Skip to main content

CLI and Backends to work with MosaicJSON.

Project description

cogeo-mosaic

rio-tiler

Create mosaics of Cloud Optimized GeoTIFF based on the mosaicJSON specification.

Test Coverage Package version Downloads Downloads


Documentation: https://developmentseed.org/cogeo-mosaic/

Source Code: https://github.com/developmentseed/cogeo-mosaic


Read the official announcement https://medium.com/devseed/cog-talk-part-2-mosaics-bbbf474e66df

Install

python -m pip install pip -U
python -m pip install cogeo-mosaic --pre

# Or from source

python -m pip install git+http://github.com/developmentseed/cogeo-mosaic

Notes:

  • Starting with version 5.0, pygeos has been replaced by shapely and thus makes libgeos a requirement. Shapely wheels should be available for most environment, if not, you'll need to have libgeos installed.

See it in action

  • TiTiler: A lightweight Cloud Optimized GeoTIFF dynamic tile server (COG, STAC and MosaicJSON).

Contribution & Development

See CONTRIBUTING.md

License

See LICENSE

Authors

Created by Development Seed

See contributors for a listing of individual contributors.

Changelog

Unreleased

8.0.0 (2024-10-21)

  • remove deprecated methods

  • update morecantile requirement to >=5.0,<7.0

  • update rio-tiler requirement to >=7.0,<8.0

  • update Info model

    # before
    class Info(BaseModel):
        bounds: BBox = Field(default=(-180, -90, 180, 90))
        center: Optional[Tuple[float, float, int]] = None
        minzoom: int = Field(0, ge=0, le=30)
        maxzoom: int = Field(30, ge=0, le=30)
        name: Optional[str] = None
        quadkeys: List[str] = []
        tilematrixset: Optional[str] = None
    
    # now
    class Info(BaseModel):
        bounds: BBox = Field(default=(-180, -90, 180, 90))
        crs: str
        center: Optional[Tuple[float, float, int]] = None
        name: Optional[str] = None
        quadkeys: List[str] = []
        mosaic_tilematrixset: Optional[str] = None
        mosaic_minzoom: int = Field(0, ge=0, le=30)
        mosaic_maxzoom: int = Field(30, ge=0, le=30)
    

7.2.0 (2024-10-04)

7.1.0 (2023-12-06)

  • Automatically remove/add asset_prefix in Mosaic Backends

7.0.1 (2023-10-17)

7.0.0 (2023-07-26)

  • update morecantile requirement to >=5.0,<6.0
  • update rio-tiler requirement to >=6.0,<7.0
  • update pydantic requirement to ~=2.0

6.2.0 (2023-07-11)

  • add coord_crs to MosaicBackend.point() method

6.1.0 (2023-07-11)

  • add tilematrixset in MosaicBackend.info() response

6.0.1 (2023-07-11)

  • fix HttpBackend post_init method

6.0.0 (2023-07-10)

  • update morecantile>=4.1,<5.0 and rio-tiler>=5.0,<6.0 requirements

  • replace supermercado with supermorecado to burn geometries as tiles for different TMS

  • update MosaicJSON models to 0.0.3 specification (adds tilematrixset, asset_type, asset_prefix, data_type, colormap and layers attributes)

  • allow Mosaic creation using other TileMatrixSet (default is still WebMercatorQuad)

  • add tms support to MosaicBackend to read tile in other TMS than the mosaic TileMatrixSet

    # Before
    # Mosaic and output Tile in WebMercatorQuad
    with MosaicBackend("mosaic.json") as mosaic:
        img, _ = mosaic.tile(0, 0, 0)
    
    # Now
    # Mosaic in WebMercatorQuad (default), output tile in WGS84
    WGS1984Quad = morecantile.tms.get("WGS1984Quad")
    with MosaicBackend("mosaic.json", tms=WGS1984Quad) as mosaic:
        img, _ = mosaic.tile(0, 0, 0)
    

5.1.1 (2023-02-06)

5.1.0 (2023-01-20)

  • use az:// prefix for private Azure Blob Storage Backend.

5.0.0 (2022-11-21)

  • switch from pygeos to shapely>=2.0

4.2.2 (2022-11-19)

  • remove useless file in package

4.2.1 (2022-11-15)

  • add python 3.11 support

4.2.0 (2022-10-24)

  • remove python 3.7 support
  • add python 3.10 support
  • switch to hatch build-system
  • update rio-tiler dependency to >=4.0.0a0

4.1.1 (2022-10-21)

4.1.0 (2022-02-22)

  • remove mercantile and switch to morecantile>=3.1

4.0.0 (2021-11-30)

  • no change since 4.0.0a2

4.0.0a2 (2021-11-22)

  • update rio-tiler requirement (>=3.0.0a6) and update backend reader type information

4.0.0a1 (2021-11-18)

  • update rio-tiler requirement (>=3.0.0a5)
  • fix MosaicBackend to match Backend input names.

4.0.0a0 (2021-10-20)

breaking changes

  • remove BaseBackend.metadata() method (can be replaced by BaseBackend.mosaic_def.dict(exclude={"tiles"}))
  • remove cogeo_mosaic.models.Metadata model
  • remove python 3.6 support
  • BaseBackend.path -> BaseBackend.input attribute (input was added in rio-tiler BaseReader)

3.0.2 (2021-07-08)

3.0.1 (2021-06-22)

3.0.0 (2021-05-19)

3.0.0rc2 (2021-02-25)

breaking

  • gzip is now only applied if the path endswith .gz
  • remove backend_options attribute in base backends. This attribute was used to pass optional gzip option and/or STAC related options
  • STAC backends has additional attributes (stac_api_options and mosaic_options)

