Skip to main content

Organize, visualize, and analyze histology images.

Project description

Organize, visualize, and analyze histology images.

HistomicsUI organizes and manages whole slide image (WSI) files using Girder. It has a dedicated interface to select WSI, add annotations manually, and to run analysis and algorithms on all or parts of images.

Girder provides authentication, access control, and diverse storage options, including using local file systems and Amazon S2. WSI images are read and displayed via the large_image module. Algorithms are containerized using Docker and are run using the slicer_cli_web Girder plugin. These can be run on multiple worker machines via Girder Worker and celery.

A set of common algorithms are provided by HistomicsTK.

Installation

Linux

In linux with Python 3.6 or newer:

Prerequisites:

  • MongoDB must be installed and running.

  • An appropriate version of Python must be installed.

pip install histomicsui --find-links https://girder.github.io/large_image_wheels
girder build
girder serve

To use Girder Worker:

pip install girder_slicer_cli_web[worker]
GW_DIRECT_PATHS=true girder_worker -l info -Ofair --prefetch-multiplier=1

The first time you start HistomicsUI, you’ll also need to configure Girder with at least one user and one assetstore (see the Girder documentation). Additionally, it is recommended that you install the HistomicsTK algorithms. This can be done going to the Admin Console, Plugins, Slicer CLI Web settings. Set a default task upload folder, then import the dsarchive/histomicstk:latest docker image.

Reference Deployment

The standard deployment of HistomicsUI is the Digital Slide Archive. The associated repository has tools for readily installing via Docker, VirtualBox, or shell scripts on Ubuntu.

Development

The most convenient way to develop on HistomicsUI is to use the devops scripts from the Digial Slide Archive.

Funding

This work is funded in part by the NIH grant U24-CA194362-01.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

histomicsui-1.0.1.dev34.zip (186.8 kB view details)

Uploaded Source

File details

Details for the file histomicsui-1.0.1.dev34.zip.

File metadata

  • Download URL: histomicsui-1.0.1.dev34.zip
  • Upload date:
  • Size: 186.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5

File hashes

Hashes for histomicsui-1.0.1.dev34.zip
Algorithm Hash digest
SHA256 e99b6e0f9ee3f5fdf7bd694bcc31b379d43accd4739e341bdb92f319548842eb
MD5 11e5e5e1604bcabef8cb5c0abd47981a
BLAKE2b-256 45b7180ff260a55e1ea8bfd5b9cbff6b5330e7e058a38b388d6beeaa20d93feb

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page