NCBI-Hackathons / HistoloMaps

The fastest gigascale image annotation system in the world!
MIT License
5 stars 0 forks source link

HistoloMaps

The fastest gigascale image annotation system in the world!

An efficient annotation storage/visualization/editing framework that can be coupled with existing web-frameworks (e.g. openslide+openseadragon) to visualize tissue images.

LOGO

You can make a free DOI with zenodo

Website (if applicable)

What is ?

Overview Diagram

How to use

Software Workflow Diagram

File structure diagram

Define paths, variable names, etc

Installation options:

We provide two options for installing : Docker or directly from Github.

Docker

The Docker image contains as well as a webserver and FTP server in case you want to deploy the FTP server. It does also contain a web server for testing the main website (but should only be used for debug purposes).

  1. docker pull ncbihackathons/<this software> command to pull the image from the DockerHub
  2. docker run ncbihackathons/<this software> Run the docker image from the master shell script
  3. Edit the configuration files as below

Installing from Github

  1. git clone https://github.com/NCBI-Hackathons/<this software>.git
  2. Edit the configuration files as below
  3. sh server/<this software>.sh to test
  4. Add cron job as required (to execute .sh script)

Configuration

Examples here

Testing

We tested four different tools with . They can be found in server/tools/ .

Additional Functionality

DockerFile

comes with a Dockerfile which can be used to build the Docker image. 1. `git clone https://github.com/NCBI-Hackathons/.git` 2. `cd server` 3. `docker build --rm -t / .` 4. `docker run -t -i /` ### Website There is also a Docker image for hosting the main website. This should only be used for debug purposes. 1. `git clone https://github.com/NCBI-Hackathons/.git` 2. `cd Website` 3. `docker build --rm -t /website .` 4. `docker run -t -i /website`