evaluate_failure_criteria#

CompositeModel.evaluate_failure_criteria(combined_criterion, composite_scope=None, measure=FailureMeasureEnum.INVERSE_RESERVE_FACTOR, write_data_for_full_element_scope=True, max_chunk_size=50000)#

Get a fields container with the evaluated failure criteria.

The fields container contains the maximum per element if the measure is FailureMeasureEnum.INVERSE_RESERVE_FACTOR and the minimum per element if the measure is FailureMeasureEnum.MARGIN_OF_SAFETY or FailureMeasureEnum.RESERVE_FACTOR.

Parameters:
  • combined_criterion (CombinedFailureCriterion) – Combined failure criterion to evaluate.

  • composite_scope (Optional[CompositeScope], default: None) – Composite scope on which to evaluate the failure criteria. If empty, the criteria is evaluated on the full model. If the time is not set, the last time or frequency in the result file is used.

  • measure (FailureMeasureEnum, default: <FailureMeasureEnum.INVERSE_RESERVE_FACTOR: 'inverse_reserve_factor'>) – Failure measure to evaluate.

  • write_data_for_full_element_scope (bool, default: True) – Whether each element in the element scope is to get a (potentially zero) failure value, even elements that are not part of composite_scope.plies. If no element scope is specified (composite_scope.elements), a (potentially zero) failure value is written for all elements.

  • max_chunk_size (int, default: 50000) –

    A higher value results in more memory consumption, but faster evaluation.

    Note

    For some special element types such as beams, write_data_for_full_element_scope=True is not supported.

Return type:

FieldsContainer