.. auto-generated by dev_tools.docs.nxdl from the NXDL source applications/NXsas.nxdl.xml -- DO NOT EDIT .. index:: ! NXsas (application definition) ! sas (application definition) see: sas (application definition); NXsas .. _NXsas: ===== NXsas ===== .. Contributors List .. |contrib_name| replace:: Pete R Jemian|prjemian|https://avatars.githubusercontent.com/u/2279984?v=4|2022-09-16 .. |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 **Status**: application definition, extends :ref:`NXobject` **Description**: .. collapse:: Raw, monochromatic 2-D SAS data with an area detector. ... Raw, monochromatic 2-D SAS data with an area detector. This is an application definition for raw data (not processed or reduced data) from a 2-D small angle scattering instrument collected with a monochromatic beam and an area detector. It is meant to be suitable both for neutron SANS and X-ray SAXS data. It covers all raw data from any monochromatic SAS techniques that use an area detector: SAS, WSAS, grazing incidence, GISAS It covers all raw data from any SAS techniques that use an area detector and a monochromatic beam. **Symbols**: The symbol(s) listed here will be used below to coordinate fields with the same shape. **nXPixel**: Number of pixels in x direction. **nYPixel**: Number of pixels in y direction. **Groups cited**: :ref:`NXcollimator`, :ref:`NXdata`, :ref:`NXdetector`, :ref:`NXentry`, :ref:`NXgeometry`, :ref:`NXinstrument`, :ref:`NXmonitor`, :ref:`NXmonochromator`, :ref:`NXsample`, :ref:`NXshape`, :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, NXcollimator (base class); used in application definition, NXgeometry (base class); used in application definition, NXshape (base class); used in application definition, NXdetector (base class); used in application definition, NXsample (base class); used in application definition, NXmonitor (base class); used in application definition, NXdata (base class); used in application definition **Structure**: .. _/NXsas/ENTRY-group: **ENTRY**: (required) :ref:`NXentry` .. _/NXsas/ENTRY/title-field: .. index:: title (field) **title**: (optional) :ref:`NX_CHAR ` :ref:`⤆ ` .. _/NXsas/ENTRY/start_time-field: .. index:: start_time (field) **start_time**: (optional) :ref:`NX_DATE_TIME ` :ref:`⤆ ` .. _/NXsas/ENTRY/end_time-field: .. index:: end_time (field) **end_time**: (optional) :ref:`NX_DATE_TIME ` :ref:`⤆ ` .. _/NXsas/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: ``NXsas`` .. _/NXsas/ENTRY/INSTRUMENT-group: **INSTRUMENT**: (required) :ref:`NXinstrument` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/name-field: .. index:: name (field) **name**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` Name of the instrument actually used to perform the experiment. .. _/NXsas/ENTRY/INSTRUMENT/SOURCE-group: **SOURCE**: (required) :ref:`NXsource` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/SOURCE/type-field: .. index:: type (field) **type**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` Type of radiation source. .. _/NXsas/ENTRY/INSTRUMENT/SOURCE/name-field: .. index:: name (field) **name**: (optional) :ref:`NX_CHAR ` :ref:`⤆ ` Name of the radiation source. .. _/NXsas/ENTRY/INSTRUMENT/SOURCE/probe-field: .. index:: probe (field) **probe**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. collapse:: Name of radiation probe, necessary to compute the sample contrast. ... Name of radiation probe, necessary to compute the sample contrast. Any of these values: ``neutron`` | ``x-ray`` .. _/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR-group: **MONOCHROMATOR**: (required) :ref:`NXmonochromator` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR/wavelength-field: .. index:: wavelength (field) **wavelength**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_WAVELENGTH `} :ref:`⤆ ` The wavelength (:math:`\lambda`) of the radiation. .. _/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR/wavelength_spread-field: .. index:: wavelength_spread (field) **wavelength_spread**: (optional) :ref:`NX_FLOAT ` .. collapse:: delta_lambda/lambda (:math:`\Delta\lambda/\lambda`): ... delta_lambda/lambda (:math:`\Delta\lambda/\lambda`): Important for resolution calculations. .. _/NXsas/ENTRY/INSTRUMENT/COLLIMATOR-group: **COLLIMATOR**: (optional) :ref:`NXcollimator` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY-group: **GEOMETRY**: (required) :ref:`NXgeometry` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE-group: **SHAPE**: (required) :ref:`NXshape` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE/shape-field: .. index:: shape (field) **shape**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` Any of these values: ``nxcylinder`` | ``nxbox`` .. _/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE/size-field: .. index:: size (field) **size**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` The collimation length. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR-group: **DETECTOR**: (required) :ref:`NXdetector` :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/data-field: .. index:: data (field) **data**: (required) :ref:`NX_NUMBER ` (Rank: 2, Dimensions: [nXPixel, nYPixel]) :ref:`⤆ ` .. collapse:: This is area detector data, number of x-pixel versus ... This is area detector data, number of x-pixel versus number of y-pixels. Since the beam center is to be determined as a step of data reduction, it is not necessary to document or assume the position of the beam center in acquired data. It is necessary to define which are the x and y directions, to coordinate with the pixel size and compute Q. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/distance-field: .. index:: distance (field) **distance**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` The distance between detector and sample. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/x_pixel_size-field: .. index:: x_pixel_size (field) **x_pixel_size**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` Physical size of a pixel in x-direction. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/y_pixel_size-field: .. index:: y_pixel_size (field) **y_pixel_size**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` Physical size of a pixel in y-direction. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/polar_angle-field: .. index:: polar_angle (field) **polar_angle**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANGLE `} :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/azimuthal_angle-field: .. index:: azimuthal_angle (field) **azimuthal_angle**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANGLE `} :ref:`⤆ ` .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/rotation_angle-field: .. index:: rotation_angle (field) **rotation_angle**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANGLE `} .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/aequatorial_angle-field: .. index:: aequatorial_angle (field) **aequatorial_angle**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANGLE `} .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/beam_center_x-field: .. index:: beam_center_x (field) **beam_center_x**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` .. collapse:: This is the x position where the direct beam would hit the detector. ... This is the x position where the direct beam would hit the detector. This is a length, not a pixel position, and can be outside of the actual detector. It is expected that data reduction will determine beam center from the raw data, thus it is not required here. The instrument can provide an initial or nominal value to advise data reduction. .. _/NXsas/ENTRY/INSTRUMENT/DETECTOR/beam_center_y-field: .. index:: beam_center_y (field) **beam_center_y**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_LENGTH `} :ref:`⤆ ` .. collapse:: This is the y position where the direct beam would hit the detector. ... This is the y position where the direct beam would hit the detector. This is a length, not a pixel position, and can be outside of the actual detector. It is expected that data reduction will determine beam center from the raw data, thus it is not required here. The instrument can provide an initial or nominal value to advise data reduction. .. _/NXsas/ENTRY/SAMPLE-group: **SAMPLE**: (optional) :ref:`NXsample` :ref:`⤆ ` .. _/NXsas/ENTRY/SAMPLE/name-field: .. index:: name (field) **name**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` Descriptive name of sample. .. _/NXsas/ENTRY/SAMPLE/aequatorial_angle-field: .. index:: aequatorial_angle (field) **aequatorial_angle**: (optional) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANGLE `} .. _/NXsas/ENTRY/MONITOR-group: **MONITOR**: (optional) :ref:`NXmonitor` :ref:`⤆ ` .. _/NXsas/ENTRY/MONITOR/mode-field: .. index:: mode (field) **mode**: (required) :ref:`NX_CHAR ` :ref:`⤆ ` .. collapse:: Count to a preset value based on either clock time ... Count to a preset value based on either clock time (timer) or received monitor counts (monitor). Any of these values: ``monitor`` | ``timer`` .. _/NXsas/ENTRY/MONITOR/preset-field: .. index:: preset (field) **preset**: (required) :ref:`NX_FLOAT ` Preset value for time or monitor. .. _/NXsas/ENTRY/MONITOR/integral-field: .. index:: integral (field) **integral**: (required) :ref:`NX_FLOAT ` {units=\ :ref:`NX_ANY `} Total integral monitor counts. .. _/NXsas/ENTRY/DATA-group: **DATA**: (required) :ref:`NXdata` :ref:`⤆ ` .. _/NXsas/ENTRY/DATA@signal-attribute: .. index:: signal (group attribute) **@signal**: (optional) :ref:`NX_CHAR ` :ref:`⤆ ` .. collapse:: Name the *plottable* field. The link here defines this name as ... Name the *plottable* field. The link here defines this name as ``data``. Obligatory value: ``data`` .. _/NXsas/ENTRY/DATA/data-link: **data**: :ref:`link` (suggested target: ``/NXentry/NXinstrument/NXdetector/data``) Hypertext Anchors ----------------- List of hypertext anchors for all groups, fields, attributes, and links defined in this class. * :ref:`/NXsas/ENTRY-group ` * :ref:`/NXsas/ENTRY/DATA-group ` * :ref:`/NXsas/ENTRY/DATA/data-link ` * :ref:`/NXsas/ENTRY/DATA@signal-attribute ` * :ref:`/NXsas/ENTRY/definition-field ` * :ref:`/NXsas/ENTRY/end_time-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/COLLIMATOR-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE/shape-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/COLLIMATOR/GEOMETRY/SHAPE/size-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/aequatorial_angle-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/azimuthal_angle-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/beam_center_x-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/beam_center_y-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/data-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/distance-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/polar_angle-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/rotation_angle-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/x_pixel_size-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/DETECTOR/y_pixel_size-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR/wavelength-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/MONOCHROMATOR/wavelength_spread-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/name-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/SOURCE-group ` * :ref:`/NXsas/ENTRY/INSTRUMENT/SOURCE/name-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/SOURCE/probe-field ` * :ref:`/NXsas/ENTRY/INSTRUMENT/SOURCE/type-field ` * :ref:`/NXsas/ENTRY/MONITOR-group ` * :ref:`/NXsas/ENTRY/MONITOR/integral-field ` * :ref:`/NXsas/ENTRY/MONITOR/mode-field ` * :ref:`/NXsas/ENTRY/MONITOR/preset-field ` * :ref:`/NXsas/ENTRY/SAMPLE-group ` * :ref:`/NXsas/ENTRY/SAMPLE/aequatorial_angle-field ` * :ref:`/NXsas/ENTRY/SAMPLE/name-field ` * :ref:`/NXsas/ENTRY/start_time-field ` * :ref:`/NXsas/ENTRY/title-field ` **NXDL Source**: https://github.com/nexusformat/definitions/blob/main/applications/NXsas.nxdl.xml