Xmgr: Introduction

# Introduction

xmgr is an XY plotting tool for workstations or X-terminals using X. A few of its features are:

- User defined 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, DFT/FFT, cross/auto-correlation.
- Hardcopy support for PostScript, HP-GL, and FrameMaker .mif format.

While xmgr has a convenient point-and-click interface, most parameter settings and operations are available through a command line interface (found in Data/Commands).

## Terminology

Sets
  Sets are collections of points, with optional associated values at these points. The associated values can be used to display error bars, high-low open-close plots and several other features. Sets are connected to a graph, and, by default, there are 30 sets per graph. Each set is numbered from 0 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 1 to N where N is the total number of points in the set. Operations to manipulate sets are found in Data/Set operations, and features such as line styles, symbol types, and others can be changed from Plot/Symbols.

Graphs
  Graphs are the collection of data sets, tick marks, titles, etc. drawn to display the data. By default, there are 10 graphs with each graph owning 30 sets (both the number of graphs and the number of sets are adjustable via command line parameters). Operations on graphs are found in the Graphs/Graph 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 filled rectangles at the corners of one graph. The 10 graphs available by default in this version of xmgr are numbered from 0 to 9.

Regions
  Regions are sections of the graph defined by the interior or exterior of a polygon, or a half plane defined by a line. A region defined by a line can be above, below, to the right, or left of the line. Defining regions and operations on points inside regions are found in Data/Region operations.

Parameters
  Parameters are the settings of symbols, line styles, colors, fonts, etc. used to define 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 "Help/Comments" on-line report facility.

The home of xmgr sources and documentation is http://plasma-gate.weizmann.ac.il/Xmgr/

## Copyright

    Copyright (c) 1991-95 Paul J Turner, Portland, OR
    Copyright (c) 1996-98 ACE/gr Development Team

    Currently maintained by Evgeny Stambulchik, Rehovot, Israel

                                 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 AND OTHER CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO
    THIS SOFTWARE, INCLUDING,  BUT  NOT LIMITED  TO, ALL  IMPLIED WARRANTIES OF
    MERCHANTABILITY  AND  FITNESS. IN NO EVENT SHALL PAUL J TURNER  OR  CURRENT
    MAINTAINER  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 TORTUOUS ACTION, ARISING OUT
    OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.