Skip to content

Star Log-extended eMulator

Welcome to our documentation webpage for the Star Log-extended eMulator (SLM) package.

Welcome to the Star Log-extended eMulation (SLM) package! Here we provide open source code for implementing the emulators we developed for the Tolman-Oppenheimer-Volkoff (TOV) equations. These include:

  • The original SLM emulator that is capable of handling logarithmically nonlinear ordinary differential equations, e.g., the TOV equations including tidal deformability.
  • A parametric extension of the original emulator, parametric SLM (pSLM) that is able to map between parameters of the equation of state (EOS) to the neutron star properties of mass, radius, and tidal deformability.

These emulators exhibit a computational speed-up of \(\approx 10^{4}\) times that of the high fidelity (HF) TOV solver employing standard Runge-Kutta (RK) methods, enabling their use in computationally intensive Bayesian frameworks used by multi-messenger astrophysical collaborations, e.g., the LIGO-Virgo-KAGRA collaboration. These emulators can also be further developed for use outside of nuclear astrophysics---feel free to try extending them or using them on your own physics or mathematics problem of interest!

Installation instructions

To install the most recent stable version of this package, run the command 

pip install SLM

To install this package in developer mode, run the following: 

git clone https://github.com/asemposki/SLM.git
cd SLM
pip install -e .

Testing

To use the testing suite in this repository, go inside the tests folder and simply run the command 

python3 -m pytest
to run all of the tests at once. To run an individual test, use the command 
python3 pytest <testing file name>
inside of the tests folder.

Citing this package

Our article based on this work was recently accepted in Phys. Rev. Research, but until it is published, keep using this link to cite our work:

@article{Lalit:2024vmu,
    author = "Lalit, Sudhanva and Semposki, Alexandra C. and Maldonado, Joshua M.",
    title = "{Star Log-extended eMulation: a method for efficient computation of the Tolman-Oppenheimer-Volkoff equations}",
    eprint = "2411.10556",
    archivePrefix = "arXiv",
    primaryClass = "astro-ph.HE",
    doi = "10.1103/5p3h-b8rf",
    journal = "Phys. Rev. Res.",
    volume = "7",
    number = "4",
    pages = "043037",
    year = "2025"
}

Author contact information

  • Sudhanva S. Lalit (FRIB/MSU): lalit@frib.msu.edu
  • Alexandra C. Semposki (Ohio U): as727414@ohio.edu
  • Joshua M. Maldonado (Ohio U): jm998521@ohio.edu