betaFeedback

WorksPhysics and Astronomy

CompOSE Reference Manual

Abstract

CompOSE (CompStar Online Supernovae Equations of State) is an online repository of equations of state (EoS) for use in nuclear physics and astrophysics, e.g., in the description of compact stars or the simulation of core-collapse supernovae and neutron-star mergers, see http://compose.obspm.fr. The main services, offered via the website, are: a collection of data tables in a flexible and easily extendable data format for different EoS types and related physical quantities with extensive documentation and referencing; software for download to extract and to interpolate these data and to calculate additional quantities; webtools to generate EoS tables that are customized to the needs of the users and to illustrate dependencies of various EoS quantities in graphical form. This manual is an update of previous versions that are available on the CompOSE website, at arXiv:1307.5715 [astro-ph.SR], and that was originally published in the journal "Physics of Particles and Nuclei" with doi:10.1134/S1063779615040061. It contains a detailed description of the service, containing a general introduction as well as instructions for potential contributors and for users. Short versions of the manual for EoS users and providers will also be available as separate publications.

Version 3.01

CompStar Online Supernovæ Equations of State

“harmonising the concert of nuclear physics and astrophysics”

https://compose.obspm.fr

CompOSE Core Team

Preliminary Remark

This CompOSE reference manual, version 3.01, is an updated and extended version of previous manuals that appeared as a preprint arXiv:1307.5715 [astro-ph.SR] on arXiv.org. and as a refereed article in the journal ”Physics of Particles and Nuclei” [1]. The content of this publication was adapted by permission from Springer Nature Customer Service Centre GmbH: Springer Nature, Physics of Particles and Nuclei, Vol. 46, No. 4, 633-664 (”CompOSE CompStar online supernova equations of state harmonising the concert of nuclear physics and astrophysics compose.obspm.fr”, S. Typel, M. Oertel, and T. Klähn), Copyright Pleiades Publishing, Ltd. (2015). Previous versions are available on the CompOSE website compose.obspm.fr.

I Introduction

What CompOSE can do and what not

The online service CompOSE provides information and data tables for different equations of state (EoS) ready for further use in astrophysical applications, nuclear physics and beyond. See the review [2] for a general introduction. CompOSE has three major purposes:

  • CompOSE is a repository of EoS tables in a common format for direct usage with information on a large number of thermodynamic properties, on the chemical composition of dense matter and, if available, on microphysical quantities of the constituents.

  • CompOSE allows to interpolate the provided tables using different schemes to obtain the relevant quantities, selected by the user, for grids that are tailored to specific applications.

  • CompOSE can provide information on additional thermodynamic quantities, which are not stored in the original data tables, and on further quantities, which characterize an EoS, such as nuclear matter parameters and compact star properties.

The format of the files, as well as the calculational mesh, is mainly determined according to the needs of scientific groups performing extensive numerical simulations of astrophysical objects. We try to provide the tables in a large parameter space to cover most applications.

We cannot offer an online service for all features of CompOSE, e.g. to run all codes online. This is mostly due to limitations in storage and computation times, but also gives better control on avoiding unphysical input parameters. However, we offer several computational tools that allow the user to extract the data from the tables that are relevant for her/him. These tools can be downloaded from the CompOSE website https://compose.obspm.fr.

Appendix § 8.5 describes how to cite CompOSE and the EoS tables it contains.

CompOSE is designed in a modular way, thus allowing to extend the service over time. More and more models and parameter sets will be provided in time. It is foreseen that additional features will be added in the future, too.

How to read this document

While reading this document please always keep in mind: this document was written by physicists for physicists. It is divided into three major parts.

The first one is relevant both to providers and users of equations of state, as it serves as a basis for the discussions in the following parts of the manual and the web site. Both, contributors and users, should first of all have a look at the introductory chapter 3 where we will discuss general conventions and the notation used throughout CompOSE. In addition, we give definitions and details on the system of units that is used within CompOSE and on physical constants that should be used in order to standardise the generation of new equations of state.

The second part concerns those persons who wish to contribute to an extension of the CompOSE data base by the active development of an EoS. CompOSE allows them to make their favourite EoS available for a broad range of astrophysical and nuclear physics applications. In part II, detailed instructions, minimal requirements and recommendations are specified for the preparation of EoS tables that can be incorporated in future versions of the CompOSE data base. If you plan to contribute your EoS, you should contact the CompOSE core team ([email protected]), see appendix D. A summary of possible future extensions of the CompOSE data base are summarized in chapter 5.

