.. _auto_simulation_unarchive_inputfile:

*UNARCHIVE SIMULATION FILE*
===========================

Extracts a compressed (archived) input file attached to a simulation record, making its contents available for downstream workflow steps. Use this worker whenever a simulation's input deck or supporting file has been stored as a ZIP/tar archive and needs to be unpacked before processing.

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

Tagged: ``decompress``, ``extract``, ``input_file``, ``simulation``, ``tar``, ``unarchive``, ``zip``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Platform simulation record to operate on; drives the attachment lookup — required, select from the remote simulation registry.
   * - Choose File
     - input_file
     - remote_lookup
     - —
     - 
     - Compressed attachment (ZIP, tar, etc.) belonging to the chosen simulation that should be extracted; leave unset to let the worker infer the default archive attached to the simulation.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Integer identifier of the simulation record whose archive was extracted, passed downstream so subsequent workers can reference the same simulation context.

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

- data.io.archive
- platform.workflow

.. raw:: html

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