NXion

Status:

base class, extends NXobject

Description:

Atomic architecture of a (molecular) ion (fragment) which can be used for example to label charged molecule ions identified from mass-to-charge histogram data as appearing as signal in e.g. time-resolved mass spectrometry techniques like atom probe or secondary ion mass spectrometry.

Symbols:

The symbols used in the schema to specify e.g. dimensions of arrays.

Nivecmax

Nranges

Groups cited:

none

Structure:

ion_type: (optional) NX_UINT {units=NX_UNITLESS}

Ion type aka ion species identifier. The identifier zero is reserved for the special ion type unknown ion type.

isotope_vector[Nivecmax]: (optional) NX_UINT {units=NX_UNITLESS}

A vector of ordered isotope hash values. The values have to be arranged in the array in decreasing order. The array is filled with zero hash values indicating unused places. The individual hash values are built with the following hash function. Hashvalue = Z + N*256 where Z is the number of protons and N the number of neutrons of the isotope. Z and N have to be 8-bit unsigned integers for this hash function to work.

charge_state: (optional) NX_INT {units=NX_DIMENSIONLESS}

Signed charge of the ion in multiples of the elementary electron charge. Only positive values will be measured in atom probe microscopy as the ions are accelerated by a negatively signed bias electric field. In the case the charge state is not recoverable explicitly, the value should be set to zero. This is for example the case when using classical range file formats (RNG, RRNG) because for atom probe microscopy these files do not document the charge state explicitly but report just a integer fraction of the theoretical mass-to-charge-state-ratios.

name: (optional) NX_CHAR

Human-readable ion type name (e.g. Al3+), i.e. ASCII UTF-8 character array, ideally using LaTeX notation to specify the ion and charge state. Examples 12C+, Al3+ or H+. Although human-readable and intuitive, parsing such names becomes impractical for more complicated cases. Therefore, the isotope_vector is the preferred machine-readable format.

mass_to_charge_range[2, Nranges]: (optional) NX_FLOAT {units=NX_ANY}

Lower (mqmin) and upper (mqmax) bounds of a mass-to-charge interval [mqmin, mqmax] (boundaries included) where assigned signal for the respective ion is labelled as this ion.

Hypertext Anchors

Table of hypertext anchors for all groups, fields, attributes, and links defined in this class.

documentation (reST source) anchor

web page (HTML) anchor

/NXion/charge_state-field

#nxion-charge-state-field

/NXion/ion_type-field

#nxion-ion-type-field

/NXion/isotope_vector-field

#nxion-isotope-vector-field

/NXion/mass_to_charge_range-field

#nxion-mass-to-charge-range-field

/NXion/name-field

#nxion-name-field

NXDL Source:

https://github.com/FAIRmat-Experimental/nexus_definitions/tree/fairmat/base_classes/NXion.nxdl.xml