import xarray as xr
import hvplot.xarray
import cartopy.crs as ccrs
Downsample zarr
xarray
and dask
with data from SMAP
Run this notebook
You can launch this notebook in VEDA JupyterHub by clicking the link below.
Launch in VEDA JupyterHub (requires access)
Learn more
Inside the Hub
This notebook was written on the VEDA JupyterHub and as such is designed to be run on a jupyterhub which is associated with an AWS IAM role which has been granted permissions to the VEDA data store via its bucket policy. The instance used provided 16GB of RAM.
See (VEDA Analytics JupyterHub Access)[https://nasa-impact.github.io/veda-docs/veda-jh-access.html] for information about how to gain access.
Outside the Hub
The data is in a protected bucket. Please request access by emailng aimee@developmentseed.org or alexandra@developmentseed.org and providing your affiliation, interest in or expected use of the dataset and an AWS IAM role or user Amazon Resource Name (ARN). The team will help you configure the cognito client.
You should then run:
%run -i 'cognito_login.py'
Approach
This notebook demonstrates 2 strategies for resampling data from a Zarr dataset in order to visualize within the memory limits of a notebook.
- Downsample the temporal resolution of the data using
xarray.DataArray.resample
- Coarsening the spatial resolution of the data using
xarray.DataArray.coarsen
A strategy for visualizing any large amount of data is Datashader
which bins data into a fixed 2-D array. Using the rasterize
argument within hvplot
calls ensures the use of the datashader library to bin the data. Optionally an external Dask
cluster is used to parallelize and distribute these large downsampling operations across compute nodes.
About the data
The SMAP mission is an orbiting observatory that measures the amount of water in the surface soil everywhere on Earth.
Load libraries
Optional: Create and Scale a Dask Cluster
We create a separate Dask cluster to speed up reprojecting the data (and other potential computations which could be required and are parallelizable).
Note if you skip this cell you will still be using Dask, you’ll just be using the machine where you are running this notebook.
from dask_gateway import GatewayCluster, Gateway
= Gateway()
gateway = gateway.list_clusters()
clusters
# connect to an existing cluster - this is useful when the kernel shutdown in the middle of an interactive session
if clusters:
= gateway.connect(clusters[0].name)
cluster else:
= GatewayCluster(shutdown_on_close=True)
cluster
16)
cluster.scale(= cluster.get_client()
client client
Client
Client-f633df20-5c0c-11ef-92ac-860c0d05aa65
Connection method: Cluster object | Cluster type: dask_gateway.GatewayCluster |
Dashboard: /services/dask-gateway/clusters/prod.f63d365675734e2ba2dee10ae8769a7c/status |
Cluster Info
GatewayCluster
- Name: prod.f63d365675734e2ba2dee10ae8769a7c
- Dashboard: /services/dask-gateway/clusters/prod.f63d365675734e2ba2dee10ae8769a7c/status
Open the dataset from S3
= xr.open_zarr("s3:///veda-data-store-staging/EIS/zarr/SPL3SMP.zarr")
ds ds
<xarray.Dataset> Size: 68GB Dimensions: (northing_m: 406, easting_m: 964, datetime: 1679) Coordinates: * datetime (datetime) datetime64[ns] 13kB 2018-01-01 ... * easting_m (easting_m) float64 8kB -1.735e+07 ... 1.7... * northing_m (northing_m) float64 3kB 7.297e+06 ... -7.... Data variables: (12/26) albedo (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> albedo_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> bulk_density (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> bulk_density_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> clay_fraction (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> clay_fraction_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> ... ... static_water_body_fraction (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> static_water_body_fraction_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> surface_flag (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> surface_flag_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> surface_temperature (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray> surface_temperature_pm (northing_m, easting_m, datetime) float32 3GB dask.array<chunksize=(100, 100, 100), meta=np.ndarray>
Select the variable of interest (soil moisture for this example).
= ds.soil_moisture
soil_moisture soil_moisture
<xarray.DataArray 'soil_moisture' (northing_m: 406, easting_m: 964, datetime: 1679)> Size: 3GB dask.array<open_dataset-soil_moisture, shape=(406, 964, 1679), dtype=float32, chunksize=(100, 100, 100), chunktype=numpy.ndarray> Coordinates: * datetime (datetime) datetime64[ns] 13kB 2018-01-01 ... 2022-09-09 * easting_m (easting_m) float64 8kB -1.735e+07 -1.731e+07 ... 1.735e+07 * northing_m (northing_m) float64 3kB 7.297e+06 7.26e+06 ... -7.297e+06 Attributes: long_name: Representative DCA soil moisture measurement for the Earth ba... units: cm**3/cm**3 valid_max: 0.5 valid_min: 0.019999999552965164
Strategy 1: Downsample the temporal resolution of the data
To plot one day from every month, resample the data to 1 observation a month.
= soil_moisture.resample(datetime="1ME").nearest() somo_one_month
Quick plot
We can generate a quick plot using hvplot
and datashader
.
# workaround to avoid warnings that are triggered within Dask.
import warnings
warnings.filterwarnings("ignore", message="All-NaN slice encountered", category=RuntimeWarning
)
somo_one_month.hvplot(="easting_m",
x="northing_m",
y="datetime",
groupby=ccrs.epsg(6933), # this is a workaround for https://github.com/holoviz/hvplot/issues/1329
crs=True,
rasterize=True,
coastline="mean",
aggregator=400,
frame_height="bottom",
widget_location )