.. _auto_uniaxial_specimen_get_nominal_dimension:

*RETRIEVES THE NOMINAL DIMENSION FOR A GIVEN UNIAXIAL SPECIMEN*
===============================================================

Looks up the nominal dimension for a specified uniaxial specimen type by querying the specimen dimensions registry. For the "area" dimension type, the nominal value is computed as gauge width × specimen thickness; for all other dimension types the stored tabular value is returned directly.

When to use
-----------

Tagged: ``area``, ``coupon``, ``gauge_width``, ``material_testing``, ``nominal_dimension``, ``specimen``, ``uniaxial``, ``workflows``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Specimen Type
     - specimen_type
     - text
     - E8_shell_standard_p25mm
     - 
     - Identifier of the uniaxial specimen geometry to look up (e.g. 'E8_shell_standard_p25mm'); must match an entry in the specimen dimensions registry exactly.
   * - Dimension Type
     - dimension_type
     - text
     - Guage Width
     - 
     - The dimension to retrieve from the specimen record (e.g. 'Guage Width', 'Guage Length'); use 'area' to compute cross-sectional area as gauge width × specimen_thickness.
   * - Specimen Thickness
     - specimen_thickness
     - text
     - 1.0
     - 
     - Sheet/coupon thickness in mm (default 1.0); only used when dimension_type is 'area' to compute the nominal cross-sectional area.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Nominal Dimension
     - nominal_dimension
     - text
     - Scalar nominal dimension value (mm or mm² for area) corresponding to the requested dimension_type for the given specimen_type.

Disciplines
-----------

- engineering.material.characterization
- engineering.material.specimen

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>uniaxial_specimen_get_nominal_dimension</code>. Schema hash: <code>c94b76be3113</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>