.. _auto_th_summary:

*EXTRACTS THE SUMMARY FROM TH/ABF FILES*
========================================

Reads a TH/ABF time-history file and extracts its channel summary as a structured dataset. Use this worker to obtain a quick inventory of all channels (names, units, metadata) present in a TH or ABF file before further post-processing.

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

Classification: **process**.

Tagged: ``abf``, ``channel-list``, ``extraction``, ``summary``, ``th``, ``time-history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File Name
     - file_name
     - string
     - TH.th
     - 
     - Path or filename of the TH/ABF time-history file to read (e.g. 'TH.th'); defaults to 'TH.th' and can be left at default when the file is already staged under that name in the working directory.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - th_summary_output_1
     - th_summary_output_1
     - dataset
     - Tabular dataset containing the channel summary extracted from the TH/ABF file — each row represents one channel entry with its associated metadata (name, unit, type, etc.).

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

- cae.postprocessing.extraction

.. raw:: html

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