popsynth.populations package

Submodules

popsynth.populations.bpl_population module

class popsynth.populations.bpl_population.BPLHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.bpl_population.BPLZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.bpl_population.BPLZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in Gpc^-3

  • delta (float) – Index of spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.bpl_population.BPLSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

popsynth.populations.lognormal_population module

class popsynth.populations.lognormal_population.LogNormalHomogeneousSphericalPopulation(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.lognormal_population.LogNormalZPowerSphericalPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.lognormal_population.LogNormalZPowerCosmoPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.lognormal_population.LogNormalSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.lognormal_population.Log10NormalHomogeneousSphericalPopulation(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.lognormal_population.Log10NormalZPowerSphericalPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.lognormal_population.Log10NormalZPowerCosmoPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: float = 1234, is_rate: float = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: float = 1234, is_rate: float = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.lognormal_population.Log10NormalSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

popsynth.populations.pareto_populations module

class popsynth.populations.pareto_populations.ParetoHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.pareto_populations.ParetoZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.pareto_populations.ParetoZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.pareto_populations.ParetoSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

popsynth.populations.schechter_populations module

class popsynth.populations.schechter_populations.SchechterHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.schechter_populations.SchechterZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.schechter_populations.SchechterZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.schechter_populations.SchechterSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

popsynth.populations.spatial_populations module

class popsynth.populations.spatial_populations.SphericalPopulation(Lambda: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

Bases: PopulationSynth

__init__(Lambda: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

A generic spherical population based on ConstantSphericalDistribution.

Parameters
  • Lambda (float) – Density per unit volume

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

class popsynth.populations.spatial_populations.ZPowerSphericalPopulation(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

Bases: PopulationSynth

__init__(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

A spherical population with a density that scales as (r+1)^delta. Based on ZpowerSphericalDistribution.

Parameters
  • Lambda (float) – Local density per unit volume

  • delta (float) – Index of spatial distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

class popsynth.populations.spatial_populations.ZPowerCosmoPopulation(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

Bases: PopulationSynth

__init__(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

A cosmological population with a density that scales as (z+1)^delta. Based on ZpowerCosmoDistribution.

Parameters
  • Lambda (float) – Local density in units of Gpc^-3

  • delta (float) – Index of spatial distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.spatial_populations.SFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, r_max: float = 5, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

Bases: PopulationSynth

__init__(r0: float, a: float, rise: float, decay: float, peak: float, r_max: float = 5, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

A cosmological population with a density that scales similarly to the star formation rate. Based on ZpowerCosmoDistribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.spatial_populations.MWRadialPopulation(rho: float, a: float = 1.64, b: float = 4.01, R1: float = 0.55, R0: float = 8.5, r_max: float = 20, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

Bases: PopulationSynth

__init__(rho: float, a: float = 1.64, b: float = 4.01, R1: float = 0.55, R0: float = 8.5, r_max: float = 20, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

A Milky-way like population based on SpiralGalaxyDistribution.

Parameters
  • rho (float) – Local density

  • a (float) – Shape parameter

  • b (float) – Shape parameter

  • R1 (float) – Scale parameter

  • R0 (float) – Scale parameter

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

Module contents

class popsynth.populations.SphericalPopulation(Lambda: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

Bases: PopulationSynth

__init__(Lambda: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

A generic spherical population based on ConstantSphericalDistribution.

Parameters
  • Lambda (float) – Density per unit volume

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

class popsynth.populations.SFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, r_max: float = 5, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

Bases: PopulationSynth

__init__(r0: float, a: float, rise: float, decay: float, peak: float, r_max: float = 5, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

A cosmological population with a density that scales similarly to the star formation rate. Based on ZpowerCosmoDistribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.ZPowerSphericalPopulation(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

Bases: PopulationSynth

__init__(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None)[source]

A spherical population with a density that scales as (r+1)^delta. Based on ZpowerSphericalDistribution.

Parameters
  • Lambda (float) – Local density per unit volume

  • delta (float) – Index of spatial distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

class popsynth.populations.ZPowerCosmoPopulation(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

Bases: PopulationSynth

__init__(Lambda: float, delta: float, r_max: float = 5.0, seed: int = 1234, luminosity_distribution: Optional[LuminosityDistribution] = None, is_rate: bool = True)[source]

A cosmological population with a density that scales as (z+1)^delta. Based on ZpowerCosmoDistribution.

Parameters
  • Lambda (float) – Local density in units of Gpc^-3

  • delta (float) – Index of spatial distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • luminosity_distribution (LuminosityDistribution, optional) – Luminosity distribution

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.ParetoHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.ParetoSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.ParetoZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.ParetoZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the ParetoDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.BPLHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.BPLSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

class popsynth.populations.BPLZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.BPLZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, Lbreak: float, beta: float, Lmax: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the BPLDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in Gpc^-3

  • delta (float) – Index of spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Lower luminosity index

  • Lbreak (float) – Break luminosity

  • beta (float) – Upper luminosity index

  • Lmax (float) – Maximum value of the luminosity

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.SchechterHomogeneousSphericalPopulation(Lambda: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.SchechterSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.SchechterZPowerSphericalPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.SchechterZPowerCosmoPopulation(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, Lmin: float, alpha: float, r_max: float = 10, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the SchechterDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • Lmin (float) – Minimum value of the luminosity

  • alpha (float) – Index of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.Log10NormalHomogeneousSphericalPopulation(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.Log10NormalSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.Log10NormalZPowerSphericalPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.Log10NormalZPowerCosmoPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: float = 1234, is_rate: float = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: float = 1234, is_rate: float = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the Log10NormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.LogNormalHomogeneousSphericalPopulation(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: SphericalPopulation

__init__(Lambda: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ConstantSphericalDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.LogNormalSFRPopulation(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: SFRPopulation

__init__(r0: float, a: float, rise: float, decay: float, peak: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the SFRDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • r0 (float) – Local density in units of Gpc^-3

  • a (float) – Offset at z=0

  • rise (float) – Rise at low z

  • decay (float) – Decay at high z

  • peak (float) – Peak of z distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.

class popsynth.populations.LogNormalZPowerSphericalPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

Bases: ZPowerSphericalPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234)[source]

A population built on the ZPowerSphericalDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density per unit volume

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum distance

  • seed (int) – Random seed

class popsynth.populations.LogNormalZPowerCosmoPopulation(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

Bases: ZPowerCosmoPopulation

__init__(Lambda: float, delta: float, mu: float, tau: float, r_max: float = 5, seed: int = 1234, is_rate: bool = True)[source]

A population built on the ZPowerCosmoDistribution spatial distribution and the LogNormalDistribution luminosity distribution.

Parameters
  • Lambda (float) – Density in units of Gpc^-3

  • delta (float) – Index of the spatial distribution

  • mu (float) – Mean of the luminosity distribution

  • tau (float) – Standard deviation of the luminosity distribution

  • r_max (float) – Maximum redshift

  • seed (int) – Random seed

  • is_rate (bool) – True if modelling a population of transient events, False if modelling a population of steady-state objects. Affects the time_adjustment method used in cosmo calculations. Default is True.