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

.. index::
    ! NXcg_cylinder_set (base class)
    ! cg_cylinder_set (base class)
    see: cg_cylinder_set (base class); NXcg_cylinder_set

.. _NXcg_cylinder_set:

=================
NXcg_cylinder_set
=================

**Status**:

  base class, extends :ref:`NXcg_primitive_set`

**Description**:

  .. collapse:: Computational geometry description of a set of cylinders. ...

      Computational geometry description of a set of cylinders.

      The radius can either be defined in the radii field or by filling both
      the upper_cap_radii or lower_cap_radii field. The latter field case can
      thus be used to represent truncated cones.

**Symbols**:

  The symbols used in the schema to specify e.g. dimensions of arrays.

  **d**: The dimensionality of the space in which the members are assumed embedded.

  **c**: The cardinality of the set, i.e. the number of members.

**Groups cited**:
  none

**Structure**:

  .. _/NXcg_cylinder_set/height-field:

  .. index:: height (field)

  **height**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 2, Dimensions: [c, d]) {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    .. collapse:: A direction vector which is parallel to the cylinder/cone axis ...

        A direction vector which is parallel to the cylinder/cone axis
        and whose magnitude is the height of the cylinder/cone.

  .. _/NXcg_cylinder_set/radius-field:

  .. index:: radius (field)

  **radius**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    Radius of the cylinder if all have the same radius.

  .. _/NXcg_cylinder_set/radii-field:

  .. index:: radii (field)

  **radii**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    Radii of the cylinder.

  .. _/NXcg_cylinder_set/upper_cap_radii-field:

  .. index:: upper_cap_radii (field)

  **upper_cap_radii**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    .. collapse:: Radii of the upper circular cap. ...

        Radii of the upper circular cap.

        This field, combined with lower_cap_radius can be used to describe
        (eventually truncated) circular cones.

  .. _/NXcg_cylinder_set/lower_cap_radii-field:

  .. index:: lower_cap_radii (field)

  **lower_cap_radii**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_LENGTH <NX_LENGTH>`} 

    .. collapse:: Radii of the upper circular cap. ...

        Radii of the upper circular cap.

        This field, combined with upper_cap_radius can be used to describe
        (eventually truncated) circular cones.

  .. _/NXcg_cylinder_set/lateral_surface_area-field:

  .. index:: lateral_surface_area (field)

  **lateral_surface_area**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_AREA <NX_AREA>`} 

    Lateral surface area

  .. _/NXcg_cylinder_set/upper_cap_surface_area-field:

  .. index:: upper_cap_surface_area (field)

  **upper_cap_surface_area**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_AREA <NX_AREA>`} 

    Area of the upper cap of each cylinder.

  .. _/NXcg_cylinder_set/lower_cap_surface_area-field:

  .. index:: lower_cap_surface_area (field)

  **lower_cap_surface_area**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_AREA <NX_AREA>`} 

    Area of the lower cap of each cylinder.

  .. _/NXcg_cylinder_set/total_surface_area-field:

  .. index:: total_surface_area (field)

  **total_surface_area**: (optional) :ref:`NX_NUMBER <NX_NUMBER>` (Rank: 1, Dimensions: [c]) {units=\ :ref:`NX_AREA <NX_AREA>`} 

    .. collapse:: Sum of upper and lower cap areas and lateral surface area ...

        Sum of upper and lower cap areas and lateral surface area
        of each cylinder.


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

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


* :ref:`/NXcg_cylinder_set/height-field </NXcg_cylinder_set/height-field>`
* :ref:`/NXcg_cylinder_set/lateral_surface_area-field </NXcg_cylinder_set/lateral_surface_area-field>`
* :ref:`/NXcg_cylinder_set/lower_cap_radii-field </NXcg_cylinder_set/lower_cap_radii-field>`
* :ref:`/NXcg_cylinder_set/lower_cap_surface_area-field </NXcg_cylinder_set/lower_cap_surface_area-field>`
* :ref:`/NXcg_cylinder_set/radii-field </NXcg_cylinder_set/radii-field>`
* :ref:`/NXcg_cylinder_set/radius-field </NXcg_cylinder_set/radius-field>`
* :ref:`/NXcg_cylinder_set/total_surface_area-field </NXcg_cylinder_set/total_surface_area-field>`
* :ref:`/NXcg_cylinder_set/upper_cap_radii-field </NXcg_cylinder_set/upper_cap_radii-field>`
* :ref:`/NXcg_cylinder_set/upper_cap_surface_area-field </NXcg_cylinder_set/upper_cap_surface_area-field>`

**NXDL Source**:
  https://github.com/FAIRmat-NFDI/nexus_definitions/tree/fairmat/contributed_definitions/NXcg_cylinder_set.nxdl.xml