DumpGeoConfig Namespace Reference

Functions
	configureGeometry (flags, cfg)
	getATLASVersion ()
	dumpGeoOutputFileName (flags)
	resolveDumpGeoGeometryTag (det_descr, configured_tag, fallback_tag)
	dumpGeoHasInputFiles (input_files)
	configureDumpGeoInputFlags (flags)
	validateDumpGeoOutputFile (output_file, force_overwrite)
	logZDCFailureReminder (zdc_enabled, run_succeeded)
	DumpGeoCfg (flags, name="DumpGeoAlg", **kwargs)

Variables
	_logger = logging.getLogger('DumpGeo')
	flags = initConfigFlags()
	MaxEvents
	NumThreads
	parser = flags.getArgumentParser(description="Dump the detector geometry to a GeoModel-based SQLite '.db' file.")
	prog
	default
	help
	metavar
	action
	args = flags.fillFromArgs(parser=parser)
	OutputFileName
	FilterDetManagers
	ShowTreetopContent
	ForceOverwrite
	dumpgeo_empty_input = configureDumpGeoInputFlags(flags)
	configured_geometry_tag = None
	geometry_tag
	AtlasVersion
	input_metadata = GetFileMD(flags.Input.Files)
	input_geometry_tag = input_metadata.get("GeoAtlas", None)
	ProjectName
	RunNumbers
	TimeStamps
	TypedCollections
	GlobalTag
	isMC
	MCCampaign
	use_metadata
	toggle_geometry
	keep_beampipe
	cfg = MainServicesCfg(flags)
	debugCAlevel = int(args.debugCA)
	status = cfg.run()

Function Documentation

configureDumpGeoInputFlags()

configureDumpGeoInputFlags

(

flags

)

Configure deterministic defaults for an input-less standalone job.

Definition at line 157 of file DumpGeoConfig.py.

def configureDumpGeoInputFlags(flags):
    """Configure deterministic defaults for an input-less standalone job."""
    if dumpGeoHasInputFiles(flags.Input.Files):
        return False
 
    from Campaigns.Utils import Campaign
    from AthenaConfiguration.TestDefaults import defaultConditionsTags
 
    flags.Input.Files = []
 
    # MainServicesCfg and detector configuration require these normally
    # metadata-derived flags to be initialized for an input-less job.
    flags.Input.ProjectName = "mc23_13p6TeV"
    flags.Input.RunNumbers = [330000]
    flags.Input.TimeStamps = [1]
    flags.Input.TypedCollections = []
    flags.IOVDb.GlobalTag = defaultConditionsTags.RUN3_MC
    flags.Input.isMC = True
    flags.Input.MCCampaign = Campaign.Unknown
    return True
 
 

configureGeometry()

configureGeometry	(		flags,
			cfg )

Definition at line 28 of file DumpGeoConfig.py.

