Class implementing the Ideal HRG model. More...

#include <ThermalModelIdeal.h>

Inheritance diagram for thermalfist::ThermalModelIdeal:

Public Member Functions
	ThermalModelIdeal (ThermalParticleSystem *TPS, const ThermalModelParameters &params=ThermalModelParameters())
	Construct a new ThermalModelIdeal object.

virtual	~ThermalModelIdeal (void)
	Destroy the ThermalModelIdeal object.

virtual void	CalculatePrimordialDensities ()
	Calculates the primordial densities of all species.

virtual void	CalculateTwoParticleCorrelations ()
	Computes the fluctuations and correlations of the primordial particle numbers.

virtual void	CalculateFluctuations ()
	Computes the fluctuation observables.

virtual std::vector< double >	CalculateChargeFluctuations (const std::vector< double > &chgs, int order=4)
	Calculates fluctuations (diagonal susceptibilities) of an arbitrary "conserved" charge.

virtual std::vector< double >	CalculateGeneralizedSusceptibilities (const std::vector< std::vector< double > > &chgs)

virtual double	CalculateEnergyDensity ()

virtual double	CalculateEntropyDensity ()

virtual double	CalculateBaryonMatterEntropyDensity ()

virtual double	CalculateMesonMatterEntropyDensity ()

virtual double	CalculatePressure ()

virtual double	CalculateEnergyDensityDerivativeT ()

virtual double	ParticleScaledVariance (int part)

virtual double	ParticleSkewness (int part)

virtual double	ParticleKurtosis (int part)

virtual double	ParticleScalarDensity (int part)

virtual void	CalculateTemperatureDerivatives ()
	Computes the temperature derivatives of densities, shifted chemical potentials, and primordial hadron number susceptibilities.

Public Member Functions inherited from thermalfist::ThermalModelBase
	ThermalModelBase (ThermalParticleSystem *TPS, const ThermalModelParameters &params=ThermalModelParameters())
	Construct a new ThermalModelBase object.

virtual	~ThermalModelBase (void)

int	ComponentsNumber () const
	Number of different particle species in the list.

virtual void	FillVirial (const std::vector< double > &ri=std::vector< double >(0))
	Fills the excluded volume coefficients \( \tilde{b}_{ij} \) based on the provided radii parameters for all species.

bool	UseWidth () const
	Whether finite resonance widths are considered.

void	SetUseWidth (bool useWidth)
	Sets whether finite resonance widths are used. Deprecated.

void	SetUseWidth (ThermalParticle::ResonanceWidthIntegration type)
	Sets the finite resonance widths scheme to use.

void	SetNormBratio (bool normBratio)
	Whether branching ratios are renormalized to 100%.

bool	NormBratio () const

void	SetOMP (bool openMP)
	OpenMP support. Currently not used.

virtual void	SetParameters (const ThermalModelParameters &params)
	The thermal parameters.

const ThermalModelParameters &	Parameters () const

void	UpdateParameters ()
	Calls SetParameters() with current m_Parameters.

virtual void	SetTemperature (double T)
	Set the temperature.

virtual void	SetBaryonChemicalPotential (double muB)
	Set the baryon chemical potential.

virtual void	SetElectricChemicalPotential (double muQ)
	Set the electric chemical potential.

virtual void	SetStrangenessChemicalPotential (double muS)
	Set the strangeness chemical potential.

virtual void	SetCharmChemicalPotential (double muC)
	Set the charm chemical potential.

virtual void	SetGammaq (double gammaq)
	Set the light quark fugacity factor.

virtual void	SetGammaS (double gammaS)
	Set the strange quark fugacity factor.

virtual void	SetGammaC (double gammaC)
	Set the charm quark fugacity factor.

virtual void	SetBaryonCharge (int B)
	Set the total baryon number (for canonical ensemble only)

virtual void	SetElectricCharge (int Q)
	Set the total electric charge (for canonical ensemble only)

virtual void	SetStrangeness (int S)
	Set the total strangeness (for canonical ensemble only)

virtual void	SetCharm (int C)
	Set the total charm (for canonical ensemble only)

virtual void	SetRadius (double)
	Set the same excluded volume radius parameter for all species.

virtual void	SetRadius (int, double)
	Set the radius parameter for particle species i.

virtual void	SetVirial (int, int, double)
	Set the excluded volume coefficient \( \tilde{b}_{ij} \).

