gammasimtools 0.22.0__py3-none-any.whl → 0.24.0__py3-none-any.whl

simtools/applications/simulate_flasher.py

@@ -56,18 +56,17 @@ telescope (str, optional)
     Telescope name (required for full simulation mode).
 """
 
-import logging
-from pathlib import Path
-
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.simtel.simulator_light_emission import SimulatorLightEmission
 from simtools.simulator import Simulator
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
-    config = configurator.Configurator(label=label, description="Simulate flasher devices.")
+    config = configurator.Configurator(
+        label=get_application_label(__file__), description="Simulate flasher devices."
+    )
     config.parser.add_argument(
         "--run_mode",
         help="Flasher simulation run mode",
@@ -108,35 +107,32 @@ def _parse(label):
 
 def main():
     """Simulate flasher devices."""
-    label = Path(__file__).stem
-
-    args_dict, db_config = _parse(label)
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+    app_context = startup_application(_parse)
 
-    logger.info(
-        f"Flasher simulation for telescope {args_dict['telescope']} "
-        f" with light source {args_dict['light_source']} "
-        f" ({args_dict['number_of_events']} events, run mode: {args_dict['run_mode']})"
+    app_context.logger.info(
+        f"Flasher simulation for telescope {app_context.args['telescope']} "
+        f" with light source {app_context.args['light_source']} "
+        f" ({app_context.args['number_of_events']} events, "
+        f"run mode: {app_context.args['run_mode']})"
     )
 
-    if args_dict["run_mode"] == "full_simulation":
+    if app_context.args["run_mode"] == "full_simulation":
         light_source = SimulatorLightEmission(
-            light_emission_config=args_dict,
-            db_config=db_config,
-            label=args_dict.get("label"),
+            light_emission_config=app_context.args,
+            db_config=app_context.db_config,
+            label=app_context.args.get("label"),
         )
-    elif args_dict["run_mode"] == "direct_injection":
+    elif app_context.args["run_mode"] == "direct_injection":
         light_source = Simulator(
-            args_dict=args_dict,
-            db_config=db_config,
-            label=args_dict.get("label"),
+            args_dict=app_context.args,
+            db_config=app_context.db_config,
+            label=app_context.args.get("label"),
         )
     else:
-        raise ValueError(f"Unsupported run_mode: {args_dict['run_mode']}")
+        raise ValueError(f"Unsupported run_mode: {app_context.args['run_mode']}")
 
     light_source.simulate()
-    logger.info("Flasher simulation completed.")
+    app_context.logger.info("Flasher simulation completed.")
 
 
 if __name__ == "__main__":

simtools/applications/simulate_illuminator.py

@@ -53,18 +53,15 @@ output_prefix (str, optional)
     Prefix for output files (default: empty).
 """
 
-import logging
-from pathlib import Path
-
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.simtel.simulator_light_emission import SimulatorLightEmission
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=(
             "Simulate light emission by a calibration light source (not attached to a telescope)."
         ),
@@ -119,16 +116,12 @@ def _parse(label):
 
 def main():
     """Simulate light emission from illuminator."""
-    label = Path(__file__).stem
-
-    args_dict, db_config = _parse(label)
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+    app_context = startup_application(_parse)
 
     light_source = SimulatorLightEmission(
-        light_emission_config=args_dict,
-        db_config=db_config,
-        label=label,
+        light_emission_config=app_context.args,
+        db_config=app_context.db_config,
+        label=app_context.args.get("label"),
     )
     light_source.simulate()
 

simtools/applications/simulate_pedestals.py

