hm_read_fail_energy.F

Go to the documentation of this file.

Copyright>        OpenRadioss
Copyright>        Copyright (C) 1986-2025 Altair Engineering Inc.
Copyright>
Copyright>        This program is free software: you can redistribute it and/or modify
Copyright>        it under the terms of the GNU Affero General Public License as published by
Copyright>        the Free Software Foundation, either version 3 of the License, or
Copyright>        (at your option) any later version.
Copyright>
Copyright>        This program is distributed in the hope that it will be useful,
Copyright>        but WITHOUT ANY WARRANTY; without even the implied warranty of
Copyright>        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Copyright>        GNU Affero General Public License for more details.
Copyright>
Copyright>        You should have received a copy of the GNU Affero General Public License
Copyright>        along with this program.  If not, see <https://www.gnu.org/licenses/>.
Copyright>
Copyright>
Copyright>        Commercial Alternative: Altair Radioss Software
Copyright>
Copyright>        As an alternative to this open-source version, Altair also offers Altair Radioss
Copyright>        software under a commercial license.  Contact Altair to discuss further if the
Copyright>        commercial version may interest you: https://www.altair.com/radioss/.
!||====================================================================
!||    hm_read_fail_energy      ../starter/source/materials/fail/energy/hm_read_fail_energy.F
!||--- called by ------------------------------------------------------
!||    hm_read_fail             ../starter/source/materials/fail/hm_read_fail.F
!||--- calls      -----------------------------------------------------
!||    ancmsg                   ../starter/source/output/message/message.F
!||    hm_get_floatv            ../starter/source/devtools/hm_reader/hm_get_floatv.F
!||    hm_get_floatv_dim        ../starter/source/devtools/hm_reader/hm_get_floatv_dim.F
!||    hm_get_intv              ../starter/source/devtools/hm_reader/hm_get_intv.F
!||    hm_option_is_encrypted   ../starter/source/devtools/hm_reader/hm_option_is_encrypted.F
!||--- uses       -----------------------------------------------------
!||    hm_option_read_mod       ../starter/share/modules1/hm_option_read_mod.F
!||    message_mod              ../starter/share/message_module/message_mod.F
!||    submodel_mod             ../starter/share/modules1/submodel_mod.F
!||====================================================================
      SUBROUTINE hm_read_fail_energy(FAIL , 
     .           MAT_ID   ,FAIL_ID  ,IRUPT    ,LSUBMODEL,UNITAB   )
C-----------------------------------------------
c    ROUTINE DESCRIPTION :
c    Read Energy based failure model parameters
C-----------------------------------------------
C   M o d u l e s
C-----------------------------------------------
      USE fail_param_mod
      USE unitab_mod
      USE message_mod 
      USE submodel_mod
      USE hm_option_read_mod 
C-----------------------------------------------
C   I m p l i c i t   T y p e s
C-----------------------------------------------
#include      "implicit_f.inc"
C-----------------------------------------------
C   C o m m o n   B l o c k s
C-----------------------------------------------
#include      "units_c.inc"
C-----------------------------------------------
C   D u m m y   A r g u m e n t s
C-----------------------------------------------
      INTEGER             ,INTENT(IN) :: FAIL_ID       ! failure model ID
      INTEGER             ,INTENT(IN) :: MAT_ID        ! material law ID
      INTEGER             ,INTENT(IN) :: IRUPT         ! failure model number
      TYPE (UNIT_TYPE_)   ,INTENT(IN) :: UNITAB        ! table of input units
      TYPE (SUBMODEL_DATA),INTENT(IN) :: LSUBMODEL(*) 
      TYPE (FAIL_PARAM_)  ,INTENT(INOUT) :: FAIL
C-----------------------------------------------
C   L o c a l   V a r i a b l e s
C-----------------------------------------------
      INTEGER  :: IRFUN,DMG_FLAG,FAILIP 
      my_real  :: rf1,rf2,rief1,rief2,scale_epsp,pthk
C----------------------------------------
       LOGICAL :: IS_AVAILABLE,IS_ENCRYPTED
