xy_plots curve modify
Allows the modification of an existing curve
Format:
xy_plots curve modify |
|---|
curve_name = | an existing curve |
vaxis_data = | an existing component |
vmeasure = | an existing measure |
y_expression_text = | string |
y_values = | real |
ddata = | an existing component |
dmeasure = | an existing measure |
dexpression_text = | string |
dvalues = | real |
haxis_data = | an existing component |
hmeasure = | an existing measure |
x_expression_text = | string |
x_values = | real |
idata = | an existing component |
imeasure = | an existing measure |
iexpression_text = | string |
ivalues = | real |
x_units = | string |
y_units = | string |
d_units = | string |
i_units = | string |
run_name = | an integer |
vertical_axis_name = | an existing axis |
auto_vertical_axis = | boolean |
auto_axis = | auto_axis |
horizontal_axis_name = | an existing axis |
legend_text = | string |
color = | an existing color |
line_type = | line_style |
thickness = | real |
Example:
xy_plots curve modify & |
|---|
increment_symbol = | integer & |
|---|
symbol_type = | plot_symbols & |
frozen = | boolean & |
allow_hotpoints = | hotpoint_motion |
Description:
Parameter | Value Type | Description |
|---|
curve_name | An Existing Curve | A curve name is string of characters that identifies a curve |
vaxis_data | An Existing Component | Identifies the set of values that will be used for the vertical axis data when creating a curve on an xy plot. |
vmeasure, | An Existing Measure | |
y_expression_text | String | |
y_values | Real | Specifies numeric values for the y curve data |
ddata, | An Existing Component | Identifies the set of values to be used for the dependent (vertical) axis data |
dmeasure, | An Existing Measure | Identifies the measures to be used for the data displayed in the dependent axis. |
dexpression_text | String | |
dvalues, | Real | Specifies numeric values for the dependent axis data |
haxis_data, | An Existing Component | Identifies the set of values that will be used for the horizontal axis data when creating a curve on an xy plot |
hmeasure | An Existing Measure | |
x_expression_text | String | |
x_values, | Real | Specifies numeric values for the x curve data |
idata | An Existing Component | Identifies the set of values to be used for the independent (horizontal by default) axis data when creating a curve on an xy plot. |
imeasure | An Existing Measure | Identifies the measures to be used for the data displayed in the independent axis. |
iexpression_text | String | String defining the independent axis data |
ivalues | Real | Specifies numeric values for the independent curve data |
x_units | String | |
y_units | String | |
d_units | String | Specifies the units for the curve's dependent data values. |
i_units | String | Specifies the units for the curve's independent data values. |
run_name | An Existing Analysis | Indicates an existing analysis where the measure results are to be found. |
single_value_index | Integer | |
vertical_axis_name | An Existing Axis | Specifies the name of a vertical axis. |
auto_vertical_axis | Boolean | |
auto_axis | Auto_axis | Identifies one of the following: units , curve , none |
horizontal_axis_name | An Existing Axis | Specifies the name of the horizontal axis for the curve |
legend_text | String | The text string to use for the plot curve's legend. |
color | An Existing Color | Specifies the COLOR of a graphic object |
line_type | Line_style | This parameter allows the selection of the line type for a curve |
thickness | Real | This parameter allows the specification of the thickness of the curve. |
increment_symbol | Integer | If the curve has a symbol, indicates the interval at which they are displayed |
symbol_type | Plot_symbols | This parameter identifies the shape of the symbol used to mark data points on an xy_plot. |
frozen | Boolean | |
allow_hotpoints | Hotpoint_motion | When you enable the ALLOW_HOTPOINTS attribute on a curve, you can then modify the curve using click and drag |
Extended Definition:
1. A curve is a graphic representation of data displayed on an XY plot. This data can come from a results/request file or be computed using a numeric results operation. This command allows you to modify the following attributes of a curve: curve_name, line type, line thickness, symbol type, symbol visibility, and the horizontal and vertical axes against which the curve is plotted. The x and y data components may only be specified when the curve is created. A curve's name must be unique to all curves on the same plot.
2. Curve names are assigned by the user when curves are created. After a curve has been created, it may be referenced by its name until it is deleted. A curve may not have the same name as another curve on the same plot. A curve is associated to a plot and may be referenced at any time with respect to the plot. For example, a curve named "c1" on plot "p1" may be referenced by the full specification of ".p1.c1".
This type of full name specification avoids the need to force a given plot to be the "current" or "default" to reference data (i.e. a curve) associated with it. This is very useful when copying a curve from one plot to another, etc.
A curve_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. This data comes from a result_set_component object. For example, if you want to use the x component of a request result_set in your model, then you might enter VAXIS_DATA=REQ1.x.
The result set compoent must have been created previously and the data may have come from a ADAMS output file (.GRA, .REQ or .RES), via a file read, or may have been computed using the NUMERIC_RESULTS command. The name of the result set is defined either by the user or by the system when a ADAMS output file was read in. By default the names of result sets (taken from ADAMS output files when no model exists) will be assigned a name made up of the Adams View default prefix for the object and its ADAMS id number. For example, request 1508 read from a request file would be assigned the result set name of REQ1508.
FFT NOTE
Notes: | When you are plotting a result set created by the NUMERIC_RESULTS CREATE FFT command, you have several options. Recall that when the FFT results were created you specified a result set component name, say, fft1.info. This actually caused creation of three result set components fft1.info, fft1.info_MAGNITUDE and fft1.FREQUENCY.
When you are plotting this data, you can specify just the result set component that you named, VAXIS_DATA=fft1.info, without any corresponding HAXIS_DATA. Adams View will treat this as complex data and plot fft1.info_MAGNITUDE over fft1.FREQUENCY.
If either of the xxx_MAGNITUDE or FREQUENCY components is selected as the VAXIS_DATA, then the HAXIS_DATA must also be specified |
4. Specifies numeric values for the y curve data. Enter one or more real numbers separated by commas which represent the y values for the curve.
ddata comes from a result set component object. For example, if you want to use the x component of a request result set in your model, then you would enter VAXIS_DATA=REQ1.x.
The result set component must have been created previously and the data can have come from an interactive session, Adams outputfile (graphics (.gra), request (.req) or results (.res)), through reading in a file, or computed using the numeric_results command. The name of the result set is defined either by a user or by the system when an Adams output file was read in. By default, the names of result sets (taken from Adams output files when no model exists) will be assigned a name made up of the Adams View default prefix for the object and its Adams ID number.
5. If you have any measures in the expression, you must include the run_name parameter to indicate the run which the measure results reference.
6. Enter one or more real numbers separated by commas, which represent the y values for the curve.
7. haxis_data data comes from a result_set_component object. For example, if you want to use the component of a request result_set in your model, then you might enter HAXIS_DATA=REQ1.x.
The result set compoent must have been created previously and the data may have come from a Adams output file (.GRA, .REQ or .RES), via a file read, or may have been computed using the NUMERIC_RESULTS command. The name of the result set is defined either by the user or by the system when a Adams output file was read in. By default the names of result sets (taken from Adams output files when no model exists) will be assigned a name made up of the Adams View default prefix for the object and its Adams id number. For example, request 1508 read from a request file would be assigned the result set name of REQ1508.
HAXIS_DATA defaults to the "time" component for the result set containing the component specified for the VAXIS_DATA, except for the case mentioned below.
8. Specifies numeric values for the x curve data. Enter one or more real numbers separated by commas which represent the x values for the curve.
9. idata comes from a result set component object. For example, if you want to use the x component of a request result set in your model, you could enter HAXIS_DATA=REQ1.x.
The result set component must have been created previously and the data can come from an interface session, Adams output file (graphics (.gra), request (.req) or results (.res)), through reading in a file, or computed using the numeric_results command. The name of the result set is defined either by a user or by the system when an Adams output file was read in.
By default, the names of result sets (taken from Adams output files when no model exists) are assigned a name made up of the Adams View default prefix for the object and its Adams ID number. For example, request 1508 read from a request file would be assigned the result set name of REQ1508.
10. String defining the independent axis data. If you have any measures in the expression, you must include the run_name parameter to indicate the run which the measure results reference.
11. Specifies numeric values for the independent curve data. Enter one or more real numbers separated by commas, which represent the x values for the curve.
12. Identifies one of the following:
♦units - When a curve is added to the plot, look for a dependent axis that has curves with the same units. If none exists, create a new dependent axis for the curve.
♦curve - Create a new dependent axis for each curve.
♦none - Place curve on primary dependent axis of plot
13. 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 |
14. The line type describes how the line will look when displayed on a plot.
Adams View supports solid, dash, dotdash, and dot.
Line Type Appearance
-------------------------------------
solid _______________
dash _ _ _ _ _ _ _ _
dotdash . _ . _ . _ . _
dot . . . . . . . .
15. Thickness parameter acts as a multiplier, is a real number and must be greater than zero. The default for this parameter is 1. If you specify THICKNESS=2.5 the curve will two and one half times as wide as the default. Note that large values for this parameter may result in the entire plot being covered.
16. If the curve has a symbol, indicates the interval at which they are displayed. For example, increment_symbol=2 means that a symbol is displayed at every second point.
17. 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 (that is, the "none" option) is not available since this is a plot with only data points and no curve.
18. You can make the hotpoints appear on the curve by clicking on it. Once you see the hotpoints, you can drag them by placing the mouse pointer on a hotpoint, holding down the left mouse button and moving the mouse.
When ALLOW_HOTPOINTS is disabled, clicking on the curve does not allow modification via click and drag.