    

 ## On this page

  

 

 # composite:composite\_failure\_operator

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Uses json failure configuration to compute evaluate composite failure criterion.

## Inputs

InputNameExpected type(s)Description**Pin 100**   
Requiredresult\_definition[`string`](../../core-concepts/dpf-types.md#standard-types)Combined failure criterion configuration (string of json dict)**Pin 310**unit\_system`class dataProcessing::unit::CUnitSystem`, [`result_info`](../../core-concepts/dpf-types.md#result-info), [`int32`](../../core-concepts/dpf-types.md#standard-types), [`string`](../../core-concepts/dpf-types.md#standard-types)Default unit system. Used if the result file specifies no unit system. Can be unit system object, result\_info object int or string.In case of int it is one of the predefined Ansys unit system ids, in case of string it should be a semicolon separated list of units.## Outputs

OutputNameExpected type(s)Description**Pin 0**fields\_containerMin[`fields_container`](../../core-concepts/dpf-types.md#fields-container)A CFieldsContainer of CFields with the minimal failure value results. Contains data for the failure value,failure mode and layer index**Pin 1**fields\_containerMax[`fields_container`](../../core-concepts/dpf-types.md#fields-container)A CFieldsContainer of CFields with the maximum failure value results. Contains data for the failure value,failure mode and layer index**Pin 2**fields\_containerMin\_ref\_surface[`fields_container`](../../core-concepts/dpf-types.md#fields-container)A CFieldsContainer of CFields with the minimum failure value results. Contains data for the failure value,failure mode, global stack index, per element stack index and solid element id**Pin 3**fields\_containerMax\_ref\_surface[`fields_container`](../../core-concepts/dpf-types.md#fields-container)A CFieldsContainer of CFields with the maximum failure value results. Contains data for the failure value,failure mode, global stack index, per element stack index and solid element id**Pin 402**cache\_status[`data_tree`](../../core-concepts/dpf-types.md#data-tree)Cache status for the different inputs. A data tree with the attributes: rst\_data\_source, default\_unit\_system, layup\_data\_source, engineering\_data\_source, material\_support and ref\_surface\_unit\_system. Each attribute is an int that is 1 if the cache was hit and 0 if not.## 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**: composite\_failure\_operator

**Full name**: composite.composite\_failure\_operator

**Internal name**: composite::composite\_failure\_operator

**License**: None

## Changelog

- Version 0.0.0: Initial release.