.. auto-generated by dev_tools.docs.nxdl from the NXDL source applications/NXstxm.nxdl.xml -- DO NOT EDIT .. index:: ! NXstxm (application definition) ! stxm (application definition) see: stxm (application definition); NXstxm .. _NXstxm: ====== NXstxm ====== .. Contributors List .. |contrib_name| replace:: Pete R Jemian|prjemian|https://avatars.githubusercontent.com/u/2279984?v=4|2022-01-28 .. |contrib_name| replace:: Russ Berg|RussBerg|https://avatars.githubusercontent.com/u/4698891?v=4|2020-11-05 .. |contrib_name| replace:: Tobias Richter|zjttoefs|https://avatars.githubusercontent.com/u/856440?v=4|2018-05-15 .. |contrib_name| replace:: Benajamin|benajamin|https://avatars.githubusercontent.com/u/10222548?v=4|2015-02-04 **Status**: application definition, extends :ref:`NXobject` **Description**: .. collapse:: Application definition for a STXM instrument. ... Application definition for a STXM instrument. The interferometer position measurements, monochromator photon energy values and detector measurements are all treated as NXdetectors and stored within the NXinstrument group as lists of values stored in chronological order. The NXdata group then holds another version of the data in a regular 3D array (NumE by NumY by NumX, for a total of nP points in a sample image stack type scan). The former data values should be stored with a minimum loss of precision, while the latter values can be simplified and/or approximated in order to fit the constraints of a regular 3D array. 'Line scans' and 'point spectra' are just sample_image scan types with reduced dimensions in the same way as single images have reduced E dimensions compared to image 'stacks'. **Symbols**: These symbols will be used below to coordinate the shapes of the datasets. **nP**: Total number of scan points **nE**: Number of photon energies scanned **nX**: Number of pixels in X direction **nY**: Number of pixels in Y direction **detectorRank**: Rank of data array provided by the detector for a single measurement **Groups cited**: :ref:`NXdata`, :ref:`NXdetector`, :ref:`NXentry`, :ref:`NXinstrument`, :ref:`NXmonitor`, :ref:`NXmonochromator`, :ref:`NXsample`, :ref:`NXsource` .. index:: NXentry (base class); used in application definition, NXinstrument (base class); used in application definition, NXsource (base class); used in application definition, NXmonochromator (base class); used in application definition, NXdetector (base class); used in application definition, NXsample (base class); used in application definition, NXdata (base class); used in application definition, NXmonitor (base class); used in application definition **Structure**: .. _/NXstxm/ENTRY-group: **ENTRY**: (required) :ref:`NXentry` .. _/NXstxm/ENTRY/title-field: .. index:: title (field) **title**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. _/NXstxm/ENTRY/start_time-field: .. index:: start_time (field) **start_time**: (required) :ref:`NX_DATE_TIME ` :ref:`⤆ ` .. _/NXstxm/ENTRY/end_time-field: .. index:: end_time (field) **end_time**: (required) :ref:`NX_DATE_TIME ` :ref:`⤆ ` .. _/NXstxm/ENTRY/definition-field: .. index:: definition (field) **definition**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. collapse:: Official NeXus NXDL schema to which this file conforms ... Official NeXus NXDL schema to which this file conforms Obligatory value: ``NXstxm`` .. _/NXstxm/ENTRY/INSTRUMENT-group: **INSTRUMENT**: (required) :ref:`NXinstrument` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/SOURCE-group: **SOURCE**: (required) :ref:`NXsource` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/SOURCE/type-field: .. index:: type (field) **type**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/SOURCE/name-field: .. index:: name (field) **name**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/SOURCE/probe-field: .. index:: probe (field) **probe**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/monochromator-group: **monochromator**: (required) :ref:`NXmonochromator` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/monochromator/energy-field: .. index:: energy (field) **energy**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nP]) :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/DETECTOR-group: **DETECTOR**: (required) :ref:`NXdetector` :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/DETECTOR/data-field: .. index:: data (field) **data**: (required) :ref:`NX_NUMBER ` (Rank: 1+detectorRank, Dimensions: [nP]) :ref:`⤆ ` .. _/NXstxm/ENTRY/INSTRUMENT/sample_x-group: **sample_x**: (optional) :ref:`NXdetector` :ref:`⤆ ` Measurements of the sample position from the x-axis interferometer. .. _/NXstxm/ENTRY/INSTRUMENT/sample_x/data-field: .. index:: data (field) **data**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nP]) .. _/NXstxm/ENTRY/INSTRUMENT/sample_y-group: **sample_y**: (optional) :ref:`NXdetector` :ref:`⤆ ` Measurements of the sample position from the y-axis interferometer. .. _/NXstxm/ENTRY/INSTRUMENT/sample_y/data-field: .. index:: data (field) **data**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nP]) .. _/NXstxm/ENTRY/INSTRUMENT/sample_z-group: **sample_z**: (optional) :ref:`NXdetector` :ref:`⤆ ` Measurements of the sample position from the z-axis interferometer. .. _/NXstxm/ENTRY/INSTRUMENT/sample_z/data-field: .. index:: data (field) **data**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nP]) .. _/NXstxm/ENTRY/SAMPLE-group: **SAMPLE**: (required) :ref:`NXsample` :ref:`⤆ ` .. _/NXstxm/ENTRY/SAMPLE/rotation_angle-field: .. index:: rotation_angle (field) **rotation_angle**: (required) :ref:`NX_FLOAT ` :ref:`⤆ ` .. _/NXstxm/ENTRY/DATA-group: **DATA**: (required) :ref:`NXdata` :ref:`⤆ ` .. _/NXstxm/ENTRY/DATA/stxm_scan_type-field: .. index:: stxm_scan_type (field) **stxm_scan_type**: (required) :ref:`NX_CHAR ` .. collapse:: Label for typical scan types as a convenience for humans. ... Label for typical scan types as a convenience for humans. Each label corresponds to a specific set of axes being scanned to produce a data array of shape: * sample point spectrum: (photon_energy,) * sample line spectrum: (photon_energy, sample_y/sample_x) * sample image: (sample_y, sample_x) * sample image stack: (photon_energy, sample_y, sample_x) * sample focus: (zoneplate_z, sample_y/sample_x) * osa image: (osa_y, osa_x) * osa focus: (zoneplate_z, osa_y/osa_x) * detector image: (detector_y, detector_x) The "generic scan" string is to be used when none of the other choices are appropriate. Any of these values: * ``sample point spectrum`` * ``sample line spectrum`` * ``sample image`` * ``sample image stack`` * ``sample focus`` * ``osa image`` * ``osa focus`` * ``detector image`` * ``generic scan`` .. _/NXstxm/ENTRY/DATA/data-field: .. index:: data (field) **data**: (required) :ref:`NX_NUMBER ` :ref:`⤆ ` .. collapse:: Detectors that provide more than one value per scan point should be summar ... Detectors that provide more than one value per scan point should be summarised to a single value per scan point for this array in order to simplify plotting. Note that 'Line scans' and focus type scans measure along one spatial dimension but are not restricted to being parallel to the X or Y axes. Such scans should therefore use a single dimension for the positions along the spatial line. The 'sample_x' and 'sample_y' fields should then contain lists of the x- and y-positions and should both have the 'axis' attribute pointing to the same dimension. .. _/NXstxm/ENTRY/DATA/energy-field: .. index:: energy (field) **energy**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nE]) .. collapse:: List of photon energies of the X-ray beam. If scanned through multiple val ... List of photon energies of the X-ray beam. If scanned through multiple values, then an 'axis' attribute will be required to link the field to the appropriate data array dimension. .. _/NXstxm/ENTRY/DATA/sample_y-field: .. index:: sample_y (field) **sample_y**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nY]) .. collapse:: List of Y positions on the sample. If scanned through multiple values, ... List of Y positions on the sample. If scanned through multiple values, then an 'axis' attribute will be required to link the field to the appropriate data array dimension. .. _/NXstxm/ENTRY/DATA/sample_x-field: .. index:: sample_x (field) **sample_x**: (required) :ref:`NX_FLOAT ` (Rank: 1, Dimensions: [nX]) .. collapse:: List of X positions on the sample. If scanned through multiple values, ... List of X positions on the sample. If scanned through multiple values, then an 'axis' attribute will be required to link the field to the appropriate data array dimension. .. _/NXstxm/ENTRY/control-group: **control**: (optional) :ref:`NXmonitor` :ref:`⤆ ` .. _/NXstxm/ENTRY/control/data-field: .. index:: data (field) **data**: (required) :ref:`NX_FLOAT ` .. collapse:: Values to use to normalise for time-variations in photon flux. Typically, ... Values to use to normalise for time-variations in photon flux. Typically, the synchrotron storage ring electron beam current is used as a proxy for the X-ray beam intensity. Array must have same shape as the NXdata groups. Hypertext Anchors ----------------- List of hypertext anchors for all groups, fields, attributes, and links defined in this class. * :ref:`/NXstxm/ENTRY-group ` * :ref:`/NXstxm/ENTRY/control-group ` * :ref:`/NXstxm/ENTRY/control/data-field ` * :ref:`/NXstxm/ENTRY/DATA-group ` * :ref:`/NXstxm/ENTRY/DATA/data-field ` * :ref:`/NXstxm/ENTRY/DATA/energy-field ` * :ref:`/NXstxm/ENTRY/DATA/sample_x-field ` * :ref:`/NXstxm/ENTRY/DATA/sample_y-field ` * :ref:`/NXstxm/ENTRY/DATA/stxm_scan_type-field ` * :ref:`/NXstxm/ENTRY/definition-field ` * :ref:`/NXstxm/ENTRY/end_time-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/DETECTOR-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/DETECTOR/data-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/monochromator-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/monochromator/energy-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_x-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_x/data-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_y-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_y/data-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_z-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/sample_z/data-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/SOURCE-group ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/SOURCE/name-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/SOURCE/probe-field ` * :ref:`/NXstxm/ENTRY/INSTRUMENT/SOURCE/type-field ` * :ref:`/NXstxm/ENTRY/SAMPLE-group ` * :ref:`/NXstxm/ENTRY/SAMPLE/rotation_angle-field ` * :ref:`/NXstxm/ENTRY/start_time-field ` * :ref:`/NXstxm/ENTRY/title-field ` **NXDL Source**: https://github.com/nexusformat/definitions/blob/main/applications/NXstxm.nxdl.xml