pdg.measurement module

class pdg.measurement.PdgFootnote(api, foot_id)[source]

Bases: object

Class for footnotes associated with PdgReferences.

references()[source]: Returns an iterator of PdgReferences that refer to this footnote.

property text: The footnote text, in plain text format.

class pdg.measurement.PdgMeasurement(api, msmt_id)[source]

Bases: object

Class for an individual measurement from the PDG Listings.

property changebar: True if this measurement has been added or updated since the previous PDG edition

property charge: Case-specific representation of the charge(s) of the particles involved in this measurement.

property comment: Inline comment displayed with this measurement in the PDG Listings.

property confidence_level: The confidence level of this measurement.

property event_count: The number of events in the sample used for this measurement.

footnotes()[source]: Returns an iterator of PdgFootnotes for this measurements.

get_value()[source]: Returns the PdgValue associated with this measurement. Raises PdgAmbiguousValueError if there are multiple values (i.e. this is a multi-column measurement).

property pdgid: The PDG Identifier to which this measurement applies.

property reference: The PdgReference associated with this measurement.

property technique: The technique used in this measurement.

values()[source]: Returns a iterator of PdgValues for all of the quanities associated with this measurement.

class pdg.measurement.PdgReference(api, ref_id)[source]

Bases: object

Class for literature references associated with PdgMeasurements.

property document_id: The identifier for this publication in AUTHOR YEAR format.

property doi: The DOI of this publication.

property inspire_id: The INSPIRE identifier of this publication.

property publication_name: The abbreviated bibliographic name (e.g. journal initials, issue, page) of this publication.

property publication_year: The year of this publication.

property title: The title of this publication.

class pdg.measurement.PdgValue(api, value_id)[source]

Bases: object

Class for an individual numerical value associated with a PdgMeasurement.

property column_name: The name of the column (in plain text format) in which this value is displayed in the PDG Listings.

property column_name_tex: The name of the column (in TeX format) in which this value is displayed in the PDG Listings.

property display_in_percent: True if value is rendered in percent for display in Listings. Implies that display_power_of_ten is -2.

property display_power_of_ten: Unit multiplier (as power of ten) as used for display in Listings.

property display_value_text: Value and uncertainty in plain text format as displayed in Listings tables. Does not include any power of ten or percent sign. Must be combined with the display_power_of_ten property in order to obtain the numerical value in units given by the property units.

property error: The total symmetric error for this value. If the positive and negative errors differ, accessing this property will give the average of the two, unless you are in pedantic mode, in which case a PdgAmibguousValueError will be raised.

property error_negative: The total negative error for this value.

property error_positive: The total positive error for this value.

property is_limit: True if value is a limit.

property is_lower_limit: True if value is a lower limit.

property is_upper_limit: True if value is an upper limit.

property measurement: The corresponding PdgMeasurement for this value.

property stat_error: The statistical symmetric error for this value. If the positive and negative statistical errors differ, accessing this property will give the average of the two, unless you are in pedantic mode, in which case a PdgAmibguousValueError will be raised.

property stat_error_negative: The statistical component of the negative error for this value.

property stat_error_positive: The statistical component of the positive error for this value.

property syst_error: The systematic symmetric error for this value. If the positive and negative systematic errors differ, accessing this property will give the average of the two, unless you are in pedantic mode, in which case a PdgAmibguousValueError will be raised.

property syst_error_negative: The systematic component of the negative error for this value.

property syst_error_positive: The systematic component of the positive error for this value.

property unit_text: The units (in plain text format) in which this value is specified.

property used_in_average: True if value is used for calculating averages shown in Summary Tables.

property used_in_fit: True if value is used for calculating best-fits shown in Summary Tables.

property value: The numerical value itself.

property value_text: Value and uncertainty (in plain text format) in units given by property units, including the power of ten, if applicable (see display_power_of_ten)