Util Namespace Reference

Classes
struct	KahanAccumulation

Functions
std::string	getGitRevision ()
double	erfinv (double x)
Vector_t	getTaitBryantAngles (Quaternion rotation, const std::string &)
std::string	toUpper (const std::string &str)
std::string	boolToUpperString (const bool &b)
std::string	boolVectorToUpperString (const std::vector< bool > &b)
std::string	doubleVectorToString (const std::vector< double > &v)
std::string	combineFilePath (std::initializer_list< std::string > ilist)
void	checkInt (double real, const std::string &name, double tolerance)
bool	isAllDigits (const std::string &str)
std::string	replaceAll (const std::string &str, const std::string &from, const std::string &to)
std::vector< std::string >	split_any_of (const std::string &s, const std::string &delims, bool compress)
std::string	compressString (const std::string &str)
unsigned int	rewindLinesSDDS (const std::string &fileName, double maxSPos, bool checkForTime)
	rewind the SDDS file such that the spos of the last step is less or equal to maxSPos
std::string	base64_encode (const std::string &string_to_encode)
std::string	base64_decode (std::string const &encoded_string)
double	getGamma (Vector_t p)
Vector_t	getBeta (Vector_t p)
double	getKineticEnergy (Vector_t p, double mass)
double	getBetaGamma (double Ekin, double mass)
double	convertMomentumEVoverCToBetaGamma (double p, double mass)
std::string	getTimeString (double time, unsigned int precision=3)
std::string	getLengthString (double spos, unsigned int precision=3)
std::string	getLengthString (Vector_t spos, unsigned int precision=3)
std::string	getEnergyString (double energyInMeV, unsigned int precision=3)
std::string	getChargeString (double charge, unsigned int precision=3)
double	angle_0to2pi (double angle)
	convert angle (in rad) to [0,2pi) range, from https://stackoverflow.com/a/29721295
bool	angleBetweenAngles (const double angle, const double min, const double max)
	check if angle (in rad and in range [0,2pi]) is within [min, max]
template<class IteratorIn , class IteratorOut >
void	toString (IteratorIn first, IteratorIn last, IteratorOut out)
std::string	trim_chars (const std::string &s, const std::string &chars)
template<typename T >
std::string	toStringWithThousandSep (T value, char sep='\'')
template<typename Enum , std::size_t N>
constexpr Enum	stringToEnum (std::string_view str, const std::array< std::pair< Enum, std::string_view >, N > &map, Enum defaultEnum) noexcept
template<typename Enum , std::size_t N>
constexpr std::string_view	enumToString (Enum e, const std::array< std::pair< Enum, std::string_view >, N > &map, std::string_view defaultStr) noexcept
template<typename It >
std::string	join (It begin, It end, const std::string &delimiter)
template<typename Container >
std::string	join (const Container &container, const std::string &delimiter)
template<typename T , typename A >
T *	c_data (std::vector< T, A > &v)
template<typename T , typename A >
T const *	c_data (std::vector< T, A > const &v)

Function Documentation

angle_0to2pi()

double Util::angle_0to2pi ( double  angle )

inline

convert angle (in rad) to [0,2pi) range, from https://stackoverflow.com/a/29721295

Definition at line 202 of file Util.h.

References Physics::two_pi.

Referenced by TrimCoil::applyField(), and TrimCoil::setAzimuth().

angleBetweenAngles()

bool Util::angleBetweenAngles ( const double  angle, const double  min, const double  max  )

inline

check if angle (in rad and in range [0,2pi]) is within [min, max]

Definition at line 209 of file Util.h.

References max(), and min().

Referenced by TrimCoil::applyField(), Cyclotron::checkInitialReferenceParticle(), and ParallelCyclotronTracker::visitRing().

Here is the call graph for this function:

base64_decode()

std::string Util::base64_decode

(

std::string const &

encoded_string

)

Definition at line 493 of file Util.cpp.

base64_encode()

std::string Util::base64_encode

(

const std::string &

string_to_encode

)

Definition at line 449 of file Util.cpp.

Referenced by MeshGenerator::write().

boolToUpperString()

std::string Util::boolToUpperString

(

const bool &

b

)

Definition at line 161 of file Util.cpp.

References toUpper().

Referenced by boolVectorToUpperString(), and ParticleMatterInteraction::print().

Here is the call graph for this function:

boolVectorToUpperString()

std::string Util::boolVectorToUpperString

(

const std::vector< bool > &

b

)

Definition at line 168 of file Util.cpp.

References boolToUpperString().

Referenced by ParallelCyclotronTracker::visitCyclotron().