def configureGeometry(flags, cfg):
 
    # Beam pipe
    if flags.Detector.GeometryBpipe:
        from BeamPipeGeoModel.BeamPipeGMConfig import BeamPipeGeometryCfg
        cfg.merge(BeamPipeGeometryCfg(flags))
 
    # Inner Detectors
    if flags.Detector.GeometryPixel:
        from PixelGeoModel.PixelGeoModelConfig import PixelReadoutGeometryCfg
        cfg.merge(PixelReadoutGeometryCfg(flags))
    # TODO: do we need to set this separately?
    # if flags.Detector.GeometryBCM:
 
    if flags.Detector.GeometrySCT:
        from SCT_GeoModel.SCT_GeoModelConfig import SCT_ReadoutGeometryCfg
        cfg.merge(SCT_ReadoutGeometryCfg(flags))
 
    if flags.Detector.GeometryTRT:
        from TRT_GeoModel.TRT_GeoModelConfig import TRT_ReadoutGeometryCfg
        cfg.merge(TRT_ReadoutGeometryCfg(flags))
 
    # InDetServMat
    # Trigger the build of the InDetServMat geometry 
    # if any ID subsystems have been enabled
    if flags.Detector.GeometryID:
        from InDetServMatGeoModel.InDetServMatGeoModelConfig import (
             InDetServiceMaterialCfg)
        cfg.merge(InDetServiceMaterialCfg(flags))
 
    # Calorimeters
    if flags.Detector.GeometryLAr:
        from LArGeoAlgsNV.LArGMConfig import LArGMCfg
        cfg.merge(LArGMCfg(flags))
 
    if flags.Detector.GeometryTile:
        from TileGeoModel.TileGMConfig import TileGMCfg
        #flags.Tile.forceFullGeometry = True
        cfg.merge(TileGMCfg(flags))
        # We must set the "FULL" geometry explicitly, otherwise the "RECO" version will be used by default,
        # which is almost 'empty' (just the first level of child volumes is created for the "RECO" geo).
        cfg.getService("GeoModelSvc").DetectorTools["TileDetectorTool"].GeometryConfig="FULL"
    # TODO: do we need to set this separately?
    # if flags.Detector.GeometryMBTS:
 
    # Muon spectrometer
    if flags.Detector.GeometryMuon:
        from MuonConfig.MuonGeometryConfig import MuonGeoModelCfg
        cfg.merge(MuonGeoModelCfg(flags))
 
    # HGTD (defined only for Run4 geometry tags)
    if flags.Detector.GeometryHGTD:
        #set up geometry
        if flags.HGTD.Geometry.useGeoModelXml:
            from HGTD_GeoModelXml.HGTD_GeoModelConfig import HGTD_SimulationGeometryCfg
        else:
            from HGTD_GeoModel.HGTD_GeoModelConfig import HGTD_SimulationGeometryCfg
        cfg.merge(HGTD_SimulationGeometryCfg(flags))
        
    # ITk (defined only for Run4 geometry tags)
    if flags.Detector.GeometryITkPixel:
        from PixelGeoModelXml.ITkPixelGeoModelConfig import ITkPixelReadoutGeometryCfg
        cfg.merge(ITkPixelReadoutGeometryCfg(flags))
    if flags.Detector.GeometryITkStrip:
        from StripGeoModelXml.ITkStripGeoModelConfig import ITkStripReadoutGeometryCfg
        cfg.merge(ITkStripReadoutGeometryCfg(flags))
    # TODO: do we need to set those separately?
    # if flags.Detector.GeometryBCMPrime:
    # if flags.Detector.GeometryPLR:
 
    # Cavern (disabled by default)
    if flags.Detector.GeometryCavern:
        from AtlasGeoModel.CavernGMConfig import CavernGeometryCfg
        cfg.merge(CavernGeometryCfg(flags))
    
    # Forward detectors (disabled by default)
    if flags.Detector.GeometryLucid or flags.Detector.GeometryALFA or flags.Detector.GeometryAFP or flags.Detector.GeometryFwdRegion :
        from AtlasGeoModel.ForDetGeoModelConfig import ForDetGeometryCfg
        cfg.merge(ForDetGeometryCfg(flags))
    if flags.Detector.GeometryZDC:
        from ZDC_GeoM.ZdcGeoModelConfig import ZDC_DetToolCfg
        cfg.merge(ZDC_DetToolCfg(flags))
 
    # Temporary 'hack': 
    # Replace EllipticTube with Box, 
    # to bypass a crash due to lack of support 
    # for EllipticTube in GeoModelIO 
    # See: https://its.cern.ch/jira/browse/ATLASSIM-7263
    if "ForwardRegionGeoModelTool" in cfg.getService("GeoModelSvc").DetectorTools:
        cfg.getService("GeoModelSvc").DetectorTools["ForwardRegionGeoModelTool"].vp1Compatibility=True
 
 

DumpGeoCfg()

DumpGeoCfg	(		flags,
			name = "DumpGeoAlg",
		**	kwargs )

Definition at line 200 of file DumpGeoConfig.py.

