G4GenericMessenger::Command Struct Reference

#include <G4GenericMessenger.hh>

Inheritance diagram for G4GenericMessenger::Command:

Public Types
enum	UnitSpec { UnitCategory , UnitDefault }

Public Member Functions
	Command (G4UIcommand *cmd, const std::type_info &ti)
	Command ()=default
Command &	SetStates (G4ApplicationState s0)
Command &	SetStates (G4ApplicationState s0, G4ApplicationState s1)
Command &	SetStates (G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2)
Command &	SetStates (G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2, G4ApplicationState s3)
Command &	SetStates (G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2, G4ApplicationState s3, G4ApplicationState s4)
Command &	SetRange (const G4String &range)
Command &	SetGuidance (const G4String &s0)
Command &	SetUnit (const G4String &, UnitSpec=UnitDefault)
Command &	SetUnitCategory (const G4String &u)
Command &	SetDefaultUnit (const G4String &u)
Command &	SetParameterName (const G4String &, G4bool, G4bool=false)
Command &	SetParameterName (G4int pIdx, const G4String &, G4bool, G4bool=false)
Command &	SetParameterName (const G4String &, const G4String &, const G4String &, G4bool, G4bool=false)
Command &	SetDefaultValue (const G4String &)
Command &	SetDefaultValue (G4int pIdx, const G4String &)
Command &	SetCandidates (const G4String &)
Command &	SetCandidates (G4int pIdx, const G4String &)
Command &	SetToBeBroadcasted (G4bool s0)
Command &	SetToBeFlushed (G4bool s0)
Command &	SetWorkerThreadOnly (G4bool s0)

Public Attributes
G4UIcommand *	command = nullptr
const std::type_info *	type = nullptr

Detailed Description

Definition at line 65 of file G4GenericMessenger.hh.

Member Enumeration Documentation

UnitSpec

enum G4GenericMessenger::Command::UnitSpec

Enumerator
UnitCategory
UnitDefault

Definition at line 67 of file G4GenericMessenger.hh.

        {
          UnitCategory,
          UnitDefault
        };

Constructor & Destructor Documentation

Command() [1/2]

G4GenericMessenger::Command::Command ( G4UIcommand * cmd, const std::type_info & ti )

inline

Definition at line 72 of file G4GenericMessenger.hh.

: command(cmd), type(&ti) {}

Command() [2/2]

G4GenericMessenger::Command::Command ( )

default

Member Function Documentation

SetCandidates() [1/2]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetCandidates

(

const G4String &

candList

)

Definition at line 407 of file G4GenericMessenger.cc.

{
  return SetCandidates(0, candList);
}

SetCandidates() [2/2]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetCandidates	(	G4int	pIdx,
		const G4String &	candList )

Definition at line 412 of file G4GenericMessenger.cc.

{
  if (pIdx < 0 || pIdx >= (G4int)(command->GetParameterEntries())) {
    G4cerr << "Invalid parameter index : " << pIdx << "\nMethod ignored." << G4endl;
    return *this;
  }
  G4UIparameter* theParam = command->GetParameter(pIdx);
  theParam->SetParameterCandidates(candList);
  return *this;
}

SetDefaultUnit()

Command & G4GenericMessenger::Command::SetDefaultUnit ( const G4String & u )

inline

Definition at line 114 of file G4GenericMessenger.hh.

{ return SetUnit(u, UnitDefault); }

SetDefaultValue() [1/2]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetDefaultValue

(

const G4String &

defVal

)

Definition at line 424 of file G4GenericMessenger.cc.

{
  return SetDefaultValue(0, defVal);
}

SetDefaultValue() [2/2]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetDefaultValue	(	G4int	pIdx,
		const G4String &	defVal )

Definition at line 429 of file G4GenericMessenger.cc.

{
  if (pIdx < 0 || pIdx >= (G4int)(command->GetParameterEntries())) {
    G4cerr << "Invalid parameter index : " << pIdx << "\nMethod ignored." << G4endl;
    return *this;
  }
  G4UIparameter* theParam = command->GetParameter(pIdx);
  theParam->SetDefaultValue(defVal);
  return *this;
}

SetGuidance()

Command & G4GenericMessenger::Command::SetGuidance ( const G4String & s0 )

inline

Definition at line 107 of file G4GenericMessenger.hh.

        {
          command->SetGuidance(s0);
          return *this;
        }

