MultiPhysicsVault/.raw/AbaqusAnalysisUserGuide1/AbaqusAnalysisUserGuide1_088.md

5.1.4 UTILITY ROUTINES FOR ACCESSING THE RESULTS FILE

Products: Abaqus/Standard Abaqus/Explicit

References

• “Accessing the results file information,” Section 5.1.3
• “URDFIL,” Section 1.1.52 of the Abaqus User Subroutines Reference Guide
• “Joining data from multiple results files and converting file format: FJOIN,” Section 15.1.2 of the Abaqus Example Problems Guide
• “Calculation of principal stresses and strains and their directions: FPRIN,” Section 15.1.3 of the Abaqus Example Problems Guide
• “Creation of a perturbed mesh from original coordinate data and eigenvectors: FPERT,” Section 15.1.4 of the Abaqus Example Problems Guide

Overview

The Abaqus results (.fil) file can be accessed with the utility routines described in this section. Access is subsequent to an analysis by a user-written postprocessing program or, in Abaqus/Standard, from within an analysis by user subroutine URDFIL.

The following utility subroutines are available:

• DBFILE (read from a file)
• DBFILW (write to a file)
• DBRNU (set a unit number for a file)
• INITPF (initialize a file)
• POSFIL (determine position in a file; available only in Abaqus/Standard)

These utility subroutines are described below in alphabetical order.

Only the subroutines DBFILE and POSFIL can be called from user subroutine URDFIL.

DBFILE (read from a file)

Interface

CALL DBFILE(LOP,ARRAY,JRCD)

Variable to be provided to the utility routine

LOP

A flag, which you must set before calling DBFILE, indicating the operation. Set LOP=0 to read the next record in the file; set LOP=2 to rewind the file currently being read (for example, if it is necessary

to read the file more than once, it must be rewound since it is a sequential file). If LOP=2 is used, the file must first be read to the end, and it should be rewound only when the end-of-file is reached.

Variables returned from the utility routine

ARRAY

The array containing one record from the file, in the format described in “Results file output format,” Section 5.1.2. When LOP=0, this array will be filled by the data management routines with the contents of the next record in the file as each call to DBFILE is executed. ARRAY must be dimensioned adequately in your routines to contain the largest record in the file. For almost all cases 500 words is sufficient. The exceptions arise if the problem definition includes user elements or user materials that use more than this many state variables or if substructures with a large number of retained degrees of freedom are used (see “Using substructures,” Section 10.1.1, for more details regarding substructures). When the results file has been written on a system on which Abaqus runs in double precision, ARRAY must be declared double precision in your routine.

JRCD

Returned as nonzero if an end-of-file marker is read when DBFILE is called with LOP=0.

DBFILW (write to a file)

Interface

CALL DBFILW(LOP,ARRAY,JRCD)

Variables to be provided to the utility routine

ARRAY

The array containing one record to be written to the file, in the format described in “Results file output format,” Section 5.1.2.

JRCD

Return code (0 – record written successfully, 1 – record not written).

LOP

Not currently used.

DBRNU (set a unit number for a file)

Interface

CALL DBRNU(JUNIT)

Variable to be provided to the utility routine

JUNIT

The Fortran unit number of the results file to be read. Valid unit numbers are 8 to read the .fil file, 15–18, or numbers greater than 100.

INITPF (initialize a file)

Interface

CALL INITPF(FNAME,NRU,LRUNIT,LOUTF)

Variables to be provided to the utility routine

FNAME

A character string defining the root file name (that is, the name without an extension) of the files being read or written. FNAME must be declared as CHARACTER*80 and can include the directory specification as well as the root file name. The extension of each individual file is defined by the LRUNIT array below. See the discussion below for file naming conventions.

NRU

An integer giving the number of results files that the postprocessing program will read. Normally only one results file is read, but sometimes it is necessary to read several results files—for example, to merge them into a single file.

LRUNIT

An integer array that must be dimensioned LRUNIT(2,NRU) in the postprocessing program and must contain the following data before INITPF is called:

LRUNIT(1,K1) is the Fortran unit number on which the K1th results file will be read. Valid unit numbers are 8 to read the .fil file, 15–18, or numbers greater than 100. All other units are reserved by Abaqus. See below for naming conventions based on the unit numbers.

LRUNIT(2,K1) is an integer that must be set to 2 if the K1th results file was written as a binary file or set to 1 if the K1th results file was written in ASCII format.

LOUTF