The third part concerns the users of EoS data, that are provided by CompOSE, who want to test various equations of state in their simulations of core-collapse supernovae, neutron-star mergers and other scenarios. In general, they can safely skip the second part and go directly to the third one. This part gives a brief introduction on nuclear matter properties relevant for the construction of an EoS, as well as a classification of different types of EoS models in chapter 6. The models can be distinguished either by using different techniques to treat the many-body system of strongly interacting particles or by assuming a different particle composition. The main aim is to give the relevant information for the interpretation of the data sheets, provided with each available EoS table on the web site. You will find remarks on the range of applicability of the various models, i.e. the range of parameters where the code is tested and/or the made approximations are still valid. Characteristic parameters of each model will be specified. For more detailed information about the physics behind each model, we refer to the original references.

In addition, the third part of the manual explains in chapter 7 how to proceed in order to download an EoS table and the computational tools. The latter allow the generation of tables with a mesh different from the original one via interpolation, in order to adapt the table to the need of the user. In addition, several thermodynamic quantities can be calculated which are not contained in the original tables. The use of the online service and web interface is described in chapter § 7.1 too.

Recent Changes

Version 1.00 of this manual was published in [1] and is still available on the CompOSE web site. Version 2.00 contains some major changes, corrections and additions, in particular concerning the structure of the manual and the use of the provided software for handling data. The main changes from version 1.00 to 2.00 in the manual are:

  • the numerical values of physical constants, recommended for the preparation of EoS tables, in Table 3.1 were updated;

  • the discussion of constraints on nuclear matter properties in § 7.0.1 has been modified;

  • § 7.0.2 (Overview of models) and 6.3 (Phase transitions) have been removed since a comprehensive review [2] is available;

  • the title ’User registration’ of § 7.1.1 has been changed to ’Access to CompOSE’ with an adjusted description of the online sevice;

  • the description of how to use the compose program in § 7.1.5.2 was adapted to the new version and the description of the files eos.parameters (with a change of the structure) and eos.quantities was moved to appendix § 8.2;

  • subsection 7.4.3 was moved to appendix § 8.3 and the corresponding tables with the (sub-)routines and functions were updated;

  • Table 7.1, Table 7.4, and Table 7.8 were amended and a new Table 7.3 was introduced;

  • new appendices § 8.2 and § 8.3 were introduced;

  • the appendices § 8.4 and § 8.6 were updated;

  • the bibliography has been updated.

QuantitySymbolValueUnit
speed of light in vacuumcc299792458m s−1^{-1}
Planck’s constantℏ\hbar1.054571817×10−341.054571817 \times10^{-34}J s
6.582119569×10−226.582119569 \times10^{-22}MeV s
197.3269804MeV fm c−1c^{-1}
Boltzmann’s constantkBk_B1.380649×10−231.380649 \times10^{-23}J K−1^{-1}
8.617333262×10−118.617333262 \times10^{-11}MeV K−1^{-1}
gravitational constantGG6.67430×10−116.67430 \times10^{-11}m3^3 kg−1^{-1} s−2^{-2}
6.70883×10−396.70883 \times10^{-39}GeV−2^{-2} c−4c^{-4}
square of elementary chargee2e^21.439964547MeV fm
fine structure constantα=e2/(ℏc)\alpha= e^2/(\hbar c)1/137.035999084—
neutron massmnm_n939.56542052MeV c−2c^{-2}
proton massmpm_p938.27208816MeV c−2c^{-2}
electron massmem_e0.51099895000MeV c−2c^{-2}
muon massmμm_\mu105.6583745MeV c−2c^{-2}
unified atomic mass unituu931.49410242MeV c−2c^{-2}
solar massM⊙M_\odot1.98841×10301.98841 \times10^{30}kg
1.11542×10601.11542 \times10^{60}MeV c−2c^{-2}

Table 3.1. Recommended values for physical constants from the 2018 CODATA evaluation and the compilation of the Particle Data Group [10].

index JJquantity/expressionunitdescription
1ppMeV fm−3^{-3}total pressure
2S=s/nbS = s/n_bdimensionlesstotal entropy per baryon
3μb−mn\mu_b - m_nMeVbaryon chemical potential with respect to neutron mass
4μq\mu_qMeVcharge chemical potential
5μl\mu_lMeVlepton chemical potential
6F/mn−1\mathcal{F}/m_n - 1dimensionlessscaled free energy per baryon
7E=E/mn−1\mathcal{E} = \mathcal{E}/m_n - 1dimensionlessscaled internal energy per baryon
8H/mn−1\mathcal{H}/m_n - 1dimensionlessscaled enthalpy per baryon
9G/mn−1\mathcal{G}/m_n - 1dimensionlessscaled free enthalpy per baryon
10∂p∂nb∣E\left.\frac{\partial p}{\partial n_b}\right|_{\mathcal{E}}MeVpartial derivative of pressure with respect to baryon number density
11∂p∂E∣nb\left.\frac{\partial p}{\partial\mathcal{E}}\right|_{n_b}fm−3^{-3}partial derivative of pressure with respect to internal energy per baryon
12cs2c_s^2dimensionlessspeed of sound squared
13cVc_Vdimensionlessspecific heat capacity at constant volume
14cpc_pdimensionlessspecific heat capacity at constant pressure
15Γ=cp/cV\Gamma= c_p/c_Vdimensionlessadiabatic index
16αp\alpha_pMeV−1^{-1}expansion coefficient at constant pressure
17βV\beta_Vfm−3^{-3}tension coefficient at constant volume
18κT\kappa_Tfm3^3/MeVisothermal compressibility
19κS\kappa_Sfm3^3/MeVadiabatic compressibility