def DumpGeoCfg(flags, name="DumpGeoAlg", **kwargs):
    if _logger.isEnabledFor(logging.DEBUG):
        _logger.debug(
            "Dumping the 'GeoModel.DumpGeo' configuration flags:"
        )
        flags.dump("GeoModel.DumpGeo")
 
    # Debug messages
    _logger.debug("kwargs: %s", kwargs)
    
    # set additional DumpGeo Alg's properties
    _logger.verbose("Using ATLAS/Athena version: %s", getATLASVersion())
    _logger.verbose("Using GeoModel ATLAS version: %s", flags.GeoModel.AtlasVersion)
    kwargs.setdefault("AtlasRelease", getATLASVersion())
    kwargs.setdefault("AtlasVersion", flags.GeoModel.AtlasVersion)
    
    # Set the user's choice to see the content of the Treetops
    if flags.GeoModel.DumpGeo.ShowTreetopContent:
        kwargs.setdefault("ShowTreetopContent", True)
 
    # Configure DetectorManager filtering independently of the output file
    # name. In particular, a user-defined file name must not disable the
    # filter passed to the C++ algorithm.
    filterDetManagers = flags.GeoModel.DumpGeo.FilterDetManagers
    if filterDetManagers:
        _logger.info(
            "+++ Filtering on these GeoModel 'Detector Managers': '%s'",
            filterDetManagers,
        )
        kwargs.setdefault("UserFilterDetManager", filterDetManagers)
 
    # Set the name of the output '.db' file.
    configuredOutFileName = dumpGeoOutputFileName(flags)
    if not flags.GeoModel.DumpGeo.OutputFileName:
        _logger.info(
            "+++ Dumping this Detector Description geometry TAG: '%s'",
            flags.GeoModel.AtlasVersion,
        )
 
    # Set the output file name variable in the C++ code
    kwargs.setdefault("OutSQLiteFileName", configuredOutFileName)
 
    # The final algorithm property is authoritative. A caller can override the
    # flag-derived filename through kwargs, so validation and deletion must use
    # the same path that the C++ algorithm will write.
    outFileName = kwargs["OutSQLiteFileName"]
    kwargs.setdefault(
        "ForceOverwrite",
        flags.GeoModel.DumpGeo.ForceOverwrite,
    )
    forceOverwrite = kwargs["ForceOverwrite"]
 
    # Reject an existing file unless overwrite is enabled. Destructive removal
    # is deliberately deferred to DumpGeo::initialize(), immediately before
    # the C++ algorithm opens the output database.
    validateDumpGeoOutputFile(
        outFileName,
        forceOverwrite,
    )
 
    # Schedule the DumpGeo Athena Algorithm
    result = ComponentAccumulator()
    the_alg = CompFactory.DumpGeo(name=name, **kwargs)
    result.addEventAlgo(the_alg, primary=True)
    return result
 
 

dumpGeoHasInputFiles()

dumpGeoHasInputFiles

(

input_files

)

Return whether standalone DumpGeo was given real input files.

Definition at line 150 of file DumpGeoConfig.py.

def dumpGeoHasInputFiles(input_files):
    """Return whether standalone DumpGeo was given real input files."""
    return bool(input_files) and input_files != [
        "_ATHENA_GENERIC_INPUTFILE_NAME_"
    ]
 
 

dumpGeoOutputFileName()

dumpGeoOutputFileName

(

flags

)

Return the configured DumpGeo SQLite output file name.

Definition at line 128 of file DumpGeoConfig.py.

def dumpGeoOutputFileName(flags):
    """Return the configured DumpGeo SQLite output file name."""
    if flags.GeoModel.DumpGeo.OutputFileName:
        return flags.GeoModel.DumpGeo.OutputFileName
 
    output_file = f"geometry-{flags.GeoModel.AtlasVersion}"
    filter_det_managers = flags.GeoModel.DumpGeo.FilterDetManagers
    if filter_det_managers:
        output_file += "-" + "-".join(filter_det_managers)
 
    return output_file + ".db"
 
 

getATLASVersion()

getATLASVersion

(

)

Definition at line 120 of file DumpGeoConfig.py.

def getATLASVersion():
    if "AtlasVersion" in os.environ:
        return os.environ["AtlasVersion"]
    if "AtlasBaseVersion" in os.environ:
        return os.environ["AtlasBaseVersion"]
    return "Unknown"
 
 

logZDCFailureReminder()

logZDCFailureReminder	(		zdc_enabled,
			run_succeeded )

Remind standalone users about ZDC diagnostics after a failed run.

Definition at line 190 of file DumpGeoConfig.py.

def logZDCFailureReminder(zdc_enabled, run_succeeded):
    """Remind standalone users about ZDC diagnostics after a failed run."""
    if zdc_enabled and not run_succeeded:
        _logger.error(
            "DumpGeo failed while ZDC geometry was enabled. Check the "
            "preceding ZDC_DetTool messages: the selected geometry tag "
            "may not contain ZDC geometry information."
        )
 
 

resolveDumpGeoGeometryTag()

resolveDumpGeoGeometryTag	(		det_descr,
			configured_tag,
			fallback_tag )

Resolve the geometry tag using the DumpGeo command-line precedence.

Definition at line 141 of file DumpGeoConfig.py.

def resolveDumpGeoGeometryTag(det_descr, configured_tag, fallback_tag):
    """Resolve the geometry tag using the DumpGeo command-line precedence."""
    if det_descr:
        return det_descr
    if configured_tag:
        return configured_tag
    return fallback_tag
 
 

validateDumpGeoOutputFile()

validateDumpGeoOutputFile	(		output_file,
			force_overwrite )

Reject an existing output file unless overwrite is enabled.

Definition at line 179 of file DumpGeoConfig.py.

def validateDumpGeoOutputFile(output_file, force_overwrite):
    """Reject an existing output file unless overwrite is enabled."""
    if os.path.exists(output_file) and not force_overwrite:
        raise ConfigurationError(
            f"DumpGeo output file '{output_file}' already exists. "
            "Move or remove it, or enable "
            "'GeoModel.DumpGeo.ForceOverwrite' "
            "(or use the '-f' option from the command line)."
        )
 
 

