xmgr.pdf

Xmgr User Guide

Evgeny Stambulchik v June

The draft xmgr user guide

Contents

Introduction

Terminology

Sets

Graphs

Regions

Parameters

Installation

Comments and bug reports

Copyright

Using xmgr

Execution

Command line parameters

Setting xmgr defaults

Setting xmgr X defaults

Environment variables

Batch printing

Guide to menus and popups

Main panel

File

Open

Save

Save as

Describe

Read sets

Read netCDF

CONTENTS

Read parameters

Read block data

Write sets

Write parameters

Clear all

Print

Printer setup

Exit

Data operations

Status

Results

Commands

Transformations

Point operations

Set operations

EditCreate set operations

Region operations

Graph operations

Block data

Hot links

Plot functions

World scaling

Viewport

Autoscale

Titlesubtitle

Tickstick labels

Frame

Symbols

Error bars

Legends

Strings Things

Time stamp

CONTENTS

Options

Page

View

Draw options

Working directory

Misc

A Command interpreter reference and parameter le format

A Introduction

A Reference

A EXIT

A Devices

A Display

A Set operations

A Block data

A Graph operations

A Transformations

A Autoscaling

A Graph focus

A Locator

A IO

A Boxes

A Lines

A Strings

A World

A World stack

A Viewport

A Title and subtitle

A Sets

A

Legend

A Graph frame

A Graph axes

A Tick marks

Introduction

A Tick labels

A Axes label strings

A

Graphs

B Hot keys

C Double clicks

D Fonts

Introduction

xmgr is an XY plotting tool for workstations or Xterminals using X A few of its features are

User dened scaling tick marks labels symbols line styles colors

Batch mode for unattended plotting

Read and write parameters used during a session

Polynomial regression splines running averages DFTFFT crossautocorrelation

Hardcopy support for PostScript HPGL and FrameMaker mif format

While xmgr has a convenient pointandclick interface most parameter settings and operations are

available through a command line interface found in DataCommands

Terminology

Sets

Sets are collections of points with optional associated values at these points The associated values can be

used to display error bars highlow openclose plots and several other features Sets are connected to a

graph and by default there are sets per graph Each set is numbered from to the maximum number

of sets less one The number of points in a set is limited by the size of virtual memory and are numbered

from to N where N is the total number of points in the set Operations to manipulate sets are found in

ADataSet operations and features such as line styles symbol types and others can be changed from

GraphSymbols

Graphs

Graphs are the collection of data sets tick marks titles etc drawn to display the data By default there

are graphs with each graph owning sets both the number of graphs and the number of sets are

Introduction

adjustable via command line parameters Operations on graphs are found in the GraphsGraph

operations popup

There are numerous popups accessible through Graphs pulldown menu that allow the manipulation of

graph parameters Most graph operations work on what is referred to as the current graph marked by

small lled rectangles at the corners of one graph The graphs available by default in this version of

xmgr are numbered from to

Regions

Regions are sections of the graph dened by the interior or exterior of a polygon or a half plane dened by

a line A region dened by a line can be above below to the right or left of the line Dening regions and

operations on points inside regions are found in DataRegion operations

Parameters

Parameters are the settings of symbols line styles colors fonts etc used to dene graphs and the display

of the active sets

Installation

To install xmgr refer to the document INSTALL found in the xmgr distribution This will describe the

details to successfully install xmgr

Comments and bug reports

For bug reports comments etc use the HelpComments online report facility

The home of xmgr sources and documentation is

httpplasmagateweizmannacilXmgrhttpplasmagateweizmannacilXmgr

Copyright

Copyright by Paul J Turner Portland OR

All Rights Reserved

Permission to use copy modify and distribute this software and its

documentation for any purpose and without fee is hereby granted

provided that the above copyright notice appear in all copies and that

both that copyright notice and this permission notice appear in

supporting documentation

PAUL J TURNER DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING

Using xmgr

ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS IN NO EVENT SHALL

PAUL J TURNER BE LIABLE FOR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR

ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE DATA OR PROFITS

WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHER TORTIOUS ACTION

ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS

SOFTWARE

Using xmgr

Execution

The interactive xmgr program is called xmgr if used in batch mode grbatch If grbatch is not found

contact your system administrator or see the section on installation For grbatch to work properly it is

important that it be called grbatch as it is the name that distinguishes xmgr from grbatch They are

the same program but when executed as grbatch the X interface is not initialized and grbatch

terminates at the end of execution without user intervention

Please note that grbatch does not read the any X resource les so that it can be run from dumb

terminals and over phone lines Dont expect resource settings used for xmgr to work for grbatch See

the section on setting defaults using a defaults xmgrrc le

Command line parameters

autoscale x or y or xy

Autoscale the x axis y axis or both axes overiding the settings for axes scaling and tick mark

spacing given in any parameter le specied by the p option

Example

xmgr autoscale x p paramspar datadat

Reads parameters from paramspar and data from datadat but overrides any settings for the X axis

found in the parameter le

noauto

y or y or xy

Suppress autoscaling on the given axis axes Use this when a data le has imbedded commands

that provide axes scaling and tick mark spacing

arrange

rows columns

Arrange graphs in column major order starting from the lower left corner in a grid rows by columns

For example arrange will position the rst four graphs in a x matrix of graphs

Using xmgr

starting with graph in the lower left corner of the plotting surface This function is not as complete

as the similar function found in GraphGraph operationsArrange graphopshtmlarrange and

gives a sightly dierent result

Example

xmgr arrange

Creates a x matrix of graphs

rows

rows Arrange the rst rows graphs in rows rows

cols

columns

Arrange the rst columns graphs in columns columns

results

results le

Write the results of regression and anything else that gets written to the results popup to le

results le

device

device number

Set the hardcopy device to device number The device numbering follows

PostScript landscape

PostScript portrait

FrameMaker mif landscape

FrameMaker mif portrait

HPGL landscape

HPGL portrait

InterLeaf landscape

InterLeaf portrait

Example

xmgr device

Sets the hardcopy device to PostScript portrait

eps

Tell the PostScript driver to produce EPS

Using xmgr

printle

graphics output le

Write the graphics output to le graphics output le rather than spool graphics data to a printer

xed

width height

portrait

landscape

free

Set the dimensions of the drawing area Presently there is no connection between the hardcopy

drivers and these settings This means that the printer needs to be set to conform to the dimensions

of the drawing area

free allow the drawing area to be resized no scrollbars will appear

xed width height set the drawing area to have dimensions width and height

portrait set the drawing area to be x in portrait

landscape set the drawing area to be x in landscape

batch

batch le

Execute the commands in batch le on startup This command line switch is not the same as

executing xmgr in batch mode as grbatch

noask

Assume the answer is yes to all requests This means that les will be overwritten without asking if

they exist and if Exit is selected in the GUI xmgr will exit abruptly This option can be used to

overwrite existing les in batch mode Be careful

graph

graph number

Make graph number the current graph Graph number is an integer between and maxgraph by

default maxgraph the maximum number of graphs is

For example to activate four graphs and read data to each graph

xmgr arrange datadat graph datadat graph datadat graph

datadat

This command creates graphs arranged in a x matrix and reads a le into each graph

graphtype

graph type

Set the current graph type to graph type Where graph type is one of

Using xmgr

xy linear scaling along both x and y

logx linear scaling in y log scaling in x

logy linear scaling in x log scaling in y

logxy log scaling in both x and y

bar vertical bar chart

hbar horizontal bar chart

stackedbar vertical stacked bar chart

stackedhbar horizontal stacked bar chart

type

data set type

The format of the next data source is data set type Where data set type is one of xydx XY data

with error bars along X xydy XY data with error bars along Y xydxdx XY data with error