Here is the call graph for this function:

c_data() [1/2]

template<typename T , typename A >

T * Util::c_data

(

std::vector< T, A > &

v

)

Definition at line 317 of file Util.h.

Referenced by H5PartWrapper::copyHeader(), H5PartWrapper::copyStepData(), H5PartWrapper::copyStepHeader(), H5PartWrapperForPC::readStepData(), H5PartWrapperForPT::readStepData(), H5PartWrapperForPC::writeStepData(), and H5PartWrapperForPT::writeStepData().

c_data() [2/2]

template<typename T , typename A >

T const * Util::c_data

(

std::vector< T, A > const &

v

)

Definition at line 320 of file Util.h.

checkInt()

void Util::checkInt	(	double	real,
		const std::string &	name,
		double	tolerance
	)

Definition at line 212 of file Util.cpp.

References name, and real().

Referenced by DumpEMFields::buildGrid(), and DumpFields::buildGrid().

Here is the call graph for this function:

combineFilePath()

std::string Util::combineFilePath

(

std::initializer_list< std::string >

ilist

)

Definition at line 204 of file Util.cpp.

Referenced by CSRIGFWakeFunction::apply(), CSRWakeFunction::apply(), Bend2D::calculateRefTrajectory(), _Fieldmap::checkMap(), BoundaryGeometry::computeMeshVoxelization(), _FM3DDynamic::getOnaxisEz(), Bend2D::getOutline(), CavityAutophaser::getPhaseAtMaxEnergy(), SigmaGenerator::initialize(), SigmaGenerator::match(), OrbitThreader::OrbitThreader(), LaserProfile::sampleDist(), OpalBeamline::save3DInput(), OpalBeamline::save3DLattice(), LaserProfile::saveData(), LaserProfile::saveHistogram(), IndexMap::saveSDDS(), RBend3D::trackRefParticleThrough(), SigmaGenerator::updateInitialSigma(), SigmaGenerator::updateSigma(), MeshGenerator::write(), _Fieldmap::write3DField(), DumpEMFields::writeFieldThis(), DumpFields::writeFieldThis(), FlexibleCollimator::writeHolesAndQuadtree(), SigmaGenerator::writeOrbitOutput_m(), Distribution::writeOutFileHeader(), and Cyclotron::writeOutputFieldFiles().

compressString()

std::string Util::compressString

(

const std::string &

str

)

Definition at line 271 of file Util.cpp.

Referenced by MeshGenerator::write().

convertMomentumEVoverCToBetaGamma()

double Util::convertMomentumEVoverCToBetaGamma ( double  p, double  mass  )

inline

Definition at line 72 of file Util.h.

Referenced by Distribution::adjustPhaseSpace(), Distribution::createDistributionFromFile(), Distribution::createOpalT(), Distribution::setSigmaP_m(), and Distribution::shiftDistCoordinates().

doubleVectorToString()

std::string Util::doubleVectorToString

(

const std::vector< double > &

v

)

Definition at line 183 of file Util.cpp.

References toString().

Referenced by ParallelCyclotronTracker::visitCyclotron().

Here is the call graph for this function:

enumToString()

template<typename Enum , std::size_t N>

constexpr std::string_view Util::enumToString ( Enum  e, const std::array< std::pair< Enum, std::string_view >, N > &  map, std::string_view  defaultStr  )

constexprnoexcept

Definition at line 271 of file Util.h.

Referenced by RFCavity::getCavityTypeString(), Option::getDumpFrameString(), ParticleProperties::getParticleTypeString(), Vacuum::getResidualGasName(), and TrackRun::getRunMethodName().

erfinv()

double Util::erfinv

(

double

x

)

Definition at line 62 of file Util.cpp.

References erfinv_a0, erfinv_a1, erfinv_a2, erfinv_a3, erfinv_b0, erfinv_b1, erfinv_b2, erfinv_b3, erfinv_b4, erfinv_c0, erfinv_c1, erfinv_c2, erfinv_c3, erfinv_d0, erfinv_d1, erfinv_d2, and Physics::pi.

Referenced by SampleGaussianSequence::SampleGaussianSequence().

getBeta()

Vector_t Util::getBeta ( Vector_t  p )

inline

Definition at line 54 of file Util.h.

References getGamma().

Referenced by FlexibleCollimator::apply(), Monitor::apply(), Source::apply(), Monitor::applyToReferenceParticle(), ScatteringPhysics::computeCoulombScattering(), Monitor::driftToCorrectPositionAndSave(), and ParallelCyclotronTracker::gapCrossKick_m().

