*Connection()

Used to establish a live link between a measure and a plot curve. A master/slave relationship is created be the two entities. The measure is the master and the slave is the child. Update events are passed from the master to the slave as needed; this is what makes it a live link.

Syntax

*Connection (mpgid, mwinid, mid, spgid, swinid, sid)

Application

HyperView and plot. They may not both be visible.

Inputs

mpgid
Master page ID (zero based index).
mwinid
Master window ID (zero based index).
mid
String consisting of "measureid:itemid:dopt"
measureid
measure ID
itemid
measure item ID
dopt
display option
0
x_coord,
1
y_coord,
2
z_coord,
3
mag
spgid
Slave page ID (zero based index).
swinid
Slave window ID (zero based index).
sid
Slave ID is the curve label.

Example

To create a live link between measure(3), item(2000), magnitude(3) in the first window on the first page, and a curve labeled "Mag N(252,528) (live)" in the second window on the first page:
*Connection(0, 0, 3:2000:3, 0, 1, Mag.N(252,528) (live))

Comments

This command must appear in the session file after the last page block. Also, this command must appear in a *BeginConnections()/*EndConnections() block.

There are Tcl Commands to create connections. See poIMeasure Class Commands for more information.