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

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

.. _NXpositioner:

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

**Status**:

  base class, extends :ref:`NXobject`

**Description**:

  A generic positioner such as a motor or piezo-electric transducer.

**Symbols**:

  No symbol table

**Groups cited**:
  none

**Structure**:

  .. index:: name (field)

  **name**: (optional) :ref:`NX_CHAR <NX_CHAR>`

    symbolic or mnemonic name (one word)

  .. index:: description (field)

  **description**: (optional) :ref:`NX_CHAR <NX_CHAR>`

    description of positioner

  .. index:: value (field)

  **value[n]**: (optional) :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 (field)

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

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

  .. index:: target_value (field)

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

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

  .. index:: tolerance (field)

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

    maximum allowable difference between target_value and value

  .. index:: soft_limit_min (field)

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

    minimum allowed limit to set value

  .. index:: soft_limit_max (field)

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

    maximum allowed limit to set value

  .. index:: velocity (field)

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

    velocity of the positioner (distance moved per unit time)

  .. index:: acceleration_time (field)

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

    time to ramp the velocity up to full speed

  .. index:: controller_record (field)

  **controller_record**: (optional) :ref:`NX_CHAR <NX_CHAR>`

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

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