executive_control set preferences
This command allows you to set preferences for Adams Solver.
Format:
executive_control set preferences |
model_name = | Name of existing model |
status_message = | on/off |
contact_geometry_library = | default library/parasolids |
contact_faceting_tolerance = | real_number |
thread_count = | integer_number |
library_path = | string |
flex_limit_check = | none/skin/selnod |
flex_limit_check_action = | halt/return/message_only |
Example:
executive_control set preferences & |
model_name = | .model_1 & |
status_message = | on & |
contact_geometry_library = | default_library & |
flex_limit_check = | none & |
flex_limit_check_action = | halt |
Description:
Parameter | Value Type | Description |
|---|
model_name | Existing Model Name | Specifies an existing model. |
status_message | on/off | Specifies the status message to be on or off. |
contact_geometry_library | default_library/
parasolid | Specifies the geometry library to be used for contact operations. |
contact_faceting_tolerance | Real | Specifies the resolution of the mesh that is to be created from the solid geometries in the model. |
thread-count | Integer | Specifies the number of parallel threads that Adams Solver (C++) will use when performing the simulation. |
library_path | String | Specifies a colon-separated list of directories which are to be searched for user subroutine plug-in libraries before searching in the default locations. |
flex_limit_check | none/skin/selnod | Specifies flexible body linear limit checking on all the flexible bodies. |
flex_limit_check_action | halt/return/
message_only | Specifies what action Adams Solver (C++) should take if a flexible body exceeds its linear limit. |
Extended Definition:
1. Status_message controls the presence of two status messages in the .msg file produced by Adams Solver (C++). These status messages mimic status messages produced by Adams Solver (FORTRAN). This preference has no effect on Adams Solver (FORTRAN).
If it is set to ON, the first status message is sent after every simulation and has the form “Simulate status =i”. The second message is sent when Adams Solver (C++) terminates and has the form “Termination status = i”. In both cases, “i” is an integer number reporting the status.
2. For many models, the Default Library can substantially reduce simulation time for contact operations. Because it is polygon-based, however, it is not always as accurate as the Parasolid geometry engine. Parasolid is an exact boundary-representation geometric modeler, which makes it highly accurate, but not as fast as a polygon-based engine. For these reasons, you can switch from one to the other depending on your needs.
3. The faceting tolerance is defined as the maximum error between the true surface and the surface of the faceted representation of the geometry. The maximum error is guaranteed not to exceed (1/value) * the minimum dimension of each geometry's bounding box.
The default value of this parameter is 300.
4. The number of threads, must be an integer in the range of 1 to 8. The default value is 1.
By executing multiple threads in parallel across multiple processors, Adams Solver (C++) can reduce the wall time required for a simulation. Typically, the optimal number of threads is between N and 2N, where N is the number of processors (including virtual processors, such as Pentium processors supporting HyperThreading). Note that this option has no effect on IRIX architectures.
Note: | The Intel® Pentium® 4 processor introduced a feature called Hyper Threading, where a single physical processor can support more than one logical instruction stream, simulating multiple logical processors on a single physical processor. For many applications and environments, this capability may offer performance improvements over non-Hyper Threading processors. If multiple analysis jobs are running concurrently, however, there may be performance degradations. If an installation determines this to be the case, hyper threading should be disabled. This can be done on a permanent basis through BIOS operations or, for Windows platforms, hyper threading may be disabled on a process by process basis using the “hyperthreads” keyword. |
5. By setting flex_limit_check parameter to:
skin - Adams Solver (C++) will check the deformation of all the nodes on the skin to see whether they exceed the linear limit. To use this option, MNF_FILE or DB_FILE need to be specified in FLEX_BODY statement.
SELNOD - Adams Solver (C++) will only check the nodes specified in SELNOD section in MTX file.
The linear limit is defined as 10% of the characteristic length of the flexible body. User can use CHAR_LEN in FLEX_BODY statement to specify the characteristic length. If CHAR_LEN is not specified, Adams Solver (C++) will try to calculate the characteristic length use MNF or MD DB if MNF_FILE or DB_FILE is specified. Otherwise, Adams Solver (C++) will issue a warning.
6. Setting the flex_limit_check_action to:
HALT - Terminates execution of Adams Solver (C++).
RETURN - Stops the simulation and returns to the command level.
MESSAGE_ONLY - Issue a warning message only (Default).
For more information see
PREFERENCES statement in Adams Solver online help.