bars along X of diering values xydydy XY data with

error bars along Y of diering values xydxdy error bars along X and Y xyr a circle drawn at

XY of radius R and xyhilo XY data with highlow openclose data This setting remains in eect

until a new format type is specied

ihl

IHL formatted le

Assume IHL formatted le or the next source of data is in IHL format a local format

nxy

The format of the next data source is X Y Y Yn

xydx

The format of the next data source is X Y DX

xydy

The format of the next data source is X Y DY

xydxdx

The format of the next data source is X Y DX DX

xydydy

The format of the next data source is X Y DY DY

xydxdy

The format of the next data source is X Y DX DY

xyz

The format of the next data source is X Y Z where Z is a value drawn as text at X Y

Using xmgr

xyr

The format of the next data source is X Y R where a circle of radius R is drawn at X Y

xybox

The format of the next data source is XMIN YMIN XMAX YMAX VALUE where XMIN YMIN

is the lower lefthand corner of a rectangle and XMAX YMAX are the upper righthand corner of a

rectangle VALUE is an integer used to specify the color to use to ll the rectangle To set the ll

use GraphSymbols and set the ll style to anything but None

boxplot

The format of the next data source is X AVG

ihl

The format of the next data souce is in IHL format this format leads to a data set of type XY

hilo

The format of the next data source is X HIGH LOW OPEN CLOSE where a symbol denoting the

open close the high and the low values for an observation is drawn at X

netcdf

netCDF le

netcdfxy

xvar or null yvar

Where xvar and yvar are the names of the variables to read if xvar null then load the index

of yvar These command line options may be used to read variables from a netCDF le For example

xmgr netcdf tnc netcdfxy null y

Reads y from tnc and loads to X the index starting from

xmgr netcdf tnc netcdfxy x y netcdfxy x y

Reads x and y from tnc then x and y from the same le sets are created both of type XY one

with x y the other composed of x y

another example reading data from CDF les

xmgr netcdf tnc netcdfxy x y netcdf tnc netcdfxy x y

saveall

lename

Write all active sets to lename

Using xmgr

wd

Set the current working directory This option can be used to read les from several dierent

directories For example

xmgr wd examples mlodat wd moredat brwd hilodat

Unfortunately this option not allow wild cards as they are expanded in the current directory only

image

X window dump le

Read the window dump le X window dump le The format is the same as generated by xwd or

Frames capture utility

imagexy

X Y

Set the upper lefthand corner position of the image at screen coordinates X Y Note that screen

coordinates have as their origin the upper lefthand corner of the drawing area and positive increasing

Y points down

block

Assume the format of the next data le is block data No sets are formed by reading block data and

only one set of block data is allowed in an active session To create sets from the block data use

EditBlock data

bxy

colcol

Create sets from a previously read block data Using bxy colcol will create a set using the

current set type default is XY and using column col and column col from the most recently read

set of block data Col and col are integers indicating the numbers of the columns column

numbers start from For example

xmgr block blockd bxy bxy

will read blockd and generate sets of type XY using columns and for the rst set and and

for the second set

xmgr block blockd type xydy bxy

will read blockd and generate a set of type XYDY an XY set with error bars using column and

for X and Y and column for the error bars

log

x or y or xy

Set the current graph type to logarithmic depending the the string x or y or both axes by xy

Using xmgr

parameter

parameter le

p

parameter le

Read the parameter le parameter le

pexec

parameter string

Interpret parameter string as a parameter setting

result

result le

Write results from regression to result le

rvideo

Exchange the color indices for black and white

mono

Limit colors to black and white aects the display only

dc

Allow double click canvas operations overriding any application default setting

nodc

Disallow double click canvas operations

redraw

Redraw the entire page if xmgr receives an Expose event

noredraw

Do not redraw the entire page when Expose events are received

maxcolors

number of colors

Set the maximum number of colors allocated For example

xmgr maxcolors pexec cmap

Sets the maximum number of colors to and sets color to cyan Colors are set to the

defaults color is undened the actual color will vary

freecolors

Attempt to free colors which are assigned a dierent colormap entry See nofreecolors below This

is the default behavior

Using xmgr

nofreecolors

Doesnt attempt to free colors which are assigned a dierent colormap entry Use this if one of the

colors you use is the same as one of the button or border colors and you subsequently change that

color This shouldnt be a problem unless youre really unlucky Using this switch can cause you to

eat up all the colors in your colormap if you change colors a lot during a session This is equivalent to

setting the X resource

freeColorsXRXMgrfreeColors to false

world

xmin ymin xmax ymax

Set the scaling of the axes for the current graph The X axis will run from xmin xmax the Y axis

from ymin ymax

view

xmin ymin xmax ymax

Set the viewport of the current graph to a rectangle described by

xmin ymin and xmax ymax

source

data source

Set source for the next data le the argument takes on the following values

disk Data le is on disk

pipe Read from a pipe

stdin xmgr is in a pipe read from standard input

The source setting stays in eect until the next source command is given

pipe

Read from standard input and plot each set when the end of the set is seen Use the pipe option to

monitor the results coming from a model or other data stream

remove

Erase the most recently read le Use this option when using xmgr to read a temporarily constructed

le that is not needed once read Note that this option does not request conrmation

legend load

For each data set read make the set legend label the same as the lename the data set originated

seed

seed value

Initialize the random number generator using seed seed value This value is used in a call to the math

library function srand

Using xmgr

GXinvert

GXxor

GXinvert and GXxor set the type of graphics operation used to draw rubberband lines and draw the

graph focus markers In a colormapped display the xor of a source and destination pixel may not

generate a color visible on the drawing area The default is to use xor to draw rubberband lines if

the lines dont show try GXinvert This draw mode can be set via X resource settings see below

maxplot

number of sets

Set the maximum number of data sets per graph Number of sets must be greater than If

maxplot is used in conjunction with maxgraph then the maxplot setting must precede the

maxgraph setting

maxgraph

number of graphs

Set the maximum number of graphs per session Number of graphs must be greater than If

maxgraph is used in conjuction with maxplot then maxplot must precede the use of maxgraph

nonl

Activate the Nonlinear curve tting module WARNING this module is a prototype and should not

be used for analysis

digit

Activate the Digitizing module WARNING this module is a prototype and should not be used for

analysis

usage

Display a brief explanation of command line settings

data les

The les or commands in the case of a pipe from which data are read

Setting xmgr defaults

On startup xmgr will look for a xmgrrc le in the users home directory allowing changes to the default

behavior of xmgr The construction of the xmgr default le is the same as for a parameter le

Setting xmgr X defaults

The following X resource settings are supported

Using xmgr

XMgrinvertDraw False

Use GXinvert to draw rubberband lines and the graph focus markers if this resource is set to True

XMgrreverseVideo False

A boolean resource used to exchange the color indices for black and white

XMgrmaxSets

Set the number of sets per graph

XMgrmaxGraphs

Set the number of graphs

XMgrmaxColors

Set the number of colors allocated There is no support in the graphical portion of the user interface

for more than

XMgrverifyAction No

Applies to the Pick set operations and allows an opportunity to accept or cancel any operation

performed

XMgrallowDoubleClick Yes

When Yes allow double clicks on the canvas to bring up various popups depending on the location of

the pointer when the double click occurs Double clicking to the right of a graph brings up the

ViewTicks popup set to the Yaxis below the graph brings up the ViewTicks popup set to the

Xaxis inside the graph brings up the les popup if no sets are active or the ViewSymbols popup set

to the set nearest the pointer Double clicking above the graph brings up the ViewTitlesubtitle

popup to the right of the graph the ViewLegend popup

The command line option to set this resource is dc or nodc