Here is the call graph for this function:

getBetaGamma()

double Util::getBetaGamma ( double  Ekin, double  mass  )

inline

Definition at line 64 of file Util.h.

Referenced by Distribution::generateMatchedGauss(), RFCavity::getAutoPhaseEstimate(), RFCavity::getAutoPhaseEstimateFallback(), Distribution::setupEmissionModelAstra(), Distribution::setupEmissionModelNone(), and SigmaGenerator::SigmaGenerator().

getChargeString()

std::string Util::getChargeString ( double  charge, unsigned int  precision = 3  )

inline

Definition at line 173 of file Util.h.

Referenced by PartBunchBase< T, Dim >::print().

getEnergyString()

std::string Util::getEnergyString ( double  energyInMeV, unsigned int  precision = 3  )

inline

Definition at line 150 of file Util.h.

Referenced by ParallelTTracker::dumpStats(), and PartBunchBase< T, Dim >::print().

getGamma()

double Util::getGamma ( Vector_t  p )

inline

Definition at line 49 of file Util.h.

References dot().

Referenced by Corrector::apply(), PluginElement::changeWidth(), OrbitThreader::checkElementLengths(), DistributionMoments::computeDebyeLength(), ScatteringPhysics::computeEnergyLoss(), DistributionMoments::computeMeans(), ParallelCyclotronTracker::computeSpaceChargeFields_m(), ScatteringPhysics::copyFromBunch(), BeamStrippingPhysics::doPhysics(), ParallelTTracker::execute(), ParallelTTracker::findStartPosition(), getBeta(), getKineticEnergy(), ScatteringPhysics::push(), ParallelCyclotronTracker::push(), ScatteringPhysics::setTimeStepForLeavingParticles(), RFCavity::trackOnAxisParticle(), OrbitThreader::updateBoundingBoxWithCurrentPosition(), and ParallelTTracker::writePhaseSpace().

Here is the call graph for this function:

getGitRevision()

std::string Util::getGitRevision

(

)

Definition at line 38 of file Util.cpp.

Referenced by SDDSWriter::addDefaultParameters(), opalMain(), SDDSWriter::replaceVersionString(), StringConstant::StringConstant(), H5PartWrapperForPC::writeHeader(), H5PartWrapperForPT::writeHeader(), LossDataSink::writeHeaderH5(), Sampler::writeJsonHeader(), and AmrMultiGrid::writeSDDSHeader_m().

getKineticEnergy()

double Util::getKineticEnergy ( Vector_t  p, double  mass  )

inline

Definition at line 59 of file Util.h.

References getGamma().

Referenced by DistributionMoments::computeMeanKineticEnergy(), DistributionMoments::computeStatistics(), BeamStrippingPhysics::doPhysics(), ParallelTTracker::findStartPosition(), RFCavity::getAutoPhaseEstimateFallback(), CavityAutophaser::getPhaseAtMaxEnergy(), CavityAutophaser::guessCavityPhase(), CavityAutophaser::track(), and RFCavity::trackOnAxisParticle().

Here is the call graph for this function:

getLengthString() [1/2]

std::string Util::getLengthString ( double  spos, unsigned int  precision = 3  )

inline

Definition at line 100 of file Util.h.

Referenced by ParallelTTracker::dumpStats(), ParallelTTracker::execute(), and PartBunchBase< T, Dim >::print().

getLengthString() [2/2]

std::string Util::getLengthString ( Vector_t  spos, unsigned int  precision = 3  )

inline

Definition at line 119 of file Util.h.

getTaitBryantAngles()

Vector_t Util::getTaitBryantAngles	(	Quaternion	rotation,
		const std::string &
	)

Definition at line 122 of file Util.cpp.

References Quaternion::conjugate(), euclidean_norm(), Quaternion::rotate(), and Physics::two_pi.

Referenced by OpalBeamline::save3DInput(), and H5PartWrapperForPT::writeStepHeader().

Here is the call graph for this function:

getTimeString()

std::string Util::getTimeString ( double  time, unsigned int  precision = 3  )

inline

Definition at line 77 of file Util.h.

Referenced by ParallelTTracker::dumpStats(), ParallelTTracker::execute(), and PartBunchBase< T, Dim >::print().

isAllDigits()

bool Util::isAllDigits

(

const std::string &

str

)

Check if there are only digits in a string from https://stackoverflow.com/questions/19678572/how-to-validate-that-there-are-only-digits-in-a-string

Definition at line 225 of file Util.cpp.

Referenced by FieldSolver::getTagging_m().

join() [1/2]

