Navigation:  Programmer's Reference > Sending data to DPlot from another application >

MultipleYAxes macro command

Print this Topic Previous pageReturn to chapter overviewNext page

Macro commands may be used either in macros or by sending the commands to DPlot via dynamic data exchange (DDE). Some commands are valid only in macros (noted by Macros Only). Commands sent to DPlot via DDE must be enclosed by square brackets [     ]. Macro commands should not include the brackets.

Command parameters shown in the descriptions below are placeholders for the actual values. Command parameters are either numeric values, equations that evaluate to numbers, or character strings. Character string parameters are always bound by double quotation marks. Equations must be preceded by an equals sign (=).

The pipe symbol (|) in the command syntax indicates that a parameter is optional, and should not be included in your macro unless otherwise noted.

All indices into arrays are 1-based, e.g. Curve1=1 refers to the first curve in a plot.

A 0x prefix for numbers in the descriptions below indicates hexadecimal notation; e.g. 0x0010 = 16.

JR/Viewer indicates that the command is supported by DPlot Jr or DPlot Viewer.
JR/Viewer indicates that the command is NOT supported by DPlot Jr or DPlot Viewer.


 

[MultipleYAxes(type,A,B)]

JR   Viewer

Controls the appearance of the Y axis.

type

Description

0

Single Y axis
Constants A and B are ignored.

1

Y2=f(Y1)
A second Y axis is linked to the primary Y axis by the function Y2 = A + B*Y1.

2

Independent Y2
A second Y axis is independent of the primary Y axis. Constant A = 1 to associate the selected curve with the left axis, = 2 to associate the selected curve with the right axis. Curve 1 must be associated with the left axis. Constant B is ignored.

For more information, see the Help topic on the Multiple Y Axes menu command.

NOTE: For type=2 and if used with DPLOTLIB's DPlot_Command function, be sure to combine this command with a SelectCurve command, as in:

DPlot_Command("[SelectCurve(4)][MultipleYAxes(2,2,0)]")

This is necessary (as opposed to two separate calls to DPlot_Command) because each call to DPlot_Command causes several internal variables to be initialized. If these two commands are sent in different calls then the currently selected curve will be undefined.

For type=1, you may use equations for A & B. For example,

MultipleYAxes(1,=-$YMIN/($YMAX-$YMIN),=1.0/($YMAX-$YMIN))

IndependentTicks(1)

will show a second Y axis with the values equal to 0 at the minimum Y value, 1 at the maximum Y value.

 

 


Page url: https://www.dplot.com/help/index.htm?multipleyaxescommand.htm