Docs add rustac quickstart#319
Draft
aboydnw wants to merge 5 commits into
Draft
Conversation
Companion notebook for the rustac tutorial: queries the Sentinel-2 L2A STAC-GeoParquet snapshot over Portland via rustac's bundled DuckDB engine, with property filters, an Arrow/Parquet write, and a GeoPandas bridge. Verified end-to-end against the live Planetary Computer. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a Key benefits list and a We'll setup line to the intro, and close with a You're done recap, matching the lonboard quickstart's structure. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…l-quickstart reference) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
gadomski
requested changes
Jul 2, 2026
Comment on lines
+57
to
+61
| "import pystac_client\n", | ||
| "\n", | ||
| "catalog = pystac_client.Client.open(\"https://planetarycomputer.microsoft.com/api/stac/v1\")\n", | ||
| "asset = catalog.get_collection(\"sentinel-2-l2a\").assets[\"geoparquet-items\"]\n", | ||
| "asset.href" |
Collaborator
There was a problem hiding this comment.
Since this is a rustac tutorial, we can use rustac to search as well.
Comment on lines
+44
to
+48
| "## Find the GeoParquet snapshot", | ||
| "", | ||
| "Every Planetary Computer collection carries a collection-level `geoparquet-items` asset that points at its STAC-items snapshot. The href resolves to a directory of monthly `part-NNNN` Parquet files on the `pcstacitems` storage account.", | ||
| "", | ||
| "**Expected result:** `abfs://items/sentinel-2-l2a.parquet`." |
Collaborator
There was a problem hiding this comment.
It might be useful to list the partition files, e.g. with obstore.
from obstore.auth.planetary_computer import PlanetaryComputerCredentialProvider
from obstore.store import AzureStore
store = AzureStore(
credential_provider=PlanetaryComputerCredentialProvider(
"https://pcstacitems.blob.core.windows.net/items"
)
)
for list_stream in store.list(prefix="sentinel-2-l2a.parquet"):
for object_meta in list_stream:
print(object_meta)| "outputs": [], | ||
| "source": [ | ||
| "items = client.search(\n", | ||
| " SNAPSHOT,\n", |
Collaborator
There was a problem hiding this comment.
Since we're narrowing the datetime, we could show how you can speed up the query by narrowing the glob to something like az://items/sentinel-2-l2a.parquet/part-*_2017-*.parquet.
- add an obstore cell listing the partition files - show glob narrowing (part-*_2017-*.parquet) to skip partitions, ~3x faster - call them partition files, not part files - clarify the SAS-token sentence; expand the acronym - note the search scans every partition with no index - trim the closing recap Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Draft rustac quickstart notebook: filter, export, and GeoPandas-bridge Sentinel-2 items from the GeoParquet snapshot.
Related to the tutorial pr here: microsoft/PlanetaryComputerDataCatalog#533