virtual void	SetRepulsion (int i, int j, double b)
	Same as SetVirial() but with a more clear name on what is actually does.

virtual void	SetAttraction (int, int, double)
	Set the vdW mean field attraction coefficient \( a_{ij} \).

virtual void	DisableMesonMesonVirial ()

void	DisableMesonMesonRepulsion ()

virtual void	DisableMesonMesonAttraction ()

virtual void	DisableMesonBaryonVirial ()

void	DisableMesonBaryonRepulsion ()

virtual void	DisableMesonBaryonAttraction ()

virtual void	DisableBaryonBaryonVirial ()

void	DisableBaryonBaryonRepulsion ()

virtual void	DisableBaryonBaryonAttraction ()

virtual void	DisableBaryonAntiBaryonVirial ()

void	DisableBaryonAntiBaryonRepulsion ()

virtual void	DisableBaryonAntiBaryonAttraction ()

virtual void	ReadInteractionParameters (const std::string &)
	Reads the QvdW interaction parameters from a file.

virtual void	WriteInteractionParameters (const std::string &)
	Write the QvdW interaction parameters to a file.

virtual void	ChangeTPS (ThermalParticleSystem *TPS)
	Change the particle list.

virtual double	VirialCoefficient (int, int) const
	Excluded volume coefficient \( \tilde{b}_{ij} = 0 \).

double	RepulsionCoefficient (int i, int j) const

virtual double	AttractionCoefficient (int, int) const
	QvdW mean field attraction coefficient \( a_{ij} \).

bool	QuantumStatistics () const

virtual void	SetStatistics (bool stats)

virtual void	SetCalculationType (IdealGasFunctions::QStatsCalculationType type)
	Sets the CalculationType() method to evaluate quantum statistics. Calls the corresponding method in TPS().

virtual void	SetClusterExpansionOrder (int order)
	Set the number of terms in the cluster expansion method. Calls the corresponding method in TPS().

void	SetResonanceWidthShape (ThermalParticle::ResonanceWidthShape shape)
	Set the ThermalParticle::ResonanceWidthShape for all particles. Calls the corresponding method in TPS().

void	SetResonanceWidthIntegrationType (ThermalParticle::ResonanceWidthIntegration type)
	Set the ThermalParticle::ResonanceWidthIntegration scheme for all particles. Calls the corresponding method in TPS().

virtual void	FillChemicalPotentials ()
	Sets the chemical potentials of all particles.

virtual void	SetChemicalPotentials (const std::vector< double > &chem=std::vector< double >(0))
	Sets the chemical potentials of all particles.

const std::vector< double > &	ChemicalPotentials () const
	A vector of chemical potentials of all particles.

double	ChemicalPotential (int i) const
	Chemical potential of particle species i.

virtual void	SetChemicalPotential (int i, double chem)
	Sets the chemical potential of particle species i.

virtual double	FullIdealChemicalPotential (int i) const
	Chemical potential entering the ideal gas expressions of particle species i.

bool	ConstrainMuB () const

void	ConstrainMuB (bool constrain)

bool	ConstrainMuQ () const

void	ConstrainMuQ (bool constrain)

bool	ConstrainMuS () const

void	ConstrainMuS (bool constrain)

bool	ConstrainMuC () const

void	ConstrainMuC (bool constrain)

void	UsePartialChemicalEquilibrium (bool usePCE)
	Sets whether partial chemical equilibrium with additional chemical potentials is used.

bool	UsePartialChemicalEquilibrium ()
	Whether partial chemical equilibrium with additional chemical potentials is used.

void	SetSoverB (double SB)
	The entropy per baryon ratio to be used to constrain the baryon chemical potential.

double	SoverB () const

void	SetQoverB (double QB)
	The electric-to-baryon charge ratio to be used to constrain the electric chemical potential.

double	QoverB () const

void	SetVolume (double Volume)
	Sets the system volume.

double	Volume () const
	System volume (fm \(^3\))

void	SetVolumeRadius (double R)
	Sets the system radius.

double	CanonicalVolume () const
	The canonical correlation volume V \(_c\) (fm \(^3\))

void	SetCanonicalVolume (double Volume)
	Set the canonical correlation volume V \(_c\).

void	SetCanonicalVolumeRadius (double Rc)
	Set the canonical correlation system radius.

void	ConstrainChemicalPotentials (bool resetInitialValues=true)
	Constrains the chemical potentials \( \mu_B,\,\mu_Q,\,\mu_S,\,\mu_C \) by the conservation laws imposed.

