.. _auto_simulation_update_input:

*INSERT TEXT IN THE MAIN INPUT FILE*
====================================

Inserts a user-supplied text block at either the top or bottom of a simulation's main input file (e.g., an LS-DYNA keyword deck). Use this worker to programmatically prepend or append keyword cards, comments, or control blocks to an existing simulation input before job submission.

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

Tagged: ``deck_edit``, ``input_file``, ``job_prep``, ``keyword``, ``simulation_update``, ``text_insert``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - The target simulation whose main input file will be modified; select or look up the simulation by name from the platform registry — required, no default.
   * - DTBI
     - data_text
     - textarea
     - —
     - ✓
     - The raw text block (e.g., LS-DYNA keyword cards, comment lines, or control parameters) to be inserted into the input file; plain text, no default.
   * - Location
     - location
     - select
     - bottom
     - ✓
     - Position in the input file where the text block is inserted: 'top' prepends it before all existing content, 'bottom' appends it after all existing content; defaults to 'bottom'.

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 whose input file was updated; can be passed downstream to a solver or further preprocessing workers.

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

- cae.preprocessing.deck_authoring
- platform.job_submission

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