LALConstants.h

Go to the documentation of this file.

/*
*  Copyright (C) 2007 Jolien Creighton
*
*  This program is free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  This program is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with with program; see the file COPYING. If not, write to the
*  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
*  MA  02110-1301  USA
*/
 
/**
 * @defgroup LALConstants_h Header LALConstants.h
 * @ingroup lal_std
 * @author Creighton, T. D.
 * @brief Provides standard numerical constants for LAL.
 *
 * This header defines a number of useful numerical constants
 * for use in LAL routines.  These constants come in three basic
 * flavours: arithmetic and mathematical constants, fundamental (or
 * defined) physical constants, and measured astrophysical and
 * cosmological parameters.
 *
 * Note that this header is not included automatically by the header
 * <tt>LALStdlib.h</tt>.  Include it explicitly if you need any of these
 * constants.
 *//** @{ */
 
/** @{ */
#ifndef _LALCONSTANTS_H
#define _LALCONSTANTS_H
 
#ifdef  __cplusplus
extern "C" {
#endif
 
/**
 * @name Floating-point constants
 * The following constants define the precision and range of
 * floating-point arithmetic in LAL.  They are taken from the IEEE
 * standard 754 for binary arithmetic.  All numbers are dimensionless.
 * @see http://dx.doi.org/10.1109/IEEESTD.2008.4610935
 */
/** @{ */
#if __STDC_VERSION__ >= 199901L
#define LAL_REAL4_MANT 24 /**< Bits of precision in the mantissa of a REAL4 */
#define LAL_REAL4_MAX 0x1.fffffe0000000p+127 /**< Largest normalized REAL4 number (2-2^-23)*2^127 */
#define LAL_REAL4_MIN 0x1.0000000000000p-126 /**< Smallest normalized REAL4 number 2^-126 */
#define LAL_REAL4_EPS 0x1.0000000000000p-23 /**< Difference between 1 and the next resolvable REAL4 2^-23 */
#define LAL_REAL8_MANT 53 /**< Bits of precision in the mantissa of a REAL8 */
#define LAL_REAL8_MAX 0x1.fffffffffffffp+1023 /**< Largest normalized REAL8 number (2-2^-52)*2^1023 */
#define LAL_REAL8_MIN 0x1.0000000000000p-1022 /**< Smallest normalized REAL8 number 2^-1022 */
#define LAL_REAL8_EPS 0x1.0000000000000p-52 /**< Difference between 1 and the next resolvable REAL8 2^-52 */
#else
#define LAL_REAL4_MANT 24
#define LAL_REAL4_MAX 3.4028234663852886e+38
#define LAL_REAL4_MIN 1.1754943508222875e-38
#define LAL_REAL4_EPS 1.1920928955078125e-07
#define LAL_REAL8_MANT 53
#define LAL_REAL8_MAX 1.797693134862315708145274237317043568e308
#define LAL_REAL8_MIN 2.225073858507201383090232717332404064e-308
#define LAL_REAL8_EPS 2.220446049250313080847263336181640625e-16
#endif
/** @} */
 
/**
 * @name Integer constants
 * Extremal integer values, all expressed as unsigned long long.
 */
/** @{ */
#define LAL_UINT8_MAX   LAL_UINT8_C(18446744073709551615)
#define LAL_UINT4_MAX   LAL_UINT8_C(4294967295)
#define LAL_UINT2_MAX   LAL_UINT8_C(65535)
#define LAL_INT8_MAX    LAL_UINT8_C(9223372036854775807)
#define LAL_INT4_MAX    LAL_UINT8_C(2147483647)
#define LAL_INT2_MAX    LAL_UINT8_C(32767)
/** @} */
 
/**
 * @name Mathematical constants
 * All are dimensionless.
 *
 * @def LAL_E
 * @brief Euler's constant, e
 * @see https://oeis.org/A001113
 *
 * @def LAL_LOG2E
 * @brief base-2 logarithm of e, log_2(e)
 * @see http://oeis.org/A007525
 *
 * @def LAL_LOG10E
 * @brief common logarithm of e, log_10(e)
 * @see http://oeis.org/A002285
 *
 * @def LAL_LN2
 * @brief natural log of 2, ln(2)
 * @see http://oeis.org/A002162
 *
 * @def LAL_LN10
 * @brief natural log of 10, ln(10)
 * @see http://oeis.org/A002392
 *
 * @def LAL_SQRT2
 * @brief Pythagoras's constant, sqrt(2)
 * @see https://oeis.org/A002193
 *
 * @def LAL_SQRT1_2
 * @brief 1/sqrt(2)
 * @see https://oeis.org/A010503
 *
 * @def LAL_GAMMA
 * @brief Euler-Mascheroni constant, gamma
 * @see https://oeis.org/A001620
 *
 * @def LAL_EXPGAMMA
 * @brief exp(gamma)
 * @see https://oeis.org/A073004
 *
 * @def LAL_PI
 * @brief Archimedes's constant, pi
 * @see https://oeis.org/A000796
 *
 * @def LAL_TWOPI
 * @brief 2*pi is circumference of a circle divided by its radius
 * @see https://oeis.org/A019692
 *
 * @def LAL_PI_2
 * @brief pi/2
 * @see http://oeis.org/A019669
 *
 * @def LAL_PI_4
 * @brief pi/4 is the least positive solution to sin(x) = cos(x)
 * @see http://oeis.org/A003881
 *
 * @def LAL_1_PI
 * @brief 1/pi is the ratio of the volume of a regular octahedron
 * to the volume of the circumscribed sphere
 * @see http://oeis.org/A049541
 *
 * @def LAL_2_PI
 * @brief 2/pi is Buffon's constant
 * @see http://oeis.org/A060294
 *
 * @def LAL_2_SQRTPI
 * @brief 2/sqrt(pi)
 * @see http://oeis.org/A190732
 *
 * @def LAL_PI_180
 * @brief 180/pi is the number of degrees in one radian
 * @see http://oeis.org/A072097
 *
 * @def LAL_180_PI
 * @brief pi/180 is the number of radians in one degree
 * @see http://oeis.org/A019685
 *
 * @def LAL_LNPI
 * @brief natural log of pi, ln(pi)
 * @see http://oeis.org/A053510
 */
/** @{ */
#define LAL_E 2.718281828459045235360287471352662498
#define LAL_LOG2E 1.442695040888963407359924681001892137
#define LAL_LOG10E 0.434294481903251827651128918916605082
#define LAL_LN2 0.693147180559945309417232121458176568
#define LAL_LN10 2.302585092994045684017991454684364208
#define LAL_SQRT2 1.414213562373095048801688724209698079
#define LAL_SQRT1_2 0.707106781186547524400844362104849039
#define LAL_GAMMA 0.577215664901532860606512090082402431
#define LAL_EXPGAMMA 1.781072417990197985236504103107179549
/* Assuming we're not near a black hole or in Tennessee... */
#define LAL_PI 3.141592653589793238462643383279502884
#define LAL_TWOPI 6.283185307179586476925286766559005768
#define LAL_PI_2 1.570796326794896619231321691639751442
#define LAL_PI_4 0.785398163397448309615660845819875721
#define LAL_1_PI 0.318309886183790671537767526745028724
#define LAL_2_PI 0.636619772367581343075535053490057448
#define LAL_2_SQRTPI 1.128379167095512573896158903121545172
#define LAL_PI_180 1.745329251994329576923690768488612713e-2
#define LAL_180_PI 57.295779513082320876798154814105170332
#define LAL_LNPI 1.144729885849400174143427351353058712
/** @} */
 
/**
 * @name Exact physical constants
 * The following physical constants are defined to have exact values.
 * The dimensions in SI units are as shown.
 * @see 2018 CODATA adjustment: http://physics.nist.gov/constants
 */
/** @{ */
#define LAL_C_SI 299792458e0 /**< Speed of light in vacuum, m s^-1 */
#define LAL_H_SI 6.62607015e-34 /**< Planck constant, J s */
#define LAL_QE_SI 1.602176634e-19 /**< Electron charge, C */
#define LAL_MOL 6.02214076e+23 /**< Avogadro constant, dimensionless */
#define LAL_K_SI 1.380649e-23 /**< Boltzmann constant, J K^-1 */
#define LAL_GEARTH_SI 9.80665 /**< Standard gravity, m s^-2 */
#define LAL_PATM_SI 101325e0 /**< Standard atmosphere, Pa */
 
/**
 * @brief Reduced Planck constant, J s
 * @details
 * LAL_HBAR_SI = LAL_H_SI / (2 * LAL_PI)
 */
#define LAL_HBAR_SI 1.054571817646156391262428003302280745e-34
 
/**
 * @brief  Molar gas constant, J mol^-1 K^-1
 * @details
 * LAL_R_SI = LAL_MOL * LAL_K_SI
 */
#define LAL_R_SI 8.31446261815324
 
/**
 * @brief Stefan-Boltzmann constant, W m^-2 K^-4
 * @details
 * LAL_SIGMA_SI = ((LAL_PI * LAL_PI * LAL_K_SI * LAL_K_SI * LAL_K_SI * LAL_K_SI) / (60 * LAL_HBAR_SI * LAL_HBAR_SI * LAL_HBAR_SI * LAL_C_SI * LAL_C_SI))
 */
#define LAL_SIGMA_SI 5.670374419184429453970996731889230876e-8
 
/**
 * @brief Second radiation constant, m K
 * @details
 * LAL_C2RAD_SI = (LAL_H_SI * LAL_C_SI / LAL_K_SI)
 */
#define LAL_C2RAD_SI 1.438776877503933802146671601543911595e-2
 
/**
 * @brief Wien displacement law constant, m K
 * @details
 * LAL_BWIEN_SI = (LAL_C2RAD_SI / X)
 *
 * where the factor X satisfies
 *
 * X * exp(X) = 5 * (exp(X) - 1)
 */
#define LAL_BWIEN_SI 2.897771955185172661478605448092884727e-3
/** @} */
 
/**
 * @name Primary physical constants
 * These physical constants are given to the precision
 * to which they are known.  Other physical constants
 * derived from these are given in the next section.
 * @see 2018 CODATA adjustment: http://physics.nist.gov/constants
 */
/** @{ */
#define LAL_ALPHA 0.0072973525693 /**< Fine structure constant, dimensionless */
#define LAL_RYD_SI 10973731.568160 /**< Rydberg constant, m^-1 */
#define LAL_MP_ME 1836.15267343 /**< Proton-electron mass ratio, dimensionless */
#define LAL_ME_AMU 0.000548579909065 /**< Electron mass, atomic mass units */
#define LAL_G_SI 6.67430e-11 /**< Gravitational constant, N m^2 kg^-2 */
/** @} */
 
/**
 * @name Derived physical constants
 * The following constants are derived from the primary
 * physical constants.  When not dimensionless, they are
 * given in the SI units shown.  Precision beyond the
 * accuracy is retained for these constants in order
 * that equivalent combinations yield the same value.
 */
/** @{ */
 
/**
 * @brief Permeability of free space, N A^-2
 * @details
 * LAL_MU0_SI = 4 * LAL_PI * LAL_ALPHA * LAL_HBAR_SI / (LAL_QE_SI * LAL_QE_SI * LAL_C_SI)
 */
#define LAL_MU0_SI 1.256637062123837330602573817851770477e-6
 
/**
 * @brief Permittivity of free space, C^2 N^-1 m^-2
 * @details
 * LAL_EPSILON0_SI = 1 / (LAL_MU0_SI * LAL_C_SI * LAL_C_SI)
 */
#define LAL_EPSILON0_SI 8.854187812773347391812964575762341677e-12
 
/**
 * @brief Planck mass, kg
 * @details
 * LAL_MPL_SI = sqrt(LAL_HBAR_SI * LAL_C_SI / LAL_G_SI)
 */
#define LAL_MPL_SI 2.176434342717898213927914919024147041e-8
 
/**
 * @brief Planck length, m
 * @details
 * LAL_LPL_SI = (LAL_HBAR_SI / (LAL_MPL_SI * LAL_C_SI))
 */
#define LAL_LPL_SI 1.616255024423705286500047697249314157e-35
 
/**
 * @brief Planck time, s
 * @details
 * LAL_TPL_SI = (LAL_LPL_SI / LAL_C_SI)
 */
#define LAL_TPL_SI 5.391246448313603961644851309932934193e-44
 
/**
 * @brief Planck luminosity, J s^-1
 * @details
 * LAL_LUMPL_SI = (LAL_C_SI * LAL_C_SI * LAL_C_SI * LAL_C_SI * LAL_C_SI) / (LAL_G_SI)
 */
#define LAL_LUMPL_SI 3.628254904411280064474144638555430509e52
 
/**
 * @brief Proton mass, atomic mass units
 * @details
 * LAL_MP_AMU = (LAL_ME_AMU * LAL_MP_ME)
 */
#define LAL_MP_AMU 1.00727646661968604164295
 
/**
 * @brief Electron mass, kg
 * @details
 * LAL_ME_SI = ((2 * LAL_RYD_SI * LAL_H_SI) / (LAL_C_SI * LAL_ALPHA * LAL_ALPHA))
 */
#define LAL_ME_SI 9.109383701517728819842163772087735080e-31
 
/**
 * @brief Proton mass, kg
 * @details
 * LAL_MP_SI = (LAL_ME_SI * LAL_MP_ME)
 */
#define LAL_MP_SI 1.672621923684144692109494784075478798e-27
 
/**
 * @brief Atomic mass unit, kg
 * @details
 * LAL_AMU_SI = (LAL_ME_SI / LAL_ME_AMU)
 */
#define LAL_AMU_SI 1.660539066595378801332508797951914123e-27
 
/**
 * @brief Bohr radius, m
 * @details
 * LAL_AB_SI = (LAL_ALPHA / (4 * LAL_PI * LAL_RYD_SI))
 */
#define LAL_AB_SI 5.291772109034624983506063293620795401e-11
 
/**
 * @brief Electron Compton wavelength, m
 * @details
 * LAL_LAMBDAE_SI = (2 * LAL_PI * LAL_ALPHA * LAL_AB_SI)
 */
#define LAL_LAMBDAE_SI 2.426310238678370231942278247906312873e-12
 
/**
 * @brief Classical electron radius, m
 * @details
 * LAL_RE_SI = (LAL_ALPHA * LAL_ALPHA * LAL_AB_SI)
 */
#define LAL_RE_SI 2.817940326207927528347087481623789683e-15
 
/**
 * @brief Bohr magneton, J T^-1
 * @details
 * LAL_MUB_SI = (LAL_LAMBDAE_SI * LAL_C_SI * LAL_QE_SI / (4 * LAL_PI))
 */
#define LAL_MUB_SI 9.274010078344114556082608495144137435e-24
 
/**
 * @brief Nuclear magneton, J T^-1
 * @details
 * LAL_MUN_SI = (LAL_MUB_SI / LAL_MP_ME)
 */
#define LAL_MUN_SI 5.050783746114056140501321131006282803e-27
/** @} */
 
/**
 * @name Exact astrophysical parameters
 * The following astrophysical constants are defined to have exact values.
 * The dimensions in SI units are as shown.
 * @see http://asa.hmnao.com/SecK/Constants.html
 * @see https://doi.org/10.3847/0004-6256/152/2/41
 */
/** @{ */
#define LAL_ROT_DAY 1.00273781191135448 /**< Number of Earth rotations in one UT1 day, dimensionless */
#define LAL_DAYJUL_SI 86400e0 /**< Julian day, s */
#define LAL_YRJUL_SI 31557600e0 /**< Julian year, s */
#define LAL_LYR_SI 9460730472580800e0 /**< (Julian) Lightyear, m */
#define LAL_AU_SI 149597870700e0 /**< Astronomical unit, m */
#define LAL_PC_SI 3.085677581491367278913937957796471611e16 /**< Parsec, m */
#define LAL_GMEARTH_SI 3.986004e+14 /**< Nominal Earth mass parameter, m^3 s^-2 */
#define LAL_REEARTH_SI 6.3781e+6 /**< Nominal Earth equatorial radius, m */
#define LAL_RPEARTH_SI 6.3568e+6 /**< Nominal Earth polar radius, m */
#define LAL_GMJUP_SI 1.2668653e+17 /**< Nominal Jupiter mass parameter, m^3 s^-2 */
#define LAL_REJUP_SI 7.1492e+7 /**< Nominal Jupiter equatorial radius, m */
#define LAL_RPJUP_SI 6.6854e+7 /**< Nominal Jupiter polar radius, m */
#define LAL_GMSUN_SI 1.3271244e+20 /**< Nominal solar mass parameter, m^3 s^-2 */
#define LAL_RSUN_SI 6.957e+8 /**< Nominal solar radius, m */
#define LAL_SSUN_SI 1361e0 /**< Nominal total solar irradiance, W m^-2 */
#define LAL_LSUN_SI 3.828e+26 /**< Nominal solar luminosity, W */
#define LAL_TSUN_SI 5772e0 /**< Nominal solar effective temperature, K */
/** @} */
 
/**
 * @name Primary astrophysical parameters
 * These astrophysical constants are given to the precision
 * to which they are known.  Other physical constants
 * derived from these are given in the next section.
 */
/** @{ */
 
/**
 * @brief Earth equatorial radius, m
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_REARTH_SI 6378136.6
 
/**
 * @brief Semimajor axis of WGS-84 Reference Ellipsoid, m
 * @see Department of Defense World Geodedic System 1984 http://earth-info.nga.mil/GandG/publications/tr8350.2/wgs84fin.pdf
 */
#define LAL_AWGS84_SI 6378137e0
 
/**
 * @brief Semiminor axis of WGS-84 Reference Ellipsoid, m
 * @details
 * LAL_BWGS84_SI = LAL_AWGS84_SI * (1 - f)
 *
 * where f is the flattening
 *
 * 1/f = 298.257223563
 *
 * @note This constant is not given to full precision for compatibility.
 * @see Department of Defense World Geodedic System 1984 http://earth-info.nga.mil/GandG/publications/tr8350.2/wgs84fin.pdf
 */
#define LAL_BWGS84_SI 6356752.314
 
/**
 * @brief Earth inclination (2000), radians
 * @details
 * This is the measured value of the mean obliquity of the
 * ecliptic, 84381.406 arcseconds, converted to radians.
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_IEARTH 0.409092600600582871467239393761915655
 
/**
 * @brief Earth orbital eccentricity, dimensionless
 * @see E. Myles Standish and James G. Williams, Orbital Ephemerides of the Sun, Moon, and Planets ftp://ssd.jpl.nasa.gov/pub/eph/planets/ioms/ExplSupplChap8.pdf
 */
#define LAL_EEARTH 0.0167
 
/**
 * @brief Rate of Earth precession (2000), Hz
 * @details
 * This is the rate of precession of the Earth,
 * 4612.156534 arcseconds per Julian century,
 * converted to cycles per second, at the epoch J2000.0
 * (=2000-01-01T12:00:00Z):
 *
 * LAL_EPREC_SI = 4612.156534 / 36525 / 15 / 86400 / LAL_DAYJUL_SI
 *
 * @see Linear (in t) term in Eq. (42) of
 * N. Capitaine, P. T. Wallace and J. Chapront
 * "Expressions for IAU 2000 precession quantities",
 * Astronomy & Astrophysics 412 567 (2003)
 * https://doi.org/10.1051/0004-6361:20031539
 */
#define LAL_EPREC_SI 1.127703867758020059420250393792953007e-12
 
/**
 * @brief Earth mass parameter, m^3 s^-2 (TCB)
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_GMEARTH_TCB_SI 3.986004418e+14
 
/**
 * @brief Earth mass parameter, m^3 s^-2 (TDB)
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_GMEARTH_TDB_SI 3.986004356e+14
 
/**
 * @brief Earth mass parameter, m^3 s^-2 (TT)
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_GMEARTH_TT_SI 3.986004415e+14
 
/**
 * @brief Solar mass parameter, m^3 s^-2 (TCB)
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_GMSUN_TCB_SI 1.32712442099e+20
 
/**
 * @brief Solar mass parameter, m^3 s^-2 (TDB)
 * @see http://asa.hmnao.com/SecK/Constants.html
 */
#define LAL_GMSUN_TDB_SI 1.32712440041e+20
 
/**
 * @brief Tropical year (2000), s
 * @see Borkowski, K. M., The Tropical Year and Solar Calendar, Journal of the Royal Astronomical Society of Canada, Vol. 85, NO. 3/JUN, P.121, 1991 http://articles.adsabs.harvard.edu/cgi-bin/nph-iarticle_query?1991JRASC..85..121B&data_type=PDF_HIGH&whole_paper=YES&type=PRINTER&filetype=.pdf
 */
#define LAL_YRTROP_SI 31556925.1874707200
 
/**
 * @brief Sidereal year (2000), s
 * @see http://hpiers.obspm.fr/eop-pc/models/constants.html
 */
#define LAL_YRSID_SI 31558149.763545600
/** @} */
 
/**
 * @name Derived astrophysical parameters
 * The following constants are derived from the primary
 * astrophysical constants.  When not dimensionless, they are
 * given in the SI units shown.  Precision beyond the
 * accuracy is retained for these constants in order
 * that equivalent combinations yield the same value.
 */
/** @{ */
 
/**
 * @brief Cosine of Earth inclination (2000)
 * @details
 * LAL_COSIEARTH = cos(LAL_IEARTH)
 */
#define LAL_COSIEARTH 0.917482143065241841533315838574859003
 
/**
 * @brief Sine of Earth inclination (2000)
 * @details
 * LAL_SINIEARTH = sin(LAL_IEARTH)
 */
#define LAL_SINIEARTH 0.397776969112605992551264763661918798
 
/**
 * @brief Nominal Earth mass, kg
 * @details
 * LAL_MEARTH_SI = LAL_GMEARTH_SI / LAL_G_SI
 */
#define LAL_MEARTH_SI 5.972167867791378871192484605127129437e24
 
/**
 * @brief Earth mass, kg (TCB)
 * @details
 * LAL_MEARTH_TCB_SI = LAL_GMEARTH_TCB_SI / LAL_G_SI
 */
#define LAL_MEARTH_TCB_SI 5.972168494074284943739418365970963247e24
 
/**
 * @brief Earth mass, kg (TDB)
 * @details
 * LAL_MEARTH_TDB_SI = LAL_GMEARTH_TDB_SI / LAL_G_SI
 */
#define LAL_MEARTH_TDB_SI 5.972168401180648157859251157424748663e24
 
/**
 * @brief Earth mass, kg (TT)
 * @details
 * LAL_MEARTH_TT_SI = LAL_GMEARTH_TT_SI / LAL_G_SI
 */
#define LAL_MEARTH_TT_SI 5.972168489579431550874248984912275445e24
 
/**
 * @brief Nominal Jupiter mass, kg
 * @details
 * LAL_MJUP_SI = LAL_GMJUP_SI / LAL_G_SI
 */
#define LAL_MJUP_SI 1.898124597336050222495242946825884362e27
 
/**
 * @brief Nominal solar mass, kg
 * @details
 * LAL_MSUN_SI = LAL_GMSUN_SI / LAL_G_SI
 */
#define LAL_MSUN_SI 1.988409870698050731911960804878414216e30
 
/**
 * @brief Geometrized nominal solar mass, m
 * @details
 * LAL_MRSUN_SI = LAL_GMSUN_SI / (LAL_C_SI * LAL_C_SI)
 */
#define LAL_MRSUN_SI 1.476625038050124729627979840144936351e3
 
/**
 * @brief Geometrized nominal solar mass, s
 * @details
 * LAL_MTSUN_SI = LAL_GMSUN_SI / (LAL_C_SI * LAL_C_SI * LAL_C_SI)
 */
#define LAL_MTSUN_SI 4.925490947641266978197229498498379006e-6
 
/**
 * @brief Solar mass, kg (TCB)
 * @details
 * LAL_MSUN_TCB_SI = LAL_GMSUN_TCB_SI / LAL_G_SI
 */
#define LAL_MSUN_TCB_SI 1.988409902147041637325262574352366540e30
 
/**
 * @brief Solar mass, kg (TDB)
 * @details
 * LAL_MSUN_TDB_SI = LAL_GMSUN_TDB_SI / LAL_G_SI
 */
#define LAL_MSUN_TDB_SI 1.988409871312347362270200620289768215e30
 
/**
 * @brief Ratio of mean solar day to sidereal day, dimensionless
 * @details
 * This quantity is evaluated at the epoch J2000.0 (=2000-01-01T12:00:00Z) as:
 *
 * LAL_SOL_SID = LAL_ROT_DAY + LAL_DAYJUL_SI * LAL_EPREC_SI
 */
#define LAL_SOL_SID 1.002737909344968654292933133909634024
 
/**
 * @brief Mean sidereal day, s
 * @details
 * This quantity is evaluated at the epoch J2000.0 (=2000-01-01T12:00:00Z) as:
 *
 * LAL_DAYSID_SI = LAL_DAYJUL_SI / LAL_SOL_SID
 */
#define LAL_DAYSID_SI 86164.090531333536768710524462700317733190
/** @} */
 
/**
 * @name Cosmological parameters
 * The following cosmological parameters are derived from measurements of
 * the Hubble expansion rate and of the cosmic microwave background radiation.
 * In what follows, the dimensionless Hubble constant \f$h_0\f$ is equal to the
 * actual Hubble constant \f$H_0\f$ divided by
 * \f$\langle H \rangle=100\,\mathrm{km}\,\mathrm{s}^{-1}\mathrm{Mpc}^{-1}\f$.
 * Thus the Hubble constant can be written as:
 * \f$H_0 = \langle H \rangle h_0\f$.  Similarly, the critical energy density
 * \f$\rho_c\f$ required for spatial flatness is given by:
 * \f$\rho_c = \langle\rho\rangle h_0^2\f$.
 *
 * The current default cosmology is the 2015 Planck TT+lowP+lensing+ext
 * Flat LambdaCDM cosmology with Hubble constant
 * \f$H_0 = 67.90\,\mathrm{km}\,\mathrm{s}^{-1}\mathrm{Mpc}^{-1}\f$
 * and matter density parameter
 * \f$\Omega_{\mathrm{m}} = 0.3065\f$
 * which is what is assumed below.
 * All values are in the SI units shown.
 * @see Table 4, column TT+lowP+lensing+ext of http://doi.org/10.1051/0004-6361/201525830
 */
/** @{ */
#define LAL_H0_DIMENSIONLESS 0.679 /**< Default dimensionless Hubble constant, dimensionless */
#define LAL_OMEGA_M 0.3065 /**< Default dimensionless Hubble constant, dimensionless */
 
/**
 * @brief Hubble constant prefactor, s^-1
 * @details
 * LAL_H0FAC_SI = 100 km s^-1 Mpc^-1
 */
#define LAL_H0FAC_SI 3.240779289444365023237687716352957261e-18
 
/**
 * @brief Default Hubble constant, s^-1
 * @details
 * LAL_H0_SI = LAL_H0_DIMENSIONLESS * LAL_H0FAC_SI
 */
#define LAL_H0_SI (LAL_H0_DIMENSIONLESS * LAL_H0FAC_SI)
 
/**
 * @brief Critical energy density prefactor, J m^-3
 * @details
 * LAL_RHOCFAC_SI = 3 * (LAL_H0FAC_SI * LAL_C_SI)^2 / (8 * LAL_PI * LAL_G_SI)
 */
#define LAL_RHOCFAC_SI 1.688169255655572064052978218230767915e-9
 
/**
 * @brief Approximate critical energy density, J m^-3
 * @details
 * LAL_RHOC_SI = LAL_H0_DIMENSIONLESS^2 * LAL_RHOCFAC_SI
 */
#define LAL_RHOC_SI (LAL_H0_DIMENSIONLESS * LAL_H0_DIMENSIONLESS * LAL_RHOCFAC_SI)
 
/**
 * @brief Cosmic microwave background radiation temperature, K
 * @see http://dx.doi.org/10.1088/0004-637X/707/2/916
 */
#define LAL_TCMB_SI 2.72548
 
/**
 * @brief Solar velocity with respect to the cosmic microwave background radiation, m s^-1
 * @details
 * Adopted value is v/c = 0.0012338
 * @see http://dx.doi.org/10.1088/0004-637X/707/2/916
 */
#define LAL_VCMB_SI 369883.9346804
 
/**
 * @brief Number density of cosmic microwave background radiation photons, m^-3
 * @details
 * LAL_NCMB_SI = 16 * zeta(3) * LAL_PI * (LAL_K_SI * LAL_TCMB_SI / (LAL_C_SI * LAL_H_SI))^3
 *
 * where zeta is the Riemann zeta function and zeta(3) is Apery's constant.
 * @see http://oeis.org/A002117
 */
#define LAL_NCMB_SI 4.107178061233267795913602167900672966e8
 
/**
 * @brief Entropy density of cosmic microwave background radiation, J K^-1 m^-3
 * @details
 * LAL_SCMB_SI = 4 * LAL_PI^2 * LAL_K_SI * (LAL_K_SI * LAL_TCMB_SI / (LAL_C_SI * LAL_HBAR_SI))^3 / 45
 */
#define LAL_SCMB_SI 2.042296344521760298284258925842980552e-14
/** @} */
 
/** @} */
/** @} */
#ifdef  __cplusplus
}
#endif
#endif /* _LALCONSTANTS_H */