SetParameterName() [1/3]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetParameterName	(	const G4String &	namex,
		const G4String &	namey,
		const G4String &	namez,
		G4bool	omittable,
		G4bool	currentAsDefault = false )

Definition at line 381 of file G4GenericMessenger.cc.

{
  if (*type != typeid(G4ThreeVector)) {
    G4cerr << "This SetParameterName method is for G4ThreeVector!! "
           << "Method ignored." << G4endl;
    return *this;
  }
  G4UIparameter* theParam = command->GetParameter(0);
  theParam->SetParameterName(namex);
  theParam->SetOmittable(omittable);
  theParam->SetCurrentAsDefault(currentAsDefault);
  theParam = command->GetParameter(1);
  theParam->SetParameterName(namey);
  theParam->SetOmittable(omittable);
  theParam->SetCurrentAsDefault(currentAsDefault);
  theParam = command->GetParameter(2);
  theParam->SetParameterName(namez);
  theParam->SetOmittable(omittable);
  theParam->SetCurrentAsDefault(currentAsDefault);
  return *this;
}

SetParameterName() [2/3]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetParameterName	(	const G4String &	name,
		G4bool	omittable,
		G4bool	currentAsDefault = false )

Definition at line 358 of file G4GenericMessenger.cc.

{
  return SetParameterName(0, name, omittable, currentAsDefault);
}

SetParameterName() [3/3]

G4GenericMessenger::Command & G4GenericMessenger::Command::SetParameterName	(	G4int	pIdx,
		const G4String &	name,
		G4bool	omittable,
		G4bool	currentAsDefault = false )

Definition at line 365 of file G4GenericMessenger.cc.

{
  if (pIdx < 0 || pIdx >= (G4int)(command->GetParameterEntries())) {
    G4cerr << "Invalid parameter index : " << pIdx << "\nMethod ignored." << G4endl;
    return *this;
  }
  G4UIparameter* theParam = command->GetParameter(pIdx);
  theParam->SetParameterName(name);
  theParam->SetOmittable(omittable);
  theParam->SetCurrentAsDefault(currentAsDefault);
  return *this;
}

SetRange()

Command & G4GenericMessenger::Command::SetRange ( const G4String & range )

inline

Definition at line 102 of file G4GenericMessenger.hh.

        {
          command->SetRange(range.c_str());
          return *this;
        }

SetStates() [1/5]

Command & G4GenericMessenger::Command::SetStates ( G4ApplicationState s0 )

inline

Definition at line 75 of file G4GenericMessenger.hh.

        {
          command->AvailableForStates(s0);
          return *this;
        }

Referenced by G4SteppingVerboseWithUnits::SetManager().

SetStates() [2/5]

Command & G4GenericMessenger::Command::SetStates ( G4ApplicationState s0, G4ApplicationState s1 )

inline

Definition at line 80 of file G4GenericMessenger.hh.

        {
          command->AvailableForStates(s0, s1);
          return *this;
        }

SetStates() [3/5]

Command & G4GenericMessenger::Command::SetStates ( G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2 )

inline

Definition at line 85 of file G4GenericMessenger.hh.

        {
          command->AvailableForStates(s0, s1, s2);
          return *this;
        }

SetStates() [4/5]

Command & G4GenericMessenger::Command::SetStates ( G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2, G4ApplicationState s3 )

inline

Definition at line 90 of file G4GenericMessenger.hh.

        {
          command->AvailableForStates(s0, s1, s2, s3);
          return *this;
        }

SetStates() [5/5]

Command & G4GenericMessenger::Command::SetStates ( G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2, G4ApplicationState s3, G4ApplicationState s4 )

inline

Definition at line 96 of file G4GenericMessenger.hh.

        {
          command->AvailableForStates(s0, s1, s2, s3, s4);
          return *this;
        }

SetToBeBroadcasted()

Command & G4GenericMessenger::Command::SetToBeBroadcasted ( G4bool s0 )

inline

Definition at line 123 of file G4GenericMessenger.hh.

        {
          command->SetToBeBroadcasted(s0);
          return *this;
        }

SetToBeFlushed()

Command & G4GenericMessenger::Command::SetToBeFlushed ( G4bool s0 )

inline

Definition at line 128 of file G4GenericMessenger.hh.

        {
          command->SetToBeFlushed(s0);
          return *this;
        }

SetUnit()

G4GenericMessenger::Command & G4GenericMessenger::Command::SetUnit	(	const G4String &	unit,
		UnitSpec	spec = UnitDefault )

