vice.yields.agb.grid

Obtain the stellar mass-metallicity grid of fractional net yields from asymptotic giant branch stars published in a nucleosynthesis study.

Signature: vice.yields.agb.grid(element, study = “cristallo11”)

Parameters

elementstr [case-insensitive]

The symbol of the element to obtain the yield grid for.

studystr [case-insensitive] [default“cristallo11”]

A keyword denoting which study to pull the yield table from.

Recognized Keywords:

  • “cristallo11”: Cristallo et al. (2011) 1

  • “karakas10”: Karakas (2010) 2

Returns

gridtuple (2-D)

A tuple of tuples containing the yield grid. The first axis is the stellar mass, and second is the metallicity

massestuple

The masses in units of \(M_\odot\) that the yield grid is sampled on.

ztuple

The metallicities by mass \(Z\) that the yield grid is sample on.

Raises

  • ValueError
    • The study or the element are not built into VICE

  • LookupError
    • study == "karakas10" and the atomic number of the element is \(\geq\) 29. The Karakas (2010) study did not report yields for elements heavier the nickel.

  • IOError [Occur’s only if VICE’s file structure has been modified]
    • The parameters passed to this function are allowed but the data file is not found.

Notes

Note

The nucleosynthetic yield tables built into VICE do not include any treatment of radioactive isotopes. The yield tables returned by this function will not include what the specified study reported for radioactive isotopes. In the case of elements with a significant nucleosynthetic contribution from radioactive decay products, the values returned from this function should be interpreted as lower bounds rather than estimates of the true yield.

Example Code

>>> y, m, z = vice.agb_yield_grid("sr")
>>> m
    (1.3, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 6.0)
>>> z
    (0.0001, 0.0003, 0.001, 0.002, 0.003, 0.006, 0.008, 0.01, 0.014, 0.02)
>>> # the fractional yield from 1.3 Msun stars at Z = 0.001
>>> y[0][2]
    2.32254e-09
1

Cristallo et al. (2011), ApJS, 197, 17

2

Karakas (2010), MNRAS, 403, 1413