stam.gentracks.get_isotrack

stam.gentracks.get_isotrack(models, vals, params=('mass', 'mh'), mass_res=0.007, absmag_res=0.01, age_res=0.1, log_age_res=0.05, mh_res=0.05, stage=1, sort_by=None, mass_min=0, mass_max=inf, absmag_min=-inf, absmag_max=inf, age_min=0, age_max=inf, mh_min=-inf, mh_max=inf, stage_min=0, stage_max=inf, color_filter1='G_BPmag', color_filter2='G_RPmag', mag_filter='Gmag', return_idx=False, return_table=False)[source]
get_isotrack(models, vals, params=(“mass”, “mh”),

mass_res=0.007, absmag_res=0.01, age_res=0.1, log_age_res=0.05, mh_res=0.05, stage=1, sort_by=None, mass_min=0, mass_max=np.inf, absmag_min=-np.inf, absmag_max=np.inf, age_min=0, age_max=np.inf, mh_min=-np.inf, mh_max=np.inf, stage_min=0, stage_max=np.inf, color_filter1=”G_BPmag”, color_filter2=”G_RPmag”, mag_filter=”Gmag”, return_idx=False, return_table=False)

Get a specific stellar evolution track, with two out of four parameters fixed (mass, age, metallicity, absmag). NOTE: This function doesn’t interpolate between tracks, just return all tracks within the mass/age/metallicity/absmag bins.

Parameters:

  • models (Table) – All stellar evolution models in a single astropy table, as retrieved by stam.models.read_parsec.

  • vals (array_like (of length 2)) – Values of the fixed parameters (units: [mass] = Msun, [age] = Gyr, [mh] = dex).

  • params (tuple (of length 2), optional) – Fixed parameters names (default: (“mass”, “mh”)).

  • mass_res (float, optional) – Mass resolution, in Msun (default: 0.007 Msun). If negative - treat as fractional.

  • absmag_res (float, optional) – Absolute magnitude resolution, in mag (default: 0.01 mag). If negative - treat as fractional.

  • age_res (float, optional) – Age resolution, in Gyr (default: 0.1 Gyr). If negative - treat as fractional.

  • log_age_res (float, optional) – log(age/yr) resolution, in dex, if using log_age as one of the params (default: 0.05 dex).

  • mh_res (float, optional) – Metallicity resolution, in dex (default: 0.05 dex)

  • stage (int, optional) – Stellar evolution stage label (None = don’t select a specific stage, 0 = pre-MS, 1 = MS, etc.; default: 1).

  • mass_min (float, optional) – Minimum mass to consider, in Msun (if no fixed mass was chosen; default: 0 Msun).

  • mass_max (float, optional) – Maximum mass to consider, in Msun (if no fixed mass was chosen; default: 1 Msun).

  • absmag_min (float, optional) – Minimum absolute magnitude to consider, in mag (if no fixed absolute magnitude was chosen; default: -np.inf).

  • absmag_max (float, optional) – Maximum absolute magnitude to consider, in mag (if no fixed absolute magnitude was chosen; default: np.inf).

  • age_min (float, optional) – Minimum age to consider, in Gyr (if no fixed age was chosen; default: 0 Gyr).

  • age_max (float, optional) – Maximum age to consider, in Gyr (if no fixed age was chosen; default: np.inf Gyr).

  • mh_min (float, optional) – Minimum [M/H] to consider, in dex (if no fixed metallicity was chosen; default: -np.inf).

  • mh_max (float, optional) – Maximum [M/H] to consider, in dex (if no fixed metallicity was chosen; default: np.inf).

  • stage_min (int, optional) – Minimum stellar evolution stage label to consider (if no fixed stage was chosen; default: 0).

  • stage_max (int, optional) – Maximum stellar evolution stage label to consider (if no fixed stage was chosen; default: np.inf).

  • color_filter1 (str, optional) – Bluer band to use for the color calculation (default: G_BPmag).

  • color_filter2 (str, optional) – Redder band to use for the color calculation (default: G_RPmag).

  • mag_filter (str, optional) – Which band to use for the magnitude axis (default: Gmag).

  • return_idx (bool, optional) – If true, return also the indices of the relevant rows in models (default: False).

  • return_table (bool, optional) – If true, return tracks in astropy Table format (default: False).

Returns:

  • color1 (array_like) – Chosen stellar evolution track color_filter1 magnitude

  • color2 (array_like) – Chosen stellar evolution track color_filter2 magnitude

  • absmag (array_like) – Chosen stellar evolution track mag_filter absolute magnitude

  • mass (array_like) – Chosen stellar evolution track mass, in Msun

  • mh (array_like) – Chosen stellar evolution track metallicity ([M/H]), in dex

  • age (array_like) – Chosen stellar evolution track age, in Gyr

  • idx (array_like) – The indices of the relevant rows in models (if return_idx=True).