.. _auto_assembler_create_systemmodel_from_assemblies:

*CREATE A SYSTEM MODEL FROM ASSEMBLIES*
=======================================

Creates a named system model from one or more assembly files (LS-DYNA .key/.k/.incl or archive formats) within a specified project, optionally associating it with a design step and configuring *INCLUDE_PATH handling. Use this worker to register a new top-level system model entity in the d3VIEW ontology graph before linking sub-assemblies or running simulations.

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

Tagged: ``assembly``, ``deck_authoring``, ``graph``, ``include_path``, ``keyword``, ``ls-dyna``, ``ontology``, ``system_model``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - System Model Name
     - name
     - text
     - —
     - ✓
     - Unique display name for the new system model (plain text, required); used as the node label in the ontology graph.
   * - Description
     - description
     - textarea
     - —
     - 
     - Optional free-text description of the system model's purpose or contents; leave blank if no additional context is needed.
   * - Type
     - type
     - text
     - generic
     - 
     - Semantic type of the system model (e.g. 'Vehicle', 'Phone', 'generic'); defaults to 'generic' when left blank.
   * - Color
     - color
     - color
     - #000000
     - ✓
     - Hex color code (e.g. '#FF5733') used to visually distinguish this system model node in the graph visualization; defaults to '#000000' (black).
   * - Design Step
     - designstep_id
     - remote_lookup
     - —
     - 
     - Optional design step to associate with this system model; select from the remote lookup of existing design steps, or leave blank to attach no design step.
   * - Project
     - project_id
     - remote_lookup
     - —
     - ✓
     - Project under which the system model will be created; must be selected from the remote lookup of available projects (required).
   * - Tags
     - tags
     - text
     - —
     - 
     - Optional comma-separated list of free-text tags for filtering and searching the system model (e.g. 'baseline,v1,frontal').
   * - Include Path Method
     - include_type
     - select
     - no_include_path
     - 
     - Controls whether an LS-DYNA *INCLUDE_PATH keyword is embedded in the system model; choose 'Include Path' to add it or leave at default 'No Include Path' to omit it.
   * - Files
     - files
     - file
     - —
     - 
     - One or more LS-DYNA deck files (.key, .k, .incl) or archives (.zip, .tar) to ingest as the assembly source for the system model; hidden field populated programmatically or via file upload.
   * - Assemblies
     - assemblies
     - remote_lookup
     - —
     - 
     - Select one or more assemblies to be included in the system model.
   * - Assembly Structure
     - assembly_structure
     - json
     - —
     - 
     - 
   * - Main Input File Name
     - main_input_file_name
     - text
     - Main.k
     - 
     - 
   * - Main Input Content
     - main_input_content
     - textarea
     - Main.k
     - 
     - 
   * - Existing System Model Id
     - systemmodel_id
     - text
     - —
     - 
     - If specified, the existing System Model is updated with the provided information instead of creating a new one.
   * - Parent Systemmodel
     - parent_id
     - remote_lookup
     - —
     - 
     - Parent from which the current Systemmodel was inherited
   * - Extra Data
     - extra_data
     - textarea
     - —
     - 
     - Valid JSON data
   * - Include Structure
     - include_structure
     - textarea
     - —
     - 
     - JSON with assembly ordering, disabled flags, transforms, and C parameters
   * - Parameters
     - parameters
     - textarea
     - —
     - 
     - JSON parameter definitions (centralized/distributed mode)

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - System Model ID
     - systemmodel_id
     - integer
     - Integer primary key of the newly created (or updated) system model record in d3VIEW; pass this downstream to workers that attach assemblies, run solvers, or query the ontology graph.

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

- cae.preprocessing.deck_authoring
- cae.preprocessing.scenario
- platform.ontology

.. 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_create_systemmodel_from_assemblies</code>. Schema hash: <code>309f1b2080bf</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>