Skip to content

Replace stackstac with odc-stac #270

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jsignell merged 2 commits into from
Mar 13, 2026
Merged

Replace stackstac with odc-stac #270

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b08e673
replace stackstac with odc-stac
tylanderson Mar 10, 2026
2a93487
update from review
tylanderson Mar 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion user-guide/content-curation/docs-and-notebooks.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ To present consistent best practices, we always access data via the STAC API.
#### Analyzing data

* [rioxarray](https://corteva.github.io/rioxarray/stable/): rasterio xarray extension
* [stackstac](https://stackstac.readthedocs.io/): stackstac.stack turns a STAC collection into a lazy xarray.DataArray, backed by dask.
* [odc-stac](https://odc-stac.readthedocs.io/): odc.stac.load turns a STAC collection into a lazy xarray.DataArray, backed by dask.


### Generate "Launch in VEDA JupyterHub" link
Expand Down
673 changes: 328 additions & 345 deletions user-guide/notebooks/datasets/nceo-biomass-statistics.ipynb
View file
Open in desktop

Large diffs are not rendered by default.

457 changes: 243 additions & 214 deletions user-guide/notebooks/quickstarts/open-and-plot.ipynb
View file
Open in desktop

Large diffs are not rendered by default.

1,641 changes: 1,641 additions & 0 deletions user-guide/notebooks/quickstarts/timeseries-rioxarray-odcstac.ipynb
View file
Open in desktop

Large diffs are not rendered by default.

2,520 changes: 0 additions & 2,520 deletions user-guide/notebooks/quickstarts/timeseries-rioxarray-stackstac.ipynb
View file
Open in desktop

This file was deleted.

1,392 changes: 568 additions & 824 deletions user-guide/notebooks/quickstarts/visualize-multiple-times.ipynb
View file
Open in desktop

Large diffs are not rendered by default.

19 changes: 7 additions & 12 deletions user-guide/notebooks/templates/template-accessing-the-data-directly.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@
"# include all your imports in this cell\n",
Copy link
Collaborator

@jsignell jsignell Mar 12, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need pandas anymore


Reply via ReviewNB

"import folium\n",
"import requests\n",
"import stackstac\n",
"import odc.stac\n",
"\n",
"from pystac_client import Client"
]
Expand Down Expand Up @@ -304,7 +304,7 @@
"source": [
"<div class=\"alert alert-block alert-success\">\n",
" \n",
"Next some notebooks read in the data. If you are using the raster API to trigger computation server side skip this section. Here is an example of reading the data in using `stackstac` and clipping using `rasterio`. \n",
"Next some notebooks read in the data. If you are using the raster API to trigger computation server side skip this section. Here is an example of reading the data in using `odc-stac` and clipping using `rasterio`. \n",
" \n",
"</div>"
]
Expand All @@ -318,7 +318,7 @@
"source": [
"## Read data\n",
"\n",
"Create an `xarray.DataSet` using `stackstac`"
"Create an `xarray.DataSet` using `odc-stac`"
]
},
{
Expand All @@ -338,12 +338,7 @@
"metadata": {},
"outputs": [],
"source": [
"# workaround for lack of stackstac support for projection extension v2\n",
"da = stackstac.stack(item_collection, epsg=4326)\n",
"\n",
"# assign the time coordinate to the start time\n",
"da = da.assign_coords({\"time\": pd.to_datetime(da.start_datetime)})\n",
"\n",
"da = odc.stac.load(item_collection, chunks={})\n",
"da"
]
},
Expand Down Expand Up @@ -395,7 +390,7 @@
"metadata": {},
"outputs": [],
"source": [
"data_band = da.sel(band=\"cog_default\")"
"data_band = da[\"cog_default\"]"
]
},
{
Expand All @@ -416,7 +411,7 @@
"outputs": [],
"source": [
"# Average over entire AOI for each month\n",
"means = data_band.mean(dim=(\"x\", \"y\")).compute()"
"means = data_band.mean(dim=(\"longitude\", \"latitude\")).compute()"
]
},
{
Expand Down Expand Up @@ -454,7 +449,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.12.10"
"version": "3.12.12"
}
},
"nbformat": 4,
Expand Down
Loading