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¶
- element
str
[case-insensitive] The symbol of the element to obtain the yield grid for.
- study
str
[case-insensitive] [default“cristallo11”] A keyword denoting which study to pull the yield table from.
Recognized Keywords:
Returns¶
- grid
tuple
(2-D) A tuple of tuples containing the yield grid. The first axis is the stellar mass, and second is the metallicity
- masses
tuple
The masses in units of \(M_\odot\) that the yield grid is sampled on.
- z
tuple
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