Variable Documentation

_logger

DumpGeoConfig._logger = logging.getLogger('DumpGeo')

protected

Definition at line 26 of file DumpGeoConfig.py.

action

DumpGeoConfig.action

Definition at line 318 of file DumpGeoConfig.py.

args

DumpGeoConfig.args = flags.fillFromArgs(parser=parser)

Definition at line 323 of file DumpGeoConfig.py.

AtlasVersion

DumpGeoConfig.AtlasVersion

Definition at line 375 of file DumpGeoConfig.py.

cfg

DumpGeoConfig.cfg = MainServicesCfg(flags)

Definition at line 457 of file DumpGeoConfig.py.

configured_geometry_tag

DumpGeoConfig.configured_geometry_tag = None

Definition at line 362 of file DumpGeoConfig.py.

debugCAlevel

DumpGeoConfig.debugCAlevel = int(args.debugCA)

Definition at line 466 of file DumpGeoConfig.py.

default

DumpGeoConfig.default

Definition at line 305 of file DumpGeoConfig.py.

dumpgeo_empty_input

tuple dumpgeo_empty_input = configureDumpGeoInputFlags(flags)

Definition at line 347 of file DumpGeoConfig.py.

FilterDetManagers

DumpGeoConfig.FilterDetManagers

Definition at line 332 of file DumpGeoConfig.py.

flags

DumpGeoConfig.flags = initConfigFlags()

Definition at line 275 of file DumpGeoConfig.py.

ForceOverwrite

DumpGeoConfig.ForceOverwrite

Definition at line 340 of file DumpGeoConfig.py.

geometry_tag

DumpGeoConfig.geometry_tag

Initial value:

=  resolveDumpGeoGeometryTag(
        args.detDescr,
        configured_geometry_tag,
        defaultGeometryTags.RUN3,
    )

Definition at line 365 of file DumpGeoConfig.py.

GlobalTag

DumpGeoConfig.GlobalTag

Definition at line 430 of file DumpGeoConfig.py.

help

DumpGeoConfig.help

Definition at line 306 of file DumpGeoConfig.py.

input_geometry_tag

DumpGeoConfig.input_geometry_tag = input_metadata.get("GeoAtlas", None)

Definition at line 403 of file DumpGeoConfig.py.

input_metadata

DumpGeoConfig.input_metadata = GetFileMD(flags.Input.Files)

Definition at line 402 of file DumpGeoConfig.py.

isMC

DumpGeoConfig.isMC

Definition at line 431 of file DumpGeoConfig.py.

keep_beampipe

DumpGeoConfig.keep_beampipe

Definition at line 447 of file DumpGeoConfig.py.

MaxEvents

DumpGeoConfig.MaxEvents

Definition at line 277 of file DumpGeoConfig.py.

MCCampaign

DumpGeoConfig.MCCampaign

Definition at line 432 of file DumpGeoConfig.py.

metavar

DumpGeoConfig.metavar

Definition at line 311 of file DumpGeoConfig.py.

NumThreads

DumpGeoConfig.NumThreads

Definition at line 290 of file DumpGeoConfig.py.

OutputFileName

DumpGeoConfig.OutputFileName

Definition at line 330 of file DumpGeoConfig.py.

parser

DumpGeoConfig.parser = flags.getArgumentParser(description="Dump the detector geometry to a GeoModel-based SQLite '.db' file.")

Definition at line 300 of file DumpGeoConfig.py.

prog

DumpGeoConfig.prog

Definition at line 301 of file DumpGeoConfig.py.

ProjectName

DumpGeoConfig.ProjectName

Definition at line 424 of file DumpGeoConfig.py.

RunNumbers

DumpGeoConfig.RunNumbers

Definition at line 425 of file DumpGeoConfig.py.

ShowTreetopContent

DumpGeoConfig.ShowTreetopContent

Definition at line 338 of file DumpGeoConfig.py.

status

DumpGeoConfig.status = cfg.run()

Definition at line 489 of file DumpGeoConfig.py.

TimeStamps

DumpGeoConfig.TimeStamps

Definition at line 426 of file DumpGeoConfig.py.

toggle_geometry

DumpGeoConfig.toggle_geometry

Definition at line 446 of file DumpGeoConfig.py.

TypedCollections

DumpGeoConfig.TypedCollections

Definition at line 427 of file DumpGeoConfig.py.

use_metadata

DumpGeoConfig.use_metadata

Definition at line 445 of file DumpGeoConfig.py.