image_tiles 0.1.4

Serve a webpage with images from a folder.

Image Tiles

A Moonshine Labs tool

Overview

A simple but flexible tool to view a folder full of images on your web browser. Features:

• Run one command and serve a folder of images in any format PIL supports.
• Easily view images on another computer, such as when working via SSH or remotely.
• Support for AWS S3 and Google Cloud Storage buckets.
• Normalization and rendering options for a variety of multispectral images, especially satellites.
• Support for multichannel TIFF, JP2, and other less common file formats.

Quickstart

Run uvx image_tiles /path/to/folder

Installation

# Install default installation
$ pip install image_tiles

# Install with AWS S3 support
$ pip install image_tiles[aws]

# Install with Google Cloud Storage support
$ pip install image_tiles[gcp]

# Install with all cloud backends
$ pip install image_tiles[all]

Using uvx

You can also run image_tiles directly with uvx without installing:

# Run with default installation
$ uvx image_tiles /path/to/folder

# Run with AWS S3 support
$ uvx --with 'image_tiles[aws]' image_tiles s3://my-bucket/images/

# Run with Google Cloud Storage support
$ uvx --with 'image_tiles[gcp]' image_tiles gs://my-bucket/images/

# Run with all cloud backends
$ uvx --with 'image_tiles[all]' image_tiles /path/to/folder

Usage

# Serve local images
$ image_tiles ./path_to_folder

# Serve images from AWS S3
$ image_tiles s3://my-bucket/images/

# Serve images from Google Cloud Storage
$ image_tiles gs://my-bucket/images/

Serving a folder of JPEGs (images from instagram.com/dustinlefevre)

Serving a folder of multispectral TIFFs:

Rendering options

• rgb: Standard RGB image rendering (default).
• bgr: BGR image rendering.
• bw: Grayscale image rendering from the first 3 channels.
• sentinel: Render using channels[1:4] for sentinel satellite data.

Normalization options

• standard: If the image is a standard 1/3 channel image, leave it alone. Otherwise apply scaling (default)
• scaling: Scale to 0-255, clipping negative numbers and scaling positive numbers.
• sigmoid: Sigmoid normalization, as described in xarray true color
• sentinel: Sentinel-2 specific normalization, as described at the Sentinel 2 user guide

Current Limitations

• Only a subset of useful normalization and rendering options supported. Help contribute!
• Eventually we'd like to more easily support user code and functions.
• Must restart the server to change some options.