Archive Documentation

2.1. Creep Subroutine UserCr

In contrast to the UserCreep subroutine, the UserCr subroutine requires that you specify the creep strain tensor. A detailed explanation of this subroutine follows.

*deck,usercr                      USERSDISTRIB
      subroutine usercr (elem,intpt,mat,ncomp,kfirst,kfsteq,e,posn,d,
     x proptb,timval,timinc,tem,dtem,toffst,fluen,dfluen,epel,epcrp,
     x statev,usvr,delcr)
c
c *** primary function:   allow users to write their own creep laws.
c                           this logic is accessed with c6 = 100
c *** secondary function:    demonstrate the use of user-written creep laws
c
c *** Notice - This file contains ANSYS Confidential information ***
c
c
c         *** Copyright ANSYS.  All Rights Reserved.
c         *** ansys, inc.
c
c  input arguments:
c     variable (type,sze,intent)    description
c
c     elem     (int,sc,in)         - element number (label)
c     intpt    (int,sc,in)         - element integration point number
c     mat      (int,sc,in)         - material reference number
c     ncomp    (int,sc,in)         - no. of stress/strain components (1,4 or 6)
c                                    1 - x
c                                    4 - x,y,z,xy
c                                    6 - x,y,z,xy,yz,xz
c     kfirst   (int,sc,in)         - 1 if first time through, 0 otherwise
c                                    (useful for initializing state variables
c                                    to a non-zero value)
c     kfsteq   (int,sc,in)         - 1 if first equilibrium iteration of a
c                                    substep, 0 otherwise
c
c
c     e        (dp,sc,in)          - elastic young'S MODULUS
c     posn     (dp,sc,in)          - poisson'S RATIO
c     d        (dp,ar(ncomp,ncomp),in)- elastic stress-strain matrix
c     proptb   (dp,ar(72),in)      - material properties input on tb commands
c                               (do not use proptb(13), as it is used elsewhere)
c     timval   (dp,sc,in)          - current time value
c     timinc   (dp,sc,in)          - time increment over this substep
c     tem      (dp,sc,in)          - temperature at the end of this substep
c     dtem     (dp,sc,in)          - temperature increment over this substep
c     toffst   (dp,sc,in)          - temperature offset from absolute zero
c     fluen    (dp,sc,in)          - fluence at the end of this substep
c     dfluen   (dp,sc,in)          - fluence increment over this substep
c
c     epel     (dp,ar(ncomp),inout)- elastic strain
c     epcrp    (dp,ar(ncomp),inout)- creep strain from previous substep
c     statev   (dp,ar(ncomp*5+2),inout)- state variables from previous 
c                                    (converged) substep.  This variable is for
c                                    explicit creep only and refers to a 
c                                    different internal variable than that 
c                                    defined by TB,stat which is used by 
c                                    implicit creep (usercreep) and usermat.
c     usvr     (dp,ar(nuval,nintp),inout)- additional state variables from
c                                    previous equilibrium iteration (saved
c                                    if the nsvr command is used)
c
c
c  output arguments:
c     variable (type,sze,intent)    description
c
c     epel     (dp,ar(ncomp),inout)- elastic strain adjusted for creep increment
c     epcrp    (dp,ar(ncomp),inout)- updated creep strain
c     statev   (dp,ar(ncomp*5+2),inout)- updated state variables
c     usvr     (dp,ar(nuval,nintp),inout)- updated additional state variables
c     delcr    (dp,sc,out)         - equivalent creep strain increment (used
c                                    for creep ratio calculation)
c
c  fortran parameters (to be defined by the user):
c     variable (type)              description
c     nuval    (int)               - number of additional state variables per
c                                    integration point
c     nintp    (int)               - maximum number of integration points of
c                                    an element to be used with this routine
c                                    (14 is the maximum)
c         note:  nuval x nintp = nstv(on nsvr command); cannot exceed 840!
c
c  internal variables:
c     variable (type,sze)     description
c     con      (dp,sc)         - temporary variable
c     del      (dp,ar(6))      - creep strain increments
c     epet     (dp,sc)         - equivalent elastic strain (before creep)
c     ept      (dp,ar(6))      - total strain
c     eptot    (dp,sc)         - equivalent total strain, elastic + creep
c     sigen    (dp,sc)         - equivalent stress (before creep)
c     temabs   (dp,sc)         - temperature on the absolute scale
c

Archive Documentation


Release 18.2 - © ANSYS, Inc. All rights reserved.