xy_plots axis create
Allows you to create horizontal and vertical axes for XY plot templates.
Format:
xy_plots axis create |
|---|
axis_name = | a new axis |
placement = | plot_axis_place |
offset = | real |
label = | string |
label_offset = | real |
scale_type = | axis_units |
divs = | integer |
inc = | real |
lim = | real |
default_lim = | real |
minor_divs = | integer |
numbers_point_size = | integer |
numbers_font_size = | integer |
time_limits = | real |
autoscale = | boolean |
autodivs = | boolean |
color = | an existing color |
Example:
xy_plots axis create & |
|---|
axis_name = | axis__1 & |
placement = | left offset= 1.0 & |
label = | "secondary dep axis" & |
label_offset = | 0 & |
scale_type = | linear & |
divs = | 10 & |
minor_divs = | 10 & |
color = | blue & |
autodivs = | no |
Description:
Parameter | Value Type | Description |
|---|
axis_name | A New Axis | Specifies a text string as the name of an axis, which you assign when you create an axis. |
placement | Plot_Axis_Place | Specifies whether the axis is on the top, bottom, left, or right of the plot graph. |
offset | Real | Specifies the offset of the axis line from the plot border. |
label | String | Specifies a label for an axis which will be displayed near the axis, its placement depending on where the axis is placed. |
label_offset | Real | Specifies the offset of the label from the axis line. |
scale_type | Axis_Units | Specifies the type of scale displayed on the axis. |
divs | Integer | Specifies the number of divisions on an axis. |
inc | Real | Specifies the increment between tic marks on an axis. |
lim | Real | Specifies the maximum and minimum values for an axis. |
default_lim | Real |
minor_divs | Integer |
numbers_point_size | Integer |
numbers_font_size | Integer |
time_limits | Real | This parameter allows you to fit the plot to the data corresponding to a certain range of time. |
autoscale | Boolean |
autodivs | Boolean |
color | An Existing Color | Specifies the COLOR of a graphic object. |
Extended Definition:
1. When creating an axis you may specify the axis name, axis placement (either top, bottom, left, or right), the offset of the axis line from the plot border, axis label, the label offset from the axis line, axis scale type, axis divisions or increments, limits, time limits, and color. The axes may then be referenced when creating or modifying a curve to indicate the axes against which the curve will be plotted. A unique axis name and the axis placement MUST be provided; all other parameters are optional.
Note: | The axis limits are optional and will be auto-scaled during the creation of the curve, if not specified. If the axis limits are specified, no auto-scaling of the axes will occur during the creation of the curve. |
2. You may reference the axis with respect to the plot. For example, an axis named "ax1" on plot "p1" may be referenced by the full specification of ".p1.ax1". This is useful when copying an axis from one plot to another.
An axis 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. The label can be of unlimited length, but may not all fit on the plot if it is very long. If the string contains spaces, it must be enclosed in quotation marks.
4. The number of tic marks will be DIVS + 1. For example, if you specify DIVS=3 the axis will be drawn with four tic marks. The DIVS parameter is mutually exclusive with the INC parameter. This parameter is optional. If not specified, Adams View will auto-scale the axis upon creation using five divisions.
5. Adams View will calculate the number of tic marks based on the scale and range of the data being plotted. The INC parameter is mutually exclusive with the DIVS parameter.
This parameter is optional. If not specified, Adams View will auto-scale the axis upon creation of the curve using five divisions and an appropriate increment.
6. The first value is the lower limit and the second the upper limit. The lower limit must be smaller than the upper limit and the two cannot be equal.
This parameter is optional. If not specified, Adams View will auto-scale the axis during the creation of the data curve.
7. If the time_limits parameter is specified when the plot template is created or modified, both the vertical and horizontal axes will be scaled to fit the time limits requested. One of the axes need not be TIME in order to use this parameter. If one of the axes is TIME, the lower an upper limits specified in this parameter will appear on that axis as its lower and upper limits.
8. 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 COLORs: 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.
Cautions:
1. An axis may not have the same name as another axis on the plot.
Tips:
1. Adams View supports linear, logarithmic, and db (decibel) and scales plot curves according to the type of scale.