image-tiles


Nameimage-tiles JSON
Version 0.1.2 PyPI version JSON
download
home_page
SummaryServe a webpage with images from a folder.
upload_time2023-01-24 00:21:58
maintainer
docs_urlNone
author
requires_python>=3.7
licenseMIT
keywords image tiles visualize
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # 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 (and eventually GCS/Azure) buckets.
* Normalization and rendering options for a variety of multispectral images, especially satellites.
* Support for multichannel TIFF, JP2, and other less common file formats.

## Installation
```
# Install default installation
$ pip install image_tiles

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

## Usage
```
$ image_tiles ./path_to_folder
```

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

![example_page](docs_images/image_tiles_demo.png)

### Serving a folder of multispectral TIFFs:

![example_sat](docs_images/image_tiles_sat.png)

### 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](https://xarray-spatial.org/reference/_autosummary/xrspatial.multispectral.true_color.html)
* `sentinel`: Sentinel-2 specific normalization, as described at the Sentinel 2 [user guide](https://sentinels.copernicus.eu/web/sentinel/user-guides/sentinel-2-msi/definitions)

## 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.

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "image-tiles",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "image,tiles,visualize",
    "author": "",
    "author_email": "Nate Harada <image_tiles@moonshinelabs.ai>",
    "download_url": "https://files.pythonhosted.org/packages/d7/f7/d2eceee90e239f558ca6c6c31c4e7ba7e8032bcdee327f09ec47dad4e504/image_tiles-0.1.2.tar.gz",
    "platform": null,
    "description": "# Image Tiles\n\n*A Moonshine Labs tool*\n\n## Overview\nA simple but flexible tool to view a folder full of images on your web browser. Features:\n\n* Run one command and serve a folder of images in any format PIL supports.\n* Easily view images on another computer, such as when working via SSH or remotely.\n* Support for AWS (and eventually GCS/Azure) buckets.\n* Normalization and rendering options for a variety of multispectral images, especially satellites.\n* Support for multichannel TIFF, JP2, and other less common file formats.\n\n## Installation\n```\n# Install default installation\n$ pip install image_tiles\n\n# Install with S3 support\n$ pip install image_tiles[aws]\n```\n\n## Usage\n```\n$ image_tiles ./path_to_folder\n```\n\n### Serving a folder of JPEGs (images from instagram.com/dustinlefevre)\n\n![example_page](docs_images/image_tiles_demo.png)\n\n### Serving a folder of multispectral TIFFs:\n\n![example_sat](docs_images/image_tiles_sat.png)\n\n### Rendering options\n* `rgb`: Standard RGB image rendering (default).\n* `bgr`: BGR image rendering.\n* `bw`: Grayscale image rendering from the first 3 channels.\n* `sentinel`: Render using channels[1:4] for sentinel satellite data.\n\n### Normalization options\n* `standard`: If the image is a standard 1/3 channel image, leave it alone. Otherwise apply `scaling` (default)\n* `scaling`: Scale to 0-255, clipping negative numbers and scaling positive numbers.\n* `sigmoid`: Sigmoid normalization, as described in [xarray true color](https://xarray-spatial.org/reference/_autosummary/xrspatial.multispectral.true_color.html)\n* `sentinel`: Sentinel-2 specific normalization, as described at the Sentinel 2 [user guide](https://sentinels.copernicus.eu/web/sentinel/user-guides/sentinel-2-msi/definitions)\n\n## Current Limitations\n\n* Only a subset of useful normalization and rendering options supported. Help contribute!\n* Eventually we'd like to more easily support user code and functions.\n* Must restart the server to change some options.",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Serve a webpage with images from a folder.",
    "version": "0.1.2",
    "split_keywords": [
        "image",
        "tiles",
        "visualize"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d916f90032beb1e4ad3be5b7937943470a222202beb45de17396d208aa2762f4",
                "md5": "2916b536883c3ff708e2809b18f75d01",
                "sha256": "4e08819d8b45a54b7fed64d4bfa171f7638738a60b7b1e0d13a05752f95cf798"
            },
            "downloads": -1,
            "filename": "image_tiles-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2916b536883c3ff708e2809b18f75d01",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 18745,
            "upload_time": "2023-01-24T00:21:56",
            "upload_time_iso_8601": "2023-01-24T00:21:56.609102Z",
            "url": "https://files.pythonhosted.org/packages/d9/16/f90032beb1e4ad3be5b7937943470a222202beb45de17396d208aa2762f4/image_tiles-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d7f7d2eceee90e239f558ca6c6c31c4e7ba7e8032bcdee327f09ec47dad4e504",
                "md5": "6e73bfbb921a0ce2dac78267943d8b24",
                "sha256": "6edf949ecaf6b9bab20e8e8e47feabffd64560558b9d950e528ad8f7c18a0dc7"
            },
            "downloads": -1,
            "filename": "image_tiles-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "6e73bfbb921a0ce2dac78267943d8b24",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 2246549,
            "upload_time": "2023-01-24T00:21:58",
            "upload_time_iso_8601": "2023-01-24T00:21:58.844129Z",
            "url": "https://files.pythonhosted.org/packages/d7/f7/d2eceee90e239f558ca6c6c31c4e7ba7e8032bcdee327f09ec47dad4e504/image_tiles-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-01-24 00:21:58",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "image-tiles"
}
Elapsed time: 0.03421s