xy_plots curve copy
This command will create a replica of an existing curve
Format:
xy_plots curve copy |
|---|
curve_name = | an existing curve |
new_curve_name = | a new curve |
horizontal_axis = | an existing axis |
vertical_axis = | an existing axis |
Example:
xy_plots curve copy & |
|---|
xy_plots curve copy curve_name = | curve_1 & |
xy_plots curve copy new_curve_name = | curve_2 & |
xy_plots curve copy horizontal_axis = | haxis & |
xy_plots curve copy vertical_axis = | vaxis |
Description:
Parameter | Value Type | Description |
|---|
curve_name | An Existing Curve | This REQUIRED parameter identifies the name of the original curve in an XY_PLOT CURVE COPY operation |
new_curve_name | A New Curve | This parameter specifies the name to be assigned to the replica curve created from an XY_PLOT CURVE COPY operation. |
horizontal_axis | An Existing Axis | Specifies the horizontal axis against which to plot the curve. |
vertical_axis | An Existing Axis | Specifies the vertical axis against which to plot the curve. |
Extended Definition:
1. This replica will be identical to the original curve with the exception of the curve name Curves must have unique names relative to other curves on a given plot. The replica will be completely independent of the original, and may be modified without effecting the original. If a curve is to be copied "to" or "from" a completely different plot, the full curve_name specification (including plot name reference) may be required. 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 for a given plot to be the "current" or "default" to reference data (i.e. a curve) associated with it. If multiple axis plots are used and if no axes have been specified, the curve will be plotted against the primary axes of the plot.
2. The XY_PLOT CURVE COPY operation will create a replica curve that is identical to the curve named in this parameter with the exception of the new curve's name. The original curve named in this parameter will not be affected by the copy operation. If the curve to be copied is on the "default" plot (i.e. the last one created or set with the defaults.... command) only the curve name is necessary. If the curve to be copied is from a completely different plot, the full curve_name specification will be necessary. The full specification depends on the fact that 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 voids the need to force a given plot to be the "current" or "default" to reference data (i.e. a curve) associated with it.
3. The curve created will be identical to the curve named in the OLD_CURVE_NAME parameter with the exception of the curve name. Since no two curves on the same plot may have the same name, it will be necessary to specify a unique name.
It is necessary to specify the full name specification if the target plot is not the default. This full name specification uses the plot name. 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.
Cautions:
1. The leading character must be a letter
A curve_name may be arbitrarily long and a combination of letters of the alphabet and numbers may be used.