feat: remaining Python examples can be chained

CI/physmon/phys_perf_mon.sh

@@ -3,6 +3,7 @@
 set -e
 
 outdir=$1
+[ -z "$outdir" ] && outdir=physmon
 mkdir -p $outdir
 
 refdir=CI/physmon/reference
@@ -35,26 +36,26 @@ function run() {
 
 
 run \
-    physmon/performance_ckf_tracks_truth_smeared.root \
+    $outdir/performance_ckf_tracks_truth_smeared.root \
     $refdir/performance_ckf_tracks_truth_smeared.root \
     --title "CKF truth smeared" \
     -c CI/physmon/ckf_truth_smeared.yml \
     -o $outdir/ckf_truth_smeared.html \
 
 run \
-    physmon/performance_ckf_tracks_truth_estimated.root \
+    $outdir/performance_ckf_tracks_truth_estimated.root \
     $refdir/performance_ckf_tracks_truth_estimated.root \
     --title "CKF truth estimated" \
     -o $outdir/ckf_truth_estimated.html \
 
 run \
-    physmon/performance_ckf_tracks_seeded.root \
+    $outdir/performance_ckf_tracks_seeded.root \
     $refdir/performance_ckf_tracks_seeded.root \
     --title "CKF seeded" \
     -o $outdir/ckf_seeded.html \
 
 run \
-    physmon/performance_truth_tracking.root \
+    $outdir/performance_truth_tracking.root \
     $refdir/performance_truth_tracking.root \
     --title "Truth tracking" \
     -c CI/physmon/truth_tracking.yml \

Examples/Python/python/acts/examples/__init__.py

@@ -1,4 +1,4 @@
-import inspect
+import sys, inspect
 
 from acts.ActsPythonBindings._examples import *
 from acts import ActsPythonBindings
@@ -123,3 +123,109 @@ def _process_volume_intervals(kwargs):
 
 
 _patchKwargsConstructor(TGeoDetector.Config.Volume, proc=_process_volume_intervals)
+
+
+def NamedTypeArgs(**namedTypeArgs):
+    """Decorator to move args of a named type (eg. `namedtuple` or `Enum`) to kwargs based on type, so user doesn't need to specify the key name.
+    Also allows the keyword argument to be converted from a built-in type (eg. `tuple` or `int`)."""
+
+    namedTypeClasses = {c: a for a, c in namedTypeArgs.items()}
+
+    def NamedTypeArgsDecorator(func):
+        from functools import wraps
+
+        @wraps(func)
+        def NamedTypeArgsWrapper(*args, **kwargs):
+            from collections.abc import Iterable
+
+            for k, v in kwargs.items():
+                cls = namedTypeArgs.get(k)
+                if cls is not None and v.__class__.__module__ == int.__module__:
+                    if issubclass(cls, Iterable):
+                        kwargs[k] = cls(*v)
+                    else:
+                        kwargs[k] = cls(v)
+
+            newargs = []
+            for a in args:
+                k = namedTypeClasses.get(type(a))
+                if k is None:
+                    newargs.append(a)
+                elif k in kwargs:
+                    raise KeyError(k)
+                else:
+                    kwargs[k] = a
+            return func(*newargs, **kwargs)
+
+        return NamedTypeArgsWrapper
+
+    return NamedTypeArgsDecorator
+
+
+def defaultKWArgs(**kwargs) -> dict:
+    """Removes keyword arguments that are None or a list of all None (eg. [None,None]).
+    This keeps the called function's defaults."""
+    from collections.abc import Iterable
+
+    return {
+        k: v
+        for k, v in kwargs.items()
+        if not (
+            v is None or (isinstance(v, Iterable) and all([vv is None for vv in v]))
+        )
+    }
+
+
+def dump_args(func):
+    """
+    Decorator to print function call details.
+    This includes parameters names and effective values.
+    https://stackoverflow.com/questions/6200270/decorator-that-prints-function-call-details-parameters-names-and-effective-valu
+    """
+    from functools import wraps
+
+    @wraps(func)
+    def dump_args_wrapper(*args, **kwargs):
+        import inspect
+
+        try:
+            func_args = inspect.signature(func).bind(*args, **kwargs).arguments
+            func_args_str = ", ".join(
+                map("{0[0]} = {0[1]!r}".format, func_args.items())
+            )
+        except ValueError:
+            func_args_str = ", ".join(
+                list(map("{0!r}".format, args))
+                + list(map("{0[0]} = {0[1]!r}".format, kwargs.items()))
+            )
+        print(f"{func.__module__}.{func.__qualname__} ( {func_args_str} )")
+        return func(*args, **kwargs)
+
+    return dump_args_wrapper
+
+
+def dump_args_calls(
+    myLocal=None,
+    mod=sys.modules[__name__],
+):
+    """
+    Wrap all calls to acts.examples Python bindings in dump_args.
+    Specify myLocal=locals() to include imported symbols too.
+    """
+    import collections
+
+    for n in dir(mod):
+        if n.startswith("_") or n == "Config":
+            continue
+        f = getattr(mod, n)
+        if not (
+            isinstance(f, collections.abc.Callable)
+            and f.__module__.startswith("acts.ActsPythonBindings")
+            and not hasattr(f, "__wrapped__")
+        ):
+            continue
+        dump_args_calls(myLocal, f)  # wrap class's contained methods
+        w = dump_args(f)
+        setattr(mod, n, w)
+        if myLocal and hasattr(myLocal, n):
+            setattr(myLocal, n, w)

Examples/Python/tests/helpers/__init__.py

@@ -5,6 +5,11 @@
 from acts.examples import BareAlgorithm
 
 geant4Enabled = any(v.startswith("G4") for v in os.environ.keys())
+if geant4Enabled:
+    try:
+        import acts.examples.geant4
+    except ImportError:
+        geant4Enabled = False
 
 try:
     import ROOT

Examples/Python/tests/root_file_hashes.txt

@@ -15,7 +15,7 @@ test_fatras__fatras_particles_initial.root: 712a41d95ed1fccafccf708afddcd2177793
 test_fatras__hits.root: f890599a8c94bc80270636c64039f8a0a7d8ddd716a15306d5ca61f15f8da5e8
 test_seeding__estimatedparams.root: 50e281ec30150bdd13635dcbc0a1191be26a189a9ffd5cf1103307a62e6c9e47
 test_seeding__performance_seeding_trees.root: c900a70a9881ce637a73ff730de4b2f4b6c0446854d666f70c7fc9c44c893666
-test_seeding__evgen_particles.root: 4943f152bfad6ca6302563b57e495599fad4fea43b8e0b41abe5b8de31b391bc
+test_seeding__particles.root: 4943f152bfad6ca6302563b57e495599fad4fea43b8e0b41abe5b8de31b391bc
 test_seeding__fatras_particles_final.root: 934e290545090fe87d177bf40a78cf9375420e854433c2ef5a6d408fb3744d9d
 test_seeding__fatras_particles_initial.root: 4943f152bfad6ca6302563b57e495599fad4fea43b8e0b41abe5b8de31b391bc
 test_propagation__propagation_steps.root: 2d9a86e1097b8f0a845f33b05830f6b9c78cdeaeeb01685753e8dc9b434c7f9d

Examples/Python/tests/test_examples.py

@@ -160,7 +160,7 @@ def test_seeding(tmp_path, trk_geo, field, assert_root_hash):
             0,
         ),
         (
-            "evgen_particles.root",
+            "particles.root",
             "particles",
             seq.config.events,
         ),
