This server was created to simplify the figure making process for planetary researchers at the USGS. It was first thought up by Laszlo Kestay and with the help from the POW development team at the USGS it became the last connection in a web-based processing pipline that connects PILOT, POW, and PIE in a smooth workflow that removes the need for researchers to learn ISIS3 command line interface programs.
- ISIS3
- GDAL
- NodeJS
PIE requires a UNIX based development environment for the simple fact that ISIS cannot be installed on Windows without a virtual environment. If you want to install PIE onto a Windows machine it would be easier to install the Docker image found here. If you wish to contribute to the repo on a Windows machine, I suggest using a virtual linux environment and following the steps below for installation for Ubuntu.
- Anaconda / Miniconda
Download Miniconda3 or Anaconda3.
- Installing Miniconda3.
cd /path/to/downloaded/script
chmod +x ./Miniconda3.sh
./Miniconda3.sh
- GDAL Environment
- Create the gdal environment.
conda create -n gdal
conda activate gdal
- Install gdal using conda
conda config --env --add channels conda-forge
conda install -c conda-forge gdal
- ISIS 3 ( Cannot be installed on Windows )
- Create the isis environment Note: Python 3.6.
conda create -n isis python=3.6
conda activate isis
- Install ISIS Version 3.10.2 or any version you want. Note: Origionally Developed with ISIS v3.10.2
conda config --env --add channels conda-forge
conda config --env --add channels usgs-astrogeology
conda install -c usgs-astrogeology isis=3.10.2
- You will need some data for ISIS before you can run any ISIS applications. At this link you can find all the command you can run to install any data collection at the USGS's disposal.
- NodeJS
Installing on Ubuntu is very simple. Just update your package set and then install the libraries with apt. nodejs contains all the executable and server side functionality while npm helps with dependencies.
sudo apt update
sudo apt install nodejs
sudo apt install npm
- Source Code & Dependencies
This can either be done using git or by downloading the source zip. I am demonstrating how to use git.
- Pull the code down with git.
git clone https://github.com/ChaddFrasier/PIE.git
cd /path/to/PIE
- Install dependencies.
# install all development dependencies
npm install
# or install with production dependencies only
npm install --only=proc
- Activate ISIS and then activate GDAL on top of the ISIS environment.
conda activate isis && conda activate --stack gdal
lowpass -h && gdal_translate -h
- Start the server code in production mode.
npm start
or you can start the code in debug mode debug:win for windows users and debug:mac for MacOS users.
npm run debug:win
Pull the repository down to your own branch, make your changes and then push the branch. Repository managers will merge or reject your changes within a week.
In order to run tests you need to install development dependencies.
Run the cypress command to start the testing UI.
npm run cy:dev