.. _auto_job_submit_simulations_from_folder:

*SUBMITS MULTIPLE SIMULATIONS FROM FOLDER*
==========================================

Scans a folder for simulation input decks matching a file-name pattern and batch-submits each as a separate HPC job under a shared study. Use this worker when you need to launch a sweep of pre-staged LS-DYNA (or equivalent) runs in one step without manually queuing each deck.

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

Tagged: ``batch_submit``, ``folder_scan``, ``hpc``, ``job_submission``, ``multi_run``, ``simulation_sweep``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Folder Name
     - input_folder
     - file
     - —
     - ✓
     - Path or file-system reference to the folder containing the staged simulation input decks; all subdirectories will be scanned for files matching the main file pattern.
   * - Main File Pattern
     - main_file_pattern
     - text
     - —
     - ✓
     - Glob or regex pattern (e.g. '*.key' or '*.inp') used to identify the primary input deck file inside each simulation sub-folder; must match exactly one file per run directory.
   * - Name Prefix
     - simulation_prefix
     - text
     - —
     - ✓
     - Short string prepended to each auto-generated simulation name to help identify the batch (e.g. 'Sweep_v3_'); leave blank only if unique naming is not required.
   * - Setting Name
     - hpcconfig
     - remote_lookup
     - —
     - ✓
     - HPC settings profile (selected from the platform registry) that defines the cluster, queue, solver executable, and resource limits to apply to every submitted job.
   * - Response Template
     - template_id
     - remote_lookup
     - —
     - 
     - Optional response template applied to each submitted simulation for automatic KPI extraction after the run completes; leave unset if no post-processing template is needed.
   * - Study Name
     - study_name
     - text
     - —
     - ✓
     - Name of the study or project grouping under which all submitted simulations will be registered, enabling consolidated result tracking and reporting.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Records
     - records
     - dataset
     - Dataset containing one row per submitted simulation with metadata columns such as simulation ID, name, submission status, and HPC job reference, suitable for downstream monitoring or reporting workers.

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

- cae.solver
- platform.hpc_config
- 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>job_submit_simulations_from_folder</code>. Schema hash: <code>e59deb915ffb</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>