.. auto-generated by dev_tools.docs.nxdl from the NXDL source base_classes/NXcylindrical_geometry.nxdl.xml -- DO NOT EDIT

.. index::
    ! NXcylindrical_geometry (base class)
    ! cylindrical_geometry (base class)
    see: cylindrical_geometry (base class); NXcylindrical_geometry

.. _NXcylindrical_geometry:

======================
NXcylindrical_geometry
======================

..
    Contributors List

    .. |contrib_name| replace:: Lukas Pielsticker|lukaspie|https://avatars.githubusercontent.com/u/50139597?v=4|2025-02-13

    .. |contrib_name| replace:: Pete R Jemian|prjemian|https://avatars.githubusercontent.com/u/2279984?v=4|2024-02-18

    .. |contrib_name| replace:: Peter Chang|PeterC-DLS|https://avatars.githubusercontent.com/u/1381719?v=4|2020-10-20

    .. |contrib_name| replace:: Pete R Jemian|prjemian|https://avatars.githubusercontent.com/u/2279984?v=4|2018-05-15

**Status**:

  base class, extends :ref:`NXobject`

**Description**:

  .. collapse:: Geometry description for cylindrical shapes. ...

      Geometry description for cylindrical shapes.
      This class can be used in place of ``NXoff_geometry`` when an exact
      representation for cylinders is preferred.
      For example, for Helium-tube, neutron detectors.
      It can be used to describe the shape of any component, including detectors.
      In the case of detectors it can be used to define the shape of a single pixel, or,
      if the pixel shapes are non-uniform, to describe the shape of the whole detector.

**Symbols**:

  These symbols will be used below.

  **i**: number of vertices required to define all cylinders in the shape

  **j**: number of cylinders in the shape

  **k**: number cylinders which are detectors

**Groups cited**:
  none

**Structure**:

  .. _/NXcylindrical_geometry/vertices-field:

  .. index:: vertices (field)

  **vertices**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 2, Dimensions: [i, 3]) {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    .. collapse:: List of x,y,z coordinates for vertices. ...

        List of x,y,z coordinates for vertices.
        The origin of the coordinates is the position of the parent component, for
        example the NXdetector which the geometry describes.
        If the shape describes a single pixel for a detector with uniform pixel shape
        then the origin is the position of each pixel as described by the
        ``x/y/z_pixel_offset`` datasets in ``NXdetector``.

  .. _/NXcylindrical_geometry/cylinders-field:

  .. index:: cylinders (field)

  **cylinders**: (optional) :ref:`NX_INT <NX_INT>` (Rank: 2, Dimensions: [j, 3]) 

    .. collapse:: List of indices of vertices in the ``vertices`` dataset to form each cylinder. ...

        List of indices of vertices in the ``vertices`` dataset to form each cylinder.
        Each cylinder is described by three vertices A, B, C.
        First vertex A lies on the cylinder axis and circular face, second point B
        on edge of the same face as A, and third point C at the other face and on axis.

  .. _/NXcylindrical_geometry/detector_number-field:

  .. index:: detector_number (field)

  **detector_number**: (optional) :ref:`NX_INT <NX_INT>` (Rank: 1, Dimensions: [k]) 

    Maps cylinders in ``cylinder``, by index, with a detector id.


Hypertext Anchors
-----------------

List of hypertext anchors for all groups, fields,
attributes, and links defined in this class.


* :ref:`/NXcylindrical_geometry/cylinders-field </NXcylindrical_geometry/cylinders-field>`
* :ref:`/NXcylindrical_geometry/detector_number-field </NXcylindrical_geometry/detector_number-field>`
* :ref:`/NXcylindrical_geometry/vertices-field </NXcylindrical_geometry/vertices-field>`

**NXDL Source**:
  https://github.com/nexusformat/definitions/blob/main/base_classes/NXcylindrical_geometry.nxdl.xml