# README for Huscher et al. (2025) AGB Yield Dataset
------------------------------------------------------

This dataset contains stellar yield tables from AGB star models calculated using MESA (Modules for Experiments in Stellar Astrophysics).
These models span a range of stellar masses and metallicities, and were discussed in:

> Huscher et al. (2025), AGB Mass Loss Rates and Metal Yields from Scaled Mixing-length and Mass-loss Parameters


## Contents
-------------

Each file is named using the following pattern:
    huscher25_yields_<Mass>M_<Z>Z.txt

Example:
    huscher25_yields_4.0M_0.0150Z.txt corresponds to 4.0 M_solar star with metal mass fraction of 0.015

Each file contains an individual AGB model's final surface abundances and total yields of 16 isotopes: 
    h1, he3, he4, c12, c13, n13, n14, n15, o16, o17, o18, f19, ne20, ne22, mg24, si28 


## File Format
----------------

Each file is a tab-delimited plain text file with the following columns:

| Column     | Description |
|------------|-------------|
| El         | Chemical element symbol
| A          | Atomic mass number
| [X/H]      | Logarithmic surface abundance relative to hydrogen: log10(N_X / N_H) - log10(N_X / N_H)_solar
| [X/O]      | Logarithmic surface abundance relative to oxygen: log10(N_X / N_O) - log10(N_X / N_O)_solar
| X_i        | Final surface mass fraction of the isotope
| Mass_i     | Total mass of the isotope present in the star at the end of the simulation [M_solar]
| Yield_i    | Total mass of the isotope ejected over the stellar lifetime [M_solar]


## Model Parameters
---------------------

Each file begins with header comments specifying:

- Initial mass (M_solar)
- Final mass (M_solar)
- Initial helium fraction Y
- Initial metallicity Z

All models were evolved using MESA r24.08.1, with custom mass loss and convective mixing parameters (see paper for details).

[X/H] and [X/O] were calculated with solar reference values from Magg et al 2022:

- H  = 12
- He = 10.93
- C  = 8.56
- N  = 7.98
- O  = 8.77
- F  = 4.40
- Ne = 8.15
- Na = 6.29
- Mg = 7.55
- Al = 6.43
- Si = 7.59


## Web Viewer
-------------

An online web tool to easily access specific metal yields for each model is available at: 

https://astronomy.nmsu.edu/ez/agb
https://hyperspaceweb.net/science/agb


## Citation
-------------

If you use this dataset, kindly cite:

> Huscher, E. et al. (2025), AGB Mass Loss Rates and Metal Yields from Scaled Mixing-length and Mass-loss Parameters


## Contact
------------

For questions, please contact:

Ezra Huscher  
New Mexico State University
ez@nmsu.edu

