Skip to main content

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

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)

DOI

@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.

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:

  • MADYS is Python package 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.

  • isochrones is a Python package that provides interface to access the MIST grids.

  • PARSEC team 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)

Source distribution for ysoisochrone 1.2.0
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)

Table of built distributions (wheels) for ysoisochrone 1.2.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page