virtual void	FixParameters ()
	Method which actually implements ConstrainChemicalPotentials() (for backward compatibility).

virtual void	FixParametersNoReset ()
	Method which actually implements ConstrainChemicalPotentialsNoReset() (for backward compatibility).

virtual bool	SolveChemicalPotentials (double totB=0., double totQ=0., double totS=0., double totC=0., double muBinit=0., double muQinit=0., double muSinit=0., double muCinit=0., bool ConstrMuB=true, bool ConstrMuQ=true, bool ConstrMuS=true, bool ConstrMuC=true)
	The procedure which calculates the chemical potentials \( \mu_B,\,\mu_Q,\,\mu_S,\,\mu_C \) which reproduce the specified total baryon, electric, strangeness, and charm charges of the system.

virtual bool	FixChemicalPotentialsThroughDensities (double rhoB=0., double rhoQ=0., double rhoS=0., double rhoC=0., double muBinit=0., double muQinit=0., double muSinit=0., double muCinit=0., bool ConstrMuB=true, bool ConstrMuQ=true, bool ConstrMuS=true, bool ConstrMuC=true)
	The procedure which calculates the chemical potentials \( \mu_B,\,\mu_Q,\,\mu_S,\,\mu_C \) which reproduce the specified baryon, electric, strangeness, and charm densities.

virtual void	CalculateDensities ()
	Calculates the primordial and total (after decays) densities of all species.

virtual void	ValidateCalculation ()
	Checks whether issues have occured during the calculation of particle densities in the CalculateDensities() method.

std::string	ValidityCheckLog () const
	All messaged which occured during the validation procedure in the ValidateCalculation() method.

virtual void	CalculateDensitiesGCE ()
	Calculates the particle densities in a grand-canonical ensemble.

virtual void	CalculateFeeddown ()
	Calculates the total densities which include feeddown contributions.

virtual void	CalculateTwoParticleFluctuationsDecays ()
	Computes particle number correlations and fluctuations for all final-state particles which are marked stable.

