xy_plots complex_scattering create
Allows you to add a new COMPLEX_SCATTERINGs to an existing plot template, or create a new template and COMPLEX_SCATTERINGs at the same time.
Format:
xy_plots complex_scattering create |
|---|
plot_name = | a new or existing plot |
complex_scattering_name = | a new scatter |
eigen_solution_name = | an existing eigen |
color = | an existing color |
symbol_type = | plot_symbols_no_none |
Example:
xy_plots complex_scattering create & |
|---|
plot_name = | plot_1 & |
color = | violet & |
symbol_type = | plus & |
eigen_solution_name = | eigen_1 & |
complex_scattering_name = | scatter__1 |
Description:
Parameter | Value Type | Description |
|---|
plot_name | A New Or Existing Plot | A plot name is a string of characters that identifies a plot. |
complex_scattering_name | A New Scatter | Specifies the name of the new complex_scattering. |
eigen_solution_name | An Existing Eigen | Specifies an existing eigen_solution. |
color | An Existing Color | Specifies the COLOR of a graphic object. |
symbol_type | Plot_Symbols_No_None | This parameter identifies the shape of the symbol used to mark data points on an xy_plot. |
Extended Definition:
1. You plot data from a result set by creating a COMPLEX_SCATTERING on a template. You must first create result sets by reading a Results or Request file or computing them using a NUMERIC_RESULTS operation.
You may specify the name of a new COMPLEX_SCATTERING, or the name of a new or old plot template. If you enter a plot name, Adams View automatically generates the COMPLEX_SCATTERING names.
If you have already created a plot template, you add COMPLEX_SCATTERINGs to it by specifying the old plot name or a new COMPLEX_SCATTERING name. If you wish to create a new template at the same time as the COMPLEX_SCATTERINGs, enter a new plot name.
Adams View will create a new template with the COMPLEX_SCATTERINGs on it.
At the time of creating a COMPLEX_SCATTERING the following attributes may be specified: COMPLEX_SCATTERING_NAME, SYMBOL_TYPE, and the EIGEN_SOLUTION_NAME. The horizontal and vertical axes defaults to REAL and IMAGINARY respectively. A COMPLEX_SCATTERING's name must be unique to all COMPLEX_SCATTERINGs on the same plot.
You may create more than one COMPLEX_SCATTERING at once by supplying EIGEN_SOLUTION_NAMEs.
2. After a plot has been created, it may be referenced by its name until it is deleted. A plot may NOT have the same name as another plot.
A plot_name may be arbitrarily long and a combination of letters of the alphabet and numbers may be used. The leading character must be a letter.
3. You may use this name later to refer to this complex_scattering. Adams View will not allow you to have two complex_scatterings with the same name, so you must provide a unique name.
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 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. You may identify a eigen_solution by typing its name.
Specifies an EIGEN_SOLUTION in a existing analysis. If an eigen_solution is available by default, you may identify it by entering its name only. The EIGEN_SOLUTION must be in an existing analysis that is associated to an existing model. Therefore, any reference to the EIGEN_SOLUTION can include the model and analysis name. For example, assume you have read a result file called "SECOND_GEAR.RES", and this result file contains the analysis "SECOND_GEAR". If you wish to refer to the EIGEN_SOLUTION named "EIG1" for the model "TRANSMISSION", enter .TRANSMISSION.SECOND_GEAR.EIG1 (the .TRANSMISSION.SECOND_GEAR. may be omitted if SECOND_GEAR is the current default analysis_name).
SECOND_GEAR refers to the analysis name that the result set came from (or is stored under). If you type a "?", Adams View will list the eigen_solutions available by default.
The eigen_solution name begins with the letters EIG and ends with the eigen_solution ID number.
You must separate multiple eigen_solution names by commas.
If the eigen_solution is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
5. A graphic object is an object that may be drawn on the screen by Adams View, these include curves, parts, markers, arcs, outlines, boxes, circles, cylinders, frustums, spring damper graphics, force graphics, and plot curves and symbols. When the COLOR of a part is specified, all graphic objects fixed to that part are drawn with the COLOR of the part. Adams View supports the following COLOR: black, white, red, green, blue, cyan, magenta, and yellow.
NOTE: if you choose the COLOR of an entity to be drawn in the view background color (typically, white or black ) it may not show up.
See help for hardcopy also.
6. Adams View currently supports the characters "*", "x", "o", "@", "+", and "none". However, you would enter the following parameter values respectively: "star", "x", "o", "at", "plus", and "none" to get those characters as symbols. The resulting shape is machine dependent but should look similar to the character.
The "none" choice produces a curve with no data point symbols displayed. For COMPLEX_SCATTERING plots the option for no symbol (i.e. the "none" option) is not available since this is a plot with only data points and no curve.