.. auto-generated by dev_tools.docs.nxdl from the NXDL source base_classes/NXapm_ranging.nxdl.xml -- DO NOT EDIT .. index:: ! NXapm_ranging (base class) ! apm_ranging (base class) see: apm_ranging (base class); NXapm_ranging .. _NXapm_ranging: ============= NXapm_ranging ============= **Status**: base class, extends :ref:`NXprocess` **Description**: .. collapse:: Base class for the configuration and results of ranging definitions. ... Base class for the configuration and results of ranging definitions. Ranging is a data post-processing step used in the research field of atom probe during which elemental, isotopic, and/or molecular identities are assigned to mass-to-charge-state ratios within certain intervals. The documentation of these steps is based on ideas that have been described in the literature: * `M. K. Miller `_ * `D. Haley et al. `_ * `M. Kühbach et al. `_ **Symbols**: No symbol table **Groups cited**: :ref:`NXatom`, :ref:`NXdata`, :ref:`NXnote`, :ref:`NXpeak`, :ref:`NXprocess`, :ref:`NXprogram` .. index:: NXprogram (base class); used in base class, NXnote (base class); used in base class, NXprocess (base class); used in base class, NXdata (base class); used in base class, NXpeak (base class); used in base class, NXatom (base class); used in base class **Structure**: .. _/NXapm_ranging/PROGRAM-group: :bolditalic:`PROGRAM`: (optional) :ref:`NXprogram` .. _/NXapm_ranging/NOTE-group: :bolditalic:`NOTE`: (optional) :ref:`NXnote` :ref:`⤆ ` .. _/NXapm_ranging/mass_to_charge_distribution-group: **mass_to_charge_distribution**: (optional) :ref:`NXprocess` Specifies the mass-to-charge-state ratio histogram. .. _/NXapm_ranging/mass_to_charge_distribution/min_mass_to_charge-field: .. index:: min_mass_to_charge (field) **min_mass_to_charge**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANY `} .. collapse:: Smallest :math:`{\frac{m}{q}}_{min}` mass-to-charge-state ratio value. ... Smallest :math:`{\frac{m}{q}}_{min}` mass-to-charge-state ratio value. The lower (left-hand side) inclusive bound of the interval :math:`[{\frac{m}{q}}_{min}, {\frac{m}{q}}_{max}]`. .. _/NXapm_ranging/mass_to_charge_distribution/max_mass_to_charge-field: .. index:: max_mass_to_charge (field) **max_mass_to_charge**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANY `} .. collapse:: Largest :math:`{\frac{m}{q}}_{max}` mass-to-charge-state ratio value. ... Largest :math:`{\frac{m}{q}}_{max}` mass-to-charge-state ratio value. The upper (right-hand side) inclusive bound of the interval :math:`[{\frac{m}{q}}_{min}, {\frac{m}{q}}_{max}]`. .. _/NXapm_ranging/mass_to_charge_distribution/n_mass_to_charge-field: .. index:: n_mass_to_charge (field) **n_mass_to_charge**: (optional) :ref:`NX_POSINT ` {units=\ :ref:`NX_UNITLESS `} .. collapse:: The number of bins on the interval :math:`[{\frac{m}{q}}_{min}, ... The number of bins on the interval :math:`[{\frac{m}{q}}_{min}, {\frac{m}{q}}_{max}]`. .. _/NXapm_ranging/mass_to_charge_distribution/PROGRAM-group: :bolditalic:`PROGRAM`: (optional) :ref:`NXprogram` .. _/NXapm_ranging/mass_to_charge_distribution/mass_spectrum-group: **mass_spectrum**: (optional) :ref:`NXdata` :ref:`⤆ ` .. collapse:: A default histogram aka mass spectrum of ... A default histogram aka mass spectrum of the mass-to-charge-state ratio values. .. _/NXapm_ranging/background_quantification-group: **background_quantification**: (optional) :ref:`NXprocess` .. collapse:: Details of the background model that was used to ... Details of the background model that was used to correct the total counts per bin into counts. .. _/NXapm_ranging/background_quantification/description-field: .. index:: description (field) **description**: (optional) :ref:`NX_CHAR ` .. collapse:: Free-text field to describe how atom probers define a background model. ... Free-text field to describe how atom probers define a background model. Thereby, community feedback can be collected to inform an improved version of this base class in the future. .. _/NXapm_ranging/background_quantification/PROGRAM-group: :bolditalic:`PROGRAM`: (optional) :ref:`NXprogram` .. _/NXapm_ranging/peak_search_and_deconvolution-group: **peak_search_and_deconvolution**: (optional) :ref:`NXprocess` How were peaks in the mass-to-charge-state ratio histogram identified. .. _/NXapm_ranging/peak_search_and_deconvolution/PROGRAM-group: :bolditalic:`PROGRAM`: (optional) :ref:`NXprogram` .. _/NXapm_ranging/peak_search_and_deconvolution/PEAK-group: :bolditalic:`PEAK`: (optional) :ref:`NXpeak` .. _/NXapm_ranging/peak_identification-group: **peak_identification**: (optional) :ref:`NXprocess` .. collapse:: Details about how peaks, with taking into account ... Details about how peaks, with taking into account error models, were interpreted as ion types or not. .. _/NXapm_ranging/peak_identification/number_of_ion_types-field: .. index:: number_of_ion_types (field) **number_of_ion_types**: (optional) :ref:`NX_UINT ` {units=\ :ref:`NX_UNITLESS `} .. collapse:: How many ion types are distinguished. If no ranging was performed, each ... How many ion types are distinguished. If no ranging was performed, each ion is of the special unknown type. The iontype ID of this unknown type is 0 representing a reserved value. Consequently, start counting iontypes from 1. .. _/NXapm_ranging/peak_identification/maximum_number_of_atoms_per_molecular_ion-field: .. index:: maximum_number_of_atoms_per_molecular_ion (field) **maximum_number_of_atoms_per_molecular_ion**: (optional) :ref:`NX_UINT ` {units=\ :ref:`NX_UNITLESS `} .. collapse:: Assumed maximum value that suffices to store all relevant molecular ions, ... Assumed maximum value that suffices to store all relevant molecular ions, even the most complicated ones that one can typically observe and distinguish typically. Currently, a value of 32 is used (see M. Kühbach et al. `_). .. _/NXapm_ranging/peak_identification/PROGRAM-group: :bolditalic:`PROGRAM`: (optional) :ref:`NXprogram` .. _/NXapm_ranging/peak_identification/ATOM-group: :bolditalic:`ATOM`: (optional) :ref:`NXatom` Hypertext Anchors ----------------- List of hypertext anchors for all groups, fields, attributes, and links defined in this class. * :ref:`/NXapm_ranging/background_quantification-group ` * :ref:`/NXapm_ranging/background_quantification/description-field ` * :ref:`/NXapm_ranging/background_quantification/PROGRAM-group ` * :ref:`/NXapm_ranging/mass_to_charge_distribution-group ` * :ref:`/NXapm_ranging/mass_to_charge_distribution/mass_spectrum-group ` * :ref:`/NXapm_ranging/mass_to_charge_distribution/max_mass_to_charge-field ` * :ref:`/NXapm_ranging/mass_to_charge_distribution/min_mass_to_charge-field ` * :ref:`/NXapm_ranging/mass_to_charge_distribution/n_mass_to_charge-field ` * :ref:`/NXapm_ranging/mass_to_charge_distribution/PROGRAM-group ` * :ref:`/NXapm_ranging/NOTE-group ` * :ref:`/NXapm_ranging/peak_identification-group ` * :ref:`/NXapm_ranging/peak_identification/ATOM-group ` * :ref:`/NXapm_ranging/peak_identification/maximum_number_of_atoms_per_molecular_ion-field ` * :ref:`/NXapm_ranging/peak_identification/number_of_ion_types-field ` * :ref:`/NXapm_ranging/peak_identification/PROGRAM-group ` * :ref:`/NXapm_ranging/peak_search_and_deconvolution-group ` * :ref:`/NXapm_ranging/peak_search_and_deconvolution/PEAK-group ` * :ref:`/NXapm_ranging/peak_search_and_deconvolution/PROGRAM-group ` * :ref:`/NXapm_ranging/PROGRAM-group ` **NXDL Source**: https://github.com/FAIRmat-NFDI/nexus_definitions/tree/fairmat/base_classes/NXapm_ranging.nxdl.xml