- file_baseThe desired solution output name without an extension. If not provided, MOOSE sets it with Outputs/file_base when available. Otherwise, MOOSE uses input file name and this object name for a master input or uses master file_base, the subapp name and this object name for a subapp input to set it.
C++ Type:std::string
Description:The desired solution output name without an extension. If not provided, MOOSE sets it with Outputs/file_base when available. Otherwise, MOOSE uses input file name and this object name for a master input or uses master file_base, the subapp name and this object name for a subapp input to set it.
Checkpoint
Output for MOOSE recovery checkpoint files.
Overview
The Checkpoint output object is designed to perform restart and recovery of simulations. The output files created contain a complete snapshot of the simulation. These files are required to perform restart or recovery operations with a MOOSE-base application.
Example Input Syntax
The simplest method for enabling checkpoint files is to use the short-cut syntax (see Output System) as follows. This will write checkpoint files at every timestep, but only keep the most recent two sets of files to avoid excessive data storage.
[Outputs]
checkpoint = true
[]
To change the interval, the number of stored files, or any of the other parameters for the Checkpoint object it is required to create a sub-block.
[Outputs]
exodus = true
[out]
type = Checkpoint
interval = 3
num_files = 2
[]
[]
(test/tests/outputs/checkpoint/checkpoint_interval.i)Input Parameters
- additional_execute_onThe list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, FAILED, CUSTOM.
C++ Type:ExecFlagEnum
Description:The list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, FAILED, CUSTOM.
- append_dateFalseWhen true the date and time are appended to the output filename.
Default:False
C++ Type:bool
Description:When true the date and time are appended to the output filename.
- append_date_formatThe format of the date/time to append, if not given UTC format is used (see http://www.cplusplus.com/reference/ctime/strftime).
C++ Type:std::string
Description:The format of the date/time to append, if not given UTC format is used (see http://www.cplusplus.com/reference/ctime/strftime).
- end_stepTime step at which this output object stop operating
C++ Type:int
Description:Time step at which this output object stop operating
- execute_onINITIAL TIMESTEP_ENDThe list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, FAILED, CUSTOM.
Default:INITIAL TIMESTEP_END
C++ Type:ExecFlagEnum
Description:The list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, FAILED, CUSTOM.
- num_files2Number of the restart files to save
Default:2
C++ Type:unsigned int
Description:Number of the restart files to save
- output_linearFalseSpecifies whether output occurs on each linear residual evaluation
Default:False
C++ Type:bool
Description:Specifies whether output occurs on each linear residual evaluation
- output_nonlinearFalseSpecifies whether output occurs on each nonlinear residual evaluation
Default:False
C++ Type:bool
Description:Specifies whether output occurs on each nonlinear residual evaluation
- start_stepTime step at which this output object begins to operate
C++ Type:int
Description:Time step at which this output object begins to operate
- suffixcpThis will be appended to the file_base to create the directory name for checkpoint files.
Default:cp
C++ Type:std::string
Description:This will be appended to the file_base to create the directory name for checkpoint files.
- use_displacedFalseEnable/disable the use of the displaced mesh for outputting
Default:False
C++ Type:bool
Description:Enable/disable the use of the displaced mesh for outputting
Optional Parameters
- binaryTrueToggle the output of binary files
Default:True
C++ Type:bool
Description:Toggle the output of binary files
- control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector
Description:Adds user-defined labels for accessing object parameters via control logic.
- enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Description:Set the enabled status of the MooseObject.
- output_if_base_containsIf this is supplied then output will only be done in the case that the output base contains one of these strings. This is helpful in outputting only a subset of outputs when using MultiApps.
C++ Type:std::vector
Description:If this is supplied then output will only be done in the case that the output base contains one of these strings. This is helpful in outputting only a subset of outputs when using MultiApps.
- padding4The number of for extension suffix (e.g., out.e-s002)
Default:4
C++ Type:unsigned int
Description:The number of for extension suffix (e.g., out.e-s002)
Advanced Parameters
- end_timeTime at which this output object stop operating
C++ Type:double
Description:Time at which this output object stop operating
- interval1The interval at which time steps are output to the solution file
Default:1
C++ Type:unsigned int
Description:The interval at which time steps are output to the solution file
- start_timeTime at which this output object begins to operate
C++ Type:double
Description:Time at which this output object begins to operate
- sync_onlyFalseOnly export results at sync times
Default:False
C++ Type:bool
Description:Only export results at sync times
- sync_timesTimes at which the output and solution is forced to occur
C++ Type:std::vector
Description:Times at which the output and solution is forced to occur
- time_tolerance1e-14Time tolerance utilized checking start and end times
Default:1e-14
C++ Type:double
Description:Time tolerance utilized checking start and end times
Timing Parameters
- linear_residual_dt_divisor1000Number of divisions applied to time step when outputting linear residuals
Default:1000
C++ Type:double
Description:Number of divisions applied to time step when outputting linear residuals
- linear_residual_end_timeSpecifies an end time to begin output on each linear residual evaluation
C++ Type:double
Description:Specifies an end time to begin output on each linear residual evaluation
- linear_residual_start_timeSpecifies a start time to begin output on each linear residual evaluation
C++ Type:double
Description:Specifies a start time to begin output on each linear residual evaluation
- nonlinear_residual_dt_divisor1000Number of divisions applied to time step when outputting non-linear residuals
Default:1000
C++ Type:double
Description:Number of divisions applied to time step when outputting non-linear residuals
- nonlinear_residual_end_timeSpecifies an end time to begin output on each nonlinear residual evaluation
C++ Type:double
Description:Specifies an end time to begin output on each nonlinear residual evaluation
- nonlinear_residual_start_timeSpecifies a start time to begin output on each nonlinear residual evaluation
C++ Type:double
Description:Specifies a start time to begin output on each nonlinear residual evaluation
Petsc Parameters
Input Files
- modules/combined/test/tests/adaptive_timestepping/adapt_tstep_function_change_restart1.i
- test/tests/restart/kernel_restartable/kernel_restartable_custom_name.i
- modules/combined/test/tests/power_law_creep/power_law_creep_restart1_sm.i
- test/tests/restart/kernel_restartable/kernel_restartable.i
- test/tests/outputs/checkpoint/checkpoint_block.i
- test/tests/restart/restartable_types/restartable_types.i
- test/tests/restart/restart_subapp_not_master/two_step_solve_sub.i
- test/tests/restart/pointer_restart_errors/pointer_load_error2.i
- test/tests/restart/pointer_restart_errors/pointer_store_error.i
- test/tests/outputs/checkpoint/checkpoint_interval.i
- modules/combined/test/tests/power_law_creep/power_law_creep_restart1.i
- test/tests/time_steppers/timesequence_stepper/timesequence_restart1.i
- modules/combined/test/tests/ad_cavity_pressure/rz.i
- modules/combined/test/tests/adaptive_timestepping/adapt_tstep_function_change_restart1_sm.i
- modules/combined/test/tests/ad_power_law_creep/power_law_creep_restart1.i
- test/tests/outputs/recover/recover1.i
- modules/combined/test/tests/solid_mechanics/LinearStrainHardening/LinearStrainHardeningRestart1.i
- modules/combined/test/tests/solid_mechanics/LinearStrainHardening/sm/LinearStrainHardeningRestart1_sm.i
- modules/combined/test/tests/cavity_pressure/rz.i