Skip to content

Commit

Permalink
Merge pull request #63 from Geomatys/master
Browse files Browse the repository at this point in the history
Add Apache SIS in the list of libraries supporting COG.
  • Loading branch information
cholmes authored Oct 18, 2023
2 parents 31c72c9 + 90009a8 commit 087096e
Show file tree
Hide file tree
Showing 2 changed files with 3 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
1 change: 1 addition & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -187,6 +187,7 @@ <h2>Libraries</h2>
<li><a href="https://github.com/mapbox/rasterio">Rasterio</a> wraps the powerful features of GDAL in idiomatic Python functions and classes. Their latest release <a href="https://blog.mapbox.com/build-for-the-cloud-with-rasterio-3254d5d60289">includes a number of features</a> to optimize cloud geotiff access. See their <a href="https://gist.github.com/sgillies/7e5cd548110a5b4d45ac1a1d93cb17a3">Advanced Rasterio Features Notebook</a> for truly excellent documentation on working with COG's.</li>
<li><a href="http://geotrellis.io">GeoTrellis</a> is a scalable Scala geospatial library, that can create and read Cloud Optimized GeoTIFF's. Head over to the <a href="https://geotrellis.readthedocs.io/en/latest/guide/core-concepts.html?highlight=cloud%20optimized#cloud-optimized-geotiffs">documentation.</a> And check out <a href="https://twitter.com/echeipesh"> Eugene Cheipesh's</a> <a href="https://www.slideshare.net/EugeneCheipesh/cloud-optimized-geottiffs-enabling-efficient-cloud-workflows">FOSS4G-NA 2018 talk on COGs.</a>
<li><a href="http://geotools.org">GeoTools</a> is the leading Java geospatial library, and it supports COG's with the <a href="https://github.com/geotools/geotools/tree/master/modules/unsupported/s3-geotiff">s3-geotiff</a> module.
<li><a href="https://sis.apache.org">Apache Spatial Information System (SIS)</a> is a Java geospatial library capable to read COG files over HTTP or S3. COG images can be part of a chain of operations such as raster reprojection, which will read only the tiles requested by the final output.
<li><a href="http://www.orfeo-toolbox.org">Orfeo ToolBox</a> All Orfeo ToolBox applications can read cloud optimized geotiffs through GDAL (simply prefix file url with /vsicurl/)</li>

</ul>
Expand Down

0 comments on commit 087096e

Please sign in to comment.