Accessing Abaqus event series data

These utility routines can be used to access event series data from Abaqus/Standard user subroutines.

These utility routines can be invoked from Abaqus/Standard user subroutines UMDFLUX and UEPACTIVATIONVOL to access a slice of event series data. A slice is a series of events from a current time increment. You can query the properties of event series (GETEVENTSERIESSLICEPROPERTIES), get the sequence of all events in the slice (GETEVENTSERIESSLICELG), or get the list of segments that are within the provided distance to a center point (GETEVENTSERIESSLICELGLOCATIONPATH).

The following topics are discussed:

ProductsAbaqus/Standard

GETEVENTSERIESSLICEPROPERTIES—query properties of a slice of the event series data

Utility routine interface

#include <aba_evs_param.inc>

CHARACTER*80 EVSNAME, CPROPS(n_evsC_size)
DIMENSION IPROPS(n_evsI_size), RPROPS(n_evsR_size)
...
CALL GETEVENTSERIESSLICEPROPERTIES(EVSNAME, IPROPS, RPROPS, CPROPS)  

Variables to be provided to the utility routine

EVSNAME

The name of the event series that will be queried.

Variables returned from the utility routine

IPROPS(i_evsI_numFields)

The number of fields in the event series.

IPROPS(i_evsI_numEvents)

The number of events in the slice of the event series.

IPROPS(i_evsI_time)

1 for STEP TIME, 2 for TOTAL TIME.

RPROPS(i_evsR_tStart)

Time of the first event in the slice.

RPROPS(i_evsR_tEnd)

Time of the last event in the slice.

GETEVENTSERIESSLICELG—get the sequence of all events in the slice

Utility routine interface

#include <aba_evs_param.inc>

CHARACTER*80 EVSNAME
DIMENSION  EVSTIME(MAXEVENTS), EVSCOORD(3,MAXEVENTS), EVSFIELD(NUMFIELDS,MAXEVENTS)
...
CALL GETEVENTSERIESSLICELG(EVSNAME, NUMEVSPOINTS, EVSTIME, EVSCOORD, EVSFIELD)  

Variables to be provided to the utility routine

EVSNAME

The name of the event series that will be accessed.

Variables returned from the utility routine

NUMEVENTS

The number of events in the slice of event series data.

EVSTIME(MAXEVENTS)

Array containing time of events in the slice. MAXEVENTS must be equal to or greater than NUMEVENTS.

EVSCOORD(3,MAXEVENTS)

Array containing X-, Y-, and Z-coordinates of locations of events.

EVSFIELD(NUMFIELDS,MAXEVENTS)

Array containing field values of events. NUMFIELDS is the number of fields in the event series.

GETEVENTSERIESSLICELGLOCATIONPATH—get the list of path segments of the slice events that are within the provided distance to a center point

Utility routine interface

#include <aba_evs_param.inc>

CHARACTER*80 EVSNAME
DIMENSION  XCENTER(3), EVSPATHTIME(2,MAXEVENTS), EVSPATHCOORD(3,2,MAXEVENTS),
 EVSPATHFIELD(NFIELDSIZE,2,MAXEVENTS)
...
CALL GETEVENTSERIESSLICELGLOCATIONPATH(EVSNAME, XCENTER, RADIUS, 
NFIELDSIZE, NUMSEGMENTS, EVSPATHTIME, EVSPATHCOORD, EVSPATHFIELD)  

Variables to be provided to the utility routine

EVSNAME

The name of the event series that will be accessed.

XCENTER(3)

Coordinates of the center point.

RADIUS

Distance to the center point.

NFIELDSIZE

Leading dimension of EVSPATHVALUE. Must be equal to or greater than the number of fields in the event series.

Variables returned from the utility routine

NUMSEGMENTS

The number of path segments of the slice events that are within the provided distance to a center point.

EVSPATHTIME(2,MAXSEGMENTS)

Array containing the start and end time of event segments. MAXSEGMENTS must be equal to or greater than NUMSEGMENTS.

EVSPATHCOORD(3,2,MAXEVENTS)

Array containing X-, Y-, and Z-coordinates at the start and end of locations of event segments.

EVSPATHFIELD(NFIELDSIZE,2,MAXEVENTS)

Array containing the start and end field values of event segments.