Installation of FASTMAP

Step 1 - Environment variables and extracting the files

This installation description covers the version of FASTMAP installed into vnmr and does not cover installation into vnmrj, or tcl/tk scripts. Installation into vnmrj is work-in-progress. For these installation steps you need to be logged in as vnmr1.

The first decision is to decide on where to install FASTMAP. Typically this directory is associated with the global vnmr directory or in a secure place that is not dependent on an upgrade of vnmr, and it contains the execution code and all necessary files. It is necessary that an environment variable FASTMAP is created that points to this directory (Be sure to check that this is included in all users .login or equivalent file. For example, after setting the vnmrsystem and vnmruser environment variables the line
setenv FASTMAP $vnmrsystem/fastmap can be inserted).
The essential fastmap files are stored in $FASTMAP, which is defined by the environment variable FASTMAP, which must be set in .login or alike files. (If FASTMAP is not installed to $vnmrsystem/fastmap, a symbolic link named $vnmrsystem/fastmap that points to $FASTMAP must be created, e.g., ln -s $FASTMAP $vnmrsystem/fastmap. 

The vnmrmenu file pointed to by the $vnmrmenu environment variable needs to be modified, as follows
"if -f $vnmrsystem/glide/vnmrmenu then
  setenv vnmrmenu $vnmrsystem/glide/vnmrmenu
endif"
The file pointed to by $vnmrmenu should contain the line
Function usermacro1 FASTMAP
if you would like to have the FASTMAP button on the top line of vnmr. In that case you need to create in $vnmrsystem/maclib the symbolic link usermacro1 that points to $vnmrsystem/maclib/fastmap after the installation of the files (yourprompt>ln -s fastmap usermacro1<cr>).

Now it is recommended that you logout and login again (as vnmr1) to verify that the environment variables are set properly ($FASTMAP and $vnmrmenu).
After changing the directory to  $FASTMAP copy the tarfile (typically named fastmap_<your institution>.tar) into $FASTMAP (e.g. yourprompt>cp -p <somewhere on your directory>/fastmap.tar $FASTMAP<cr>) and the untar (yourprompt>tar xvf fastmap.tar .<cr>) and the fastmap.tar file should unfold into $FASTMAP with the following sub directories:

install/ - directory containing the tar files for each of the following sub directories 
               (help.tar, menulib.tar, maclib.tar, parlib.tar, psglib.tar, shapelib.tar, src.tar, tablib.tar - each tarfile containg a
               corresponding .readme file with a brief description of the files)
The following directories are also unfolded, but at this point they are empty:
$FASTMAP/help/    $FASTMAP/maclib/  $FASTMAP/menulib/     $FASTMAP/parlib/   
$FASTMAP/psglib/   $FASTMAP/code/   $FASTMAP/obj/    $FASTMAP/src/    $FASTMAP/src/calib

In $FASTMAP you will find a file named fastmap.readme - which is equivalent to the instructions provided on this page. Provided are also a number of shell scripts that can be used to manage private FASTMAP installations, e.g . yourprompt>checkversion anydirectory <cr> does check for files installed in individual user directories (indicated by the input 'anydirectory') and if they are different from the files in $FASTMAP.

Next step is to execute the shell script  fastmap.untar, e.g. yourprompt>fastmap.untar<cr>, which untars the individual tar files in $FASTMAP/install and puts the extracted files into the corresponding directory, such as the files in help.tar into $FASTMAP/help etc. (At the end of the shell script fastmap.untar the following instructions are provided)

To complete the installation, you need to finally run the shell script fastmap.upload (yourprompt>source fastmap.upload<cr>). It will copy the content of the individual directories into the corresponding directories in $vnmrsystem and it compiles the pulse sequence, copies the pulse sequence to $vnmrsystem/seqlib and compiles the c source code.(gcc). Compilation of the pulse sequence should complete without error messages and the compilation of the source code should result in non-fatal error output (check to see that $FASTMAP/code contains the two files calshim and shuffle with an up-to-date time stamp.).

For further instructions, see the output of fastmap.upload or click here.