Title | Previous | Next

refl

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

Synopsis:

refl option=value option=value

Arguments:

option

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

value

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

Option

Value

Value Meaning

Default Value

ix1

integer >= -1

The x index of the starting location for the reference line. When this value, iy1 , ix2 , and iy2 are set to -1 and logical is on , then you can specify via coordinates ( x1 , y1 , x2 , y2 ) and the code will calculate the appropriate indices.

-1

ix2

integer >= -1

The x index of the ending location for the reference line. When this value, ix1 , iy1 , and iy2 are set to -1 and logical is on , then you can specify via coordinates ( x1 , y1 , x2 , y2 ) and the code will calculate the appropriate indices.

-1

iy1

integer >= -1

The y index of the starting location for the reference line. When this value, ix1 , ix2 , and iy2 are set to -1 and logical is on , then you can specify via coordinates ( x1 , y1 , x2 , y2 ) and the code will calculate the appropriate indices.

-1

iy2

integer >= -1

The y index of the ending location for the reference line. When this value, ix1 , iy1 , and ix2 are set to -1 and logical is on , then you can specify via coordinates ( x1 , y1 , x2 , y2 ) and the code will calculate the appropriate indices.

-1

lc

line color

Line color. Color Names off means the line color will cycle through the MeshTV standard color table. A color index may be used in place of a color name.

off

legend

on, off

Whether or not a legend should be displayed with the plot.

off

logical

on, off

When on , the reference line will be created using locical index values, else it is created using coordinate values.

off

ls

dash, dot,
dotdash, solid

Line style. Line Styles

solid

lt

1 <= integer <= 4

Number to indicate thickness. 1 is the most thin, and 4 is the thickest.

1.0

name

string

The name of a reference line.

cycle

x1

real number >= 0

The x coordinate of the starting endpoint for the reference line.

0.0

x2

real number >= 0

The x coordinate of the ending endpoint for the reference line.

0.0

y1

real number >= 0

The y coordinate of the starting endpoint for the reference line.

0.0

y2

real number >= 0

The y coordinate of the ending endpoint for the reference line.

0.0

Description:

A reference plot (see the ref command) is the curve generated from data found in a reference line plot. A reference line plot 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:

refl x1=1.0 y1 4.5 x2=165.2 y2=55.3 name="line"

See Also:

curve , dist , distline , plot , ref


Title | Previous | Next

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