SYNOPSIS

Used to manipulate parameter files

SYNTAX 

     mp    -commands     -fileoptions   file(s)

DESCRIPTION

This program is used to manipulate a single map or to combine a group of maps into a single map. The program is intended for manipulation of .pot files used in the graphics programs in which .pot files as described in cjmaps and cvrti are used. All three entries must be provided. Multiple entries are not allowed. -commands for map manipulation. Features provided for single map manipulations include:

Normalized map: -n

mp will construct a map in which all values range from 0.0 to 1.0. The output map will be stored in a file named map.nmz.

Normalized map: -o

mp will construct a map in which all values are offset by the value at the last node. The output map will be stored in a file named map.ofs.

Scaled average map: -s

mp will construct a map in which all values are scaled by the mean value in the map. Values in the scaled average map will be centered around 1.0. The output map will be stored in a file named map.scav.

First derivative map: -x -y -z

mp will construct a map in which all values contain the first spatial derivative for a rectangular arrangment of leads/nodes. With the -x option, spatial derivatives are determined as the forward difference right along rows. The output map will be stored in a file named map.dxb. With the -y option, spatial derivatives are determined as the forward difference up columns. The output map will be stored in a file named map.dyb. With the -z option, spatial derivatives are determined as the magnitude of the forward difference right along rows and up columns. The output map will be stored in a file named map.dm.

Second derivative map: -u -v -w

mp will construct a map in which all values contain the second spatial derivative for a rectangular arrangment of leads/nodes. With the -u option, spatial derivatives are determined from the differences left and right along rows. The output map will be stored in a file named map.d2x. With the -v option, spatial derivatives are determined as the differences up and down columns. The output map will be stored in a file named map.d2y. With the -w option, spatial derivatives are determined as the magnitude of the forward difference right along rows and up columns. The output map will be stored in a file named map.d2m.

NAI map: -i

mp will construct a map in which all values contain the Steinhaus NAI (nonuiformity of activation index). The output map will be stored in a file named map.nai.

Absolute value NAI map: -j

mp will construct a map in which all values contain the Steinhaus NAI (nonuiformity of activation index). NAI values are then set to their absolute values before a map is created. The output map will be stored in a file named map.anai.

gradient-based NAI map: -h

mp will construct a map in which the Steinhaus approach for the NAI (nonuiformity of activation index) is used to calculated the magnitude of the spatial gradient. The output map will be stored in a file named map.gnai.

Allesie gradient map: -p

mp will construct a map in which all values contain the Allesie gradient. The Allesie gradient is described in Lammers et al, Am. J. Physiol. 1990:1254-1263. The output map will be stored in a file named map.alg.

grmap: -t

mp will construct a special output file type for use with a VAX program to plot maps. This option is not reccomended. The output map will be stored in a file named map.grmap.

-commands for map comparison. Features provided for group map comparisons include:

Correlation coefficient: -c

mp will calculate the CCF between two maps using the CCF formula in ``An introduction to Mathematical Statistics and its Applications,'' page 394, Equation 10.3. The correlation coefficient is stored in a file named map.ccf.

Maximum/minimum value: -max -min

mp will report the maximum value in a passed map file

Difference map: -d

mp will construct a difference map with entries map1 - map2. The output map will be stored in a file named map.diff.

Average map: -a

mp will construct an average map from map1,2...N. The output map will be stored in a file named map.avg.

Range map: -r

mp will construct a range map from map1,2...N. The range is defined as the difference between the smallest and largest values within all input maps at each point. The output map will be stored in a file named map.rng.

-fileoptions for map comparison. File options support a number of file structures.

Square grids: -S n

mp will assume the leads/nodes in the input .pot file are arranged in a square with n leads/nodes on a side. This is the option used for a plaque.

Square grids: -X nx -Y ny

mp will the assume the leads/nodes in the input .pot file are arranged in a rectangle with nx leads/nodes on the column side and ny leads/nodes on a row side.

Pollard grid: -C

mp will the assume the geometry and map are the type created from a Pollard simulation.

Ascii matrix: -M

mp will the assume a rectangular geometry defined by the number of rows and columns in the input Ascii file. 

1. mp -n test.pot
Generate a normalized map from the entries in test.pot. The results are stored in map.nmz. 
2. mp -z -S 8 map.test
Generate a first derivative magintude map from the entries in test.pot. The results are stored in map.dm. The option -S 8 will inform mp that there are 64 entries in an 8 by 8 grid for the difference calculations. 
3. mp -c test1.pot test2.pot
Determine the correlation coefficient between entries in test1.pot and test2.pot. 
4. mp -a test1.pot test2.pot test3.pot
Generate an average map from the entries in test1.pot, test2.pot and test3.pot. -generate with the Makefile. -the MPxxx.c files -the mp and cj.h include files 1. The derivatives are calculated as differences. These must be scaled beore the maps can be used as gradient maps.

2. The maximum number of maps for the comparison operations is N=5.

AUTHOR 

 
  Dr. Andrew E. Pollard  
  Biomedical Engineering
  Computational Electrophysiology
  Tulane University
  New Orleans, LA 70118
  andrew.pollard@tulane.edu