EIC code displayed by LXR master/​include/​accel/​SetupOptions.hh	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2025-02-21 09:29:26

 //----------------------------------*-C++-*----------------------------------//
 // Copyright 2022-2024 UT-Battelle, LLC, and other Celeritas developers.
 // See the top-level COPYRIGHT file for details.
 // SPDX-License-Identifier: (Apache-2.0 OR MIT)
 //---------------------------------------------------------------------------//
 //! \file accel/SetupOptions.hh
 //---------------------------------------------------------------------------//
 #pragma once
 
 #include <functional>
 #include <memory>
 #include <string>
 #include <unordered_set>
 #include <vector>
 
 #include "corecel/sys/Device.hh"
 #include "celeritas/Types.hh"
 #include "celeritas/global/ActionInterface.hh"
 
 class G4LogicalVolume;
 
 namespace celeritas
 {
 struct AlongStepFactoryInput;
 //---------------------------------------------------------------------------//
 /*!
  * Control options for initializing Celeritas SD callbacks.
  *
  * These affect only the \c HitManager construction that is responsible for
  * reconstructing CPU hits and sending directly to the Geant4 detectors.
  *
  * Various attributes on the step, track, and pre/post step points may be
  * available depending on the selected options.
  * - Disabling \c track will leave \c G4Step::GetTrack as \c nullptr
  * - Enabling \c locate_touchable will also set \c Material and \c
  *   MaterialCutsCouple
  * - Enabling \c track will set particle the \c Charge attribute on the
  *   pre-step
  * - Requested post-step data including \c GlobalTime, \c Position, \c
  *   KineticEnergy, and \c MomentumDirection will be copied to the \c Track
  *   when the combination of options is enabled
  * - Track and Parent IDs will \em never be a valid value since Celeritas track
  *   counters are independent from Geant4 track counters.
  */
 struct SDSetupOptions
 {
     struct StepPoint
     {
         bool global_time{false};
         bool position{false};
         bool direction{false};  //!< AKA momentum direction
         bool kinetic_energy{false};
     };
 
     //! Call back to Geant4 sensitive detectors
     bool enabled{false};
     //! Skip steps that do not deposit energy locally
     bool ignore_zero_deposition{true};
     //! Save energy deposition
     bool energy_deposition{true};
     //! Set TouchableHandle for PreStepPoint
     bool locate_touchable{false};
     //! Create a track with the dynamic particle type and post-step data
     bool track{false};
     //! Options for saving and converting beginning-of-step data
     StepPoint pre;
     //! Options for saving and converting end-of-step data
     StepPoint post;
 
     //! Manually list LVs that don't have an SD on the master thread
     std::unordered_set<G4LogicalVolume const*> force_volumes;
     //! List LVs that should *not* have automatic hit mapping
     std::unordered_set<G4LogicalVolume const*> skip_volumes;
 
     //! True if SD is enabled
     explicit operator bool() const { return this->enabled; }
 };
 
 //---------------------------------------------------------------------------//
 /*!
  * Control options for initializing Celeritas.
  *
  * The interface for the "along-step factory" (input parameters and output) is
  * described in \c AlongStepFactoryInterface .
  */
 struct SetupOptions
 {
     //!@{
     //! \name Type aliases
     using size_type = unsigned int;
     using real_type = double;
 
     using SPConstAction = std::shared_ptr<CoreStepActionInterface const>;
     using AlongStepFactory
         = std::function<SPConstAction(AlongStepFactoryInput const&)>;
     using IntAccessor = std::function<int()>;
     using VecString = std::vector<std::string>;
     //!@}
 
     //! Don't limit the number of steps
     static constexpr size_type no_max_steps()
     {
         return static_cast<size_type>(-1);
     }
 
     //!@{
     //! \name I/O
     //! GDML filename (optional: defaults to exporting existing Geant4)
     std::string geometry_file;
     //! Filename for JSON diagnostic output
     std::string output_file;
     //! Filename for ROOT dump of physics data
     std::string physics_output_file;
     //! Filename to dump a HepMC3 copy of offloaded tracks as events
     std::string offload_output_file;
     //!@}
 
     //!@{
     //! \name Celeritas stepper options
     //! Number of track "slots" to be transported simultaneously
     size_type max_num_tracks{};
     //! Maximum number of events in use
     size_type max_num_events{};
     //! Limit on number of step iterations before aborting
     size_type max_steps = no_max_steps();
     //! Maximum number of track initializers (primaries+secondaries)
     size_type initializer_capacity{};
     //! At least the average number of secondaries per track slot
     real_type secondary_stack_factor{3.0};
     //! Number of tracks to buffer before offloading (if unset: max num tracks)
     size_type auto_flush{};
     //!@}
 
     //!@{
     //! \name Track reordering options
     TrackOrder track_order{Device::num_devices() ? TrackOrder::init_charge
                                                  : TrackOrder::none};
     //!@}
 
     //! Set the number of streams (defaults to run manager # threads)
     IntAccessor get_num_streams;
 
     //!@{
     //! \name Stepping actions
     AlongStepFactory make_along_step;
     //!@}
 
     //!@{
     //! \name Field options
     short int max_field_substeps{100};
     //!@}
 
     //!@{
     //! \name Sensitive detector options
     SDSetupOptions sd;
     //!@}
 
     //!@{
     //! \name Physics options
     //! Ignore the following EM process names
     VecString ignore_processes;
     //!@}
 
     //!@{
     //! \name CUDA options
     size_type cuda_stack_size{};
     size_type cuda_heap_size{};
     //! Sync the GPU at every kernel for timing
     bool action_times{false};
     //! Launch all kernels on the default stream
     bool default_stream{false};
     //!@}
 
     //!@{
     //! \name Diagnostic setup
     //! Filename base for slot diagnostics
     std::string slot_diagnostic_prefix;
     //!@}
 };
 
 //---------------------------------------------------------------------------//
 // FREE FUNCTIONS
 //---------------------------------------------------------------------------//
 
 // Find volumes by name for SDSetupOptions
 std::unordered_set<G4LogicalVolume const*>
     FindVolumes(std::unordered_set<std::string>);
 
 //---------------------------------------------------------------------------//
 }  // namespace celeritas

This page was automatically generated by the 2.3.7 LXR engine. The LXR team