Skip to content
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.

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

RADD Alerts #643

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
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
106 changes: 106 additions & 0 deletions catalog/WUR/WUR_radd_alerts.jsonnet
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
local id = 'WUR/radd_alerts';
Copy link
Collaborator

Choose a reason for hiding this comment

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

We are starting to allow users add their assets to the catalog under their original ids (eg, projects/radar-wur/raddalert/v1'). Would you like to do that?

Copy link
Author

Choose a reason for hiding this comment

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

What is the benefit of having the assets listed under their original ids?

local ee_const = import 'earthengine_const.libsonnet';
local ee = import 'earthengine.libsonnet';
local spdx = import 'spdx.libsonnet';
local units = import 'units.libsonnet';
local versions = import 'versions.libsonnet';

local subdir = 'WUR';

local basename = std.strReplace(id, '/', '_');
local base_filename = basename + '.json';
local self_ee_catalog_url = ee_const.ee_catalog_url + basename;

local license = spdx.cc_by_4_0;

{
stac_version: ee_const.stac_version,
type: ee_const.stac_type.collection,
stac_extensions: [
ee_const.ext_eo,
ee_const.ext_sci,
ee_const.ext_ver,
],
id: id,
title: 'RADD forest disturbance alerts v1',
version: 'v1',
'gee:type': ee_const.gee_type.image_collection,
description: |||
Radar satellite imagery from the European Space Agency’s Sentinel-1 mission is used to map new disturbances in primary humid tropical forest at 10 m spatial scale and in near real-time. Sentinel-1’s cloud-penetrating radar provides gap-free observations for the tropics consistently every 6 to 12 days. A new forest disturbance alert is triggered (low confidence alerts) based on a single observation from the latest Sentinel-1 image. Subsequent observations are used to increase confidence and confirm (high confidence alerts) or reject the alert. RADD (Radar for Detecting Deforestation) alerts are operational for the pan-tropics (50 countries) and updated weekly.
The dataset provides a RADD alert layer (alert confidence and alert date) and a primary tropical forest baseline mask, separately for four geographies: Central America, South America, Africa, and Asia (Insular Southeast-Asia and parts of the Pacific).
Copy link
Collaborator

Choose a reason for hiding this comment

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

no comma before "separately"

Copy link
Author

Choose a reason for hiding this comment

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

fixed

Documentation:
- RADD alert website (resources, versions and method updates).
Copy link
Collaborator

Choose a reason for hiding this comment

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

if this is just http://radd-alert.wur.nl/, you don't need to mention it - it's already in the provider section. You are welcome to link to a specific page here, but please use a markdown link

Copy link
Author

Choose a reason for hiding this comment

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

RADD alert website was removed here

- Reference paper – Reiche et al., 2021 “Forest disturbance alerts for the Congo Basin using Sentinel-1”, Environmental Research Letters, [https://doi.org/10.1088/1748-9326/abd0a8] (https://doi.org/10.1088/1748-9326/abd0a8)
Copy link
Collaborator

Choose a reason for hiding this comment

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

also not needed - it's already in the citation section

Copy link
Author

Choose a reason for hiding this comment

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

Citation was removed here

|||,
license: license.id,
links: ee.standardLinks(subdir, id),
keywords: [
'deforestation',
'forest',
'radar',
'sentinel',
'wur',
Copy link
Collaborator

Choose a reason for hiding this comment

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

please add this keyword commented-out - we recommend to avoid adding keywords when there's just one instance

Copy link
Author

Choose a reason for hiding this comment

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

fixed

],
providers: [
ee.producer_provider('Radar remote sensing group, Wageningen University and Research (WUR)', 'http://radd-alert.wur.nl/'),
ee.host_provider(self_ee_catalog_url),
],
extent: ee.extent_global('2019-01-01T00:00:00Z', '2024-01-01T00:00:00Z'),
summaries: {
gsd: [
30.92,
],
'eo:bands': [
{
name: 'Alert',
description: |||
Low confidence (pixel value 2) and High confidence alerts (pixel value 3). Disturbances are defined as the complete or partial removal of tree cover within a 10 m Sentinel-1 pixel.
|||,
},
{
name: 'Date',
description: |||
YYDOY (Year-Year-Day-Of-Year). Date of image that triggered the alert. Africa 19000 (Alerts start in 2019-01-01) and other geographies 20000 (Alerts start in 2020-01-01)
|||,
}
{
name: 'forest_baseline',
Copy link
Collaborator

Choose a reason for hiding this comment

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

Eg, on projects/radar-wur/raddalert/v1/africa_20230201 I only see Date and Alert. Which assets have forest_baseline?

Also, there should be a comma on line 65 before the forest_baseline section

Copy link
Author

Choose a reason for hiding this comment

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

We fixed the comma issue in line 65.

Regarding the forest baseline map:
The RADD alerts are structured as Multiband images in an imagecollection for four regions.
For each region the weekly updates are added to the imagecollection as multi-band images with the bands 'Alert' and 'Date'. The forest baseline map is a static layer for each of the four regions within the said Imagecollection. So there are four singleband images in the collection representing the forest baseline four regions. The band in the respective images are called 'Constant'. That's how the RADD alerts architecture is designed. Does that work for you and how could that be addressed?

description: |||
Primary humid tropical forest mask compiled from Turubanova et al (2018) with 2001-2019 (2001-2018 for Africa) forest loss (Hansen et al 2013) and mangrove (Bunting et al 2018) removed
|||,
}
],
'gee:visualizations': [
{
display_name: 'RADD alert',
lookat: {
lat: -6.5,
lon: -75.5,
zoom: 12,
},
image_visualization: {
band_vis: {
min: [
2,
],
max: [
3,
],
palette: [
'blue',
'coral',
],
bands: [
'Alert',
],
},
},
},
],
},
'sci:citation': |||
Reiche J, Mullissa A, Slagter B, Gou Y, Tsendbazar N, Odongo-Braun C, Vollrath A, Weisse M, Stolle F, Pickens A, Donchyts G, Clinton N, Gorelick N & Herold M, (2021), Forest disturbance alerts for the Congo Basin using Sentinel-1, Environmental Research Letters, https://doi.org/10.1088/1748-9326/abd0a8.
Copy link
Collaborator

Choose a reason for hiding this comment

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

please write DOI as a link:
[https://doi.org/10.1088/1748-9326/abd0a8] (https://doi.org/10.1088/1748-9326/abd0a8)

Copy link
Author

Choose a reason for hiding this comment

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

fixed

|||,
'gee:terms_of_use': ee.gee_terms_of_use(license),
'gee:user_uploaded': true,
}
23 changes: 23 additions & 0 deletions catalog/WUR/catalog.jsonnet
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
local id = 'WUR';
local ee_const = import 'earthengine_const.libsonnet';
local ee = import 'earthengine.libsonnet';

local basename = 'catalog';
local base_filename = basename + '.json';
local base_url = ee_const.catalog_base + 'WUR/';
local parent_url = ee_const.catalog_base + 'catalog.json';
local self_url = base_url + base_filename;

{
stac_version: ee_const.stac_version,
type: ee_const.stac_type.catalog,
id: id,
title: id,
description: importstr 'description.md',
links: [
ee.link.root(),
ee.link.parent(parent_url),
ee.link.self_link(self_url),
ee.link.child_collection('WUR_radd_alerts', base_url),
],
}
2 changes: 2 additions & 0 deletions catalog/WUR/description.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Datasets from the
[RAdar for Detecting Deforestation (RADD)](http://radd-alert.wur.nl/) group at [Wagenignen University](http://wur.eu/grs/).
1 change: 1 addition & 0 deletions catalog/catalog.jsonnet
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,7 @@ local self_url = base_url + base_filename;
ee.link.child_catalog('WHRC', base_url),
ee.link.child_catalog('WORLDCLIM', base_url),
ee.link.child_catalog('WRI', base_url),
ee.link.child_catalog('WUR', base_url),
ee.link.child_catalog('WWF', base_url),
ee.link.child_catalog('WorldPop', base_url),
ee.link.child_catalog('YALE', base_url),
Expand Down
14 changes: 14 additions & 0 deletions examples/WUR/WUR_radd_alerts.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
var radd = ee.ImageCollection('projects/radar-wur/raddalert/v1');
Copy link
Collaborator

Choose a reason for hiding this comment

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

Copy link
Author

Choose a reason for hiding this comment

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

added a preview script for the thumbnail alongside the original example script.

var geography = 'sa' // 'ca' (central america), 'sa' (south america), 'africa' (africa), 'asia' (asia & pacific)
Copy link
Collaborator

Choose a reason for hiding this comment

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

please add a monochrome (eg, white) background image to hide the basemap

eg, https://github.com/google/earthengine-catalog/blob/main/examples/NASA/NASA_NASADEM_HGT_001.js

Copy link
Author

Choose a reason for hiding this comment

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

Added a white background in the example script

var forest_baseline = ee.Image(radd.filterMetadata('layer','contains','forest_baseline')
.filterMetadata('geography','equals',geography).first())
Map.addLayer(forest_baseline, {palette:['black'], opacity: 0.3},'Forest baseline')
var radd_alert = ee.Image(radd.filterMetadata('layer','contains','alert')
.filterMetadata('geography','equals',geography)
.sort('system:time_end', false).first());
Map.addLayer(radd_alert.select('Alert'), {min:2,max:3,palette:['blue','coral']}, 'RADD alert')
Map.addLayer(radd_alert.select('Date'), {min:19000,max:23000, palette: ['ffffcc','800026']}, 'RADD alert date')
if (geography =='ca') {Map.setCenter(-89.11, 16.91,12)}
if (geography =='sa') {Map.setCenter(-75.5,-6.5,12)}
if (geography =='africa') {Map.setCenter(16,4,12)}
if (geography =='asia') {Map.setCenter(133.1,-3.2,12)}