@@ -54,17 +54,16 @@ azimuth_angle (float, optional)
     Azimuth angle in degrees.
 """
 
-import logging
-from pathlib import Path
-
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.simulator import Simulator
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
-    config = configurator.Configurator(label=label, description="Simulate calibration events.")
+    config = configurator.Configurator(
+        label=get_application_label(__file__), description="Simulate calibration events."
+    )
     config.parser.add_argument(
         "--run_mode",
         help="Calibration run mode",
@@ -105,14 +104,15 @@ def _parse(label):
     )
 
 
-def main():  # noqa: D103
-    label = Path(__file__).stem
-    args_dict, db_config = _parse(label)
+def main():
+    """Simulate pedestal events."""
+    app_context = startup_application(_parse)
 
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
-
-    simulator = Simulator(label=args_dict.get("label"), args_dict=args_dict, db_config=db_config)
+    simulator = Simulator(
+        label=app_context.args.get("label"),
+        args_dict=app_context.args,
+        db_config=app_context.db_config,
+    )
     simulator.simulate()
 
 

simtools/applications/simulate_prod.py

@@ -67,29 +67,14 @@ r"""
     will be written to data_directory/label/simtel-data.
 """
 
-import logging
-
-import simtools.utils.general as gen
+from simtools.application_control import startup_application
 from simtools.configuration import configurator
 from simtools.simulator import Simulator
 
 
-def _parse(description=None):
-    """
-    Parse command line configuration.
-
-    Parameters
-    ----------
-    description: str
-        Application description.
-
-    Returns
-    -------
-    CommandLineParser
-        Command line parser object.
-
-    """
-    config = configurator.Configurator(description=description)
+def _parse():
+    """Parse command line configuration."""
+    config = configurator.Configurator(description="Run simulations for productions")
     config.parser.add_argument(
         "--data_directory",
         help=(
@@ -152,27 +137,30 @@ def _parse(description=None):
     )
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse(description="Run simulations for productions")
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Run simulations for productions."""
+    app_context = startup_application(_parse, setup_io_handler=False)
 
-    simulator = Simulator(label=args_dict.get("label"), args_dict=args_dict, db_config=db_config)
+    simulator = Simulator(
+        label=app_context.args.get("label"),
+        args_dict=app_context.args,
+        db_config=app_context.db_config,
+    )
 
     simulator.simulate()
     simulator.validate_metadata()
 
