Code Examples for the Common Cases in Multiple Languages

[wildintellect]

There are 2 main users stories: Data Producers and Data Users

• Each of these groups needs some examples (overlapping if a User then becomes a Producer)
  • Producer - Making data in the format
  • User - Reading data in a cloud-optimized way
• The examples need to exist in several languages, some are better for Producers and others Users
  • Producer - Python, R, Julia?, Commandline GDAL/OGR?
  • Users - Python, R, Julia, Javascript, Commandline GDAL/OGR?

The matrix of Producer/User * Language * Format = number of code samples

Level 2 would be to also include various common authentication issues, also in all the languages.

• rasterio/GDAL env variables
• S3/Azure/GCP
• NASA/USGS EarthData
• ESA SentinelHub?
• Planetary Computer

As pointed out in #83 using quarto tabsets would be a nice way to keep adding languages as people make examples for the same thing.

[wildintellect]

Generally we should defer the STAC portion to https://stacspec.org/en/tutorials/ with the exception if STAC results are the input to the loading (e.g. stackstac). So we should start with knowing the URL to the item we want to read.

Also depth examples that do more than just read parts of a file should find similar appropriate homes like
https://projectpythia.org/
Maybe R depth examples can go to https://r-spatial.org

[wildintellect]

Quick check, we're looking at up to 72 code examples with the proposed options (not all may be valid)
9 languages(across 2 use types) * 8 = 72

[wildintellect]

Note for R examples:

• client https://github.com/brazil-data-cube/rstac
• NASA EarthData login library (newish) https://github.com/boettiger-lab/earthdatalogin
• Terra automatically applies vsis3 to s3:// urls, and has vsi=TRUE to trigger vsicurl usage