3.2.16 Execution procedure for joining output database (.odb) files from restarted analyses

Products: ABAQUS/Standard  ABAQUS/Explicit  

References

Overview

The abaqus restartjoin utility appends an output database (.odb) file produced by a restart analysis of a model to the output database produced by the original analysis of that model. Combining the original and restart output database files into a single file enables you to examine all of the output data for the analysis in ABAQUS/CAE.

A similar utility, abaqus append, is used to join results (.fil) files. See Execution procedure for joining results (.fil) files, Section 3.2.10, for details.

Appending data when the analysis restarts between steps versus midstep

You can append output database files from analyses that restart between steps and from analyses that restart in the middle of a step. While the required syntax is the same for these two types of analyses, ABAQUS appends data differently, as follows:

  • For an analysis that stops and restarts between steps, ABAQUS simply appends the output from the new steps to the output from the existing steps of the original analysis.

  • For an analysis that stops and restarts in the middle of a step, the original and restart analyses overlap because the restart analysis resumes at the beginning of the interrupted step. In this case the abaqus restartjoin utility retains the results for any completed steps in the original analysis but replaces the results for the interrupted step with the output data produced by the restart analysis.

Customizing the combined output database file

By default, ABAQUS appends the output data produced by the restart analysis directly to the original output database file. If you prefer to retain the original output database file, you can create a copy of it and append the restart analysis output data to the copy instead. ABAQUS names this copy using the format Restart_original-odb-filename; for example, a copy of the original output database file job–1.odb would be named Restart_job-1.odb.

ABAQUS omits history data when you combine original and restart output databases; however, you can override this default. You can also control whether ABAQUS compresses the combined output database file.

Command summary

abaqus restartjoin
originalodb=odb-file-name
 
restartodb=odb-file-name

Command line options

originalodb

This option specifies the output database file produced by the original analysis. If you omit the copyoriginal option, ABAQUS appends the output data from the restart output database file directly to the original output database file.

If you omit this option from the command line, ABAQUS will prompt you for its value.

restartodb

This option specifies the output database file produced by the restart analysis. You can specify only one restart analysis output database file at a time.

If you omit this option from the command line, ABAQUS will prompt you for its value.

copyoriginal

If this option is specified, ABAQUS creates a copy of the output database file specified by the originalodb option and appends the contents of the restartodb output database file to that copy instead of to the original file. When this option is omitted, ABAQUS appends the output data from the restart analysis directly to the original output database file.

ABAQUS names the copied output database file by adding the prefix Restart_ to the name of the original output database file; for example, a copy of the original output database file original.odb would be named Restart_original.odb.

history

If this option is specified, ABAQUS copies history data from the restart output database to the original output database or its copy. ABAQUS omits history data in the joined output database file unless you specify this option.

compressresult

If this option is specified, ABAQUS compresses the resulting output database file.

Examples

If your model produced an initial output database file named Job-1.odb and a restart output database file named Job-1_res.odb, issue the following command to append the contents of the restart database to the initial output database file:

abaqus restartjoin originalodb=Job-1.odb restartodb=Job-1_res.odb
If you prefer to retain the original output database file, you can create a copy of this original file and append the contents of the restart output database file to the copy instead. ABAQUS creates the name of the copied output database file by adding the prefix Restart_ to the name of the original file; in the preceding example the copy of the original file Job-1.odb would be named Restart_Job-1.odb. To perform the restart join operation using a copy of the original file, issue the following command:
abaqus restartjoin originalodb=Job-1.odb restartodb=Job-1_res.odb
   copyoriginal
By default, ABAQUS does not copy history data to the combined output database. To include history data, issue the following command:
abaqus restartjoin originalodb=Job-1.odb restartodb=Job-1.odb
   history