Definition at line 281 of file G4GenericMessenger.cc.

{
  // Change the type of command (unfortunatelly this is done a posteriory)
  // We need to delete the old command before creating the new one and therefore
  // we need to recover the information before the deletetion
  if (G4Threading::IsMultithreadedApplication()) {
    G4String cmdpath = command->GetCommandPath();
    G4ExceptionDescription ed;
    ed << "G4GenericMessenger::Command::SetUnit() is thread-unsafe and should "
          "not be used\n"
       << "in multi-threaded mode. For your command <" << cmdpath << ">, use\n"
       << " DeclarePropertyWithUnit(const G4String& name, const G4String& "
          "defaultUnit,\n"
       << "                         const G4AnyType& variable, const G4String& "
          "doc)\n"
       << "or\n"
       << " DeclareMethodWithUnit(const G4String& name, const G4String& "
          "defaultUnit,\n"
       << "                       const G4AnyType& variable, const G4String& "
          "doc)\n"
       << "to define a command with a unit <" << unit << ">.";
    if (spec != UnitDefault) {
      ed << "\nPlease use a default unit instead of unit category.";
    }
    G4Exception("G4GenericMessenger::Command::SetUnit()", "Intercom70001", FatalException, ed);
    return *this;
  }
 
  G4String cmdpath = command->GetCommandPath();
  G4UImessenger* messenger = command->GetMessenger();
  G4String range = command->GetRange();
  std::vector<G4String> guidance;
  G4String par_name = command->GetParameter(0)->GetParameterName();
  G4bool par_omitable = command->GetParameter(0)->IsOmittable();
  for (G4int i = 0; i < (G4int)command->GetGuidanceEntries(); ++i) {
    guidance.push_back(command->GetGuidanceLine(i));
  }
  // Before deleting the command we need to add a fake one to avoid deleting
  // the directory entry and with its guidance
  G4UIcommand tmp((cmdpath + "_tmp").c_str(), messenger);
  delete command;
 
  if (*type == typeid(float) || *type == typeid(double)) {
    auto* cmd_t = new G4UIcmdWithADoubleAndUnit(cmdpath, messenger);
    if (spec == UnitDefault) {
      cmd_t->SetDefaultUnit(unit);
    }
    else if (spec == UnitCategory) {
      cmd_t->SetUnitCategory(unit);
    }
    cmd_t->SetParameterName(par_name, par_omitable);
    command = cmd_t;
  }
  else if (*type == typeid(G4ThreeVector)) {
    auto* cmd_t = new G4UIcmdWith3VectorAndUnit(cmdpath, messenger);
    if (spec == UnitDefault) {
      cmd_t->SetDefaultUnit(unit);
    }
    else if (spec == UnitCategory) {
      cmd_t->SetUnitCategory(unit);
    }
    command = cmd_t;
  }
  else {
    G4cerr << "Only parameters of type <double> or <float> can be associated "
              "with units"
           << G4endl;
    return *this;
  }
  for (auto& i : guidance) {
    command->SetGuidance(i);
  }
  command->SetRange(range);
  return *this;
}

Referenced by SetDefaultUnit(), and SetUnitCategory().

SetUnitCategory()

Command & G4GenericMessenger::Command::SetUnitCategory ( const G4String & u )

inline

Definition at line 113 of file G4GenericMessenger.hh.

{ return SetUnit(u, UnitCategory); }

SetWorkerThreadOnly()

Command & G4GenericMessenger::Command::SetWorkerThreadOnly ( G4bool s0 )

inline

Definition at line 133 of file G4GenericMessenger.hh.

        {
          command->SetWorkerThreadOnly(s0);
          return *this;
        }

Member Data Documentation

command

G4UIcommand* G4GenericMessenger::Command::command = nullptr

Definition at line 139 of file G4GenericMessenger.hh.

Referenced by SetGuidance(), SetRange(), SetStates(), SetStates(), SetStates(), SetStates(), SetStates(), SetToBeBroadcasted(), SetToBeFlushed(), SetUnit(), and SetWorkerThreadOnly().

type

const std::type_info* G4GenericMessenger::Command::type = nullptr

Definition at line 140 of file G4GenericMessenger.hh.

Referenced by SetUnit().

---

The documentation for this struct was generated from the following files:

• G4GenericMessenger.hh
• G4GenericMessenger.cc