isotopylog.EDistribution.from_literature

classmethod EDistribution.from_literature(mineral='calcite', reference='HH21', **kwargs)

Classmethod for generating an ipl.EDistribution instance directly from literature data. This method simply inputs the results of literature model fits; it does not re-calculate rate data using raw literature D data.

Parameters:

• mineral (string) –

  The mineral type whose data will be imported. Current options are:

  'apatite' (‘SE15’ reference only)

  'calcite' (all references)

  'dolomite' (‘HH21’ reference only)

• reference (string) –

  The reference whose data will be imported. Current options are:

  'PH12' (Passey and Henkes 2012; model type ‘PH12’)

  'Hea14' (Henkes et al. 2014; model type ‘Hea14’)

  'SE15' (Stolper and Eiler 2015; model type ‘SE15’)

  'Bea18' (Brenner et al. 2018; model type ‘SE15’)

  'HH21' (Hemingway and Henkes 2021; model type ‘HH21’)

  'Lea23_HH21' (Looser et al. 2023, model type ‘HH21’)

  'Lea23_Hea14' (Looser et al. 2023, model type ‘Hea14’)

  'Lea23_SE15' (Looser et al. 2023, model type ‘SE15’)

Returns:

ed – The ipl.EDistribution object containing all the literature data.

Return type:

isotopylog.EDistribution

Raises:

ValueError – If inputted mineral or reference string are not appropriate.

Notes

All rate data within the ed.kds list are reported in units of inverse seconds, independent of the units used in the original publication.

By default, the model type of the generated EDistribution matches the native model type used in each reference. For example, if reference = 'SE15', then ‘SE15’ model types will be generated.

If reference = 'PH12', this also includes Brachiopod data from Hea14 and wet-pressurized optical calicte data from Bea18 analyzed using the PH12 model. However, this excludes NE-CC-1 samples since the reported rate data were split into “labile” and “recalcitrant” fractions and are thus not comparable to other reported data.

If reference = 'Hea14', this also includes the optical calcite data from PH12 analyzed using the Hea14 model, as reported in Henkes et al. (2014).

If reference = 'SE15', this also includes Brachiopod data from Hea14 and optical calcite data from PH12 analyzed using the SE15 model, as reported in Stolper and Eiler 2015.

For Looser et al. (2023) belemnites, reference can be either 'Lea23_HH21', 'Lea23_Hea14', or 'Lea23_SE15', since results for all three models were reported in this study. Note that this study only includes belemnite results, not optical calcites.

Lloyd et al. (2018) do not report calculated rate parameters for individual experiments, only a set of derived activation energy and pre-exponential factor results. This reference is thus not included here; however, dolomite data from Lea18 are included within the HH21 reference.

Examples

Importing all of the calcite data generatd in Passey and Henkes (2012):

#import necessary packages
import isotopylog as ipl

#make EDistribution object
ed = ipl.EDistribution.from_literature(
        mineral = 'calcite',
        reference = 'PH12'
        )

References

[1] Passey and Henkes (2012) Earth Planet. Sci. Lett., 351,

223–236.

[2] Henkes et al. (2014) Geochim. Cosmochim. Ac., 139, 362–382.

[3] Stolper and Eiler (2015) Am. J. Sci., 315, 363–411.

[4] Brenner et al. (2018) Geochim. Cosmochim. Ac., 224, 42–63.

[5] Lloyd et al. (2018) Geochim. Cosmochim. Ac., 242, 1–20.

[6] Hemingway and Henkes (2021) Earth Planet. Sci. Lett., 566,

[7] Looser et al. (2023) Geochim. Cosmochim. Ac., 350, 1–15.