ysoisochrone
ysoisochrone is a Python3.8+ package that handles the isochrones for young-stellar-objects. One of the primary goals of this package is to derive the stellar mass and ages from the isochrones.
Contributors
Dingshan Deng (dingshandeng@arizona.edu), The University of Arizona
Ilaria Pascucci, The University of Arizona
Rachel B. Fernandes, The Pennsylvania State University
Luigi Zallio, University of Milan
Min Fang, Purple Mountain Observatory
We thank the referees and editors of AAS, A&A, and JOSS journals for their constructive feedback. Special thanks go to Warrick Ball, Heloise F. Stevance, and Vito Squicciarini for their detailed reviews and suggestions, as well as the anonymous referees whose suggestions greatly enhanced the quality of this package.
Feature
- Handle different formats of the isochrones from different reference sources. The available evolutionary models include Baraffe et al. (2015), Feiden (2016), and PARSEC (both version 1.2 and 2.0). Other tracks will also be added in the future.
NEW TRACKS AVAILABLE in v1.1.3: Siess et al. (2000); Feiden Magnetic Tracks (Feiden 2016); SPOTS Tracks with different cold photospheric spot coverages (Somers et al. 2020); and Pisa models Tognelli et al. 2011.
-
Derive the stellar masses and ages from the isochrones by:
-
(a) Using the Bayesian inference approach. The required inputs are stellar effective temperature ($T_{\rm eff}$), bolometric luminosity ($L_{\rm bol}$), and their uncertainties.
-
(b) Using the Bayesian inference approach where we do not have a good luminosity measurement. Therefore, we need to assume an age for the target.
-
The code also includes a stand alone function to estimate the stellar masses and ages from the grid point that has the closest $T_{\rm eff}$ and $L_{\rm bol}$ to the target.
- Basic plot utils to show Hertzsprung–Russell diagram, Bayesian inference results and others.
Installation
You can easily install the package via
pip install ysoisochrone
If you have installed ysoisochrone before, to use the new tracks in the latest version (1.1.3+), use
pip install --upgrade ysoisochrone
to update to the latest version.
Or, you can also install your preferred release by downloading the package release from the GitHub page. Then unzip the package.
In the terminal and in the directory of this package where setup.py exists.
pip install --upgrade .
Quick Start
A Quick Start Guide is provided as a Jupyter Notebook together with other tutorial Jupyter Notebooks. You can also find these tutorial notebooks in the folder called tutorial_notebooks.
This Guide is also provided in the documentation together with some other detailed explanations.
Citations
If you use ysoisochrone as part of your research, please cite
"Deng et al. (2025), based on the IDL code developed by Pascucci et al. (2016)"
If the version number needs to be specified, please cite according to the Zenodo page. For the latest version (v1.1.3.1), use
@software{deng_2026_18859400,
author = {Deng, Dingshan and
Pascucci, Ilaria and
Fernandes, Rachel B. and
Zallio, Luigi and
Fang, Min},
title = {ysoisochrone: A Python package to estimate masses
and ages for YSOs
},
month = mar,
year = 2026,
publisher = {Zenodo},
version = {v1.1.3.1},
doi = {10.5281/zenodo.14847201},
url = {https://doi.org/10.5281/zenodo.14847201},
}
Quick Access to these works, where you can find the definitions of the methods: Deng et al. (2025); Pascucci et al. (2016)
@article{Deng2025,
doi = {10.21105/joss.07493},
url = {https://doi.org/10.21105/joss.07493},
year = {2025},
publisher = {The Open Journal},
volume = {10},
number = {106},
pages = {7493},
author = {Dingshan Deng and Ilaria Pascucci and Rachel B. Fernandes},
title = {ysoisochrone: A Python package to estimate masses and ages for YSOs},
journal = {Journal of Open Source Software}
}
@article{Pascucci2016,
author = {{Pascucci}, I. and {Testi}, L. and {Herczeg}, G.~J. and {Long}, F. and {Manara}, C.~F. and {Hendler}, N. and {Mulders}, G.~D. and {Krijt}, S. and {Ciesla}, F. and {Henning}, Th. and {Mohanty}, S. and {Drabek-Maunder}, E. and {Apai}, D. and {Sz{\H{u}}cs}, L. and {Sacco}, G. and {Olofsson}, J.},
title = {A Steeper than Linear Disk Mass-Stellar Mass Scaling Relation},
journal = {The Astrophysical Journal},
keywords = {brown dwarfs, protoplanetary disks, stars: pre-main sequence, submillimeter: planetary systems, Astrophysics - Earth and Planetary Astrophysics, Astrophysics - Solar and Stellar Astrophysics},
year = 2016,
month = nov,
volume = {831},
number = {2},
eid = {125},
pages = {125},
doi = {10.3847/0004-637X/831/2/125},
archivePrefix = {arXiv},
eprint = {1608.03621},
primaryClass = {astro-ph.EP},
adsurl = {https://ui.adsabs.harvard.edu/abs/2016ApJ...831..125P},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
If you use any stellar evolutionary models, please also refer to their original work/website for citations.
Community Guidelines
We welcome contributions, issue reports, and questions about ysoisochrone! If you encounter a bug or issue, check out the Issues page and provide a report with details about the problem and steps to reproduce it. For general support, usage questions and suggestions, you can start a discussion in Discussions page, and of course feel free to send emails directly to us. If you want to contribute, feel free to fork the repository and create pull requests here. ysoisochrone is licensed under MIT license, so feel free to make use of the source code in any part of your own work/software.
Useful links
There are a few other useful tools and packages that can be used to handle stellar evolutionary tracks and to estimate stellar mass and age for pre-main sequence stars. Including:
-
MADYSisPythonpackage that can be used to derive ages and masses for pre-main sequence stars from multi-wavelengths photometric data with the extinction corrected according to extinction maps and laws; and it could ustilize different stellar evolutionary models, including MIST, PARSEC (v1.2 and 2.0), Feiden, Baraffe and many other models for pre-MS or MS stars. -
isochronesis aPythonpackage that provides interface to access the MIST grids. -
PARSECteam provides a web interface to access different versions of their tracks together with some useful web-based tools.
Metadata
Release files for ysoisochrone 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ysoisochrone-1.2.0.tar.gz | 10.0 MB | Without provenance | Details for ysoisochrone-1.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ysoisochrone-1.2.0-py3-none-any.whl | Python 3 | none | any | Details for ysoisochrone-1.2.0-py3-none-any.whl |
Total release size: 19.9 MB
Release files / ysoisochrone-1.2.0.tar.gz
| Download URL | ysoisochrone-1.2.0.tar.gz |
|---|---|
| Size | 10.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd8e3f4cf8fde835a06d4b8f657521384326eaa50b10781f89278e3cf4716da2
|
|
BLAKE2b-256 checksum How to use checksums |
9eab38b979f347748c1f93eb9c08e5b20123b7653c007c73b9a0a8b66e610edd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.17
|
Release files / ysoisochrone-1.2.0-py3-none-any.whl
| Download URL | ysoisochrone-1.2.0-py3-none-any.whl |
|---|---|
| Size | 10.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fdd9ef26688cd22ae6f650a3af2c27b4d30c85f6700893de5236637e939de26c
|
|
BLAKE2b-256 checksum How to use checksums |
ee5ffd50c2ddd6287e84979705aa3d30761e34b06016509a351138a529c56522
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.17
|
Security for ysoisochrone 1.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.