From d716eb156592f634d0488e3341ee313b6574cb56 Mon Sep 17 00:00:00 2001 From: sharkAndshar Date: Tue, 17 Dec 2024 12:45:21 +0800 Subject: [PATCH] update doc about cog --- docs/src/sources-cog-files.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/src/sources-cog-files.md b/docs/src/sources-cog-files.md index ab6a3f73d..70ee4b9f7 100644 --- a/docs/src/sources-cog-files.md +++ b/docs/src/sources-cog-files.md @@ -1,6 +1,6 @@ # Cloud Optimized GeoTIFF File Sources -Martin can also serve raster source like local [COG(Cloud Optimized GeoTIFF)](https://cogeo.org/) files. For cog on remote like S3 and other improvements, you could track them on [issue 875](https://github.com/maplibre/martin/issues/875), we are working on and welcome any assistance. +Martin can also serve raster sources like local [COG(Cloud Optimized GeoTIFF)](https://cogeo.org/) files. For cog on remote like S3 and other improvements, you could track them on [issue 875](https://github.com/maplibre/martin/issues/875), we are working on and welcome any assistance. ## Supported colortype and bits per sample @@ -61,11 +61,11 @@ cog: [COG](https://cogeo.org/) is just Cloud Optimized GeoTIFF file. -TIFF is an image file format. TIFF tags are something like key-value pairs to describe the metadata about TIFF file, like `ImageWidth`, `ImageLength`.. etc. +TIFF is an image file format. TIFF tags are something like key-value pairs inside to describe the metadata about a TIFF file, ike `ImageWidth`, `ImageLength`, etc. -GeoTIFF is a valid TIFF file with a set of TIFF tags to describe "Cartographic" information associated with. +GeoTIFF is a valid TIFF file with a set of TIFF tags to describe the 'Cartographic' information associated with it. -And COG is a valid GeoTIFF file with some requirements for efficient reading. That is, all COG files are valid GeoTIFF files, but not all GeoTIFF files are valid COG files. For quick access to tiles in TIFF files, Martin relies on these requirements/recommendations(like the order of sub-files, and it must be tiled) so we use the term `COG` over `GeoTIFF` in our documentation and configuration files. +COG is a valid GeoTIFF file with some requirements for efficient reading. That is, all COG files are valid GeoTIFF files, but not all GeoTIFF files are valid COG files. For quick access to tiles in TIFF files, Martin relies on the requirements/recommendations(like the [requirement about Reduced-Resolution Subfiles](https://docs.ogc.org/is/21-026/21-026.html#_requirement_reduced_resolution_subfiles) and [the content dividing strategy](https://docs.ogc.org/is/21-026/21-026.html#_tiles)) so we use the term `COG` over `GeoTIFF` in our documentation and configuration files. You may want to visit these specs: @@ -101,4 +101,4 @@ So basically there's a mapping from zxy to tile of sub-file of TIFF. | Zoom level | which sub-file in TIFF file | | X and Y | which tile in subfile | -Clients could read only the header part of cog to figure out the mapping from zxy to the chunk number and the subfile number. And Martin get tile to frontend by this mapping. +Clients could read only the header part of COG to figure out the mapping from zxy to the chunk number and the subfile number. Martin get tile to frontend by this mapping.