Skip to content

Commit

Permalink
update doc about cog
Browse files Browse the repository at this point in the history
  • Loading branch information
sharkAndshark committed Dec 17, 2024
1 parent 3900817 commit d716eb1
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions docs/src/sources-cog-files.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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:

Expand Down Expand Up @@ -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.

0 comments on commit d716eb1

Please sign in to comment.