Skip to main content

Create, serve, and display large multiresolution images.

Project description

Large Image Build Status codecov.io License

Python modules to work with large multiresolution images.

Large Image consists of several Python modules designed to work together. These include:

  • large_image: The core module. You can specify extras_require of the name of any tile source included with this repository, sources for all of the tile sources in the repository, memcached for using memcached for tile caching, or all for all of the tile sources and memcached.

  • girder_large_image: Large Image as a Girder 3.x plugin. You can specify extras_require of tasks to install a Girder Worker task that can convert otherwise unreadable images to pyramidal tiff files.

  • large_image_tasks: A utility for using pyvips to convert images into pyramidal tiff files that can be read efficiently by large_image. This can be used by itself or with Girder Worker.

  • Tile sources:

    • large-image-source-tiff: A tile source for reading pyramidal tiff files in common compression formats.

    • large-image-source-openslide: A tile source using the OpenSlide library. This works with svs, ndpi, Mirax, tiff, vms, and other file formats.

    • large-image-source-pil: A tile source for small images via the Python Imaging Library (Pillow).

    • large-image-source-mapnik: A tile source for reading geotiff and netcdf files via Mapnik and GDAL.

    • large-image-source-test: A tile source that generates test tiles, including a simple fractal pattern. Useful for testing extreme zoom levels.

    • large-image-source-dummy: A tile source that does nothing.

    Most tile sources can be used with girder_large_image.

Installation

To install all packages from source, clone

  1. git clone https://github.com/girder/large_image.git

  2. Install all packages and dependencies:

    pip install -e large_image[memcached] -r requirements-dev.txt

Tile source prerequisites

Many tile sources have complex prerequisites. These can be installed directly using your system’s package manager or from some prebuilt Python wheels for Linux. The prebuilt wheels are not official packages, but they can be used by instructing pip to use them by preference:

pip install -e large_image[memcached] -r requirements-dev.txt --find-links https://manthey.github.io/large_image_wheels

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

large_image-1.0.0.dev27.tar.gz (155.7 kB view details)

Uploaded Source

File details

Details for the file large_image-1.0.0.dev27.tar.gz.

File metadata

  • Download URL: large_image-1.0.0.dev27.tar.gz
  • Upload date:
  • Size: 155.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for large_image-1.0.0.dev27.tar.gz
Algorithm Hash digest
SHA256 fd80155a48624b0df51898f8aed96f9f6f4f747e3e9381cd2ccb496e8714487f
MD5 9b1035f0d06202029a389da2deadfacc
BLAKE2b-256 3c62bc7e1f36f5dd0aec1cea6a52d5b558ffb6e23bf1770c36f77bdf1f31ce27

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