Salish Sea Repos and Packages¶
Once you have your Mercurial Configuration set up and the Anaconda Python Distribution installed and activated you need to set up a working area, clone some Mercurial repositories, and install some Salish Sea MEOPAR project tools.
In the working environment on your Waterhole workstation you should create a work space on the /ocean/ partition:
mkdir -p /ocean/$USER/MEOPAR
On your own laptop, well, the choice of where you put files is up to you…
In the work space you need to clone a number of Salish Sea MEOPAR project repos from Bitbucket. The repos that you need depends whether the environment is for running the model, doing analysis, etc.; the Quick Start Guide provides guidance for the repos to install in model run environments. Here, we’ll assume that you are setting up your Waterhole machine working environment where you will be doing analysis, documentation, etc.
cd /ocean/$USER/MEOPAR/ git clone email@example.com:SalishSeaCast/docs.git git clone firstname.lastname@example.org:SalishSeaCast/tools.git git clone email@example.com:SalishSeaCast/NEMO-Cmd.git git clone firstname.lastname@example.org:SalishSeaCast/SalishSeaCmd.git
python3 -m pip install --user --editable tools/SalishSeaTools python3 -m pip install --user --editable NEMO-Cmd python3 -m pip install --user --editable SalishSeaCmd
The links above contain information about the contents of those packages.
Next, you need a repo to store you analysis notebooks and other bits of code, text, etc. in. We used to all share a single analysis repo, but it got too big. So, we broke it up so that each team member has their own analysis repo, and there are a few special pupose analysis repos. You can find them all at https://bitbucket.org/account/user/salishsea/projects/SSM_ANALYSIS. The original analysis repo is now read-only.
If you are joining the team as a researcher there should be an analysis repo already set up for you. Its name will be something like analysis-james, but with your name. Go ahead and clone that repo too:
cd /ocean/$USER/MEOPAR/ git clone email@example.com:SalishSeaCast/analysis-james.git
If you are joining the team for a sprint, please clone the analysis-sprints repo:
cd /ocean/$USER/MEOPAR/ git clone firstname.lastname@example.org:SalishSeaCast/analysis-sprints.git
and create a directory in it named after yourself to work in.