Earth Analytics Python Conda Environment
Welcome to the Earth Analytics Python Environment Repository! Here you will find a conda environment that can be installed on your computer using a .yaml file. You will also find a docker image that can be used to actually run the environment in a containerized environment.
Contributors:
- Leah A. Wasser (@lwasser)
- Filipe fernandes (@ocefpaf)
- Tim Head (@betatim)
- Chris Holdgraf (@choldgraf)
- Max Joseph (@mbjoseph)
- Martha Morrissey
Getting started with the Conda Environment
1. Install the Earth Lab Conda Environment on your Local Computer.
To begin, install git and conda for Python 3.x (we suggest 3.6).
Installing git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
Installing miniconda: https://docs.conda.io/en/latest/miniconda.html
About Conda Environments: https://conda.io/docs/user-guide/tasks/manage-environments.html
Tutorial On Setup
If you want a more detailed tutorial on setting up this environment using miniconda, please visit our learning portal: https://www.earthdatascience.org/workshops/setup-earth-analytics-python/
We recommend installing everything using the with conda-forge channel.
Quick Start: Setup Your Environment
The tutorial above will provide you with more detailed setup instructions. But here are the cliff notes:
To begin, install the environment using:
conda env create -f environment.yml
This will take a bit of time to run.
- Also note that for the code above to work, you need to be in the directory where the
environment.ymlfile lives so CD to that directory first
$ cd earth-analytics-python-env
Update Your EA Environment from the YAML File
You can update your environment at any time using:
conda env update -f environment.yml
To manage your conda environments, use the following commands:
View envs installed
conda info --envs
Activate the environment that you'd like to use
Conda 4.6 and later versions (all operating systems):
conda activate earth-analytics-python
The environment name is earth-analytics-python as
defined in the environment.yml file.
Docker Build
To run a docker container you need to do the following:
-
Install docker and make sure it is running.
-
Build the docker image on your compute locally. Be patient - this will take a bit of time. Run the following lines to build the docker image locally:
cd earth-analytics-python-env
docker build -t earthlab/earth-analytics-python-env .
docker run -it -p 8888:8888 earthlab/earth-analytics-python-env
- Run the image.
To run your earth-analytics image, use the following code:
docker run --hostname localhost -it -p 8888:8888 earthlab/earth-analytics-python-env
NOTE: earthlab/earth-analytics-python-env is the name of this image as built above. To
view all images on your computer, type
docker images --all
One you run your image, you will be given a URL at the command line. Paste that puppy into your browser to run jupyter with the earth analytics environment installed!!
Updating the Earth Analytics Environment
If you wish to update the earth analytics environment, do the following.