ASSEMBLER: SUBMIT SIMULATION FOR SYSTEM MODEL¶
Creates a simulation record from a system model by resolving include structure, transforms, stamped parts, and loadcase variable substitution, then optionally submits the assembled deck to HPC. Use this worker to go from a configured system model and loadcase directly to a running (or queued) simulation in one step.
When to use¶
Tagged: assembler, deck_assembly, hpc, include_handling, loadcase, lsdyna, simulation, stamped_parts.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| System Model | systemmodel_id | remote_lookup | — | ✓ | The system model to assemble; resolved via the platform’s system-model registry — required, no default. |
| Simulation Name | input_sim_name | text | — | Explicit name for the created simulation; when provided it overrides the pattern-generated name entirely — leave blank to rely on simulation_name_pattern. | |
| Simulation Name Pattern | simulation_name_pattern | text | <%SM_NAME%>_<%LC_NAME%>_<%TIMESTAMP%> | Token pattern used to auto-generate the simulation name when input_sim_name is not set; supports <%SM_NAME%>, <%LC_NAME%>, <%TIMESTAMP%>, <%DATE%>, <%UNIQUE_ID%> — defaults to <%SM_NAME%>_<%LC_NAME%>_<%TIMESTAMP%>. | |
| Simulation Description | description | textarea | — | Free-text description attached to the created simulation record — optional, leave blank if not needed. | |
| Tags | tags | text | — | Comma-separated labels attached to the simulation for filtering/search in the platform UI — optional. | |
| Solver Type | solver_type | text | lsdyna | Solver identifier passed to the HPC job; defaults to ‘lsdyna’ — change only when targeting a different solver backend. | |
| Project | input_project_id | remote_lookup | — | Project under which the simulation is created; defaults to null, in which case the system model’s own project is used. | |
| Loadcase | loadcase_id | remote_lookup | — | ✓ | Loadcase used for template content resolution and variable substitution; must belong to the same project as the system model unless add_loadcase_to_curr_project is true — required. |
| Auto-duplicate Loadcase to Project | add_loadcase_to_curr_project | boolean | False | When true, a cross-project loadcase is automatically duplicated into the system model’s project before assembly; when false a project-mismatch raises an error — defaults to false. | |
| Assembly IDs | assembly_ids | text | — | Comma-separated list of assembly IDs to include in the deck; leave empty to include all assemblies defined in the system model. | |
| Include Structure | include_structure | textarea | — | JSON blob controlling per-assembly ordering, disabled flags, and transform configurations (e.g. forming/stamping transforms) — leave empty to use system model defaults. | |
| Parameters | parameters | textarea | — | JSON key-value map of additional variables injected into loadcase template substitution — leave empty when no extra parameter overrides are needed. | |
| Response Template | template_id | remote_lookup | — | Response template to attach to the simulation for automatic KPI extraction after the run completes — optional, resolved via the platform’s response-template registry. | |
| HPC Setting | hpcjob_setting | remote_lookup | — | Required unless skip_submission is ‘yes’. When provided, the simulation is submitted to HPC and solver_type is derived from this setting. | |
| Skip Submission | skip_submission | text | no | Set to ‘yes’ to create simulation without submitting to HPC | |
| Physical Test | physicaltest_id | remote_lookup | — | ||
| Alternate Main Input File Name | alt_main_input_file_name | text | — | Override the main input file name from the system model | |
| Alternate Main Input File Content | alt_main_input_file_content | textarea | — | Override the main input file content entirely |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Simulation Id | simulation_id | integer | Integer primary key of the newly created simulation record in the platform database; use as input to downstream post-processing or monitoring workers. |
| Hpcjob Id | hpcjob_id | integer | Integer primary key of the HPC job submitted for this simulation; null when the worker is run in assemble-only mode without submission. |
| Loadcase Duplicated | loadcase_duplicated | json | JSON object populated only when add_loadcase_to_curr_project triggered a duplication; contains loadcase_id, loadcase_name, files_copied, and files_skipped for audit purposes — null otherwise. |
Disciplines¶
- cae.preprocessing.deck_authoring
- cae.preprocessing.scenario
- cae.solver
- platform.job_submission
Auto-generated from platform schema. Worker id: assembler_submit_simulation_for_systemmodel. Schema hash: 587c69ba7035. Hand-curated docs in workerexamples/ override this page when present.