CREATES A UNI-AXIAL RESPONSE TEMPLATE FOR DATA EXTRACTION¶
Creates a reusable uniaxial-tension response template that maps simulation sensor IDs (nodes, cross-sections, part IDs) to standard KPI channels (force-displacement, engineering/true stress-strain, DIC strain). Use this worker to configure and register the extraction template before running post-processing or curve-matching workflows on uniaxial coupon simulations.
When to use¶
Tagged: coupon, dic, extraction, force_displacement, kpi, response_template, specimen, stress_strain.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| IFTES( | import_from_file | file | — | Optional helper file (e.g. a binout or d3plot) used to auto-populate sensor IDs such as node labels and section IDs; leave empty if entering sensor IDs manually. | |
| Template Name | template_name | text | Generic Uniaxial Tensile Template | ✓ | Human-readable name assigned to the new response template; defaults to ‘Generic Uniaxial Tensile Template’ and must be unique unless Delete Existing is set to Yes. |
| Reference Curve | ref_curve | vector | — | ✓ | Physical test reference curve (XY vector) used to compute curve-match error against the simulation; supply as a force-displacement or stress-strain pair matching the selected Reference Type. |
| Reference Type | ref_curve_type | select | fd | ✓ | Type of the reference curve supplied above — one of Force-Displacement (fd), Engineering Stress-Strain (eng_ss), True Stress-Strain (true_ss), or DIC Strain vs Displacement (dic_strain); must match the physical units of ref_curve. |
| Elastic Modulus | emod | text | 210 | ✓ | Elastic modulus of the material in GPa (default 210 GPa for steel); used to compute derived stress-strain KPIs and elastic-regime identification. |
| Poisson Ratio | pr | text | 0.3 | ✓ | Poisson’s ratio of the material (dimensionless, default 0.3); used together with the elastic modulus for volumetric and lateral strain calculations. |
| Specimen PID | specimen_pid | text | 1 | ✓ | LS-DYNA Part ID (PID) of the uniaxial coupon mesh; default is 1 — update to match the actual part ID in the simulation deck. |
| Section Id | force_cross_section_id | text | 1 | ✓ | LS-DYNA cross-section (DATABASE_CROSS_SECTION) ID used to extract the reaction force time-history; default is 1. |
| N1IOL | disp_node1_id | text | 1 | ✓ | Node ID or label for the first gauge-length reference node (N1) used to compute axial displacement/strain; default is 1. |
| N2IOL | disp_node2_id | text | 2 | ✓ | Node ID or label for the second gauge-length reference node (N2) used to compute axial displacement/strain; default is 2. |
| WN1IOL | width_node1_id | text | 3 | ✓ | Node ID or label for the first width-direction reference node (WN1) used to compute lateral strain and Poisson-ratio checks; default is 3. |
| WN2IOL | width_node2_id | text | 4 | ✓ | Node ID or label for the second width-direction reference node (WN2) used to compute lateral strain; default is 4. |
| Delete Existing | delete_existing | select | no | ✓ | Controls whether a pre-existing template with the same name is overwritten (Yes) or left in place causing the worker to abort (No, default); set to Yes when iterating on template definitions. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Template Id | template_id | integer | Integer ID of the newly created (or replaced) uniaxial-tension response template in the d3VIEW platform, passable directly to downstream post-processing or curve-matching workers. |
Disciplines¶
- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.material.characterization
- engineering.material.specimen
Auto-generated from platform schema. Worker id: template_create_uniaxial_tension. Schema hash: 385e8b915693. Hand-curated docs in workerexamples/ override this page when present.