Installationļ
Use conda (recommended)ļ
The latest stable public release of GPlately can be installed using conda from the conda-forge channel. The following commands will create a new conda environment called my-gplately-conda-env and install GPlately within that environment.
$ conda create -n my-gplately-conda-env
$ conda activate my-gplately-conda-env
$ conda install -c conda-forge gplately
Note
If conda gets stuck while solving the environment during the installation of GPlately, you can try to use micromamba instead.
Use pipļ
GPlately can also be installed using pip.
š Install the latest stable public release from PyPI
$ pip install gplately
š Install from the GitHub GPlately repository (if you need the latest code changes on GitHub)
$ pip install git+https://github.com/GPlates/gplately.git
š Install from a local folder (if you need local code changes)
$ git clone https://github.com/GPlates/gplately.git gplately.git
$ cd gplately.git
$ git checkout master
$ git pull
$ MAKE YOUR LOCAL CODE CHANGES HERE ...
$ pip install -e .
Note
āļø The pip install -e .
command installs GPlately in editable mode.
Use dockerļ
š Run GPlately notebooks with Docker
$ docker pull gplates/gplately
$ docker run --rm -ti -p 8888:8888 gplates/gplately
The commands above will start a Jupyter Notebook server on port 8888. Open this link http://localhost:8888 in a web browser.
š Run GPlately commands with Docker
$ docker run gplates/gplately gplately --version
$ docker run gplates/gplately gplately --help
š Run your Python scripts with Docker
$ docker run -it --rm -v THE_FULL_PATH_TO_YOUR_SCRIPT_FOLDER:/ws -w /ws gplates/gplately python my_script_to_run.py
Note
Replace THE_FULL_PATH_TO_YOUR_SCRIPT_FOLDER
with the full path to the folder containing your script file.
In PowerShell, you can use ā$PWDā if your script is in the current working directory. On Linux or macOS, you can use `pwd` instead.
Docker images are available at both Docker Hub and GitHub Container Registry.
Visit this Docker README page for more details about using Docker with GPlately.