RealisticSeismology

This project presents an implementation of realistic, finite-temperature nuclear-matter models in neutron-star seismology. It was developed to support Gittins and Andersson (Phys. Rev. D 111, 083024, 2025) and Gittins et al. (Phys. Rev. D 111, 023049, 2025).

Installation

The software is developed using the Julia programming language. To use it:

1. Install Julia (Note: as specified in the Manifest.toml, this code has been validated with v1.10.5)

2. Download this repository

3. Run Julia in the repository directory

4. Type ] to enter Julia's package manager (Pkg.jl) REPL,

   (@v1.10) pkg>

5. activate the project environment with

   (@v1.10) pkg> activate .

6. instantiate the project,

   (RealisticSeismology) pkg> instantiate

For more information on Julia packages and environments, see the Pkg.jl documentation.

Getting started

General use of this software is demonstrated in the scripts and notebooks directories. The notebooks are written in Julia Markdown and may be compiled using Weave.jl. For example,

julia> using Weave

julia> weave("mode_demo.jmd")

Citation

If you found this project to be useful in academic work, please cite it using the following references:

@article{gittins2024neutronstar,
        title="{Neutron-star seismology with realistic, finite-temperature nuclear matter}", 
       author={{Gittins}, F. and {Andersson}, N.},
      journal={Phys.\ Rev.\ D},
         year={2025},
        month=apr,
       volume={111},
        issue={8},
        pages={083024},
          doi={10.1103/PhysRevD.111.083024},
       eprint={2406.05177},
archivePrefix={arXiv},
 primaryClass={gr-qc}
}

@article{gittins2025problematicsystematics,
        title="{Problematic systematics in neutron-star merger simulations}", 
       author={{Gittins}, F. and {Matur}, R. and {Andersson}, N. and {Hawke}, I.},
      journal={Phys.\ Rev.\ D},
         year={2025},
        month=jan,
       volume={111},
        issue={2},
        pages={023049},
          doi={10.1103/PhysRevD.111.023049},
       eprint={2409.13468},
archivePrefix={arXiv},
 primaryClass={gr-qc}
}