gammasimtools 0.21.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

simtools/applications/derive_ctao_array_layouts.py

@@ -42,10 +42,7 @@ r"""
             --updated_parameter_version 3.0.0
 """
 
-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.layout.array_layout_utils import (
@@ -55,10 +52,10 @@ from simtools.layout.array_layout_utils import (
 )
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description="Derive CTAO array layouts from CTAO common identifiers repository.",
     )
     config.parser.add_argument(
@@ -85,34 +82,32 @@ def _parse(label):
     )
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse(Path(__file__).stem)
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Derive CTAO array layouts from CTAO common identifiers repository."""
+    app_context = startup_application(_parse)
 
     ctao_array_layouts = retrieve_ctao_array_layouts(
-        site=args_dict["site"],
-        repository_url=args_dict["repository_url"],
-        branch_name=args_dict["repository_branch"],
+        site=app_context.args["site"],
+        repository_url=app_context.args["repository_url"],
+        branch_name=app_context.args["repository_branch"],
     )
 
-    db = db_handler.DatabaseHandler(mongo_db_config=db_config)
+    db = db_handler.DatabaseHandler(mongo_db_config=app_context.db_config)
     db_array_layouts = db.get_model_parameter(
         parameter="array_layouts",
-        site=args_dict["site"],
+        site=app_context.args["site"],
         array_element_name=None,
-        parameter_version=args_dict.get("parameter_version"),
-        model_version=args_dict.get("model_version"),
+        parameter_version=app_context.args.get("parameter_version"),
+        model_version=app_context.args.get("model_version"),
     )
     db_array_layouts["array_layouts"].pop("_id", None)
     db_array_layouts["array_layouts"].pop("entry_date", None)
-    logger.info(f"Layouts from model parameter database: {db_array_layouts}")
+    app_context.logger.info(f"Layouts from model parameter database: {db_array_layouts}")
 
     write_array_layouts(
         array_layouts=merge_array_layouts(db_array_layouts["array_layouts"], ctao_array_layouts),
-        args_dict=args_dict,
-        db_config=db_config,
+        args_dict=app_context.args,
+        db_config=app_context.db_config,
     )
 
 

simtools/applications/derive_mirror_rnda.py

@@ -125,18 +125,15 @@ 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.ray_tracing.mirror_panel_psf import MirrorPanelPSF
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        description="Derive mirror random reflection angle.", label=label
+        description="Derive mirror random reflection angle.", label=get_application_label(__file__)
     )
     psf_group = config.parser.add_mutually_exclusive_group()
     psf_group.add_argument(
@@ -217,15 +214,13 @@ def _parse(label):
     )
 
 
-def main():  # noqa: D103
-    label = Path(__file__).stem
-
-    args_dict, db_config = _parse(label)
+def main():
+    """Derive mirror random reflection angle of a single mirror panel."""
+    app_context = startup_application(_parse)
 
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
-
-    panel_psf = MirrorPanelPSF(label, args_dict, db_config)
+    panel_psf = MirrorPanelPSF(
+        app_context.args.get("label"), app_context.args, app_context.db_config
+    )
     panel_psf.derive_random_reflection_angle(save_figures=True)
     panel_psf.print_results()
     panel_psf.write_optimization_data()

simtools/applications/derive_photon_electron_spectrum.py

@@ -34,18 +34,17 @@ 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.camera.single_photon_electron_spectrum import SinglePhotonElectronSpectrum
 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="Derive single photon electron spectrum from a given amplitude spectrum.",
     )
     config.parser.add_argument(
@@ -112,13 +111,11 @@ def _parse(label):
     return config.initialize(db_config=False, output=True, simulation_model=["telescope"])
 
 
-def main():  # noqa: D103
-    args_dict, _ = _parse(Path(__file__).stem)
+def main():
+    """Derive single photon electron spectrum from a given amplitude spectrum."""
+    app_context = startup_application(_parse)
 
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
-
-    single_pe = SinglePhotonElectronSpectrum(args_dict)
+    single_pe = SinglePhotonElectronSpectrum(app_context.args)
     single_pe.derive_single_pe_spectrum()
     single_pe.write_single_pe_spectrum()
 

simtools/applications/derive_psf_parameters.py

@@ -110,22 +110,19 @@ r"""
 
 """
 
-import logging
-from pathlib import Path
-
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
-from simtools.io import io_handler
 from simtools.model.model_utils import initialize_simulation_models
 from simtools.ray_tracing import psf_parameter_optimisation as psf_opt
-from simtools.utils.general import get_log_level_from_user
 
 
 def _parse():
     config = configurator.Configurator(
+        label=get_application_label(__file__),
         description=(
             "Derive mirror_reflection_random_angle, mirror_align_random_horizontal "
             "and mirror_align_random_vertical using cumulative PSF measurement."
-        )
+        ),
     )
     config.parser.add_argument(
         "--src_distance",
@@ -184,30 +181,36 @@ def _parse():
         help="Use KS statistic for monte carlo uncertainty analysis.",
         action="store_true",
     )
+    config.parser.add_argument(
+        "--fraction",
+        help="PSF containment fraction for diameter calculation (e.g., 0.8 for D80, 0.95 for D95).",
+        type=float,
+        default=0.8,
+    )
     return config.initialize(
         db_config=True,
         simulation_model=["telescope", "model_version", "parameter_version"],
     )
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse()
-
-    label = label = Path(__file__).stem
-    logger = logging.getLogger()
-    logger.setLevel(get_log_level_from_user(args_dict["log_level"]))
+def main():
+    """Derive PSF parameters."""
+    app_context = startup_application(_parse)
 
-    _io_handler = io_handler.IOHandler()
-    output_dir = _io_handler.get_output_directory(label, sub_dir="application-plots")
-    tel_model, site_model = initialize_simulation_models(
-        label=label,
-        db_config=db_config,
-        site=args_dict["site"],
-        telescope_name=args_dict["telescope"],
-        model_version=args_dict["model_version"],
+    tel_model, site_model, _ = initialize_simulation_models(
+        label=app_context.args.get("label"),
+        db_config=app_context.db_config,
+        site=app_context.args["site"],
+        telescope_name=app_context.args["telescope"],
+        model_version=app_context.args["model_version"],
     )
 
-    psf_opt.run_psf_optimization_workflow(tel_model, site_model, args_dict, output_dir)
+    psf_opt.run_psf_optimization_workflow(
+        tel_model,
+        site_model,
+        app_context.args,
+        app_context.io_handler.get_output_directory(),
+    )
 
 
 if __name__ == "__main__":

simtools/applications/derive_trigger_rates.py

@@ -37,9 +37,7 @@ Derive trigger rates for the South Alpha layout:
 
 """
 
