DEEP as a Service container for phytoplankton classification

This service is deprecated. Please refer to the newer Tensorflow version.

This is a container that will run the DEEP as a Service API component, with an application to classify phytoplankton images. This module runs in Lasagne on top of Theano and uses a convolutional neural network (ResNet50) as model.

Running the container

Directly from Docker Hub

To run the Docker container directly from Docker Hub and start using the API simply run the following command:

$ docker run -ti -p 5000:5000 deephdc/deep-oc-phytoplankton-classification

This command will pull the Docker container grom the Docker Hub deephdc organization.

Building the container

If you want to build the container directly in your machine (because you want to modify the Dockerfile for instance) follow the following instructions:

Building the container:

1. Get the DEEP-OC-phytoplankton-classification repository (this repo):

   $ git clone https://github.com/indigo-dc/DEEP-OC-phytoplankton-classification

2. Build the container:

   $ cd DEEP-OC-phytoplankton-classification
   $ docker build -t deephdc/deep-oc-phytoplankton-classification .

3. Run the container:

   $ docker run -ti -p 5000:5000 deephdc/deep-oc-phytoplankton-classification

These three steps will download the repository from GitHub and will build the Docker container locally on your machine. You can inspect and modify the Dockerfile in order to check what is going on. For instance, you can pass the --debug=True flag to the deepaas-run command, in order to enable the debug mode.

Connect to the API

Once the container is up and running, browse to http://localhost:5000 to get the OpenAPI (Swagger) documentation page.