Needs to be defined only if the program that is making the call to INITPF will also write an output file in the Abaqus results file format (for example, if results files are being merged into a single results file or if a results file is being converted from binary to ASCII format). In that case LOUTF should be set to 2 if the output file is to be written as a binary file or set to 1 if the output file is to be written as an ASCII file. This results file will be written with the file name extension .fin. See “Accessing the results file information,” Section 5.1.3, for a discussion of writing results files; see below for information on the naming of this file.

File naming conventions

The file extension is derived from the value of LRUNIT(1,K1). If LRUNIT(1,K1) is 8, the file name will be constructed with the extension fil. Any other unit number will result in a file extension of 0nn, where nn is the number assigned to LRUNIT(1,K1). For example, if LRUNIT(1,K1) is 15, the file extension is .015. If an output file has been indicated by a nonzero value of LOUTF, its extension will be .fin.

For example, to read a file xxxx.fil, set LRUNIT(1,K1) to 8 and the character variable FNAME to xxxx using assignment or data statements. If desired, FNAME can include a directory specification, device name, or path. Operating system environment and shell variables will not be translated properly and, therefore, should not be used.

All error messages generated by Abaqus are written to Fortran unit 6. On most machines error messages will be printed by default directly to the screen if the program is run interactively. You can include an open statement for unit 6 in the main program to redirect messages to a file. If you wish to read or write to units other than those units specified in LRUNIT, OPEN statements for those units may have to be included in the program (depending upon the computer being used). Unit numbers of such auxiliary files should be greater than 100 to avoid any conflict with Abaqus internal files.

POSFIL (determine position in a file)

The POSFIL utility routine is available only in Abaqus/Standard.

Interface

CALL POSFIL(NSTEP,NINC,ARRAY,JRCD)

Variables to be provided to the utility routine

NSTEP

Desired step. If this variable is set to 0, the first available step will be read.

NINC

Desired increment. If this variable is set to 0, the first available increment of the specified step will be read.

Variables returned from the utility routine

ARRAY

Real array containing the values of record 2000 from the results file for the requested step and increment.

JRCD

Return code (0 – specified increment found, 1 – specified increment not found). If the step and increment requested are not found in the results file, POSFIL will return an error and leave you positioned at the end of the results file.

Positioning with POSFIL

You may find it convenient to call POSFIL with both NSTEP and NINC set to 0 to skip over the information that is written to the results file at the beginning of an analysis (see “Results file output format,” Section 5.1.2) and, thus, start reading from the first increment written to the file.

POSFIL cannot be used to move backward in the results file: you cannot use POSFIL to find a given increment in the file and then make a second call to POSFIL later to read an increment earlier than the first one found. If this is attempted, POSFIL will return an error indicating that the requested increment was not found.

OI.1 Abaqus/Standard OUTPUT VARIABLE INDEX

This index provides a reference to all of the output variables that are available in Abaqus/Standard. Output variables are listed in alphabetical order.

Variable	Page	Variable	Page
A	4.2.1–38	ALPHAN	4.2.1–7
ACV	4.2.1–12	ALPHAP	4.2.1–7
ACVn	4.2.1–12	ALPHAPn	4.2.1–7
ALEAKVR	4.2.1–51	AMPCU	4.2.1–59
ALEAKVRB	4.2.1–18	An	4.2.1–38
ALEAKVRBXFEM	4.2.1–31	AR	4.2.1–38
ALEAKVRT	4.2.1–18	ARn	4.2.1–38
ALEAKVRTXFEM	4.2.1–31	AT	4.2.1–38
ALLAE	4.2.1–57	AZZIT	4.2.1–14
ALLCCDW	4.2.1–57	BDSTAT	4.2.1–51
ALLCCE	4.2.1–57	BF	4.2.1–29
ALLCCEN	4.2.1–57	BICURV	4.2.1–26
ALLCCET	4.2.1–57	BIMOM	4.2.1–25
ALLCCSD	4.2.1–58	BM	4.2.1–46
ALLCCSDN	4.2.1–57	CA	4.2.1–35
ALLCCSDT	4.2.1–58	CALPHAF	4.2.1–32
ALLCD	4.2.1–58	CALPHAFn	4.2.1–32
ALLDMD	4.2.1–58	CALPHAMn	4.2.1–32
ALLEE	4.2.1–58	CAn	4.2.1–35
ALLFD	4.2.1–58	CAREA	4.2.1–49
ALLIE	4.2.1–58	CARn	4.2.1–35
ALLJD	4.2.1–58	CASU	4.2.1–34
ALLKE	4.2.1–58	CASUC	4.2.1–34
ALLKL	4.2.1–58	CASUn	4.2.1–34
ALLPD	4.2.1–58	CASURn	4.2.1–34
ALLQB	4.2.1–58	CCF	4.2.1–34
ALLSD	4.2.1–58	CCFn	4.2.1–34
ALLSE	4.2.1–58	CCMn	4.2.1–34
ALLVD	4.2.1–58	CCU	4.2.1–34
ALLWK	4.2.1–58	CCUn	4.2.1–34
ALPHA	4.2.1–7	CCURn	4.2.1–34
ALPHAij	4.2.1–7	CD	4.2.1–56
ALPHAk	4.2.1–7	CDIF	4.2.1–33
ALPHAk_ij	4.2.1–7	CDIFC	4.2.1–33

