hm_read_mat117.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_mat117           ../starter/source/materials/mat/mat117/hm_read_mat117.F
!||--- called by ------------------------------------------------------
!||    hm_read_mat              ../starter/source/materials/mat/hm_read_mat.F90
!||--- 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
!||    init_mat_keyword         ../starter/source/materials/mat/init_mat_keyword.F
!||--- uses       -----------------------------------------------------
!||    elbuftag_mod             ../starter/share/modules1/elbuftag_mod.F
!||    message_mod              ../starter/share/message_module/message_mod.F
!||    submodel_mod             ../starter/share/modules1/submodel_mod.F
!||====================================================================
      SUBROUTINE hm_read_mat117(MTAG     ,UPARAM    ,MAXUPARAM,NUPARAM  ,PM       ,
     .                          PARMAT   ,NUVAR     ,MAXFUNC  ,NFUNC    ,IFUNC,
     .                          UNITAB   ,MAT_ID    ,TITR     ,LSUBMODEL,MATPARAM )
C-----------------------------------------------
C   ROUTINE DESCRIPTION :
C   ===================
C   READ MAT LAW117 WITH HM READER - connection material
C-----------------------------------------------
C   DUMMY ARGUMENTS DESCRIPTION:
C   ===================
C
C     NAME            DESCRIPTION                         
C
C     IPM             MATERIAL ARRAY(INTEGER)
C     PM              MATERIAL ARRAY(REAL)
C     UNITAB          UNITS ARRAY
C     ID              MATERIAL ID(INTEGER)
C     TITR            MATERIAL TITLE
C     LSUBMODEL       SUBMODEL STRUCTURE
C-----------------------------------------------
C   M o d u l e s
C-----------------------------------------------
      USE unitab_mod
      USE elbuftag_mod
      USE message_mod
      USE submodel_mod
      USE matparam_def_mod
      USE names_and_titles_mod , ONLY : nchartitle
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      "param_c.inc"
#include      "units_c.inc"
C-----------------------------------------------
C   D u m m y   A r g u m e n t s
C-----------------------------------------------
      TYPE (UNIT_TYPE_),INTENT(IN) ::UNITAB 
      INTEGER, INTENT(INOUT)          :: IFUNC(MAXFUNC), NFUNC, MAXFUNC
      INTEGER, INTENT(INOUT)          :: MAXUPARAM,
     .                                   nuparam,nuvar
      INTEGER, INTENT(IN)             :: MAT_ID
      my_real, INTENT(INOUT)          :: PM(NPROPM),PARMAT(100),UPARAM(MAXUPARAM)
      CHARACTER(LEN=NCHARTITLE) ,INTENT(IN) :: TITR
      TYPE(submodel_data),INTENT(IN)  :: LSUBMODEL(*)
      TYPE(mlaw_tag_), INTENT(INOUT)  :: MTAG
      TYPE(matparam_struct_) ,INTENT(INOUT) :: MATPARAM  
C-----------------------------------------------
C   L o c a l   V a r i a b l e s
C-----------------------------------------------
      INTEGER :: NRATE,ILAW,IMASS,IDEL,IORDER1,IORDER2,
     .   IFAIL1,IFAIL2, IRUPT,ICRIT
      my_real :: rho0,e,g,thick,gc1_ini,gc2_ini,gc1_inf,gc2_inf,ratg1,ratg2,fscalex,fscalex_unit,
     .   fg1,fg2,siga1,siga2,sigb1,sigb2,rate1,rate2,unit_l,e_elas_n,e_elas_s,tmax_n,tmax_s,
     .                   gic,giic,exp_g,exp_bk,disp_0n,disp_0s,delta0n,delta0s,und,utd,gama
      LOGICAL :: IS_AVAILABLE,IS_ENCRYPTED
C=======================================================================
      ilaw = 117
!
      is_encrypted   = .false.
      is_available = .false.
!
      CALL hm_option_is_encrypted(is_encrypted)
