Instructions for installing/running CrunchFlow/CrunchTope on Mac OS

First thing is to make sure you have the updated CrunchTopeInstall-Mac folder (the very first version of CrunchTope was not built correctly).  Or download from the Web:

https://bitbucket.org/crunchflow/crunchtope/downloads/CrunchTope-InstallMac.tar.gz (Links to an external site.)

Unpack the gzipped tarball by following these steps:

Copy the CrunchTopeInstall-Mac.tar.gz into a directory where you know you have WRITE privilege, either Documents or Desktop.  This could be, for example:

       /Users/CISteefel/Documents  

or in your case, /Users/”YourLoginName”/Documents

To find out your “user or login name”, launch a terminal window and type (followed by enter):

      whoami

Your login or user name should be echoed.

Then change directories in the terminal window by typing (assuming you have chosen “Documents”)

          cd /Users/”YourLoginName”/Documents

Give these commands at the command line (in each case typing the text followed by “enter”):

      gunzip CrunchTopeInstall-Mac.tar.gz

      tar xvf CrunchTopeInstall-Mac.tar

This will create the CrunchTopeInstall-Mac directory.  Now change directories to the CrunchTopeInstall-Mac directory you just created:

     cd CrunchTopeInstall-Mac

Move in your Mac OS Finder to the same directory.  Double click on m_comp_lib_icc*.dmg and m_comp_lib_ifort*.dmg files.  In each case, 
this will bring up a window that looks like a package just arrived from Amazon, double click on this to actually install 
the Intel redistributable libraries.

This will install to:

/Users/”YourLoginName”/intel/redist/compilers_and_libraries_2019.1.144/mac/compiler/lib

Or in my case:

/Users/CISteefel/intel/redist/compilers_and_libraries_2019.1.144/mac/compiler/lib

OK, now you need to get the Mac OS to know where both CrunchTope and the Intel redistributable libraries are.  So go back to your 
home directory by giving the command:

      cd (followed by Enter)

This should take you to your home directory, the equivalent of /Users/CISteefel.  Here you need a two-step between the 
command terminal and your Mac OS windows.  You should be in the Home directory in the Mac Windows Finder, which you 
can get to by Selecting Finder at the top of the screen and moving over to Go and selecting Home 
(or on the keyboard with Finder open, do Shift-Command-H all at same time).  Back to the terminal windows in the 
same home directory, use the “vi” editor to create a bashrc file (better to leave “.” off here, or it will be a hidden file).  So:

       vi bashrc

It will open the bashrc file.  Now you save it by typing a colon “:”, followed by “wq” to Write the file and to then Quit the file. 

Since it is easier to use TextEdit on the Mac than “vi”, right click on the “bashrc” file and open with TextEdit (you may have 
to scroll down in the drop down window to find this app that resides on your system). Then copy and paste the following

export DYLD_LIBRARY_PATH=/Users/”YourLoginName”/intel/redist/compilers_and_libraries_2019.1.144/mac/compiler/lib

export PATH=$PATH:/Users/”YourLoginName”/”YourInstallPath”/CrunchTopeInstall-Mac

You can get “YourLoginName” from the “whoami” command.  Save the file and then give the command (in the same location):

       source bashrc

Now you should be able to find CrunchTope and the libraries.  If you open a new terminal window, you will need to do the 
“source bashrc” command again in your home directory.

Now navigate to where you put the CrunchTopeInstall-Mac directory, and “cd Exercises” and then “cd Ex1Speciation” to get 
to the right directory where the short course exercises are.  Then run the first exercise.  You do this by typing:

       CrunchTope  (followed by “enter”)

Look at the output in ShortCourse1.out (presumably opened with TextEdit).