Product: Abaqus/Standard
User subroutine UEXTERNALDB:
is called once each at the beginning of the analysis, at the beginning of each increment, at the end of each increment, and at the end of the analysis (in addition, the user subroutine is also called once at the beginning of a restart analysis);
can be used to communicate between other software and user subroutines within Abaqus/Standard;
can be used to open external files needed for other user subroutines at the beginning of the analysis and to close those files at the end of the analysis;
can be used to calculate or read history information at the beginning of each increment. This information can be written to user-defined COMMON block variables or external files for use during the analysis by other user subroutines; and
can be used to write the current values of the user-calculated history information to external files.
SUBROUTINE UEXTERNALDB(LOP,LRESTART,TIME,DTIME,KSTEP,KINC)
C
INCLUDE 'ABA_PARAM.INC'
C
DIMENSION TIME(2)
C
user coding to set up the Fortran environment, open files, close files,
calculate user-defined model-independent history information,
write history information to external files,
recover history information during restart analyses, etc.
do not include calls to utility routine XIT
RETURN
ENDLOP
LOP=0 indicates that the user subroutine is being called at the start of the analysis.
LOP=1 indicates that the user subroutine is being called at the start of the current analysis increment. The user subroutine can be called multiple times at the beginning of an analysis increment if the increment fails to converge and a smaller time increment is required.
LOP=2 indicates that the user subroutine is being called at the end of the current analysis increment. When LOP=2, all information that you need to restart the analysis should be written to external files.
LOP=3 indicates that the user subroutine is being called at the end of the analysis.
LOP=4 indicates that the user subroutine is being called at the beginning of a restart analysis. When LOP=4, all necessary external files should be opened and properly positioned and all information required for the restart should be read from the external files.
LOP=5 indicates that the user subroutine is being called at the start of a step. The KSTEP argument contains the current step number.
LOP=6 indicates that the user subroutine is being called at the end of a step. The KSTEP argument contains the current step number.
LRESTART
LRESTART=0 indicates that an analysis restart file is not being written for this increment.
LRESTART=1 indicates that an analysis restart file is being written for this increment.
LRESTART=2 indicates that an analysis restart file is being written for this increment and that only one increment is being retained per step so that the current increment overwrites the previous increment in the restart file (see “Restarting an analysis,” Section 9.1.1 of the Abaqus Analysis User's Guide).
TIME(1)
Value of current step time.
TIME(2)
Value of current total time.
DTIME
Time increment.
KSTEP
Current step number. When LOP=4, KSTEP gives the restart step number.
KINC
Current increment number. When LOP=4, KINC gives the restart increment number.