XMgrautoscaleOnRead No

When this resource is Yes or True allow autoscaling to occur each time a set is read from the

FileRead sets popup

XMgrbackingstore No

Have xmgr handle backing store if the server doesnt

The command line option for this is bs or nobs

XMgrfreeColors True

See documentation for the command line option freeColorsSWnofreecolors Using that

command line switch is equivalent to setting this resource to false

It is also possible to customize menus by assigning key accelerators to any item

The list below describes the menu labels and related X resources For example in order to make xmgr

popup the Nonlinear curve tting by pressing ControlF you would add the following two lines

Using xmgr

XMgrtransformationsMenunonLinearFitacceleratorText CtrlF

XMgrtransformationsMenunonLinearFitaccelerator CtrlKeyf

to your Xresources le the le which is read when an X session starts it could be Xdefaults Xsession or

some other le ask your system administrator when in doubt

XMgrleMenuopen Open

XMgrleMenusave Save

XMgrleMenusaveAs Save as

XMgrleMenudescribe Describe

XMgrreadMenusets Sets

XMgrreadMenunetCDF NetCDF

XMgrreadMenuparameters Parameters

XMgrreadMenublockData Block data

XMgrreadMenuimage Image

XMgrwriteMenusets Sets

XMgrwriteMenuparameters Parameters

XMgrleMenuclearAll Clear all

XMgrleMenuprint Print

XMgrleMenuprinterSetup Printer setup

XMgrleMenuexit Exit

XMgrdataMenustatus Status

XMgrdataMenuresults Results

XMgrdataMenucommands Commands

XMgrtransformationsMenuevaluateExpression Evaluate expression

XMgrtransformationsMenuloadValues Load values

XMgrtransformationsMenuloadEvaluate Load evaluate

XMgrtransformationsMenuhistograms Histograms

XMgrtransformationsMenufourierTransforms Fourier transforms

XMgrtransformationsMenurunningAverages Running averages

XMgrtransformationsMenuregression Regression

XMgrtransformationsMenunonLinearFit Nonlinear curve tting

XMgrtransformationsMenudirences Dierences

Using xmgr

XMgrtransformationsMenuseasonalDierences Seasonal dierences

XMgrtransformationsMenuintegration Integration

XMgrtransformationsMenucorrelation Crossauto correlation

XMgrtransformationsMenuinterpolation Interpolation

XMgrtransformationsMenusplines Splines

XMgrtransformationsMenusamplePoints Sample points

XMgrtransformationsMenudigitalFilter Digital lter

XMgrtransformationsMenulinearConvolution Linear convolution

XMgrtransformationsMenugeometricTransforms Geometric transforms

XMgrdataMenupointOperations Point operations

XMgrsetOperationsMenupickOperations Pick operations

XMgrsetOperationsMenuactivate Activate

XMgrsetOperationsMenudeactivate Deactivate

XMgrsetOperationsMenureactivate Reactivate

XMgrsetOperationsMenusetLength Set length

XMgrsetOperationsMenuchangeType Set type

XMgrsetOperationsMenucopy Copy

XMgrsetOperationsMenumove Move

XMgrsetOperationsMenudropPoints Drop points

XMgrsetOperationsMenujoin Join

XMgrsetOperationsMenusplit Split

XMgrsetOperationsMenukill Kill

XMgrsetOperationsMenukillAll Kill all

XMgrsetOperationsMenuSort Sort

XMgrsetOperationsMenureverse Reverse

XMgrsetOperationsMenucoalesce Coalesce

XMgrsetOperationsMenuswap Swap

XMgrsetOperationsMenupack Pack

XMgrtransformationsMenueditCreateSet Editcreate set

XMgrregionOpearationsMenudene Dene

XMgrregionOpearationsMenuevaluate Evaluate

XMgrregionOpearationsMenuclear Clear

XMgrregionOpearationsMenuextractPoints Extract points

XMgrregionOpearationsMenuextractSets Extract sets

Using xmgr

XMgrregionOpearationsMenudeletePoints Delete points

XMgrregionOpearationsMenukillSets Kill sets

XMgrregionOpearationsMenureportOn Report on

XMgrregionOpearationsMenuareaPerimeter Areaperimeter

XMgrgraphOperationsMenuactivate Activate

XMgrgraphOperationsMenucopy Copy

XMgrgraphOperationsMenuswap Swap

XMgrgraphOperationsMenukill Kill

XMgrgraphOperationsMenufocus Focus

XMgrgraphOperationsMenushow Show

XMgrgraphOperationsMenusetType Set type

XMgrgraphOperationsMenuarrange Arrange

XMgrgraphOperationsMenuoverlay Overlay

XMgrgraphOperationsMenuinvertFlipAxes Invertip axes

XMgrtransformationsMenublockData Block data

XMgrtransformationsMenuhotLinks Hot links

XMgrplotMenuworldScaling World scaling

XMgrplotMenuviewport Viewport

XMgrplotMenuautoscale Autoscale

XMgrplotMenutitles Titles

XMgrplotMenutickLabelsMarks Tick labelstick marks

XMgrplotMenuframe Frame

XMgrplotMenusymbols Symbols

XMgrplotMenuerrorBars Error bars

XMgrplotMenulegends Legends

XMgrplotMenustringsThings Strings things

XMgrplotMenutimeStamp Time stamp

XMgrpageMenufree Free

XMgrpageMenulandscape Landscape

XMgrpageMenuportrait Portrait

XMgrpageMenuxed Fixed

Using xmgr

XMgrpageMenusize Size

XMgrviewMenulocatorBar Locator bar

XMgrviewMenustatusBar Status bar

XMgrviewMenutoolBar Tool bar

XMgrviewMenusetLocatorFixedPoint Set locator xed point

XMgrviewMenuclearLocatorFixedPoint Clear locator xed point

XMgrviewMenulocatorProps Locator props

XMgroptionsMenudraw Draw

XMgroptionsMenuworkingDirectory Working directory

XMgroptionsMenumisc Misc

XMgrhelpMenuonContext On context

XMgrhelpMenuuserGiude User Guide

XMgrhelpMenufaq FAQ

XMgrhelpMenuchanges Changes

XMgrhelpMenucomments Comments

XMgrhelpMenuabout About

Environment variables

GR HOME

Set the location of xmgr This will be where help les auxillary programs and examples are located

If you are unable to nd the location of this directory contact your system administrator

GR PS PRSTR

Set the command string to use for spooling to a PostScript printer The default unless changed

during the build process is lpr h

GR MIF PRSTR

Set the command string to use for printing the FrameMaker mif format The default unless changed

during the build process is cat acegrmif ie output is to a le

GR HPGL PRSTR

Set the command string to use for spooling to an HPGL capable printer or plotter

GR HDEV

Select the hardcopy device

The device numbering is as follows


PostScript landscape

PostScript portrait

FrameMaker interchange format mif landscape

FrameMaker interchange format mif portrait

HPGL landscape

HPGL portrait

Interleaf landscape

Interleaf portrait

GR EDITOR

Set the name of the editor to use in DataEditCreate set The default is vi

Batch printing

Executing xmgr as grbatch suppresses the initialization of the graphical user interface and allows

hardcopy plots to be made without intervention


Main panel

There are main areas in the display the menu bar at the top the locator bar just below the toolbar

along the lefthand side of the display the status bar at the bottom and the drawing area where graphics

are drawn The following items describe the locator bar the toolbar and the status bar

Tool bar

The toolbar runs along the lefthand side of the display and provides functions to manipulate the axes

scaling of active graphs by scrolling and mouse powered zooms

Draw

Click on Draw to freshenup the drawing area with the current set of graphs parameters and

