Skip to main content

('image_tiller is a Python library for tiling and retiling images. It can be used for splitting large images into smaller tiles for other applications like Training Deep Learning models, inference on large images, etc.',)

Project description

Image Tiler

Image Tiler is a Python package that allows you to split an image into tiles based on a grid and overlap between tiles. It also provides functionality to combine the tiles back into the original image.

Installation

You can install Image Tiler using pip:

pip install image-tiller

Usage

SplitImage Class

The SplitImage class is used to split an image into tiles based on a grid and overlap between tiles. The class takes in an image path, the number of rows and columns in the grid, and the overlap between tiles.

CombineTiles Class

The CombineTiles class is used to combine tiles back into the original image. The class takes in a list of tiles, the number of rows and columns in the grid, and the overlap between tiles.

Example

from ImgTiler import SplitImage, CombineTiles
import cv2

img = cv2.imread('image.jpg')
grid = (3, 4) #3 rows, 4 columns
overlap = 30 #30 pixels
show_rects = True
show_image = True

splitter = SplitImage(img, grid, overlap) # Create SplitImage object
tiles = splitter.split_image(show_rect=show_rect, show_tiles=show_image) # Split image into tiles

combiner = CombineTiles(tiles, grid, overlap) # Create CombineTiles object
img2 = combiner.combine_tiles(show_image=show_image) # Combine tiles into original image

Original Image

Orignal Image

Split Result

Split Image without Rectangle Split Image with Rectangle

Combined Image

Combined Image without rectangle Combined Image with rectangle

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT license.

Project details


Download files

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

Source Distribution

image_tiller-0.1.2.1.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

image_tiller-0.1.2.1-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file image_tiller-0.1.2.1.tar.gz.

File metadata

  • Download URL: image_tiller-0.1.2.1.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for image_tiller-0.1.2.1.tar.gz
Algorithm Hash digest
SHA256 cacbb7a7485ab6e229b9fe2c99020b405ca8ed89309fe7213a84d2e0d30d75db
MD5 9f1f3584abe4c013101cf6fafe197595
BLAKE2b-256 3d504cc9856ec95d1a4c906e5b9c7878b6ef82b93771366081f42be0328c4fc7

See more details on using hashes here.

File details

Details for the file image_tiller-0.1.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for image_tiller-0.1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0d066c3190a4174c6d5afe85c232df0ef702a62b6b90f6f3fcf65b74b0b07e8c
MD5 b2c9c7cced743f8d95f9e1e67ceb7ff5
BLAKE2b-256 451dd0b81afbd4d06816fffa0243c26718ed9a3f7128e294dbac27e414343342

See more details on using hashes here.

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