#!/bin/sh # This is a shell archive, meaning: # 1. Remove everything above the #!/bin/sh line. # 2. Save the resulting text in a file. # 3. Execute the file with /bin/sh (not csh) to create the files: # MAPA # MAPI # README # makefile # This archive created: Wed Jan 4 11:20:01 1989 export PATH; PATH=/bin:$PATH if test ! -d 'MAPA' then mkdir 'MAPA' fi cd 'MAPA' if test -f 'README' then echo shar: over-writing existing file "'README'" fi cat << \SHAR_EOF > 'README' This subdirectory contains the source code for MAPA, the graphics part of the MAP package. The code is written in C, using Sunview, and will run on monochrome and color monitors. It has only been tested on Sun 3's running SunOS 3.4. If you have problems with different versions of Suns and/or SunOS's, please let us know. MAPA displays the memory access patterns on the arrays in FORTRAN programs that were instrumentated using MAPI. It maps the arrays to the graphics screen and elements of the arrays flash when they are accessed. To invoke the program, type "mapa". The graphics window will take up most of the screen. It initially looks for trace files named memory., where distingushes the different trace files. If it does not find any, it prints an informational message to that effect. You can right click the mouse on "Directory:" to change directory ("Enter new directory" not yet implemented). If it does find memory files, you can right click the mouse on "Memory file:" to see a listing of the memory files and select one of your choice. Left click the mouse on "Load" to open the selected file and left click the mouse on "Go" to begin execution. Left click the mouse on "stop" to suspend exection. You can then continue execution by left clicking the mouse on "Go" again, or you can select another file. Map can display up to four different arrays. The top row displays the read accesses to the arrays and the bottom displays the writes. The read accesses flash in green and the write acceses flash in red. The Update Speed slider controls how fast the memory flashes fade. The Execution Speed slider control how fast the program executes. Memory file format: Matrix definition: 0 Read access: 1