SCALES THE LCREG CURVES BASED ON ERROR MATRIX¶
Computes mesh-size and strain-rate dependent scale factors for GISSMO regularization curves (LCREG/LCSR) by interpolating an error matrix across mesh sizes and strain rates, then applies those scales to the LCREG curves in a *MAT_ADD_EROSION or *MAT_ADD_DAMAGE_GISSMO keyword block. Use this worker when mesh-regularization calibration errors exceed an acceptable threshold and the LCREG/LCSR curves must be corrected before running production simulations.
When to use¶
Tagged: calibration, error_matrix, gissmo, lcreg, lcsr, mat_add_damage_gissmo, mat_add_erosion, mesh_size.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| GISSMO Material Data | material_data | textarea | — | ✓ | Full text of a valid LS-DYNA *MAT_ADD_EROSION or *MAT_ADD_DAMAGE_GISSMO keyword block whose LCREG/LCSR curve references will be scaled in place. |
| Data with Errors | errors_ds | dataset | — | ✓ | Dataset whose rows correspond to mesh sizes and whose columns contain per-strain-rate regularization errors (as percentages); drives the interpolated scale factors. |
| Column containing Mesh Size | mesh_size_col | text | — | ✓ | Name of the column in errors_ds that holds the mesh-element size values (e.g., mm); must match an actual column header in the dataset. |
| Columns containing Errors for each Strain-Rate | strain_rate_error_cols | text | — | ✓ | One or more column names in errors_ds representing the error (%) at each calibrated strain rate; order must align with the strain_rates input. |
| Strain-rates | strain_rates | text | 0.001,0.1,1.0 | ✓ | Comma-separated list of strain-rate values (e.g., ‘0.001,0.1,1.0’ s⁻¹) that correspond to the LCREG/LCSR curve IDs defined in the material keyword. |
| Min Mesh Size | min_mesh_size | scalar | 1.0 | Lower clamp on mesh size (mm, default 1.0); mesh sizes below this value reuse the scale factor computed at this boundary to avoid extrapolation. | |
| Max Mesh Size | max_mesh_size | scalar | 5.0 | Upper clamp on mesh size (mm, default 5.0); mesh sizes above this value reuse the scale factor computed at this boundary to avoid extrapolation. | |
| Type of Scaling | scale_type | select | lcreg | ✓ | Selects whether strain-rate-dependent LCREG curves (‘lcreg_sr’) or LCSR curves (‘lcsrs’) are the target of the computed scale factors. |
| Min Strain-rate | min_strain_rate | scalar | 0.0001 | Lower clamp on strain rate (s⁻¹, default 0.0001); queries below this value adopt the scale factor of the next higher defined strain rate. | |
| Max Strain-rate | max_strain_rate | scalar | 100 | Upper clamp on strain rate (s⁻¹, default 100); queries above this value adopt the scale factor of the next lower defined strain rate. | |
| Error Threshold | error_threshold | scalar | 20 | Percentage error tolerance (default 20 %); if the interpolated error for a mesh-size/strain-rate cell is below this value, that cell’s scale is left unchanged. | |
| User-defined Scales | scales | dataset | — | Optional user-supplied dataset of pre-computed scale factors; when provided these values override the error-matrix interpolation entirely. | |
| Column that has the Mesh Size | scales_mesh_col | scalar | Mesh Size | Column name in the user-defined scales dataset that contains the mesh-size values; required when the scales input is provided. | |
| Type of Threshold Scaling | threshold_scaling_type | select | total | ✓ | |
| Restrict to mesh sizes listed here | mesh_sizes | text | — | Column that contains the mesh sizes |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Updated Material-data | updated_material_data | textarea | Full LS-DYNA keyword text of the input material card with LCREG/LCSR curve point values updated to reflect the computed scale factors. |
| Unscaled Regularization Scale-factors | un_scaled_lcreg | vector | Vector of original LCREG regularization scale-factor values extracted from the material card before any scaling is applied. |
| Scaled Regularization Scale-factors | scaled_lcreg | vector | Vector of LCREG regularization scale-factor values after mesh-size and strain-rate dependent scaling has been applied. |
| Un-scaled LCSR | un_scaled_lcsr | vector | Vector of original LCSR strain-rate scale-factor values extracted from the material card before any scaling is applied. |
| Scaled LCSR | scaled_lcsr | vector | Vector of LCSR strain-rate scale-factor values after mesh-size and strain-rate dependent scaling has been applied. |
| LCREG Scale Ratios | lcreg_scales | vector | Vector of multiplicative scale ratios (scaled / unscaled) for each LCREG curve point, useful for auditing the magnitude of corrections. |
| LCREG Scale Factor Table | lcreg_scale_factors | vector | Tabulated (mesh-size × strain-rate) matrix of the final LCREG scale factors used during the correction, suitable for downstream reporting or visualization. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.failure
Auto-generated from platform schema. Worker id: gissmo_scale_regularization_scale_factors. Schema hash: aa6010dd1f55. Hand-curated docs in workerexamples/ override this page when present.