A small example package
Project description
CompactObject
CompactObject is an open-source package designed to perform Bayesian inference on neutron star equation of state (EOS) constraints. It offers a comprehensive workflow that integrates astrophysical observations and nuclear measurements to explore the interior composition of neutron stars. The package is built to be user-friendly, easily extendable, and thoroughly documented, making it an essential tool for researchers in nuclear astrophysics.
We have a detailed documentation please check here: CompactObject Package Website
Please star this repository if you find it is helpful!
Table of Contents
- Core Functionality
- Papers
- Sample Citation
- Includes
- Installation
- Physics Notations
- License
- Contact
- Acknowledgments
Core Functionality
CompactObject offers a range of functionalities essential for constraining the EOS of neutron stars:
-
Equation of State (EOS) Generation
- Utilizes multiple physics/meta models, including Relativistic Mean Field (RMF), strange star, quark star, polytrope, and speed of sound models, to generate neutron star EOS.
- EOSgenerators Package
-
Tolman-Oppenheimer-Volkoff (TOV) Solver
- Solves the TOV equations for a spherically symmetric compact object based on a given neutron star EOS.
- TOVsolver Package
-
Bayesian Inference Workflow
- Implements neutron star EOS inference using Nested Sampling.
- Provide options for single machine users using MCMC sampling by emcee.
- Integrates constraints from nuclear experiments, neutron star mass and/or radius observations (from X-ray timing and/or radio timing), and tidal measurements from gravitational wave detections.
- InferenceWorkflow Package
Papers
Please consider cite the following papers if you use CompactObject in your research:
-
Huang, C., Raaijmakers, G., Watts, A. L., Tolos, L., & Providência, C. (2024). Constraining fundamental nuclear physics parameters using neutron star mass-radius measurements I: Nucleonic models. Monthly Notices of the Royal Astronomical Society, 529. DOI:10.1093/mnras/stae844
-
Huang, C., Tolos, L., Providência, C., & Watts, A. (2024). Constraining a relativistic mean field model using neutron star mass-radius measurements II: Hyperonic models. arXiv preprint arXiv:2410.14572. https://arxiv.org/abs/2410.14572
-
Huang, C., & Zheng, X.-P. (2024). Bayesian Insights into post-Glitch Dynamics: Model comparison and parameter constraint from decades-long observation data of the Crab pulsar. arXiv preprint arXiv:2409.18432. https://arxiv.org/abs/2409.18432
Sample Citation
"The inference conducted here relies on the framework in the CompactObject \cite{CompactObject} package\footnote{https://chunhuangphy.github.io/CompactObject/}. This is an open-source, comprehensive package designed to implement Bayesian constraints on the neutron star EOS. Other works based on this package include ..."
Includes
CompactObject includes the following components to facilitate neutron star EOS inference analysis:
-
EOS Output Validation Routine
- Compute various type of EOS by different models
- Checks the validity of EOS inputs.
-
Mass, Radius, and Tidal Deformability Calculator
- Returns mass, radius, tidal deformability, by solve TOV equation, and computes the corresponding speed of sound.
-
Sample TOV Solver Notebook
- Test_TOVsolver.ipynb
- Demonstrates how to solve the TOV equation with a given EOS.
-
Sample EOS Generators Notebook
- test_EOSgenerators.ipynb
- Showcases all integrated EOS computations, including:
- Polytrope
- Speed of Sound Model
- RMF Model
- Strange Star Model
- Quark Star Model
-
Sample Analysis and Tutorial Notebook
- test_Inference.ipynb
- Demonstrates the entire pipeline of Bayesian inference using supported EOS models, constructing priors and likelihoods, and the types of likelihoods supported in this project. Also provide a MCMC based emcee example for people don't have access to High Performance Computer. This is specifically focus on the RMF EOS, However, please check this notebook before all other notebook, since here we showcase all the likelihood
- Other Inference pipline that using different EOS are
Note: Please review these notebooks before starting your own project to familiarize yourself with the coding routines.
Installation
Below are the commands to install and update the CompactObject package, along with a link to PyPI.
PyPI - CompactObject-TOV
-
Install the Package
pip install CompactObject-TOV
-
Update the Package
pip install CompactObject-TOV --upgrade
Importing the Package
-
For EOS Computation:
import EOSgenerators
-
For TOV Solver:
import TOVsolver
-
For Bayesian Inference:
import InferenceWorkflow
Physics Notations
-
Units:
- CGS Units are used throughout the package.
- Pressure (P): erg/cm³
- Energy Density (ρ): g/cm³
- Default Unit system any input in this package is follow the cgs unit
-
Unit Conventions:
- Follow the unit system defined in the Unit Conversion notebook.
- Basic Rules:
- If using a quantity with a unit, multiply by the unit during computations.
- If plotting or demonstrating values in a specific unit, divide accordingly.
- Detailed guidelines can be found in the Unit Conversion documentation.
License
Distributed under the MIT License. See LICENSE.txt
for more information.
Contact
- Chun Huang - chun.h@wustl.edu
Documentation Link: CompactObject Documentation
Acknowledgments
We would like to acknowledge the support of the Code/Astro workshop, which was instrumental in the development of this project. Special thanks to Professor Anna Watts, Dr. Geert Raaijmakers, and Jeannie Kuijper for their assistance with coding and providing foundational strategies to address the research challenges.
```Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file compactobject_tov-2.0.0.tar.gz
.
File metadata
- Download URL: compactobject_tov-2.0.0.tar.gz
- Upload date:
- Size: 53.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.13.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94896c5af879e308a1a307eab3419e81860075dc43ebd2e1e832146d05c3fe61 |
|
MD5 | 6093059dcf3def048f8635203cb36158 |
|
BLAKE2b-256 | ff9f62872d4f6f24cf8f9567b04ee9a9ded9c0961a51f7aeaeff8dad5ac60c0c |
File details
Details for the file CompactObject_TOV-2.0.0-py3-none-any.whl
.
File metadata
- Download URL: CompactObject_TOV-2.0.0-py3-none-any.whl
- Upload date:
- Size: 60.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.13.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f09775b377aee70078fe6bcbd593544747ff4e2f2ecd0321de8ecbc5d8f146d |
|
MD5 | ee853c0785a2530e415c953acf7626b7 |
|
BLAKE2b-256 | fcdbd177bcc42e4880d49a2512a8dcb0f6495eacab1224968e09c0ab1535c7a2 |