Merge pull request #220 from sentinel-hub/feat/docker-images

Feat/docker images

Author: AleksMat

Diff for: .dockerignore

@@ -0,0 +1,2 @@
+.git
+docs

Diff for: README.md

@@ -4,6 +4,7 @@
 [![License](https://img.shields.io/pypi/l/eo-learn.svg)](https://github.com/sentinel-hub/eo-learn/blob/master/LICENSE)
 [![Overall downloads](http://pepy.tech/badge/eo-learn)](https://pepy.tech/project/eo-learn)
 [![Last month downloads](https://pepy.tech/badge/eo-learn/month)](https://pepy.tech/project/eo-learn)
+[![Docker pulls](https://img.shields.io/docker/pulls/sentinelhub/eolearn.svg)](https://hub.docker.com/r/sentinelhub/eolearn)
 [![codecov](https://codecov.io/gh/sentinel-hub/eo-learn/branch/master/graph/badge.svg)](https://codecov.io/gh/sentinel-hub/eo-learn)
 <img align="right" src="docs/source/figures/eo-learn-logo.png" alt="" width="300"/>
 
@@ -25,7 +26,7 @@ to use any of the available tasks and is encouraged to improve the, develop new
 
 **`eo-learn`** makes extraction of valuable information from satellite imagery as easy as defining a sequence of operations to be performed on satellite imagery. Image below illustrates a processing chain that maps water in satellite imagery by thresholding the Normalised Difference Water Index in user specified region of interest.
 
-![eo-learn-workflow0illustration](docs/source/figures/eo-learn-illustration.png)
+![](docs/source/figures/eo-learn-illustration.png)
 
 **`eo-learn`** _library acts as a bridge between Earth observation/Remote sensing field and Python ecosystem for data science and machine learning._ The library is written in Python and uses NumPy arrays to store and handle remote sensing data. Its aim is to make entry easier for non-experts to the field of remote sensing on one hand and bring the state-of-the-art tools for computer vision, machine learning, and deep learning existing in Python ecosystem to remote sensing experts.
 
@@ -110,6 +111,30 @@ conda install eo-learn-ml-tools
 conda install eo-learn-visualization
 ```
 
+### Run with Docker
+
+A docker image with the latest released version of `eo-learn` is available at [Docker Hub](https://hub.docker.com/r/sentinelhub/eolearn). It provides a full installation of `eo-learn` together with a Jupyter notebook environment. You can pull and run it with:
+
+```bash
+docker pull sentinelhub/eolearn:latest
+docker run -p 8888:8888 sentinelhub/eolearn:latest
+```
+
+An extended version of the `latest` image additionally contains all example notebooks and data to get you started with `eo-learn`. Run it with: 
+
+```bash
+docker pull sentinelhub/eolearn:latest-examples
+docker run -p 8888:8888 sentinelhub/eolearn:latest-examples
+```
+
+Both docker images can also be built manually from GitHub repository:
+
+```bash
+docker build -f docker/eolearn.dockerfile . --tag=sentinelhub/eolearn:latest
+docker build -f docker/eolearn-examples.dockerfile . --tag=sentinelhub/eolearn:latest-examples
+```
+
+
 ## Documentation
 
 For more information on the package content, visit [readthedocs](https://eo-learn.readthedocs.io/).

Diff for: docker/eolearn-examples.dockerfile

@@ -0,0 +1,4 @@
+FROM sentinelhub/eolearn:latest
+
+COPY ./examples ./examples
+COPY ./example_data ./example_data

Diff for: docker/eolearn.dockerfile

@@ -0,0 +1,58 @@
+FROM python:3.8-buster
+
+LABEL maintainer="Sinergise EO research team <[email protected]>"
+
+RUN apt-get update && apt-get install -y \
+        gcc \
+        libgdal-dev \
+        graphviz \
+        proj-bin \
+        libproj-dev \
+        libspatialindex-dev \
+    && apt-get clean && apt-get autoremove -y && rm -rf /var/lib/apt/lists/*
+
+ENV CPLUS_INCLUDE_PATH=/usr/include/gdal
+ENV C_INCLUDE_PATH=/usr/include/gdal
+
+RUN pip3 install --no-cache-dir shapely --no-binary :all:
+
+WORKDIR /tmp
+
+COPY core core
+COPY coregistration coregistration
+COPY features features
+COPY geometry geometry
+COPY io io
+COPY mask mask
+COPY ml_tools ml_tools
+COPY visualization visualization
+COPY setup.py README.md requirements-dev.txt ./
+
+RUN pip3 install --no-cache-dir \
+    ./core \
+    ./coregistration \
+    ./features \
+    ./geometry \
+    ./io \
+    ./mask \
+    ./ml_tools \
+    ./visualization \
+    .
+
+RUN pip3 install --no-cache-dir \
+    ./visualization[FULL] \
+    rtree \
+    jupyter
+
+RUN rm -r ./*
+
+ENV TINI_VERSION=v0.19.0
+ADD https://github.com/krallin/tini/releases/download/${TINI_VERSION}/tini /tini
+RUN chmod +x /tini
+ENTRYPOINT ["/tini", "--"]
+
+WORKDIR /home/eolearner
+
+EXPOSE 8888
+CMD ["/usr/local/bin/jupyter", "notebook", "--no-browser", "--port=8888", "--ip=0.0.0.0", \
+     "--NotebookApp.token=''", "--allow-root"]

Diff for: visualization/eolearn/visualization/xarray_utils.py

@@ -229,8 +229,8 @@ def new_coordinates(data, crs, new_crs):
     y_values = data.coords['y'].values
     bbox = BBox((x_values[0], y_values[0], x_values[-1], y_values[-1]), crs=crs)
     bbox = bbox.transform(new_crs)
-    xmin, ymin = bbox.get_lower_left()
-    xmax, ymax = bbox.get_upper_right()
+    xmin, ymin = bbox.lower_left
+    xmax, ymax = bbox.upper_right
     new_xs = np.linspace(xmin, xmax, len(x_values))
     new_ys = np.linspace(ymin, ymax, len(y_values))