29.2.1 Reading X–Y data from output database history output

You can read X–Y data from history output in the output database. Available data consist of history output that were saved during the analysis. From this output, you can select the following:

ABAQUS/CAE then reads X–Y data pairs from the output database at the frames you specify. If you select multiple variables, ABAQUS/CAE reads the data pairs and creates a separate X–Y data object for each variable by default. When you save multiple history output variables at one time, you can choose to operate on the data first; ABAQUS/CAE saves the results of the operation as a new X–Y data object. For time-based analyses, X-values are taken as total time from the start of the analysis or, in the case of a restarted analysis, as total time from the start of the last continuation of the analysis. Y-values are taken as the value at that time of the variable at the location you specify.

History output from an ABAQUS/Standard analysis is available after 10 increments are written to the output database; history output from an ABAQUS/Explicit analysis is available after 100 increments are written to the output database or after an ABAQUS/Explicit heartbeat is triggered based on CPU time, whichever occurs first.

To read X–Y data from output database history output:

  1. Locate the History Output options.

    Select ToolsXY DataCreate from the main menu bar, then choose ODB history output.

    Tip:  You can also specify history output by selecting ResultHistory Output from the main menu bar.

    The History Output dialog box appears.

    Note:  The History Output dialog box lists all history output saved during the analysis, giving the variable name and the location at which it was saved. If this list is empty, history output is not available.

  2. Click the Variables tab, if it is not already selected. Select one or more variables that you want to read. Variables are listed alphabetically along with their locations. The default is to read the first entry in the list. For more information on selecting multiple items in dialog boxes, see Selecting multiple items from lists and tables, Section 3.2.11.

    If your output database contains many history output variables, you can use the filter to reduce the number of output variable names displayed. Click the Tip button next to the Name filter field to see examples of valid filtering syntax.

    The specified variable and location are highlighted.

  3. Click the Steps/Frames tab.

    The Steps/Frames options appear.

  4. Select the step or steps you want to read. The default is to read data from all available steps.

    The specified steps are highlighted.

  5. To customize the frequency at which ABAQUS reads frames, click either:

    • Read all to read all available frames or

    • Skip, then enter the number of frames to skip in the frames between reads box. For example, if you enter 1, every second frame is read.

  6. If the data include complex numbers, you can select the displayed form using the Result Options dialog box. For more information on complex number forms in ABAQUS/CAE, see Controlling the form of complex results, Section 24.5.9.

  7. To evaluate and display the data, click Plot.

    An X–Y plot appears in the current viewport. The plot represents the data you have configured in the dialog box, which ABAQUS considers temporary data whether or not you have clicked Save As to save it.

  8. To save the data you have configured, click Save As. Any complex data are saved as the current complex form, not as complete complex numbers.

    Note:  To plot saved X–Y data, select ToolsXY DataPlot from the main menu bar and choose the X–Y data from the pull-right menu.

    If you have selected multiple output variables, you can choose in the Save XY Data As dialog box to perform one of the following operations on the variables before saving the data: sum, average, minimum envelope, maximum envelope, range, or square root of the sum of the squares (SRSS). In addition, you can toggle on Plot curves on OK to plot the X–Y data objects when you click OK.

  9. When you have finished, click Dismiss to close the History Output dialog box.


For information on related topics, click any of the following items: