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

.. index::
    ! NXpositioner (base class)
    ! positioner (base class)
    see: positioner (base class); NXpositioner

.. _NXpositioner:

============
NXpositioner
============

**Status**:

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

**Description**:

  This group describes a generic positioner 
  such as a motor or piezo-electric transducer.  It is used to document the
  current information of a piece of beam line equipment.
  Note: When using multiple ``NXpositioner`` groups, it is suggested to place 
  them inside a ``NXcollection`` group.  In such cases, when
  ``NXpositioner`` is used in another class,
  ``NXcollection/NXpositioner`` 
  is then constructed.

**Symbols**:

  No symbol table

**Groups cited**:
  none

**Structure**:

  .. index:: name (data field)

  **name**: :ref:`NX_CHAR <NX_CHAR>`

    symbolic or mnemonic name (one word)

  .. index:: description (data field)

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

    description of positioner

  .. index:: value (data field)

  **value[n]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    best known value of positioner - need [n] as may be scanned

  .. index:: raw_value (data field)

  **raw_value[n]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    raw value of positioner - need [n] as may be scanned

  .. index:: target_value (data field)

  **target_value[n]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    targeted (commanded) value of positioner - need [n] as may be scanned

  .. index:: tolerance (data field)

  **tolerance[n]**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    maximum allowable difference between target_value and value

  .. index:: soft_limit_min (data field)

  **soft_limit_min**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    minimum allowed limit to set value

  .. index:: soft_limit_max (data field)

  **soft_limit_max**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    maximum allowed limit to set value

  .. index:: velocity (data field)

  **velocity**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    velocity of the positioner (distance moved per unit time)

  .. index:: acceleration_time (data field)

  **acceleration_time**: :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_ANY <NX_ANY>`}

    time to ramp the velocity up to full speed

  .. index:: controller_record (data field)

  **controller_record**: :ref:`NX_CHAR <NX_CHAR>`

    Hardware device record, e.g. EPICS process variable, taco/tango ...

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