Skip to main content

XWaveName

XWaveName (graphNameStr, traceNameStr)​

The XWaveName function returns a string containing the name of the wave supplying the X coordinates for the named trace in the named graph window or subwindow.

Parameters​

graphNameStr can be "" to refer to the top graph window.

When identifying a subwindow with graphNameStr, see Subwindow Syntax for details on forming the window hierarchy.

traceNameStr is the name of the trace in question.

Details​

XWaveName returns an empty string ("") if the trace is not plotted versus an X wave.

For most uses, we recommend that you use XWaveRefFromTrace instead of WaveName. XWaveName returns a string containing the wave name only, with no data folder path qualifying it. Thus, you may get erroneous results if the X wave referred to in the graph has the same name as a different wave in the current data folder. Likewise, if the named wave resides in a folder that is not the current data folder, you will not be able to refer to the named wave. Use XWaveRefFromTrace instead.

graphNameStr and traceNameStr are strings, not names.

Examples​

Display ywave vs xwave // XY graph
Print XWaveName("","ywave") // prints xwave

See Also​

Trace Names, Programming With Trace Names