model modify

Allows you to create a model. You may reverse this creation at a later time with an UNDO command.


model modify
model_name =	an existing model
new_model_name =	a new model
comments =	string
title =	string
view_name =	an existing view

Example:


model modify
model_name =	model__1
new_model_name =	model__2
comments =	“a new model”
title =	model2
view_name =	view__1

Description:


Parameter	Value Type	Description
model_name	An existing model	Specifies the model to be modified. You use this parameter to identify the existing model to be affected with this command.
new_model_name	A New Model	Specifies the name of the new model. You may use this name later to refer to this model.
comments	String	Specifies comments for the object being created or modified.
title	String	Specifies the title of model
view_name	An Existing View	Specifies the view in which to display this model.

Extended Definition:

1.	In order to build a mechanism in Adams/View, you must first create a model object in the Adams/View database. You then add parts and other objects to the model. As you develop your model, you may display it, verify it, and change its attributes.

Once you have created a model, you add parts to it with the 'PART CREATE RIGID_BODY NAME_AND_POSITION' command. After you have created your first part or two, you can continue creating parts, or you may wish to start putting markers on the parts so you can add geometry, constraints, and forces. You use the 'MARKER CREATE' command to add markers to a part. Adding markers may help you position other parts, and creating geometry with markers will help you visualize your model as you are constructing it.

When your model is complete, you use the 'OUTPUT_CONTROL' command to request Adams output, write an Adams data set, and then analyze it with Adams. If your analysis is fairly simple, you may use the 'SUBMIT' command to write the dataset and invoke Adams.

2.	Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be of any length.

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 (e.g. 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

3.	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.

4.	When an Adams/Solver data file (.adm) is read into Adams/View, all comments associated with a statement (from the end of the previous statement through the end of the current statement) are stored with the object. Comments in the data file can be associated with model.

These comments must follow the title statement and be followed by the comment 'END OF MODEL COMMENTS'. This string must be uppercase.

When an Adams/Solver data file is written, the comments for an object are written before the statement corresponding to the object.

5.	The title is a character string up to 80 characters which describes the model. It is used as the TITLE statement in the Adams DATA SET (.adm file)

6.	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:

1.	Adams/View will not allow you to have two models with the same name, so you must provide a unique name.