active sets Most operations perform an automatic redraw this may be undesirable in the cases

where the sets are large or there are several active graphs By playing with the options in

GraphDraw options and using the Draw button much of the tedium associated with slow

redraw rates can be alleviated If you feel something should have happened after performing an

operation press this button to force a draw operation to freshenup the display If the X display

being used does not do backing store then Draw will give a clean picture if the graphics get

damaged when overlaid by popups or other applications

Zoom

Zoom


Autoscale

Click on Autoscale to generate a default scaling for both the X and Y axes in the current graph

Expand

Click on Expand to incrementally zoom in on the data

Shrink

Click on Shrink to incrementally zoom out from the data

Page left

Click on Left to incrementally shift the axes to the left

Page right

Click on Right to incrementally shift the axes to the right

Page down

Click on Down to incrementally shift the axes down

Page up

Click on Up to incrementally shift the axes up

Auto ticks

Using any of the buttons that aect the scale of the axes it is likely that unpleasing tickmarks

will result By clicking on AutoT the tick spacing will be set using the current autoscaling

parameters set in GraphAutoscale

Auto scale on a picked set

Click on AutoO then click near a point in the set of interest to autoscale the current graph with

respect to the selected sets bounding box

Zoom X

Select a Zoom line used to scale the X axis of the current graph

Zoom Y

Select a Zoom line used to scale the Y axis of the current graph

Auto X

Autoscale the X axis only

Auto Y

Autoscale the Y axis only

Push n zoom

Save the current graphs axes scales and tickmark settings and prepare for a zoom This

function can be used to zoom in on an area of interest then restore the previous graph scale

Push

Save the current graphs axes scales and tickmark settings for later retrieval Use Pop to restore

Pop

Restore the current graphs axes scale saved from the most recent use of Push

Cycle

Cycle allows the contents of the current graphs world stack to be displayed in stack order The

contents of the stack are unaected


Stack depth

Report on the current depth of the stack Each graph has its own stack

Current world

When cyling through the current graphs worl stack display the position in the stack

Exit

Exit xmgr

Locator bar The Locator bar found directly under the main menu bar displays the current graph and

the position of the pointer To set properties of the locator display text see ViewLocator props

Status bar The Status bar at the bottom of the display reports on items of interest and provides a

line of help when the mouse is used in any operation

File

Read data from disk or pipes read variables from netCDF or HDF les read and write plot parameters

read block data write one or more xmgr datasets set the current working directory set the printer

options print hardcopy and exit

Open

Open an existing binary or ascii xmgr le abandoning the current plot

Save

Save the current plot using the last specied name and save format

Save as

Select the name and format for saving the current plot

Describe

Add a text description to a plot This will only be saved if binary format is used

Read sets

Read one or more data sets The list item at the top of the popup displays the contents of the current

directory Select a le or directory by clicking on the item with the right mouse button The selection is

placed in the text item labeled File and checked to see if it is a directory or a le Selecting a directory

causes xmgr to change to the new directory and reload the le list with the contents of the new directory

Selecting a le does nothing until the Accept button is pressed or return is entered Before


Accepting the le the items describing the le type le source and the graph in which to read the data

need to be properly set The type of data le can be one of several formats

A column multidata set le Sets are separated by a line containing nonnumeric characters that

are neither comment lines lines with a in column nor parameter lines lines beginning with an

The sets generated from this le type are all of type XY

A multi column data le X is assumed to be in the rst column and Y Y up to Y in the

remaining columns The sets generated with this data le format are all of type XY

IHL format A column data le with the rst line an integer value with the number of points to

follow

Binary format not dened as of this writing

X Y DX format A column data le consisting of X Y and a quantity used to form an error bar

parallel to the Xaxis ie the point will be plotted with an error bar at XDX Y

X Y DY format A column data le consisting of X Y and a quantity used to form an error bar

parallel to the Yaxis ie the point will be plotted with an error bar at X YDY

X Y DX DX format A column data le consisting of X Y and the errors in X The error bar

riser is drawn from XDXY to XDXY If both DX and DX are then the error bar will

bracket the datum If DX is and DX the error bars are drawn to the right of the datum

Likewise if DX and DX the error bar is drawn to the left of the datum

There are cases for the error bars position with respect to the datum

DX and DX Error bars bracket the datum

DX and DX Error bars are drawn to the right of the datum

DX and DX Error bars are drawn to the left of the datum

DX and DX Error bars bracket the datum but reversed from case

X Y DY DY format A column data le consisting of X Y and the errors in Y The error bar

riser is drawn from X YDY to X YDY If both DY and DY are then the error bar

will bracket the datum If DY is and DY the error bars are drawn to the right of the

datum Likewise if DY and DY the error bar is drawn to the left of the datum There are

cases for the error bars position with respect to the datum

DY and DY Error bars bracket the datum

DY and DY Error bars are drawn above the datum

DY and DY Error bars are drawn below the datum

DY and DY Error bars bracket the datum but reversed from case

X Y DX DY format A column data le consisting of X Y and the errors in X and Y The error

bar risers are drawn from XDX Y to XDX Y and X YDY to X YDY


X Y Z format A column data le consisting of X Y Z Sets with this type are drawn with the Z

value in text at X Y

X Y R format A column data le consisting of X Y R Sets with this type are drawn with a circle

of radius R at X Y

X HI LO OPEN CLOSE format A column data le consisting of the high low open and close

values for an observation at X A data set of this type uses the line style line width and line color for

a normal set when the symbol is drawn

Read from sets the source of the data either a disk le or a pipe In the case of a pipe the information

provided by the le lter item is not used as the le in this case will be a command as typed at the

UNIX prompt

Read to graph selects a particular graph to serve as the repository for the incoming data The Current

graph is the graph that has the focus and can be any of the available graphs If you arent sure which

graph is current the locator item on the main panel displays the current graph number

Selecting Autoscale on read forces an autoscale of the target graph each time a set is read

Note Data are read into the next available set All data are assumed to be delimited by tabs or blanks

For the xy xydx xydy xydxdx xydydy xydxdy xyz xyr data le formats sets are separated by a line

containing nonnumeric characters that are neither comment lines lines with a in column nor

parameter lines lines beginning with an Data les can have imbedded comments by placing a in

the rst column of the comment line Plot parameters can be set by placing a in the rst column of the

line followed immediately by the parameter name and setting See the command line reference for a

description of plot parameters and other commands that may be placed in a data le using the

character Comment lines and parameter lines can occur at any place in the data le and are not used to

indicate data set separators I recommend a single on a line to use as a data set separator

Press Accept to read the data If the read was successful the graph of the data is drawn using the current

plot scaling parameters If the data lies outside the current plotting limits the new sets will not be

visible until the plotting limits are changed by autoscaling or manually through the ViewDene world

popup graphshtmlworld

Press Cancel to close the popup

Open the Status popup status to get information on the state of sets If reading the le generates more

than errors youll be prompted by an alert requesting whether or not youd like to continue These

errors generally arise when an attempt is made to read a text le xmgr relies on the interpretive

capabilities of sscanf to parse the data xmgr will read data sets until there are no more sets available

after the maximum number of sets have been used youll need to free some sets using the Kill! or Kill all!

items in the EditSet operations pullright

Read netCDF

FileRead netCDF

Select X Select Y


netCDF le

Load to set

Autoscale on read

Accept Files Update Query Done

"""""""""""""

Enter the name of the netCDF le in the text item labelled netCDF le then click on Update note

that if netcdf lename! was used on the command line this step is not needed as the lists will be loaded

automatically This will read the names of all one dimensional variables into the two scrolled lists The

leftmost list is for X and the rightmost for Y There is an additional item in the X list called INDEX Im

