.. _auto_d3hsp_file_extractor:

*D3HSP EXTRACTOR FROM FILE*
===========================

Parses an LS-DYNA d3hsp text file and extracts a user-selected section (e.g. summary, mass, GISSMO failures, contact, curves) into a structured dataset. Use this worker whenever you need to pull tabular or structured data from a d3hsp output file for downstream processing or reporting.

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

Tagged: ``bom``, ``contact``, ``control_card``, ``curves``, ``d3hsp``, ``d3hsp2xml``, ``errors``, ``extraction``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - D3hsp File
     - d3hsp_file
     - file
     - —
     - ✓
     - The LS-DYNA d3hsp output file to parse; must be a valid d3hsp text file uploaded or attached to the workflow.
   * - Select Section
     - d3hsp_section
     - select
     - summary
     - ✓
     - The named section to extract from the d3hsp file (e.g. 'summary', 'mass', 'gissmo_failures', 'curves'); defaults to 'summary' — choose the section that matches the data you need downstream.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Extractions
     - extractions
     - dataset
     - Structured dataset containing the rows and fields parsed from the selected d3hsp section; schema varies by section (tabular for mass/materials/curves, key-value for summary/parameters/control_card).

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

- cae.postprocessing.extraction

.. raw:: html

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