About Run Options
Use these options to control the engine run. You can also access many of these functions through the > command and the associated dialog box. For more information on some of these settings, see
Setting Up a Run.
sim_accurate_asm_links
Specifies whether the command line option
—sim_accurate_asm_links is included in the
msengine command in both inline and batch mode. If set to
yes, the option
—sim_accurate_asm_links is included in the msengine command. The values are as follows:
• no*
• yes
sim_contact_penetration
Use this option to modify the percent allowable penetration at a contact interface.
• 5*
• positive real number from 1 to 100
sim_contact_tolerance_factor
Use this option to modify the tolerance of the residual energy norm used for contact convergence. This option acts as a multiplication factor for the residual energy norm, which by default must be below 1.0 e-12 for an analysis to converge. The default value of this option is 1.
• 1*
• positive real number
An appropriate value can be determined by examining the residual norm values reported in the Checkpoints tab of the Run Status dialog box (the .pas file).
For example, if these values are approximately 5E-11, then the analysis is failing to reach the default by a factor of about 50. The option should be set to 50 or higher. If with an upper limit as high as 10000, the analysis still does not converge it means that you need to check the model itself.
sim_invoke_diagnostics_on_run
Use this option to run the interactive diagnostics automatically during the run of an analysis. When you run the interactive diagnostics, the Diagnostics dialog box displays all errors, warnings messages that are generated during an analysis.
When you set this option to yes, the Diagnostics dialog box is displayed by default, when you select Start run on the Analyses and Design Studies dialog box. When you set this option to no, the Diagnostics dialog box is not displayed and you cannot view any errors and warnings generated during the analysis. When you set this option to prompt, you are prompted for a confirmation to run the interactive diagnostics.
• prompt*
• no
• yes
For more information on diagnostics during a run, see
Interactive Diagnostic.
sim_massnorm_modes
Specifies whether the option
–massnorm is included in the msengine command in both inline and batch mode. If
sim_massnorm_modes is set to
yes the
–massnorm command line option is included in the
msengine command. When you set this option to
no, the modes are normalized to a maximum displacement of 1. The values are as follows:
• no*
• yes
sim_max_memory_usage
Specifies the maximum amount of memory that the FEM mesher can use. The value type is a numeric value that is measured in megabytes and should be equal or greater than 0. The default value is 0. Be aware that, if you enter a value of 0, the FEM mesher will use all the available memory.
sim_modal_disp_superposition
When set to true, dynamic analyses use modal displacement superposition for displacement, velocity or acceleration. Change this option to false to override the modal displacement superposition choices.
• true*
• false
sim_modal_stress_superposition
Set this option to control the default selection of the Stresses check box on the Output tab of the modal or the prestress modal analysis definition dialog box. When you set this option to true, the Stresses check box is selected by default and when you set it to false, the Stresses check box is cleared by default. The values are as follows:
• true*
• false
sim_newton_debugprint
Set this option to yes to print debug information to the .pas file when running the modified Newton Raphson method for an analysis. The values are as follows:
• no*
• yes
sim_newton_tolerance_factor
Factor used to change the default convergence of 1e-12 in the modified Newton Raphson method. Modify the value of this option to vary the value of user convergence tolerance as per the following equation :
User Modified Newton Raphson Convergence Tolerance=sim_newton_tolerance_factor*1e-12
• 1*
• all positive integer values greater than 1 and less than or equal to 1e8.
sim_nl_ldc
Prints the load deflection curve to the .ldc file when set to yes. The .ldc file is a text file with comma separated values for load and displacement.
• no*
• yes
sim_snap_tolerance_factor
Determines whether to start or delay snap-through. The default value of snap-through tolerance is 1.333. Set this option to a value greater than 1 to delay snap-through. To start snap-through earlier, set the value of this option to a value less than 1. This factor is used to determine the user tolerance as per the following equation:
user tolerance=sim_snap_tolerance_factor *1.33333
As per this equation, when sim_snap_tolerance_factor is set to the default value of 1 the user tolerance is 1.33333.
• 1*
• positive real number values greater than 0 and less than or equal to 1e12
sim_perturbation_solvers
Specifies whether the command line option
–no_pert is included in the msengine command in both inline and batch mode. If set to
no the
–no_pert command line option is included in the
msengine command. The values are as follows:
• yes*
• no
sim_results_io_cache_size
Specifies the size of the results IO cache in kilobytes. The default value is 512 kilobytes. During an analysis, data is written to the results IO cache and then to the hard disk.
• positive integer
• 512
sim_results_on_first_pass
Specifies whether the command line option
–results_always is included in the msengine command in both inline and batch mode. If set to
yes, the
–results_always command line option is included in the
msengine command. The values are as follows:
• no*
• yes
sim_run_out_dir
Specifies the directory for output storage. The value type is a complete path name. The default is the current directory.
sim_run_tmp_dir
Specifies the directory for temporary file storage. The value type is a complete path name. The default is the current directory.
sim_run_num_threads
Specifies the number of CPUs used for the engine run. The values are as follows:
• all*
• all_but_1
• all_but_2
• 2
• 1
• half
sim_solver_memory_allocation
Specifies the maximum amount of memory that the native solver will allocate. The value type is a numeric value that is measured in megabytes and should be greater than 0. The default value is 128.
sim_sturm_sequence
Specifies whether the command line option
–sturm is included in the
msengine command in both inline and batch mode. If set to
always, msengine runs with the option
–sturmalways and if set to
never msengine runs with the option
–sturmnever. As a part of modal solutions the run sturm sequence is checked. The default value is
default which means that the solver decides when a sturm sequence check is necessary. The values are as follows:
• default*
• always
• never
sim_supercon_recovery
Specifies whether the
–no_supercon_recovery option is included in the msengine command in both inline and batch mode. If set to
no the
—no_supercon_recovery command line option is included in the
msengine command. The values are as follows:
• yes*
• no