hoping here that no one names a variable INDEX maybe I need to change this that indicates that for X

use the index of the Y variable numbering starts from

Select on a variable from the X list to use for X and select a variable from the Y list only single selections

for now

If information about the selected variables is desired click on Query

Select a set using Load to set the default is to load to the next available set

If things look OK click on Accept to read the data and load the set Use Autoscale on read to setunset

autoscaling after a successful read

To read data from a new CDF le enter the lename or use File to scan the directory Click on Update

to freshenup the X and Y selection lists

Note Presently only sets of type XY are created

Note xmgr scans and replaces commas with blanks and the D in Fortran double precision exponential

formats with e

Read parameters

Enter the parameter le name on the line labeled File press Accept to read a saved state of

adjustable parameters legends strings etc to the graph selected by the Read to graph cycle As the

graph number is saved in the parameter le this isnt used at the present time

Read block data

Select the data source either Disk or Pipe and enter the block data le name in the text item labeled

File to read a data set in block data le format The block data le format consists of columns of data

For example the following is a block data le consisting of columns


After reading the le of block data the popup will close if no errors were found and the EditBlock data

popup will take its place Use the functions in the EditBlock data popup to create sets from the block

data

NOTE All items are assumed delimited by spaces or tabs There is presently a column limit Only one

set of block data per session ie reading another set of block data will obliterate the previous set of block

data

Write sets

Write one or all sets to disk Select the set to write using the cycle displaying the set numbers there is an

item for selecting all active sets The item denoted Format is the C language format string that will be

used to format the data for output the default should work well for most cases Enter the le name on the

line labeled File and press the button marked Accept! to write the data The item Imbed parameters

causes xmgr to write not only the data but the parameters describing the graph or graphs as well

A complete dump of the contents of xmgr may be accomplished by selecting all sets imbed parameters

and all active graphs The le generated this way can then be read as a normal data le and should

recreate the originating environment

Write parameters

Select the graph from which to save the parameters This can be the current graph any particular graph

or all active graphs Enter the parameter le name on the line labeled Write parameters to press

Accept to write the current state of adjustable parameters legends strings etc A prompt will appear if

the action would overwrite an existing le allowing the operation to be cancelled

Clear all

Kill all sets graphs and annotative text lines and boxes After performing this action it will be

necessary to activate a graph using ViewGraphsActivate graphs

Print

Generate a hardcopy of the current plot on the device specied in the FilePrinter setup popup

Printer setup

Set the hardcopy device parameters Select the device where to print either the printer or a le and the

string to use as a spooling command for the print job or le name if output is directed to disk Click on

the Accept button to make the selections above current or Done to close the popup and cancel the

operation If the selection is accepted the next time FilePrint is selected hardcopy output will be to the

selected device Click on the Print button to accept the settings and print a hardcopy


Exit

Click on the Exit button to terminate the session with xmgr

Data operations

Access the command line interpreter describe the status of data sets graphs and regions display results of

computations and other operations perform transformations set operations point operations region

operations block data management

Status

When the selection for Display is Regions no operations are provided at the present time

Results

Display the results of the regression routine and the output of the Write button in File Status in the

monitor window

Commands

Command driven version of the interface to xmgr Here commands are typed at the Command text item

and executed when return is entered The command will be parsed and executed and if no errors are

found the command line is placed in the history list Items in the history list can be recalled by simply

clicking on them with the left mouse button Save a history list by clicking on the Save button popping

up the Save commands popup Clicking on Read will open the Read commands popup and allows

previously stored commands to be loaded into the history list for future access Clear empties the history

list Replay cycles through each item in the history list and executes each instruction in the list See the

command line reference for a description of the command line syntax

Transformations

NOTE Some of these operations generate new sets if you run out of sets use DataSet operations

described below to kill unneeded sets Also the scaling of the world coordinate system may be

inappropriate for the results of many of these operations Use the Status popup to determine the

appropriate scaling factors to use in Dene world above or use Autoscale in ViewAutoscale

above Most functions operate on active sets only

Evaluate expressions Evaluates a formula dened in inx fashion

Select the set on which the formula will operate set must be active use FileStatus to nd the current

state of sets If you desire the result be loaded to a new set rather than overwriting the set used for

computations use the panel cycle denoted Result to to inform xmgr youd like the result placed in a new


set if there is one A new set is created only if a single set is selected from step If All sets are selected

then the results will overwrite all active sets

Enter the formula the syntax is

xyabcdexpression

where xyabcd are dened as the x and y of the currently selected set and abcd are scratch arrays

that can be used to perform operations between sets Case is ignored so XCOSX is correct

Click on Accept when you are satised with everything

Variables

a reference to scratch array

b reference to scratch array

c reference to scratch array

d reference to scratch array

Functions

absx absolute value

acosx arccosine

acoshx hyperbolic arccosine

asinx arcsine

asinhx hyperbolic arcsine

atanx arctangent

atanhx hyperbolic arctangent

atanyx Fortran ATAN

ceilx greatest integer function

cosx cosine

coshx hyperbolic cosine

deg PI

dx span of world coordinate system in x

dy span of world coordinate system in y

erfx error function

erfcx complement of error function


expx e#x

oorx least integer function

index the index of the current point in the selected set

intx truncation

invnp inverse of standard normal p in !

invtpid inverse of Students t with id degrees of freedom

irandn random integer less than n

lgammax log of gamma function

lnx natural log should be log

logx log base should be log

maxxy returns greater of x and y

minxy returns lesser of x and y

modxy mod function also x $ y

normx gaussian density function

normpx cumulative gaussian density infx

pi constant PI

rad PI

rand pseudo random number distributed uniformly on

rnormxbars psuedo random number distributed Nxbars

sinx sine function

sinx hyperbolic sine

sqrx x#

sqrtx x#

tanx tangent function

tanhx hyperbolic tangent

x currently selected set X

y currently selected set Y


Note See parsyacc for the yacc grammer

Examples

yy

yxcosxPIsqrx

xindexxindexx

If the index of the current point is greater than then xx else xx Conditionals evaluate to if false

anything else is true

ay

Store y of the current set into scratch array a You may now select another set and perform the

operation ysomefunctionofa

Restrictions

Load values Load a sequence to xy or abcd

Load and evaluate Evaluate parametric functions

Enter the functions to be used to dene X and Y

Select the independant variable xyabcd

Enter the start stop and the number of points items

Press the button Apply to evaluate the functions and load the result to a new set

Histogram Compute a frequency histogram

Select the set

Enter the width of a bin all bin widths are the same

Enter the minimum and maximum values of the portion of the data you wish histoed sic Note that

Xmin and Xmax refer to the RANGE or Y of the set not the domain or X

Press Accept to compute the histogram

Fourier Compute the Discrete Fourier transform

Select the set

Select the type of data window the default is the rectangular window ie the data are transformed

unmodied The data windows are dened as follows

None

Use the default rectangular window


Triangular

iNN

Hanning

cospiiN!

Welch

iNN#

Hamming

cospiiN

Blackman

cospiiNcospiiN

Parzen

iNN

Select the form of the output magnitude spectrum phase or the coe%cients The spectrum is computed

by sqrtxx yy where x y are the coe%cients computed by the DFT or FFT Only N values

representing frequencies to PI are loaded to the resulting set

If the magnitude or phase is selected then the next item X determines what values should be loaded

to X The index runs from to n the frequency is the cyclical ith fourier frequency the period is the

reciprocal of the frequency with the period of the th fourier frequency plotted at Tdelt where T is the

total length of the data and delt is the sampling interval

Select transform or inverse transform

Select real or complex data

If real is selected then the data to be transformed is assumed to be in Y X is assumed equally spaced and

