CSM-CameraModel

Setting up dependencies with conda (RECOMMENDED)

Install conda if you do not already have it.

wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh;
bash miniconda.sh -b

You can add a -p <install-prefix> to choose where to install miniconda. By default, it will install it to $HOME/miniconda3.

Setting up conda for bash

Copy and paste the following into a terminal running the bash shell:

echo -e "\n\n# Adding miniconda3 to PATH" >> $HOME/.bashrc && \
echo -e "export PATH=$HOME/miniconda3/bin:\$PATH" >> $HOME/.bashrc && \
source $HOME/.bashrc && \
which conda

For more information: bash installation

Setting up conda for tcsh

Copy and paste the following into a terminal running the tcsh shell:

echo  "\n\n# Setting up miniconda3 for tcsh" >> $HOME/.cshrc && \
echo  "source $HOME/miniconda3/etc/profile.d/conda.csh > /dev/null" >> $HOME/.cshrc && \
source $HOME/.cshrc && \
which conda

For more information: tcsh installation

Creating an isolated conda environment

Run the following commands to create a self-contained dev environment for CSM-CameraModel (type y to confirm creation):

conda create -n csmdev -c usgs-astrogeology cmake libcsm

For more information: conda environments

Activating the environment

After creating the csmdev environment and installing cmake and libcsm into it, we need to activate it. Right now, cmake, libcsm, and their dependencies are isolated to a conda environment and we need to tell conda that we want to use it. The activation command depends on your shell.

• bash: source activate csmdev
• tcsh: conda activate csmdev

You can add these to the end of your $HOME/.bashrc or $HOME/.cshrc if you want the csmdev environment to be active in every new terminal.

Building CSM-CameraModel

After you've set up conda, you can build CSM-CameraModel:

1. Fork USGS-Astrogeology/CSM-CameraModel if you don't already have a fork.
2. Clone your fork of CSM-CameraModel with --recursive option to get the gtest submodule.

git clone --recursive git@github.com:<your-username>/CSM-CameraModel.git
cd CSM-CameraModel
git remote add upstream git@github.com:USGS-Astrogeology/CSM-CameraModel.git

3. Sync your fork with upstream and ensure the gtest submodule is init'd if your fork is old.

git pull upstream master
git submodule update --init --recursive
git push -u origin master

4. mkdir build && cd build
5. cmake .. && make
6. ctest

Building without a package manager

To build:

1. Install libcsmapi

   You can install this with an INSTDIR of your choice, or let it default (see libcsmapi README)

mkdir $HOME/csmenv
cd $HOME
git clone git@github.com:sminster/csm.git
cd csm
make -f Makefile.linux64 all install clean INSTDIR="$csmenv"

2. Install cmake >= 3.10

cd $HOME
wget https://cmake.org/files/v3.12/cmake-3.12.0-Linux-x86_64.tar.gz
tar xzf cmake-3.12.0-Linux-x86_64.tar.gz
rsync -azv cmake-3.12.0-Linux-x86_64/ $HOME/csmenv/
echo -e "\n#Prepending csm env to path\nsetenv PATH "$HOME/csmenv/bin:$PATH" >> $HOME/.cshrc
source $HOME/.cshrc

3. Fork and clone down this repo and its submodules (gtest)

git clone --recursive git@github.com:<username>/CSM-CameraModel.git
cd CSM-CameraModel
git remote add upstream git@github.com:USGS-Astrogeology/CSM-CameraModel.git
git pull upstream master
git submodule update --init --recursive
git push -u origin master

4. mkdir build && cd build
5. cmake -DCSM_INCLUDE_DIR="${csmenv}/include/csm -DCSM_LIBRARY="${csmenv}/lib/libcsmapi.so .. && make