RemoveFromGraph
RemoveFromGraph [/ALL /W=winName /Z] traceName [,traceName ]...
The RemoveFromGraph operation removes the specified wave traces from the target or named graph. A trace is a representation of the data in a wave, usually connected line segments.
Parameters
traceName is usually just the name of a wave.
More generally, traceName is a wave name, optionally followed by the # character and an instance number - for example, wave0#1. See Instance Notation for details.
Flags
| /ALL | Removes all non-contour traces from the graph. Any trace name parameters listed are ignored. /ALL was added in Igor Pro 9.00. | |
| /W=winName | Removes traces from 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. | ||
| /Z | Suppresses error if specified trace or image is not on the graph. | |
Details
Up to 100 traceNames may be specified, subject to the 2500 byte command length limit.
A string containing traceName can be used with the $ operator to specify traceName.
Specifying $"#0" for traceName removes the first trace in the graph. $"#1" removes the second trace in the graph, and so on. $"" is equivalent to $"#0".
Note that removing all the contour traces from a contour plot is not the same as removing the contour plot itself. Use the RemoveContour operation.
Examples
The command:
Display myWave,myWave;Modify mode(myWave#1)=6
appends two instances of myWave to the graph.The first/backmost instance of myWave is instance 0, and its trace name is just "myWave" as a synonym for "myWave#0". The second/frontmost wave instance of myWave is "myWave#1" and it is displayed with the cityscape mode.
To remove the second instance from the graph requires the command:
RemoveFromGraph myWave#1
or
String MyTraceName="myWave#1"
RemoveFromGraph $MyTraceName