Perform stellar classifications using isochrone grids
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Isochrone Stellar Classification Codes


Python codes to perform stellar classifications given any set of input observables. Details are described in Huber et al. 2017 - please cite this paper when using the code.


# Clone repo
git clone

# Download dependencies
pip install ebfpy 
pip install ephem
pip install dustmaps

# Download MESA models into isoclassify directory
cd isoclassify

# Download asfgrid input files for asteroseismic Delta_nu corrections (NB: currently not working for direct mode)
cd isoclassify/direct

# Set environment variables
export ISOCLASSIFY=${WKDIR}/code/isoclassify # access mesa models via ${ISOCLASSIFY}/mesa.ebf 
export PATH=${WKDIR}/code/isoclassify/bin:$PATH # This adds isoclassify executable to your path

Grid Modeling:

Derives posterior distributions for stellar parameters (teff, logg, feh, rad, mass, rho, lum, age, distance, av) through direct intregration of isochrones, given any set of observables (photometry, spectroscopy, parallax, asteroseismology) and priors. Can fit for extinction or use reddening map, includes (optionally) a correction to the Dnu scaling relation corrections by Sharma et al. (2016).

Required isochrone grid interpolated from MIST models (Choi et al. 2016):

See example/grid.ipynb for an application.

Direct Method:

Uses bolometric corrections and extinction maps to derive stellar parameters using direct physical relations. Options are:

  1. RA/DEC + Photometry + (Spectroscopy) + Parallax -> Teff, R, L, distance, Av. Uses Monte-Carlo method to implement exponentially decreasing volume density prior with a length scale of 1.35 kpc (Astraatmadja & Bailer-Jones 2016)

  2. RA/DEC + Asteroseismology + Spectroscopy -> logg, rho, rad, mass, lum, distance, Av. Uses Dnu scaling relation corrections by Sharma et al. (2016).

Bolometric corrections are interpolated in (Teff, logg, FeH, Av) from the MIST grid, Conroy et al. in prep (

Command line interface

isoclassify includes a command line interface (CLI) for convenient single star processing, as well as batch processing of many stars.

isoclassify run <mode> <star name> --csv <csv file> --outdir <output directory> --plot <plotmode> 
  1. <mode> direct or grid
  2. <star name> tells isoclassify which row of to pull the input parameters
  3. <output directory> will contain the isoclassify output files
  4. <csv file> contains as columns parameters that are passed to isoclassify
  5. <plotmode> tells isoclassify whether pop interactive plots show, save to a png save-png, or to not plot at all none.

We've included examples/example.csv with a few stars as an example

mkdir -p output/sol # make sure output directory exists
isoclassify run direct sol --csv examples/example.csv --outdir output/sol --plot show

The CLI also makes parallel processing easy.

# generate batch scripts
isoclassify batch direct examples/example.csv -o output > isoclassify.tot 

# Run with GNU parallel
parallel :::: isoclassify.tot

# Combine outputs into one CSV file
bin/isoclassify scrape-output 'output/*/output.csv' output.csv

Testing the codebase

When making changes, if you haven't changed the core algorithm then run the following command

isoclassify batch direct examples/example.csv -o output/direct > isoclassify-test-direct.tot 
isoclassify batch grid examples/example.csv -o output/grid > isoclassify-test-grid.tot 
cat isoclassify-test-direct.tot isoclassify-test-grid.tot  > isoclassify-test.tot
parallel :::: isoclassify-test.tot 

and compare the output with a previous version.