.. auto-generated by dev_tools.docs.nxdl from the NXDL source contributed_definitions/NXspm_scan_control.nxdl.xml -- DO NOT EDIT .. index:: ! NXspm_scan_control (base class) ! spm_scan_control (base class) see: spm_scan_control (base class); NXspm_scan_control .. _NXspm_scan_control: ================== NXspm_scan_control ================== **Status**: *base class* (contribution), extends :ref:`NXobject` **Description**: .. collapse:: A scan is performed inside an N-dimensional phase space, where each dimension ca ... A scan is performed inside an N-dimensional phase space, where each dimension can correspond not only to real space coordinates (x,y) but also to any other parameter. This class contains detailed information about controlling the scan in such a phase space (or its subspace). scan_types: Trajectory: A list of N-dimensional sequential vectors describes the trajectory line for a full scan. Mesh: For each dimension a range and a direction are chosen. When a scan along a dimension is done, a single step in the next dimension is taken, and then the scan in the previous dimension is repeated. As such we can speak about the fastest and the slowest scan axes. Snake: Similar to a mesh scan but with the scanning direction reversed after each line. Spiral: A scan taken along a spiral trajectory. Linear: A scan where the scanning will be performed along a single independent axis. Tilt: At each step, a proportional movement is done in all dimensions (an special case of Trajectory scan). Scan_control_types: Stepping: At each step, a movement to the next point is performed; correction (for example backlash) or active regulation (feedback loop) may or may not be applied. After the movement is done, the measurement is performed without the movement. Continuous: The scanning of each line in an N-dimensional phase space is done without stopping; measurements are done simultaneously with the movement. Oscillating: Scanning over a scan point continuously and then moving to start scanning at the next position. **Symbols**: No symbol table **Groups cited**: :ref:`NXspm_scan_pattern`, :ref:`NXspm_scan_region` .. index:: NXspm_scan_region (base class); used in base class, NXspm_scan_pattern (base class); used in base class **Structure**: .. _/NXspm_scan_control/scan_time_start-field: .. index:: scan_time_start (field) **scan_time_start**: (optional) :ref:`NX_DATE_TIME ` {units=\ :ref:`NX_TIME `} The start time of the scan. .. _/NXspm_scan_control/scan_time_end-field: .. index:: scan_time_end (field) **scan_time_end**: (optional) :ref:`NX_DATE_TIME ` {units=\ :ref:`NX_TIME `} The end time of the scan. .. _/NXspm_scan_control/independent_scan_axes-field: .. index:: independent_scan_axes (field) **independent_scan_axes**: (optional) :ref:`NX_CHAR ` .. collapse:: An array of scan axes which are controlled independently of each other. ... An array of scan axes which are controlled independently of each other. (e.g. X, Y, Z, or other physical dimensions) The array elements are in the order of axes of the scan from the fastest to the slowest. .. _/NXspm_scan_control/scan_resolutionN-field: .. index:: scan_resolutionN (field) **scan_resolution**\ :bolditalic:`N`: (optional) :ref:`NX_NUMBER ` {units=\ :ref:`NX_ANY `} .. collapse:: Define the scan resolution along each dimension as the number of steps per uni ... Define the scan resolution along each dimension as the number of steps per unit of the dimension parameters. Rename the field according to the name of the independent dimension (e.g. scan_resolution_x, scan_resolution_voltage). .. _/NXspm_scan_control/accuracyN-field: .. index:: accuracyN (field) **accuracy**\ :bolditalic:`N`: (optional) :ref:`NX_NUMBER ` {units=\ :ref:`NX_LENGTH `} Define the accuracy of the scan probe. .. _/NXspm_scan_control/scan_type-field: .. index:: scan_type (field) **scan_type**: (optional) :ref:`NX_CHAR ` .. collapse:: This group specifies how the trajectory of the scan is defined. ... This group specifies how the trajectory of the scan is defined. Any of these values: * ``trajectory`` * ``mesh`` * ``snake`` * ``spiral`` * ``linear`` * ``tilt`` .. _/NXspm_scan_control/scan_control_type-field: .. index:: scan_control_type (field) **scan_control_type**: (optional) :ref:`NX_CHAR ` .. collapse:: This string describes how the scan was performed. ... This string describes how the scan was performed. Any of these values: ``stepping`` | ``continuous`` | ``oscillating`` .. _/NXspm_scan_control/scan_region-group: **scan_region**: (optional) :ref:`NXspm_scan_region` .. collapse:: The scan region is the area of phase space or sub-phase space where the scan i ... The scan region is the area of phase space or sub-phase space where the scan is performed. The region could be N-dimensional and is defined by the minimum and maximum values of the scan axes. .. _/NXspm_scan_control/meshSCAN-group: **mesh**\ :bolditalic:`SCAN`: (optional) :ref:`NXspm_scan_pattern` .. collapse:: For each dimension a range and a direction are chosen. When a scan along a dim ... For each dimension a range and a direction are chosen. When a scan along a dimension is done, a single step in the next dimension is taken, and then the scan in the previous dimension is repeated. As such we can speak about the fastest and the slowest scan axes. .. _/NXspm_scan_control/spiralSCAN-group: **spiral**\ :bolditalic:`SCAN`: (optional) :ref:`NXspm_scan_pattern` To define the spiral or circular scan, use this group. .. _/NXspm_scan_control/spiralSCAN/spiral_radiusN-field: .. index:: spiral_radiusN (field) **spiral_radius**\ :bolditalic:`N`: (optional) :ref:`NX_NUMBER ` {units=\ :ref:`NX_ANY `} :ref:`⤆ ` .. collapse:: Define the radius of the spiral circle of scanning. ... Define the radius of the spiral circle of scanning. Rename the field, according to the circle order, the nearest circle to the center is 0. .. _/NXspm_scan_control/spiralSCAN/scan_pointsN-field: .. index:: scan_pointsN (field) **scan_points**\ :bolditalic:`N`: (optional) :ref:`NX_NUMBER ` :ref:`⤆ ` .. collapse:: Define the total number of points in a given circle scan to be performed. ... Define the total number of points in a given circle scan to be performed. Rename the field, according to the circle order, the nearest circle to the center is 0 (e.g. scan_points_2). .. _/NXspm_scan_control/snakeSCAN-group: **snake**\ :bolditalic:`SCAN`: (optional) :ref:`NXspm_scan_pattern` To define the snake scan, use this group. .. _/NXspm_scan_control/trajSCAN-group: **traj**\ :bolditalic:`SCAN`: (optional) :ref:`NXspm_scan_pattern` To define the trajectory scan, use this group. .. _/NXspm_scan_control/linearSCAN-group: **linear**\ :bolditalic:`SCAN`: (optional) :ref:`NXspm_scan_pattern` To define the linear scan, use this group. Hypertext Anchors ----------------- List of hypertext anchors for all groups, fields, attributes, and links defined in this class. * :ref:`/NXspm_scan_control/accuracyN-field ` * :ref:`/NXspm_scan_control/independent_scan_axes-field ` * :ref:`/NXspm_scan_control/linearSCAN-group ` * :ref:`/NXspm_scan_control/meshSCAN-group ` * :ref:`/NXspm_scan_control/scan_control_type-field ` * :ref:`/NXspm_scan_control/scan_region-group ` * :ref:`/NXspm_scan_control/scan_resolutionN-field ` * :ref:`/NXspm_scan_control/scan_time_end-field ` * :ref:`/NXspm_scan_control/scan_time_start-field ` * :ref:`/NXspm_scan_control/scan_type-field ` * :ref:`/NXspm_scan_control/snakeSCAN-group ` * :ref:`/NXspm_scan_control/spiralSCAN-group ` * :ref:`/NXspm_scan_control/spiralSCAN/scan_pointsN-field ` * :ref:`/NXspm_scan_control/spiralSCAN/spiral_radiusN-field ` * :ref:`/NXspm_scan_control/trajSCAN-group ` **NXDL Source**: https://github.com/FAIRmat-NFDI/nexus_definitions/tree/fairmat/contributed_definitions/NXspm_scan_control.nxdl.xml