Inheritance diagram for ElossHarvestingRun:

Public Member Functions
	output_file_name (self)

	harvesting_module (self, path=None)

	create_argument_parser (self, **kwds)

	create_path (self)

	pickle_crops (self, harvesting_module, crops, **kwds)

	unpickle_crops (self)

	postprocess (self)

	adjust_path (self, path)

	run (self, path)

	name (self)

	configure_and_execute_from_commandline (self)

	execute (self)

	configure_from_commandline (self)

	configure (self, arguments)

Public Attributes
	pickle_crops = self.output_file_name

Static Public Attributes
bool	show_results = False
	By default, do not show the browsing results.

bool	postprocess_only = False
	By default, browse the output TFile too.

str	description = "Empty execution of basf2"
	Description of the run setup to be displayed on command line.

	generator_module = None
	By default, do not generate events.

str	detector_setup = "Default"
	By default, use the default detector setup.

list	bkg_files = []
	By default, no background overlay.

	components = None
	By default, do specific components.

bool	disable_deltas = False
	By default, do not disable delta-ray generation.

	simulation_output = None
	By default, do no store the simulation output.

bool	allow_input = True
	By default, this basf2 job can read events from an input ROOT TFile.

int	n_events = 10000
	By default, process 10000 events.

	root_input_file = None
	By default, there is no input ROOT TFile.

	random_seed = None
	By default, the random-number seed is unassigned.

int	n_processes = 0
	By default, no parallel processing.

int	n_events_to_skip = 0
	By default, do not skip any events at the start of the input ROOT TFile.

Detailed Description


Harvester to generate, postprocess and inspect MC events for energy-loss evaluation

Definition at line 93 of file record.py.

Member Function Documentation

◆ adjust_path()

adjust_path	(		self,
			path )

inherited


Add the harvester to the basf2 path

Reimplemented from EmptyRun.

Definition at line 66 of file run.py.

    def adjust_path(self, path):
        """Add the harvester to the basf2 path"""
        super().adjust_path(path)
        harvesting_module = self.harvesting_module()
        if self.output_file_name:
            harvesting_module.output_file_name = self.output_file_name
        harvesting_module.refiners.append(self.pickle_crops)
        path.add_module(harvesting_module)
        return path
 
 

◆ configure()

configure	(		self,
			arguments )

inherited


Save the command-line arguments as key-value pairs

Reimplemented in CDCDisplayRun, and ReadOrGenerateEventsRun.

Definition at line 73 of file minimal.py.

    def configure(self, arguments):
        """Save the command-line arguments as key-value pairs"""
        # Simply translate the arguments that have
        # the same name as valid instance arguments
        for (key, value) in list(vars(arguments).items()):
            if value is None:
                continue
            if hasattr(self, key):
                get_logger().info("Setting %s to %s", key, value)
                setattr(self, key, value)
 

◆ configure_and_execute_from_commandline()

configure_and_execute_from_commandline ( self )

inherited


Configure basf2 job script from command-line arguments then run it

Definition at line 45 of file minimal.py.

    def configure_and_execute_from_commandline(self):
        """Configure basf2 job script from command-line arguments then run it"""
        self.configure_from_commandline()
        self.execute()
 

◆ configure_from_commandline()

configure_from_commandline ( self )

inherited


Convert the command-line arguments to a basf2 job script

Definition at line 67 of file minimal.py.

    def configure_from_commandline(self):
        """Convert the command-line arguments to a basf2 job script"""
        argument_parser = self.create_argument_parser()
        arguments = argument_parser.parse_args()
        self.configure(arguments)
 

◆ create_argument_parser()

create_argument_parser	(		self,
		**	kwds )


Convert command-line arguments to basf2 argument list

Reimplemented from HarvestingRunMixin.

Definition at line 114 of file record.py.

    def create_argument_parser(self, **kwds):
        """Convert command-line arguments to basf2 argument list"""
        argument_parser = super().create_argument_parser(**kwds)
        return argument_parser
 

◆ create_path()

create_path ( self )

Sets up a path that plays back pregenerated events or generates events
based on the properties in the base class.

Reimplemented from EmptyRun.

Definition at line 119 of file record.py.

    def create_path(self):
        """
        Sets up a path that plays back pregenerated events or generates events
        based on the properties in the base class.
        """
        path = super().create_path()
 
        path.add_module("TFCDC_WireHitPreparer",
                        logLevel=8,
                        flightTimeEstimation="outwards",
                        UseNLoops=1)
 
        path.add_module('TFCDC_AxialTrackCreatorMCTruth',
                        logLevel=8,
                        useOnlyBeforeTOP=True,
                        fit=True,
                        reconstructedDriftLength=True,
                        reconstructedPositions=True)
 
        return path
 
 

◆ execute()

execute ( self )

inherited


Create the basf2 path then run the job

Reimplemented in ReadOrGenerateEventsRun.

Definition at line 50 of file minimal.py.

    def execute(self):
        """Create the basf2 path then run the job"""
        # Create path and run #
        
        path = self.create_path()
        self.adjust_path(path)
        self.run(path)
 

◆ harvesting_module()

harvesting_module	(		self,
			path = None )


Harvest and post-process the generated events

Reimplemented from HarvestingRunMixin.

