Title | Previous | Next

ref

Set options for plotting a variable vs. distance along a line.

Synopsis:

ref option=value [option=value]

Arguments:

option

A plot option for the ref plot. See table below.

value

A value associated with the matching option . See table below.

Option

Value

Value Meaning

Default Value

rl

string

The name of the reference line plot from which to take data.

a

var

variable name

Name of the variable to use for the distance data.

d

Description:

A reference plot is the curve generated from data found in a reference line plot. A reference line plot (see the refl command) consists of a line drawn on a 2D data set. This line "selects" the nodes/zones used when a corresponding reference plot is done. For example, of you type "refl x1=1.0 y1=1.0 x2=2.0 y2=4.4" and then "plot refl", a reference line will draw to the specified window. If you then type "winnew; winset 2; plot ref", a reference plot will draw to the newly created (via winnew ) and selected (via winset ) window 2. This plot will display the value of "d", the default for the var option, along the reference line created when you typed "plot refl". As you can see, the two plot types, ref and refl , are inseparable.

Another example shows the value of the two shortcut commands, dist and distline . In this example, the data are plotted in window 1, and you have already created window 2. The goal is to draw a reference line in window 1, and see the results (a reference plot) in window 2. To accomplish this by using ref and refl commands, you would type the following:

refl x1=1.0 y1=1.0 x2=2.0 y2=2.0 name= "my_refl"

plot refl

winset 2

ref var="d" rl="my_refl"

plot ref

The equivalent results typed via the dist and distline commands would be:

dist var= "d" outwin=2

distline 1 1.0 1.0 2.0 2.0

You might wonder why we even have ref and refl since dist and distline seem much easier. They are easier, but they are also much less flexible, so for those users who want more control (including the ability to specify the reference line's endpoint via logical mesh indices rather than via coordinates), ref and refl are the commands to use.

Examples:

ref rl="line", var="p"

See Also:

curve , dist , distline , plot , refl


Title | Previous | Next

MeshTV@viper.llnl.gov
Copyright © 1998, U.S. Department of Energy. All rights reserved.