ASSEMBLER: SUBMIT DOE STUDY FOR SYSTEM MODEL¶
Creates a DOE study from a system model by generating a baseline simulation, assembling experiment variations from DOE parameters, and optionally submitting all simulations to HPC. Use this worker to automate the full study setup pipeline — from system-model selection through loadcase assignment, assembly configuration, and batch HPC dispatch.
When to use¶
Tagged: assembler, assembly, baseline, batch_submit, doe, experiment, hpc, loadcase.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| System Model | systemmodel_id | remote_lookup | — | ✓ | Remote lookup selecting the system model that defines the simulation structure; required as the root source of all generated experiments. |
| Baseline Simulation Name | input_sim_name | text | — | Human-readable name for the baseline simulation; auto-generated from the name pattern if left blank. | |
| Simulation Name Pattern | simulation_name_pattern | text | — | Token-based naming pattern for generated simulations (e.g. <%SM_NAME%>_<%LC_NAME%>_<%TIMESTAMP%>); used whenever a simulation name is not explicitly provided. | |
| Simulation Description | description | textarea | — | Free-text description attached to each generated simulation record; leave blank to omit a description. | |
| Tags | tags | text | — | Comma-separated tags applied to the generated simulations for downstream filtering and search. | |
| Solver Type | solver_type | text | lsdyna | Solver engine used for job submission; defaults to ‘lsdyna’ — change only when targeting a different solver backend. | |
| Project | input_project_id | remote_lookup | — | Remote lookup selecting the project under which all generated simulations are registered; leave null to use the system-model’s default project. | |
| Loadcase | loadcase_id | remote_lookup | — | Remote lookup selecting the loadcase applied to the baseline and experiment simulations; leave null to inherit the system model’s default loadcase. | |
| Assembly IDs | assembly_ids | text | — | Comma-separated list of assembly IDs to include in the model build; leave empty to include all assemblies defined in the system model. | |
| Include Structure | include_structure | textarea | — | JSON blob controlling assembly ordering, disabled flags, and geometric transforms; leave blank to use default assembly structure from the system model. | |
| Response Template | template_id | remote_lookup | — | Remote lookup selecting a response template to attach to all generated simulations for automated KPI extraction; leave null if no template is required. | |
| HPC Setting | hpcjob_setting | remote_lookup | — | Remote lookup selecting the HPC configuration (cluster, queue, resources) used for job submission; required unless skip_submission is true. | |
| Physical Test | physicaltest_id | remote_lookup | — | Remote lookup linking a physical test record to the study for sim-vs-test correlation; leave null if no physical test is associated. | |
| Alternate Main Input File Name | alt_main_input_file_name | text | — | Override filename for the main solver input deck (e.g. ‘main.key’); leave blank to use the system model’s default input file name. | |
| Alternate Main Input File Content | alt_main_input_file_content | textarea | — | Full text content of an alternate main input file to substitute into the deck; leave blank to use the system model’s generated content. | |
| Study Name | study_name | text | — | Name assigned to the new DOE study; auto-generated from the system model and timestamp if not provided. | |
| Study Description | study_description | textarea | — | Free-text description attached to the DOE study record; leave blank to omit. | |
| Existing Study | study_id | remote_lookup | — | Remote lookup selecting an existing study to append new experiments to; leave null to create a fresh study. | |
| DOE Parameters | parameters | textarea | — | ✓ | JSON array of parameter definitions with ranges and levels |
| Experiment Type | experiment_type | text | all | Options: all, yes (baseline only), random_sampling, bounds | |
| Number of Random Samples | num_random_sampling | integer | 3 | ||
| Skip Submission | skip_submission | text | no | ||
| Iteration Number | iteration_number | integer | 1 | ||
| Start Index | start_index | integer | 1 | ||
| LS-DYNA Format | format | text | short | Options: short, long, auto | |
| Add to Existing Study | add_to_existing_study | text | no | If a study with the same name exists, add experiments to it | |
| Verify Template | verify_template | text | no | Check response template for missing dependencies before running |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Study Id | study_id | scalar | Platform identifier of the created (or updated) DOE study; use as input to downstream study-analysis or reporting workers. |
| Baseline Simulation Id | baseline_simulation_id | integer | Integer ID of the baseline simulation generated from the system model; represents the nominal, unperturbed design point. |
| Simulations | simulations | dataset | Dataset of all simulation records created for this study, including the baseline and all DOE experiment variants. |
| Template Id | template_id | integer | Integer ID of the response template attached to the study simulations; pass to post-processing workers for KPI extraction. |
| Experiments With Sim Ids | experiments_with_sim_ids | dataset | Dataset mapping each DOE experiment row (with its parameter values) to the simulation ID assigned for execution. |
| Logs | logs | dataset | Execution log records capturing worker activity, warnings, and errors produced during study creation and submission. |
Disciplines¶
- cae.preprocessing.deck_authoring
- cae.preprocessing.scenario
- cae.solver
- design_exploration.doe
- platform.job_submission
Auto-generated from platform schema. Worker id: assembler_submit_doe_for_systemmodel. Schema hash: a5e545b0a964. Hand-curated docs in workerexamples/ override this page when present.