Definition at line 107 of file record.py.

    def harvesting_module(self, path=None):
        """Harvest and post-process the generated events"""
        harvesting_module = ElossHarvestingModule(self.output_file_name)
        if path:
            path.add_module(harvesting_module)
        return harvesting_module
 

◆ name()

name ( self )

inherited


provide name of this object

Definition at line 41 of file minimal.py.

41 def name(self):

42 """provide name of this object"""

43 return self.__class__.__name__

44

◆ output_file_name()

output_file_name ( self )


Get the output ROOT filename

Reimplemented from HarvestingRunMixin.

Definition at line 103 of file record.py.

103 def output_file_name(self):

104 """Get the output ROOT filename"""

105 return 'eloss.root'

106

◆ pickle_crops()

pickle_crops	(		self,
			harvesting_module,
			crops,
		**	kwds )

inherited


Save the raw crops as a pickle file

Definition at line 41 of file run.py.

    def pickle_crops(self, harvesting_module, crops, **kwds):
        """Save the raw crops as a pickle file"""
        with open(self.output_file_name + ".pickle", "wb") as pickle_file:
            pickle.dump(crops, pickle_file)
 

◆ postprocess()

postprocess ( self )

inherited


Post-process the crops

Reimplemented from BrowseTFileOnTerminateRunMixin.

Definition at line 51 of file run.py.

    def postprocess(self):
        """Post-process the crops"""
        if self.postprocess_only:
            harvesting_module = self.harvesting_module()
            if self.output_file_name:
                harvesting_module.output_file_name = self.output_file_name
            try:
                crops = self.unpickle_crops()
            except FileNotFoundError:
                print("Crops pickle file not found. Create it now.")
            else:
                harvesting_module.refine(crops)
 
        super().postprocess()
 

◆ run()

run	(		self,
			path )

inherited


Post-process the basf2 job output

Reimplemented from EmptyRun.

Definition at line 45 of file mixins.py.

    def run(self, path):
        """Post-process the basf2 job output"""
        if not self.postprocess_only:
            super().run(path)
 
        self.postprocess()
 

◆ unpickle_crops()

unpickle_crops ( self )

inherited


Load the raw crops from a pickle file

Definition at line 46 of file run.py.

    def unpickle_crops(self):
        """Load the raw crops from a pickle file"""
        with open(self.output_file_name + ".pickle", "rb") as pickle_file:
            return pickle.load(pickle_file)
 

Member Data Documentation

◆ allow_input

bool allow_input = True

staticinherited

By default, this basf2 job can read events from an input ROOT TFile.

Definition at line 109 of file minimal.py.

◆ bkg_files

list bkg_files = []

staticinherited

By default, no background overlay.

Definition at line 47 of file event_generation.py.

◆ components

components = None

staticinherited

By default, do specific components.

Definition at line 49 of file event_generation.py.

◆ description

str description = "Empty execution of basf2"

staticinherited

Description of the run setup to be displayed on command line.

Definition at line 33 of file minimal.py.

◆ detector_setup

str detector_setup = "Default"

staticinherited

By default, use the default detector setup.

Definition at line 45 of file event_generation.py.

◆ disable_deltas

bool disable_deltas = False

staticinherited

By default, do not disable delta-ray generation.

Definition at line 51 of file event_generation.py.

◆ generator_module

generator_module = None

staticinherited

By default, do not generate events.

Definition at line 43 of file event_generation.py.

◆ n_events

n_events = 10000

staticinherited

By default, process 10000 events.

Definition at line 111 of file minimal.py.

◆ n_events_to_skip

int n_events_to_skip = 0

staticinherited

By default, do not skip any events at the start of the input ROOT TFile.

Definition at line 119 of file minimal.py.

◆ n_processes

n_processes = 0

staticinherited

By default, no parallel processing.

Definition at line 117 of file minimal.py.

◆ pickle_crops

pickle_crops = self.output_file_name

inherited

Definition at line 72 of file run.py.

◆ postprocess_only

bool postprocess_only = False

staticinherited

By default, browse the output TFile too.


Post-process the basf2 job output

Definition at line 29 of file mixins.py.

◆ random_seed

random_seed = None

staticinherited

By default, the random-number seed is unassigned.

Definition at line 115 of file minimal.py.

◆ root_input_file

root_input_file = None

staticinherited

By default, there is no input ROOT TFile.

Definition at line 113 of file minimal.py.

◆ show_results

bool show_results = False

staticinherited

By default, do not show the browsing results.

Definition at line 62 of file mixins.py.

◆ simulation_output

simulation_output = None

staticinherited

By default, do no store the simulation output.

Definition at line 53 of file event_generation.py.

The documentation for this class was generated from the following file:

tracking/trackFindingCDC/studies/eloss/record.py

Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Member Function Documentation

◆ adjust_path()

◆ configure()

◆ configure_and_execute_from_commandline()

◆ configure_from_commandline()

◆ create_argument_parser()

◆ create_path()

◆ execute()

◆ harvesting_module()

◆ name()

◆ output_file_name()

◆ pickle_crops()

◆ postprocess()

◆ run()

◆ unpickle_crops()

Member Data Documentation

◆ allow_input

◆ bkg_files

◆ components

◆ description

◆ detector_setup

◆ disable_deltas

◆ generator_module

◆ n_events

◆ n_events_to_skip

◆ n_processes

◆ pickle_crops

◆ postprocess_only

◆ random_seed

◆ root_input_file

◆ show_results

◆ simulation_output