.. _auto_assembler_fetch_simulation_ids:

*ASSEMBLER FETCH SIMULATION IDS*
================================

Fetches all simulation IDs associated with a set of loadcase, system model, or study IDs, resolving both direct simulations and those linked through DOE studies. Returns a deduplicated CSV of simulation IDs together with a per-source count breakdown and a human-readable summary.

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

Classification: **default**.

Tagged: ``assembler``, ``batch_fetch``, ``csv``, ``loadcase``, ``simulation_ids``, ``study``, ``system_model``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - ID Type
     - id_type
     - select
     - —
     - ✓
     - Selector that controls the resolution strategy: 'loadcase' finds simulations via loadcase_id, 'systemmodel' collects direct and study-linked simulations from system model records, and 'study' extracts simulations from DOE study targets.
   * - IDs
     - ids
     - text
     - —
     - ✓
     - Comma-separated list of integer IDs whose type must match the id_type selection (e.g., '123,456,789'); at least one valid ID is required.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation IDs (CSV)
     - simulation_ids_csv
     - text
     - Comma-separated string of all unique simulation IDs resolved from the provided input IDs; empty string if none are found.
   * - Simulation Count
     - simulation_count
     - number
     - Integer count of unique simulations contained in simulation_ids_csv; useful for downstream loop or guard logic.
   * - Breakdown
     - breakdown
     - json
     - JSON object keyed by source ('direct', 'from_studies') and by input entity (loadcase / system model / study ID), giving per-entity simulation counts and any input IDs that returned no results.
   * - Summary
     - summary
     - text
     - Human-readable text summary of the fetch operation, including total simulations found and how many input IDs were not matched; suitable for logging or report annotations.

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

- cae.preprocessing.scenario
- 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>assembler_fetch_simulation_ids</code>. Schema hash: <code>f68dd4d7dc7b</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>