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 applyscaling(default)scaling: Scale to 0-255, clipping negative numbers and scaling positive numbers.sigmoid: Sigmoid normalization, as described in xarray true colorsentinel: 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.
Metadata
Release files for image_tiles 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| image_tiles-0.1.5.tar.gz | 2.3 MB | Without provenance | Details for image_tiles-0.1.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| image_tiles-0.1.5-py3-none-any.whl | Python 3 | none | any | Details for image_tiles-0.1.5-py3-none-any.whl |
Total release size: 2.3 MB
Release files / image_tiles-0.1.5.tar.gz
| Download URL | image_tiles-0.1.5.tar.gz |
|---|---|
| Size | 2.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8f72b2a3917a7feadcac6b2d4f5f976cc6a24429256677fde25e81d162759bce
|
|
BLAKE2b-256 checksum How to use checksums |
58c02bec841d7d1c31a7b13f23798a539ed1f4a699d4395688830348dbcb7888
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.7
|
Release files / image_tiles-0.1.5-py3-none-any.whl
| Download URL | image_tiles-0.1.5-py3-none-any.whl |
|---|---|
| Size | 19.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
41db11f676631eaa803201251ad65d97648b6dafca61dfa558e093b43680df21
|
|
BLAKE2b-256 checksum How to use checksums |
aa71ad40aa1350d47029ec035c8e9b3683708bb7d9432432f69d2d5a90de1c05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.7
|
Security for image_tiles 0.1.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.