ssagear/zoomies: v0.1

zoomies is a dynamical age prediction package that uses Gaia parallax, proper motion, and radial velocity along with a Milky Way potential model to produce dynamical stellar age estimates based on a star’s galactic orbit.

In this repository, we include the following files:

1. zoomies-0.1: The source code for version 0.1 of the zoomies Python package.
   • In tutorials:
     • Main_kinematic_spline.ipynb: Tutorial on calibrating the stellar age-vertical action relation given a calibration sample of stars with external age measurements.
     • get_age_predictions.ipynb: Tutorial on calculating vertical actions and generating age predictions for stars with Gaia data.
   • In data: 
     • StokholmRGB_GaiaXmatch.csv: Abridged data table of asteroseismic ages for red giant branch stars from Stokholm et al. (2023), crossmatched with all Gaia DR3 data columns. Only stars with Gaia DR3 radial velocity data are included in this table. This table is necessary to run the tutorial notebooks.
     • StarHorse_APOGEE_composite.csv: Abridged data table of isochrone ages obtained with the Bayesian isochrone-fitting code STARHORSE for main-sequence turn-off stars from Queiroz et al. (2023). As above, the Gaia DR3 crossmatches and data are included in this table for stars with radial velocity data. This table is also necessary to run the tutorial notebooks.
2. MSTO_spline_model: Relevant files for the stellar age–vertical action relation calibrated on the sample of main-sequence turn-off stars from Queiroz et al. (2023). These files are also generated by running the tutorial notebook titled Main_Kinematic_Age_Spline.ipynb.
3. RGB_spline_model: Relevant files for the stellar age–vertical action relation calibrated on the sample of red giant branch stars from Stokholm et al. (2023). These files is also generated by running the tutorial notebook titled Main_Kinematic_Age_Spline.ipynb.
4. Data: tables of stellar parameters taken from Queiroz et al. (2023). and Stokholm et al. (2023), cross-matched with Gaia DR3.

A description of the construction and calibration process for the Bayesian stellar age–vertical action model in zoomies, along with relevant checks and suggested applications, are described in Sagear et al. (in review). The draft manuscript can be viewed on arXiv at arXiv:2403.09878.