-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.telescope_trigger_rates import telescope_trigger_rates
 
@@ -47,6 +45,7 @@ from simtools.telescope_trigger_rates import telescope_trigger_rates
 def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
+        label=get_application_label(__file__),
         description="Derive trigger rates for a single telescope or an array of telescopes.",
     )
     config.parser.add_argument(
@@ -78,13 +77,11 @@ def _parse():
     )
 
 
-def main():  # noqa: D103
-    args_dict, db_config = _parse()
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args_dict.get("log_level", "info")))
+def main():
+    """Derive trigger rates for a single telescope or an array of telescopes."""
+    app_context = startup_application(_parse)
 
-    telescope_trigger_rates(args_dict, db_config)
+    telescope_trigger_rates(app_context.args, app_context.db_config)
 
 
 if __name__ == "__main__":

simtools/applications/docs_produce_array_element_report.py

@@ -7,20 +7,18 @@ The report includes detailed information on each parameter,
 such as the parameter name, value, unit, description, and short description.
 """
 
-import logging
 from pathlib import Path
 
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
-from simtools.io import io_handler
 from simtools.reporting.docs_auto_report_generator import ReportGenerator
 from simtools.reporting.docs_read_parameters import ReadParameters
-from simtools.utils import general as gen
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=("Produce a markdown report for model parameters."),
     )
 
@@ -51,34 +49,35 @@ def _parse(label):
     )
 
 
-def main():  # noqa: D103
-    label_name = "reports"
-    args, db_config = _parse(label_name)
+def main():
+    """Produce a markdown file for a given array element, site, and model version."""
+    app_context = startup_application(_parse)
+    output_path = app_context.io_handler.get_output_directory()
 
-    io_handler_instance = io_handler.IOHandler()
-    output_path = io_handler_instance.get_output_directory(label=label_name, sub_dir="productions")
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args["log_level"]))
-
-    if any([args.get("all_telescopes"), args.get("all_sites"), args.get("all_model_versions")]):
+    if any(
+        [
+            app_context.args.get("all_telescopes"),
+            app_context.args.get("all_sites"),
+            app_context.args.get("all_model_versions"),
+        ]
+    ):
         ReportGenerator(
-            db_config,
-            args,
+            app_context.db_config,
+            app_context.args,
             output_path,
         ).auto_generate_array_element_reports()
 
     else:
-        model_version = args["model_version"]
+        model_version = app_context.args["model_version"]
         ReadParameters(
-            db_config,
-            args,
+            app_context.db_config,
+            app_context.args,
             Path(output_path / f"{model_version}"),
         ).produce_array_element_report()
 
-        logger.info(
-            f"Markdown report generated for {args['site']}"
-            f" Telescope {args['telescope']} (v{model_version}):"
+        app_context.logger.info(
+            f"Markdown report generated for {app_context.args['site']}"
+            f" Telescope {app_context.args['telescope']} (v{model_version}):"
             f" {output_path}"
         )
 

simtools/applications/docs_produce_calibration_reports.py

@@ -2,47 +2,49 @@
 
 r"""Produces a markdown file for calibration reports."""
 
-import logging
-
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
-from simtools.io import io_handler
-from simtools.reporting.docs_read_parameters import ReadParameters
-from simtools.utils import general as gen
+from simtools.reporting.docs_auto_report_generator import ReportGenerator
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=("Produce a markdown report for calibration parameters."),
     )
 
+    config.parser.add_argument(
+        "--all_model_versions",
+        action="store_true",
+        help="Produce reports for all model versions.",
+    )
+
     return config.initialize(
         db_config=True,
         simulation_model=["model_version"],
     )
 
 
-def main():  # noqa: D103
-    label_name = "reports"
-    args, db_config = _parse(label_name)
-
-    io_handler_instance = io_handler.IOHandler()
-    output_path = io_handler_instance.get_output_directory(label=label_name, sub_dir="productions")
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args["log_level"]))
-
-    read_parameters = ReadParameters(
-        db_config=db_config, args=args, output_path=output_path / f"{args.get('model_version')}"
-    )
+def main():
+    """Produce a markdown file for calibration reports."""
+    app_context = startup_application(_parse)
 
-    read_parameters.produce_calibration_reports()
+    output_path = app_context.io_handler.get_output_directory()
 
-    logger.info(
-        f"Calibation reports for model version {args.get('model_version')} produced successfully."
+    generator = ReportGenerator(
+        db_config=app_context.db_config, args=app_context.args, output_path=output_path
     )
-    logger.info(f"Output path: {output_path}/{args.get('model_version')}/")
+    generator.auto_generate_calibration_reports()
+
+    if app_context.args.get("all_model_versions"):
+        app_context.logger.info("Calibration reports for all model versions produced successfully.")
+    else:
+        app_context.logger.info(
+            f"Calibration reports for model version {app_context.args.get('model_version')}"
+            " produced successfully."
+        )
+    app_context.logger.info(f"Output path: {output_path}")
 
 
 if __name__ == "__main__":

simtools/applications/docs_produce_model_parameter_reports.py

@@ -8,19 +8,16 @@ comparing their values over various model versions.
 Currently only implemented for telescopes.
 """
 
