API

Evolutionary tracks

mistery.get_tracks(Ms=[1.0], FeH=0.0, vvcrit=0.0, Av=0.0, photometry=None)

Returns a list of evolutionary tracks from the MIST database. The script makes the PHP request, infers the archive’s filename, decompresses it, combines the theoretical and photometry data if necessary and returns a list of NumPy structured arrays. You can get the list of column names with e.g.

tracks = mistery.get_tracks(Ms=[1.0, 2.0], FeH=-0.5)
print(tracks[0].dtype.names)
Parameters:

  • Ms (iterable of floats) – Masses of the desired tracks, in solar units.

  • FeH (float) – Metallicity [Fe/H] of the tracks.

  • vvcrit (float, 0.0 or 0.4 only) – ZAMS rotation rate of the tracks, relative to critical.

  • Av (float) – Extinction coefficient.

  • photometry (None or str) – Name of the table of photometric bands to include. e.g. 'UBVRIplus'. See Photometry table options for all options.

Returns:

tracks – List containing the evolutionary tracks, in the same order as Ms. Always includes the 77 columns of theoretical data and also includes photometry if photometry is not None.

Return type:

list of NumPy structured arrays

mistery.get_track(M=1.0, **kwargs)

Returns a single evolutionary track from the MIST database with mass M (in solar units) and other keywords options that are passed to get_tracks() (e.g. FeH). The function really just calls get_tracks() with Ms=[M] and returns a single NumPy structured array, rather than a list of them. See get_tracks() for more details.

Isochrones

mistery.get_isochrones(ts=[1.0], split=True, FeH=0.0, vvcrit=0.0, Av=0.0, theory='basic', photometry=None)

Returns a set of isochrones from the MIST database. The script makes the PHP request, infers the filename, and returns a list of NumPy structured arrays. You can get the list of column names with e.g.

isochrones = mistery.get_isochrones(ts=[0.3, 1.3], FeH=-0.25)
print(isochrones[0].dtype.names)

The data is returned in a single .iso file, which is split up into a list of arrays for each age if split=True. Otherwise, a single array is returned that contains all the isochrones.

Parameters:

  • ts (iterable of floats) – Ages of the desired isochrones, in billions of years (Gyr).

  • split (bool) – If True, return a list of arrays corresponding to each age in ts, in that order. Otherwise, return the single array that the web form returns.

  • FeH (float) – Metallicity [Fe/H] of the isochrones.

  • vvcrit (float, 0.0 or 0.4 only) – ZAMS rotation rate of the isochrones, relative to critical.

  • Av (float) – Extinction coefficient.

  • theory (None, 'basic' or 'full') – How much theoretical data to include.

  • photometry (None or str) – Name of the table of photometric bands to include. e.g. 'UBVRIplus'. See Photometry table options for all options.

Returns:

isochrones – If split=True, a list containing the isochrones, in the same order as ts. If split=False, a single array containing all the isochrones. Columns in the arrays depends on choice of theory and photometry.

Return type:

NumPy structured array or a list of NumPy structured arrays

mistery.get_isochrone(t=1.0, **kwargs)

Returns a single isochrone from the MIST database with age t (in Gyr) and other keywords options that are passed to get_isochrones() (e.g. FeH). The function really just calls get_isochrones() with ts=[t] and returns a single NumPy structured array, rather than a list of them. See get_isochrones() for more details.

Photometry table options

Scraped from MIST form.

Option

Passbands

'CFHTugriz'

CFHT/MegaCam

'DECam'

DECam

'HST_ACSHR'

HST ACS/HRC

'HST_ACSWF'

HST ACS/WFC

'HST_WFC3'

HST WFC3/UVIS+IR

'HST_WFPC2'

HST WFPC2

'GALEX'

GALEX

'JWST'

JWST

'LSST'

LSST

'PanSTARRS'

PanSTARRS

'SDSSugriz'

SDSS

'SkyMapper'

SkyMapper

'SPITZER'

Spitzer IRAC

'SPLUS'

S-PLUS

'HSC'

Subaru Hyper Suprime-Cam

'IPHAS'

INT / IPHAS

'Swift'

Swift

'UBVRIplus'

UBV(RI)c + 2MASS + Kepler + Hipparcos + Gaia (DR2/MAW/EDR3) + TESS

'UKIDSS'

UKIDSS

'UVIT'

UVIT

'VISTA'

VISTA

'WashDDOuvby'

Washington + Strömgren + DDO51

'WFIRST'

WFIRST (preliminary)

'WISE'

WISE