Table 7.1. Thermodynamic quantities in the data tables with their units.

index JJquantity/expressionunitdescription
1F\mathcal{F}[MeV]free energy per baryon
2∂F∂T\frac{\partial\mathcal{F}}{\partial T}dimensionlessfirst temperature derivative of free energy per baryon
3∂2F∂T2\frac{\partial^{2} \mathcal{F}}{\partial T^{2}}[MeV−1^{-1}]second temperature derivative of free energy per baryon
4∂2F∂T∂nb\frac{\partial^{2} \mathcal{F}}{\partial T\partial n_b}[fm3^{3}]mixed second derivative of free energy per baryon
5∂2F∂T∂Yq\frac{\partial^{2} \mathcal{F}}{\partial T\partial Y_q}dimensionlessmixed second derivative of free energy per baryon
6∂F∂nb\frac{\partial\mathcal{F}}{\partial n_b}[MeV fm3^{3}]first baryon density derivative of free energy per baryon
7∂2F∂nb2\frac{\partial^{2} \mathcal{F}}{\partial n_b^{2}}[MeV fm6^{6}]second baryon density derivative of free energy per baryon
8∂2F∂nb∂Yq\frac{\partial^{2} \mathcal{F}}{\partial n_b\partial Y_q}[MeV fm3^{3}]mixed second derivative of free energy per baryon
9∂F∂Yq\frac{\partial\mathcal{F}}{\partial Y_q}[MeV]first hadronic charge fraction derivative of free energy per baryon
10∂2F∂Yq2\frac{\partial^{2} \mathcal{F}}{\partial Y_q^{2}}[MeV]second hadronic charge fraction derivative of free energy per baryon

Table 7.3. Values and derivatives of the free energy per baryon which are stored in the data tables with their units.

index JJquantity / expressionunitdescription
IphaseI_{\mathrm{phase}}dimensionlessphase index
YIiY_{I_i}dimensionlessfraction of particle IiI_i
1Y%avY_{\%}^{\mathrm{av}}dimensionlesscombined fraction of group % of nuclei
2A%avA_{\%}^{\mathrm{av}}dimensionlessaverage mass number of group % of nuclei
3Z%avZ_{\%}^{\mathrm{av}}dimensionlessaverage charge number of group % of nuclei
4N%avN_{\%}^{\mathrm{av}}dimensionlessaverage neutron number of group % of nuclei

Table 7.4. Quantities containing information on the composition which are stored in the data tables with their units. The particle index IiI_i has been defined in tables 3.2, 3.3, 3.4 and 3.5. The symbols % denotes the group of nuclei.

