Refactor: Further enhance Python packaging and modularity

This commit implements further refactoring based on feedback to improve the project's structure as a Python library:

- Removed `if __name__ == "__main__"` blocks from `FreeTSE/FreeTSE.py` and `FreeTSE/gui.py` to ensure they act as importable modules without side effects.
- Refactored `FreeTSE/gui.py` to encapsulate its primary functionality within a callable `run_gui_application()` function. This makes the GUI behavior explicitly invokable rather than running on import.
- Updated `FreeTSE/__init__.py` to only export the core `FreeTSE` class by default. The `run_gui_application` function can be imported directly from `FreeTSE.gui` if needed. This change prevents `PySimpleGUIWx` (a GUI dependency) from becoming a core dependency for non-GUI uses of the library.
- Adjusted test imports in `tests/test_freetse_integration.py` to `from FreeTSE import FreeTSE`.
- Confirmed all tests pass after these changes.

Author: google-labs-jules[bot]

FreeTSE.py FreeTSE/FreeTSE.pyFreeTSE.py renamed to FreeTSE/FreeTSE.py

@@ -1,5 +1,5 @@
 #coding:utf-8
-from util import *
+from .util import *
 
 import random as pyrand
 from pylab import *
@@ -785,47 +785,4 @@ def visualize(self, speed=0, prior=0, posterior=0, smooth=0, posterior_stddev=0,
 					if save:
 						savefig("%s_timeseries_%d.png"%(fname, x))
 
-		show()
-
-if __name__ == "__main__":
-	tse = FreeTSE()
-	tse.set_scenario(
-		name = "ngsim_trajectory",
-		dt = 4,
-		dx = 100,
-		mint = 0,
-		maxt = 800,
-		minx = 0,
-		maxx = 500,
-		number_of_lanes = 5,
-		speed_data_name = "./dat/ngsim_sampled_trajectories.csv",
-		speed_label_t = "t",
-		speed_label_x = "x",
-		speed_label_v = "v",
-		density_data_name = None,
-		density_label_t = "t",
-		density_label_x = "x",
-		density_label_k = "k",
-		flow_data_name = "./dat/ngsim_grid_flow_200m.csv",
-		flow_label_t = "t",
-		flow_label_x = "x",
-		flow_label_q = "q",
-		density_dat_true_name = None,
-		true_density_label_t = "t",
-		true_density_label_x = "x",
-		true_density_label_k = "k",
-		flow_dat_true_name = "./dat/ngsim_grid_flow_400m.csv",
-		true_flow_label_t = "t",
-		true_flow_label_x = "x",
-		true_flow_label_q = "q"
-	)
-	tse.estimation()
-	tse.accuracy_evaluation()
-	fname = "res_test"
-	tse.save_results(fname+".csv")
-	tse.visualize(smooth=1, true=1, speed=1, timeseries=1, inputdata=1, save=1, fname=fname)
-	
-	q, k, v = tse.get_results()
-	print("flow", q)
-	print("density", k)
-	print("speed", v)
+		show()

FreeTSE/__init__.py

@@ -0,0 +1,5 @@
+from .FreeTSE import FreeTSE
+
+__all__ = ['FreeTSE']
+# Users who want run_gui_application can import it directly:
+# from FreeTSE.gui import run_gui_application