-import logging
-
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
-from simtools.io import io_handler
 from simtools.reporting.docs_auto_report_generator import ReportGenerator
 from simtools.reporting.docs_read_parameters import ReadParameters
-from simtools.utils import general as gen
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=("Produce a markdown report for model parameters."),
     )
 
@@ -37,32 +34,28 @@ def _parse(label):
     return config.initialize(db_config=True, simulation_model=["site", "telescope"])
 
 
-def main():  # noqa: D103
-    label_name = "reports"
-    args, db_config = _parse(label_name)
-    io_handler_instance = io_handler.IOHandler()
-    output_path = io_handler_instance.get_output_directory(label=label_name, sub_dir="parameters")
-
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args["log_level"]))
+def main():
+    """Produce a model parameter report per array element."""
+    app_context = startup_application(_parse)
+    output_path = app_context.io_handler.get_output_directory()
 
-    if any([args.get("all_telescopes"), args.get("all_sites")]):
+    if any([app_context.args.get("all_telescopes"), app_context.args.get("all_sites")]):
         ReportGenerator(
-            db_config,
-            args,
+            app_context.db_config,
+            app_context.args,
             output_path,
         ).auto_generate_parameter_reports()
 
     else:
         ReadParameters(
-            db_config,
-            args,
+            app_context.db_config,
+            app_context.args,
             output_path,
         ).produce_model_parameter_reports()
 