-    logger.info(
-        f"Production run complete for primary {args_dict['primary']} showers "
-        f"from {args_dict['azimuth_angle']} azimuth and {args_dict['zenith_angle']} zenith "
-        f"at {args_dict['site']} site, using {args_dict['model_version']} model."
+    app_context.logger.info(
+        f"Production run complete for primary {app_context.args['primary']} showers "
+        f"from {app_context.args['azimuth_angle']} azimuth and "
+        f"{app_context.args['zenith_angle']} zenith "
+        f"at {app_context.args['site']} site, using {app_context.args['model_version']} model."
     )
-    if args_dict["save_reduced_event_lists"]:
+    if app_context.args["save_reduced_event_lists"]:
         simulator.save_reduced_event_lists()
-    if args_dict.get("pack_for_grid_register"):
-        simulator.pack_for_register(args_dict["pack_for_grid_register"])
-    if args_dict["save_file_lists"]:
+    if app_context.args.get("pack_for_grid_register"):
+        simulator.pack_for_register(app_context.args["pack_for_grid_register"])
+    if app_context.args["save_file_lists"]:
         simulator.save_file_lists()
 
 

simtools/applications/simulate_prod_htcondor_generator.py

@@ -45,29 +45,17 @@ priority (int, optional)
 
 """
 
-import logging
-
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.job_execution import htcondor_script_generator
 
 
-def _parse(description=None):
-    """
-    Parse command line configuration.
-
-    Parameters
-    ----------
-    description: str
-        Application description.
-
-    Returns
-    -------
-    CommandLineParser
-        Command line parser object.
-
-    """
-    config = configurator.Configurator(description=description)
+def _parse():
+    """Parse command line configuration."""
+    config = configurator.Configurator(
+        label=get_application_label(__file__),
+        description="Prepare simulations production for HT Condor job submission",
+    )
     config.parser.add_argument(
         "--apptainer_image",
         help="Apptainer image to use for the simulation (full path).",
@@ -88,13 +76,11 @@ def _parse(description=None):
     )
 
 
-def main():  # noqa: D103
-    args_dict, _ = _parse(description="Prepare simulations production for HT Condor job submission")
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Generate HT Condor submission script and submit file."""
+    app_context = startup_application(_parse)
 
-    htcondor_script_generator.generate_submission_script(args_dict)
+    htcondor_script_generator.generate_submission_script(app_context.args)
 
 
 if __name__ == "__main__":

simtools/applications/submit_array_layouts.py

@@ -32,19 +32,19 @@ r"""
 
     """
 
-import logging
-from pathlib import Path
-
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.db import db_handler
 from simtools.io import ascii_handler
 from simtools.layout.array_layout_utils import validate_array_layouts_with_db, write_array_layouts
 
 
-def _parse(label, description):
+def _parse():
     """Parse command line configuration."""
-    config = configurator.Configurator(label=label, description=description)
+    config = configurator.Configurator(
+        label=get_application_label(__file__),
+        description="Submit and validate array layouts.",
+    )
 
     config.parser.add_argument(
         "--array_layouts",
@@ -69,25 +69,22 @@ def _parse(label, description):
     return config.initialize(output=True, db_config=True, simulation_model=["model_version"])
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse(
-        label=Path(__file__).stem,
-        description="Submit and validate array layouts.",
-    )
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Submit and validate array layouts."""
+    app_context = startup_application(_parse)
 
-    db = db_handler.DatabaseHandler(mongo_db_config=db_config)
+    db = db_handler.DatabaseHandler(db_config=app_context.db_config)
 
     array_layouts = validate_array_layouts_with_db(
-        production_table=db.read_production_table_from_mongo_db(
-            collection_name="telescopes", model_version=args_dict["model_version"]
+        production_table=db.read_production_table_from_db(
+            collection_name="telescopes", model_version=app_context.args["model_version"]
         ),
-        array_layouts=ascii_handler.collect_data_from_file(args_dict["array_layouts"]),
+        array_layouts=ascii_handler.collect_data_from_file(app_context.args["array_layouts"]),
     )
 
-    write_array_layouts(array_layouts=array_layouts, args_dict=args_dict, db_config=db_config)
+    write_array_layouts(
+        array_layouts=array_layouts, args_dict=app_context.args, db_config=app_context.db_config
+    )
 
 
 if __name__ == "__main__":

simtools/applications/submit_data_from_external.py

@@ -36,34 +36,19 @@ r"""
 
 """
 
-import logging
-from pathlib import Path
-
 import simtools.data_model.model_data_writer as writer
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 from simtools.data_model import validate_data
 from simtools.data_model.metadata_collector import MetadataCollector
 
 
-def _parse(label, description):
-    """
-    Parse command line configuration.
-
-    Parameters
-    ----------
-    label: str
-        Label describing application.
-    description: str
-        Description of application.
-
-    Returns
-    -------
-    CommandLineParser
-        Command line parser object
-
-    """
-    config = configurator.Configurator(label=label, description=description)
+def _parse():
+    """Parse command line configuration."""
+    config = configurator.Configurator(
+        label=get_application_label(__file__),
+        description="Submit and validate data (e.g., input data to tools, model parameters).",
+    )
 
     config.parser.add_argument(
         "--input_meta",
@@ -92,26 +77,25 @@ def _parse(label, description):
     return config.initialize(output=True)
 
 
-def main():  # noqa: D103
-    args_dict, _ = _parse(
-        label=Path(__file__).stem,
-        description="Submit and validate data (e.g., input data to tools, model parameters).",
-    )
+def main():
+    """Submit and validate data (e.g., input data to tools, model parameters)."""
+    app_context = startup_application(_parse)
 
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
-
-    _metadata = None if args_dict.get("ignore_metadata") else MetadataCollector(args_dict)
+    _metadata = (
+        None if app_context.args.get("ignore_metadata") else MetadataCollector(app_context.args)
+    )
 
     data_validator = validate_data.DataValidator(
         schema_file=(
-            _metadata.get_data_model_schema_file_name() if _metadata else args_dict.get("schema")
+            _metadata.get_data_model_schema_file_name()
+            if _metadata
+            else app_context.args.get("schema")
         ),
-        data_file=args_dict["input"],
+        data_file=app_context.args["input"],
     )
 
     writer.ModelDataWriter.dump(
-        args_dict=args_dict,
+        args_dict=app_context.args,
         metadata=_metadata,
         product_data=data_validator.validate_and_transform(),
     )

simtools/applications/submit_model_parameter_from_external.py

@@ -38,32 +38,19 @@ r"""
 
 """
 
-import logging
 from pathlib import Path
 
 import simtools.data_model.model_data_writer as writer
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
 
 
-def _parse(label, description):
-    """
-    Parse command line configuration.
-
-    Parameters
-    ----------
-    label: str
-        Label describing application.
-    description: str
-        Description of application.
-
-    Returns
-    -------
-    CommandLineParser
-        Command line parser object
-
-    """
-    config = configurator.Configurator(label=label, description=description)
+def _parse():
+    """Parse command line configuration."""
+    config = configurator.Configurator(
+        label=get_application_label(__file__),
+        description="Submit and validate a model parameter.",
+    )
 
     config.parser.add_argument(
         "--parameter", type=str, required=True, help="Parameter for simulation model"
@@ -98,30 +85,30 @@ def _parse(label, description):
     return config.initialize(output=True, db_config=True)
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse(
-        label=Path(__file__).stem,
-        description="Submit and validate a model parameters).",
-    )
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Submit and validate a model parameter value and metadata."""
+    app_context = startup_application(_parse)
 
-    output_path = (
-        Path(args_dict["output_path"]) / args_dict["parameter"]
-        if args_dict.get("output_path")
-        else None
-    )
+    if app_context.args.get("output_path"):
+        output_path = app_context.io_handler.get_output_directory(
+            sub_dir=app_context.args.get("parameter")
+        )
+    else:
+        output_path = None
 
     writer.ModelDataWriter.dump_model_parameter(
-        parameter_name=args_dict["parameter"],
-        value=args_dict["value"],
-        instrument=args_dict["instrument"],
-        parameter_version=args_dict["parameter_version"],
-        output_file=Path(args_dict["parameter"] + "-" + args_dict["parameter_version"] + ".json"),
+        parameter_name=app_context.args["parameter"],
+        value=app_context.args["value"],
+        instrument=app_context.args["instrument"],
+        parameter_version=app_context.args["parameter_version"],
+        output_file=Path(
+            app_context.args["parameter"] + "-" + app_context.args["parameter_version"] + ".json"
+        ),
         output_path=output_path,
-        metadata_input_dict=args_dict,
-        db_config=db_config if args_dict.get("check_parameter_version") else None,
+        metadata_input_dict=app_context.args,
+        db_config=app_context.db_config
+        if app_context.args.get("check_parameter_version")
+        else None,
     )
 
 

simtools/applications/validate_camera_efficiency.py

@@ -44,19 +44,18 @@ r"""
     The output is saved in simtools-output/validate_camera_efficiency.
 """
 
-import logging
 from pathlib import Path
 
 import simtools.data_model.model_data_writer as writer
-import simtools.utils.general as gen
+from simtools.application_control import get_application_label, startup_application
 from simtools.camera.camera_efficiency import CameraEfficiency
 from simtools.configuration import configurator
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=(
             "Calculate the camera efficiency and NSB pixel rates. "
             "Plot the camera efficiency vs wavelength for Cherenkov and NSB light."
@@ -91,29 +90,26 @@ def _parse(label):
         action="store_true",
         required=False,
     )
-    _args_dict, _db_config = config.initialize(
+    args_dict, db_config = config.initialize(
         db_config=True,
         simulation_model=["telescope", "model_version", "parameter_version"],
         simulation_configuration={"corsika_configuration": ["zenith_angle", "azimuth_angle"]},
     )
-    if _args_dict["site"] is None or _args_dict["telescope"] is None:
+    if args_dict["site"] is None or args_dict["telescope"] is None:
         config.parser.print_help()
         print("\n\nSite and telescope must be provided\n\n")
         raise RuntimeError("Site and telescope must be provided")
-    return _args_dict, _db_config
+    return args_dict, db_config
 
 
-def main():  # noqa: D103
-    label = Path(__file__).stem
-    args_dict, db_config = _parse(label)
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Calculate the camera efficiency and NSB pixel rates."""
+    app_context = startup_application(_parse)
 
     ce = CameraEfficiency(
-        db_config=db_config,
-        label=args_dict.get("label", label),
-        config_data=args_dict,
+        db_config=app_context.db_config,
+        label=app_context.args.get("label"),
+        config_data=app_context.args,
     )
     ce.simulate()
     ce.analyze(force=True)
@@ -123,12 +119,18 @@ def main():  # noqa: D103
     writer.ModelDataWriter.dump_model_parameter(
         parameter_name="nsb_pixel_rate",
         value=ce.get_nsb_pixel_rate(
-            reference_conditions=args_dict.get("write_reference_nsb_rate_as_parameter", False)
+            reference_conditions=app_context.args.get(
+                "write_reference_nsb_rate_as_parameter", False
+            )
+        ),
+        instrument=app_context.args["telescope"],
+        parameter_version=app_context.args.get("parameter_version", "0.0.0"),
+        output_file=Path(
+            f"nsb_pixel_rate-{app_context.args.get('parameter_version', '0.0.0')}.json"
         ),
-        instrument=args_dict["telescope"],
-        parameter_version=args_dict.get("parameter_version", "0.0.0"),
-        output_file=Path(f"nsb_pixel_rate-{args_dict.get('parameter_version', '0.0.0')}.json"),
-        output_path=Path(args_dict["output_path"]) / args_dict["telescope"] / "nsb_pixel_rate",
+        output_path=app_context.io_handler.get_output_directory()
+        / app_context.args["telescope"]
+        / "nsb_pixel_rate",
     )