Variable	Page
CDIFn	4.2.1–33
CDIFRn	4.2.1–33
CDIM	4.2.1–33
CDIMC	4.2.1–33
CDIMn	4.2.1–33
CDIMRn	4.2.1–33
CDIP	4.2.1–33
CDIPC	4.2.1–33
CDIPn	4.2.1–33
CDIPRn	4.2.1–33
CDISP	4.2.1–47
CDISPETOS	4.2.1–47
CDMG	4.2.1–33
CDMGn	4.2.1–33
CDMGRn	4.2.1–33
CDSTRESS	4.2.1–47
CE	4.2.1–10
CEAVG	4.2.1–37
CECHG	4.2.1–40
CECUR	4.2.1–40
CEEQ	4.2.1–10
CEERI	4.2.1–37
CEF	4.2.1–31
CEFn	4.2.1–31
CEij	4.2.1–10
CEMAG	4.2.1–11
CEMn	4.2.1–32
CENER	4.2.1–13
CENTMAG	4.2.1–30
CENTRIFMAG	4.2.1–30
CEP	4.2.1–11
CEPn	4.2.1–11
CESW	4.2.1–11
CF	4.2.1–39
CFAILST	4.2.1–35
CFAILSTi	4.2.1–35
CFAILURE	4.2.1–13
CFF	4.2.1–38
CFL	4.2.1–41

Variable	Page
CFLn	4.2.1–41
CFn	4.2.1–39
CFN	4.2.1–48
CFNM	4.2.1–48
CFORCE	4.2.1–47
CFS	4.2.1–48
CFSM	4.2.1–48
CFT	4.2.1–48
CFTM	4.2.1–48
CHRGS	4.2.1–28
CIVC	4.2.1–34
CLINELOAD	4.2.1–47
CMn	4.2.1–39
CMN	4.2.1–49
CMNM	4.2.1–49
CMS	4.2.1–49
CMSM	4.2.1–49
CMT	4.2.1–49
CMTM	4.2.1–49
CNAREA	4.2.1–47
CNF	4.2.1–32
CNFC	4.2.1–33
CNFn	4.2.1–33
CNMn	4.2.1–33
CONC	4.2.1–16
CONF	4.2.1–14
COORD	4.2.1–19
	4.2.1–26
	4.2.1–40
COORn	4.2.1–40
CORIOMAG	4.2.1–30
CP	4.2.1–34
CPn	4.2.1–34
CPOINTLOAD	4.2.1–48
CPRn	4.2.1–34
CRACK	4.2.1–14
CRDCUTXFEM	4.2.1–31
CRF	4.2.1–34
CRFn	4.2.1–34

Variable	Page
CRKDISP	4.2.1-48
CRKSTRESS	4.2.1-48
CRMn	4.2.1-34
CRPTIME	4.2.1-56
CRSTS	4.2.1-52
CS11	4.2.1-11
CSDMG	4.2.1-48
	4.2.1-51
CSF	4.2.1-32
CSFC	4.2.1-32
CSFn	4.2.1-32
CSLST	4.2.1-33
CSLSTi	4.2.1-34
CSMAXSCRT	4.2.1-48
CSMAXUCRT	4.2.1-48
CSMn	4.2.1-32
CSQUADSCRT	4.2.1-48
CSQUADUCRT	4.2.1-48
CSTATUS	4.2.1-48
CSTRESS	4.2.1-47
CSTRESSERI	4.2.1-47
CSTRESSETOS	4.2.1-47
CTANDIR	4.2.1-48
CTF	4.2.1-31
CTFn	4.2.1-31
CTMn	4.2.1-31
CTRL_INPUT	4.2.1-59
CTRQ	4.2.1-49
CTSHR	4.2.1-11
CTSHRi3	4.2.1-12
CU	4.2.1-34
CUE	4.2.1-32
CUEn	4.2.1-32
CUn	4.2.1-34
CUP	4.2.1-32
CUPEQ	4.2.1-32
CUPEQC	4.2.1-32
CUPEQn	4.2.1-32
CUPn	4.2.1-32

