AppendToGraph
AppendToGraph [/W=winName /B[=axisName ] /C=(r,g,b[,a]) /L[=axisName ] /NCAT/Q/R [=axisName ] /T[=axisName ]/VERT] waveName [, waveName ] ... [vs xwaveName ]
The AppendToGraph operation appends the named waves as traces in the target or named graph. By default the traces are plotted versus the left and bottom axes.
Parameters
waveNames are the names of existing waves.
vs xwaveName tells Igor to plot the data values of waveNames against the data values of xwaveName. Otherwise, the data values of waveName are plotted versus calculated X values derived from the X scaling of waveName.
If you are appending a new trace to an existing category plot, xwaveName must be the same as the one already controlling the plot's X axis. If the existing X axis uses dimension labels from a Y wave, using the '_labels_' keyword, then xwaveName must be set to '_labels_'.
If you are appending a new category plot using a different X axis, xwaveName can refer any suitable text wave, or it may be '_labels_' to use dimension labels from the Y wave.
Subsets of data, including individual rows or columns from a matrix, may be specified using Subrange Display Syntax.
You can provide a custom name for a trace by appending /TN=traceName to the waveName specification. This is useful when displaying waves with the same name but from different data folders. See Trace Name Parameters for more information.
Flags
| /B[=axisName ] | Plots X coordinates versus the standard or named bottom axis. | |
| /C=(r,g,b[,a]) | Sets the color of appended traces. r, g, b, and a specify the the color and optional opacity as RGBA Values. | |
| /L[=axisName ] | Plots Y coordinates versus the standard or named left axis. | |
| /NCAT | Causes trace to be plotted normally on what otherwise is a category plot. X values are just category numbers but can be fractional. Category numbers start from zero. This can be used to overlay the original data points for a box plot. | |
| See Combining Numeric and Category Traces for details. | ||
| /Q | If appending to a pair of existing axes then a special, quick update mode is used. A side effect of this mode is that waves that are appended are marked as not modified. This will prevent other graphs containing these waves, if any, from being updated properly. | |
| /R[=axisName ] | Plots Y coordinates versus the standard or named right axis. | |
| /T[=axisName ] | Plots X coordinates versus the standard or named top axis. | |
| /TN=traceName | ||
| Allows you to provide a custom name for a trace. This is useful when displaying waves with the same name but from different data folders. See User-Defined Trace Names for details. | ||
| /VERT | Plots data vertically. Similar to SwapXY (ModifyGraph) but on a trace-by-trace basis. | |
| /W=winName | Appends to the named graph window or subwindow. When omitted, action will affect the active window or subwindow. This must be the first flag specified when used in a Proc or Macro or on the command line. | |
| When identifying a subwindow with winName, see Subwindow Syntax for details on forming the window hierarchy. | ||