- Dataset Availability
- 2015-06-27T00:00:00Z–2024-11-21T17:05:29Z
- Dataset Provider
- European Union/ESA/Copernicus/SentinelHub
- Earth Engine Snippet
-
ee.ImageCollection("COPERNICUS/S2_CLOUD_PROBABILITY") - Tags
Description
The S2 cloud probability is created with the
sentinel2-cloud-detector
library (using LightGBM).
All bands are upsampled using bilinear interpolation to 10m resolution
before the gradient boost base algorithm is applied. The resulting
0..1 floating point probability is scaled to 0..100 and stored as
a UINT8. Areas missing any or all of the bands are masked out.
Higher values are more likely to be clouds or highly reflective surfaces
(e.g. roof tops or snow).
Sentinel-2 is a wide-swath, high-resolution, multi-spectral imaging mission supporting Copernicus Land Monitoring studies, including the monitoring of vegetation, soil and water cover, as well as observation of inland waterways and coastal areas.
The Level-2 data can be found in the collection COPERNICUS/S2_SR_HARMONIZED. The Level-1B data can be found in the collection COPERNICUS/S2_HARMONIZED. Additional metadata is available on assets in those collections.
See this tutorial explaining how to apply the cloud mask.
Bands
Bands
| Name | Min | Max | Pixel Size | Description |
|---|---|---|---|---|
probability |
0 | 100 | 10 meters | Probability that the pixel is cloudy. |
Terms of Use
Terms of Use
The use of Sentinel data is governed by the Copernicus Sentinel Data Terms and Conditions.
Explore with Earth Engine
Code Editor (JavaScript)
var s2Sr = ee.ImageCollection('COPERNICUS/S2_SR_HARMONIZED');
var s2Clouds = ee.ImageCollection('COPERNICUS/S2_CLOUD_PROBABILITY');
var START_DATE = ee.Date('2019-01-01');
var END_DATE = ee.Date('2019-03-01');
var MAX_CLOUD_PROBABILITY = 65;
var region =
ee.Geometry.Rectangle({coords: [-76.5, 2.0, -74, 4.0], geodesic: false});
Map.setCenter(-75, 3, 12);
function maskClouds(img) {
var clouds = ee.Image(img.get('cloud_mask')).select('probability');
var isNotCloud = clouds.lt(MAX_CLOUD_PROBABILITY);
return img.updateMask(isNotCloud);
}
// The masks for the 10m bands sometimes do not exclude bad data at
// scene edges, so we apply masks from the 20m and 60m bands as well.
// Example asset that needs this operation:
// COPERNICUS/S2_CLOUD_PROBABILITY/20190301T000239_20190301T000238_T55GDP
function maskEdges(s2_img) {
return s2_img.updateMask(
s2_img.select('B8A').mask().updateMask(s2_img.select('B9').mask()));
}
// Filter input collections by desired data range and region.
var criteria = ee.Filter.and(
ee.Filter.bounds(region), ee.Filter.date(START_DATE, END_DATE));
s2Sr = s2Sr.filter(criteria).map(maskEdges);
s2Clouds = s2Clouds.filter(criteria);
// Join S2 SR with cloud probability dataset to add cloud mask.
var s2SrWithCloudMask = ee.Join.saveFirst('cloud_mask').apply({
primary: s2Sr,
secondary: s2Clouds,
condition:
ee.Filter.equals({leftField: 'system:index', rightField: 'system:index'})
});
var s2CloudMasked =
ee.ImageCollection(s2SrWithCloudMask).map(maskClouds).median();
var rgbVis = {min: 0, max: 3000, bands: ['B4', 'B3', 'B2']};
Map.addLayer(
s2CloudMasked, rgbVis, 'S2 SR masked at ' + MAX_CLOUD_PROBABILITY + '%',
true);