model copy
Allows you to create a replica model.
Format:
model copy |
|---|
model_name = | an existing model |
new_model_name = | a new model |
analysis_name = | an existing analysis |
frame_number = | integer |
time = | time |
view_name = | an existing view |
include_contact_steps = | integer |
more_results = | yes/no |
index_time = | yes/no |
Example:
model copy & |
|---|
model_name = | crankshaft & |
new_model_name = | model__1 & |
view_name = | view_1 |
Description:
Parameter | Value Type | Description |
|---|
model_name | An Existing Model | Specifies an existing model |
new_model_name | A New Model | Specifies the name of the new model. You may use this name later to refer to this model. |
analysis_name | An Existing Analysis | Specifies the name of an analysis. |
frame_number | Integer | Specifies the frame number (Adams simulation output time step) at which to configure the new model. |
time | Time | Allows you to identify the frame number (Adams simulation output time step) at which to configure the new model. |
view_name | An Existing View | Specifies the view in which to display this model. |
include_contact_steps | Integer | |
more_results | Boolean | Set to "yes" or "no". If unspecified, Adams View will assume "no". In addition to the positions of bodies, nearly all the states of the model at the output step of "time" for "analysis_name" will be applied as initial conditions in the ensuing model. For example, displacements and velocities of bodies, values of state variables and initial loads of force elements will be defined as initial conditions in the new model. The following entities' states are preserved when using this argument. body, gse, lse, differential_equation, motion, joint, pcurve, ccurve, marker, general_force, force_vector, torque_vector, single_component_force, modal_force, gcon, variable, request, sensor, ude_instance To learn more, see Saving a Simulation State as New Model. |
index_time | Boolean | Set to "yes" or "no". If unspecified, Adams View will assume "no". Time variables in Adams Solver (aka, "runtime") functions will shift to the value specified in the "time" argument. |
Extended Definition:
1. You can either copy a model as it was created, or at a specified frame/time step of an analysis.
If you use the MODEL_NAME parameter, the replica model will be identical to the original with the exception of the model name. All modeling entities under the original model will be copied to the replica and have the same names, including the analysis data.
If you use the ANALYSIS_NAME parameter, the replica model will contain all the modeling entities under the original model, including the analyses. The part positions (locations and orientations) and the dynamic polyline shapes will be modified to match what they would be at the time, or frame, you specify.
Models must have unique names relative to other models in Adams View.
The replica will be completely independent of the original, and may be modified without affecting the original.
2. You may identify a model by typing its name or by picking it from the screen.
If the model is not visible on the screen, you must type the name.
You may also find it convenient to type the name even if the model is displayed.
You must separate multiple model names by commas.
If the model is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
You need not separate multiple model picks by commas.
3. Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be of any length. For more information, see
Using Extended Names.
By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it.
Note that you can specify the parentage of an entity (for example, what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may override the default parent. In most cases, when creating an entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed.
You may, of course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it
4. When Adams View reads a graphics file (.GRA), a request file (.REQ), or a results file (.RES) an analysis name is created. By default, the name of the analysis is the file name excluding the extension.
Adams View requires that Adams simulations have unique names and the default name of an analysis may be overridden when reading the file(s) using the file_name parameter. When referring to an analysis name that already exists, quotes are not necessary. When processing any command that requires an analysis name, the system will default to the default analysis name. The default analysis name is set to the last analysis file read in (.GRA, .REQ, .RES, or all three). To change the default analysis name without reading in an analysis file, use the "defaults analysis" command.
5. If entered, the frame_number must be a positive integer corresponding to the desired frame (output time step). If a value greater than the last frame number is entered, the system will display the last frame.
6. The frame with the time value closest to the time specified in this parameter will be selected. Adams View will use the last frame if the time entered is greater than the time for the last frame in the simulation.
7. You may identify a view by typing its name or by picking it from the screen. In most cases, you may enter the special view name 'all', which means all the views currently displayed.
You must separate multiple view names by commas. You need not separate multiple view picks by commas.
Cautions:
■Adams View will not allow you to have two models with the same name, so you must provide a unique name.