is ignored If complex is selected then the real part is assumed to be in X and the imaginary part in Y

Press DFT for small data sets whose length is not a power of or FFT for data sets whose length is a

power of

Click on Window only to generated a windowed version of the data in a new set

NOTE Small for the DFT is points The DFT is ON and can be quite time consuming to

compute for large N

Running averages Compute a running average median minimum maximum or standard deviation

Select the method

Select the set

Set the length of the running method in the text item marked Length it must be less than the set length

Click on Accept


Regression Perform linear or polynomial regression

Select the set

Select the degree of t

Select tted curve or residuals to load

Press the button marked Regress

A set is loaded if there is one with the resulting curve and a summary of the statistical results are written

to the Result popup

Notes

The tting techniques used by xmgr are as follows

For linear ts yaxb a straightforward least squares procedure is used For exponential and power ts

the function to t is linearized it is important to note that the statistics generated refer to the parameters

of the linearized function and not the original function

Nonlinear curve tting

Select the set you would like to approximate

The unknown parameters to t are labelled A to A case insensitive Type in the function using

the parameters starting with A

Enter the number of parameters

Adjust the tolerance

Choose initial values default and specify bounds if required for the parameters

Specify what you would like to view

Fitted values

Value of approximating function at abscissa of selected set

Residuals

Error in approximating function at abscissca of selected set

Function

Approximating function at abscissa dened by Start Stop and of points

Run the tting routine by specifying the number of convergence steps you wish to perform

Load the values to a new set if autoload not selected

Look at the results and repeat any of the above steps until satised Results will continue to be

loaded to the same newly created set

Press Accept to make the new set permanent or Cancel to destroy it


Dierences Numerical dierentiation

Select the set

Select the method one of forward backward or centered dierence Assumes unevenly spaced data

increasing in X

Click on Accept

A set is loaded if there is one with the resulting curve

Seasonal dierences Dierence a set by a given lag

Select the set

Enter the value for the lag Assumptions are evenly spaced data increasing in X

Press the button marked Accept

Use Pick to use the mouse to select the set by clicking near a point in the set as displayed in the drawing

area


Integration Numerical integration

Select the set

Select the form of the results the item marked cumulative sum will construct a set composed of the

current value of the integral at a given X Sum only reports just the value on the next line Assumes

unevenly spaced data increasing in X

Press the button marked Integrate

A set is loaded if there is one with the resulting curve if cumulative sum is chosen

Xcorr Crossautocorrelation

Select both sets use the same set if autocorrelation is desired

Select the lag N is a reasonable value your mileage may vary

Select bias generally this will not make any dierence for large data sets with lags the length of the

set I was just curious The dierence is division by N biased or Nlag unbiased A set is loaded if

there is one with the resulting curve

Interpolation Create a new set by performing interpolation on one set at abscissas from another set

All sets are in the current graph This will allow pointwise mathematical operations to be performed

between the new set and the set providing the abscissas using the command interpreter

datahtmlcommands

Choose the set on which to interpolate which will provide the Y values Select a second set which will

provide the X values for the new set


The interpolation method can be a cubic or Akima spline or linear

Spline Compute a spline t to a set

Select the set

Select the starting value of X for the tted curve

Select the ending value of X

Select the number of samples The spline curve will be evaluated at XiMaxX MinXNsteps for each i

in Nsteps

Select the type of the spline It could be either plain cubic one or Akima spline The latter should be

prefered when approximating su%ciently nonsmooth series

Press Spline


Notes The code to compute the spline is a literal translation of the code in FMM

Sample Sample a set pointwise or by a logical expression

Select the set

Select the type of sample either Startstep or Logical expression If Startstep is selected then enter the

starting index to begin the sample

Select the number of points to skip between samples in Step If Logical expression is selected enter the

expression in the text item denoted Expr Values of the expression not equal to zero are interpreted as

TRUE and the point is accepted Any expression evaluating to zero will result in the point being ignored

Digital lter Apply a digital lter to a set

Select the set to be ltered

Select the set with the lter weights

Linear convolution Perform convolution of sets

Geometric transformations Apply rotations scaling and translations to a set

Select the order in which to apply the transformations

Press the button Apply to perform the transformation

Press the Reset to reset values and return to the identity transformation

Press the Reset to reset values and return to the identity transformation

Restrictions Only the set X and Y are transformed additional vectors attached to a set such as error

bars are not transformed


Point operations

Operations in Point operations use the pointer to query sets about points delete points in a set and

move points In all cases where interaction is required pressing the right mouse button with the pointer in

the drawing area cancels the operation

Find points Report on a point in a set

Click on Find points

Position the pointer close to the data point to identify

Press the left mouse button

The set the location in the set and X Y for the datum nearest to the pointer will be displayed in a

popup Press the right mouse button to shut o the Find point feature

Tracker Track points in a set

Visit each point of a set in a sequential manner Click nearest the set to track and use the left mouse

button to go forward through the set and the middle mouse button to go backwards through the set The

right mouse button exits tracking

Delete points Press Delete point with the left mouse button to activate

Position the pointer close to the data point to delete


Add points Add points to a set Select the set and press Add points to append points to the selected

set by clicking on the location where the point is desired This can be used to crudely digitize data from

pages pasted on the screen

Move points Press Move with the left mouse button to activate

Position the pointer close to the data point to move


Move the pointer to the new location and press the left mouse button again to register the points new

location

Move X only Click on Move X only to activate




location


Move Y only Click on Move Y only to activate




location

Distance dydx angle Click on Distance dydx angle to activate

Position the pointer close to the starting point Press the left mouse button Click again at another point

to form a straight line The results are the distance slope and the angle from horizontal

Goto Enter the X Y of the point to go to and press Goto point to have the pointer warp to that

position on the drawing area

Set operations

Set operations allow sets to be created destroyed written to disk sorted

Pick ops Pick ops use the point in a set nearest to the location of the pointer when clicked to select the

set for the chosen operation The nearest point is determined by the Euclidian distance which can be very

dierent from the point that is visually closer As long as there are sets with points the operation will

always be performed which means that a bit of care should be exercised using these operations

Kill nearest set

Kill the set nearest the pointer

Copy nearest set

Select a set to copy with one click and the destination which may be in another graph with another

click

Move nearest set

Select a set to move with one click and the destination which may be in another graph with

another click

Reverse nearest set

Select a set to reverse by clicking near a point in a set The result is that the order of the points is

reversed point N becomes point and point becomes point number N etc

Deactivate nearest set

Select a set to deactivate by clicking near a point in a set The result is that the set will act as if

undened for most operations and will not be drawn even if the line or symbol selections would

cause it to be drawn The data are not destroyed and the set can be reactivated using the functions

in FileStatus or DataSet ops


Join nearest sets

Click near a point in one set to use for the join then click again near a point in another set to select

the second set The second set will be appended to the end of the rst set

Delete range in nearest set

Click near a point in one set to use for the start of the range to delete then again near the point at

the end of the range to delete The result is that all points between the selected points will be

removed from the set including the points selected

Cancel operation

Cancel any operation in progress

The remaining items in the Set ops toolbox allow sets to be created destroyed written to disk moved

sorted deactivated reactivated

Activate Make a set active and able to participate in operations

To activate a set select the set number specify the number of points in the set and click on Accept

Deactivate Make a set inactive and unable to participate in operations The data associated with a

deactivated set are still available and all plot parameters associated with the set are unchanged Use the

Reactivate set item below to make the set known to xmgr again This item is include for those situations

where a set is to be ignored temporarily but needed later in the session

Select the set to Deactivate


Reactivate Undo the eect of Deactivate

Select the set to Reactivate it is a noop to Reactivate an unused set


Set length Set the length of a set