3.0.0rc1 (2021-02-11)

breaking

3.0.0b1 (2020-12-18)

3.0.0a19 (2020-12-14)

  • Update to remove all calls to rio_tiler.mercator functions.

3.0.0a18 (2020-11-24)

  • update Backend base class for rio-tiler 2.0.0rc3 (add .feature() method)

3.0.0a17 (2020-11-09)

  • update for rio-tiler 2.0rc and add backend output models

3.0.0a16 (2020-10-26)

  • raise MosaicNotFoundError when mosaic doesn't exists in the DynamoDB table.

3.0.0a15 (2020-10-22)

3.0.0a14 (2020-10-22)

with MosaicBackend(
    f"stac+{stac_endpoint}",
    query.copy(),
    11,
    14,
    backend_options={
        "accessor": lambda feature: feature["id"],
        "stac_next_link_key": "next",
    }
) as mosaic:

Breaking changes

3.0.0a13 (2020-10-13)

  • add TMS in BaseBackend to align with rio-tiler BaseBackend.

3.0.0a12 (2020-10-07)

Note: We changed the versioning scheme to {major}.{minor}.{path}{pre}{prenum}

3.0a11 (2020-09-21)

  • Raise Exception when trying to overwrite a mosaic (#112)
  • Add reverse option in .tile and .point to get values from assets in reversed order.

3.0a10 (2020-08-24)

  • Allow PointOutsideBounds exception for point method (#108)

3.0a9 (2020-08-24)

  • BaseBackend.center returns value from the mosaic definition (#105)

3.0a8 (2020-08-21)

  • BaseBackend is now a subclass of rio-tiler.io.base.BaseReader (add minzoom, maxzoom, bounds properties and info method)
  • use attr to define backend classes

Breaking changes

  • backend_options is now used to pass options (*kwargs) to the _read method

3.0a7 (2020-07-31)

  • update to rio-tiler 2.0b5

Breaking changes

  • 'value' -> 'values' in MosaicBackend.point output (#98)

3.0a6 (2020-07-31)

  • Use environement variable to set/disable cache (#93, autho @geospatial-jeff)
  • Allow Threads configuration for overview command (author @kylebarron)
  • add --in-memory/--no-in-memory to control temporary files creation for overview function.
  • allow pixel_selection method options for overview function.
  • update to rio-tiler 2.0b4
  • use new COGReader and STACReader to add .tile and .point methods directly in the backends

Breaking changes

  • backend.tile -> backend.assets_for_tile
  • backend.point -> backend.assets_for_point

3.0a5 (2020-06-29)

3.0a4 (2020-06-25)

  • add STACBackend (#82)
  • fix backends caching and switch to TTL cache (#83)

3.0a3 (2020-05-01)

  • add Upload CLI (#74, author @kylebarron)
  • fix boto3 dynamodb exception (#75)

3.0a2 (2020-05-01)

  • Better mosaicJSON model testing and default center from bounds (#73, author @geospatial-jeff)

3.0a1 (2020-05-01)

This is a major version, meaning a lot of refactoring was done and may lead to breaking changes.

  • add quadkey_zoom option in CLI (#41, author @kylebarron)
  • use R-tree from pygeos for testing intersections (#43, author @kylebarron)

Breaking changes

2.0.1 (2020-01-28)

  • Bug fix, use pygeos from pypi instead of git repo

2.0.0 (2020-01-28) - Major refactor

  • remove stack related code (lambda handler, serverless)
  • switch to pygeos (#24)
  • bug fixes
  • add last pixel_method

1.0.0 (2019-12-13)

  • add tif output
  • fix overview creation
  • add other Web templates

0.3.0 (2019-11-07)

  • use aws lambda layer
  • add update_mosaic utility function
  • add /tiles/point endpoint to get points values from a mosaic
  • add logs for mosaic creation
  • add custom pixel methods
  • add custom color maps

Breaking changes

  • rename /mosaic/info/<mosaicid> to /mosaic/<mosaicid>/info

0.2.0 (2019-09-30)

  • update for lambda-proxy~=5.0 (#15)
  • add minimum_tile_cover option for mosaic creation (#16)
  • add tile_cover_sort option (#16)
  • add verbosity for cli

0.1.0 (2019-09-05)

  • add /create.html endpoint (#14)
  • update to remotepixel/amazonlinux docker image

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

cogeo_mosaic-8.0.0.tar.gz (33.7 kB view details)

Uploaded Source

Built Distribution

cogeo_mosaic-8.0.0-py3-none-any.whl (40.2 kB view details)

Uploaded Python 3

File details

Details for the file cogeo_mosaic-8.0.0.tar.gz.

File metadata

  • Download URL: cogeo_mosaic-8.0.0.tar.gz
  • Upload date:
  • Size: 33.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.2

File hashes

Hashes for cogeo_mosaic-8.0.0.tar.gz
Algorithm Hash digest
SHA256 04ed86b84da3be606e87248d565b6cbc423fd153400e9a763edfae0af4a099ae
MD5 fb9ed5986c75ec4b54f5336e4c3aeabd
BLAKE2b-256 2528302c4eb67bbdb09df40896055dac108347a4f8209f8b54598ca076e8e297

See more details on using hashes here.

File details

Details for the file cogeo_mosaic-8.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cogeo_mosaic-8.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 551e0ad8629ce3005f96c0a4931b7243e6d22bc2be067435be4f913df34b33c5
MD5 440e92c4d152d917f4f88d9fc1afb4c5
BLAKE2b-256 2573b958c5009640ead469cb30b82378a81e3a5d1a8db6b566c1d53ef1c65b96

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