Products: ABAQUS/Standard ABAQUS/Explicit ABAQUS/CAE
When you run an analysis, you can write the model definition and state to the files required for restart. In ABAQUS/Standard these files are the restart (job-name.res), analysis database (.mdl and .stt), part (.prt), output database (.odb), and AMS eigenvector (.hdx) files. In ABAQUS/Explicit these files are the restart (job-name.res), analysis database (.abq, .mdl, .pac, and .stt), part (.prt), selected results (.sel), and output database (.odb) files. These files, collectively referred to as the restart files, allow an analysis to be completed up to a certain point in a particular run and restarted and continued in a subsequent run. The output database file only needs to contain the model data; results data are not required and can be suppressed.
Output, Section 4.1.1, describes the process of obtaining results output from an ABAQUS/Standard restart file.
If you want to be able to restart an analysis, you must request that the files required for restart be written when the analysis is first run. If you do not request that restart data be written, restart files will not be created in ABAQUS/Standard, while in ABAQUS/Explicit a state file will be created with results at only the beginning and end of each step.
You can control the amount of data written to the restart files, as described below. The amount of data written to the restart file can be changed from step to step if you include the restart request in each step definition.
Restart information is not written during the following linear perturbation steps:
ABAQUS/CAE Usage: | Step module: OutputRestart Requests |
In ABAQUS/CAE restart requests are always associated with a particular step; you cannot define a restart request for the entire analysis. Restart requests are created by default for every step; restart requests for ABAQUS/Standard steps have a default frequency of 0, while restart requests for ABAQUS/Explicit steps have a default number of intervals of 1. |
You can specify the frequency at which data will be written to the ABAQUS/Standard restart file and the ABAQUS/Explicit state file. The variables to be written cannot be specified; a complete set of data is written each time. Therefore, the restart files can be quite large unless you control the frequency with which restart information is written. If restart information is requested for an ABAQUS/Standard analysis at exact time intervals, ABAQUS/Standard will obtain a solution each time data are written. In this case if the frequency of output to the restart file is high, the number of increments and, consequently, the computational cost of the analysis may increase considerably.
By default, ABAQUS/Standard will write data to the restart file after each increment at which the increment number is exactly divisible by a user-specified frequency value, N, and at the end of each step of the analysis (regardless of the increment number at that time). In a direct cyclic analysis ABAQUS/Standard will write data to the restart file only at the end of a loading cycle; therefore, ABAQUS/Standard will write data to the restart file after each iteration at which the iteration number is exactly divisible by N and at the end of each step of the analysis.
Input File Usage: | *RESTART, WRITE, FREQUENCY=N |
By default, N=1. |
ABAQUS/CAE Usage: | Step module: OutputRestart Requests: enter N in the Frequency column for each step |
By default, N=0 (no restart information is written). |
ABAQUS/Standard can divide the step into a user-specified number of time intervals, n, and write the results at the end of each interval, for a total of n points for the step. If n is specified, by default data will be written to the results file at the exact times calculated by dividing the step into n equal intervals. Alternatively, you can choose to write the information at the increment ending immediately after the time dictated by each interval.
You can specify the frequency of restart output in time intervals only for the procedures listed in Table 9.1.11. In addition, this capability is not supported for linear perturbation analyses.
ABAQUS/CAE Usage: | Step module: OutputRestart Requests: enter n in the Number Interval column; click to check the Time Marks column for each step if you want the results written at the exact time intervals |
Table 9.1.11 List of ABAQUS/Standard procedures that support restart at time intervals.
Procedure | Time incrementation | Restart at exact time intervals | Restart at approximate time intervals |
---|---|---|---|
Static stress analysis, Section 6.2.2 (except if the Riks method is used) | Automatic | ||
Fixed | — | ||
Implicit dynamic analysis using direct integration, Section 6.3.2 | Automatic | ||
Fixed | — | ||
Uncoupled heat transfer analysis, Section 6.5.2 (except if you specify that the analysis end when steady state is reached) | Automatic | ||
Fixed | — | ||
Mass diffusion analysis, Section 6.8.1 (except if you specify that the analysis end when steady state is reached) | Automatic | ||
Fixed | — | ||
Coupled pore fluid diffusion and stress analysis, Section 6.7.1 (except if you specify that the analysis end when steady state is reached) | Automatic | ||
Fixed | — | ||
Fully coupled thermal-stress analysis, Section 6.5.4 | Automatic | ||
Fixed | — | ||
Coupled thermal-electrical analysis, Section 6.6.2 (except if you specify that the analysis end when steady state is reached) | Automatic | ||
Fixed | — | ||
Steady-state transport analysis, Section 6.4.1 | Automatic | ||
Fixed | — | ||
Subspace-based steady-state dynamic analysis, Section 6.3.9 | Fixed | — | |
Quasi-static analysis, Section 6.2.5 | Automatic | ||
Fixed | — |
If the output frequency is specified in terms of the number of intervals, ABAQUS/Standard will adjust the time increments to ensure that data are written at the exact time points specified. In some cases ABAQUS may use a time increment smaller than the minimum time increment allowed in the step in the increment directly before a time point. However, ABAQUS will not violate the minimum time increment allowed for consolidation, transient mass diffusion, transient heat transfer, transient couple thermal-electrical, and transient coupled temperature-displacement analyses. For these procedures if a time increment smaller than the minimum time increment is required, ABAQUS will use the minimum time increment allowed in the step and will write restart data at the first increment after the time point.
When the output frequency is specified in terms of the number of intervals, the number of increments necessary to complete the analysis might increase, which might adversely affect performance.
ABAQUS/Explicit will divide the step into a user-specified number of time intervals, n, and write the results at the beginning of the step and at the end of each interval, for a total of n+1 points for the step. By default, the results will be written to the state file at the increment ending immediately after the time dictated by each interval. Alternatively, you can choose to write the results at the exact times calculated by dividing the step into n equal intervals. Results are always written at the end of the step, so it is not necessary to request results at the exact time intervals if results are required only at the end of a step.
If a problem precludes the analysis from continuing to completion, such as if an element becomes excessively distorted, ABAQUS/Explicit will attempt to save the last completed increment in the state file.
Input File Usage: | Use the following option to request results at the increments ending immediately after each time interval: |
*RESTART, WRITE, NUMBER INTERVAL=n, TIME MARKS=NO Use the following option to request results at the exact time intervals: *RESTART, WRITE, NUMBER INTERVAL=n, TIME MARKS=YES By default, n=1. |
ABAQUS/CAE Usage: | Step module: OutputRestart Requests: enter n in the Number Interval column; click to check the Time Marks column for each step if you want the results written at the exact time intervals |
By default, n=1. |
You can specify that only one increment (or one iteration in the case of a direct cyclic analysis) per step should be retained in the ABAQUS/Standard restart file or ABAQUS/Explicit state file, thus minimizing the size of the files. As the data are written, they overlay the data from the previous increment (or iteration), if any, written for the same step. You can specify whether or not the data should be overlaid for each step individually. Since in ABAQUS/Explicit the results are written by default only at the end of the step, it is recommended to overlay the data in conjunction with specifying a number of time intervals at which data are written; in this way the data in the restart file are advanced as dictated by the number of intervals used.
To protect you from losing data if your system crashes, when ABAQUS/Standard writes a frame from a given increment, it does not strictly overwrite the frame from the last saved increment. Instead, it always keeps a reserve frame and only frees a given saved frame for overwriting when the next frame is secured on the file. This reserve frame is not deleted unless the space is required for later increments. This process produces a bonus frame in the last step of an analysis if overlaying is occurring in that step and if the analysis completes successfully; users will observe that the penultimate restart frame is also retained for the last step, even though overlay is being used.
The advantage of overlaying the restart data is that it minimizes the space required to store the restart files. The disadvantage is that if an ABAQUS/Explicit analysis terminates due to a system error, all data in the current step may be lost. Such loss of data due to a system error is extremely unlikely in ABAQUS/Standard.
ABAQUS/CAE Usage: | Step module: OutputRestart Requests: click to check the Overlay column for each step |
You restart (continue) an analysis by specifying that the restart or state, analysis database, and part files created by the original analysis be read into the new analysis. The restart files must be saved upon completion of the first job. In ABAQUS/Explicit the package (.pac) file and the selected results (.sel) file are also used for restarting an analysis and must be saved upon completion of the first job. Since restart files can be very large, sufficient disk space must be provided (in ABAQUS/Standard the analysis input file processor estimates the space that is required for the restart file).
You can specify the point at which the analysis is continued in the new run, as discussed below.
An analysis cannot be restarted from the linear perturbation steps listed in “Writing restart files.”
ABAQUS/CAE Usage: | Job module: job editor: toggle on Restart as the Job Type |
In an ABAQUS/Standard restart analysis you must specify the name of the restart file that contains the specified step and increment (or iteration for a direct cyclic analysis). In an ABAQUS/Explicit restart analysis you must specify the name of the state file that contains the specified step and interval.
ABAQUS will issue an error message if the step and increment, iteration, or interval number at which restart is requested do not exist in the specified restart or state file.
Input File Usage: | Enter the following input on the command line: |
abaqus job=job-name oldjob=oldjob-name |
ABAQUS/CAE Usage: | Any module: ModelEdit Attributesmodel_name: Restart: toggle on Read data from job and enter the oldjob-name |
You can specify the point (step and increment, iteration, or interval) in the previous analysis from which to restart. Truncating a step in the previous analysis when you restart is discussed below.
An ABAQUS/Standard analysis restarted from any analysis other than a direct cyclic analysis will continue the analysis immediately after the user-specified step and increment. If you do not specify a step or increment, the analysis will restart at the last available step and increment found in the restart file.
Input File Usage: | *RESTART, READ, STEP=step, INC=increment |
ABAQUS/CAE Usage: | Any module: ModelEdit Attributesmodel_name: Restart: toggle on Read data from job, Step name: step, toggle on Restart from increment/interval, and enter the increment |
An ABAQUS/Standard analysis restarted from a previous direct cyclic analysis can be restarted only from the end of a loading cycle. In this case you should specify the step and iteration number at which the new analysis will be resumed.
In a direct cyclic analysis that has not reached a stabilized cycle upon restart, you can increase the number of iterations or Fourier terms, thus allowing continuation of an analysis (see Direct cyclic analysis, Section 6.2.6).
Input File Usage: | *RESTART, READ, STEP=step, ITERATION=iteration |
ABAQUS/CAE Usage: | Direct cyclic analysis is not supported in ABAQUS/CAE. |
An ABAQUS/Explicit restart analysis will continue the analysis immediately after the user-specified step and interval. You must specify the step from which an ABAQUS/Explicit restart analysis will continue. If you do not specify an interval from which to restart or that the current step should be terminated at a specified interval, the analysis is restarted from the last interval available in the state file for the specified step.
Input File Usage: | *RESTART, READ, STEP=step, INTERVAL=interval |
ABAQUS/CAE Usage: | Any module: ModelEdit Attributesmodel_name: Restart: toggle on Read data from job, Step name: step, toggle on Restart from increment/interval, and enter the interval |
To continue an analysis without changes, only the steps subsequent to the step at which restart is being made should be defined in the restart analysis. All other information has been saved to the restart files.
In ABAQUS/Standard, in cases where restart is being performed simply to continue a long step (which might have been terminated because the time limit for the job was exceeded, for example), the data for the restart run may simply consist of the request to read restart data from another analysis.
Input File Usage: | *RESTART, READ |
ABAQUS/CAE Usage: | Any module: ModelEdit Attributesmodel_name: Restart: toggle on Read data from job |
In ABAQUS/Explicit, in cases where restart is being performed simply to continue a long step (which might have been terminated because a CPU time limit was exceeded, for example), do not use a restart analysis; instead, use a recover analysis. In this case no data are needed (unless user subroutines are being used).
Input File Usage: | Enter the following input on the command line: |
abaqus job=job-name recover |
ABAQUS/CAE Usage: | Job module: job editor: toggle on Recover (Explicit) as the Job Type |
You can truncate an analysis step prior to its completion when you restart the analysis. For example, by default, if the previous analysis is an ABAQUS/Standard procedure and you specify that the restart point is Step p, the restart analysis will restart from the last saved increment of Step p and continue the step to completion. However, if you specify that the restart point is increment n of Step p and that the step should be terminated before restart, the restart analysis will restart from increment n of Step p, end Step p at that point, and continue with newly defined steps. In this case the step from which the analysis is being restarted will be truncated at the time of restart, regardless of the step end time that had been given in the previous analysis. Thus, the step is considered to be completed even though all of the loading may not have been applied. Continuation of the analysis will be defined by history data provided in the restart run.
When you truncate an analysis step in an ABAQUS/Explicit restart analysis, you must specify the interval after which the analysis should be restarted.
If the step from which the restart is being made completed normally, you can truncate the step to restart within the step so that you can request additional output, write to the restart file with a higher frequency, etc. In ABAQUS/Explicit it may be necessary to truncate an analysis step when an unforeseen event occurs within a step; for example, if contact surface definitions require modification due to unforeseen displacements. If the step from which the restart is being made completed normally and the restart is being made from the last increment, iteration, or interval, truncating the analysis step will have no effect.
If the restart is being made from a job that was truncated by the operating system (for example, because of insufficient disk space, run-time limit exceeded, etc.), you will usually not choose to truncate the analysis step, so that the old step will first be completed before a new step—if any exists—is started. If restart is being made from the end of a step that terminated prematurely inside ABAQUS (for example, because it ran out of increments or it failed to converge), you must truncate the step and include a new step definition. If you do not truncate the step, ABAQUS will try to continue the old step upon restart and will terminate the analysis in the same manner as before.
Input File Usage: | Use the following option in ABAQUS/Standard to restart from any analysis step other than a direct cyclic step: |
*RESTART, READ, STEP=p, INCREMENT=n, END STEP Use the following option in ABAQUS/Standard to restart from a direct cyclic analysis step: *RESTART, READ, STEP=p, ITERATION=n, END STEP Use the following option in ABAQUS/Explicit: *RESTART, READ, STEP=p, INTERVAL=n, END STEP |
ABAQUS/CAE Usage: | Any module: ModelEdit Attributesmodel_name: Restart: toggle on Read data from job, Step name: step, toggle on Restart from increment/interval, enter the increment or interval, and toggle on and terminate the step at this point |
Care should be taken if loads and boundary conditions refer to amplitude curves (Amplitude curves, Section 27.1.2). If the amplitude is given in terms of total time, the loads and boundary conditions will continue to be applied according to the amplitude definition. However, if the amplitude is given in terms of step time (default), the loads and boundary conditions will be held constant at their values at the time the step is terminated.
Temperatures, field variables, and mass flow rates applied in the old step will remain in the new step if they are not redefined. If an amplitude curve was not specified, these quantities will continue to be applied according to the default amplitude for the procedure.
In ABAQUS/Standard care should be exercised when automatic stabilization is active at the point at which a step is truncated. This may happen either in the middle of quasi-static procedures using automatic stabilization (see Solving nonlinear problems, Section 7.1.1) or during contact analyses using automatic viscous damping (see Adjusting contact controls in ABAQUS/Standard, Section 29.2.12). In such cases viscous forces may be present, which will not be carried over to the subsequent step, therefore causing convergence difficulties.
In the case of quasi-static procedures using automatic stabilization it is recommended that the stabilization continue to be enforced during the following step and that you specify the damping factor directly, using the last value printed out by ABAQUS/Standard in the message file. In the case of automatic viscous damping in a contact pair when contact has not yet been fully established, it is recommended that the damping be applied again, although there is no guarantee that the amount of damping applied will be the same as in the original step.
In ABAQUS/Standard take care in choosing the time period and initial time increment for the new step if the previous step was truncated. In transient analyses the initial time increment for the new step should be similar to the time increment that was used at the point of restart in the old step. In quasi-static analyses choose the initial time increment of the new step so that the increments in loads or prescribed boundary conditions are similar to those at the point of restart in the old step.
In a nonlinear analysis the increment of load applied in the first increment of the restart run should be similar to that applied in the last converged increment of the previous run. Let
= the load to be applied in the first increment of the restart run,
= the remaining load to be applied in the restart run,
= the initial time increment for the restart run, and
= the total step time for the first step of the restart run.
Suppose an ABAQUS/Standard job stopped running because it reached the maximum number of increments specified for the step. The original input file was as follows:
*HEADING … *STEP, INC=4 *STATIC, DIRECT 0.1, 1.0 *CLOAD 1, 2, 20.0 *RESTART, WRITE, FREQUENCY=2 *END STEP
*HEADING *RESTART, READ, STEP=1, INC=4, END STEP *STEP, INC=120 *STATIC, DIRECT 0.1, 0.6 *CLOAD 1, 2, 20.0 *END STEP
In this example assume that a load increment of 2.0 was applied in the last converged increment of the previous run. Therefore, the initial time increment for the restart run is chosen such that the load increment applied during the first increment is also 2.0. The remaining load to be applied in the restart run is 12.0 (20.0 total 8.0 applied in the previous run). Substitution into the equation for the initial time increment yields = /6. The step time for the first step of the restarted job, , is chosen to be 0.6 so that the total accumulated time is 1.0 when the applied load is 20.0 (at the end of the step). Thus, the initial time increment for the restart run, , is set equal to 0.1.
It is possible to define steps subsequent to the step at which restart is being made. It is also possible to supply new amplitude definitions, new surfaces, new node sets, and new element sets during the restart analysis. Existing sets cannot be modified.
In ABAQUS/Standard additional surfaces defined in the model part of a restart analysis have the restriction that they can be referenced only from surface-based loading definitions (see Loads, Section 27.4) or output requests for user-defined surface sections (see Output to the data and results files, Section 4.1.2).
For example, suppose a one-step ABAQUS/Explicit job stopped prior to completion because a CPU time limit was exceeded and you have decided that a second step should be added with new boundary condition definitions. The following input file could be used to restart this job, complete the remaining part of Step 1, and complete Step 2:
The rules governing the continuation of optional analysis history data—loading, boundary conditions, output controls, and auxiliary controls (see Defining a model in ABAQUS, Section 1.3.1)—are the same for the steps defined in the restart analysis and the original analysis. For a discussion of the rules governing the continuation of optional history data, see Procedures: overview, Section 6.1.1.
It is possible to prescribe predefined fields (see Predefined fields, Section 27.6.1) in the restart analysis.
To specify predefined temperatures or field variables in an ABAQUS/Standard restart analysis, the corresponding predefined field must have been specified in the original analysis as initial temperatures or field variables (Initial conditions, Section 27.2.1) or as predefined temperatures or field variables (Predefined fields, Section 27.6.1).
User subroutines are not written to the ABAQUS/Standard restart file or to the ABAQUS/Explicit state file. Therefore, if the original analysis contained any user subroutines, these subroutines must be included again in the restart run or when recovering additional results output from restart data (see Recovering additional results output from restart data in ABAQUS/Standard” in “Output, Section 4.1.1). These subroutines can be modified on restart; however, modifications should be made with caution because they may invalidate the solution from which the restart is being made.
You can continue a previous analysis as a restart analysis and write the results from the restart analysis to a new restart file or state file. For example, if the previous analysis is an ABAQUS/Explicit procedure and in the current analysis you specify that the restart point is Step p and the restart output frequency is n, the analysis will be restarted from the last saved interval of Step p and restart states will be written in subsequent steps based on the new value of n.
To discontinue the writing of a restart file in ABAQUS/Standard when you are restarting a previous analysis, specify a restart output frequency of 0; if you do not specify a frequency, the file will continue to be written at the frequency defined for the previous analysis.
Restart files can be very large for large models or for jobs involving many restart increments (unless you choose to overlay the restart data—see “Overlaying results in the restart files”). Therefore, the previous restart file is not copied to the beginning of the new restart file when a job is restarted: only the data at restart increments requested in the current run are saved to the new restart file. However, if an eigenfrequency extraction step (Natural frequency extraction, Section 6.3.5) is restarted and additional eigenvalues are requested, the new restart file will contain those eigenvalues that converged during the first run as well as the additional eigenvalues.
Suppose an ABAQUS/Standard job stopped running because it ran out of disk space. The last complete information for an increment in the restart file is from Step 2, increment 4. The following two-line input file could be used to restart this job and continue writing the restart file:
Suppose you stopped an ABAQUS/Explicit job because too much output was being generated. The last information in the state file is from Step 2, Interval 4 at a time of .004. Step 2 has a time period of .010 and restart results were requested at 10 intervals. The following input file could be used to restart this job and redefine the remainder of the step with reduced output requests:
When you restart an analysis, ABAQUS creates a new output database file (job-name.odb) and a new results file (job-name.fil) and writes output data to those files according to the criteria described below.
The ABAQUS output database file (job-name.odb) contains results that can be used for postprocessing in ABAQUS/CAE. By default, the output database file is not made continuous across restarts; ABAQUS creates a new output database file each time a job is run. You can combine X–Y data extracted from multiple output database files in the Visualization module of ABAQUS/CAE. Alternatively, you can also join field and history results from an original analysis and a restart analysis by running the abaqus restartjoin execution procedure. For more information, see Execution procedure for joining output database (.odb) files from restarted analyses, Section 3.2.16.
The ABAQUS results file (job-name.fil) contains user-specified results that can be used for postprocessing in external postprocessing packages. In ABAQUS/Explicit results are also written to the selected results file (job-name.sel), which is then converted to the results file for postprocessing. See Output, Section 4.1.1, for details.
Upon restart ABAQUS/Standard will copy the information from the old results file into the results file for the new job up to the restart point and begin writing the new results to the new file following that point. ABAQUS/Explicit will copy the information from the old selected results file into the selected results file for the new job up to the restart point and begin writing the new results to the new file following that point.
If the old results file is not provided, ABAQUS/Standard will continue the analysis, writing the results of the restart analysis only to the new results file. Therefore, you will have segments of the analysis results in different files, which should be avoided in most cases since postprocessing programs assume that the results are in a single continuous file. You can merge such segmented results files, if necessary, by using the abaqus append execution procedure (Execution procedure for joining results (.fil) files, Section 3.2.10).
A restart analysis in ABAQUS/Standard can use the restart files generated from the same or any previous maintenance version of the same general release. For example, if the original analysis is executed with the Version 6.5-3 maintenance release, all subsequent Version 6.5 maintenance releases can be used to launch the restart analysis. Restart is not compatible between general releases; if the original analysis is executed with any Version 6.5 release, a Version 6.6 release cannot be used to launch the restart analysis.
In ABAQUS/Explicit the original analysis and the restart analysis must use precisely the same release. For example, if the original analysis is executed with the Version 6.5-3 maintenance release, only this exact release can be used to launch the restart analysis.
A restart analysis in ABAQUS and a recover analysis in ABAQUS/Explicit must be run on a computer that is binary compatible with the computer used to generate the restart files.