Select the set

Fill in the item marked Length


Change Set type Set the type of a set

Select the set

Select the type to set



Copy Copy one set to another in a possibly dierent graph

Select the set to copy from

Select the set to copy to

Select the graph to receive the copy


Move Move one set to another in a possibly dierent graph

Select the set to move from

Select the set to move to

Select the graph to receive the set


Swap Exchange one set with another

Select the sets and the graphs these sets reside

Click on Accept

The contents of the sets plus all parameters associated with the display of the sets are exchanged

Drop points Drop points from a set

Select the set

Fill in the items Start drop and End drop


NOTE Points in a set are numbered from to N where N is the number of points in the set as opposed

to sets which are numbered from

Join Merge sets together

Select the set that will be appended

Select the set accepting the previous set

Press the button marked Accept to append the rst set to the second

Split Divide a set into other sets

Select the set to split

Enter the length of the resulting sets say N

Press the button marked Accept to divide the selected set into length of selected set N sets with the

remainder to the last set


The rst set will be the set selected to split and will contain the rst N points

Kill Eliminate a set

Select the set to kill or All to kill every active set

To save the parameter settings toggle Preserve parameters

Press the button Accept

NOTE This operation is nal

Kill all Kill all active sets

This is an action item youll be asked if it is OK to kill all active sets

Sort sort x or y of a set

Select set to sort

Select which component x or y as a key

Select the order of the sort

Press the button marked Accept to sort the set in place

Write sets Write a sets to disk

Select the set to write or All for all sets

Fill in the format to use to write syntax is C default is $lf $lf

Fill in the item marked Write to le with the lename to write


Note A complete dump of xmgr may be accomplished by selecting All sets All active graphs and toggling

Imbed parameters The generated le may be read as a normal data le and will contain the necessary

information to completly reconstruct all graphs in the current session

Reverse order Exchange points in a set

Select set to reverse

Press the button marked Accept to reverse the order of a set

Coalesce sets Merge active sets to an inactive set

Select set to receive points from all active sets This selected set should not be an active set

Press the button marked Accept to merge all sets to the selected set


Pack sets Move sets so that the set structure in the current graph has no gaps

During the course of several operations on sets gaps can form in the set structure This can result cause

problems when doing a Save all as the actual location ie set number of the set is not retained in the

Save le For example after several operations that create and delete sets the active sets are numbered

Following a Pack the active sets will be numbered

Press the button marked Accept to pack all sets in the current graph

EditCreate set operations

EditCreate set operations allow sets to be created using a formula or text editor or edited in a

spreadsheetlike fashion

Edit Edit is used to alter an existing set by invoking a spreadsheetlike editor Values are updated by

pressing return or when leaving a cell Several buttons appear on the widget

Add

Add a point to a set by copying the currently edited cell and appending it directly afterwards

Delete

Delete the current point

Props

Change the format precision and column widths of the table

Update

Refresh the display This is useful if the set type changes or the number of points changes

Formula See Load evaluate transhtmlleval

Manual Create a new set by invoking a text editor

Region operations

Dene region Dene a region of interest on a graph or graphs

Select the region there are

Select the type of region


Inside polygon

Points inside a closed nonintersecting polygon are considered inside the region

Outside polygon

Points outside a closed nonintersecting polygon are considered inside the region

Above below to the left and to the right

Regions dening a halfplane points inside the halfplane are considered in the region

Select the type of linkage either a particular graph or all graphs the default is the current graph

Press Accept to make the pointer ready for the region denition In the polygonal region type dene the

region by successive clicks with the left mouse button use the right mouse button to register the polygon

In the line case dene the line by clicking on the beginning point and end point of the line

Evaluate in region Evaluate an expression applied to points within a region

Select the region to use

Enter the expression regions are referred to by Rnx or Rny where n is the number of the region to use

Functions available are the same as those in Evaulate expressions described above

Examples

RX RX

Clear region Remove a dened region

Select the region to remove and press Apply

Extract points Extract points from a region to a set


Select the set to receive the points

Select the graph to put the set

Click on Accept to combine all points within the specied region to the specied set and graph

Delete points Delete points in a region


Click on Accept to delete all points in all sets within the specied region

Areaperimeter Compute the area and perimeter of a region This item doesnt belong here as it does

not use the region structures Click on Area or Perimeter and use the mouse to dene the region The

area or perimeter will be displayed in the text items Area or Perimeter whichever the case may

be Use the right mouse button to close the region


Graph operations

Activate Make a graph eligible for receiving the graph focus and other operations Select the graph to

activate and press Accept

Copy Copy a graph to another graph

Select the graph to copy from and the graph to copy to and press Accept

Note Copying a graph will automatically conceal one of the graphs as they will both have the same

viewport settings Some adjustments in the viewport settings of either or both graphs will be required for

each graph to be displayed in a nonoverlapping manner

Swap Exchange two graphs

Select the rst graph then the second and press Accept to exchange the contents of the two graphs This

can be used to adjust the order in which graphs are drawn as graphs are drawn in numerical order starting

with graph

Kill Make a graph inactive and free all storage associated with sets Select the graph to kill and press

Accept

Focus Set the graph focus the focus policy and toggle the display of focus markers Select the graph to

have the focus the focus policy and the toggle for the focus markers and press Accept

Note Most operations in xmgr act on the current graph Not noticing which graph has the current focus

can be a source of frustration when working with xmgr if you plan to work extensively with a particular

graph it might be useful to set the focus policy to Set to x xmgrs notion of the current graph

Show Toggle the display of a one or more graphs

Select which graph or graphs to show then press Accept The default is to show all active graphs

This item can relieve some of the drudgery when working with multiple graphs especially when some of

the graphs contain large data sets

Set graph type Set the current graph type to XY loglinear linearlog loglog bar or stacked bar

Select the graph type and press Accept

Note As of this writing very little is done to ensure that the data are acceptable for log plots

Arrange graphs Place several graphs in a nonoverlapping manner

Select the number of rows and the number of columns the packing method the vertical and horizontal

spacing between graphs in viewport coordinates the start of the rst graph in viewport coordinates and

how wide and how tall each graph should be Graphs are laid out in column major order starting from the

lower left So given columns and rows the graphs will be laid out as follows


Given colums and rows

Note that graphs are numbered from

The packing selection packs the graphs vertically horizontally or both Use this item when there are

several graphs with the same X or Y axis scaling so graphs on the outside of the packing arrangement

provide the tick and axis labelling for all graphs in that row or column In the x example aboveselecting

packing both graphs will have Xaxis tick labels and graphs will have Yaxis tick labels Graphs

will have neither X or Y axis tick labels while graph will have both

Note that the graph width is computed using the number of columns horizontal gap X starting location

and packing whenever the number of columns is selected Likewise the graph height is recomputed using

the number of rows packing vertical gap and starting Y value whenever the number of rows is selected

New values for the rows and columns need not be chosen for the computation to occur

If the number of graphs chosen is decreased the higher number graphs will still be displayed They must

be killed kill or not shown show to be removed

Overlay Overlay one graph onto another This can be used to plot sets of dierent scale in what will

appear to be the same graph

Invertip axes Reverse the direction of the X or Y axes or exchange the X and Y axes

Image Read and place an X window dump le on the drawing area At the present time only one

image per session is allowed

Block data

Create sets from block data Select the type of set and the columns to use for each vector of the new set

Press Accept to create the set Note that reading block data does not aect the scaling of the graph so

when a set is created using this popup the set may not appear within the graphs scaling limits use AS

Autoscale to set the scale of the graph if needed or use ViewDene world


Hot links

To be written

Plot functions

The selections in the Plot pulldown menu allow the modication of plot parameters There are popups for