Variable	Page
CUREn	4.2.1–32
CURn	4.2.1–34
CURPEQn	4.2.1–32
CURPn	4.2.1–32
CV	4.2.1–34
CVF	4.2.1–32
CVFn	4.2.1–32
CVMn	4.2.1–32
CVn	4.2.1–35
CVOL	4.2.1–40
CVRn	4.2.1–35
CW	4.2.1–39
CYCLEINI	4.2.1–17
CYCLEINIXFEM	4.2.1–31
DAMAGEC	4.2.1–15
DAMAGEFC	4.2.1–24
DAMAGEFT	4.2.1–24
DAMAGEMC	4.2.1–24
DAMAGEMT	4.2.1–24
DAMAGESHR	4.2.1–24
DAMAGET	4.2.1–15
DAMPRATIO	4.2.1–57
DBS	4.2.1–51
DBSF	4.2.1–51
DBT	4.2.1–51
DELTA_THICKNESS	4.2.1–59
DG	4.2.1–8
DGij	4.2.1–8
DGP	4.2.1–8
DGPn	4.2.1–9
DISP_NORMAL_VAL	4.2.1–60
DISP_OPT	4.2.1–59
	4.2.1–60
DISP_OPT_VAL	4.2.1–59
	4.2.1–60
DMENER	4.2.1–13
DMICRT	4.2.1–17
	4.2.1–24
DUCTCRT	4.2.1–24

Variable	Page
E	4.2.1–8
EASEDEN	4.2.1–36
ECD	4.2.1–17
	4.2.1–49
	4.2.1–50
ECDA	4.2.1–49
	4.2.1–50
ECDDEN	4.2.1–36
ECDM	4.2.1–17
ECDn	4.2.1–17
ECDT	4.2.1–49
	4.2.1–50
ECDTA	4.2.1–49
	4.2.1–50
ECTEDEN	4.2.1–36
ECURS	4.2.1–28
EDMDDEN	4.2.1–37
EE	4.2.1–9
EEij	4.2.1–9
EENER	4.2.1–13
EEP	4.2.1–9
EEPn	4.2.1–9
EFENRRTR	4.2.1–52
EFLAVG	4.2.1–37
EFLERI	4.2.1–37
EFLX	4.2.1–16
EFLXM	4.2.1–17
EFLXn	4.2.1–17
EIGFREQ	4.2.1–56
	4.2.1–57
EIGIMAG	4.2.1–57
EIGREAL	4.2.1–57
EIGVAL	4.2.1–56
Eij	4.2.1–8
EKEDEN	4.2.1–36
ELASE	4.2.1–29
ELCD	4.2.1–29
ELCTE	4.2.1–29
ELDMD	4.2.1–29

Variable	Page
ELEDEN	4.2.1–36
ELEN	4.2.1–28
ELJD	4.2.1–29
ELKE	4.2.1–28
ELPD	4.2.1–29
ELSD	4.2.1–29
ELSE	4.2.1–28
ELVD	4.2.1–29
EMB	4.2.1–25
EMBF	4.2.1–25
EMBFC	4.2.1–25
EMCD	4.2.1–25
EMCDA	4.2.1–25
EME	4.2.1–25
EMH	4.2.1–25
EMJH	4.2.1–25
EMn	4.2.1–56
ENDEN	4.2.1–37
ENDENERI	4.2.1–37
ENER	4.2.1–12
ENRRT	4.2.1–52
ENRRTXFEM	4.2.1–31
EP	4.2.1–8
EPDDEN	4.2.1–36
EPG	4.2.1–16
EPGAVG	4.2.1–37
EPGERI	4.2.1–37
EPGM	4.2.1–16
EPGn	4.2.1–16
EPn	4.2.1–8
EPOT	4.2.1–39
ER	4.2.1–8
ERij	4.2.1–8
ERP	4.2.1–8
ERPn	4.2.1–8
ERPRATIO	4.2.1–24
ESDDEN	4.2.1–36
ESEDEN	4.2.1–36
ESF1	4.2.1–26