.. auto-generated by dev_tools.docs.nxdl from the NXDL source contributed_definitions/NXapm_paraprobe_config_intersector.nxdl.xml -- DO NOT EDIT .. index:: ! NXapm_paraprobe_config_intersector (application definition) ! apm_paraprobe_config_intersector (application definition) see: apm_paraprobe_config_intersector (application definition); NXapm_paraprobe_config_intersector .. _NXapm_paraprobe_config_intersector: ================================== NXapm_paraprobe_config_intersector ================================== **Status**: application definition, extends :ref:`NXobject` **Description**: Configuration of a paraprobe-intersector tool run in atom probe microscopy. **Symbols**: The symbols used in the schema to specify e.g. dimensions of arrays. **Groups cited**: :ref:`NXcollection`, :ref:`NXcs_profiling`, :ref:`NXentry`, :ref:`NXprocess` .. index:: NXentry (base class); used in application definition, NXprocess (base class); used in application definition, NXcollection (base class); used in application definition, NXcs_profiling (base class); used in application definition **Structure**: .. _/NXapm_paraprobe_config_intersector/ENTRY-group: **ENTRY**: (required) :ref:`NXentry` .. _/NXapm_paraprobe_config_intersector/ENTRY@version-attribute: .. index:: version (group attribute) **@version**: (required) :ref:`NX_CHAR ` Version specifier of this application definition. .. _/NXapm_paraprobe_config_intersector/ENTRY/definition-field: .. index:: definition (field) **definition**: (required) :ref:`NX_CHAR ` Official NeXus NXDL schema with which this file was written. Obligatory value: ``NXapm_paraprobe_config_intersector`` .. _/NXapm_paraprobe_config_intersector/ENTRY/program-field: .. index:: program (field) **program**: (required) :ref:`NX_CHAR ` Given name of the program/software/tool with which this NeXus (configuration) file was generated. .. _/NXapm_paraprobe_config_intersector/ENTRY/program@version-attribute: .. index:: version (field attribute) **@version**: (required) :ref:`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. .. _/NXapm_paraprobe_config_intersector/ENTRY/analysis_identifier-field: .. index:: analysis_identifier (field) **analysis_identifier**: (optional) :ref:`NX_CHAR ` Ideally, a (globally persistent) unique identifier for referring to this analysis. .. _/NXapm_paraprobe_config_intersector/ENTRY/analysis_description-field: .. index:: analysis_description (field) **analysis_description**: (optional) :ref:`NX_CHAR ` Possibility for leaving a free-text description about this analysis. .. _/NXapm_paraprobe_config_intersector/ENTRY/results_path-field: .. index:: results_path (field) **results_path**: (optional) :ref:`NX_CHAR ` Path to the directory where the tool should store NeXus/HDF5 results of this analysis. If not specified results will be stored in the current working directory. .. _/NXapm_paraprobe_config_intersector/ENTRY/time_stamp-field: .. index:: time_stamp (field) **time_stamp**: (required) :ref:`NX_DATE_TIME ` ISO 8601 formatted time code with local time zone offset to UTC information included when this configuration file was created. .. _/NXapm_paraprobe_config_intersector/ENTRY/number_of_processes-field: .. index:: number_of_processes (field) **number_of_processes**: (required) :ref:`NX_UINT ` {units=\ :ref:`NX_UNITLESS `} For now a support field for the tool to identify how many individual analyses the tool should execute as part of the analysis. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation-group: **volume_volume_spatial_correlation**: (required) :ref:`NXprocess` Tracking volume_volume_spatial_correlation is the process of building logical relations between volumetric features based on meshes, their proximity and eventual intersections. Volumetric overlap and proximity of volumetric features is identified for members of sets of features to members of other sets of volumetric features. Specifically, for each time step k pairs of sets are compared: Members of a so-called current_set to members of a so-called next_set. Members can be different types of volumetric features. In the analysis of M. Kuehbach et al. specifically features can be so-called objects (closed non-degnerated polyhedra representing watertight parts of an e.g. iso-surface) and/or proxies. Proxies are computed doppelganger/replacement meshes for parts of an iso-surface which initially were not resulting in watertight meshes because objects at the edge of the dataset or incompletely measured or truncated objects. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/intersection_detection_method-field: .. index:: intersection_detection_method (field) **intersection_detection_method**: (required) :ref:`NX_CHAR ` Specifies the method whereby to decide if two objects intersect volumetrically. For reasons which are detailed in the supplementary material of `M. Kühbach et al. `_, the tool by default assumes that two objects intersect if they share at least one ion with the same evaporation ID (shared_ion). Alternatively, with specifying tetrahedra_intersections, the tool can perform an intersection analysis which attempts to tetrahedralize first each polyhedron. If successful, the tool then checks for at least one pair of intersecting tetrahedra to identify if two objects intersect or not. However, we found that these geometrical analyses can result in corner cases which the currently used library (TetGen) was not unable to tetrahedralize successfully. These cases were virtually always associated with complicated non-convex polyhedra which had portions of the mesh that were connected by almost point like tubes of triangles. Finding more robust methods for computing intersections between not necessarily convex polyhedra might improve the situation in the future. Obligatory value: ``shared_ion`` .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_intersection-field: .. index:: analyze_intersection (field) **analyze_intersection**: (required) :ref:`NX_BOOLEAN ` Specifies if the tool evaluates if for each pair the two objects (and proxies if used) intersect volumetrically. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_proximity-field: .. index:: analyze_proximity (field) **analyze_proximity**: (required) :ref:`NX_BOOLEAN ` Specifies if the tool evaluates if for each pair the two objects (and proxies if used) lie closer to one another than the threshold_proximity. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_coprecipitation-field: .. index:: analyze_coprecipitation (field) **analyze_coprecipitation**: (required) :ref:`NX_BOOLEAN ` Specifies if the tool evaluates, ones all tracking tasks were successfully completed, how intersecting or proximity related objects build sub-graphs. This is the feature which enabled M. Kühbach et al. 2022 the high-throughput analyses of how many objects are coprecipitates in the sense that they are single, duplet, triplet, or high-order. For these analyses to work has_object_volume needs to be activated. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/threshold_proximity-field: .. index:: threshold_proximity (field) **threshold_proximity**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} The maximum Euclidean distance between two objects below which both objects are still considered within proximity. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/has_current_to_next_links-field: .. index:: has_current_to_next_links (field) **has_current_to_next_links**: (required) :ref:`NX_BOOLEAN ` Specifies if the tool stores the so-called forward relations between nodes representing members of the current_set to nodes representing members of the next_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/has_next_to_current_links-field: .. index:: has_next_to_current_links (field) **has_next_to_current_links**: (required) :ref:`NX_BOOLEAN ` Specifies if the tool stores the so-called backward relations between nodes representing members of the next_set to nodes representing members of the current_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set-group: **current_set**: (required) :ref:`NXprocess` Current set stores a set of members, meshes of volumetric features, which will be checked for proximity and/or volumetric intersection, to members of the current_set. The meshes were generated as a result of some other meshing process. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/set_identifier-field: .. index:: set_identifier (field) **set_identifier**: (required) :ref:`NX_UINT ` {units=\ :ref:`NX_ANY `} This identifier can be used to label the current set. The label effectively represents (can be interpreted as) the time/iteration step when the current set was taken. As it is detailed in M. Kühbach et al. 2022, this identifier takes the role of the time variable k. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/number_of_feature_types-field: .. index:: number_of_feature_types (field) **number_of_feature_types**: (required) :ref:`NX_UINT ` {units=\ :ref:`NX_UNITLESS `} The total number of distinguished feature sets FEATURE. It is assumed that the members within all these FEATURE sets are representing a set together. As an example this set might represent all volumetric_features. However, users might have formed a subset of this set where individuals were regrouped. For paraprobe-nanochem this is the case for objects and proxies. Specifically, objects are distinguished further into those far from and those close to the edge of the dataset. Similarly, proxies are distinguished further into those far from and those close to the edge of the dataset. So while these four sub-sets contain different so-called types of features key is that they were all generated for one set, here the current_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE-group: **FEATURE**: (required) :ref:`NXcollection` .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/feature_type-field: .. index:: feature_type (field) **feature_type**: (required) :ref:`NX_CHAR ` Descriptive category explaining what these features are. Any of these values: * ``objects_far_from_edge`` * ``objects_close_to_edge`` * ``proxies_far_from_edge`` * ``proxies_close_to_edge`` .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/filename-field: .. index:: filename (field) **filename**: (required) :ref:`NX_CHAR ` Name of the (NeXus)/HDF5 file which contains triangulated surface meshes of the members of the set as instances of NXcg_polyhedron_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/filename@version-attribute: .. index:: version (field attribute) **@version**: (required) :ref:`NX_CHAR ` Version identifier of the file such as a secure hash which documents the binary state of the file to add an additional layer of reproducibility from which file specifically contains these data. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/groupname_geometry_prefix-field: .. index:: groupname_geometry_prefix (field) **groupname_geometry_prefix**: (required) :ref:`NX_CHAR ` String whereby the path to the geometry data can be interferred automatically. Currently groupname_geometry_prefix/object/polyhedron. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/feature_identifier-field: .. index:: feature_identifier (field) **feature_identifier**: (required) :ref:`NX_UINT ` Array of identifier whereby the path to the geometry data can be interferred automatically. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set-group: **next_set**: (required) :ref:`NXcollection` Next set stores a set of members, meshes of volumetric features, which will be checked for proximity and/or volumetric intersection, to members of the next_set. The meshes were generated as a result of some other meshing process. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/set_identifier-field: .. index:: set_identifier (field) **set_identifier**: (required) :ref:`NX_UINT ` {units=\ :ref:`NX_ANY `} This identifier can be used to label the next_set. The label effectively represents (can be interpreted as) the time/iteration step when the current set was taken. As it is detailed in M. Kühbach et al. 2022, this identifier takes the role of the time variable k+1. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/number_of_feature_types-field: .. index:: number_of_feature_types (field) **number_of_feature_types**: (required) :ref:`NX_UINT ` {units=\ :ref:`NX_UNITLESS `} The total number of distinguished feature sets FEATURE. It is assumed that the members within all these FEATURE sets are representing a set together. As an example this set might represent all volumetric_features. However, users might have formed a subset of this set where individuals were regrouped. For paraprobe-nanochem this is the case for objects and proxies. Specifically, objects are distinguished further into those far from and those close to the edge of the dataset. Similarly, proxies are distinguished further into those far from and those close to the edge of the dataset. So while these four sub-sets contain different so-called types of features key is that they were all generated for one set, here the next_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE-group: **FEATURE**: (required) :ref:`NXcollection` .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/feature_type-field: .. index:: feature_type (field) **feature_type**: (required) :ref:`NX_CHAR ` Descriptive category explaining what these features are. Any of these values: * ``objects_far_from_edge`` * ``objects_close_to_edge`` * ``proxies_far_from_edge`` * ``proxies_close_to_edge`` .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/filename-field: .. index:: filename (field) **filename**: (required) :ref:`NX_CHAR ` Name of the (NeXus)/HDF5 file which contains triangulated surface meshes of the members of the set as instances of NXcg_polyhedron_set. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/filename@version-attribute: .. index:: version (field attribute) **@version**: (required) :ref:`NX_CHAR ` Version identifier of the file such as a secure hash which documents the binary state of the file to add an additional layer of reproducibility from which file specifically contains these data. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/groupname_geometry_prefix-field: .. index:: groupname_geometry_prefix (field) **groupname_geometry_prefix**: (required) :ref:`NX_CHAR ` String whereby the path to the geometry data can be interferred automatically. Currently groupname_geometry_prefix/object/polyhedron. .. _/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/feature_identifier-field: .. index:: feature_identifier (field) **feature_identifier**: (required) :ref:`NX_UINT ` Array of identifier whereby the path to the geometry data can be interferred automatically. .. _/NXapm_paraprobe_config_intersector/ENTRY/performance-group: **performance**: (required) :ref:`NXcs_profiling` .. _/NXapm_paraprobe_config_intersector/ENTRY/performance/current_working_directory-field: .. index:: current_working_directory (field) **current_working_directory**: (required) :ref:`NX_CHAR ` Hypertext Anchors ----------------- List of hypertext anchors for all groups, fields, attributes, and links defined in this class. * :ref:`/NXapm_paraprobe_config_intersector/ENTRY-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/analysis_description-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/analysis_identifier-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/definition-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/number_of_processes-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/performance-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/performance/current_working_directory-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/program-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/program@version-attribute ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/results_path-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/time_stamp-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_coprecipitation-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_intersection-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/analyze_proximity-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/feature_identifier-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/feature_type-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/filename-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/filename@version-attribute ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/FEATURE/groupname_geometry_prefix-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/number_of_feature_types-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/current_set/set_identifier-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/has_current_to_next_links-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/has_next_to_current_links-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/intersection_detection_method-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE-group ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/feature_identifier-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/feature_type-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/filename-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/filename@version-attribute ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/FEATURE/groupname_geometry_prefix-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/number_of_feature_types-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/next_set/set_identifier-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY/volume_volume_spatial_correlation/threshold_proximity-field ` * :ref:`/NXapm_paraprobe_config_intersector/ENTRY@version-attribute ` **NXDL Source**: https://github.com/nexusformat/definitions/blob/main/contributed_definitions/NXapm_paraprobe_config_intersector.nxdl.xml