Merge branch 'staging' into feature/python-cog-access

Author: wildintellect

.github/workflows/preview.yml

@@ -14,7 +14,7 @@ concurrency: preview-${{ github.ref }}
 
 jobs:
   deploy-preview:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v3

_quarto.yml

@@ -14,7 +14,7 @@ website:
   page-footer:
     right: "This page is built with ❤️ and [Quarto](https://quarto.org/)."
     center: '<a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>. <img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1"><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1">'
-    left: '&copy; [Cloud-Native Geospatial Foundation](https://cloudnativegeo.org/), 2023'
+    left: '&copy; [Cloud-Native Geospatial Forum](https://cloudnativegeo.org/), 2023'
   sidebar:
     pinned: true
     align: center
@@ -41,6 +41,8 @@ website:
           - cloud-optimized-geotiffs/cogs-overview_resampling.ipynb
           - cloud-optimized-geotiffs/accessing-cogs-in-python.ipynb
           - cloud-optimized-geotiffs/writing-cogs-in-python.ipynb
+          - cloud-optimized-geotiffs/accessing-cogs-in-r-stars.ipynb
+          - cloud-optimized-geotiffs/accessing-cogs-in-r-terra.ipynb
         - section: Zarr
           contents:
           - zarr/intro.qmd
@@ -73,6 +75,15 @@ website:
         text: Glossary
       - href: cookbooks/index.qmd
         text: Cookbooks
+        contents:
+        - text: Zarr Visualization Report ↗
+          href: https://nasa-impact.github.io/zarr-visualization-report/
+        - section: Zarr + STAC Report
+          contents:
+            - cookbooks/zarr-stac-report/index.qmd
+            - cookbooks/zarr-stac-report/data-producers/index.qmd
+            - cookbooks/zarr-stac-report/data-consumers/index.qmd
+
       - href: contributing.qmd
         text: Get Involved
 

_thankyous.qmd

@@ -4,10 +4,10 @@
 
 This guide has been made possible through the support of:
 
-::: {layout="[15,-5,25,-3,20]" layout-valign="center"}
+::: {layout="[15,-5,25,-3,15]" layout-valign="center"}
 [![](./images/thankyous-impact-logo.png){fig-alt="NASA Impact Logo" fig-align="left" width=40%}](https://impact.earthdata.nasa.gov)
 
 [![](./images/thankyous-devseed-logo.png){fig-alt="Development Seed Logo" fig-align="left" width=40%}](https://developmentseed.org)
 
-[![](./images/thankyous-cng-logo.png){fig-alt="Cloud-Native Geospatial Foundation" fig-align="left" width=40%}](https://cloudnativegeo.org)
+[![](./images/thankyous-cng-logo.png){fig-alt="Cloud-Native Geospatial Forum" fig-align="left" width=40%}](https://cloudnativegeo.org)
 :::

cloud-optimized-geotiffs/accessing-cogs-in-r-stars.ipynb

@@ -13,3 +13,7 @@ dependencies:
   - boto3
   - numpy
   - rio-xarray
+  - r-base
+  - r-essentials
+  - r-terra
+  - r-stars

cloud-optimized-geotiffs/accessing-cogs-in-r-terra.ipynb

@@ -8,7 +8,7 @@ Cloud-Optimized GeoTIFF (COG), a raster format, is a variant of the TIFF image f
 
 For more details see [https://www.cogeo.org/](https://www.cogeo.org/)
 
-<img alt="COG Diagram" src="../images/cog-diagram-1.png" width=300/>
+<img alt="COG Diagram" src="../images/cog-diagram-2.png" width=100%/>
 
 ## Dimensions
 

cloud-optimized-geotiffs/environment.yml

@@ -1,7 +1,7 @@
 ---
 title: Cloud-Optimized HDF/NetCDF
 bibliography: references.bib
-author: Aimee Barciauskas, Alexey Shikmonalov, Luis Lopez
+author: Aimee Barciauskas, Alexey Shiklomanov, Luis Lopez
 toc-depth: 3
 ---
 
@@ -140,7 +140,7 @@ For example, the following library defaults will impact performance and may be i
 * HDF5 library:
     * **Chunk cache:** The size of the HDF5's chunk cache by default is 1MB. This value is configurable. Chunks that don't fit into the chunk cache are discarded and must be re-read from the storage location each time. See also: [Improve HDF5 performance using caching](https://www.hdfgroup.org/2022/10/17/improve-hdf5-performance-using-caching/) and [h5py documentation: Chunk cache](https://docs.h5py.org/en/stable/high/file.html#chunk-cache).
     * **Page buffer size:** The [H5Pset_page_buffer_size](https://hdfgroup.github.io/hdf5/develop/group___f_a_p_l.html#title89) and [the page_buf_size argument to h5py.File](https://docs.h5py.org/en/stable/high/file.html) should match up with the page size to optimize reading the data in pages.
-* S3FS library: The S3FS library is a popular library for accessing data on AWS's cloud object storage S3. It has a default block size of 5MB ([S3FS API docs](https://s3fs.readthedocs.io/en/stable/api.html#s3fs.core.S3FileSystem)).
+* S3FS library: The S3FS library is a popular library for accessing data on AWS's cloud object storage S3. Note that S3FS has a default block size, which may change, so please refer to the [S3FS API docs](https://s3fs.readthedocs.io/en/stable/api.html#s3fs.core.S3FileSystem) for the default setting. And note it can be set upon instantiation of an S3FileSystem object.
 * Additional guidance on h5py, fsspec, and ROS3 libraries for creating and reading HDF5 can be found in @jelenak2024.
 
 ### Additional research

cloud-optimized-geotiffs/intro.qmd

@@ -10,6 +10,18 @@ We encourage contributions to this guide. The guide's goal is to provide documen
 
 If you wish to preview the site locally, install [quarto](https://quarto.org/). You will also need to be familiar with [quarto markdown](https://quarto.org/docs/authoring/markdown-basics.html).
 
+## Contribution Workflow
+
+Due to previews only working from branches within the repository and not external forks (see: [#74](https://github.com/cloudnativegeo/cloud-optimized-geospatial-formats-guide/issues/74)), all PRs should target staging. More specifically, the contribution workflow follows these steps:
+
+1. PR is made with `staging` as target.
+
+2. Maintainer will merge the PR to staging and then open a PR to main (build preview will run).
+
+3. Maintainers merge to main which triggers the production deployment.
+
+The process is not ideal, and we are open to suggestions on how to improve upon it. The main constraint is the [`pr-preview-action`](https://github.com/rossjrw/pr-preview-action) not supporting previews on external contributions. 
+
 ## Communication Channels
 
 Discussions can occur in [GitHub Discussions](https://github.com/cloudnativegeo/cloud-optimized-geospatial-formats-guide/discussions) and issues can be raised at [GitHub Issues](https://github.com/cloudnativegeo/cloud-optimized-geospatial-formats-guide/issues).

cloud-optimized-netcdf4-hdf5/index.qmd

@@ -11,3 +11,4 @@ Cookbooks should address common questions and present solutions for cloud-optimi
 Cookbooks:
 
 * [Zarr Visualization Report (in development)](https://nasa-impact.github.io/zarr-visualization-report/)
+* [Zarr + STAC Report (in development)](./zarr-stac-report/index.qmd)