template<typename Container >

std::string Util::join	(	const Container &	container,
		const std::string &	delimiter
	)

Definition at line 299 of file Util.h.

References join().

Here is the call graph for this function:

join() [2/2]

template<typename It >

std::string Util::join	(	It	begin,
		It	end,
		const std::string &	delimiter
	)

Definition at line 281 of file Util.h.

References begin(), and end().

Referenced by join(), and AttributeHandler::setPredefinedValues().

Here is the call graph for this function:

replaceAll()

std::string Util::replaceAll	(	const std::string &	str,
		const std::string &	from,
		const std::string &	to
	)

Definition at line 231 of file Util.cpp.

Referenced by OpalParser::readStatement().

rewindLinesSDDS()

unsigned int Util::rewindLinesSDDS	(	const std::string &	fileName,
		double	maxSPos,
		bool	checkForTime
	)

rewind the SDDS file such that the spos of the last step is less or equal to maxSPos

Definition at line 305 of file Util.cpp.

References Physics::c, end(), endl(), INFOMSG, level2(), IpplInfo::myNode(), and name.

Referenced by StatBaseWriter::rewindToSpos(), and Monitor::writeStatistics().

Here is the call graph for this function:

split_any_of()

std::vector< std::string > Util::split_any_of	(	const std::string &	s,
		const std::string &	delims,
		bool	compress
	)

Definition at line 250 of file Util.cpp.

Referenced by OpalSimulation::collectResults(), and GenerateOpalSimulation::fillDictionary().

stringToEnum()

template<typename Enum , std::size_t N>

constexpr Enum Util::stringToEnum ( std::string_view  str, const std::array< std::pair< Enum, std::string_view >, N > &  map, Enum  defaultEnum  )

constexprnoexcept

Definition at line 261 of file Util.h.

Referenced by ParticleProperties::getParticleType(), Option::handlePsDumpFrame(), RFCavity::setCavityType(), Vacuum::setResidualGas(), and TrackRun::setRunMethod().

toString()

template<class IteratorIn , class IteratorOut >

void Util::toString	(	IteratorIn	first,
		IteratorIn	last,
		IteratorOut	out
	)

Definition at line 358 of file Util.h.

Referenced by doubleVectorToString().

toStringWithThousandSep()

template<typename T >

std::string Util::toStringWithThousandSep	(	T	value,
		char	sep = '\''
	)

Definition at line 324 of file Util.h.

Referenced by BeamStrippingPhysics::print(), and ScatteringPhysics::print().

toUpper()

std::string Util::toUpper

(

const std::string &

str

)

Definition at line 152 of file Util.cpp.

Referenced by _Astra1DDynamic::_Astra1DDynamic(), _Astra1DElectroStatic::_Astra1DElectroStatic(), _Astra1DMagnetoStatic::_Astra1DMagnetoStatic(), _FM2DDynamic::_FM2DDynamic(), _FM2DElectroStatic::_FM2DElectroStatic(), _FM2DMagnetoStatic::_FM2DMagnetoStatic(), _FM3DDynamic::_FM3DDynamic(), _FM3DMagnetoStatic::_FM3DMagnetoStatic(), _FM3DMagnetoStaticExtended::_FM3DMagnetoStaticExtended(), Physics::Material::addMaterial(), boolToUpperString(), OpalSimulation::cleanUp(), FieldWriter::dumpField(), Physics::Material::getMaterial(), Attributes::getString(), Attributes::getStringArray(), VariableRFCavity::initialise(), Bend2D::initialise(), Attributes::makePredefinedString(), Attributes::makeUpperCaseString(), opalMain(), Attributes::PredefinedString::parse(), Attributes::PredefinedString::PredefinedString(), _FM1DDynamic::readFileHeader(), _FM1DDynamic_fast::readFileHeader(), _FM1DElectroStatic::readFileHeader(), _FM1DElectroStatic_fast::readFileHeader(), _FM1DMagnetoStatic::readFileHeader(), _FM1DMagnetoStatic_fast::readFileHeader(), _Astra1DDynamic_fast::readFileHeader(), _Astra1DElectroStatic_fast::readFileHeader(), _Astra1DMagnetoStatic_fast::readFileHeader(), Attributes::setPredefinedString(), MultipoleT::setScalingName(), and Attributes::setUpperCaseString().

trim_chars()

std::string Util::trim_chars ( const std::string &  s, const std::string &  chars  )

inline

Definition at line 245 of file Util.h.

Referenced by OpalSimulation::collectResults(), GenerateOpalSimulation::fillDictionary(), and CmdArguments::split().