C=======================================================================
      is_encrypted = .false.
      is_available = .false.
C--------------------------------------------------
C EXTRACT DATA (IS OPTION CRYPTED)
C--------------------------------------------------
      CALL hm_option_is_encrypted(is_encrypted)
C=======================================================================
c     ENERGY Rupture Criterion
C=======================================================================
Card1
      CALL hm_get_floatv         ('E1'         ,rief1      ,is_available,lsubmodel,unitab)
      CALL hm_get_floatv         ('E2'         ,rief2      ,is_available,lsubmodel,unitab)
      CALL hm_get_intv           ('fct_ID'     ,irfun      ,is_available,lsubmodel)
      CALL hm_get_floatv         ('xscale'     ,scale_epsp ,is_available,lsubmodel,unitab)
      CALL hm_get_intv           ('I_Dam'      ,dmg_flag   ,is_available,lsubmodel)
      CALL hm_get_intv           ('FAILIP'       ,failip  ,is_available,lsubmodel) 
      IF (failip == 0)  failip  = 1
C=======================================================================
      IF (rief1 <= zero) rief1 = ep30
      IF (rief2 <= zero) rief2 = two*ep30      
      IF (dmg_flag == 0) dmg_flag = 1  ! DMG_FLAG = 1    => damage reduces forces after criteria is met
      IF (dmg_flag == 2) dmg_flag = 0  ! DMG_FLAG = 2->0 => damage reduces saved stress (old method)
C=======================================================================
      IF (rief1 > rief2) THEN
        CALL ancmsg(msgid=618, msgtype=msgerror, anmode=aninfo_blind_1,
     .              i1=mat_id)
      ENDIF 
C
      pthk = em06
      IF(scale_epsp == zero) THEN
        CALL hm_get_floatv_dim('xscale' ,scale_epsp   ,is_available, lsubmodel, unitab)
        scale_epsp = one * scale_epsp
      ENDIF
c---------------------------
      fail%KEYWORD = 'ENERGY' 
      fail%IRUPT   = irupt 
      fail%FAIL_ID = fail_id 
      fail%NUPARAM = 6
      fail%NIPARAM = 0
      fail%NUVAR   = 1
      fail%NFUNC   = 1
      fail%NTABLE  = 0
      fail%NMOD    = 0
c            
      fail%PTHK    = pthk
c            
      ALLOCATE (fail%UPARAM(fail%NUPARAM))
      ALLOCATE (fail%IPARAM(fail%NIPARAM))
      ALLOCATE (fail%IFUNC (fail%NFUNC))
      ALLOCATE (fail%TABLE (fail%NTABLE))
 
      fail%UPARAM(1) = rief1
      fail%UPARAM(2) = rief2
      fail%UPARAM(3) = pthk
      fail%UPARAM(4) = one/scale_epsp
      fail%UPARAM(5) = dmg_flag   
      fail%UPARAM(6)= failip
C
      fail%IFUNC(1)  = irfun
C=============================================  
      IF(is_encrypted)THEN
        WRITE(iout, 1000)
      ELSE       
       WRITE(iout, 2000) rief1,rief2,irfun,scale_epsp,failip
      ENDIF
      RETURN
C=============================================  
 1000 FORMAT(
     & 5x,40h    crypted DATA in failure model             /,
     & 5x,40h    -----------------------------             /)
 2000 FORMAT(
     & 5x,40h    energy   failure model                  /,
     & 5x,40h    ------------------------                  /,
     & 5x,'MAXIMUM SPECIFIC ENERGY 1. . . . . . . =',e12.4/
     & 5x,'MAXIMUM SPECIFIC ENERGY 2. . . . . . . =',e12.4/
     & 5x,'MAXIMUM ENERGIES SCALING FUNCTION. . . =',i8/
     & 5x,'ABSCISSA SCALE FACTOR FOR FUNCTION . . =',e12.4/,
     & 5x,'NUMBER OF FAILED INTG. POINTS PRIOR TO ELEM DELETION  .=',i10/)      
c----------- 
      RETURN
      END