## On this page

  

 

 # composite:evaluate\_failure\_criterion\_per\_scope

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Evaluates failure criteria for a specified scope.

## Inputs

InputNameExpected type(s)Description**Pin 1**   
Requiredelement\_scoping[`scoping`](../../core-concepts/dpf-types.md#scoping)Element scoping on which failure criteria are evaluated**Pin 3**   
Requiredstream\_provider[`streams_container`](../../core-concepts/dpf-types.md#streams-container)Stream with result file.**Pin 7**   
Requiredmesh[`abstract_meshed_region`](../../core-concepts/dpf-types.md#meshed-region)Mesh (including layup information if available)**Pin 22**material\_fields`umap<string,struct dataProcessing::composite::ImportedMaterialField>`Material fields: Only needed if has\_layup\_provider is true**Pin 23**   
Requiredmaterials\_container`materials_container`Materials container**Pin 24**section\_data\_container[`fields_container`](../../core-concepts/dpf-types.md#fields-container)Section Data Container: Only needed if has\_layup\_provider is true**Pin 25**mesh\_properties\_container[`fields_container`](../../core-concepts/dpf-types.md#fields-container)Mesh Properties Container Container: Only needed if has\_layup\_provider is true**Pin 100**   
Requiredcriterion\_configuration[`string`](../../core-concepts/dpf-types.md#standard-types)Failure criteria configuration**Pin 217**   
Requiredhas\_layup\_provider[`bool`](../../core-concepts/dpf-types.md#standard-types)Deprecated since 2024 R2. Use input pin 218instead. Should be set to true if layup information is available. Equivalent new input is ACP (1).**Pin 218**   
Requiredlayup\_model\_context\_type[`int32`](../../core-concepts/dpf-types.md#standard-types)Define the source of section data. Values are: 0=not available, 1=ACP, 2=RST, 3=MIXED (ACP+RST).**Pin 302**   
Requiredrequest\_sandwich\_results[`bool`](../../core-concepts/dpf-types.md#standard-types)Request results for sandwich failure criteria.**Pin 303**use\_live\_evaluation[`bool`](../../core-concepts/dpf-types.md#standard-types)Use live evaluation. Default: False**Pin 307**   
Requiredscope\_configuration`struct dataProcessing::composite::CompositeScopeConfig`Scope configuration## Outputs

OutputNameExpected type(s)Description**Pin 304**failure\_container[`fields_container`](../../core-concepts/dpf-types.md#fields-container)Fields container with the failure results**Pin 306**time\_id[`int32`](../../core-concepts/dpf-types.md#standard-types)Requested time id**Pin 400**strains\_container[`fields_container`](../../core-concepts/dpf-types.md#fields-container)Fields container with the strains**Pin 401**stresses\_container[`fields_container`](../../core-concepts/dpf-types.md#fields-container)Fields container with the stresses## Configurations

NameExpected type(s)Default valueDescription**mutex**[`bool`](../../core-concepts/dpf-types.md#standard-types)falseIf this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.## Scripting

**Category**: composite

**Plugin**: composite

**Scripting name**: evaluate\_failure\_criterion\_per\_scope

**Full name**: composite.evaluate\_failure\_criterion\_per\_scope

**Internal name**: composite::evaluate\_failure\_criterion\_per\_scope

**License**: None

## Changelog

- Version 0.0.0: Initial release.