ugle

General Purpose:

The program UGLE reads in a list of data (numbers) from a file and embeds the necessary spaces within the file. It then calls GNUPLOT and reads a command file created by the command line arguments, creating the desired potential map.

Format:

     ugle       Application File \
                {-Grid Shape} {Dimension} {Grid Dimensions} \
                {-Terminal Type} {-Grid View} {-Map Type} \
                {data file}

Grid Shape :

The grid shape can be either square or rectangular, represented by -s or -r respectively The user MUST enter either -s or -r. There is no default.

Dimension :

Refers to 1D ro 2D plots. Enter -1d or -2d. This argument is new and may not work well.

Grid Dimensions :

The dimensions refer to the size of the grid shape. In the case of a square grid (-S), only the number of rows needs to be entered. In the case of a rectangular grid (-R), both the number of rows and columns must be entered IN THAT ORDER.

Terminal Type :

The terminal type determines what terminal GNUPLOT should use. Possible entries are: -pbm, -ps, -x11 or -tek (pbm, postscript, x11 or tek40xx). Each choice will add commands to a command file which GNUPLOT will read. -tek is the default. NOTE: For both -pbm and -ps, output in GNUPLOT is sent to the files vm.

Grid View :

The grid view is only required when a surface plot is desired. If only a contour plot is needed, this argument should be left out. The possible entries are: -front and -side. Again, each choice will add certain commands to the command file for GNUPLot. -side is the default.

Map Type :

To produce a surface plot, the argument -car (carpet) is needed. If a contour plot is needed, the argument -con (contour) should be entered. If both types are desired, -both may be entered to produce first the surface plot and then the contour plot. -car is the default.

Data File :

The data file is where the list of data is located. In this case UGLE looks for gpltvm.dat (file created by DART).

Example

ugle -s 40 -x11 gpltvm.dat
In this example, the user is in the directory where the dart application is running. The user's grid is a square 40x40 grid.

AUTHOR

R. Jorge Fornaris, Assistant Professor
Biomedical Engineering
Computational Electrophysiology
Tulane University
New Orleans, LA 70118
bmrf@mailhost.tcs.tulane.edu