Available models

Nomenclature

In its attempt to organize the jungle of evolutionary models published in the recent literature, MADYS establishes a taxonomical classification of models based on four levels of hierarchy:

  • the model family (L1), which can be thought as a container of all the models developed by a certain working team;

  • the model suite (L2), that should be characterized by a well-defined set of physical assumptions, equations, atmospheric and evolutionary codes; in general, a suite of model is described by one or more publications;

  • the model version (L3). The model suite can be distributed under different flavours, characterized by e.g. varying boundary conditions, treatments of dust, and “minor” differences;

  • the model grid (L4), that adds to the previous one the specification of up to six input parameters (metallicity, helium fraction, rotational velocity, alpha enhancement, fraction of stellar surface covered by star spots, and magnetic field.

For example:

L1 = model_family: ATMO #(ERC-ATMO @ University of Exeter)
L2 = model_suite: ATMO2020 #(suite published in Phillips et al. 2020)
L3 = model_version: ATMO2020-ceq #(version assuming chemical equilibrium)
L4 = model_grid: ATMO2020-ceq_p0.00 #(solar metallicity)

The class ModelHandler is meant to handle the model database of MADYS and to assist the user in:

  • understanding which models are available;

  • resolving the taxonomy of any of them;

  • downloading the corresponding files;

  • identifying the available filters and customizable parameters.

Many of these tasks are accomplished through the function ModelHandler.available(). In particular, the full model database with its taxonomic tree can be accessed through the command:

ModelHandler.available('full_model_list')

Calling the same function with argument equal to a valid model suite or version will return – if at least one grid is locally available – a detailed verbose description of the model itself, including literature references, customizable parameters, age and mass ranges, taxonomical information and the list of surveys currently featured in the model itself. The range of age, mass and parameters is dynamically adjusted based on the files present in the working path of MADYS, giving precise information on what is actually available for use in MADYS.

 ModelHandler.available('mist')


# isochrone model: MIST (v1.2)
# MESA revision number = 7503
# Basic references: Dotter, ApJS, 222, 8 (2016) + Choi et al., ApJ 823, 102 (2016)
# Solar mixture: Y = 0.2703, Z = 0.0142
# Photometric systems:
# 2mass, bessell, gaia, hipparcos, hr, kepler, sdss, tess, tycho, wise
# Mass range (M_sun): [0.1, 149.5237]
# Age range (Myr): [0.1, 19952.6]
# Available metallicities: [-4.0,-3.5,-3.0,-2.5,-2.0,-1.75,-1.5,-1.25,-1.0,-0.75,-0.5,-0.25,0.0,0.25,0.5]
# Available rotational velocities: [0.0,0.4]
# Available alpha enhancements: [0.0]
# Available magnetic field strengths: [0]
# Available spot fractions: [0.0]
# Available helium contents: [0.2703]
# Model family: mist
# Model suite: mist
# Call it as: 'mist'

If the function is called with no argument, all verbose information about all locally available model suites will be printed at once.

Usage

Whenever a model is required as input of a MADYS function, the user should intend it as a model version. The parameters uniquely specifying the model grid to be internally employed by the program must be supplied, if needed, by means of optional keywords named feh, afe, he, v_vcrit, fspot, and B.

Model grids constitute the input of just one function, ModelHandler.download_model(); additionally, they can be accepted as input of ModelHandler.available().

Download models

A user can in any moment download a model grid through the following function:

ModelHandler.download_model(model_grid)

This function is automatically called when attempting to use a combination of parameters that is best reproduced by a model grid that is not available in the current working path of MADYS. In this case, the program will ask whether to use the local best-matching model or to download and use the more suitable model available in the Zenodo repository associated to MADYS.