@@ -195,10 +195,9 @@ def test_seeding(tmp_path, trk_geo, field, assert_root_hash):
             assert_entries(fp, tn, exp_entries)
             assert_root_hash(fn, fp)
 
-    assert_csv_output(csv, "evgen_particles")
-    assert_csv_output(csv, "evgen_particles")
-    assert_csv_output(csv, "fatras_particles_final")
-    assert_csv_output(csv, "fatras_particles_initial")
+    assert_csv_output(csv, "particles")
+    assert_csv_output(csv, "particles_final")
+    assert_csv_output(csv, "particles_initial")
 
 
 def test_propagation(tmp_path, trk_geo, field, seq, assert_root_hash):
@@ -923,7 +922,7 @@ def test_ckf_tracks_example_truth_smeared(tmp_path, assert_root_hash):
 
 @pytest.mark.skipif(not dd4hepEnabled, reason="DD4hep not set up")
 @pytest.mark.slow
-# @pytest.mark.filterwarnings("ignore::UserWarning")
+@pytest.mark.filterwarnings("ignore::UserWarning")
 def test_vertex_fitting(tmp_path):
     detector, trackingGeometry, decorators = getOpenDataDetector()
 
@@ -936,7 +935,7 @@ def test_vertex_fitting(tmp_path):
     runVertexFitting(
         field,
         vertexFinder=VertexFinder.Truth,
-        outputDir=Path.cwd(),
+        outputDir=tmp_path,
         s=s,
     )
 
@@ -982,7 +981,8 @@ def test_vertex_fitting_reading(
             trackingGeometry,
             field,
             digiConfigFile=Path(
-                "Examples/Algorithms/Digitization/share/default-smearing-config-generic.json"
+                Path(__file__).parent.parent.parent.parent
+                / "Examples/Algorithms/Digitization/share/default-smearing-config-generic.json"
             ),
             outputDir=tmp_path,
             s=s2,