@basemaps/cli-raster
Advanced tools
CLI to retile imagery into a [Cloud Optimised Geotiffs (COG)](https://www.cogeo.org/) aligned to a [TileMatrix](https://www.ogc.org/standard/tms/)
CLI to retile imagery into a Cloud Optimised Geotiffs (COG) aligned to a TileMatrix
LINZ gets most of it's imagery delivered as tiles in NZTM2000 the imagery is tiled as rectangles against a tile grid such as the 1:5k or 1:1k.
These grids are not designed for use in XYZ tiles services in WebMercator/EPSG:3857, If the tiles were converted directly to WebMercator there would be significant overlap between multiple source imagery tiffs and a output WebMercator tile. This would cause large overheads for basemaps to render tiles as it would need to fetch data from all of the tiffs inside of the output tile.
Above is an example of a web mercator zoom 11 tile (Red outline) and the number 1:5k tiles required to render (Shaded black) it
This package contains the logic to process input imagery into a output Tile Matrix to create optimised COGs for web mapping purposes.
The output COGS perfectly align to a output tile, greatly increasing XYZ tile service performance.
To convert imagery to optimized COG, a output tile cover is created, this covers the source imagery in tiles from the output tile matrix.
cogify cover --tile-matrix WebMercatorQuad s3://linz-imagery/.../porirua_2020_0.1m --target ./output
The metadata for the optimized COGS is written into the output folder where the COG creation step can use GDAL to create the output tiff.
cogify create ./output/WebMercatorQuad/porirua_2020_0.1m/01GY8W69EJEMAKKXNHYMRF7DCY/14-16150-10245.json
The output COG can be validated to ensure it matches the tile exactly.
cogify validate --tile-matrix WebMercatorQuad ./output/WebMercatorQuad/porirua_2020_0.1m/01GY8W69EJEMAKKXNHYMRF7DCY/14-16150-10245.tiff
Install cogify using npm
npm install -g @basemaps/cli-raster
$ cogify --help
- cover - Create a covering configuration from a collection from source imagery
- create - Create a COG from a covering configuration
Create a tile covering for WebMeractorQuad from source imagery located in s3 and outputs the resulting configuration files into ./output/:projection/:imageryName/:id/collection.json
cogify cover --tile-matrix WebMercatorQuad s3://linz-imagery/new-zealand/north-island_2023_0.5m/rgb/2193/ --target ./output
Create the first COG from the list
cogify create ./output/3857/north-island_2023_0.5m/:id/14-16150-10245.json
FAQs
CLI to retile imagery into a [Cloud Optimised Geotiffs (COG)](https://www.cogeo.org/) aligned to a [TileMatrix](https://www.ogc.org/standard/tms/)
The npm package @basemaps/cli-raster receives a total of 24 weekly downloads. As such, @basemaps/cli-raster popularity was classified as not popular.
We found that @basemaps/cli-raster demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ECMAScript 2025 introduces Iterator Helpers, Set methods, JSON modules, and more in its latest spec update approved by Ecma in June 2025.
Security News
A new Node.js homepage button linking to paid support for EOL versions has sparked a heated discussion among contributors and the wider community.
Research
North Korean threat actors linked to the Contagious Interview campaign return with 35 new malicious npm packages using a stealthy multi-stage malware loader.