hm_read_mat83.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_mat83            ../starter/source/materials/mat/mat083/hm_read_mat83.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_mat83(UPARAM  ,MAXUPARAM ,NUPARAM  ,MTAG    ,PM       ,
     .                         NUVAR   ,IFUNC     ,MAXFUNC  ,NFUNC   ,PARMAT   , 
     .                         UNITAB  ,MAT_ID    ,TITR     ,ISRATE  ,LSUBMODEL,
     .                         MATPARAM)
C-----------------------------------------------
C   ROUTINE DESCRIPTION :
C   ===================
C   READ MAT LAW83 WITH HM READER
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,MAXUPARAM,NUPARAM,NUVAR,ISRATE
      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(NSUBMOD)
      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 :: I,J,NRATE,IFILTR,IDYIELD,IFUNN,IFUNT,
     .           RHOFLAG,ICOMP,IPLAS,VP,ILAW
      my_real :: YOUNGT,YOUNGC,G,YOUNG,FCUT,XFAC,YFAC,XSCALE,RN,RS,BETA,ALPHA,
     .           a1,a2,aa,e0,emax,epsmax,rho0,rhor,yfac_unit,
     .           xfac_unit,xscale_unit,rn_unit,rs_unit
      LOGICAL :: IS_AVAILABLE,IS_ENCRYPTED
!======================================================================= 
      ILAW = 83
!
      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_floatv('Refer_Rho'    ,rhor        ,is_available, lsubmodel, unitab)
