www.kxcad.net Home > CAE Index > MSC Software Index > Adams MD R2 Index

model attributes

Allows you to set specification of attributes on the entire model.

Format:

 

model attributes
model_name =	an existing model
scale_of_icons =	real
size_of_icons =	real
visibility =	on_off_with_toggle
name_ visibility =	on_off_with_toggle
color =	an existing color
active =	on_off_no_opinion
dependents_active =	on_off_no_opinion
entity_scope =	color_scope

Example:

 

model attributes
model_name =	model__1
scale_of_icons =	0.91
visibility =	on
name_visibility =	on
color =	blue
active =	on
dependents_active =	off

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.
scale_of_icons	Real	Specifies a unit-less scale factor to apply to the current icon size.
size_of_icons	Real	Specifies the size, in modeling units, the Adams/View icons will appear in.
visibility	On_Off_With_Toggle	Specifies the visibility of graphic entities.
name_ visibility	On_Off_With_Toggle	The NAME_VISIBILITY parameter provides control over the visibility of the view name displayed in the top center position of a given view.
color	An Existing Color	Specifies the color the modeling entity should be drawn in.
active	On_Off_No_Opinion	Set the activation of the element
dependents_active	On_Off_No_Opinion	Set the activation of the dependants of an element
entity_scope	Color_Scope	The ENTITY_SCOPE parameter is used to control how a color modification is to affect a particular graphic entity.

Extended Definition:

1.	You can set the following attributes on a marker.

- SIZE_OF_ICONS / SCALE_OF_ICONS. These two parameters are mutually exclusive. You may set a size of the icon used for the marker representation in modeling units, or you may scale the size of the icon by a non-unit scale factor.

- VISIBILITY. You may set a marker's visibility ON, OFF or TOGGLE the current setting. When you set a marker's visibility OFF, the marker will not be drawn. When you set a marker's visibility ON, you allow that marker to be drawn.

- NAME_VISIBILITY. You may set a marker's name label visibility ON, OFF or TOGGLE the current setting with this parameter.

- COLOR. You may set the color of a marker with this parameter.

If an entity does not have a GRAPHICS ATTRIBUTE setting, the value for that GRAPHIC ATTRIBUTE may be inherited from another entity. INHERITANCE may either be TOP_DOWN or BOTTOM_UP.

BOTTOM_UP and TOP_DOWN refer to the natural hierarchy of the Adams model. The hierarchy is a tree structure with the model at the apex.

Parts exist beneath the model, and markers exist beneath the parts.

If the icon size of the model is set to 0.1, and the default INHERITANCE is set to TOP_DOWN, then all icons displayed within the model will be displayed in this size. However, if the icon size of a model is set to 0.1, and then the default INHERITANCE is set to BOTTOM_UP, then any icons set to a size other than the model's icon size will be displayed in their own size.

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.	If no initial size is specified for Adams/View icons, the default size will be one modeling LENGTH unit. For example, if the modeling units are K/M/S, a part axes icon will have triad legs of one meter in length.

When you specify SCALE_OF_ICONS, a new size is calculated by multipling the current size, by the scale, and storing the product as the new ICON_SIZE.

4.	If no initial size is specified for Adams/View icons, the default size will be one modeling LENGTH unit. For example, if the modeling units are K/M/S, a part axes icon will have triad legs of one meter in length.

When you set SIZE_OF_ICONS at the model level, all Adams/View icons used in creating a model will use the size specified.

If the model has a SIZE_OF_ICONS set, and a part under that model has a different SIZE_OF_ICONS, the model's ICONS_SIZE will take precedence.

An Example:

.model ---------------------- SIZE_OF_ICONS = .15 meters

.part-------------------- SIZE_OF_ICONS = .125 meters

The part's icon will be 1.5 meters is size.

If the model has SIZE_OF_ICONS set to 0.0 , and a part under that model has its SIZE_OF_ICONS set to .125, the part's icon size will be used.

An Example:

model ---------------------- SIZE_OF_ICONS = 0.0 meters

.part-------------------- SIZE_OF_ICONS = .125 meters

The part's icon will be .125 meters in size.

5.	The visibility parameter is used to control whether graphic entities, such as markers, joints, and parts, are to be drawn in an Adams/View viewport.

The legal values for this parameter are: ON, OFF, and TOGGLE. ON will make the desired entity visible. OFF will make the desired entity invisible. TOGGLE will take the current state of an entity’s visibility and reverse it.

6.	The NAME_VISIBILITY parameter provides control over the visibility of the view name displayed in the top center position of a given view.

The legal values of this parameter are ON and OFF. This is an optional parameter and if not entered, the name will be visible (i.e. will be ON).

Note that if the visibility of the view name is turned off, the only indication that a view is "active" will be the color of the viewport border. This would be a problem on a black and white monitor.

7.	Adams/View allows you to specify the following colors for modeling entities: BLACK, WHITE, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, and NO_COLOR

Specifying 'NO_COLOR' for a modeling entity instructs Adams/View to use the default color for this entity, if there is no color present in its parent modeling entity.

Example 1:

.model -------------------------NO_COLOR

.part ---------------------- RED

.geometry(circle) ------- NO_COLOR

The circle will be RED.

Example 2:

.model -------------------------NO_COLOR

.part ---------------------- RED

.geometry(circle) ------- BLUE

If a parent modeling entity has a color previously specified, that color takes precedence. Adams/View will issue a warning message about color precedence. The circle will be RED.

Example 3:

.model -------------------------NO_COLOR

.part ---------------------- NO_COLOR

.geometry(circle) ------- BLUE

The circle will be BLUE.

8.

When you set ACTIVE=NO, that element is written to the data set as a comment. When you set the ACTIVE attribute on an object, you are also setting it on the children of the object. If you set ACTIVE=NO on a part, but wish for a marker on that part to be on, then you must explicitly set ACTIVE=YES on the marker, after setting activation on the part.

The DEPENDENTS_ACTIVE parameter acts in the same fashion, but sets the ACTIVE attribute for the dependents all the way down the dependency chain. For example, if you execute the following command:

PART ATTRIBUTES PART=PAR1 DEPENDENTS_ACTIVE=NO

Where PAR1 has a marker MAR1 which is the I marker of a joint JOI1 (which has a J marker MAR2), then JOI1 will be deactivated.

Also, if the joint JOI1 is referenced in a request function, or if the I marker is referenced by a request, then the request will be deactivated.

Propagation of activation status through groups is as if each element were to have its activation status changed indvidually.

Elements affected are:

• Group

• Part

• Differential Equation

• Marker

• Geometry

• Constraints

• Forces

• Data Elements

• Output Control

9.	The legal values for this parameter are FILL_COLOR, EDGE_COLOR, OUTLINE_COLOR, and ALL.

FILL_COLOR is the color of those areas of a graphic that can be shaded (they include sides of cylinders, frustums, boxes, etc.) The EDGE_COLOR is the color of the lines making up the edges of the facets (or areas filled by the FILL_COLOR) of a graphic that can be shaded.

The OUTLINE_COLOR represents the color of the lines that make up those graphics that cannot be shaded or filled, like an outline graphic statement consisting of two points or the coil of a springdamper.

Finally, the ALL value indicates that all three entity types, FILL_COLOR, EDGE_COLOR, and OUTLINE_COLOR will be affected by the color change.

The ENTITY_SCOPE parameter is optional and if not entered, will be set to FILL_COLOR.