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 68 of file G4GenericMessenger.hh.

Member Enumeration Documentation

UnitSpec

enum G4GenericMessenger::Command::UnitSpec

Enumerator
UnitCategory
UnitDefault

Definition at line 70 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 75 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 408 of file G4GenericMessenger.cc.

{
  return SetCandidates(0,candList);
}

SetCandidates() [2/2]

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

Definition at line 414 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 125 of file G4GenericMessenger.hh.

      {
        return SetUnit(u, UnitDefault);
      }

SetDefaultValue() [1/2]

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

(

const G4String &

defVal

)

Definition at line 428 of file G4GenericMessenger.cc.

{
  return SetDefaultValue(0,defVal);
}

SetDefaultValue() [2/2]

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

Definition at line 434 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 115 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 383 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 360 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 366 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 110 of file G4GenericMessenger.hh.

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

SetStates() [1/5]

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

inline

Definition at line 81 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 86 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 91 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 97 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 103 of file G4GenericMessenger.hh.

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

SetToBeBroadcasted()

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

inline

Definition at line 137 of file G4GenericMessenger.hh.

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

SetToBeFlushed()

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

inline

Definition at line 142 of file G4GenericMessenger.hh.

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

SetUnit()

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

Definition at line 271 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 121 of file G4GenericMessenger.hh.

      {
        return SetUnit(u, UnitCategory);
      }

SetWorkerThreadOnly()

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

inline

Definition at line 147 of file G4GenericMessenger.hh.

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

Member Data Documentation

command

G4UIcommand* G4GenericMessenger::Command::command = nullptr

Definition at line 153 of file G4GenericMessenger.hh.

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

type

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

Definition at line 154 of file G4GenericMessenger.hh.

Referenced by SetUnit().

---

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

• G4GenericMessenger.hh
• G4GenericMessenger.cc