References

  1. [1]S. Typel, M. Oertel, and T. Klähn, “CompOSE CompStar online supernova equations of state harmonising the concert of nuclear physics and astrophysics compose.obspm.fr,” Physics of Particles and Nuclei 46, 633 (2015).DOI
  2. [2]M. Oertel, M. Hempel, T. Klähn and S. Typel, “Equations of state for supernovae and compact stars,” Rev. Mod. Phys. 89, 015007 (2017).DOI
  3. [3]E. Tiesinga, D.B. Newell, P.J. Mohr, and B.N. Taylor, “CODATA Recommended Values of the Fundamental Physical Constants: 2018”, NIST SP961 (May 2019)
  4. [4]W.J. Huang, G. Audi, Meng Wang, F.G. Kondev, W.J. Huang, S. Naimi, and Xing Xu, “The AME2016 atomic mass evaluation (I). Evaluation of input data; and adjustment procedures,” Chinese Physics C 41, 030002 (2017);DOI
  5. [5]Meng Wang, G. Audi, F.G. Kondev, W.J. Huang, S. Naimi, and Xing Xu, Chinese Physics C “The AME2016 atomic mass evaluation (II). Tables, graphs and references,” Chinese Physics C 41, 030003 (2017).
  6. [6]W. J. Huang, M. Wang, F. G. Kondev, G. Audi and S. Naimi, “The AME 2020 atomic mass evaluation (I). Evaluation of input data, and adjustment procedures,” Chin. Phys. C 45 (2021) no.3, 030002DOI
  7. [7]M. Wang, W. J. Huang, F. G. Kondev, G. Audi and S. Naimi, “The AME 2020 atomic mass evaluation (II). Tables, graphs and references,” Chin. Phys. C 45 (2021) no.3, 030003
  8. [8]G. Audi, F. G. Kondev, M. Wang, W. J. Huang and S. Naimi, “The NUBASE2016 evaluation of nuclear properties,” Chinese Physics C 41, 030001 (2017).DOI
  9. [9]F. G. Kondev, M. Wang, W. J. Huang, S. Naimi and G. Audi, “The NUBASE2020 evaluation of nuclear physics properties,” Chin. Phys. C 45 (2021) no.3, 030001DOI
  10. [10]P. A. Zyla et al. [Particle Data Group], “Review of Particle Physics,” PTEP 2020 (2020) no.8, 083C01
  11. [11]R. C. Tolman, “Static solutions of Einstein’s field equations for spheres of fluid” Phys. Rev. 55 (1939) 364.DOI
  12. [12]J. R. Oppenheimer and G. M. Volkoff, “On massive neutron cores”, Phys. Rev. 55 (1939) 374.DOI
  13. [13]T. Hinderer, “Tidal Love numbers of neutron stars,” Astrophys. J. 677 (2008), 1216-1220.DOI
  14. [14]T. Hinderer, B. D. Lackey, R. N. Lang and J. S. Read, “Tidal deformability of neutron stars with realistic equations of state and their gravitational wave signatures in binary inspiral,” Phys. Rev. D 81 (2010), 123016.DOI
  15. [15]N. Stergioulas and J. L. Friedman, “Comparing models of rapidly rotating relativistic stars constructed by two numerical methods,” Astrophys. J. 444 (1995), 306
  16. [16]T. Nozawa, N. Stergioulas, E. Gourgoulhon and Y. Eriguchi, “Construction of highly accurate models of rotating neutron stars: Comparison of three different numerical schemes,” Astron. Astrophys. Suppl. Ser. 132 (1998), 431
  17. [17]RNS - Rapidly Rotating Neutron Star, http://www.gravity.phys.uwm.edu/rns
  18. [18]LORENE - Langage Objet pour la Relativité NumériquE, https://lorene.obspm.fr/
  19. [19]J. M. Lattimer, M. Prakash, C. J. Pethick and P. Haensel, “Direct URCA process in neutron stars,” Phys. Rev. Lett. 66 (1991), 2701-2704pubmed.ncbi.nlm.nih.gov/10043594
  20. [20]D. E. Alvarez-Castillo and D. Blaschke, “Interplay between Symmetry Energy and Excluded Volume Corrections under the Direct Urca Cooling Constraint in Neutron Stars,” PoS MPCS2015 (2016), 026
  21. [21]M. Strickland, “Anisotropic Hydrodynamics: Three lectures,” Acta Phys. Polon. B 45 (2014) no.12, 2355-2394DOI
  22. [22]M. Dutra, O. Lourenço, J. S. Sa Martins, A. Delfino, J. R. Stone and P. D. Stevenson, “Skyrme Interaction and Nuclear Matter Constraints,” Phys. Rev. C 85, 035201 (2012).DOI
  23. [23]R. Sellahewa and A. Rios, “Isovector properties of the Gogny interaction,” Phys. Rev. C 90, 054327 (2014).
  24. [24]M. Dutra, O. Lourenço, S. S. Avancini, B. V. Carlson, A. Delfino, D. P. Menezes, C. Providência, S. Typel and J. R. Stone, “Relativistic Mean-Field Hadronic Models under Nuclear Matter Constraints,” Phys. Rev. C 90, 055203 (2014).DOI
  25. [25]J. R. Stone, N. J. Stone and S. A. Moszkowski, “Incompressibility in finite nuclei and nuclear matter,” Phys. Rev. C 89, 044316 (2014).DOI
  26. [26]F. D. Swesty, “Thermodynamically Consistent Interpolation for Equation of State Tables,” J. Comp. Phys. 127, 118 (1996).DOI

Paper details

vlnc:W_4p5688pt
Version
v1 · latest
Published
Fresh — added to the Hub within the last 30 days
Added
License
CC BY 4.0
Usage

views · 0

downloads · 0

A view counts once per browser per day, a download each time the PDF is requested.

  • Physics and Astronomy

Not recorded for this paper

View statement
Looking for related papers…
Contents