card2
      CALL hm_get_floatv('MAT_E'        ,youngt      ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_G'        ,g           ,is_available, lsubmodel, unitab)
      CALL hm_get_intv  ('MAT_IMASS'    ,rhoflag     ,is_available, lsubmodel)
      CALL hm_get_intv  ('COMP_OPT'     ,icomp       ,is_available, lsubmodel) 
      CALL hm_get_floatv('MAT_ECOMP'    ,youngc      ,is_available, lsubmodel, unitab) 
card3
      CALL hm_get_intv  ('FUN_A1'       ,idyield     ,is_available ,lsubmodel)
      CALL hm_get_floatv('FScale11'     ,yfac        ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('FScale22'     ,xfac        ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_ALPHA'    ,alpha       ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_Beta'     ,beta        ,is_available, lsubmodel, unitab)
card4
      CALL hm_get_floatv('MAT_R00'      ,rn          ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv('MAT_R45'      ,rs          ,is_available, lsubmodel, unitab)
      CALL hm_get_intv  ('Fsmooth'      ,israte      ,is_available ,lsubmodel)
      CALL hm_get_floatv('Fcut'         ,fcut      ,is_available, lsubmodel, unitab)
card5
      CALL hm_get_intv  ('FUN_A2'       ,ifunn       ,is_available ,lsubmodel)
      CALL hm_get_intv  ('FUN_A3'       ,ifunt       ,is_available ,lsubmodel)
      CALL hm_get_floatv('FScale33'     ,xscale      ,is_available, lsubmodel, unitab)
c-------------------------------------------------------------------------------------
      CALL hm_get_floatv_dim('FScale11' ,yfac_unit   ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv_dim('FScale22' ,xfac_unit   ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv_dim('FScale33' ,xscale_unit ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv_dim('MAT_R00'  ,rn_unit     ,is_available, lsubmodel, unitab)
      CALL hm_get_floatv_dim('MAT_R45'  ,rs_unit     ,is_available, lsubmodel, unitab)
c-------------------------------------------------------------------------------------
      IF (rhor == zero) rhor=rho0
      pm(1) = rhor
      pm(89)= rho0
!
      IF (xfac == zero) xfac = one*xfac_unit
      IF (beta  == zero) beta = two
      IF (rn  == zero) rn = one*rn_unit
      IF (rs  == zero) rs = one*rs_unit
      iplas = 0 ! hidden
      IF (iplas == 0)  iplas = 2
      IF (israte == 0) THEN
        vp = 0
      ELSE
        vp = 1
        israte = 1
      END IF
      IF (fcut  == zero) fcut = 10000.0d0*unitab%FAC_T_WORK
C---
      nfunc = 3 
      ifunc(1) = ifunn
      ifunc(2) = ifunt
      ifunc(3) = idyield
C---
      IF (ifunc(3) == 0) THEN
         CALL ancmsg(msgid=126, msgtype=msgerror, anmode=aninfo_blind_1,
     .               i1=mat_id,
     .               c1=titr,
     .               i2=ifunc(3))
      ENDIF
   
      IF (yfac == zero)   yfac   = one*yfac_unit
      IF (xscale == zero) xscale = one*xscale_unit
      IF( g == zero)  g = youngt
      IF (youngc == zero) youngc = youngt
      IF (icomp /= 1) icomp = 0
      young = max(youngt,youngc)
      alpha = min(alpha, one)
C----------------
      uparam(1) = youngt
      uparam(2) = alpha
      uparam(3) = beta
      uparam(4) = yfac
      uparam(5) = xscale
      uparam(6) = rn
      uparam(7) = rs
      uparam(8) = xfac
      uparam(9) = rhoflag
      uparam(10)= iplas
      uparam(11) = g
      uparam(12) = icomp
      uparam(13) = youngc
      uparam(14) = vp      ! total or plastic strain rate flag
C----------------
      nuparam = 14
      nuvar   = 1
C----------------
      parmat(1) = young/three
      parmat(2) = young
      parmat(5) = fcut
C     Formulation for solid elements time step computation.
      parmat(16) = 2
      parmat(17) =  one ! (ONE - TWO*NU)/(ONE - NU), NU=0      
!
      mtag%G_GAMA = 9
      mtag%G_EPSD = 1  
      mtag%G_PLA  = 1 !global
      mtag%L_EPE  = 3
      mtag%L_PLA  = 1
      mtag%L_EPSD = 1
      mtag%L_DMG  = 1
      mtag%G_DMG  = 1
c-----------------
      ! MATPARAM keywords
      CALL init_mat_keyword(matparam,"HOOK")
      ! Properties compatibility  
      CALL init_mat_keyword(matparam,"SOLID_COHESIVE")       
C----------------
      WRITE(iout,1100) trim(titr),mat_id,83
      WRITE(iout,1000)
      IF (is_encrypted) THEN
        WRITE(iout,'(5X,A,//)')'CONFIDENTIAL DATA'
      ELSE                                                     
        WRITE(iout,1200) rho0
        WRITE(iout,1300) youngt,youngc,g,icomp,rhoflag,idyield,yfac,xfac,alpha,beta
        WRITE(iout,1400)ifunn,ifunt,xscale,rn,rs,israte,fcut
        IF (vp ==0) THEN
          WRITE(iout,1500)
        ELSE
          WRITE(iout,1600)
        END IF
      ENDIF
C-----------
      RETURN
C-----------
 1000 FORMAT(
     & 5x,'  CONNECTION MATERIAL LAW 83                        ',/,
     & 5x,'  --------------------------                        ',/)   
 1100 FORMAT(/
     & 5x,a,/,
     & 5x,'MATERIAL NUMBER . . . . . . . . . . . . . . . . . .=',i10/,
     & 5x,'MATERIAL LAW. . . . . . . . . . . . . . . . . . . .=',i10/)
 1200 FORMAT(
     & 5x,'INITIAL DENSITY . . . . . . . . . . . . . . . . . .=',1pg20.13)
 1300 FORMAT(
     & 5x,'YOUNG MODULUS PER THICKNESS UNIT IN TENSION . . . .=',1pg20.13/,
     & 5x,'YOUNG MODULUS PER THICKNESS UNIT IN COMPRESSION . .=',1pg20.13/,
     & 5x,'SHEAR MODULUS PER THICKNESS UNIT  . . . . . . . . .=',1pg20.13/,
     & 5x,'COMPRESSION BEHAVIOR (FLAG) . . . . . . . . . . . .=',i10/,
     & 5x,'             = 0 => ELASTO-PLASTIC                  '/,
     & 5x,'             = 1 => LINEAR ELASTIC                  '/,
     & 5x,'DENSITY UNIT FLAG . . . . . . . . . . . . . . . . .=',i10/,
     & 5x,'             = 0 => VOLUME  DENSITY                 '/,
     & 5x,'             = 1 => surface density                 '/,
     & 5X,'yield stress FUNCTION . . . . . . . . . . . . . . .=',I10/,
     & 5X,'scale factor for yield function . . . . . . . . . .=',1PG20.13/,
     & 5X,'scale factor for yield function abscissa  . . . . .=',1PG20.13/,
     & 5X,'parameter alpha in yield function . . . . . . . . .=',1PG20.13/,
     & 5X,'parameter beta in yield function  . . . . . . . . .=',1PG20.13)
 1400 FORMAT(
     & 5X,'strain rate function in normal direction. . . . . .=',I10/,
     & 5X,'strain rate function in tangent direction . . . . .=',I10/,
     & 5X,'scale factor for strain rate in function  . . . . .=',1PG20.13/,
     & 5X,'rn variable . . . . . . . . . . . . . . . . . . . .=',1PG20.13/,
     & 5X,'rs variable . . . . . . . . . . . . . . . . . . . .=',1PG20.13/,
     & 5X,'strain rate filtering flag  . . . . . . . . . . . .=',I10/,
     & 5X,'cut freq for strain rate filtering  . . . . . . . .=',1PG20.13)
 1500 FORMAT(5X,'using total strain rate',/)
 1600 FORMAT(5X,'using plastic strain rate',/)
C--------
      END