MATF

Bulk Data Entry Defines material properties and failure model parameters for Failure criteria calculations.

Format

(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
MATF MID                
  CRI CRITERIA TID/V1 V2 V3 V4 V5 V6  
  V7 V8 V9   V10 V11 V12 W1  
  W2 W3 W4            
  etc                

Example

(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
MATF 100                
  CRI PUCK 3.E5 3.E5 3.E5 3.E5 3.E5    
                0.25  
  0.25 0.25              

Definitions

Field Contents SI Unit Example
MID Material identification number.

(Integer > 0)

 
CRI CRI flag indicating that the failure criterion input data are to follow. 9  
CRITERIA Character String representing the chosen failure criterion.
PUCK
Puck failure criterion.
HILL
Hill failure criterion.
HOFF
Hoffman failure criterion.
TSAI
Tsai-Wu failure criterion.
HASH
Hashin failure criterion.
STRN
Maximum strain failure criterion.
STRS
Maximum stress failure criterion.
DUCTILE
Damage initiation criterion.
PUCK3D
Puck failure criterion for continuum shell elements.
HILL3D
Hill failure criterion for continuum shell elements/solid elements with anisotropic material.
HOFF3D
Hoffman failure criterion for continuum shell elements/solid elements with anisotropic material.
TSAI3D
Tsai-Wu Failure criterion for continuum shell elements/solid elements with anisotropic material.
HASH3D
Hashin failure criterion for continuum shell elements.
STRND3D
Maximum strain failure criterion for continuum shell elements/solid elements with anisotropic material.
STRS3D
Maximum stress failure criterion for continuum shell elements/solid elements with anisotropic material.
CNTZ3D
Cuntze failure criterion for continuum shell elements.

No default

 
TID Identification number of a TABLEMD entry that identifies the equivalent plastic strain (Yi) at the onset of damage versus temperature (Xi). 7  
Vi Material stress limits. 2 3

(Real > 0.0)

 
Wi Parameters for failure criteria calculations. 4
W1
Failure envelope factor 12(-).
W2
Failure envelope factor 12(+)
If blank, set to be equal to W1, W1 and W3 should be specified.
W3
Failure envelope factor 22(-).
W4
Failure envelope factor 22(+).
This is only used for PUCK3D.

(Real > 0.0)

 

Comments

  1. MID field may refer to MAT1, MAT2, MAT8, MAT9 or MAT9OR entries.
  2. For laminated shells (PCOMP/PCOMPP/PCOMPG).
    V1, V2, through V5 specify material stress/strain limits.
    V1
    Tensile stress/strain limit in longitudinal direction
    V2
    Compressive stress/strain limit in longitudinal direction
    V3
    Tensile stress/strain limit in lateral direction
    V4
    Compressive stress/strain limit in lateral direction
    V5
    In-plane shear stress/strain limit

    For STRS failure criterion, the input allowables should be stress-allowables.

    For STRN failure criterion, the input allowables should be strain-allowables. OptiStruct will not conduct internal conversion for STRN failure criterion. The values defined are directly used as strain-allowables for STRN failure criterion on MATF.

    For STRN failure criterion, the STRN field on MAT8 entry has no effect on the allowable values defined on the MATF entry.

    For Solid Elements (MAT9/MAT9OR) and Continuum Shells (PCOMPLS).

    V1, V2 through V9 specify material stress/strain limits.
    V1
    Tensile stress/strain limit in 1-1 direction
    V2
    Compressive stress/strain limit in 1-1 direction
    V3
    Tensile stress/strain limit in 2-2 direction
    V4
    Compressive stress/strain limit in 2-2 direction
    V5
    Tensile stress/strain limit in 3-3 direction
    V6
    Compressive stress/strain limit in 3-3 direction
    V7
    Shear stress/strain limit in 1-2 direction
    V8
    Shear stress/strain limit in 2-3 direction
    V9
    Shear stress/strain limit in 1-3 direction

    Coordinate system 1-2-3 are user-defined for continuum shell elements or solid elements with MAT9.

    For STRS3D failure criterion, the input allowables should be stress-allowables.

    For STRN3D failure criterion, the input allowables should be strain-allowables. OptiStruct will not conduct internal conversion for STRN3D failure criterion. The values defined are directly used as strain-allowables for STRN3D failure criterion on MATF.

  3. V10, V11, and V12 are used for TSAI/TSAI3D criterion.
    • For TSAI:
      • V10: the coupling coefficient C 12 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaam4qamaaBa aaleaacaaIXaGaaGOmaaqabaaaaa@3862@ for the σ 1 σ 2 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaeq4Wdm3aaS baaSqaaiaaigdaaeqaaOGaeq4Wdm3aaSbaaSqaaiaaikdaaeqaaaaa @3B56@ term.
      • If V10 is blank, the coupling coefficient is calculated from W1.
      • If V10 and W1 are both blank, the coupling coefficient is 0.0.
    • For TSAI3D:
      • V10: the coupling coefficient C 12 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaam4qamaaBa aaleaacaaIXaGaaGOmaaqabaaaaa@3862@ for the σ 1 σ 2 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaeq4Wdm3aaS baaSqaaiaaigdaaeqaaOGaeq4Wdm3aaSbaaSqaaiaaikdaaeqaaaaa @3B56@ term.
      • V11: the coupling coefficient C 23 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaam4qamaaBa aaleaacaaIXaGaaGOmaaqabaaaaa@3862@ for the σ 2 σ 3 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaeq4Wdm3aaS baaSqaaiaaikdaaeqaaOGaeq4Wdm3aaSbaaSqaaiaaiodaaeqaaaaa @3B58@ term.
      • V12: the coupling coefficient C 12 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaam4qamaaBa aaleaacaaIXaGaaGOmaaqabaaaaa@3862@ for the σ 1 σ 3 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaeq4Wdm3aaS baaSqaaiaaigdaaeqaaOGaeq4Wdm3aaSbaaSqaaiaaikdaaeqaaaaa @3B56@ term.
      • If V10, V11, and V12 are all blank, the coupling coefficients are calculated from W1, W2, and W3.
      • If V10, V11, and V12 and W1, W2, and W3 are all blank, the coupling coefficients are 0.0.
  4. W1, W2, W3, and W4 definition is dependent on the failure criterion specified.
    • PUCK/PUCK3D specify failure envelope parameters:
      W1
      Failure envelope factor 12(-)
      W2
      Failure envelope factor 12(+)
      If W2 is blank, it is set to be equal to W1, W1 and W3 should be specified.
      W3
      Failure envelope factor 22(-)
      W4
      Failure envelope factor 22(+).
      This is only used for PUCK3D.
    • TSAI3D on anisotropic solid material

      If V10, V11 and V12 are blank, they are the tensile stress limits in equal-biaxial tension tests. W1 is the tensile stress limit in equal-biaxial tests where the two tensile loads are in directions 1 and 2. W1 is mandatory, while W2 and W3 are optional. If W2 and W3 are not specified, then they are set equal to W1. The definition of W2 and W3 is similar to W1. W2 is the tensile stress limit in equal-biaxial tension tests where the two tensile loads are in directions 2 and 3. W3 is the tensile stress limit in equal-biaxial tension tests where the two tensile loads are in directions 1 and 3.

      If V10, V11 and V12 are defined, W1, W2 and W3 are ignored for TSAI3D.

    • HASH3D

      When Hashin failure criteria is applied on continuum shell elements, W1 is defined as alpha, which takes the transverse shear stress (in 1-2 and 1-3 direction) into account in the tensile fiber check. When W1 is blank, alpha is assumed to be 1.0.

    • CNTZ3D
      When using Cuntze failure criterion, W1 and W2, corresponding to the two free curve parameters,   b | | MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVCI8FfYJH8YrFfeuY=Hhbbf9v8qqaqFr0xc9pk0xbb a9q8WqFfeaY=biLkVcLq=JHqpepeea0=as0Fb9pgeaYRXxe9vr0=vr 0=vqpWqaaeaabiGaciaacaqabeaadaqaaqaaaOqaaabaaaaaaaaape GaaiiOaiaadkgapaWaaSbaaSqaa8qacqGHLkIxcaGG8bGaaiiFaaWd aeqaaaaa@3C22@ and b T   MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVCI8FfYJH8YrFfeuY=Hhbbf9v8qqaqFr0xc9pk0xbb a9q8WqFfeaY=biLkVcLq=JHqpepeea0=as0Fb9pgeaYRXxe9vr0=vr 0=vqpWqaaeaabiGaciaacaqabeaadaqaaqaaaOqaaabaaaaaaaaape GaamOya8aadaqhaaWcbaWdbiabgwQiEbWdaeaapeGaamivaaaakiaa cckaaaa@3B16@ should be provided. The two curve parameters can be determined from multi-axial test data from experiments. Bounds on the safe side for GFRP, CFRP and AFRP are assumed by Cuntze 1 to be:(1)
      0.0.5 < b | | < 0.15 , 1.0 < b | T < 1.6 MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVCI8FfYJH8YrFfeuY=Hhbbf9v8qqaqFr0xc9pk0xbb a9q8WqFfeaY=biLkVcLq=JHqpepeea0=as0Fb9pgeaYRXxe9vr0=vr 0=vqpWqaaeaabiGaciaacaqabeaadaqaaqaaaOqaaabaaaaaaaaape GaaGimaiaac6cacaaIWaGaaiOlaiaaiwdacqGH8aapcaWGIbWdamaa BaaaleaapeGaeyyPI4LaaiiFaiaacYhaa8aabeaakiaaysW7cqGH8a apcaaIWaGaaiOlaiaaigdacaaI1aGaaiilaiaaysW7caaMc8UaaGym aiaac6cacaaIWaGaeyipaWZdbiaadkgapaWaa0baaSqaa8qacqGHLk IxcaGG8baapaqaa8qacaWGubaaaOWdaiabgYda8iaaigdacaGGUaGa aGOnaiaacYcacaaMc8UaaGjbVlaaicdacqGH8aapcaaMe8+dbiaadk gapaWaa0baaSqaa8qacqGHLkIxcaGG8bGaaiiFaaWdaeaapeGaeqiX dqhaaOWdaiabgYda8iaaicdacaGGUaGaaGinaaaa@6574@
  5. When some failure criteria are defined on both PCOMP(G/P) (allowables on MATi) and MATF, then:
    • If the same criterion type is defined in both PCOMP(G/P) property and the MATF entry, then the allowables defined on the MATF entry will be used in the failure criterion calculations. The MATF entry overwrites the allowables defined by the corresponding MATi entry (if any).
    • If some criteria are only defined on PCOMP(G/P) but not on MATF, then for such criteria, the allowables are taken from corresponding MATi entries.
    • If some criteria are defined on MATF, and PARAM,ALLFT,YES exists, then the criteria defined on MATF will use the allowables defined on MATF. However, the criteria not defined on MATF will be calculated based on allowables defined on the corresponding MATi entry.
  6. The following criteria can only be defined on the MATF entry.

    PUCK, DUCTILE, PUCK3D, HILL3D, HOFF3D, TSAI3D, HASH3D, STRN3D, and CNTZ3D.

    The rest of the criteria can also be defined on the FT field of the corresponding PCOMPP/PCOMPG/PCOMP entry.

    For the PUCK failure criterion, even though it is available on the FT field of the PCOMPP/PCOMPG/PCOMP entry, the corresponding failure envelope factors (W1, W2, W3) can only be defined on the MATF entry. Therefore, the MATF entry is mandatory when PUCK failure criterion is requested via the FT field of PCOMP/PCOMPG/PCOMPP entries, and additionally, the allowables should be defined on the MATF for PUCK criterion only. To use PUCK failure criteria, the MATF entry should be specified with MID referring to the corresponding material entry.

  7. If the CRITERIA field is set to DUCTILE, then the TID field should point to a TABLEMD entry with NDEP set to 1. The first data column (Yi) is the equivalent plastic strain at the onset of damage. The second data column (Xi) is the corresponding temperature. The second column should be specified in ascending order only.

    When the CRITERIA field is set to DUCTILE in OSTTS analysis, the temperature-based lookup is conducted for each temperature to identify the corresponding equivalent plastic strain from the TABLEMD entry. This plastic strain is used in conjunction with the calculated von Mises Strain to calculate Damage (This can be output using the DAMAGE I/O Options Entry).

  8. The following tables summarize the supported failure criteria with different properties and materials.
    Table 1. Shell Elements
      PSHELL PCOMP/PCOMPG/PCOMPP
      MAT1/MAT2/MAT8
    HILL No Yes
    HOFF No Yes
    TSAI No Yes
    STRN No Yes
    STRS No Yes
    HASHIN No Yes
    PUCK No Yes
    DUCTILE No Yes
    Table 2. Solid Elements
    PSOLID PCOMPLS
    MAT9 MAT9OR MAT9 MAT9OR
    HILL3D Yes Yes Yes Yes
    HOFF3D Yes Yes Yes Yes
    TSAI3D Yes Yes Yes Yes
    STRN3D Yes Yes Yes Yes
    STRS3D Yes Yes Yes Yes
    HASH3D No Yes Yes Yes
    PUCH3D No Yes Yes Yes
    CNTZ3D No Yes Yes Yes
  9. Multiple different failure criteria can be defined on a single MATF entry. Therefore, the CRI continuation line can be repeated, and multiple different failure criteria can be specified. However, a particular failure criterion can only appear once on the MATF entry and cannot be repeated. Different failure criteria for different materials can be defined by referencing the corresponding material entry (with same ID as MATF) on MID# fields of the PCOMP(G) and PLY entries (for PCOMPP). If different failure criteria are required to be defined for a single composite property, then MATF entry should be used.
1 Cuntze, R.G. and Freund, A., The predictive capability of failure mode concept-based strength criteria for multidirectional laminates in Failure Criteria in Fibre Reinforced Polymer Composites, 2004 QinetiQ Ltd. Published by Elsevier Ltd.