data-access

Digital Earth Pacific (DEP) Data Access Documentation

Documentation of Digital Earth Pacific data organisation and access mechanisms via AWS Open Data Program.

Data Organisation

Digital Earth Pacific’s earth observation derived products are made accessible via the following integration services:

Product Type Data Format Service
Cloud Optimised GeoTiffs (COGs) Raster STAC, WMS, WMTS, WCS
Coastlines Multi-Year PolyLines Vector WMTS, XYZ

Data Descriptions

The data service URLs in this document will change in the near future, please refer back here for updated links and information.

STAC item records for the following COG products are available at DEP STAC Catalog Browser.

The includes data descriptions for the following DEP products:

Product Temporal Scale STAC Collection Name
Water Observations from Space (WoFS) 2013-2021 dep_ls_wofs
Mangroves Extent and Density 2017-202 dep_s2_mangroves
Sentinel-2 GeoMAD 2017-2024 dep_s2_geomad
Sentinel 1 GeoMAD 2017-2023 dep_s1_geomad
Pacific Intertidal Model 2024 dep_s2ls_intertidal
Satellite Derived Bathymetry 2023-2024 dep_s2_sdb

The DEP Coastlines Product from 2000-2023 is available via WFS and WMS services via DEP Tileserver.

Data Access Tutorials

File access

Direct access to data is available through our data browser or via the AWS CLI from the bucket at s3://dep-public-data, which is hosted in the us-west-2 zone on AWS.

Jupyter, Python and PySTAC-Client

STAC data items can be queried, visualised and/or downloaded using PySTAC-Client API within the DEP Analytical Hub or local Python/Jupyter environment.

The full STAC API for Digital Earth Pacific is accessible at DEP STAC API.

Below is an example for querying, plotting and downloading DEP Managroves Extent and Density product at a particular area of interest across all years.

from pystac.client import Client
from odc.stac import load

catalog = "https://stac.digitalearthpacific.org"  # DE Pacific STAC Catalog
collection = "dep_s2_mangroves"  # Collection for mangroves

# Define Coordinates, in lat, lon
lower_left = (-10.590125, 149.844629)
upper_right = (-10.360110, 150.195631)

bbox = (lower_left[1], lower_left[0], upper_right[1], upper_right[0])

# Find STAC Items
client = Client.open(catalog)
items = client.search(collections=[collection], bbox=bbox).item_collection()
print(f"Found {len(items)} items")

# Load STAC Items
data = load(items, bbox=bbox, bands=["mangroves"], chunks={})

# Plot Mangroves
data.mangroves.plot.imshow(
    col="time",
    col_wrap=4,
    levels=[0, 1, 2, 3],
    colors=["white", "yellow", "green", "darkgreen"],
)

# Save Mangroves as COG Tiles
for time in data.time.values:
    year = time.astype("datetime64[Y]")
    data_year = data.sel(time=year)
    data_year.mangroves.odc.write_cog(f"{collection}_{year}.tif")

A comprehensive tutorial on using PySTAC Client is available at https://pystac-client.readthedocs.io/

QGIS STAC Plugin

The QGIS STAC API Browser plugin can be used to query and visualise DEP earth observations COG products within QGIS.

To install the plugin, follow the below steps.

After launching the from the menu STAC API Browser Plugin > Open STAC API Browser register the following connection to access DEP products.

Name : DEP STAC API
URL  : https://stac.digitalearthpacific.org

Using the QGIS STAC Plugin to Access DEP Data

For more detailed information on how to use the plug-in please check out [documentation by STAC] (https://github.com/stac-utils/qgis-stac-plugin/blob/main/docs/user-guide.md).

Coastlines Data Download

The latest iteration of the DEP multi-year coastlines change data can be downloaded in GeoPackage format from AWS S3 Storage.

Support

For support and assistance on DEP data access, please contact dep@spc.int.