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.
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.
Download Miniconda3 or Anaconda3.
cd /path/to/downloaded/script
chmod +x ./Miniconda3.sh
./Miniconda3.sh
conda create -n gdal
conda activate gdal
conda config --env --add channels conda-forge
conda install -c conda-forge gdal
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.
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
This can either be done using git or by downloading the source zip. I am demonstrating how to use git.
git clone https://github.com/ChaddFrasier/PIE.git
cd /path/to/PIE
# install all development dependencies
npm install
npm install --only=proc
## Running
1. Activate ISIS and then activate GDAL on top of the ISIS environment.
conda activate isis && conda activate --stack gdal lowpass -h && gdal_translate -h
2. 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
## Contribute
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.
#### Running Tests
*In order to run tests you need to install development dependencies.*
Run the cypress command to start the testing UI.
npm run cy:dev
-----------------------
[USGS-Astrogeology](https://www.usgs.gov/centers/astrogeology-science-center) | [Docker Container](https://hub.docker.com/repository/docker/chaddfrasier/pie-usgs)