part create external_system name_and_position
Allows you to create an external system part by specifying its name and position.
Format:
part create external_system name_and_position |
|---|
external_system_name = | a new external system |
type = | boolean |
adams_id = | adams_id |
comments = | string |
view_name = | an existing view |
input_file_name = | string |
modal_neutral_file_name = | string |
md_db_file_name = | string |
index_in_database = | integer |
user_function = | real |
interface_routines = | string |
location = | location |
orientation = | orientation |
along_axis_orientation = | location |
in_plane_orientation = | location |
relative_to = | an existing model, part or marker |
Example:
part create external_system name_and_position & |
|---|
external_system_name = | external_system_1 & |
adams_id = | 1 & |
type = | nastran & |
planar = | yes & |
relative_to = | ground |
Description:
Parameter | Value Type | Description |
|---|
external_system_name | New external system | Specifies the name of the external system to be created. |
type | Nastran, Marc, user | The type of external system. Defaults to 'nastran' if not specified. |
adams_id | Integer | Specifies an integer used to identify this element in the Adams data file. |
comments | String | Specifies comments for the object being created or modified. |
view_name | Existing View | Specifies the view in which to display this part. |
input_file_name | String | File containing the input source parameters for the external system. |
modal_neutral_file_name | String | An optional (rigid only) MNF, if a visual representation of the external system is required. |
md_db_file_name | String | An optional MD DB, if a visual representation of the external system is required. |
index_in_database | Integer | Index of the body in the specified MD DB. Valid only if the parameter md_db_file_name is specified. |
user_function | Real | Specifies up to 30 values for Adams Solver to pass to a user-written subroutine. Valid only if the external system type is 'user'. |
interface_routines | Function | Specifies an alternative library and subroutine names for the user subroutines EXTSYS_DERIV, EXTSYS_UPDATE, EXTSYS_OUTPUT, EXTSYS_SAMP, EXTSYS_SET_NS, EXTSYS_SET_ND, EXTSYS_SENSUB, EXTSYS_SET_STATIC_HOLD, EXTSYS_SET_SAMPLE_OFFSET, respectively. |
location | Location | Specifies x, y, and z coordinates defining the flexible body's location in a given reference frame defined in the parameter relative_to. |
orientation | Orientation | Specifies the orientation method |
along_axis_orientation | Location | Specifies the orientation method |
in_plane_orientation | Location | Specifies the in_plane orientation method |
relative_to | Existing model, part or marker | Specifies a reference frame relative to which the location and orientation are defined. Leave blank or enter model name to use the global coordinate system. |
Extended Definition:
1. The position of the external system part can be broken down into two parts:
a. LOCATION
It can be specified by supplying three coordinates corresponding to the current coordinate system type. For example, if the current coordinate system type is 'cartesian', you would supply an X, Y, and Z. You may also specify location by "clicking" on an existing part or marker, with the mouse cursor, that has the same desired location.
b. ORIENTATION
It can be specified by three different methods in Adams View.
The first is by supplying three angles that correspond to the current orientation type. For example, if the current orientation type is 'body313' you would supply Z,X',Z'' rotation angles. You may also supply three angles by "clicking" on an existing part or marker, that has the same desired orientation. The second method is called the ALONG_AXIS_ORIENTATION. This method specifies the orientation by directing one of the axes. Adams View will assign an arbitrary rotation about that axis. The third and final method is called IN_PLANE_ORIENTATION. This method specifies orientation by directing one of the axes, and locating one of the coordinate planes.
All location and orientation coordinates will be relative to the coordinate system specified in the parameter RELATIVE_TO. RELATIVE_TO defaults to the global origin of the model.
2. Currently, there are three types supported for an external system: nastran, marc and user. If the parameter is not specified, it defaults to 'nastran'.
3. The input file name defines the source for the external analysis component. Nominally, this is a string defining a path and input file, but can potentially be interpreted by the external analysis component in an arbitrary manner.
4. Note that the parameters user_function and 'interface_routines' are valid only for external systems that are of type 'user'.
5. When a valid rigid only MNF or an MD-DB (with the optional index) parameters are specified, the external system will have a visual representation. Interactive marker creation and swap operations (for a rigid or a flex body) are supported for such systems. However, these parameters are optional. When not specified, the external system will have no visual representation.
6. 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 (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 AdamsAdams 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.
7. When you use the FILE ADAMS_DATA_SET WRITE command, Adams View writes an Adams data file for your model. Adams requires that each modeling element be identified by a unique integer identifier. If you use this parameter to specify a non-zero identifier, Adams View will use it in the corresponding statement in the Adams data file.
You may also enter zero as an identifier, either explicitly or by default. The next time you write an Adams file, Adams View will replace the zero with a unique, internally-generated identifier.
Adams View will permanently store this identifier with the element just as if you had entered it yourself.
Normally, you would let all identifiers default to zero, and Adams View would generate the identifiers for you. You are never required to enter a non-zero identifier. You only need to specify it if, for some reason, you wish to control the Adams file output.
8. 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.
9. 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.
10. By default, you supply Cartesian (x, y, z) coordinates. You may use the 'defaults units coordinate_system_type =' command to change this convention. For example, selecting 'cylindrical' means you will subsequently be supplying r, theta, and z coordinates.
Adams View applies your location coordinates in the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
11. Adams View will orient the coordinate system by starting from the initial coordinate system and applying three successive rotations.
Depending on the convention you have selected, the rotations may occur about space-fixed or body-fixed axes in any meaningful combination of the x, y, and z axes.
By default, you supply Euler (body313, or body-fixed z, x, z) angles.You may change this convention with the 'DEFAULTS UNITS ORIENTATION_TYPE=' command. For example, selecting SPACE123 means you will subsequently be supplying space-fixed x, y, and z angles.
Adams View applies your orientation angles starting from the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
12. You may enter either one or two locations for the in_plane_orientation parameter to direct the axis. If you enter one location, the axis will point toward the location. If you specify two locations, the axis will be parallel to, and pointing the same way as the vector from the first location to the second. Note that this does not completely dictate the orientation of the coordinate system. Adams View will position the coordinate system with an arbitrary rotation about the axis. If you must completely control the coordinate system orientation, use ORIENTATION or IN_PLANE_ORIENTATION.
By default, you direct the Z axis of the coordinate system. You may change this convention with the 'DEFAULTS ORIENT_AXIS_AND_PLANE AXIS_AND_PLANE_SETTING=' command. For example, selecting either X_AXIS_XY_PLANE or X_AXIS_XZ_PLANE means you will subsequently be directing the X axis. The plane-convention setting does not affect this parameter.
Adams View applies your location coordinates in the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
13. If the relative_to parameter is not specified, the default coordinate system is used. The default coordinate system is initially your model, that is, the global coordinate system. You may change the default coordinate system using the 'defaults coordinate_system' command.
14. The six coordinates are below.
■X - X coordinate
■Y - Y coordinate
■Z - Z coordinate
■PSI - Psi angle
■THETA - Theta angle
■PHI - Phi angle
You may enter these coordinates in any order. If Adams has to alter the part position to obtain consistent initial conditions, it does not vary the coordinates you specify with this parameter unless Adams must vary them to satisfy the initial conditions you specify for a joint or for a motion.