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

.. index::
    ! NXattenuator (base class)
    ! attenuator (base class)
    see: attenuator (base class); NXattenuator

.. _NXattenuator:

============
NXattenuator
============

**Status**:

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

**Description**:

  Description of a device that reduces the intensity of a beam by attenuation.
  If uncertain whether to use ``NXfilter`` (band-pass filter)
  or ``NXattenuator`` (reduces beam intensity), then choose 
  ``NXattenuator``.

**Symbols**:

  No symbol table

**Groups cited**:
  none

**Structure**:

  .. index:: distance (data field)

  **distance**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`}

    Distance from sample

  .. index:: type (data field)

  **type**: :ref:`NX_CHAR <NX_CHAR>`

    Type or composition of attenuator, e.g. polythene

  .. index:: thickness (data field)

  **thickness**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`}

    Thickness of attenuator along beam direction

  .. index:: scattering_cross_section (data field)

  **scattering_cross_section**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_CROSS_SECTION <NX_CROSS_SECTION>`}

    Scattering cross section (coherent+incoherent)

  .. index:: absorption_cross_section (data field)

  **absorption_cross_section**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_CROSS_SECTION <NX_CROSS_SECTION>`}

    Absorption cross section

  .. index:: attenuator_transmission (data field)

  **attenuator_transmission**: :ref:`NX_FLOAT <NX_FLOAT>` {units=\ :ref:`NX_DIMENSIONLESS <NX_DIMENSIONLESS>`}

    The nominal amount of the beam that gets through
    (transmitted intensity)/(incident intensity)

  .. index:: status (data field)

  **status**: :ref:`NX_CHAR <NX_CHAR>`

    In or out or moving of the beam

    Any of these values: ``in`` | ``out`` | ``moving``

    .. index:: time (attribute)

    **@time**: :ref:`NX_DATE_TIME <NX_DATE_TIME>`

      time stamp for this observation

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