2.3.3.3.42. NXapm_paraprobe_transcoder_results¶
Status:
application definition, extends NXobject
Description:
Application definition for results files of the paraprobe-transcoder tool. ...
Application definition for results files of the paraprobe-transcoder tool.
This tool is part of the paraprobe-toolbox. Inspect the base class NXapm_paraprobe_tool_results. The purpose and need of the paraprobe-transcoder tool is to create a standardized representation of reconstructed position and mass-to-charge-state-ratio values surplus other pieces of information to enable working with atom probe data in reconstruction space in the paraprobe-toolbox. This includes ranging definitions which map mass-to-charge-state ratio values onto iontypes.
So far the atom probe community has not yet agreed upon a comprehensive standardization on how to exchange information especially when it comes to the communication of configurations and results from analyses of atom probe data. Instead, different simplistic file formats are used, such as POS, ePOS, APT, or RNG and RRNG. None of these formats, though, are self-descriptive, standardize, or document their origin and thus the sequence in which the file was generated during an analysis.
Paraprobe-transcoder solves this limitation by interpreting the information content in such files and standardize the representation prior injection into the scientific data analysis tools of the toolbox. Therefore, the here proposed set of NeXus base classes and application definitions can be a useful starting point for the atom probe community to take advantage of standardized information exchange and improve the here proposed classes and concepts to become more inclusive.
Paraprobe-transcoder uses a Python library developed based on efforts by members of the global atom probe community International Field Emission Society (IFES) Atom Probe Technical Committee (APT TC). This library offers the actual low-level I/O operations and respective information interpretation of above-mentioned file formats.
Symbols:
The symbols used in the schema to specify e.g. dimensions of arrays.
n_ions: The total number of ions in the reconstruction.
n_ivec_max: Maximum number of allowed atoms per (molecular) ion (fragment). Needs to match maximum_number_of_atoms_per_molecular_ion.
n_topology: Total number of integers in the supplementary XDMF topology array.
n_variable: Number of entries
- Groups cited:
NXapm_paraprobe_tool_common, NXapm_paraprobe_tool_results, NXcoordinate_system_set, NXcoordinate_system, NXcs_filter_boolean_mask, NXcs_profiling, NXentry, NXion, NXprocess, NXprogram, NXserialized, NXuser
Structure:
ENTRY: (required) NXentry
definition: (required) NX_CHAR ⤆
atom_probe: (required) NXapm_paraprobe_tool_results
analysis_identifier: (required) NX_UINT
config: (required) NXserialized
window: (optional) NXcs_filter_boolean_mask ⤆
mass_to_charge_conversion: (required) NXprocess
reconstruction: (required) NXprocess
reconstructed_positions: (required) NX_FLOAT (Rank: 2, Dimensions: [n_ions, 3]) {units=NX_LENGTH}
Three-dimensional reconstructed positions of the ions. ...
Three-dimensional reconstructed positions of the ions. Interleaved array of x, y, z positions in the specimen space.
@depends_on: (required) NX_CHAR
Defines in which reference frame the positions are defined.
visualization: (recommended) NXprocess
xdmf_topology: (required) NX_UINT (Rank: 1, Dimensions: [n_topology]) {units=NX_UNITLESS}
An array of triplets of integers which can serve as a supplementary ...
An array of triplets of integers which can serve as a supplementary array for Paraview to display the reconstruction. The XDMF datatype is here 1, the number of primitives 1 per triplet, the last integer in each triplet is the identifier of each point starting from zero.
ranging: (required) NXprocess
peak_identification: (required) NXprocess
common: (required) NXapm_paraprobe_tool_common
analysis_identifier: (required) NX_UINT ⤆
config: (required) NXserialized ⤆
programID: (required) NXprogram ⤆
profiling: (recommended) NXcs_profiling ⤆
coordinate_system_set: (required) NXcoordinate_system_set ⤆
paraprobe: (required) NXcoordinate_system ⤆
Hypertext Anchors¶
List of hypertext anchors for all groups, fields, attributes, and links defined in this class.
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/analysis_identifier-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/config-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/config/algorithm-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/config/checksum-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/config/path-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/config/type-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/mass_to_charge_conversion-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/mass_to_charge_conversion/mass_to_charge-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/ranging-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/ranging/peak_identification-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/ranging/peak_identification/ION-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/reconstruction-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/reconstruction/reconstructed_positions-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/reconstruction/visualization-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/window-group
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/window/bitdepth-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/window/mask-field
/NXapm_paraprobe_transcoder_results/ENTRY/atom_probe/window/number_of_ions-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/analysis_identifier-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/config-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/config/algorithm-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/config/checksum-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/config/path-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/config/type-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe/handedness-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe/type-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe/x-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe/y-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/coordinate_system_set/paraprobe/z-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/current_working_directory-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/end_time-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/number_of_gpus-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/number_of_processes-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/number_of_threads-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/start_time-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/profiling/total_elapsed_time-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/programID-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/programID/program-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/programID/program@version-attribute
/NXapm_paraprobe_transcoder_results/ENTRY/common/status-field
/NXapm_paraprobe_transcoder_results/ENTRY/common/userID-group
/NXapm_paraprobe_transcoder_results/ENTRY/common/userID/name-field
/NXapm_paraprobe_transcoder_results/ENTRY/definition@version-attribute