virtual double	TwoParticleSusceptibilityPrimordial (int i, int j) const
	Returns the computed primordial particle number (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with ids i and j. CalculateFluctuations() must be called beforehand.

virtual double	TwoParticleSusceptibilityPrimordialByPdg (long long id1, long long id2)
	Returns the computed primordial particle number (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with pdg codes id1 and id2. CalculateFluctuations() must be called beforehand.

virtual double	TwoParticleSusceptibilityTemperatureDerivativePrimordial (int i, int j) const
	Returns the computed temperature derivative of the primordial particle number (cross-)susceptibility \( \frac{\partial}{\partial T} \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with ids i and j. CalculateFluctuations() must be called beforehand.

virtual double	TwoParticleSusceptibilityTemperatureDerivativePrimordialByPdg (long long id1, long long id2)
	Returns the computed temperature derivative of the primordial particle number (cross-)susceptibility \( \frac{\partial}{\partial T} \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with pdg codes id1 and id2. CalculateFluctuations() must be called beforehand.

virtual double	NetParticleSusceptibilityPrimordialByPdg (long long id1, long long id2)
	Returns the computed (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) between primordial net-particle numbers for pdg codes id1 and id2. CalculateFluctuations() must be called beforehand.

virtual double	TwoParticleSusceptibilityFinal (int i, int j) const
	Returns the computed final particle number (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with ids i and j. CalculateFluctuations() must be called beforehand. Both particle species must be those marked stable.

virtual double	TwoParticleSusceptibilityFinalByPdg (long long id1, long long id2)
	Returns the computed final particle number (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) for particles with pdg codes id1 and id2. CalculateFluctuations() must be called beforehand. Both particle species must be those marked stable.

virtual double	NetParticleSusceptibilityFinalByPdg (long long id1, long long id2)
	Returns the computed (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_j \rangle \) between final net-particle numbers for pdg codes id1 and id2. CalculateFluctuations() must be called beforehand.

virtual double	PrimordialParticleChargeSusceptibility (int i, ConservedCharge::Name chg) const
	Returns the computed primordial particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with id i and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	PrimordialParticleChargeSusceptibilityByPdg (long long id1, ConservedCharge::Name chg)
	Returns the computed primordial particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with pdg code id1 and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	PrimordialNetParticleChargeSusceptibilityByPdg (long long id1, ConservedCharge::Name chg)
	Returns the computed primordial net particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with pdg code id1 and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	FinalParticleChargeSusceptibility (int i, ConservedCharge::Name chg) const
	Returns the computed final (after decays) particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with id i and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	FinalParticleChargeSusceptibilityByPdg (long long id1, ConservedCharge::Name chg)
	Returns the computed final (after decays) particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with pdg code id1 and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	FinalNetParticleChargeSusceptibilityByPdg (long long id1, ConservedCharge::Name chg)
	Returns the computed final (after decays) net particle vs conserved charge (cross-)susceptibility \( \frac{1}{VT^3} \, \langle \Delta N_i \Delta N_chg \rangle \) for particle with pdg code id1 and conserved charge chg. CalculateFluctuations() must be called beforehand.

virtual double	SusceptibilityDimensionfull (ConservedCharge::Name i, ConservedCharge::Name j) const
	A 2nd order susceptibility of conserved charges.

virtual void	CalculateSusceptibilityMatrix ()
	Calculates the conserved charges susceptibility matrix.

virtual void	CalculateProxySusceptibilityMatrix ()
	Calculates the susceptibility matrix of conserved charges proxies.

virtual void	CalculateParticleChargeCorrelationMatrix ()
	Calculates the matrix of correlators between primordial (and also final) particle numbers and conserved charges.

Additional Inherited Members
Public Types inherited from thermalfist::ThermalModelBase
enum	ThermalModelEnsemble { GCE = 0 , CE = 1 , SCE = 2 , CCE = 3 }
	The list of statistical ensembles. More...

enum	ThermalModelInteraction { Ideal = 0 , DiagonalEV = 1 , CrosstermsEV = 2 , QvdW = 3 , RealGas = 4 , MeanField = 5 }
	Type of interactions included in the HRG model. More...

Detailed Description

Class implementing the Ideal HRG model.

Examples: CalculationTmu.cpp, CosmicTrajectory.cpp, PCE-Saha-LHC.cpp, SusceptibilitiesBQS.cpp, ThermodynamicsBQS.cpp, cpc1-HRG-TDep.cpp, cpc2-chi2-vs-T.cpp, cpc3-chi2NEQ.cpp, and cpc4-mcHRG.cpp.

Definition at line 19 of file ThermalModelIdeal.h.

Constructor & Destructor Documentation

◆ ThermalModelIdeal()

thermalfist::ThermalModelIdeal::ThermalModelIdeal	(	ThermalParticleSystem *	TPS,
		const ThermalModelParameters &	params = ThermalModelParameters() )

Construct a new ThermalModelIdeal object.

Parameters

TPS	A pointer to the ThermalParticleSystem object containing the particle list
params	ThermalModelParameters object with current thermal parameters

Definition at line 23 of file ThermalModelIdeal.cpp.

◆ ~ThermalModelIdeal()

thermalfist::ThermalModelIdeal::~ThermalModelIdeal ( void )

virtual

Destroy the ThermalModelIdeal object.

Definition at line 32 of file ThermalModelIdeal.cpp.

Member Function Documentation

◆ CalculateBaryonMatterEntropyDensity()

double thermalfist::ThermalModelIdeal::CalculateBaryonMatterEntropyDensity ( )

virtual

Definition at line 194 of file ThermalModelIdeal.cpp.

◆ CalculateChargeFluctuations()

std::vector< double > thermalfist::ThermalModelIdeal::CalculateChargeFluctuations	(	const std::vector< double > &	chgs,
		int	order = 4 )

virtual

Calculates fluctuations (diagonal susceptibilities) of an arbitrary "conserved" charge.

Each particle specie is assumed to carry a conserved charge with a value provided by an input vector.

Restricted to the grand canonical ensemble.

Parameters

chgs	A vector with conserved charge values for all species. 0-based indices of the vector must correspond to the 0-based indices of the particle list TPS()
order	Up to which order the susceptibilities are computed

Returns: std::vector<double> A vector with computed values of diagonal susceptibilities

Reimplemented from thermalfist::ThermalModelBase.

Definition at line 127 of file ThermalModelIdeal.cpp.

◆ CalculateEnergyDensity()

double thermalfist::ThermalModelIdeal::CalculateEnergyDensity ( )

virtual

Definition at line 178 of file ThermalModelIdeal.cpp.

◆ CalculateEnergyDensityDerivativeT()

double thermalfist::ThermalModelIdeal::CalculateEnergyDensityDerivativeT ( )

virtual

Definition at line 218 of file ThermalModelIdeal.cpp.

◆ CalculateEntropyDensity()

double thermalfist::ThermalModelIdeal::CalculateEntropyDensity ( )

virtual

Definition at line 186 of file ThermalModelIdeal.cpp.

◆ CalculateFluctuations()

void thermalfist::ThermalModelIdeal::CalculateFluctuations ( )

virtual

Computes the fluctuation observables.

Includes the matrix of 2nd order susceptibilities of conserved charges, as well as particle number correlations and fluctuations, both for primordial yields and after decays.

Reimplemented from thermalfist::ThermalModelBase.

Definition at line 78 of file ThermalModelIdeal.cpp.

◆ CalculateGeneralizedSusceptibilities()

std::vector< double > thermalfist::ThermalModelIdeal::CalculateGeneralizedSusceptibilities ( const std::vector< std::vector< double > > & chgs )

virtual

Definition at line 158 of file ThermalModelIdeal.cpp.

◆ CalculateMesonMatterEntropyDensity()

double thermalfist::ThermalModelIdeal::CalculateMesonMatterEntropyDensity ( )

virtual

Definition at line 202 of file ThermalModelIdeal.cpp.

◆ CalculatePressure()

double thermalfist::ThermalModelIdeal::CalculatePressure ( )

virtual

Definition at line 210 of file ThermalModelIdeal.cpp.

◆ CalculatePrimordialDensities()

void thermalfist::ThermalModelIdeal::CalculatePrimordialDensities ( )

virtual

Calculates the primordial densities of all species.

Implements thermalfist::ThermalModelBase.

Definition at line 36 of file ThermalModelIdeal.cpp.

◆ CalculateTemperatureDerivatives()

void thermalfist::ThermalModelIdeal::CalculateTemperatureDerivatives ( )

virtual

Computes the temperature derivatives of densities, shifted chemical potentials, and primordial hadron number susceptibilities.

Reimplemented from thermalfist::ThermalModelBase.

Definition at line 247 of file ThermalModelIdeal.cpp.

◆ CalculateTwoParticleCorrelations()

void thermalfist::ThermalModelIdeal::CalculateTwoParticleCorrelations ( )

virtual

Computes the fluctuations and correlations of the primordial particle numbers.

More specifically, computes the susceptibility matrix \( \frac{1}{VT^3} \, \langle \Delta N_i^* \Delta N_j^* \rangle \), where \( N_i^* \) is the primordial yield of species i.

Reimplemented from thermalfist::ThermalModelBase.

Definition at line 47 of file ThermalModelIdeal.cpp.

◆ ParticleKurtosis()

double thermalfist::ThermalModelIdeal::ParticleKurtosis ( int part )

virtual

Definition at line 239 of file ThermalModelIdeal.cpp.

◆ ParticleScalarDensity()

double thermalfist::ThermalModelIdeal::ParticleScalarDensity ( int part )

virtual

Definition at line 243 of file ThermalModelIdeal.cpp.

◆ ParticleScaledVariance()

double thermalfist::ThermalModelIdeal::ParticleScaledVariance ( int part )

virtual

Definition at line 231 of file ThermalModelIdeal.cpp.

◆ ParticleSkewness()

double thermalfist::ThermalModelIdeal::ParticleSkewness ( int part )

virtual

Definition at line 235 of file ThermalModelIdeal.cpp.

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

include/HRGBase/ThermalModelIdeal.h
src/library/HRGBase/ThermalModelIdeal.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ThermalModelIdeal()

◆ ~ThermalModelIdeal()

Member Function Documentation

◆ CalculateBaryonMatterEntropyDensity()

◆ CalculateChargeFluctuations()

◆ CalculateEnergyDensity()

◆ CalculateEnergyDensityDerivativeT()

◆ CalculateEntropyDensity()

◆ CalculateFluctuations()

◆ CalculateGeneralizedSusceptibilities()

◆ CalculateMesonMatterEntropyDensity()

◆ CalculatePressure()

◆ CalculatePrimordialDensities()

◆ CalculateTemperatureDerivatives()

◆ CalculateTwoParticleCorrelations()

◆ ParticleKurtosis()

◆ ParticleScalarDensity()

◆ ParticleScaledVariance()

◆ ParticleSkewness()