>>>>> courtesy of the Colorado School of Mines Center for Wave Phenomena and iTeam
>>>>> updated 24 April 2025, Nick Dorogy, Apple Silicon (Sequoia 15.2)

-----------------------------------------------------------------------
>>>>> install "Command line tools"

download & install XCode
xcode-select --install

-----------------------------------------------------------------------
>>>>> install GlobalProtect from Mines

https://helpcenter.mines.edu/TDClient/1946/Portal/KB/ArticleDet?ID=133494

-----------------------------------------------------------------------
>>>>> generate SSH keys
ssh-keygen -t rsa

>>>>> append the local public key ~/.ssh/if_rsa.pub
>>>>> to gauss and newton in ~/.ssh/authorized_keys

>>>>> edit the local ~/.ssh/config and add
Host *
      Protocol 2
      ForwardX11      yes
      ForwardX11Trusted yes
      XauthLocation /opt/X11/bin/xauth
      ForwardAgent    yes
      ForwardX11Timeout 596h
      Compression yes

-----------------------------------------------------------------------
>>>>> make directories
cd ~
mkdir SCRATCH
mkdir WORK

cd ~/WORK
mkdir rsffigs

-----------------------------------------------------------------------
>>>>> install Matlab - get @ Mines

For command line execution on a mac with M2 processor:
- in /Applications/MATLAB_R2023b.app/bin
ln -s maci64 maca64

- in /Applications/MATLAB_R2023b.app/Contents/MacOS
ln -s ../../bin/maci64/MATLAB MATLAB_maca64

-----------------------------------------------------------------------
>>>>> install X11
http://xquartz.macosforge.orgx 

in Preferences/Security - select "Allow connections from network clients"

-----------------------------------------------------------------------
>>>>> Install Anaconda

>>> download the graphical installer from
http://anaconda.com/download/#macos

export PATH=$WORK/anaconda3/bin:$PATH

>>> install jupyter extensions
conda install nodejs
conda install numpy
conda install numba

conda config --add channels conda-forge
conda install jupyter_contrib_nbextensions

DID NOT WORK!!!
# conda install conda-forge::rise
# jupyter labextension install @ijmbarr/jupyterlab_spellchecker

-----------------------------------------------------------------------
>>>>> install MacTeX
http://www.tug.org/mactex/mactex-download.html

>>> install Tex Live Utility - WHY?
ttps://github.com/amaxwell/tlutility/releases

-----------------------------------------------------------------------
>>>>> download repositories

cd ~/WORK
git clone https://github.com/ahay/src rsf
git clone https://github.com/SEGTeX/texmf texmf
git clone https://github.com/Center-for-Wave-Phenomena/iTeam.git

cd ~
ln -s $WORK/rsf .
ln -s $WORK/texmf .
ln -s $WORK/iTeam .

cd ~
sudo texhash

cd ~ 
cd Library 
Ln -s ../texmf 

-----------------------------------------------------------------------
>>>>> install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

>>> install clang:
brew install llvm libomp
(brew reinstall llvm libomp)

export LLVMDIR=/opt/homebrew/opt/llvm
export LIBOMPDIR=/opt/homebrew/opt/libomp

brew install subversion
brew install fig2dev gifsicle
brew install ffmpeg

>>> add to .zshrc
export PATH=/opt/homebrew/bin:$PATH
export PATH=${LLVMDIR}/bin:$PATH

export LDFLAGS="-L${LLVMDIR}/lib"
LDFLAGS+=" -L/opt/homebrew/opt/libomp/lib"

export CPPFLAGS="-I${LLVMDIR}/include"
CPPFLAGS+=" -I/opt/homebrew/opt/libomp/include"

export LDFLAGS="-L${LLVMDIR}/lib/c++ -Wl,-rpath,${LLVMDIR}/lib/c++":$LDFLAGS

-----------------------------------------------------------------------
>>>>> install macports from http://www.macports.org

sudo port selfupdate
sudo port install xfig

-----------------------------------------------------------------------
>>>>> configure and install PCRE
from http://www.pcre.org

./configure CC=`which clang`
make; sudo make install

-----------------------------------------------------------------------
>>>>> install FFTW
from www.fftw.org/download.html

export FFTDIR=/opt/fftw/fftw-3.3.10

./configure --enable-float \
            --enable-openmp --enable-threads \
            --enable-shared \
            CC=`which clang` \
            -prefix=${FFTDIR}
make; sudo make install

-----------------------------------------------------------------------
>>>>> add environment variables to .zshrc

export GDDIR=/opt/homebrew/opt/gd

export WORK=~/WORK

export RSF=$WORK/rsf
export RSFSRC=$RSF
export RSFROOT=$RSF
export RSFFIGS=$WORK/rsffigs
export DATAPATH=~/SCRATCH/
export TMPDATAPATH=/tmp/
export VPLOTFONTDIR=$RSFROOT/include/
export PSTEXPENOPTS='color=y force=n fat=1 fatmult=1.5 rgb=no serifs=no'
export RSFMEMSIZE=4000
export GIFBORDER=0
export GIFDELAY=10
export PPI=150

export LD_LIBRARY_PATH=$RSFROOT/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${FFTDIR}/lib

export SVN_EDITOR=vi
export OMP_NUM_THREADS=8

# ---------- PATH ----------
export iTeam=$HOME/iTeam/
export COLIB=~iTeam/colib

export PATH=$RSFROOT/bin:$PATH
export PATH=$WORK/anaconda3/bin:$PATH
export PATH=$PATH:/usr/local/bin
export PATH=$PATH:/opt/local/bin

# ---------- PYTHON -----------
if [ -n "$PYTHONPATH" ]; then
export PYTHONPATH=$RSFROOT/lib/python3.11/site-packages:${PYTHONPATH}
else
export PYTHONPATH=$RSFROOT/lib/python3.11/site-packages
fi

export PYTHONPATH=$RSFROOT/lib:$RSF/book/Recipes:$RSFSRC/user/cwp:${PYTHONPATH}
export PYTHONPATH=$COLIB/NOP:$COLIB/LOP:${PYTHONPATH}

-----------------------------------------------------------------------
>>>>> configure and install M8R. Make sure FFTDIR, LLVMDIR, LIBOMPDIR, and GDDIR are defined in .zshrc
source ~/.zshrc

cd $RSF

./configure API=c++ SFPEN='xtpen' \
            CC=`which clang`    CFLAGS="-O3 -fopenmp" \
            CXX=`which clang++` CXXFLAGS="-O3 -fopenmp" \
            LIBPATH=${FFTDIR}/lib,${LLVMDIR}/lib,${LIBOMPDIR}/lib,${GDDIR}/lib \
            CPPPATH=${FFTDIR}/include,${LLVMDIR}/include,${LIBOMPDIR}/include,${GDDIR}/include \
            LINKFLAGS="-L/opt/homebrew/opt/libomp/lib -lomp"

- had to set SWIG = '' in config.py - WHY?

scons install