-        logger.info(
-            f"Markdown report generated for {args['site']}"
-            f"Telescope {args['telescope']}: {output_path}"
+        app_context.logger.info(
+            f"Markdown report generated for {app_context.args['site']}"
+            f"Telescope {app_context.args['telescope']}: {output_path}"
         )
 
 

simtools/applications/docs_produce_simulation_configuration_report.py

@@ -2,21 +2,24 @@
 
 r"""Produces a markdown file for a given simulation configuration."""
 
-import logging
-
+from simtools.application_control import get_application_label, startup_application
 from simtools.configuration import configurator
-from simtools.io import io_handler
-from simtools.reporting.docs_read_parameters import ReadParameters
-from simtools.utils import general as gen
+from simtools.reporting.docs_auto_report_generator import ReportGenerator
 
 
-def _parse(label):
+def _parse():
     """Parse command line configuration."""
     config = configurator.Configurator(
-        label=label,
+        label=get_application_label(__file__),
         description=("Produce a markdown report for model parameters."),
     )
 
+    config.parser.add_argument(
+        "--all_model_versions",
+        action="store_true",
+        help="Produce reports for all model versions.",
+    )
+
     return config.initialize(
         db_config=True,
         simulation_model=["model_version"],
@@ -24,26 +27,22 @@ def _parse(label):
     )
 
 
-def main():  # noqa: D103
-    label_name = "reports"
-    args, db_config = _parse(label_name)
+def main():
+    """Produce a markdown file for a given simulation configuration."""
+    app_context = startup_application(_parse)
 
-    io_handler_instance = io_handler.IOHandler()
-    output_path = io_handler_instance.get_output_directory(label=label_name, sub_dir="productions")
+    output_path = app_context.io_handler.get_output_directory()
 
-    logger = logging.getLogger()
-    logger.setLevel(gen.get_log_level_from_user(args["log_level"]))
-
-    read_parameters = ReadParameters(
-        db_config=db_config, args=args, output_path=output_path / f"{args.get('model_version')}"
+    report_generator = ReportGenerator(
+        db_config=app_context.db_config, args=app_context.args, output_path=output_path
     )
+    report_generator.auto_generate_simulation_configuration_reports()
 
-    read_parameters.produce_simulation_configuration_report()
-
-    logger.info(
-        f"Configuration reports for {args.get('simulation_software')} produced successfully."
+    app_context.logger.info(
+        f"Configuration reports for {app_context.args.get('simulation_software')} "
+        "produced successfully."
     )
-    logger.info(f"Output path: {output_path}/{args.get('model_version')}/")
+    app_context.logger.info(f"Output path: {output_path}")
 
 
 if __name__ == "__main__":

simtools/applications/generate_array_config.py

@@ -25,50 +25,31 @@ North - 5.0.0:
 The output is saved in simtools-output/test/model.
 """
 
-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.model.array_model import ArrayModel
 
 
-def _parse(label, description):
-    """
-    Parse command line configuration.
-
-    Parameters
-    ----------
-    label : str
-        Label describing the application.
-    description : str
-        Description of the 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="Generate sim_telarray configuration files for a given array.",
+    )
     return config.initialize(db_config=True, simulation_model=["site", "layout", "model_version"])
 
 
 def main():
     """Generate sim_telarray configuration files for a given array."""
-    args_dict, db_config = _parse(
-        label=Path(__file__).stem,
-        description=("Generate sim_telarray configuration files for a given array."),
-    )
-    logger = logging.getLogger("simtools")
-    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+    app_context = startup_application(_parse)
 
     array_model = ArrayModel(
-        label=args_dict["label"],
-        model_version=args_dict["model_version"],
-        mongo_db_config=db_config,
-        site=args_dict.get("site"),
-        layout_name=args_dict.get("array_layout_name"),
-        array_elements=args_dict.get("array_elements"),
+        label=app_context.args["label"],
+        model_version=app_context.args["model_version"],
+        mongo_db_config=app_context.db_config,
+        site=app_context.args.get("site"),
+        layout_name=app_context.args.get("array_layout_name"),
+        array_elements=app_context.args.get("array_elements"),
     )
     array_model.print_telescope_list()
     array_model.export_all_simtel_config_files()