.. _auto_th_channel_by_id:

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

Extracts a named channel's time-history data from a TH or ABF file and returns it as a numeric vector. Use this worker when you need to pull a single channel by its identifier from a time-history result file for downstream curve processing or plotting.

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

Classification: **process**.

Tagged: ``abf``, ``binout``, ``channel``, ``extraction``, ``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 or ABF time-history file to read (e.g. 'TH.th'); defaults to 'TH.th' and can be left at default when the upstream solver step writes to that standard name.
   * - Channel Id
     - channel_id
     - string
     - —
     - 
     - String identifier of the channel to extract from the file (e.g. 'X_VEL' or a numeric channel index as a string); required in practice — no default is provided, so always supply the target channel name.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - th_channel_by_id_output_1
     - th_channel_by_id_output_1
     - vector
     - Numeric vector containing the extracted channel values (e.g. force, velocity, displacement vs. time) read sequentially from the TH/ABF file for the requested channel ID.

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

- cae.postprocessing.extraction
- data.io.file

.. 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_channel_by_id</code>. Schema hash: <code>ee57739e6344</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>