.. _auto_polymer_uniaxial_sequential_calibration:

*POLYMER UNIAXIAL CALIBRATOR*
=============================

Sequentially calibrates a polymer material model from uniaxial test data by running a series of LS-DYNA simulations on HPC to identify elastic, crazing, stabilization, hardening, and post-necking parameters. Provide a test engineering stress-strain curve, initial elastic constants, and a specimen input deck; the worker returns a simulation record and a populated response template for downstream KPI extraction.

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

Tagged: ``crazing``, ``hardening``, ``hpc``, ``ls-dyna``, ``material_calibration``, ``necking``, ``polymer``, ``sequential_calibration``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Study Name
     - study_name
     - text
     - Polymer Calibration
     - ✓
     - Human-readable label for the calibration study; used as the study record name in the platform (free text, default: 'Polymer Calibration').
   * - Material Name
     - material_name
     - text
     - Polymer Material
     - ✓
     - Identifier for the polymer material being calibrated; propagated into result records and the generated material card (free text, default: 'Polymer Material').
   * - TESSC
     - test_eng_stress_strain
     - vector
     - —
     - ✓
     - Engineering stress-strain curve measured from a uniaxial coupon test (vector of paired stress/strain values); this is the reference target for all sequential calibration stages.
   * - Elastic Modulus
     - emod
     - text
     - 10
     - ✓
     - Initial elastic (Young's) modulus of the polymer in the model's pressure units (e.g. GPa or MPa); used as the fixed elastic parameter during sequential fitting (default: 10).
   * - Poisson Ratio
     - pr
     - text
     - 0.3
     - ✓
     - Poisson's ratio of the polymer (dimensionless, 0–0.5); controls volumetric response during the elastic phase (default: 0.3).
   * - SLIF
     - specimen_file
     - file
     - —
     - ✓
     - LS-DYNA keyword input file (.k / .key) defining the uniaxial coupon model geometry, boundary conditions, and an initial material curve; the curve referenced by curve_id must be present in this file.
   * - Choose Uniaxial Template
     - template_id
     - text
     - 1
     - ✓
     - Integer ID of the d3VIEW response template to apply to each simulation run for automated KPI extraction (default: 1; select an existing template from the platform).
   * - HCIITSFTR
     - curve_id
     - text
     - 1
     - ✓
     - Integer ID of the stress-strain curve defined inside the specimen LS-DYNA input file that will be replaced/updated during calibration; the curve must already exist in the deck (default: 1).
   * - NOPBTNAFTCFC
     - num_points
     - text
     - 5
     - ✓
     - Number of control points used to parameterise the post-necking portion of the true stress-strain curve; 5 is sufficient for mildly nonlinear behaviour — increase for highly nonlinear post-necking (default: 5).
   * - Choose HPC Configuration
     - hpcconfig_id
     - remote_lookup
     - —
     - ✓
     - Platform HPC configuration record (remote_lookup) specifying the cluster, queue, solver version, and resource limits for all LS-DYNA jobs submitted during calibration; must be a valid hpc_settings entry.
   * - Execution Type
     - execution_type
     - select
     - test
     - ✓
     - Calibration stage to execute: 'test' (dry-run validation), 'baseline' (initial forward run), 'crazing' (crazing duration identification), 'stabilization' (stability identification), 'hardening' (hardening identification), or 'post_necking' (post-necking hardening); stages are intended to be run sequentially.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Platform integer ID of the LS-DYNA simulation record created for the executed calibration stage; use this to retrieve results, binout data, or status from the simulation database.
   * - Template Id
     - template_id
     - integer
     - Integer ID of the response template instance populated with KPIs from this calibration run; pass to downstream postprocessing or reporting workers to extract and compare curves.

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

- cae.solver
- engineering.material.calibration
- engineering.material.characterization
- engineering.material.specimen
- platform.hpc_config
- platform.job_submission

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>polymer_uniaxial_sequential_calibration</code>. Schema hash: <code>fe28ad95367c</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>