.. auto-generated by script ../../../../utils/nxdl2rst.py from the NXDL source ../../../../base_classes/NXguide.nxdl.xml

.. index::
    ! NXguide (base class)
    ! guide (base class)
    see: guide (base class); NXguide

.. _NXguide:

=======
NXguide
=======

**Status**:

  base class, extends :ref:`NXobject`, version 1.0

**Description**:

  ``NXguide`` is used by neutron instruments to describe
  a guide consists of several mirrors building a shape through which 
  neutrons can be guided or directed. The simplest such form is box shaped
  although elliptical guides are gaining in popularity. 
  The individual parts of a guide usually have common characteristics 
  but there are cases where they are different.
  For example,  a neutron guide might consist of 2 or 4 coated walls or
  a supermirror bender with multiple, coated vanes.

  To describe polarizing supermirrors such as used in neutron reflection,
  it may be necessary to revise this definition of ``NXguide``
  to include ``NXpolarizer`` and/or ``NXmirror``.

  When even greater complexity exists in the definition of what
  constitutes a *guide*,  it has been suggested that ``NXguide`` 
  be redefined as a ``NXcollection`` of
  ``NXmirrors`` each having their own 
  ``NXgeometries`` describing their location(s).

  For the more general case when describing mirrors, consider using 
  ``NXmirror``.

  NOTE: The NeXus International Advisory Committee welcomes 
  comments for revision and improvement of 
  this definition of ``NXguide``.


**Symbols**:


  **nsurf**: number of reflecting surfaces

  **nwl**: number of wavelengths

**Groups cited**:
  :ref:`NXdata`, :ref:`NXgeometry`

.. index:: NXgeometry (base class); used in base class, NXdata (base class); used in base class

**Structure**:

  .. index:: description (data field)

  **description**: :ref:`NX_CHAR <NX_CHAR>`

    A description of this particular instance of ``NXguide``.

  .. index:: incident_angle (data field)

  **incident_angle**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_ANGLE <NX_ANGLE>`}

    TODO: documentation needed

  .. index:: bend_angle_x (data field)

  **bend_angle_x**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_ANGLE <NX_ANGLE>`}

    TODO: documentation needed

  .. index:: bend_angle_y (data field)

  **bend_angle_y**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_ANGLE <NX_ANGLE>`}

    TODO: documentation needed

  .. index:: interior_atmosphere (data field)

  **interior_atmosphere**: :ref:`NX_CHAR <NX_CHAR>`


    Any of these values: ``vacuum`` | ``helium`` | ``argon``

  .. index:: external_material (data field)

  **external_material**: :ref:`NX_CHAR <NX_CHAR>`

    external material outside substrate

  .. index:: m_value (data field)

  **m_value[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>`

    The ``m`` value for a supermirror, which defines the supermirror 
    regime in multiples of the critical angle of Nickel.

  .. index:: substrate_material (data field)

  **substrate_material[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>`

    TODO: documentation needed

  .. index:: substrate_thickness (data field)

  **substrate_thickness[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`}

    TODO: documentation needed

  .. index:: coating_material (data field)

  **coating_material[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>`

    TODO: documentation needed

  .. index:: substrate_roughness (data field)

  **substrate_roughness[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`}

    TODO: documentation needed

  .. index:: coating_roughness (data field)

  **coating_roughness[nsurf]**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`}

    TODO: documentation needed

  .. index:: number_sections (data field)

  **number_sections**: :ref:`NX_INT <NX_INT>` {units=\ :ref:`NX_UNITLESS <NX_UNITLESS>`}

    number of substrate sections (also called ``nsurf`` as an 
    index in the ``NXguide`` specification)

  **(geometry)**: :ref:`NXgeometry`

    TODO:  Explain what this NXgeometry group means.  What is intended here?

  **reflectivity**: :ref:`NXdata`

    Reflectivity as function of reflecting surface and wavelength

    .. index:: data (data field)

    **data[nsurf, nwl]**: :ref:`NX_NUMBER <NX_NUMBER>`

      reflectivity of each surface as a function of wavelength

      .. index:: signal (attribute)

      **@signal**: :ref:`NX_POSINT <NX_POSINT>`

        .. index:: plotting

        Use ``signal=1`` to indicate that this 
        is the plottable data for NeXus.

        Obligatory value:  ``1``

      .. index:: axes (attribute)

      **@axes**: :ref:`NX_CHAR <NX_CHAR>`

        Use ``axes="surface:wavelength"`` to indicate the 
        dimension scales to be used when plotting this data.

        Obligatory value:  ``surface:wavelength``

    .. index:: surface (data field)

    **surface[nsurf]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

      List of surfaces.  Probably best to use index 
      numbers but the specification is very loose.

    .. index:: wavelength (data field)

    **wavelength[nwl]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_WAVELENGTH <NX_WAVELENGTH>`}

      wavelengths at which reflectivity was measured

**Source**:
  Automatically generated from https://github.com/nexusformat/definitions/blob/master/base_classes/NXguide.nxdl.xml