cog2tiles 0.0.4

COG to web map tiles converter with concurrent processing

cog2tiles

Cloud Optimized GeoTIFF (COG) to web map tiles converter built with modern Python.

Installation

Using uv (recommended)

git clone https://github.com/kshitijrajsharma/cog2tiles.git
cd cog2tiles
uv sync

Using pip

pip install cog2tiles

Usage

Command Line Interface

Basic usage:

cog2tiles input.tif -z 19

Advanced usage:

cog2tiles input.tif -z 19 --tile-size 512 --extension png --output-dir tiles/ --workers 64

Options

• input_cog: Path to input COG file
• -z, --zoom: Target zoom level (0-22)
• -o, --output-dir: Output directory (default: tiles)
• --tile-size: Tile size in pixels, 256 or 512 (default: 256)
• --prefix: Filename prefix for tiles (default: tile)
• --extension: Output format - png, jpg, webp (default: png)
• --workers: Maximum concurrent workers (default: auto-detected)
• --log-level: Logging level - DEBUG, INFO, WARNING, ERROR (default: INFO)

Python API

import asyncio
from cog2tiles import COGTiler

async def main():
    tiler = COGTiler(
        tile_size=512,
        max_workers=32,
        extension="webp"
    )
    
    await tiler.convert_to_tiles("input.tif", "output/", zoom=19)

asyncio.run(main())

Requirements

• Python 3.11 or higher
• GDAL/rasterio for geospatial operations
• Numba for accelerated processing
• UV for dependency management
• uvloop for the fast asyncio loops (optional)

Development

Setup Development Environment

git clone https://github.com/kshitijrajsharma/cog2tiles.git
cd cog2tiles
uv sync --dev

Running Tests

uv run pytest

Code Formatting

uv run black src/
uv run isort src/

Supported Input Formats

• Cloud Optimized GeoTIFF (COG)
• Any rasterio-supported format with proper georeferencing

Output Formats

• PNG (lossless, supports transparency)
• JPEG (lossy, smaller file sizes)
• WebP (modern format, good compression)

License

MIT License - see LICENSE file for details.

Author

Kshitij Raj Sharma (2025)