vice.yields.sneia.fractional

Calculate an IMF-averaged fractional nucleosynthetic yield of a given element from type Ia supernovae.

Signature: vice.yields.sneia.fractional(element, study = “seitenzahl13”, model = “N1”, n = 2.2e-03)

Parameters

elementstr [case-insensitive]

The symbol of the element to calculate the yield for.

studystr [case-sensitive] [default“seitenzahl13”]

A keyword denoting which study to adopt SN Ia mass yields from.

Keywords and their Associated Studies:

  • “seitenzahl13”: Seitenzahl et al. (2013) 1

  • “iwamoto99”: Iwamoto et al. (1999), 2

modelstr [case-insensitive] [default“N1”]

The model from the associated study to adopt.

Keywords and their Associated Models:

  • “seitenzahl13” : N1, N3, N5, N10, N20, N40, N100H, N100, N100L, N150, N200, N300C, N1600, N1600C, N100_Z0.5, N100_Z0.1, N100_Z0.01

  • “iwamoto99” : W7, W70, WDD1, WDD2, WDD3, CDD1, CDD2

nreal number [default2.2e-03]

The average number of type Ia supernovae produced per unit stellar mass formed \(N_\text{Ia}/M_\star\) in \(M_\odot^{-1}\).

Note

The default value for this parameter is adopted from Maoz & Mannucci (2012) 3.

Returns

yreal number

The IMF-averaged yield.

Note

Unlike vice.yields.ccsne.fractional, there is no associated numerical error with this function, because the solution is analytic.

Raises

  • ValueError

    • The element is not built into VICE.

    • The study is not built into VICE.

    • n < 0

  • LookupError

    • The model is not recognized for the given study.

  • IOError [Occurs 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

This function evaluates the solution to the following equation:

\[y_x^\text{Ia} = \left(\frac{N_\text{Ia}}{M_\star}\right)M_x\]

where \(M_x\) is the value returned by vice.yields.sneia.single, and \(N_\text{Ia}/M_\star\) is specified by the parameter n.

Note

The nucleosynthetic yield tables built into VICE do not include any treatment of radioactive isotopes. This function evaluates the solution to the above equation given the total mass yield of stable isotopes only. 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

>>> import vice
>>> vice.fractional_ia_yield("fe")
        0.0025825957080000002
>>> vice.fractional_ia_yield("ca")
        8.935489894764334e-06
>>> vice.fractional_ia_yield("ni")
        0.00016576890932800003
1

Seitenzahl et al. (2013), MNRAS, 429, 1156

2

Iwamoto et al. (1999), ApJ, 124, 439

3

Maoz & Mannucci (2012), PASA, 29, 447