Overview

This package provides commands for intuitive display of waves that are in (ywave,xwave) sets.

Features

Link(xwave,ywaveList,[full])
Links all waves in the string ywaveList in the current folder to the given xwave. Option full=1 links the waves using full path information (useful when working outside of a given folder). This is the default behavior. Use full=0 to link using local (folder dependent) names. When ywaveList is an empty string, link will link xwave to all other waves in the folder.

LDisplay(ywaveList,[flags,title])
Displays all waves in string ywaveList as a (ywave, xwave) set. Option flags provides for the flags associated with the standard Display command (Display/W=(...)/N=...). Option title provides for setting a title (Display ... as title). An empty string to ywaveList will display all waves in data folder except linked xwave.

LAppendToGraph(ywaveList,[flags])
Appends all waves in string ywaveList as a (ywave, xwave) set to the topmost graph. Option flags is used as above, and an empty ywaveList behaves as above.

ItsLink(ywave)
Returns the link (x-wave) name for a given ywave (wave reference).

LinkList(flder, how, [WavesList])
Returns a list of waves in folder fldr according to how and based on selections given in optional WavesList.

Help()
Typing LinkDisplay#Help() on the command line opens the help file.

Distribution Details

• Experiments: none
• Procedure Files: LinkDisplay
• XOPS: none
• Demos: none
• Requires Packages: none
• Benefits from Optional Packages: none
• Help Files: LinkDisplayHelp
• Documentation: the Web pages for this project

Example

After installing the package, execute the following commands on the command line (without the * prefixes):

* make/n=100 xwave=sin(x), ywave1, ywave2, ywave3
* ywave1=cos(x);ywave2=xwave*x;ywave3=x*cos(x)
* linkdisplay#link(xwave,WaveList("y*",";",""))
* display
* linkdisplay#lappendtograph(WaveList("y*",";",""))
* linkdisplay#ldisplay("ywave1",flags="/W=(0,0,200,200)/N=ATestPlot",title="A Simple Plot")

Assuming only xwave, ywave1, ywave2, and ywave3 exists in the current data folder, an alternative coding for the link and append to graph commands would be ...

* ...
* linkdisplay#link(xwave,""); display; linkdisplay#lappendtograph("")
* ...

Technical Details

The link command pre-pends the string <link>XWaveName</link> to the wave note of each dependent wave. The ldisplay and lappendtograph commands search for and use this information. When the given ywave contains no xwave, it is displayed as a scaled wave.

Installation

General Users

Download the Official Release. The recommended installation of the procedure file is in the User Procedures folder. Use #include "LinkDisplay" in the procedure window or in your procedure file to access the functions. Make an alias/shortcut to the LinkDisplay folder and put it in the Igor Procedures folder to have the functions always available.

Releases