Card1
      CALL hm_get_floatv('MAT_RHO'        ,rho0         ,is_available, lsubmodel, unitab)
      CALL hm_get_intv  ('MAT_IMASS'      ,imass        ,is_available, lsubmodel)
      CALL hm_get_intv  ('MAT_Fct_TN'     ,ifunc(1)     ,is_available, lsubmodel)
      CALL hm_get_intv  ('MAT_Fct_TT'     ,ifunc(2)     ,is_available, lsubmodel)
      CALL hm_get_floatv('MAT_Fscale_x'   ,fscalex      ,is_available, lsubmodel, unitab)
      IF(fscalex == zero) THEN
          CALL hm_get_floatv_dim('MAT_Fscale_x'  ,fscalex_unit    ,is_available, lsubmodel, unitab)
          fscalex = fscalex_unit  
      ENDIF
      CALL hm_get_floatv('MAT_E_ELAS_N'   ,e_elas_n     ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_E_ELAS_S'   ,e_elas_s     ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_TMAX_N'     ,tmax_n       ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_TMAX_S'     ,tmax_s       ,is_available, lsubmodel, unitab)
 
      CALL hm_get_intv  ('MAT_IRUPT'      ,irupt        ,is_available, lsubmodel)
      CALL hm_get_intv  ('MAT_IDEL'       ,idel         ,is_available, lsubmodel)
      CALL hm_get_floatv('MAT_GIC'        ,gic          ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_GIIC'       ,giic         ,is_available, lsubmodel, unitab)
 
      CALL hm_get_floatv('MAT_EXP_G'    ,exp_g      ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_EXP_BK'   ,exp_bk     ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_GAMMA'    ,gama       ,is_available, lsubmodel, unitab)
c---------------------------------------------------------------------------------
      pm(1) = rho0  ! RHOR
      pm(89)= rho0
C-------------------------------------------
C Number of User Element Variables and Curves
C-------------------------------------------
      nuvar = 15
      nfunc = 2
      nuparam = 18
c-------------------
c     Default Values
c-------------------
      IF (idel  == 0)   idel    = 1
      IF (imass == 0)   imass   = 1
      IF (irupt == 0)   irupt   = 1
      IF (gama  == zero)   gama   = one
      IF (exp_g  == zero) exp_g   = two
      IF (e_elas_s == zero) e_elas_s = e_elas_n
      IF ( gic < (tmax_n**2 / two/e_elas_n )  ) THEN
        gic = tmax_n**2 / two/e_elas_n
        CALL ancmsg(msgid=3016,msgtype=msgwarning,anmode=aninfo_blind_1,
     .                i1 = mat_id,
     .                c1 = titr )
      END IF
      IF ( giic < (tmax_s**2 / two/e_elas_s )  ) THEN
        giic = tmax_s**2 / two/e_elas_s
        CALL ancmsg(msgid=3017,msgtype=msgwarning,anmode=aninfo_blind_1,
     .                i1 = mat_id,
     .                c1 = titr )
      END IF
 
 
 
 
      delta0n  = tmax_n/e_elas_n !single mode damage initiation normal
      delta0s  = tmax_s/e_elas_s !single mode damage initiation tangential
 
      und  = two*gic /(delta0n *e_elas_n)! ultimate displacement in normal direction (UND)
      utd  = two*giic/(delta0s *e_elas_s)! ultimate displacement in tangential direction (UTD)
 
 
 
 
C-------------------------------------------
C User Material Parameters Definition
C-------------------------------------------
 
      disp_0n = tmax_n/e_elas_n
      disp_0s = tmax_s/e_elas_s
      uparam(1)  = e_elas_n 
      uparam(2)  = e_elas_s 
      uparam(3)  = gama
      uparam(4)  = tmax_n
      uparam(5)  = tmax_s  
      uparam(6)  = irupt  
      uparam(7)  = gic  
      uparam(8)  = giic
      uparam(9)  = idel  
      uparam(10) = exp_g
      uparam(11) = exp_bk  
      uparam(12) = imass
      uparam(13) = delta0n        !         DISP puremode 
      uparam(14) = delta0s        !         DISP puremode 
      uparam(15) = und! ultimate displacement in normal direction (UND)
      uparam(16) = utd! ultimate displacement in tangential direction (UTD)
      uparam(17) = fscalex
 
C-------------------------------------------
C Interface Contact
C-------------------------------------------
C----------------
      parmat(1)  = max(e_elas_n,e_elas_s) / three
      parmat(2)  = max(e_elas_n,e_elas_s)
      parmat(17) = one ! (ONE - TWO*NU)/(ONE - NU), NU=0      
c
      mtag%L_EPE  = 3
      mtag%L_DMG  = 1
      mtag%G_DMG  = 1
c
      ! MATPARAM keywords
      CALL init_mat_keyword(matparam,"HOOK")
c 
      ! Properties compatibility
      CALL init_mat_keyword(matparam,"SOLID_COHESIVE")
c-------------------
c     STARTER Output
c-------------------
      WRITE(iout,1100) trim(titr),mat_id,ilaw
      WRITE(iout,1000)
      IF (is_encrypted) THEN
        WRITE(iout,'(5X,A,//)')'CONFIDENTIAL DATA'
      ELSE                                                     
        WRITE(iout,1200) rho0,e_elas_n,e_elas_s,tmax_n,tmax_s,
     .                   ifunc(1),ifunc(2),fscalex,
     .                   irupt,gic,giic,exp_g,exp_bk,gama
      ENDIF
c-----------
      RETURN
C-------------------------------------------
 1000 FORMAT(
     & 10x,' MIXED MODE COHESIVE LAW 117  ',/,
     & 10x,' ---------------------------  ',/)   
 1100 FORMAT(/
     & 5x,a,/,
     & 5x,'MATERIAL NUMBER . . . . . . . . . . . . . . .=',i10/,
     & 5x,'MATERIAL LAW. . . . . . . . . . . . . . . . .=',i10/)
 1200 FORMAT(
     & 5x,'INITIAL DENSITY . . . . . . . . . . . . . . . . . . . .=',1pg20.13/,
     & 5x,'STIFFNESS NORMAL TO THE PLANE OF THE COHESIVE ELEMENT .=',1pg20.13/,
     & 5x,'STIFFNESS IN TO THE PLANE OF THE COHESIVE ELEMENT . . .=',1pg20.13/,
     & 5x,'PEAK TRACTION IN NORMAL DIRECTION . . . . . . . . . . .=',1pg20.13/,
     & 5x,'PEAK TRACTION IN TANGENTIAL DIRECTION . . . . . . . . .=',1pg20.13/,
     & 5x,'FUNCTION OF THE PEAK TRACTION IN NORMAL DIRECTION. . . =',i10/,
     & 5x,'FUNCTION OF THE PEAK TRACTION IN TANGENTIAL DIRECTION .=',i10/,
     & 5x,'ABSCISSA SCALE FACTOR FOR THE PEAK TRACTION FUNCTIONS .=',1pg20.13/,
c
     & 5x,'CHOICE OF PROPAGATION CRITERION . . . . . . . . . . . .=',i10/,
     & 5x,'             = 1 => POWER LAW                   '/,
     & 5x,'             = 2 => BENZEGGAGH-KENANE           '/,
c
     & 5x,'ENERGY RELEASE RATE FOR MODE I. . . . . . . . . . . . .=',1pg20.13/,
     & 5x,'ENERGY RELEASE RATE FOR MODE II . . . . . . . . . . . .=',1pg20.13/,
 
     & 5x,'POWER LAW EXPONENT MU . . . . . . . . . . . . . . . . .=',1pg20.13/,
     & 5x,'BENZEGGAGH-KENANE EXPONENT MU . . . . . . . . . . . . .=',1pg20.13/,
     & 5x,'BENZEGGAGH-KENANE EXPONENT GAMMA. . . . . . . . . . . .=',1pg20.13/)
 
c--------
      END