setting the scaling of the axes the number of tick marks to display legends writing annotative text and

drawing objects such as lines and boxes

xmgr uses coordinate systems in drawing a graph These are the world viewport and device coordinate

systems following Foley and Van Dam The world coordinates system is the one in which the data are

dened and constitutes the users coordinate system The viewport coordinate system in xmgr is a

rectangle dened by the points or the lower left corner of the device and or the upper

right corner of the device The pipeline for drawing objects on the screen or hardcopy device is a pair of

linear transformations that carry points in world coordinates to the viewport and then on to the device

coordinate system The upshot is that an object located in world coordinates can be drawn in various

parts of the screen or hardcopy device depending on the scaling while an object located in viewport

coordinates remains in the same spot regardless of the world scaling Strings lines boxes and the graph

legend can be located in either world or viewport coordinates

World scaling

Dene the world coordinate system by lling in the items Xmin Xmax Ymin and Ymax The plot is

drawn in world coordinates in a rectangle described by the two points Xmin Ymin Xmax Ymax The

input is scanned for arithmetic expressions so setting Xmin PI and Xmax PI is legal input see the

section on transformations for a description of the syntax and available functions The tick spacing can

also be set in this popup by lling in the items for the major and minor spacing for each axis Update

worldticks is used when occasionally the state of the items used to dene the world scaling get out of

sync with what is actually used to draw the graph clicking on this item synchronizes the internal values

with the displayed values Press the button marked Accept to inform xmgr of the changes

Note make sure Xmin Xmax and Ymin Ymax

Viewport

Dene the viewport by lling in the items Xmin Xmax Ymin Ymax Viewport coordinates run from

the lower left corner of the screen or hardcopy device to the upper right corner of the

screen or hardcopy device Press the button marked Accept to make the change to the new viewport

Press the Pick view button to use the mouse to dene the viewport Take the mouse to the lower left

corner of the desired viewport and press the left button there is no need to hold the button down A

rubberband box will show you the current size of the viewport you may select When you are satised with

the view press the left mouse button again to activate the new viewport

Press the button marked Close to close the Viewport popup


The viewport can also be changed by double clicking on the focus markers or where they would be placed

if not shown The new location is chosen by clicking the rst mouse button

Autoscale

Use the Autoscale popup to set parameters associated with autoscaling Select the axis to scale or none

Selecting none allows the autoscale type and the number of ticks to create to be set but no autoscaling is

done Select the particular set to use or All The Autoscale type sets the method of autoscaling either

Heckbert or xed Heckbert uses a method based on routines posted to the net by Paul Heckbert and

generates nice looking tick spacing but alters the scaling of the axes The xed option uses the minimum

and maximum values in the set or over all sets to set the scale of the axes Select the number of tick

marks to use for dening the tickmark spacing in the case of Heckbert scaling these settings are advisory

only The item labeled Apply to allows the autoscaling of the current graph or all active graphs

Titlesubtitle

The title and subtitle are strings that appear centered at the top of the plot Fill in the items indicated

and press the button marked Accept To change the font color or character size used for titles use the

items from the popup denoted Props

Tickstick labels

Set the spacing and type of major and minor tick marks denition of axes labels and toggle features

associated with the drawing of the graph axes

The top item Edit selects the axis for which the feature selections will apply There are two axes dened

for each coordinate direction the primary axis and the zero axis The primary axis will be used the most

the zero axis is by default turned o The button to the right of the Edit item labelled Props

allows

the axis to be oset by a specied amount in viewport coordinates The item Axis label accepts the

denition of the label to be used when drawing the axis Various properties of the label may be set in the

popup just below labeled Axis label props

The two items Major tick spacing and Minor tick spacing set the spacing of major and minor ticks Tick

labels are drawn based on the setting for the major tick spacing These items are duplicated in the Dene

world popup described previously Fill in the appropriate blanks and press Accept to refresh the display

The units are positive deltas starting with the world minimums Input is run through the scanner so

expressions are allowed The are special symbols dx and dy for setting a prescribed number of tick marks

Dx is the distance along the Xaxis and dy is the distance along the Yaxis as dened in the current

window of the world coordinate system Typing at Major tick spacing dx will give major

tickmarks

Tick labels tick marks the axis bar may be toggled by the check boxes Properties for each of these can

be set by the Props

popups associated with each item

Properties for tick labels are


Font

Which font to use when drawing the labels

Color

Which color to use

Line width

Width of line to use when drawing the label

Char size

Size of characters to use

Format

Decimal exponential power general plus several time and date formats To use the time and date

formats the data are required to be in Julian Date format the long version Two auxillary programs

julgreg and gregjul are available with the distribution to assist in the conversion from Julian to

Gregorian date formats

Stagger

each tick label may be oset with respect to its neighbor the levels of staggering ranging from to

This is especially useful with some of the time and date formats

Precision

sets the number of places to display to the right of the decimal point for the labels

Skip every

tick labels are drawn at every major tick mark use the skip factor to circumvent this

Start labels at

Graph minimum or specied To start the labels at some other point than the graph minimum ll

in the text item to the immediate right with the value where tick labels are to begin There is a

similar item in the property sheet for tick marks that can be used to set where the major tick marks

begin between these two there should be su%cient exibility

Stop labels at

same as above only works at the other end of the axis

Layout

allows the tick labels to be drawn horizontally vertically or a specied angle in degrees

Draw tick labels

which side of the graph to draw tick labels either the normal side the bottom of the graph in the

case of the Xaxis or to the left of the graph in the case of the Yaxis The opposite side or both

This can be handy when using multiple axes or overlaying graphs with diering scales


Sign

allows the numerical value of the label to be displayed as is as its absolute value or negated This

can be used to eectively reverse the sense of the axis negate or reect the axis about zero

absolute value

Apply to

Override the selected axis from the Tickstick label popup causing the settings to be selected for all

axes in the current graph the current axis for all graphs or all axes in all graphs

Press the button Accept when everything is OK or Close to close the popup

Properties for tick marks are

Tick mark direction

in out or both Which direction the ticks point

Tick marks on

Which side of the graph to draw ticks The normal side is the bottom of the graph in the case of the

Xaxis or to the left of the graph in the case of the Yaxis the default is to draw ticks on both sides

Major tick length

sets the length of major tick marks

Minor tick length

sets the length of minor tick marks

Major grid lines

a check box that when toggled on grid lines will be drawn at the settings for major tick marks

Minor grid lines

a check box that when toggled on grid lines will be drawn at the settings for minor tick marks

Color line width and line style

These items set the characteristics of the lines use to draw ticks and grid lines

Apply to

allows the axis select in the Tickstick label popup to be overidden causing the settings to be

selected for all axes in the current graph the current axis for all graphs or all axes in all graphs

Press the button Accept when everything is OK or Cancel to close the popup

Properties for the axis bar are

Color line width and line style items set the characteristics of the lines use to draw ticks and grid

lines


Press the button Accept when everything is OK or Cancel to close the popup

IMPORTANT NOTE FOR LOG PLOTS When log scaling is selected for a particular axis or axes

the meaning of major and minor ticks changes slightly Major ticks should be set to integer values Use

minor ticks to set the number of interdecade tickmarks these should be set to integer values ranging from

no interdecade tickmarks to A value of will draw each interdecade position will skip every other

position etc

Frame

The frame is the box drawn around the clipping region of the graph and the region inside Items in the

frame popup are

Frame

Turn the frame on or o

Style

Either closed or open

Color

Set the color of the line drawn around the graph

Line width

Set the width of the line around the graph

Line style

Set the line style of the line

Fill graph background

Toggle the lling of the frame

Background color

The color with whi

xmgr.pdf

Documents