.. _auto_simulation_import_from_dataset:

*SIMULATION IMPORT FROM DATASET*
================================

Reads rows from a platform dataset and bulk-creates named Simulation records, one per row. Use it when you need to bootstrap a simulation study from a structured spreadsheet or upstream dataset result. An optional name prefix and description column allow fine-grained labelling of every generated simulation.

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

Tagged: ``bulk_create``, ``dataset``, ``import``, ``simulation``, ``simulations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Dataset
     - dataset
     - dataset
     - —
     - ✓
     - Source platform dataset whose rows will be converted into Simulation records; each row produces exactly one simulation.
   * - Choose Name Column
     - name_col
     - scalar
     - —
     - ✓
     - Column in the dataset whose value is used as the primary name of each created simulation; required, column list is populated dynamically from the chosen dataset.
   * - Choose Description Column
     - desc_col
     - scalar
     - —
     - 
     - Optional column whose value is written to the description field of each simulation; leave blank to create simulations with no description.
   * - Name Prefix
     - name_prefix
     - scalar
     - —
     - 
     - Optional free-text string prepended to every simulation name (e.g. 'RUN_'); leave blank to use the name column value as-is.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Num Sim
     - num_sim
     - scalar
     - Integer count of Simulation records successfully created during this invocation.
   * - Simulations
     - simulations
     - dataset
     - Platform dataset of type 'simulations' containing references to all newly created Simulation records, one row per simulation.

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

- data.dataset.ingest
- 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_import_from_dataset</code>. Schema hash: <code>a146034610dd</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>