NXapm_paraprobe_config_ranger¶
Status:
application definition, extends NXobject
Description:
Configuration of a paraprobe-ranger tool run in atom probe microscopy.
Symbols:
The symbols used in the schema to specify e.g. dimensions of arrays.
n_isotopes: The number of isotopes to consider as building blocks for searching molecular ions.
n_composition: The number of compositions to consider for molecular ion search tasks.
- Groups cited:
NXapm_input_ranging, NXapm_input_reconstruction, NXcg_cylinder_set, NXcg_ellipsoid_set, NXcg_face_list_data_structure, NXcg_hexahedron_set, NXcs_filter_boolean_mask, NXentry, NXmatch_filter, NXprocess, NXspatial_filter, NXsubsampling_filter
Structure:
ENTRY: (required) NXentry
@version: (required) NX_CHAR
Version specifier of this application definition.
definition: (required) NX_CHAR
Official NeXus NXDL schema with which this file was written.
Obligatory value:
NXapm_paraprobe_config_ranger
program: (required) NX_CHAR
Given name of the program/software/tool with which this NeXus (configuration) file was generated.
@version: (required) NX_CHAR
Ideally program version plus build number, or commit hash or description of ever persistent resources where the source code of the program and build instructions can be found so that the program can be configured ideally in such a manner that the result of this computational process is recreatable in the same deterministic manner.
time_stamp: (required) NX_DATE_TIME
ISO 8601 formatted time code with local time zone offset to UTC information included when this configuration file was created.
analysis_identifier: (optional) NX_CHAR
Ideally, a (globally persistent) unique identifier for referring to this analysis.
analysis_description: (optional) NX_CHAR
Possibility for leaving a free-text description about this analysis.
number_of_processes: (required) NX_UINT {units=NX_UNITLESS}
How many task to perform?
PROCESS: (optional) NXprocess
number_of_ranging_processes: (required) NX_UINT {units=NX_UNITLESS}
How many range_with_existent_iontypes processes should the tool execute as part of the analysis.
number_of_ion_search_processes: (required) NX_UINT {units=NX_UNITLESS}
How many molecular_ion_search processes should the tool execute as part of the analysis.
range_with_existent_iontypes: (optional) NXprocess
dataset: (required) NXapm_input_reconstruction
iontypes: (required) NXapm_input_ranging
spatial_filter: (optional) NXspatial_filter
windowing_method: (required) NX_CHAR
CG_ELLIPSOID_SET: (optional) NXcg_ellipsoid_set
CG_CYLINDER_SET: (optional) NXcg_cylinder_set
CG_HEXAHEDRON_SET: (optional) NXcg_hexahedron_set
dimensionality: (required) NX_POSINT
cardinality: (required) NX_POSINT
identifier_offset: (required) NX_INT
hexahedra: (required) NXcg_face_list_data_structure
CS_FILTER_BOOLEAN_MASK: (optional) NXcs_filter_boolean_mask
evaporation_id_filter: (optional) NXsubsampling_filter
iontype_filter: (optional) NXmatch_filter
hit_multiplicity_filter: (optional) NXmatch_filter
molecular_ion_search: (optional) NXprocess
assumed_composition_isotopes: (required) NX_UINT (Rank: 2, Dimensions: [n_composition, 2]) {units=NX_UNITLESS}
A list of pairs of number of protons and either the value 0 (per row) or the mass number for all those isotopes which are assumed present in a virtual specimen. The purpose of this field is to compute also composition-weighted products to yield a simple estimation which could potentially help scientists to judge if certain molecular ions are to be expected. The corresponding setting store_composition_weighted_product should be activated.
isotope_whitelist: (required) NX_UINT (Rank: 2, Dimensions: [n_isotopes, 2]) {units=NX_UNITLESS}
A list of pairs of number of protons and mass number for all isotopes to consider that can be composed into (molecular) ions, during the recursive molecular_ion_search.
mass_to_charge_interval: (required) NX_FLOAT (Rank: 1, Dimensions: [2]) {units=NX_ANY}
The mass-to-charge-state ratio interval in which all molecular ions are searched.
maximum_charge: (required) NX_UINT {units=NX_UNITLESS}
The maximum charge that a molecular ion should have.
maximum_number_of_isotopes: (required) NX_UINT {units=NX_UNITLESS}
The maximum number of isotopes of which the molecular ion should be composed. Currently this must not be larger than 32.
Users should be warned that the larger the maximum_charge and especially the larger the maximum_number_of_isotopes is chosen, the eventually orders of magnitude more costly the search becomes.
This is because paraprobe-ranger computes really all (at least) theoretically possible combinations that would have likely a mass-to-charge-state ratio in the specified mass_to_charge_interval. It is the challenge in atom probe to judge which of these (molecular) ions are feasible and also practically possible. This tool does not answer this question.
Namely, which specific molecular ion will evaporate, remain stable during flight and becomes detected is a complicated and in many cases not yet in detail understood phenomenon. The ab-initio conditions before and during launch, the local environment, arrangement and field as well as the flight phase in an evacuated but not analysis chamber with a complex electrical field, eventual laser pulsing in place, temperature and remaining atoms or molecules all can have an effect which iontypes are really physically evaporating and detected.
store_atomic_mass_sum: (required) NX_BOOLEAN
Report the accumulated atomic mass from each isotope building the ion. Accounts for each identified ion. Relatistic effects are not accounted for.
store_natural_abundance_product: (required) NX_BOOLEAN
Report the product of the natural abundances from each isotope building the ion. Accounts for each identified ion.
The value zero indicates it is not possible to build such molecular ion from nuclids which are all observationally stable. Very small values can give an idea/about how likely such a molecular ion is expected to form assuming equal probabilities.
However in atom probe experiments this product has to be modified by the (spatially-correlated) local composition in the region from which the ions launch because the formation of a molecular ion depends as summarized under maximum_number_of_isotopes on the specific quantum-mechanical configuration and field state upon launch or/and (early state) of flight respectively. We are aware that this modified product can have a substantially different value than the natural_abundance_product.
Natural abundancies folded with the estimated compositions of the specimen can differ by orders of magnitude.
store_charge_state: (required) NX_BOOLEAN
Report the charge state of the ions.
store_disjoint_isotopes: (required) NX_BOOLEAN
Report if identified ions should be characterized wrt to their number of disjoint isotopes.
Hypertext Anchors¶
List of hypertext anchors for all groups, fields, attributes, and links defined in this class.
/NXapm_paraprobe_config_ranger/ENTRY/analysis_description-field
/NXapm_paraprobe_config_ranger/ENTRY/analysis_identifier-field
/NXapm_paraprobe_config_ranger/ENTRY/number_of_processes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search-group
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/assumed_composition_isotopes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/isotope_whitelist-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/mass_to_charge_interval-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/maximum_charge-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/maximum_number_of_isotopes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/store_atomic_mass_sum-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/store_charge_state-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/molecular_ion_search/store_disjoint_isotopes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/number_of_ion_search_processes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/number_of_ranging_processes-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes-group
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/dataset-group
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/dataset/filename-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/iontype_filter-group
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/iontypes-group
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/iontypes/filename-field
/NXapm_paraprobe_config_ranger/ENTRY/PROCESS/range_with_existent_iontypes/spatial_filter-group
/NXapm_paraprobe_config_ranger/ENTRY/program@version-attribute