Dark Matter Only Halo Profiles¶
Class providing dark matter-only halo density profiles, i.e. the profile a halo would have in the absence of baryonic effects. This returns a massDistributionClass object for the specified node. Common implementations include NFW and Einasto profiles parameterized by a scale radius or concentration. This class is used in calculations of dynamical friction, tidal stripping, and other processes where the unmodified dark matter profile is needed.
Default implementation: darkMatterProfileDMONFW
Methods¶
get→class(massDistributionClass)Return the mass distribution of the dark matter-only profile.
type (treeNode ), intent(inout) :: nodetype (enumerationWeightByType), intent(in ), optional :: weightByinteger , intent(in ), optional :: weightIndex
darkMatterProfileDMOAccelerator¶
An accelerator wrapper for dark-matter-only profile classes that caches recently computed profile quantities (enclosed mass, density, potential, etc.) and returns interpolated estimates when the requested radius is close to a cached value, significantly speeding up calculations that repeatedly query the profile at nearby radii.
Methods
tabulate— Tabulate the mass function.
Parameters
[toleranceRelative](default1.0d-2) — The relative tolerance within which a cached (accelerated) profile estimate is accepted; if the requested radius differs from the cached value by more than this fractional amount, the full profile calculation is recomputed.[factorRadiusMaximum](default3.0d0) — The maximum radial extrapolation factor allowed when using cached profile values for the dark-matter-only profile; if the requested radius exceeds the cached radius by more than this factor, the full calculation is recomputed.[toleranceRelative](default1.0d-2) — The toleranceRelative with which to accept accelerated estimates.[factorRadiusMaximum](default3.0d0) — The maximum radial extrapolation factor allowed when using cached profile values; if the requested radius differs from the cached radius by more than this factor, the full profile is recomputed rather than interpolated.[toleranceRelative](default1.0d-2) — The tolerance with which to accept accelerated estimates.[factorRadiusMaximum](default3.0d0) — The maximum factor by which to interpolate in radius.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[tablePointsPerDecade](default10) — The number of points per decade of wavenumber at which to tabulate the transfer function.
darkMatterProfileDMOAccretionFlowCorrelationFunction¶
An accretion flow class which models the accretion flow using the 2-halo correlation function by building massDistributionCorrelationFunction objects.
Parameters
[scaleFactorVelocity](default1.0d0) — A dimensionless multiplicative scale factor applied to the inflow velocities computed from the correlation-function-based accretion flow model, allowing calibration of the infall velocity amplitude relative to the two-point clustering prediction.[mass]— The virial mass (in \(\mathrm{M}_\odot\)) of the halo whose accretion flow is being modeled via the 2-halo correlation function.[redshift]— The cosmological redshift of the halo, used to convert to cosmic time for evaluating the correlation function-based accretion flow density profile.[radius]— The radius in the tabulated correlation function.[correlationFunction]— The correlation in the tabulated correlation function.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOAccretionFlowDiemerKravtsov2014¶
An accretion flow class which models the accretion flow using the fitting function of Diemer and Kravtsov (2014). Specifically, massDistributionDiemerKravtsov2014 objects are built with parameters chosen using fits to the redshift and \(\nu\) dependencies of the fitting parameters \(b_\mathrm{e}\) and \(s_\mathrm{e}\) chosen to match the results of their figure 18.
Parameters
[b0](default+1.1250d0) — The parameter \(b_0\) in the fitting function \(b(\nu,z)=b_0 (1+z)^{b_z} \nu^{b_\nu}\) for the parameter \(b(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[bz](default+0.625d0) — The parameter \(b_z\) in the fitting function \(b(\nu,z)=b_0 (1+z)^{b_z} \nu^{b_\nu}\) for the parameter \(b(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[bnu](default-0.2250d0) — The parameter \(b_\nu\) in the fitting function \(b(\nu,z)=b_0 (1+z)^{b_z} \nu^{b_\nu}\) for the parameter \(b(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[s0](default+1.3925d0) — The parameter \(s_0\) in the fitting function \(s(\nu,z)=s_0 (1+z)^{s_z} \nu^{s_\nu}\) for the parameter \(s(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[sz](default-0.199d0) — The parameter \(s_z\) in the fitting function \(s(\nu,z)=s_0 (1+z)^{s_z} \nu^{s_\nu}\) for the parameter \(s(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[snu](default+0.0875d0) — The parameter \(s_\nu\) in the fitting function \(s(\nu,z)=s_0 (1+z)^{s_z} \nu^{s_\nu}\) for the parameter \(s(\nu,z)\) appearing in equation (4) of Diemer and Kravtsov (2014).[densityMean]— The mean density of the universe in the Diemer and Kravtsov (2014) accretion flow mass distribution.[radius200Mean]— The radius enclosing a density of 200 times the mean density of the universe in the Diemer and Kravtsov (2014) accretion flow mass distribution.[includeMean](default.true.) — If true, include the mean density of the universe in the profile, otherwise, subtract off that mean density.[b]— The coefficient \(b\) in the Diemer and Kravtsov (2014) accretion flow mass distribution.[s]— The exponent \(s\) in the Diemer and Kravtsov (2014) accretion flow mass distribution.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOAccretionFlowShi2016¶
A dark matter profile class which builds massDistributionShi2016 objects to model accretion flows using the model of Shi (2016).
Methods
solve— Solve for the structure of the accretion flow.
Parameters
[scaleFactorVelocity](default1.0d0) — A dimensionless multiplicative scale factor applied to the inflow velocities computed from the Shi (2016) splashback and accretion flow model, allowing calibration of the infall velocity amplitude relative to the theoretical prediction.[mass]— The virial mass (in \(\mathrm{M}_\odot\)) of the halo used to set the normalization of the Shi (2016) accretion flow density profile.[massAccretionRate]— The mass accretion rate (in \(\mathrm{M}_\odot\)/Gyr) of the halo, used in the Shi (2016) framework to set the amplitude of the outer accretion flow density profile.[radiusVirial]— The virial radius (in Mpc) of the halo, used together with the turnaround radius ratio to set the spatial scale of the Shi (2016) accretion flow.[ratioRadiusTurnaroundVirial]— The ratio of the turnaround to virial radii of the halo.[redshift]— The cosmological redshift of the halo, used to evaluate the cosmic time and expansion factor for the Shi (2016) accretion flow solution.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOBurkert¶
A dark matter only profile class which builds massDistributionBurkert objects to compute the (Burkert, 1995) density profile.
Methods
timeFreefallTabulate— Tabulate the freefall time as a function of radius in a scale-free Burkert mass distribution.
Parameters
[densityNormalization](default1.0d0/Pi/(log(8.0d0)-Pi/2.0d0)) — The density normalization of the Burkert profile.[scaleLength](default1.0d0) — The scale radius of the Burkert profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the Burkert profile, used to set the density normalization \(\rho_0\) whendensityNormalizationis not supplied.[radiusOuter]— The outer radius of the Burkert profile.[dimensionless](default.true.) — If true the Burkert profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOCuspNFW¶
A dark matter profile DMO class which builds massDistributionCuspNFW objects to implement the cusp-NFW density profile (Delos, 2025), normalized such that the total mass of the node is enclosed with the virial radius and with the scale length \(r_\mathrm{s}\).
Parameters
[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion.[velocityDispersionUseSeriesExpansion](default.true.) — Iftrue, radial velocity dispersion is computed using series expansion (but only for the case of \(y=0\), i.e. an NFW profile).[densityNormalization](default1.0d0/2.0d0/Pi/(log(4.0d0)-1.0d0)) — The density normalization of the cusp-NFW profile.[radiusScale](default1.0d0) — The scale radius of the cusp-NFW profile.[y](default0.0d0) — The cusp amplitude parameter the cusp-NFW profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the cusp-NFW halo, used to set the density normalization when the concentration and virial radius are provided instead ofdensityNormalization.[concentration](default1.0d0) — The concentration of the cusp-NFW profile.[radiusVirial](default1.0d0) — The virial radius of the cusp-NFW profile.[dimensionless](default.true.) — If true the cusp-NFW profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[toleranceRelativePotential](default1.0d-3) — The relative tolerance to use in numerical solutions for the gravitational potential.
darkMatterProfileDMODecaying¶
A dark matter profile DMO class which builds massDistributionSphericalDecaying objects to account for dark matter particle decays in some other dark matter profile.
Methods
lifetime— Return the lifetime of the dark matter particle.massSplitting— Return the mass splitting of the decay.velocityKick— Return the velocity kick imparted by the decay.
Parameters
[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion.[toleranceRelativePotential](default1.0d-3) — The relative tolerance to use in numerical solutions for the gravitational potential.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate numerical failures when computing the gravitational potential of a decaying dark matter profile (e.g. due to extreme decay fractions), allowing the calculation to proceed with a fallback result rather than terminating.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[toleranceRelativePotential](default1.0d-3) — The relative tolerance to use in numerical solutions for the gravitational potential.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate failures to compute the potential.[radiusEscape]— The radius beyond which a particle is assumed to have escaped the potential.[time]— The time at which decays should be evaluated.[lifetime]— The mean lifetime (in Gyr) of the decaying dark matter particle before it decays into lighter daughter particles, controlling the timescale over which dark matter density is reduced by decay.[massSplitting]— The fractional mass splitting \(\epsilon = \Delta m / m\) between the parent and daughter dark matter particles in the decay, used to compute the velocity kick imparted to the daughter particle.[velocityKick]— The velocity kick (in km/s) imparted to the daughter dark matter particle when the parent decays, which heats and disrupts the dark matter distribution in halos over time.
darkMatterProfileDMOEinasto¶
A dark matter profile DMO class which builds massDistributionEinasto objects to compute the Einasto density profile (e.g. Cardone et al. 2005), normalized such that the total mass of the node is enclosed with the virial radius and with the characteristic length \(r_{-2} = r_\mathrm{virial}/c\) where \(c\) is the halo concentration (see darkMatterProfileConcentration). The shape parameter, \(\alpha\), is set using the density profile shape method (see darkMatterProfileShape).
Methods
timeFreefallTabulate— Tabulate the freefall time as a function of radius in a scale-free Einasto mass distribution.timeFreefallMinimum— Compute the minimum freefall time in a scale-free Einasto mass distribution.
Parameters
[shapeParameter]— The shape parameter, \(\alpha\), of the Einasto profile.[densityNormalization](defaultshapeParameter/4.0d0/Pi*(2.0d0/shapeParameter)**(3.0d0/shapeParameter)*exp(-2.0d0/shapeParameter)/Gamma_Function(3.0d0/shapeParameter)) — The density normalization of the Einasto profile.[scaleLength](default1.0d0) — The scale radius of the Einasto profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the Einasto profile, used to set the density normalization \(\rho_{-2}\) whendensityNormalizationis not supplied.[concentration](default1.0d0) — The concentration of the Einasto profile.[virialRadius](default1.0d0) — The virial radius of the Einasto profile.[dimensionless](default.true.) — If true the Einasto profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOFiniteResolution¶
A dark matter profile DMO class which builds massDistributionSphericalFiniteResolution objects to mimic the effects of finite resolution in an N-body simulation.
Methods
tabulate— Tabulate the virial density contrast as a function of mass and time.restoreTable— Restore a tabulated solution from file.storeTable— Store a tabulated solution to file.
Parameters
[velocityCharacteristic](default250.0d0) — The velocity scale at which the SNe-driven outflow rate equals the star formation rate in disks.[exponent](default3.5d0) — The velocity scaling of the SNe-driven outflow rate in disks.[fraction](default0.01d0) — The normalization \(f\) of the outflow rate relative to the star formation rate at a reference halo velocity of 200 km/s and expansion factor of 1, setting the overall mass-loading amplitude of the halo-scaling feedback model.[exponentVelocity](default-2.0d0) — The exponent of virial velocity in the outflow rate in disks.[exponentRedshift](default0.0d0) — The power-law exponent of the cosmological expansion factor \((1+z)\) in the halo-scaling outflow rate, allowing the mass-loading factor to evolve with redshift; a value of zero gives no redshift evolution.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[radiusNormalization](default3.3d-6) — The initial value appearing in the radius-mass relation[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the nuclear star cluster is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not nuclear star cluster stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[scaleRelativeMass](default1.0d-2) — The mass scale, relative to the total mass of the node, below which calculations in the delayed very simple hot halo component are allowed to become inaccurate.[starveSatellites](default.false.) — Specifies whether or not the hot halo should be removed (“starved”) when a node becomes a satellite.[starveSatellitesOutflowed](default.false.) — Specifies whether or not the outflowed hot halo should be removed (“starved”) when a node becomes a satellite.[outflowReturnOnFormation](default.false.) — Specifies whether or not outflowed gas should be returned to the hot reservoir on halo formation events.[angularMomentumAlwaysGrows](default.false.) — Specifies whether or not negative rates of accretion of angular momentum into the hot halo will be treated as positive for the purposes of computing the hot halo angular momentum.[fractionBaryonLimitInNodeMerger](default.false.) — Controls whether the hot gas content of nodes should be limited to not exceed the universal baryon fraction at node merger events. If set totrue, hot gas (and angular momentum, abundances, and chemicals proportionally) will be removed from the merged halo to the unaccreted gas reservoir to limit the baryonic mass to the universal baryon fraction where possible.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple disk component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[radiusStructureSolver](default1.0d0) — The radius (in units of the standard scale length) to use in solving for the size of the disk.[structureSolverUseCole2000Method](default.false.) — If true, use the method described in Cole et al. (2000) to correct for difference between thin disk and spherical mass distributions when solving for disk radii.[diskNegativeAngularMomentumAllowed](default.true.) — Specifies whether or not negative angular momentum is allowed for the disk.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not disk stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumSolverRadius](defaultratioAngularMomentumSolverRadiusDefault) — The assumed ratio of the specific angular momentum at the structure solver radius to the mean specific angular momentum of the standard disk component.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple spheroid component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[efficiencyEnergeticOutflow](default1.0d-2) — The proportionality factor relating mass outflow rate from the spheroid to the energy input rate divided by \(V_\mathrm{spheroid}^2\).[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not spheroid stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumScaleRadius](defaultratioAngularMomentumScaleRadiusDefault) — The assumed ratio of the specific angular momentum at the scale radius to the mean specific angular momentum of the standard spheroid component.[outputMergers](default.false.) — Determines whether or not properties of black hole mergers will be output.[fileNames]— The name of the file(s) from which merger tree data should be read when using the[mergerTreeConstruct]\(=\)readtree construction method.[forestSizeMaximum](default0_c_size_t) — The maximum number of nodes allowed in a forest before it will be broken up into trees and processed individually. A value of 0 implies that forests should never be split.[presetMergerTimes](default.true.) — Specifies whether merging times for subhalos should be preset when reading merger trees from a file.[presetMergerNodes](default.true.) — Specifies whether the target nodes for mergers should be preset (i.e. determined from descendant nodes). If they are not, merging will be with each satellite’s host node.[presetSubhaloMasses](default.true.) — Specifies whether subhalo mass should be preset when reading merger trees from a file.[subhaloAngularMomentaMethod](defaultvar_str('summation')) — Specifies how to account for subhalo angular momentum when adding subhalo mass to host halo mass.[presetSubhaloIndices](default.true.) — Specifies whether subhalo indices should be preset when reading merger trees from a file.[presetPositions](default.true.) — Specifies whether node positions should be preset when reading merger trees from a file.[presetScaleRadii](default.true.) — Specifies whether node scale radii should be preset when reading merger trees from a file.[scaleRadiiFailureIsFatal](default.true.) — Specifies whether failure to set a node scale radii should be regarded as a fatal error. (If not, a fallback method to set scale radius is used in such cases.)[presetScaleRadiiConcentrationMinimum](default3.0d0) — The lowest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiConcentrationMaximum](default60.0d0) — The largest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiMinimumMass](default0.0d0) — The minimum halo mass for which scale radii should be preset (if[presetScaleRadii]\(=\)true).[presetUnphysicalAngularMomenta](default.false.) — When reading merger trees from file and presetting halo angular momenta, detect unphysical (<=0) angular momenta and preset them using the selected halo spin method.[presetAngularMomenta](default.true.) — Specifies whether node angular momenta should be preset when reading merger trees from a file.[presetAngularMomenta3D](default.false.) — Specifies whether node 3-D angular momenta vectors should be preset when reading merger trees from a file.[presetOrbits](default.true.) — Specifies whether node orbits should be preset when reading merger trees from a file.[presetOrbitsSetAll](default.true.) — Forces all orbits to be set. If the computed orbit does not cross the virial radius, then select one at random instead.[presetOrbitsAssertAllSet](default.true.) — Asserts that all virial orbits must be preset. If any can not be set, Galacticus will stop.[presetOrbitsBoundOnly](default.true.) — Specifies whether only bound node orbits should be set.[beginAt](default-1_kind_int8) — Specifies the index of the tree to begin at. (Use -1 to always begin with the first tree.)[outputTimeSnapTolerance](default0.0d0) — The relative tolerance required to “snap” a node time to the closest output time.[missingHostsAreFatal](default.true.) — Specifies whether nodes with missing host nodes should be considered to be fatal—see the discussion of missing host nodes in the class description above.[treeIndexToRootNodeIndex](default.false.) — Specifies whether tree indices should always be set to the index of their root node.[allowBranchJumps](default.true.) — Specifies whether nodes are allowed to jump between branches.[allowSubhaloPromotions](default.true.) — Specifies whether subhalos are permitted to be promoted to being isolated halos.[alwaysPromoteMostMassive](default.false.) — If true, the most massive progenitor is always promoted to be the primary progenitor even if it is a subhalo. Otherwise, isolated progenitors are given priority over subhalo progenitors, even if they are less massive.[presetNamedReals]— Names of real datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[presetNamedIntegers]— Names of integer datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[fatalMismatches](default.true.) — Specifies whether mismatches in cosmological parameter values between Galacticus and “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be considered fatal.[fatalNonTreeNode](default.true.) — Specifies whether nodes in snapshot files but not in the merger tree file should be considered fatal when importing from the “Sussing Merger Trees” format (Srisawat et al., 2013).[subvolumeCount](default1) — Specifies the number of subvolumes along each axis into which a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be split for processing through Galacticus.[subvolumeBuffer](default0.0d0) — Specifies the buffer region (in units of Mpc\(/h\) to follow the format convention) around subvolumes of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file which should be read in to ensure that no halos are missed from trees.[subvolumeIndex](default[0,0,0]) — Specifies the index (in each dimension) of the subvolume of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file to process. Indices range from 0 to[subvolumeCount]\(-1\).[badValue](default-0.5d0) — Use for bad value detection in “Sussing” merger trees. Values for scale radius and halo spin which exceed this threshold are assumed to be bad.[badValueTest](defaultvar_str('lessThan')) — Use for bad value detection in “Sussing” merger trees. Values which exceed the threshold in ths specified direction are assumed to be bad.[treeSampleRate](default1.0d0) — Specify the probability that any given tree should processed (to permit subsampling).[massOptions](defaultvar_str('default')) — Mass option for Sussing merger trees.[mergeProbability](default0.1d0) — The largest probability of branching allowed in a timestep in merger trees built by the Cole et al. (2000) method.[accretionLimit](default0.1d0) — The largest fractional mass change due to subresolution accretion allowed in a timestep in merger trees built by the Cole et al. (2000) method.[redshiftMaximum](default1.0d5) — The highest redshift to which merger trees will be built in the Cole et al. (2000) method.[toleranceTimeEarliest](default2.0d-6) — The fractional tolerance used to judge if a branch is at the earliest allowed time in the tree.[branchIntervalStep](default.true.) — Iffalseuse the original Cole et al. (2000) method to determine whether branching occurs in a timestep. Iftruedraw branching intervals from a negative exponential distribution.[toleranceResolutionSelf](default1.0d-6) — The fractional tolerance in node mass at the resolution limit below which branch mis-orderings will be ignored.[toleranceResolutionParent](default1.0d-3) — The fractional tolerance in parent node mass at the resolution limit below which branch mis-orderings will be ignored.[ignoreNoProgress](default.false.) — If true, failure to make progress on a branch will be ignored (and the branch terminated).[ignoreWellOrdering](default.false.) — If true, non-well-ordered tree branches are pruned away instead of causing errors..[redshiftBase](default0.0d0) — The redshift at which to plant the base node when building merger trees.[timeSnapTolerance](default1.0d-6) — The fractional tolerance within which the tree base time will be snapped to a nearby output time.[treeBeginAt](default0) — The index (in order of increasing base halo mass) of the tree at which to begin when building merger trees. A value of “0” means to begin with tree number 1 (if processing trees in ascending order), or equal to the number of trees (otherwise).[processDescending](default.true.) — If true, causes merger trees to be processed in order of decreasing mass.[splitTrees](default.false.) — If true, prune away any nodes of the tree that are not needed to determine evolution up to the latest time at which a node is present inside the lightcone. This typically leads to a tree splitting into a forest of trees.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[starFormationRates]— The star formation rates corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of star formation rate to use when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d10) — The star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d12) — The maximum star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[likelihoodBins]— Controls which bins in the stellar mass–halo mass relation will be used in computing the likelihood: * not present: all bins are included in the likelihood calculation; * list of integers: use only the mass bin(s) given in this list in the likelihood calculation; *auto: use only bins which have a non-zero number of halos contributing to them in the likelihood calculation.[fileNameTarget]— The name of the file containing the target data.[redshiftInterval](default1) — The redshift interval to use.[likelihoodNormalize](default.false.) — If true, then normalize the likelihood to make it a probability density.[computeScatter](default.false.) — If true, the scatter in log10(stellar mass) is computed. Otherwise, the mean is computed.[systematicErrorPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for stellar mass in the stellar vs halo mass relation.[systematicErrorMassHaloPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for halo mass in the stellar vs halo mass relation.[errorTolerant](default.false.) — Error tolerance for the N-body spin distribution operator.[logNormalRange](default100.0d0) — The multiplicative range of the log-normal distribution used to model the distribution of the mass and energy terms in the spin parameter. Specifically, the lognormal distribution is truncated outside the range \((\lambda_\mathrm{m}/R,\lambda_\mathrm{m} R\), where \(\lambda_\mathrm{m}\) is the measured spin, and \(R=\)[logNormalRange][fileName]— The name of the file from which to read spin distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the spin distribution function.[comment]— A descriptive comment for the spin distribution function.[redshift]— The redshift at which to compute the spin distribution function.[massMinimum]— Minimum halo mass for the spin distribution function.[massMaximum]— Maximum halo mass for the spin distribution function.[spinMinimum]— Minimum spin for the spin distribution function.[spinMaximum]— Maximum spin for the spin distribution function.[countSpinsPerDecade]— Number of spins per decade at which to compute the spin distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[particleCountMinimum]— The minimum particle count to assume when computing N-body errors on spins.[massParticle]— The mass of the particle used in the N-body simulation from which spins were measured.[energyEstimateParticleCountMaximum]— The maximum number of particles used in estimating halo energies when measuring spins from the N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[magnitudesAbsolute]— The absolute magnitudes corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[luminosities]— The luminosities corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[includeNitrogenII](default.false.) — If true, include contamination by the [NII] (6548AA \(+\) 6584AA) doublet.[depthOpticalISMCoefficient](default1.0d0) — Multiplicative coefficient for optical depth in the ISM.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[rootVarianceFractionalMinimum](default0.0d0) — The minimum fractional root variance (relative to the target dataset).[fileName]— The name of the file from which to read concentration distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the concentration distribution function.[comment]— A descriptive comment for the concentration distribution function.[redshift]— The redshift at which to compute the concentration distribution function.[massMinimum]— Minimum halo mass for the concentration distribution function.[massMaximum]— Maximum halo mass for the concentration distribution function.[concentrationMinimum]— Minimum concentration for the concentration distribution function.[concentrationMaximum]— Maximum concentration for the concentration distribution function.[countConcentrationsPerDecade]— Number of concentrations per decade at which to compute the concentration distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[massParticle]— The particle mass in the source N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[fileName]— The name of the file from which to read star forming main sequence function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[separations]— The separations corresponding to bin centers.[massMinima]— The minimum mass of each mass sample.[massMaxima]— The maximum mass of each mass sample.[massHaloBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing the mass function covariance matrix for main branch galaxies.[massHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[massHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[wavenumberCount](default60_c_size_t) — The number of bins in wavenumber to use in computing the correlation function.[wavenumberMinimum](default1.0d-3) — The minimum wavenumber to use when computing the correlation function.[wavenumberMaximum](default1.0d4) — The maximum wavenumber to use when computing the correlation function.[integralConstraint]— The integral constraint for these correlation functions.[depthLineOfSight]— The line-of-sight depth over which the correlation function was projected.[halfIntegral]— Set to true if the projection integrand should be over line-of-sight depths greater than zero.[binnedProjectedCorrelationTarget]— The target function for likelihood calculations.[binnedProjectedCorrelationCovarianceTarget]— The target function covariance for likelihood calculations.[targetLabel](defaultvar_str('')) — A label for the target dataset in a plot of this analysis.[starFormationRateSpecificQuiescentLogarithmic]— The base-10 logarithm specific star formation rate (in units of Gyr\(^{-1}\)) separating quiescent and star-forming galaxies.[starFormationRateSpecificLogarithmicError]— The observational fractional error in specific star formation rate (in units of dex) of galaxies.[fileName]— The name of the file from which to read quiescent fraction function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[radiusFractionalTruncateMinimum](default2.0d0) — The minimum radius (in units of the virial radius) to begin truncating the density profile.[radiusFractionalTruncateMaximum](default4.0d0) — The maximum radius (in units of the virial radius) to finish truncating the density profile.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[velocityDispersionApproximate](default.true.) — Iftrue, radial velocity dispersion is computed using an approximate method in which we assume that \(\sigma_\mathrm{r}^2(r) \rightarrow \sigma_\mathrm{r}^2(r) - (2/3) \epsilon(r)\), where \(\epsilon(r)\) is the specific heating energy. Iffalsethen radial velocity dispersion is computed by numerically solving the Jeans equation.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityDispersionFailure](default.false.) — Iftrue, tolerate failures to compute the velocity dispersion.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate numerical failures when computing the gravitational potential of a heated dark matter profile, allowing the calculation to continue with a fallback result rather than aborting.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[tolerateVelocityMaximumFailure](default.true.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[lengthResolution]— The gravitational softening length \(\Delta x\) (in Mpc) of the N-body simulation, which sets the minimum spatial scale below which the dark matter profile is smoothed to avoid artificial two-body effects.[massResolution]— The mass resolution \(\Delta M\) (in \(\mathrm{M}_\odot\)) of the N-body simulation, representing the minimum halo mass that can be resolved; profiles of halos near this limit are softened to account for particle discreteness effects.[resolutionIsComoving]— If true, the resolution length is assumed to be fixed in comoving coordinates, otherwise in physical coordinates.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[C](default400.0d0) — The parameter \(C\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[f](default0.02d0) — The parameter \(f\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[timeFormationSeekDelta](default0.0d0) — The parameter \(\Delta \log t\) by which the logarithm of the trial formation time is incremented when stepping through the formation history of a node to find the formation time. If set to zero (or a negative value) the cumulative mass histories of nodes are assumed to be monotonic functions of time, and the formation time is instead found by a root finding algorithm,[massBoundIsInactive](default.false.) — Specifies whether or not the bound mass of the satellite component is inactive (i.e. does not appear in any ODE being solved).[useLastIsolatedTime](default.false.) — If true, evaluate the halo virial radius using a the virial density definition at the last isolated time of the halo.[filterName]— The filter to select.[filterType]— The filter type (rest or observed) to select.[redshiftBand]— The redshift of the band (if not the output redshift).[postprocessChain]— The postprocessing chain to use.[cloudyTableFileName](defaultvar_str('%DATASTATICPATH%/hiiRegions/emissionLineLuminosities_BC2003_highResolution_imfChabrier.hdf5')) — The file of emission line luminosities to use.[lineNames]— The emission lines to extract.[component]— The component from which to extract star formation rate.[toleranceRelative](default1.0d-3) — The relative tolerance used in integration over stellar population spectra.[component]— The component from which to extract star formation rate.[radiusCore]— The soliton core radius (in Mpc) characterizing the size of the quantum pressure-supported central core of the fuzzy dark matter halo; the density profile flattens inside this scale.[densitySolitonCentral]— The central density (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the solitonic core at \(r=0\), which sets the overall normalization of the density profile \(\rho(r) = \rho_\mathrm{c} [1+(r/r_c)^2]^{-8}\).[toleranceRelativePotential](default1.0d-3) — The relative tolerance used in numerical ODE solutions for the gravitational potential of the solitonic core profile.[dimensionless](default.true.) — If true the soliton profile is treated as dimensionless (scale-free), allowing its radial and density quantities to be specified in arbitrary units.[componentType](defaultvar_str('unknown')) — The galactic structure component type (e.g.dark matter halo, disk, spheroid) represented by this mass distribution, used for component-specific queries.[massType](defaultvar_str('unknown')) — The mass type (e.g.dark matter, baryonic, total) represented by this mass distribution, used for mass-type-specific queries.[radiusTransition]— The transition radius (in Mpc) at which the density profile smoothly switches from the halo profile to the accretion flow, controlled by the fourth-order transition function \(f_\mathrm{trans}(r)\).[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[timeAge]— The age of the halo (in Gyr) since its formation, determining the total time available for SIDM self-interactions to thermalize the inner halo and produce an isothermal core.[velocityRelativeMean]— Mean relative velocity to calculate self interaction cross section.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[tolerateVelocityMaximumFailure](default.false.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate failures to compute the potential.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[lengthResolution]— The spatial resolution length scale (in Mpc) below which the underlying density profile is softened to a flat core, mimicking the finite force resolution of an N-body simulation.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[massMinimum]— The minimum halo mass (in \(\mathrm{M}_\odot\)) below which halos are excluded from the mass function histogram.[massMaximum]— The maximum halo mass (in \(\mathrm{M}_\odot\)) above which halos are excluded from the mass function histogram.[massCountPerDecade]— The number of logarithmic bins per decade of halo mass used when constructing the halo mass function.[description]— A human-readable description of this mass function dataset, stored as metadata in the output file.[simulationReference]— A bibliographic reference for the N-body simulation from which this mass function is derived, stored as metadata.[simulationURL]— A URL pointing to the publicly accessible dataset or documentation for the N-body simulation, stored as metadata.[bootstrapSampleCount](default30_c_size_t) — The number of bootstrap resamples of the particles that should be used.[representativeMinimumCount](default10_c_size_t) — Minimum number of representative particles used to compute the center of a halo.[tolerance](default1.0d-2) — The tolerance in the summed weight of bound particles which must be attained to declare convergence.[bootstrapSampleRate](default1.0d0) — The sampling rate for particles.[representativeFraction](default0.05d0) — Fraction of bound particles used to compute the center of a halo.[analyzeAllParticles](default.true.) — If true, all particles are assumed to be self-bound at the beginning of the analysis. Unbound particles at previous times are allowed to become bound in the current snapshot. If false and the self-bound information from the previous snapshot is available, only the particles that are self-bound at the previous snapshot are assumed to be bound at the beginning of the analysis.[useVelocityMostBound](default.false.) — If true, the velocity of the most bound particle in velocity space is used as the representative velocity of the satellite. If false, use the mass weighted mean velocity (center-of-mass velocity) of self-bound particles instead.[orderRotation](defaultvar_str('none')) — The order in which evaluation of likelihoods should be rotated as a function of process number.[logLikelihoodAccept](defaulthuge(0.0d0)) — The log-likelihood which should be “accepted”—once the log-likelihood reaches this value (or larger) no further updates to the chain will be made.[report](default.false.) — If true, report on the log-likelihood obtained.[means]— The mean of the multivariate normal distribution.[covariance]— The covariance matrix for the of the multivariate normal distribution.[countForestsMaximum](default-1_c_size_t) — If set to a positive number, this is the maximum number of forests that will be evolved.[walltimeMaximum](default-1_kind_int8) — If set to a positive number, this is the maximum wall time for which forest evolution is allowed to proceed before the task gives up.[tolerateFailures](default.false.) — If true then failures to evolve a forest are tolerated. The forest is evolved no further, but evolution of other forests continues.[evolveForestsInParallel](default.true.) — If true then each forest is evolved by a separate OpenMP thread. Otherwise, a single thread evolves all forests.[suspendToRAM](default.true.) — Specifies whether trees should be suspended to RAM (otherwise they are suspend to file).[suspendPath]— The path to which tree suspension files will be stored.[timeIntervalCheckpoint](default-1_kind_int8) — If positive, gives the time in seconds between storing of checkpoint files. If zero or negative, no checkpointing is performed..[fileNameCheckpoint]— The path to which checkpoint data will be stored.[logM0](default10.0d0) — The parameter \(\log_{10} M_0\) (with \(M_0\) in units of \(\mathrm{M}_\odot\)) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR0](default9.0d0) — The parameter \(\alpha_0\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR1](default0.0d0) — The parameter \(\alpha_1\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[cW](default3.78062835d0) — The parameter \(c_\mathrm{W}\) in the Bohr et al. (2021) power spectrum window function.[beta](default3.4638743d0) — The parameter \(\beta\) in the Bohr et al. (2021) power spectrum window function.[transferFunctionType](defaultvar_str('darkMatter')) — Specifies whether to use thedarkMatterortotaltransfer function.[fileName]— The name of the file from which to read a tabulated transfer function.[redshift](default0.0d0) — The redshift of the transfer function to read.[factorWavenumberSmoothExtrapolation](default0.0d0) — If positive, and extrapolation is used at high wavenumbers, the slope for extrapolation will be set by averaging over wavenumbers from \(k_\mathrm{max}/f\) to \(k_\mathrm{max}\), where \(f=\)[factorWavenumberSmoothExtrapolation]and \(k_\mathrm{max}\) is the highest wavenumber tabulated. This avoids spurious extrapolation for highly oscillatory transfer functions.[acceptNegativeValues](default.false.) — If true, negative values in the transfer function are allowed (and the absolute value is taken prior to interpolation). Otherwise, negative values result in an error.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[fileName](defaultvar_str('none')) — The name of the file to/from which tabulations of barrier first crossing probabilities should be written/read. If set to “none” tables will not be stored.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[varianceNumberPerUnitProbability](default1000) — The number of points to tabulate per unit variance for first crossing probabilities.[varianceNumberPerUnit](default40) — The number of tabulation points per unit of \(\sigma^2\) used when building the rate look-up table for the Farahi excursion-set first-crossing distribution; higher values improve interpolation accuracy at the cost of memory and initialization time.[varianceNumberPerDecade](default400) — The number of points to tabulate per decade of progenitor variance for first crossing rates.[varianceNumberPerDecadeNonCrossing](default40) — The number of points to tabulate per decade of progenitor variance for non-crossing rates.[timeNumberPerDecade](default10) — The number of tabulation points per decade of cosmic time used when building the first-crossing rate look-up table as a function of time; higher values improve temporal interpolation accuracy for rapidly evolving cosmologies.[varianceIsUnlimited](default.false.) — If true, the variance is assumed to have no upper limit (e.g. as in the case of CDM). This allows the tabulated solutions to be extended arbitrarily. Otherwise, tables are extended to encompass just the range of variance requested.[linkingLength](default0.2d0) — The friends-of-friends linking length to use in computing virial density contrasts with the percolation analysis of More et al. (2011).
darkMatterProfileDMOFiniteResolutionNFW¶
A dark matter profile DMO class which builds massDistributionSphericalFiniteResolutionNFW objects to mimic a finite resolution to an NFW density profile.
Methods
radiusEnclosingDensityTabulate— Tabulate the radius enclosing a given density as a function of density and core radius.radiusEnclosingMassTabulate— Tabulate the radius enclosing a given mass as a function of density and core radius.energyTabulate— Tabulate the energy as a function of concentration and core radius.densityScaleFree— The density of the profile in units where the mass and scale length are both 1.massEnclosedScaleFree— The mass enclosed of the profile in units where the mass and scale length are both 1.storeDensityTable— Store the tabulated radius-enclosing-density to file.restoreDensityTable— Attempt to restore the tabulated radius-enclosing-density from file, returning true if successful.storeMassTable— Store the tabulated radius-enclosing-mass to file.restoreMassTable— Attempt to restore the tabulated radius-enclosing-mass from file, returning true if successful.storeEnergyTable— Store the tabulated energy to file.restoreEnergyTable— Attempt to restore the tabulated energy from file, returning true if successful.suffix— Return a file name suffix (containing a source code digest.
Parameters
[useSeriesApproximation](default.true.) — If true, use a fast series approximation to the velocity dispersion profile in an NFW mass distribution. The approximation matches the exact (dilogarithm-based) form to better than \(5\times 10^{-6}\) in relative terms across \(r/r_\mathrm{s} \in [10^{-4},10^4]\) (seetests.kinematic_distributions.NFW).[velocityDispersionUseSeriesExpansion](default.true.) — Iftrue, radial velocity dispersion is computed using series expansion.[lengthResolution]— The gravitational softening length \(\Delta x\) (in Mpc) of the N-body simulation used to smooth the NFW profile at small radii, preventing artificial divergence below the resolution scale.[massResolution]— The mass resolution \(\Delta M\) (in \(\mathrm{M}_\odot\)) of the N-body simulation, used to determine the finite-resolution softening of the NFW profile for halos near the resolution limit.[resolutionIsComoving]— If true, the resolution length is assumed to be fixed in comoving coordinates, otherwise in physical coordinates.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[f](default0.01d0) — The parameter \(f\) appearing in the halo concentration algorithm of Navarro et al. (1996).[C](default2000.0d0) — The parameter \(C\) appearing in the halo concentration algorithm of Navarro et al. (1996).[densityNormalization](default1.0d0/2.0d0/Pi/(log(4.0d0)-1.0d0)) — The density normalization of the NFW profile.[scaleLength](default1.0d0) — The NFW scale radius (in Mpc) \(r_\mathrm{s}\) at which the density profile transitions from the inner \(\rho \propto r^{-1}\) to the outer \(\rho \propto r^{-3}\) slope.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the NFW profile, used to set the density normalization when the concentration and virial radius are provided.[concentration](default1.0d0) — The halo concentration parameter \(c = r_\mathrm{vir}/r_\mathrm{s}\) of the NFW profile, controlling how centrally concentrated the dark matter density profile is.[virialRadius](default1.0d0) — The virial radius (in Mpc) \(r_\mathrm{vir}\) of the NFW halo, which defines the outer boundary of the profile at which the mean enclosed density equals the virial overdensity threshold.[dimensionless](default.true.) — If true the NFW profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[lengthResolution]— The spatial resolution length scale (in Mpc) of the N-body simulation being modeled; sets the minimum effective radius below which the NFW density profile is softened.[radiusScale]— The NFW scale radius (in Mpc) at which the density profile transitions from the inner \(\rho \propto r^{-1}\) slope to the outer \(\rho \propto r^{-3}\) slope.[radiusVirial]— The virial radius (in Mpc) of the halo, defining the outer boundary of the NFW profile at which the mean enclosed density equals the virial overdensity threshold.[mass]— The total mass (in \(\mathrm{M}_\odot\)) enclosed within the virial radius, used together withradiusScaleandradiusVirialto normalize the NFW density profile.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOHeated¶
A dark matter profile DMO class which builds massDistributionSphericalHeated objects to account for heating of some other dark matter profile.
Methods
tabulate— Tabulate the virial density contrast as a function of mass and time.restoreTable— Restore a tabulated solution from file.storeTable— Store a tabulated solution to file.
Parameters
[velocityCharacteristic](default250.0d0) — The velocity scale at which the SNe-driven outflow rate equals the star formation rate in disks.[exponent](default3.5d0) — The velocity scaling of the SNe-driven outflow rate in disks.[fraction](default0.01d0) — The normalization \(f\) of the outflow rate relative to the star formation rate at a reference halo velocity of 200 km/s and expansion factor of 1, setting the overall mass-loading amplitude of the halo-scaling feedback model.[exponentVelocity](default-2.0d0) — The exponent of virial velocity in the outflow rate in disks.[exponentRedshift](default0.0d0) — The power-law exponent of the cosmological expansion factor \((1+z)\) in the halo-scaling outflow rate, allowing the mass-loading factor to evolve with redshift; a value of zero gives no redshift evolution.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[radiusNormalization](default3.3d-6) — The initial value appearing in the radius-mass relation[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the nuclear star cluster is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not nuclear star cluster stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[scaleRelativeMass](default1.0d-2) — The mass scale, relative to the total mass of the node, below which calculations in the delayed very simple hot halo component are allowed to become inaccurate.[starveSatellites](default.false.) — Specifies whether or not the hot halo should be removed (“starved”) when a node becomes a satellite.[starveSatellitesOutflowed](default.false.) — Specifies whether or not the outflowed hot halo should be removed (“starved”) when a node becomes a satellite.[outflowReturnOnFormation](default.false.) — Specifies whether or not outflowed gas should be returned to the hot reservoir on halo formation events.[angularMomentumAlwaysGrows](default.false.) — Specifies whether or not negative rates of accretion of angular momentum into the hot halo will be treated as positive for the purposes of computing the hot halo angular momentum.[fractionBaryonLimitInNodeMerger](default.false.) — Controls whether the hot gas content of nodes should be limited to not exceed the universal baryon fraction at node merger events. If set totrue, hot gas (and angular momentum, abundances, and chemicals proportionally) will be removed from the merged halo to the unaccreted gas reservoir to limit the baryonic mass to the universal baryon fraction where possible.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple disk component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[radiusStructureSolver](default1.0d0) — The radius (in units of the standard scale length) to use in solving for the size of the disk.[structureSolverUseCole2000Method](default.false.) — If true, use the method described in Cole et al. (2000) to correct for difference between thin disk and spherical mass distributions when solving for disk radii.[diskNegativeAngularMomentumAllowed](default.true.) — Specifies whether or not negative angular momentum is allowed for the disk.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not disk stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumSolverRadius](defaultratioAngularMomentumSolverRadiusDefault) — The assumed ratio of the specific angular momentum at the structure solver radius to the mean specific angular momentum of the standard disk component.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple spheroid component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[efficiencyEnergeticOutflow](default1.0d-2) — The proportionality factor relating mass outflow rate from the spheroid to the energy input rate divided by \(V_\mathrm{spheroid}^2\).[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not spheroid stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumScaleRadius](defaultratioAngularMomentumScaleRadiusDefault) — The assumed ratio of the specific angular momentum at the scale radius to the mean specific angular momentum of the standard spheroid component.[outputMergers](default.false.) — Determines whether or not properties of black hole mergers will be output.[fileNames]— The name of the file(s) from which merger tree data should be read when using the[mergerTreeConstruct]\(=\)readtree construction method.[forestSizeMaximum](default0_c_size_t) — The maximum number of nodes allowed in a forest before it will be broken up into trees and processed individually. A value of 0 implies that forests should never be split.[presetMergerTimes](default.true.) — Specifies whether merging times for subhalos should be preset when reading merger trees from a file.[presetMergerNodes](default.true.) — Specifies whether the target nodes for mergers should be preset (i.e. determined from descendant nodes). If they are not, merging will be with each satellite’s host node.[presetSubhaloMasses](default.true.) — Specifies whether subhalo mass should be preset when reading merger trees from a file.[subhaloAngularMomentaMethod](defaultvar_str('summation')) — Specifies how to account for subhalo angular momentum when adding subhalo mass to host halo mass.[presetSubhaloIndices](default.true.) — Specifies whether subhalo indices should be preset when reading merger trees from a file.[presetPositions](default.true.) — Specifies whether node positions should be preset when reading merger trees from a file.[presetScaleRadii](default.true.) — Specifies whether node scale radii should be preset when reading merger trees from a file.[scaleRadiiFailureIsFatal](default.true.) — Specifies whether failure to set a node scale radii should be regarded as a fatal error. (If not, a fallback method to set scale radius is used in such cases.)[presetScaleRadiiConcentrationMinimum](default3.0d0) — The lowest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiConcentrationMaximum](default60.0d0) — The largest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiMinimumMass](default0.0d0) — The minimum halo mass for which scale radii should be preset (if[presetScaleRadii]\(=\)true).[presetUnphysicalAngularMomenta](default.false.) — When reading merger trees from file and presetting halo angular momenta, detect unphysical (<=0) angular momenta and preset them using the selected halo spin method.[presetAngularMomenta](default.true.) — Specifies whether node angular momenta should be preset when reading merger trees from a file.[presetAngularMomenta3D](default.false.) — Specifies whether node 3-D angular momenta vectors should be preset when reading merger trees from a file.[presetOrbits](default.true.) — Specifies whether node orbits should be preset when reading merger trees from a file.[presetOrbitsSetAll](default.true.) — Forces all orbits to be set. If the computed orbit does not cross the virial radius, then select one at random instead.[presetOrbitsAssertAllSet](default.true.) — Asserts that all virial orbits must be preset. If any can not be set, Galacticus will stop.[presetOrbitsBoundOnly](default.true.) — Specifies whether only bound node orbits should be set.[beginAt](default-1_kind_int8) — Specifies the index of the tree to begin at. (Use -1 to always begin with the first tree.)[outputTimeSnapTolerance](default0.0d0) — The relative tolerance required to “snap” a node time to the closest output time.[missingHostsAreFatal](default.true.) — Specifies whether nodes with missing host nodes should be considered to be fatal—see the discussion of missing host nodes in the class description above.[treeIndexToRootNodeIndex](default.false.) — Specifies whether tree indices should always be set to the index of their root node.[allowBranchJumps](default.true.) — Specifies whether nodes are allowed to jump between branches.[allowSubhaloPromotions](default.true.) — Specifies whether subhalos are permitted to be promoted to being isolated halos.[alwaysPromoteMostMassive](default.false.) — If true, the most massive progenitor is always promoted to be the primary progenitor even if it is a subhalo. Otherwise, isolated progenitors are given priority over subhalo progenitors, even if they are less massive.[presetNamedReals]— Names of real datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[presetNamedIntegers]— Names of integer datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[fatalMismatches](default.true.) — Specifies whether mismatches in cosmological parameter values between Galacticus and “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be considered fatal.[fatalNonTreeNode](default.true.) — Specifies whether nodes in snapshot files but not in the merger tree file should be considered fatal when importing from the “Sussing Merger Trees” format (Srisawat et al., 2013).[subvolumeCount](default1) — Specifies the number of subvolumes along each axis into which a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be split for processing through Galacticus.[subvolumeBuffer](default0.0d0) — Specifies the buffer region (in units of Mpc\(/h\) to follow the format convention) around subvolumes of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file which should be read in to ensure that no halos are missed from trees.[subvolumeIndex](default[0,0,0]) — Specifies the index (in each dimension) of the subvolume of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file to process. Indices range from 0 to[subvolumeCount]\(-1\).[badValue](default-0.5d0) — Use for bad value detection in “Sussing” merger trees. Values for scale radius and halo spin which exceed this threshold are assumed to be bad.[badValueTest](defaultvar_str('lessThan')) — Use for bad value detection in “Sussing” merger trees. Values which exceed the threshold in ths specified direction are assumed to be bad.[treeSampleRate](default1.0d0) — Specify the probability that any given tree should processed (to permit subsampling).[massOptions](defaultvar_str('default')) — Mass option for Sussing merger trees.[mergeProbability](default0.1d0) — The largest probability of branching allowed in a timestep in merger trees built by the Cole et al. (2000) method.[accretionLimit](default0.1d0) — The largest fractional mass change due to subresolution accretion allowed in a timestep in merger trees built by the Cole et al. (2000) method.[redshiftMaximum](default1.0d5) — The highest redshift to which merger trees will be built in the Cole et al. (2000) method.[toleranceTimeEarliest](default2.0d-6) — The fractional tolerance used to judge if a branch is at the earliest allowed time in the tree.[branchIntervalStep](default.true.) — Iffalseuse the original Cole et al. (2000) method to determine whether branching occurs in a timestep. Iftruedraw branching intervals from a negative exponential distribution.[toleranceResolutionSelf](default1.0d-6) — The fractional tolerance in node mass at the resolution limit below which branch mis-orderings will be ignored.[toleranceResolutionParent](default1.0d-3) — The fractional tolerance in parent node mass at the resolution limit below which branch mis-orderings will be ignored.[ignoreNoProgress](default.false.) — If true, failure to make progress on a branch will be ignored (and the branch terminated).[ignoreWellOrdering](default.false.) — If true, non-well-ordered tree branches are pruned away instead of causing errors..[redshiftBase](default0.0d0) — The redshift at which to plant the base node when building merger trees.[timeSnapTolerance](default1.0d-6) — The fractional tolerance within which the tree base time will be snapped to a nearby output time.[treeBeginAt](default0) — The index (in order of increasing base halo mass) of the tree at which to begin when building merger trees. A value of “0” means to begin with tree number 1 (if processing trees in ascending order), or equal to the number of trees (otherwise).[processDescending](default.true.) — If true, causes merger trees to be processed in order of decreasing mass.[splitTrees](default.false.) — If true, prune away any nodes of the tree that are not needed to determine evolution up to the latest time at which a node is present inside the lightcone. This typically leads to a tree splitting into a forest of trees.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[starFormationRates]— The star formation rates corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of star formation rate to use when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d10) — The star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d12) — The maximum star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[likelihoodBins]— Controls which bins in the stellar mass–halo mass relation will be used in computing the likelihood: * not present: all bins are included in the likelihood calculation; * list of integers: use only the mass bin(s) given in this list in the likelihood calculation; *auto: use only bins which have a non-zero number of halos contributing to them in the likelihood calculation.[fileNameTarget]— The name of the file containing the target data.[redshiftInterval](default1) — The redshift interval to use.[likelihoodNormalize](default.false.) — If true, then normalize the likelihood to make it a probability density.[computeScatter](default.false.) — If true, the scatter in log10(stellar mass) is computed. Otherwise, the mean is computed.[systematicErrorPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for stellar mass in the stellar vs halo mass relation.[systematicErrorMassHaloPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for halo mass in the stellar vs halo mass relation.[errorTolerant](default.false.) — Error tolerance for the N-body spin distribution operator.[logNormalRange](default100.0d0) — The multiplicative range of the log-normal distribution used to model the distribution of the mass and energy terms in the spin parameter. Specifically, the lognormal distribution is truncated outside the range \((\lambda_\mathrm{m}/R,\lambda_\mathrm{m} R\), where \(\lambda_\mathrm{m}\) is the measured spin, and \(R=\)[logNormalRange][fileName]— The name of the file from which to read spin distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the spin distribution function.[comment]— A descriptive comment for the spin distribution function.[redshift]— The redshift at which to compute the spin distribution function.[massMinimum]— Minimum halo mass for the spin distribution function.[massMaximum]— Maximum halo mass for the spin distribution function.[spinMinimum]— Minimum spin for the spin distribution function.[spinMaximum]— Maximum spin for the spin distribution function.[countSpinsPerDecade]— Number of spins per decade at which to compute the spin distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[particleCountMinimum]— The minimum particle count to assume when computing N-body errors on spins.[massParticle]— The mass of the particle used in the N-body simulation from which spins were measured.[energyEstimateParticleCountMaximum]— The maximum number of particles used in estimating halo energies when measuring spins from the N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[magnitudesAbsolute]— The absolute magnitudes corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[luminosities]— The luminosities corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[includeNitrogenII](default.false.) — If true, include contamination by the [NII] (6548AA \(+\) 6584AA) doublet.[depthOpticalISMCoefficient](default1.0d0) — Multiplicative coefficient for optical depth in the ISM.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[rootVarianceFractionalMinimum](default0.0d0) — The minimum fractional root variance (relative to the target dataset).[fileName]— The name of the file from which to read concentration distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the concentration distribution function.[comment]— A descriptive comment for the concentration distribution function.[redshift]— The redshift at which to compute the concentration distribution function.[massMinimum]— Minimum halo mass for the concentration distribution function.[massMaximum]— Maximum halo mass for the concentration distribution function.[concentrationMinimum]— Minimum concentration for the concentration distribution function.[concentrationMaximum]— Maximum concentration for the concentration distribution function.[countConcentrationsPerDecade]— Number of concentrations per decade at which to compute the concentration distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[massParticle]— The particle mass in the source N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[fileName]— The name of the file from which to read star forming main sequence function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[separations]— The separations corresponding to bin centers.[massMinima]— The minimum mass of each mass sample.[massMaxima]— The maximum mass of each mass sample.[massHaloBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing the mass function covariance matrix for main branch galaxies.[massHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[massHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[wavenumberCount](default60_c_size_t) — The number of bins in wavenumber to use in computing the correlation function.[wavenumberMinimum](default1.0d-3) — The minimum wavenumber to use when computing the correlation function.[wavenumberMaximum](default1.0d4) — The maximum wavenumber to use when computing the correlation function.[integralConstraint]— The integral constraint for these correlation functions.[depthLineOfSight]— The line-of-sight depth over which the correlation function was projected.[halfIntegral]— Set to true if the projection integrand should be over line-of-sight depths greater than zero.[binnedProjectedCorrelationTarget]— The target function for likelihood calculations.[binnedProjectedCorrelationCovarianceTarget]— The target function covariance for likelihood calculations.[targetLabel](defaultvar_str('')) — A label for the target dataset in a plot of this analysis.[starFormationRateSpecificQuiescentLogarithmic]— The base-10 logarithm specific star formation rate (in units of Gyr\(^{-1}\)) separating quiescent and star-forming galaxies.[starFormationRateSpecificLogarithmicError]— The observational fractional error in specific star formation rate (in units of dex) of galaxies.[fileName]— The name of the file from which to read quiescent fraction function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[radiusFractionalTruncateMinimum](default2.0d0) — The minimum radius (in units of the virial radius) to begin truncating the density profile.[radiusFractionalTruncateMaximum](default4.0d0) — The maximum radius (in units of the virial radius) to finish truncating the density profile.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[velocityDispersionApproximate](default.true.) — Iftrue, radial velocity dispersion is computed using an approximate method in which we assume that \(\sigma_\mathrm{r}^2(r) \rightarrow \sigma_\mathrm{r}^2(r) - (2/3) \epsilon(r)\), where \(\epsilon(r)\) is the specific heating energy. Iffalsethen radial velocity dispersion is computed by numerically solving the Jeans equation.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityDispersionFailure](default.false.) — Iftrue, tolerate failures to compute the velocity dispersion.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate numerical failures when computing the gravitational potential of a heated dark matter profile, allowing the calculation to continue with a fallback result rather than aborting.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[tolerateVelocityMaximumFailure](default.true.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[lengthResolution]— The gravitational softening length \(\Delta x\) (in Mpc) of the N-body simulation, which sets the minimum spatial scale below which the dark matter profile is smoothed to avoid artificial two-body effects.[massResolution]— The mass resolution \(\Delta M\) (in \(\mathrm{M}_\odot\)) of the N-body simulation, representing the minimum halo mass that can be resolved; profiles of halos near this limit are softened to account for particle discreteness effects.[resolutionIsComoving]— If true, the resolution length is assumed to be fixed in comoving coordinates, otherwise in physical coordinates.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[C](default400.0d0) — The parameter \(C\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[f](default0.02d0) — The parameter \(f\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[timeFormationSeekDelta](default0.0d0) — The parameter \(\Delta \log t\) by which the logarithm of the trial formation time is incremented when stepping through the formation history of a node to find the formation time. If set to zero (or a negative value) the cumulative mass histories of nodes are assumed to be monotonic functions of time, and the formation time is instead found by a root finding algorithm,[massBoundIsInactive](default.false.) — Specifies whether or not the bound mass of the satellite component is inactive (i.e. does not appear in any ODE being solved).[useLastIsolatedTime](default.false.) — If true, evaluate the halo virial radius using a the virial density definition at the last isolated time of the halo.[filterName]— The filter to select.[filterType]— The filter type (rest or observed) to select.[redshiftBand]— The redshift of the band (if not the output redshift).[postprocessChain]— The postprocessing chain to use.[cloudyTableFileName](defaultvar_str('%DATASTATICPATH%/hiiRegions/emissionLineLuminosities_BC2003_highResolution_imfChabrier.hdf5')) — The file of emission line luminosities to use.[lineNames]— The emission lines to extract.[component]— The component from which to extract star formation rate.[toleranceRelative](default1.0d-3) — The relative tolerance used in integration over stellar population spectra.[component]— The component from which to extract star formation rate.[radiusCore]— The soliton core radius (in Mpc) characterizing the size of the quantum pressure-supported central core of the fuzzy dark matter halo; the density profile flattens inside this scale.[densitySolitonCentral]— The central density (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the solitonic core at \(r=0\), which sets the overall normalization of the density profile \(\rho(r) = \rho_\mathrm{c} [1+(r/r_c)^2]^{-8}\).[toleranceRelativePotential](default1.0d-3) — The relative tolerance used in numerical ODE solutions for the gravitational potential of the solitonic core profile.[dimensionless](default.true.) — If true the soliton profile is treated as dimensionless (scale-free), allowing its radial and density quantities to be specified in arbitrary units.[componentType](defaultvar_str('unknown')) — The galactic structure component type (e.g.dark matter halo, disk, spheroid) represented by this mass distribution, used for component-specific queries.[massType](defaultvar_str('unknown')) — The mass type (e.g.dark matter, baryonic, total) represented by this mass distribution, used for mass-type-specific queries.[radiusTransition]— The transition radius (in Mpc) at which the density profile smoothly switches from the halo profile to the accretion flow, controlled by the fourth-order transition function \(f_\mathrm{trans}(r)\).[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[timeAge]— The age of the halo (in Gyr) since its formation, determining the total time available for SIDM self-interactions to thermalize the inner halo and produce an isothermal core.[velocityRelativeMean]— Mean relative velocity to calculate self interaction cross section.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[tolerateVelocityMaximumFailure](default.false.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate failures to compute the potential.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[lengthResolution]— The spatial resolution length scale (in Mpc) below which the underlying density profile is softened to a flat core, mimicking the finite force resolution of an N-body simulation.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[massMinimum]— The minimum halo mass (in \(\mathrm{M}_\odot\)) below which halos are excluded from the mass function histogram.[massMaximum]— The maximum halo mass (in \(\mathrm{M}_\odot\)) above which halos are excluded from the mass function histogram.[massCountPerDecade]— The number of logarithmic bins per decade of halo mass used when constructing the halo mass function.[description]— A human-readable description of this mass function dataset, stored as metadata in the output file.[simulationReference]— A bibliographic reference for the N-body simulation from which this mass function is derived, stored as metadata.[simulationURL]— A URL pointing to the publicly accessible dataset or documentation for the N-body simulation, stored as metadata.[bootstrapSampleCount](default30_c_size_t) — The number of bootstrap resamples of the particles that should be used.[representativeMinimumCount](default10_c_size_t) — Minimum number of representative particles used to compute the center of a halo.[tolerance](default1.0d-2) — The tolerance in the summed weight of bound particles which must be attained to declare convergence.[bootstrapSampleRate](default1.0d0) — The sampling rate for particles.[representativeFraction](default0.05d0) — Fraction of bound particles used to compute the center of a halo.[analyzeAllParticles](default.true.) — If true, all particles are assumed to be self-bound at the beginning of the analysis. Unbound particles at previous times are allowed to become bound in the current snapshot. If false and the self-bound information from the previous snapshot is available, only the particles that are self-bound at the previous snapshot are assumed to be bound at the beginning of the analysis.[useVelocityMostBound](default.false.) — If true, the velocity of the most bound particle in velocity space is used as the representative velocity of the satellite. If false, use the mass weighted mean velocity (center-of-mass velocity) of self-bound particles instead.[orderRotation](defaultvar_str('none')) — The order in which evaluation of likelihoods should be rotated as a function of process number.[logLikelihoodAccept](defaulthuge(0.0d0)) — The log-likelihood which should be “accepted”—once the log-likelihood reaches this value (or larger) no further updates to the chain will be made.[report](default.false.) — If true, report on the log-likelihood obtained.[means]— The mean of the multivariate normal distribution.[covariance]— The covariance matrix for the of the multivariate normal distribution.[countForestsMaximum](default-1_c_size_t) — If set to a positive number, this is the maximum number of forests that will be evolved.[walltimeMaximum](default-1_kind_int8) — If set to a positive number, this is the maximum wall time for which forest evolution is allowed to proceed before the task gives up.[tolerateFailures](default.false.) — If true then failures to evolve a forest are tolerated. The forest is evolved no further, but evolution of other forests continues.[evolveForestsInParallel](default.true.) — If true then each forest is evolved by a separate OpenMP thread. Otherwise, a single thread evolves all forests.[suspendToRAM](default.true.) — Specifies whether trees should be suspended to RAM (otherwise they are suspend to file).[suspendPath]— The path to which tree suspension files will be stored.[timeIntervalCheckpoint](default-1_kind_int8) — If positive, gives the time in seconds between storing of checkpoint files. If zero or negative, no checkpointing is performed..[fileNameCheckpoint]— The path to which checkpoint data will be stored.[logM0](default10.0d0) — The parameter \(\log_{10} M_0\) (with \(M_0\) in units of \(\mathrm{M}_\odot\)) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR0](default9.0d0) — The parameter \(\alpha_0\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR1](default0.0d0) — The parameter \(\alpha_1\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[cW](default3.78062835d0) — The parameter \(c_\mathrm{W}\) in the Bohr et al. (2021) power spectrum window function.[beta](default3.4638743d0) — The parameter \(\beta\) in the Bohr et al. (2021) power spectrum window function.[transferFunctionType](defaultvar_str('darkMatter')) — Specifies whether to use thedarkMatterortotaltransfer function.[fileName]— The name of the file from which to read a tabulated transfer function.[redshift](default0.0d0) — The redshift of the transfer function to read.[factorWavenumberSmoothExtrapolation](default0.0d0) — If positive, and extrapolation is used at high wavenumbers, the slope for extrapolation will be set by averaging over wavenumbers from \(k_\mathrm{max}/f\) to \(k_\mathrm{max}\), where \(f=\)[factorWavenumberSmoothExtrapolation]and \(k_\mathrm{max}\) is the highest wavenumber tabulated. This avoids spurious extrapolation for highly oscillatory transfer functions.[acceptNegativeValues](default.false.) — If true, negative values in the transfer function are allowed (and the absolute value is taken prior to interpolation). Otherwise, negative values result in an error.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[fileName](defaultvar_str('none')) — The name of the file to/from which tabulations of barrier first crossing probabilities should be written/read. If set to “none” tables will not be stored.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[varianceNumberPerUnitProbability](default1000) — The number of points to tabulate per unit variance for first crossing probabilities.[varianceNumberPerUnit](default40) — The number of tabulation points per unit of \(\sigma^2\) used when building the rate look-up table for the Farahi excursion-set first-crossing distribution; higher values improve interpolation accuracy at the cost of memory and initialization time.[varianceNumberPerDecade](default400) — The number of points to tabulate per decade of progenitor variance for first crossing rates.[varianceNumberPerDecadeNonCrossing](default40) — The number of points to tabulate per decade of progenitor variance for non-crossing rates.[timeNumberPerDecade](default10) — The number of tabulation points per decade of cosmic time used when building the first-crossing rate look-up table as a function of time; higher values improve temporal interpolation accuracy for rapidly evolving cosmologies.[varianceIsUnlimited](default.false.) — If true, the variance is assumed to have no upper limit (e.g. as in the case of CDM). This allows the tabulated solutions to be extended arbitrarily. Otherwise, tables are extended to encompass just the range of variance requested.[linkingLength](default0.2d0) — The friends-of-friends linking length to use in computing virial density contrasts with the percolation analysis of More et al. (2011).
darkMatterProfileDMOHeatedMonotonic¶
A dark matter profile DMO class in which builds massDistributionSphericalHeatedMonotonic objects to account for heating of some other dark matter profile.
Methods
computeSolution— Compute a solution for the heated profile.
Parameters
[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[radiusVirial]— The virial radius (in Mpc) of the halo, defining the outer boundary up to which the monotonic heating calculation tracks the energy-ordered shell mapping from the initial to heated density profile.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOIsothermal¶
A dark matter profile DMO class in which builds massDistributionIsothermal objects to implement isothermal density profiles, normalized such that the total mass of the node is enclosed with the virial radius.
Parameters
[temperature]— The temperature (in Kelvin) of the isothermal gas distribution; used withmassAtomicMeanto compute the 1D velocity dispersion via \(\sigma^2 = k_\mathrm{B} T / (\mu m_\mathrm{H})\).[massAtomicMean]— The mean atomic mass (in atomic mass units) of the distribution.[velocityDispersion]— The 1D velocity dispersion (in km/s) of the isothermal distribution, used directly when notemperatureis specified; sets the thermally broadened line-of-sight velocity spread.[densityNormalization](default0.25d0/Pi) — The density normalization of the isothermal profile.[lengthReference](default1.0d0) — The reference radius (in Mpc) of the isothermal profile at whichdensityNormalizationis evaluated; sets the physical length scale of the \(\rho \propto r^{-2}\) profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) enclosed within the reference radius, used to normalize the \(\rho \propto r^{-2}\) density profile whendensityNormalizationis not supplied.[dimensionless](default.true.) — If true the isothermal profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOMultiple¶
A dark matter profile DMO class in which the density profiles of the host halo and the satellite halo can be set separately to any other darkMatterProfileDMO available.
darkMatterProfileDMONFW¶
A dark matter profile DMO class which builds massDistributionNFW objects to implement the NFW density profile (Navarro et al., 1997), normalized such that the total mass of the node is enclosed with the virial radius and with the scale length \(r_\mathrm{s} = r_\mathrm{virial}/c\) where \(c\) is the halo concentration (see darkMatterProfileConcentration).
(Default implementation)
Methods
radiusEnclosingDensityTabulate— Tabulate the radius enclosing a given density as a function of density and core radius.radiusEnclosingMassTabulate— Tabulate the radius enclosing a given mass as a function of density and core radius.energyTabulate— Tabulate the energy as a function of concentration and core radius.densityScaleFree— The density of the profile in units where the mass and scale length are both 1.massEnclosedScaleFree— The mass enclosed of the profile in units where the mass and scale length are both 1.storeDensityTable— Store the tabulated radius-enclosing-density to file.restoreDensityTable— Attempt to restore the tabulated radius-enclosing-density from file, returning true if successful.storeMassTable— Store the tabulated radius-enclosing-mass to file.restoreMassTable— Attempt to restore the tabulated radius-enclosing-mass from file, returning true if successful.storeEnergyTable— Store the tabulated energy to file.restoreEnergyTable— Attempt to restore the tabulated energy from file, returning true if successful.suffix— Return a file name suffix (containing a source code digest.
Parameters
[useSeriesApproximation](default.true.) — If true, use a fast series approximation to the velocity dispersion profile in an NFW mass distribution. The approximation matches the exact (dilogarithm-based) form to better than \(5\times 10^{-6}\) in relative terms across \(r/r_\mathrm{s} \in [10^{-4},10^4]\) (seetests.kinematic_distributions.NFW).[velocityDispersionUseSeriesExpansion](default.true.) — Iftrue, radial velocity dispersion is computed using series expansion.[lengthResolution]— The gravitational softening length \(\Delta x\) (in Mpc) of the N-body simulation used to smooth the NFW profile at small radii, preventing artificial divergence below the resolution scale.[massResolution]— The mass resolution \(\Delta M\) (in \(\mathrm{M}_\odot\)) of the N-body simulation, used to determine the finite-resolution softening of the NFW profile for halos near the resolution limit.[resolutionIsComoving]— If true, the resolution length is assumed to be fixed in comoving coordinates, otherwise in physical coordinates.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[f](default0.01d0) — The parameter \(f\) appearing in the halo concentration algorithm of Navarro et al. (1996).[C](default2000.0d0) — The parameter \(C\) appearing in the halo concentration algorithm of Navarro et al. (1996).[densityNormalization](default1.0d0/2.0d0/Pi/(log(4.0d0)-1.0d0)) — The density normalization of the NFW profile.[scaleLength](default1.0d0) — The NFW scale radius (in Mpc) \(r_\mathrm{s}\) at which the density profile transitions from the inner \(\rho \propto r^{-1}\) to the outer \(\rho \propto r^{-3}\) slope.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the NFW profile, used to set the density normalization when the concentration and virial radius are provided.[concentration](default1.0d0) — The halo concentration parameter \(c = r_\mathrm{vir}/r_\mathrm{s}\) of the NFW profile, controlling how centrally concentrated the dark matter density profile is.[virialRadius](default1.0d0) — The virial radius (in Mpc) \(r_\mathrm{vir}\) of the NFW halo, which defines the outer boundary of the profile at which the mean enclosed density equals the virial overdensity threshold.[dimensionless](default.true.) — If true the NFW profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[lengthResolution]— The spatial resolution length scale (in Mpc) of the N-body simulation being modeled; sets the minimum effective radius below which the NFW density profile is softened.[radiusScale]— The NFW scale radius (in Mpc) at which the density profile transitions from the inner \(\rho \propto r^{-1}\) slope to the outer \(\rho \propto r^{-3}\) slope.[radiusVirial]— The virial radius (in Mpc) of the halo, defining the outer boundary of the NFW profile at which the mean enclosed density equals the virial overdensity threshold.[mass]— The total mass (in \(\mathrm{M}_\odot\)) enclosed within the virial radius, used together withradiusScaleandradiusVirialto normalize the NFW density profile.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOPenarrubia2010¶
A dark matter profile DMO class which builds massDistributionZhao1996 to implement the Peñarrubia et al. (2010) density profile.
Parameters
[alpha]— The parameter \(\alpha\) of the Zhao (1996) dark matter density profile.[beta]— The parameter \(\beta\) of the Zhao (1996) dark matter density profile.[betaStripped](default5.0d0) — The parameter \(\beta_\mathrm{stripped}\) of the Peñarrubia et al. (2010) dark matter density profile. This is the \(\beta\) exponent of the Zhao (1996) dark matter density profile for cases where significant stripping of the profile has occurred.[gamma]— The parameter \(\gamma\) of the Zhao (1996) dark matter density profile.[muRadius]— The parameter \(\mu\) of the Peñarrubia et al. (2010) tidal track for \(r_\mathrm{max}\).[etaRadius]— The parameter \(\eta\) of the Peñarrubia et al. (2010) tidal track for \(r_\mathrm{max}\).[muVelocity]— The parameter \(\mu\) of the Peñarrubia et al. (2010) tidal track for \(V_\mathrm{max}\).[etaVelocity]— The parameter \(\eta\) of the Peñarrubia et al. (2010) tidal track for \(V_\mathrm{max}\).[etaVelocity]— The parameter \(\eta\) of the Peñarrubia et al. (2010) tidal track for \(V_\mathrm{max}\).
darkMatterProfileDMOSIDMCoreNFW¶
Cored-NFW dark matter halo profiles to approximate the effects of SIDM based on the model of Jiang et al. (2023) are built via massDistributionSphericalSIDMCoreNFW objects.
Methods
radiusCore— Computes the core radius of halo.
Parameters
[factorRadiusCore](default0.45d0) — The factor \(\alpha\) appearing in the definition of the core radius, \(r_\mathrm{c}=\alpha r_1\) where \(r_1\) is the radius at which an SIDM particle has had, on average, 1 interaction.[timeAge]— The age of the halo (in Gyr) since its formation, used to compute how long SIDM self-interactions have been active in determining the size of the dark matter core.[velocityRelativeMean]— Mean relative velocity to calculate self interaction cross section.[factorRadiusCore](default0.45d0) — The factor \(\alpha\) appearing in the definition of the core radius, \(r_\mathrm{c}=\alpha r_1\) where \(r_1\) is the radius at which an SIDM particle has had, on average, 1 interaction.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOSIDMIsothermal¶
Dark matter halo profiles for self-interacting dark matter following the “isothermal” model of Jiang et al. (2023) are built via the massDistributionSphericalSIDMIsothermal mass distribution class.
Parameters
[temperature]— The temperature (in Kelvin) of the isothermal gas distribution; used withmassAtomicMeanto compute the 1D velocity dispersion via \(\sigma^2 = k_\mathrm{B} T / (\mu m_\mathrm{H})\).[massAtomicMean]— The mean atomic mass (in atomic mass units) of the distribution.[velocityDispersion]— The 1D velocity dispersion (in km/s) of the isothermal distribution, used directly when notemperatureis specified; sets the thermally broadened line-of-sight velocity spread.[densityNormalization](default0.25d0/Pi) — The density normalization of the isothermal profile.[lengthReference](default1.0d0) — The reference radius (in Mpc) of the isothermal profile at whichdensityNormalizationis evaluated; sets the physical length scale of the \(\rho \propto r^{-2}\) profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) enclosed within the reference radius, used to normalize the \(\rho \propto r^{-2}\) density profile whendensityNormalizationis not supplied.[dimensionless](default.true.) — If true the isothermal profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOSIDMParametric¶
Dark matter halo profiles for self-interacting dark matter following the “SIDM parametric” model of Yang et al. (2024) are built via the massDistributionSIDMParametricProfile class.
Parameters
[beta](default4.0d0) — The value \(\beta\) in a SIDMParametric-model mass distribution.[alpha](default2.0d0) — The coefficient \(\alpha\) of the halo mass-growth term in the gravothermal \(\tau\) evolution, \(\dot\tau = 1/t_\mathrm{c} - \alpha \, (\dot{M}/M) \, \tau\). The default value of \(2.0\) is the best-fit value found by Raut et al. (2026).[C](default0.75d0) — The calibration constant \(C\) relating the gravothermal collapse timescale \(t_\mathrm{c}\) to the relaxation time (eqn. 2.2 of Yang et al. (2024)). The default value of \(0.75\) is the best-fit value found by Raut et al. (2026).
darkMatterProfileDMOSolitonNFW¶
A dark matter profile DMO class which builds massDistributionSolitonNFW objects to implement the FDM profile. The core-halo mass relation and core radius are computed following Chan et al. (2022), while the core density normalization follows Schive et al. (2014).
Methods
computeProperties— Compute properties of the mass distribution.calculationReset— Reset memoized calculations.
Parameters
[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion.[scatterFractional](default0.5d0) — The fractional scatter in the solitonic core-halo mass relation (default corresponds to a 50% fractional scatter).[radiusScale]— The scale radius of the NFW component of the mass distribution.[radiusCore]— The soliton core radius (in Mpc) characterizing the size of the central quantum pressure-supported core of the fuzzy dark matter halo before the profile transitions to the outer NFW envelope.[radiusSoliton]— The transition radius (in Mpc) at which the solitonic core profile smoothly joins onto the outer NFW envelope; the density profile matches the NFW form beyond this radius.[densitySolitonCentral]— The central density (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the solitonic core at \(r=0\), which sets the normalization of the soliton density profile \(\rho(r) = \rho_\mathrm{c} [1+(r/r_c)^2]^{-8}\).[densityNormalizationNFW]— The density normalization \(\rho_0\) (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the outer NFW component, setting the amplitude of the \(\rho(r) = \rho_0/[(r/r_\mathrm{s})(1+r/r_\mathrm{s})^2]\) profile.[concentration]— The concentration parameter \(c = r_\mathrm{vir}/r_\mathrm{s}\) of the outer NFW component, specifying how centrally concentrated the NFW halo is.[radiusVirial]— The virial radius (in Mpc) of the outer NFW component, defining the outer boundary of the halo at which the mean enclosed density equals the virial overdensity threshold.[toleranceRelativePotential](default1.0d-3) — The relative tolerance used in numerical ODE solutions for the gravitational potential of the soliton-NFW composite profile.[dimensionless](default.true.) — If true the soliton-NFW profile is treated as dimensionless (scale-free), allowing its radial and density quantities to be specified in arbitrary units.[componentType](defaultvar_str('unknown')) — The galactic structure component type (e.g.dark matter halo, disk, spheroid) represented by this mass distribution, used for component-specific queries.[massType](defaultvar_str('unknown')) — The mass type (e.g.dark matter, baryonic, total) represented by this mass distribution, used for mass-type-specific queries.
darkMatterProfileDMOSolitonNFWHeated¶
A dark matter profile DMO class which builds massDistributionSolitonNFWHeated objects to implement the FDM profile. The inner region follows the soliton solution, while the outer region transitions to a heated NFW envelope. The core-halo mass relation and core radius are computed following Chan et al. (2022), while the core density normalization follows Schive et al. (2014).
Methods
computeProperties— Compute properties of the mass distribution.calculationReset— Reset memoized calculations.
Parameters
[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate numerical failures when computing the gravitational potential of the heated soliton-NFW dark matter profile (e.g. due to extreme heating), allowing the calculation to proceed with a fallback result.[velocityDispersionApproximate](default.true.) — Iftrue, radial velocity dispersion is computed using an approximate method in which we assume that \(\sigma_\mathrm{r}^2(r) \rightarrow \sigma_\mathrm{r}^2(r) - (2/3) \epsilon(r)\), where \(\epsilon(r)\) is the specific heating energy. Iffalsethen radial velocity dispersion is computed by numerically solving the Jeans equation.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[scatterFractional](default0.5d0) — The fractional scatter in the solitonic core-halo mass relation (default corresponds to a 50% fractional scatter).[radiusCore]— The soliton core radius (in Mpc) that characterizes the size of the central quantum pressure-supported core of the fuzzy dark matter halo; density is approximately constant within this radius.[radiusSoliton]— The outer radius (in Mpc) of the soliton region, beyond which the profile transitions from the soliton core to the heated NFW outer envelope.[densitySolitonCentral]— The central density (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the solitonic core at \(r=0\), which sets the normalization of the soliton density profile \(\rho(r) = \rho_\mathrm{c} [1+(r/r_\mathrm{c})^2]^{-8}\).[toleranceRelativePotential](default1.0d-3) — The relative tolerance used in numerical ODE solutions for the gravitational potential of the heated soliton-NFW composite profile.[dimensionless](default.true.) — If true the NFW profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOTruncated¶
Truncated dark matter halo profiles are built via the massDistributionSphericalTruncated mass distribution class.
Methods
tabulate— Tabulate the virial density contrast as a function of mass and time.restoreTable— Restore a tabulated solution from file.storeTable— Store a tabulated solution to file.
Parameters
[velocityCharacteristic](default250.0d0) — The velocity scale at which the SNe-driven outflow rate equals the star formation rate in disks.[exponent](default3.5d0) — The velocity scaling of the SNe-driven outflow rate in disks.[fraction](default0.01d0) — The normalization \(f\) of the outflow rate relative to the star formation rate at a reference halo velocity of 200 km/s and expansion factor of 1, setting the overall mass-loading amplitude of the halo-scaling feedback model.[exponentVelocity](default-2.0d0) — The exponent of virial velocity in the outflow rate in disks.[exponentRedshift](default0.0d0) — The power-law exponent of the cosmological expansion factor \((1+z)\) in the halo-scaling outflow rate, allowing the mass-loading factor to evolve with redshift; a value of zero gives no redshift evolution.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[radiusNormalization](default3.3d-6) — The initial value appearing in the radius-mass relation[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the nuclear star cluster is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not nuclear star cluster stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[scaleRelativeMass](default1.0d-2) — The mass scale, relative to the total mass of the node, below which calculations in the delayed very simple hot halo component are allowed to become inaccurate.[starveSatellites](default.false.) — Specifies whether or not the hot halo should be removed (“starved”) when a node becomes a satellite.[starveSatellitesOutflowed](default.false.) — Specifies whether or not the outflowed hot halo should be removed (“starved”) when a node becomes a satellite.[outflowReturnOnFormation](default.false.) — Specifies whether or not outflowed gas should be returned to the hot reservoir on halo formation events.[angularMomentumAlwaysGrows](default.false.) — Specifies whether or not negative rates of accretion of angular momentum into the hot halo will be treated as positive for the purposes of computing the hot halo angular momentum.[fractionBaryonLimitInNodeMerger](default.false.) — Controls whether the hot gas content of nodes should be limited to not exceed the universal baryon fraction at node merger events. If set totrue, hot gas (and angular momentum, abundances, and chemicals proportionally) will be removed from the merged halo to the unaccreted gas reservoir to limit the baryonic mass to the universal baryon fraction where possible.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple disk component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the disk is physically plausible.[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[radiusStructureSolver](default1.0d0) — The radius (in units of the standard scale length) to use in solving for the size of the disk.[structureSolverUseCole2000Method](default.false.) — If true, use the method described in Cole et al. (2000) to correct for difference between thin disk and spherical mass distributions when solving for disk radii.[diskNegativeAngularMomentumAllowed](default.true.) — Specifies whether or not negative angular momentum is allowed for the disk.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not disk stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumSolverRadius](defaultratioAngularMomentumSolverRadiusDefault) — The assumed ratio of the specific angular momentum at the structure solver radius to the mean specific angular momentum of the standard disk component.[scaleAbsoluteMass](default100.0d0) — The absolute mass scale below which calculations in the very simple spheroid component are allowed to become inaccurate.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[efficiencyEnergeticOutflow](default1.0d-2) — The proportionality factor relating mass outflow rate from the spheroid to the energy input rate divided by \(V_\mathrm{spheroid}^2\).[toleranceRelativeMetallicity](default1.0d-4) — The metallicity tolerance for ODE solution.[toleranceAbsoluteMass](default1.0d-6) — The mass tolerance used to judge whether the spheroid is physically plausible.[inactiveLuminositiesStellar](default.false.) — Specifies whether or not spheroid stellar luminosities are inactive properties (i.e. do not appear in any ODE being solved).[postStepZeroNegativeMasses](default.true.) — If true, negative masses will be zeroed after each ODE step. Note that this can lead to non-conservation of mass.[ratioAngularMomentumScaleRadius](defaultratioAngularMomentumScaleRadiusDefault) — The assumed ratio of the specific angular momentum at the scale radius to the mean specific angular momentum of the standard spheroid component.[outputMergers](default.false.) — Determines whether or not properties of black hole mergers will be output.[fileNames]— The name of the file(s) from which merger tree data should be read when using the[mergerTreeConstruct]\(=\)readtree construction method.[forestSizeMaximum](default0_c_size_t) — The maximum number of nodes allowed in a forest before it will be broken up into trees and processed individually. A value of 0 implies that forests should never be split.[presetMergerTimes](default.true.) — Specifies whether merging times for subhalos should be preset when reading merger trees from a file.[presetMergerNodes](default.true.) — Specifies whether the target nodes for mergers should be preset (i.e. determined from descendant nodes). If they are not, merging will be with each satellite’s host node.[presetSubhaloMasses](default.true.) — Specifies whether subhalo mass should be preset when reading merger trees from a file.[subhaloAngularMomentaMethod](defaultvar_str('summation')) — Specifies how to account for subhalo angular momentum when adding subhalo mass to host halo mass.[presetSubhaloIndices](default.true.) — Specifies whether subhalo indices should be preset when reading merger trees from a file.[presetPositions](default.true.) — Specifies whether node positions should be preset when reading merger trees from a file.[presetScaleRadii](default.true.) — Specifies whether node scale radii should be preset when reading merger trees from a file.[scaleRadiiFailureIsFatal](default.true.) — Specifies whether failure to set a node scale radii should be regarded as a fatal error. (If not, a fallback method to set scale radius is used in such cases.)[presetScaleRadiiConcentrationMinimum](default3.0d0) — The lowest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiConcentrationMaximum](default60.0d0) — The largest concentration (\(c=r_\mathrm{vir}/r_\mathrm{s}\)) allowed when setting scale radii, \(r_\mathrm{s}\).[presetScaleRadiiMinimumMass](default0.0d0) — The minimum halo mass for which scale radii should be preset (if[presetScaleRadii]\(=\)true).[presetUnphysicalAngularMomenta](default.false.) — When reading merger trees from file and presetting halo angular momenta, detect unphysical (<=0) angular momenta and preset them using the selected halo spin method.[presetAngularMomenta](default.true.) — Specifies whether node angular momenta should be preset when reading merger trees from a file.[presetAngularMomenta3D](default.false.) — Specifies whether node 3-D angular momenta vectors should be preset when reading merger trees from a file.[presetOrbits](default.true.) — Specifies whether node orbits should be preset when reading merger trees from a file.[presetOrbitsSetAll](default.true.) — Forces all orbits to be set. If the computed orbit does not cross the virial radius, then select one at random instead.[presetOrbitsAssertAllSet](default.true.) — Asserts that all virial orbits must be preset. If any can not be set, Galacticus will stop.[presetOrbitsBoundOnly](default.true.) — Specifies whether only bound node orbits should be set.[beginAt](default-1_kind_int8) — Specifies the index of the tree to begin at. (Use -1 to always begin with the first tree.)[outputTimeSnapTolerance](default0.0d0) — The relative tolerance required to “snap” a node time to the closest output time.[missingHostsAreFatal](default.true.) — Specifies whether nodes with missing host nodes should be considered to be fatal—see the discussion of missing host nodes in the class description above.[treeIndexToRootNodeIndex](default.false.) — Specifies whether tree indices should always be set to the index of their root node.[allowBranchJumps](default.true.) — Specifies whether nodes are allowed to jump between branches.[allowSubhaloPromotions](default.true.) — Specifies whether subhalos are permitted to be promoted to being isolated halos.[alwaysPromoteMostMassive](default.false.) — If true, the most massive progenitor is always promoted to be the primary progenitor even if it is a subhalo. Otherwise, isolated progenitors are given priority over subhalo progenitors, even if they are less massive.[presetNamedReals]— Names of real datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[presetNamedIntegers]— Names of integer datasets to be additionally read and stored in the nodes of the merger tree when using the[mergerTreeConstruct]\(=\)readtree construction method.[fatalMismatches](default.true.) — Specifies whether mismatches in cosmological parameter values between Galacticus and “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be considered fatal.[fatalNonTreeNode](default.true.) — Specifies whether nodes in snapshot files but not in the merger tree file should be considered fatal when importing from the “Sussing Merger Trees” format (Srisawat et al., 2013).[subvolumeCount](default1) — Specifies the number of subvolumes along each axis into which a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree files should be split for processing through Galacticus.[subvolumeBuffer](default0.0d0) — Specifies the buffer region (in units of Mpc\(/h\) to follow the format convention) around subvolumes of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file which should be read in to ensure that no halos are missed from trees.[subvolumeIndex](default[0,0,0]) — Specifies the index (in each dimension) of the subvolume of a “Sussing Merger Trees” format (Srisawat et al., 2013) merger tree file to process. Indices range from 0 to[subvolumeCount]\(-1\).[badValue](default-0.5d0) — Use for bad value detection in “Sussing” merger trees. Values for scale radius and halo spin which exceed this threshold are assumed to be bad.[badValueTest](defaultvar_str('lessThan')) — Use for bad value detection in “Sussing” merger trees. Values which exceed the threshold in ths specified direction are assumed to be bad.[treeSampleRate](default1.0d0) — Specify the probability that any given tree should processed (to permit subsampling).[massOptions](defaultvar_str('default')) — Mass option for Sussing merger trees.[mergeProbability](default0.1d0) — The largest probability of branching allowed in a timestep in merger trees built by the Cole et al. (2000) method.[accretionLimit](default0.1d0) — The largest fractional mass change due to subresolution accretion allowed in a timestep in merger trees built by the Cole et al. (2000) method.[redshiftMaximum](default1.0d5) — The highest redshift to which merger trees will be built in the Cole et al. (2000) method.[toleranceTimeEarliest](default2.0d-6) — The fractional tolerance used to judge if a branch is at the earliest allowed time in the tree.[branchIntervalStep](default.true.) — Iffalseuse the original Cole et al. (2000) method to determine whether branching occurs in a timestep. Iftruedraw branching intervals from a negative exponential distribution.[toleranceResolutionSelf](default1.0d-6) — The fractional tolerance in node mass at the resolution limit below which branch mis-orderings will be ignored.[toleranceResolutionParent](default1.0d-3) — The fractional tolerance in parent node mass at the resolution limit below which branch mis-orderings will be ignored.[ignoreNoProgress](default.false.) — If true, failure to make progress on a branch will be ignored (and the branch terminated).[ignoreWellOrdering](default.false.) — If true, non-well-ordered tree branches are pruned away instead of causing errors..[redshiftBase](default0.0d0) — The redshift at which to plant the base node when building merger trees.[timeSnapTolerance](default1.0d-6) — The fractional tolerance within which the tree base time will be snapped to a nearby output time.[treeBeginAt](default0) — The index (in order of increasing base halo mass) of the tree at which to begin when building merger trees. A value of “0” means to begin with tree number 1 (if processing trees in ascending order), or equal to the number of trees (otherwise).[processDescending](default.true.) — If true, causes merger trees to be processed in order of decreasing mass.[splitTrees](default.false.) — If true, prune away any nodes of the tree that are not needed to determine evolution up to the latest time at which a node is present inside the lightcone. This typically leads to a tree splitting into a forest of trees.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[starFormationRates]— The star formation rates corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of star formation rate to use when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d10) — The star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d12) — The maximum star formation rate to consider when constructing star formation rate function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[likelihoodBins]— Controls which bins in the stellar mass–halo mass relation will be used in computing the likelihood: * not present: all bins are included in the likelihood calculation; * list of integers: use only the mass bin(s) given in this list in the likelihood calculation; *auto: use only bins which have a non-zero number of halos contributing to them in the likelihood calculation.[fileNameTarget]— The name of the file containing the target data.[redshiftInterval](default1) — The redshift interval to use.[likelihoodNormalize](default.false.) — If true, then normalize the likelihood to make it a probability density.[computeScatter](default.false.) — If true, the scatter in log10(stellar mass) is computed. Otherwise, the mean is computed.[systematicErrorPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for stellar mass in the stellar vs halo mass relation.[systematicErrorMassHaloPolynomialCoefficient](default[0.0d0]) — The coefficients of the systematic error polynomial for halo mass in the stellar vs halo mass relation.[errorTolerant](default.false.) — Error tolerance for the N-body spin distribution operator.[logNormalRange](default100.0d0) — The multiplicative range of the log-normal distribution used to model the distribution of the mass and energy terms in the spin parameter. Specifically, the lognormal distribution is truncated outside the range \((\lambda_\mathrm{m}/R,\lambda_\mathrm{m} R\), where \(\lambda_\mathrm{m}\) is the measured spin, and \(R=\)[logNormalRange][fileName]— The name of the file from which to read spin distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the spin distribution function.[comment]— A descriptive comment for the spin distribution function.[redshift]— The redshift at which to compute the spin distribution function.[massMinimum]— Minimum halo mass for the spin distribution function.[massMaximum]— Maximum halo mass for the spin distribution function.[spinMinimum]— Minimum spin for the spin distribution function.[spinMaximum]— Maximum spin for the spin distribution function.[countSpinsPerDecade]— Number of spins per decade at which to compute the spin distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[particleCountMinimum]— The minimum particle count to assume when computing N-body errors on spins.[massParticle]— The mass of the particle used in the N-body simulation from which spins were measured.[energyEstimateParticleCountMaximum]— The maximum number of particles used in estimating halo energies when measuring spins from the N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing HI mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[magnitudesAbsolute]— The absolute magnitudes corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the luminosity function.[comment]— A descriptive comment for the luminosity function.[luminosities]— The luminosities corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing luminosity function covariance matrices for main branch galaxies.[includeNitrogenII](default.false.) — If true, include contamination by the [NII] (6548AA \(+\) 6584AA) doublet.[depthOpticalISMCoefficient](default1.0d0) — Multiplicative coefficient for optical depth in the ISM.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[masses]— The masses corresponding to bin centers.[covarianceBinomialBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[covarianceBinomialMassHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing stellar mass function covariance matrices for main branch galaxies.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[rootVarianceFractionalMinimum](default0.0d0) — The minimum fractional root variance (relative to the target dataset).[fileName]— The name of the file from which to read concentration distribution function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the concentration distribution function.[comment]— A descriptive comment for the concentration distribution function.[redshift]— The redshift at which to compute the concentration distribution function.[massMinimum]— Minimum halo mass for the concentration distribution function.[massMaximum]— Maximum halo mass for the concentration distribution function.[concentrationMinimum]— Minimum concentration for the concentration distribution function.[concentrationMaximum]— Maximum concentration for the concentration distribution function.[countConcentrationsPerDecade]— Number of concentrations per decade at which to compute the concentration distribution function.[timeRecent]— Halos which experienced a major node merger within a time \(\Delta t=\)[timeRecent]of the analysis time will be excluded from the analysis.[massParticle]— The particle mass in the source N-body simulation.[targetLabel]— Label for the target dataset.[functionValueTarget]— The target function for likelihood calculations.[functionCovarianceTarget]— The target function covariance for likelihood calculations.[fileName]— The name of the file from which to read star forming main sequence function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[label]— A label for the mass function.[comment]— A descriptive comment for the mass function.[separations]— The separations corresponding to bin centers.[massMinima]— The minimum mass of each mass sample.[massMaxima]— The maximum mass of each mass sample.[massHaloBinsPerDecade](default10) — The number of bins per decade of halo mass to use when constructing the mass function covariance matrix for main branch galaxies.[massHaloMinimum](default1.0d8) — The minimum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[massHaloMaximum](default1.0d16) — The maximum halo mass to consider when constructing the mass function covariance matrix for main branch galaxies.[wavenumberCount](default60_c_size_t) — The number of bins in wavenumber to use in computing the correlation function.[wavenumberMinimum](default1.0d-3) — The minimum wavenumber to use when computing the correlation function.[wavenumberMaximum](default1.0d4) — The maximum wavenumber to use when computing the correlation function.[integralConstraint]— The integral constraint for these correlation functions.[depthLineOfSight]— The line-of-sight depth over which the correlation function was projected.[halfIntegral]— Set to true if the projection integrand should be over line-of-sight depths greater than zero.[binnedProjectedCorrelationTarget]— The target function for likelihood calculations.[binnedProjectedCorrelationCovarianceTarget]— The target function covariance for likelihood calculations.[targetLabel](defaultvar_str('')) — A label for the target dataset in a plot of this analysis.[starFormationRateSpecificQuiescentLogarithmic]— The base-10 logarithm specific star formation rate (in units of Gyr\(^{-1}\)) separating quiescent and star-forming galaxies.[starFormationRateSpecificLogarithmicError]— The observational fractional error in specific star formation rate (in units of dex) of galaxies.[fileName]— The name of the file from which to read quiescent fraction function parameters.[comment]— A comment describing this analysis.[label]— A label for this analysis.[label]— A label for the star forming main sequence function.[comment]— A descriptive comment for the star forming main sequence function.[massMinimum]— Minimum stellar mass for the star forming main sequence function.[massMaximum]— Maximum stellar mass for the star forming main sequence function.[countMassesPerDecade]— Number of masses per decade at which to compute the star forming main sequence function.[targetLabel]— Label for the target dataset.[meanValueTarget]— The target function for likelihood calculations.[meanCovarianceTarget]— The target function covariance for likelihood calculations.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[radiusFractionalTruncateMinimum](default2.0d0) — The minimum radius (in units of the virial radius) to begin truncating the density profile.[radiusFractionalTruncateMaximum](default4.0d0) — The maximum radius (in units of the virial radius) to finish truncating the density profile.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[velocityDispersionApproximate](default.true.) — Iftrue, radial velocity dispersion is computed using an approximate method in which we assume that \(\sigma_\mathrm{r}^2(r) \rightarrow \sigma_\mathrm{r}^2(r) - (2/3) \epsilon(r)\), where \(\epsilon(r)\) is the specific heating energy. Iffalsethen radial velocity dispersion is computed by numerically solving the Jeans equation.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[tolerateVelocityDispersionFailure](default.false.) — Iftrue, tolerate failures to compute the velocity dispersion.[tolerateVelocityMaximumFailure](default.false.) — Iftrue, tolerate failures to find the radius of the maximum circular velocity.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate numerical failures when computing the gravitational potential of a heated dark matter profile, allowing the calculation to continue with a fallback result rather than aborting.[toleranceRelativeVelocityDispersion](default1.0d-6) — The relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[toleranceRelativeVelocityDispersionMaximum](default1.0d-3) — The maximum relative tolerance to use in numerical solutions for the velocity dispersion in dark-matter-only density profiles.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[tolerateVelocityMaximumFailure](default.true.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[lengthResolution]— The gravitational softening length \(\Delta x\) (in Mpc) of the N-body simulation, which sets the minimum spatial scale below which the dark matter profile is smoothed to avoid artificial two-body effects.[massResolution]— The mass resolution \(\Delta M\) (in \(\mathrm{M}_\odot\)) of the N-body simulation, representing the minimum halo mass that can be resolved; profiles of halos near this limit are softened to account for particle discreteness effects.[resolutionIsComoving]— If true, the resolution length is assumed to be fixed in comoving coordinates, otherwise in physical coordinates.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[C](default400.0d0) — The parameter \(C\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[f](default0.02d0) — The parameter \(f\) appearing in the halo concentration algorithm of Ludlow et al. (2016).[timeFormationSeekDelta](default0.0d0) — The parameter \(\Delta \log t\) by which the logarithm of the trial formation time is incremented when stepping through the formation history of a node to find the formation time. If set to zero (or a negative value) the cumulative mass histories of nodes are assumed to be monotonic functions of time, and the formation time is instead found by a root finding algorithm,[massBoundIsInactive](default.false.) — Specifies whether or not the bound mass of the satellite component is inactive (i.e. does not appear in any ODE being solved).[useLastIsolatedTime](default.false.) — If true, evaluate the halo virial radius using a the virial density definition at the last isolated time of the halo.[filterName]— The filter to select.[filterType]— The filter type (rest or observed) to select.[redshiftBand]— The redshift of the band (if not the output redshift).[postprocessChain]— The postprocessing chain to use.[cloudyTableFileName](defaultvar_str('%DATASTATICPATH%/hiiRegions/emissionLineLuminosities_BC2003_highResolution_imfChabrier.hdf5')) — The file of emission line luminosities to use.[lineNames]— The emission lines to extract.[component]— The component from which to extract star formation rate.[toleranceRelative](default1.0d-3) — The relative tolerance used in integration over stellar population spectra.[component]— The component from which to extract star formation rate.[radiusCore]— The soliton core radius (in Mpc) characterizing the size of the quantum pressure-supported central core of the fuzzy dark matter halo; the density profile flattens inside this scale.[densitySolitonCentral]— The central density (in \(\mathrm{M}_\odot\)/Mpc\(^3\)) of the solitonic core at \(r=0\), which sets the overall normalization of the density profile \(\rho(r) = \rho_\mathrm{c} [1+(r/r_c)^2]^{-8}\).[toleranceRelativePotential](default1.0d-3) — The relative tolerance used in numerical ODE solutions for the gravitational potential of the solitonic core profile.[dimensionless](default.true.) — If true the soliton profile is treated as dimensionless (scale-free), allowing its radial and density quantities to be specified in arbitrary units.[componentType](defaultvar_str('unknown')) — The galactic structure component type (e.g.dark matter halo, disk, spheroid) represented by this mass distribution, used for component-specific queries.[massType](defaultvar_str('unknown')) — The mass type (e.g.dark matter, baryonic, total) represented by this mass distribution, used for mass-type-specific queries.[radiusTransition]— The transition radius (in Mpc) at which the density profile smoothly switches from the halo profile to the accretion flow, controlled by the fourth-order transition function \(f_\mathrm{trans}(r)\).[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[timeAge]— The age of the halo (in Gyr) since its formation, determining the total time available for SIDM self-interactions to thermalize the inner halo and produce an isothermal core.[velocityRelativeMean]— Mean relative velocity to calculate self interaction cross section.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[tolerateVelocityMaximumFailure](default.false.) — If true, tolerate failures to find the radius of the peak in the rotation curve.[tolerateEnclosedMassIntegrationFailure](default.false.) — Iftrue, tolerate failures to find the mass enclosed as a function of radius.[toleratePotentialIntegrationFailure](default.false.) — Iftrue, tolerate failures to compute the potential.[fractionRadiusFinalSmall](default1.0d-3) — The initial radius is limited to be no smaller than this fraction of the final radius. This can help avoid problems in profiles that are extremely close to being disrupted.[toleranceRelativePotential](default1.0d-3) — The maximum allowed relative tolerance to use in numerical solutions for the gravitational potential in dark-matter-only density profiles before aborting.[lengthResolution]— The spatial resolution length scale (in Mpc) below which the underlying density profile is softened to a flat core, mimicking the finite force resolution of an N-body simulation.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.[massMinimum]— The minimum halo mass (in \(\mathrm{M}_\odot\)) below which halos are excluded from the mass function histogram.[massMaximum]— The maximum halo mass (in \(\mathrm{M}_\odot\)) above which halos are excluded from the mass function histogram.[massCountPerDecade]— The number of logarithmic bins per decade of halo mass used when constructing the halo mass function.[description]— A human-readable description of this mass function dataset, stored as metadata in the output file.[simulationReference]— A bibliographic reference for the N-body simulation from which this mass function is derived, stored as metadata.[simulationURL]— A URL pointing to the publicly accessible dataset or documentation for the N-body simulation, stored as metadata.[bootstrapSampleCount](default30_c_size_t) — The number of bootstrap resamples of the particles that should be used.[representativeMinimumCount](default10_c_size_t) — Minimum number of representative particles used to compute the center of a halo.[tolerance](default1.0d-2) — The tolerance in the summed weight of bound particles which must be attained to declare convergence.[bootstrapSampleRate](default1.0d0) — The sampling rate for particles.[representativeFraction](default0.05d0) — Fraction of bound particles used to compute the center of a halo.[analyzeAllParticles](default.true.) — If true, all particles are assumed to be self-bound at the beginning of the analysis. Unbound particles at previous times are allowed to become bound in the current snapshot. If false and the self-bound information from the previous snapshot is available, only the particles that are self-bound at the previous snapshot are assumed to be bound at the beginning of the analysis.[useVelocityMostBound](default.false.) — If true, the velocity of the most bound particle in velocity space is used as the representative velocity of the satellite. If false, use the mass weighted mean velocity (center-of-mass velocity) of self-bound particles instead.[orderRotation](defaultvar_str('none')) — The order in which evaluation of likelihoods should be rotated as a function of process number.[logLikelihoodAccept](defaulthuge(0.0d0)) — The log-likelihood which should be “accepted”—once the log-likelihood reaches this value (or larger) no further updates to the chain will be made.[report](default.false.) — If true, report on the log-likelihood obtained.[means]— The mean of the multivariate normal distribution.[covariance]— The covariance matrix for the of the multivariate normal distribution.[countForestsMaximum](default-1_c_size_t) — If set to a positive number, this is the maximum number of forests that will be evolved.[walltimeMaximum](default-1_kind_int8) — If set to a positive number, this is the maximum wall time for which forest evolution is allowed to proceed before the task gives up.[tolerateFailures](default.false.) — If true then failures to evolve a forest are tolerated. The forest is evolved no further, but evolution of other forests continues.[evolveForestsInParallel](default.true.) — If true then each forest is evolved by a separate OpenMP thread. Otherwise, a single thread evolves all forests.[suspendToRAM](default.true.) — Specifies whether trees should be suspended to RAM (otherwise they are suspend to file).[suspendPath]— The path to which tree suspension files will be stored.[timeIntervalCheckpoint](default-1_kind_int8) — If positive, gives the time in seconds between storing of checkpoint files. If zero or negative, no checkpointing is performed..[fileNameCheckpoint]— The path to which checkpoint data will be stored.[logM0](default10.0d0) — The parameter \(\log_{10} M_0\) (with \(M_0\) in units of \(\mathrm{M}_\odot\)) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR0](default9.0d0) — The parameter \(\alpha_0\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[logSFR1](default0.0d0) — The parameter \(\alpha_1\) appearing in the star formation rate threshold expression for the star formation rate galactic filter class.[cW](default3.78062835d0) — The parameter \(c_\mathrm{W}\) in the Bohr et al. (2021) power spectrum window function.[beta](default3.4638743d0) — The parameter \(\beta\) in the Bohr et al. (2021) power spectrum window function.[transferFunctionType](defaultvar_str('darkMatter')) — Specifies whether to use thedarkMatterortotaltransfer function.[fileName]— The name of the file from which to read a tabulated transfer function.[redshift](default0.0d0) — The redshift of the transfer function to read.[factorWavenumberSmoothExtrapolation](default0.0d0) — If positive, and extrapolation is used at high wavenumbers, the slope for extrapolation will be set by averaging over wavenumbers from \(k_\mathrm{max}/f\) to \(k_\mathrm{max}\), where \(f=\)[factorWavenumberSmoothExtrapolation]and \(k_\mathrm{max}\) is the highest wavenumber tabulated. This avoids spurious extrapolation for highly oscillatory transfer functions.[acceptNegativeValues](default.false.) — If true, negative values in the transfer function are allowed (and the absolute value is taken prior to interpolation). Otherwise, negative values result in an error.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[fileName](defaultvar_str('none')) — The name of the file to/from which tabulations of barrier first crossing probabilities should be written/read. If set to “none” tables will not be stored.[fractionalTimeStep](default0.01d0) — The fractional time step used when computing barrier crossing rates (i.e. the step used in finite difference calculations).[varianceNumberPerUnitProbability](default1000) — The number of points to tabulate per unit variance for first crossing probabilities.[varianceNumberPerUnit](default40) — The number of tabulation points per unit of \(\sigma^2\) used when building the rate look-up table for the Farahi excursion-set first-crossing distribution; higher values improve interpolation accuracy at the cost of memory and initialization time.[varianceNumberPerDecade](default400) — The number of points to tabulate per decade of progenitor variance for first crossing rates.[varianceNumberPerDecadeNonCrossing](default40) — The number of points to tabulate per decade of progenitor variance for non-crossing rates.[timeNumberPerDecade](default10) — The number of tabulation points per decade of cosmic time used when building the first-crossing rate look-up table as a function of time; higher values improve temporal interpolation accuracy for rapidly evolving cosmologies.[varianceIsUnlimited](default.false.) — If true, the variance is assumed to have no upper limit (e.g. as in the case of CDM). This allows the tabulated solutions to be extended arbitrarily. Otherwise, tables are extended to encompass just the range of variance requested.[linkingLength](default0.2d0) — The friends-of-friends linking length to use in computing virial density contrasts with the percolation analysis of More et al. (2011).
darkMatterProfileDMOTruncatedExponential¶
Exponentially truncated dark matter halo profiles Kazantzidis et al. (2006) are constructed via the massDistributionSphericalTruncatedExponential mass distribution class.
Parameters
[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available. If set to “fallThrough” then the solution ignoring heating is used, while if set to “numerical” then numerical solvers are used to find solutions.[radiusFractionalDecay](default1.0d0) — The truncation scale radius expressed as a fraction of the virial radius; the exponentially truncated dark matter profile decays as \(\exp(-r/r_\mathrm{trunc})\) for \(r > r_\mathrm{trunc} =\)[radiusFractionalDecay]\(\times r_\mathrm{virial}\), suppressing the profile at large radii.[variogramFitOption](defaultvar_str('median')) — Option controlling how the binned semi-variance data are aggregated before fitting the exponential variogram model; allowed values aremean,median(default), ormaximumof the residuals within each separation bin.[assumeZeroVarianceAtZeroLag](default.false.) — If true, the variogram model is forced to go to zero for states with zero separation (as expected if the likelihood model being emulated is fully deterministic). Otherwise, the variance at zero separation is treated as a free parameter.[radiusTruncateMinimum]— The minimum radius to begin truncating the density profile.[radiusTruncateDecay]— The exponential decay scale for truncating the density profile.[nonAnalyticSolver](defaultvar_str('fallThrough')) — Selects how solutions are computed when no analytic solution is available.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.
darkMatterProfileDMOZhao1996¶
A dark matter profile DMO class which builds massDistributionZhao1996 objects.
Methods
timeFreefallTabulate— Tabulate the freefall time as a function of radius in a scale-free Zhao1996 mass distribution.
Parameters
[alpha]— The parameter \(\alpha\) of the Zhao (1996) dark matter density profile.[beta]— The parameter \(\beta\) of the Zhao (1996) dark matter density profile.[gamma]— The parameter \(\gamma\) of the Zhao (1996) dark matter density profile.[alpha]— The parameter \(\alpha\) of the Zhao1996 profile.[beta]— The parameter \(\beta\) of the Zhao1996 profile.[gamma]— The parameter \(\gamma\) of the Zhao1996 profile.[densityNormalization](default(3.0d0-gamma)/4.0d0/Pi/Hypergeometric_2F1([(3.0d0-gamma)/alpha,(beta-gamma)/alpha],[1.0d0+(3.0d0-gamma)/alpha],-1.0d0)) — The density normalization of the Zhao1996 profile.[scaleLength](default1.0d0) — The scale radius of the Zhao1996 profile.[mass](default1.0d0) — The total mass (in \(\mathrm{M}_\odot\)) of the Zhao (1996) profile, used to set the density normalization \(\rho_0\) whendensityNormalizationis not supplied directly.[radiusOuter]— The outer radius of the Zhao1996 profile.[dimensionless](default.true.) — If true the Zhao1996 profile is considered to be dimensionless.[componentType](defaultvar_str('unknown')) — The component type that this mass distribution represents.[massType](defaultvar_str('unknown')) — The mass type that this mass distribution represents.