Skip to content

Commit

Permalink
Nuance the claim that GDAL is the easiest way to read COG by adding "…
Browse files Browse the repository at this point in the history
…For C/C++ or Python developers" in the sentence.

Add a paragraph for Java developers in the developers guide, with GeoTools and Apache SIS cited as examples.
  • Loading branch information
desruisseaux committed Oct 12, 2023
1 parent 7d5092b commit 90009a8
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion developers-guide.html
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@ <h3>Introduction</h3>
contributing then please make pull requests on the <a href="https://github.com/cholmes/www.cogeo.org">Github Project</a>. In the meantime this document will just link to a few other resources</p>

<h3>Reading a Cloud Optimized GeoTIFF</h3>
<p>The easiest way to read a COG in a way that takes advantage of its unique properties is to use GDAL and its <a href="https://gdal.org/user/virtual_file_systems#network-based-file-systems">VSI Curl</a> functionality. See the GDAL Wiki on Cloud Optimized GeoTIFF in its <a href="https://trac.osgeo.org/gdal/wiki/CloudOptimizedGeoTIFF#HowtoreaditwithGDAL">How to read it with GDAL</a> section. A majority of geospatial software in the world uses GDAL as a library, so incorporating it is likely the fastest way to incorporate COG reading in to your software.</p>
<p>For C/C++ or Python developers, the easiest way to read a COG in a way that takes advantage of its unique properties is to use GDAL and its <a href="https://gdal.org/user/virtual_file_systems#network-based-file-systems">VSI Curl</a> functionality. See the GDAL Wiki on Cloud Optimized GeoTIFF in its <a href="https://trac.osgeo.org/gdal/wiki/CloudOptimizedGeoTIFF#HowtoreaditwithGDAL">How to read it with GDAL</a> section. A majority of geospatial software in the world uses GDAL as a library, so incorporating it is likely the fastest way to incorporate COG reading in to your software.</p>
<p>Java developers may find more convenient to use pure Java readers that integrate well with the Java2D framework. Taking advantage of COG properties on file system, HTTP or S3 is possible for example with GeoTools and <a href="https://sis.apache.org/howto/rasters_bigger_than_memory.html">Apache SIS</a> libraries.</p>
<p><a href="http://planet.com">Planet</a> produces all its data as COG, and has a little tutorial on how to <a href="https://developers.planet.com/tutorials/download-a-subarea/">download part of an image</a> using VSI Curl. Most of the tutorial is specific to working with the Planet API, but it shows the use of GDAL Warp with a COG to extract a single farm field from a larger image.

<h3>How to generate a Cloud Optimized GeoTIFF</h3>
Expand Down

0 comments on commit 90009a8

Please sign in to comment.