Add option to use the package online

[mdtanker]

Description of the desired feature:

Choose between Google Colab or Binder

Binder

• searches repo for either requirements.txt or environment.yml to build a Docker image.

• .yml would be good since it uses conda to install, solves issues associate with Reconfigure PyGMT / GMT install #17 and Reconfigure GeoPandas / GDAL install #19

• automatically include in Jupyter-Book RTD webpage.

• follow this to use conda and pip

• follow this to use with just conda

• follow this to use with just pip

• tutorial

Colab

• can install packages within the Colab with !pip install or !apt-get install
• Follow directions here to set up PyGMT on Colab

%%capture
!sudo apt update
!sudo apt upgrade -y
!sudo apt install -y build-essential cmake libcurl4-gnutls-dev libnetcdf-dev gdal-bin libgdal-dev libfftw3-dev libpcre3-dev liblapack-dev libblas-dev libglib2.0-dev ghostscript ghostscript-x graphicsmagick ffmpeg xdg-utils
# clone gmt from source
!git clone --depth 50 https://github.com/GenericMappingTools/gmt
# cmake everything
!cmake /content/gmt
# build and install
!cmake --build . --target install

# just for the paranoics (answer should be )/usr/local/bin/gmt
!which GMT

# install pygmt and geopandas with pip
%%capture
!pip install pygmt geopandas

# %load_ext autoreload
# %autoreload 2
# install antarctic_plots with pip
%%capture
!pip install antarctic_plots
from antarctic_plots import profile
from antarctic_plots import fetch

Above only recognized v0.0.1 of antarctic_plots

Other things

• repo2docker

Are you willing to help implement and maintain this feature?

Yes

[mdtanker]

Added folder /binder with environment.yml. This automatically re-builds binder with each PR with the pinned packages in the above file.

I haven't figured out how to have conda install optional dependencies, so tqdm is included for pooch[progress], and the following are included for xarray[io]:

• cfgrib=0.9.10.1
• rasterio=1.3.2
• cftime=1.6.1
• zarr=2.12.0
• pydap=3.2.2
• scipy=1.6.1
• h5netcdf=1.0.2
• netcdf4=1.6.0

After lots of attempts, the following commit had the successful environment.yml file: c88a23c

The binder link is: https://mybinder.org/v2/gh/mdtanker/antarctic_plots/c88a23c9dfe92c36f0bfdbbc277d926c2de763de

Still need to follow this link to help reduce the binder build time, and to stop rebuilding at each commit.