# Install eerepr if needed
# !pip install eerepr
import ee
import eerepr
ee.Authenticate()
ee.Initialize()
Importing eerepr
registers interactive HTML reprs to all Earth Engine objects. Just print an object to preview it. This works for simple objects, like ee.Dictionary
...
ee.Dictionary({"test": [1, 2, 3, 4]})
...and for much more complex objects like ee.ImageCollection
or ee.FeatureCollection
.
ee.ImageCollection("COPERNICUS/S2_SR").limit(10)
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 Sentinel-2 L2 data are downloaded from scihub. They were computed by running sen2cor. WARNING: ESA did not produce L2 data for all L1 assets, and earlier L2 coverage is not global.
The assets contain 12 UINT16 spectral bands representing SR scaled by 10000 (unlike in L1 data, there is no B10). There are also several more L2-specific bands (see band list for details). See the Sentinel-2 User Handbook for details. In addition, three QA bands are present where one (QA60) is a bitmask band with cloud mask information. For more details, see the full explanation of how cloud masks are computed.
EE asset ids for Sentinel-2 L2 assets have the following format: COPERNICUS/S2_SR/20151128T002653_20151128T102149_T56MNN. Here the first numeric part represents the sensing date and time, the second numeric part represents the product generation date and time, and the final 6-character string is a unique granule identifier indicating its UTM grid reference (see MGRS).
Clouds can be removed by using COPERNICUS/S2_CLOUD_PROBABILITY. See this tutorial explaining how to apply the cloud mask.
For more details on Sentinel-2 radiometric resolution, see this page.
Provider: European Union/ESA/Copernicus
Revisit Interval
5 days
Bands
Name | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
B1 | Aerosols | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B2 | Blue | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B3 | Green | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B4 | Red | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B5 | Red Edge 1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B6 | Red Edge 2 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B7 | Red Edge 3 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B8 | NIR | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B8A | Red Edge 4 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B9 | Water vapor | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B11 | SWIR 1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
B12 | SWIR 2 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AOT | Aerosol Optical Thickness | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WVP | Water Vapor Pressure. The height the water would occupy if the vapor were condensed into liquid and spread evenly across the column. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SCL | Scene Classification Map (The "No Data" value of 0 is masked out) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TCI_R | True Color Image, Red channel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TCI_G | True Color Image, Green channel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TCI_B | True Color Image, Blue channel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MSK_CLDPRB | Cloud Probability Map (missing in some products) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MSK_SNWPRB | Snow Probability Map (missing in some products) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
QA10 | Always empty | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
QA20 | Always empty | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
QA60 | Cloud mask | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bitmask for QA60
|
Image Properties
Name | Type | Description |
---|---|---|
AOT_RETRIEVAL_ACCURACY | DOUBLE | Accuracy of Aerosol Optical thickness model |
CLOUDY_PIXEL_PERCENTAGE | DOUBLE | Granule-specific cloudy pixel percentage taken from the original metadata |
CLOUD_COVERAGE_ASSESSMENT | DOUBLE | Cloudy pixel percentage for the whole archive that contains this granule. Taken from the original metadata |
CLOUDY_SHADOW_PERCENTAGE | DOUBLE | Percentage of pixels classified as cloud shadow |
DARK_FEATURES_PERCENTAGE | DOUBLE | Percentage of pixels classified as dark features or shadows |
DATASTRIP_ID | STRING | Unique identifier of the datastrip Product Data Item (PDI) |
DATATAKE_IDENTIFIER | STRING | Uniquely identifies a given Datatake. The ID contains the Sentinel-2 satellite, start date and time, absolute orbit number, and processing baseline. |
DATATAKE_TYPE | STRING | MSI operation mode |
DEGRADED_MSI_DATA_PERCENTAGE | DOUBLE | Percentage of degraded MSI and ancillary data |
FORMAT_CORRECTNESS | STRING | Synthesis of the On-Line Quality Control (OLQC) checks performed at granule (Product_Syntax) and datastrip (Product Syntax and DS_Consistency) levels |
GENERAL_QUALITY | STRING | Synthesis of the OLQC checks performed at the datastrip level (Relative_Orbit_Number) |
GENERATION_TIME | DOUBLE | Product generation time |
GEOMETRIC_QUALITY | STRING | Synthesis of the OLQC checks performed at the datastrip level (Attitude_Quality_Indicator) |
GRANULE_ID | STRING | Unique identifier of the granule PDI (PDI_ID) |
HIGH_PROBA_CLOUDS_PERCENTAGE | DOUBLE | Percentage of pixels classified as high probability clouds |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B1 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B1 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B2 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B2 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B3 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B3 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B4 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B4 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B5 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B5 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B6 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B6 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B7 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B7 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B8 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B8 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B8A | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B8a and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B9 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B9 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B10 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B10 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B11 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B11 and for all detectors |
MEAN_INCIDENCE_AZIMUTH_ANGLE_B12 | DOUBLE | Mean value containing viewing incidence azimuth angle average for band B12 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B1 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B1 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B2 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B2 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B3 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B3 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B4 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B4 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B5 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B5 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B6 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B6 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B7 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B7 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B8 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B8 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B8A | DOUBLE | Mean value containing viewing incidence zenith angle average for band B8a and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B9 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B9 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B10 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B10 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B11 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B11 and for all detectors |
MEAN_INCIDENCE_ZENITH_ANGLE_B12 | DOUBLE | Mean value containing viewing incidence zenith angle average for band B12 and for all detectors |
MEAN_SOLAR_AZIMUTH_ANGLE | DOUBLE | Mean value containing sun azimuth angle average for all bands and detectors |
MEAN_SOLAR_ZENITH_ANGLE | DOUBLE | Mean value containing sun zenith angle average for all bands and detectors |
MEDIUM_PROBA_CLOUDS_PERCENTAGE | DOUBLE | Percentage of pixels classified as medium probability clouds |
MGRS_TILE | STRING | US-Military Grid Reference System (MGRS) tile |
NODATA_PIXEL_PERCENTAGE | DOUBLE | Percentage of No Data pixels |
NOT_VEGETATED_PERCENTAGE | DOUBLE | Percentage of pixels classified as non-vegetated |
PROCESSING_BASELINE | STRING | Configuration baseline used at the time of the product generation in terms of processor software version and major Ground Image Processing Parameters (GIPP) version |
PRODUCT_ID | STRING | The full id of the original Sentinel-2 product |
RADIATIVE_TRANSFER_ACCURACY | DOUBLE | Accuracy of radiative transfer model |
RADIOMETRIC_QUALITY | STRING | Based on the OLQC reports contained in the Datastrips/QI_DATA with RADIOMETRIC_QUALITY checklist name |
REFLECTANCE_CONVERSION_CORRECTION | DOUBLE | Earth-Sun distance correction factor |
SATURATED_DEFECTIVE_PIXEL_PERCENTAGE | DOUBLE | Percentage of saturated or defective pixels |
SENSING_ORBIT_DIRECTION | STRING | Imaging orbit direction |
SENSING_ORBIT_NUMBER | DOUBLE | Imaging orbit number |
SENSOR_QUALITY | STRING | Synthesis of the OLQC checks performed at granule (Missing_Lines, Corrupted_ISP, and Sensing_Time) and datastrip (Degraded_SAD and Datation_Model) levels |
SOLAR_IRRADIANCE_B1 | DOUBLE | Mean solar exoatmospheric irradiance for band B1 |
SOLAR_IRRADIANCE_B2 | DOUBLE | Mean solar exoatmospheric irradiance for band B2 |
SOLAR_IRRADIANCE_B3 | DOUBLE | Mean solar exoatmospheric irradiance for band B3 |
SOLAR_IRRADIANCE_B4 | DOUBLE | Mean solar exoatmospheric irradiance for band B4 |
SOLAR_IRRADIANCE_B5 | DOUBLE | Mean solar exoatmospheric irradiance for band B5 |
SOLAR_IRRADIANCE_B6 | DOUBLE | Mean solar exoatmospheric irradiance for band B6 |
SOLAR_IRRADIANCE_B7 | DOUBLE | Mean solar exoatmospheric irradiance for band B7 |
SOLAR_IRRADIANCE_B8 | DOUBLE | Mean solar exoatmospheric irradiance for band B8 |
SOLAR_IRRADIANCE_B8A | DOUBLE | Mean solar exoatmospheric irradiance for band B8a |
SOLAR_IRRADIANCE_B9 | DOUBLE | Mean solar exoatmospheric irradiance for band B9 |
SOLAR_IRRADIANCE_B10 | DOUBLE | Mean solar exoatmospheric irradiance for band B10 |
SOLAR_IRRADIANCE_B11 | DOUBLE | Mean solar exoatmospheric irradiance for band B11 |
SOLAR_IRRADIANCE_B12 | DOUBLE | Mean solar exoatmospheric irradiance for band B12 |
SNOW_ICE_PERCENTAGE | DOUBLE | Percentage of pixels classified as snow or ice |
SPACECRAFT_NAME | STRING | Sentinel-2 spacecraft name: Sentinel-2A, Sentinel-2B |
THIN_CIRRUS_PERCENTAGE | DOUBLE | Percentage of pixels classified as thin cirrus clouds |
UNCLASSIFIED_PERCENTAGE | DOUBLE | Percentage of unclassified pixels |
VEGETATION_PERCENTAGE | DOUBLE | Percentage of pixels classified as vegetation |
WATER_PERCENTAGE | DOUBLE | Percentage of pixels classified as water |
WATER_VAPOUR_RETRIEVAL_ACCURACY | DOUBLE | Declared accuracy of the Water Vapor model |
Terms of Use
The use of Sentinel data is governed by the Copernicus Sentinel Data Terms and Conditions.
Just like in the Code Editor, printing an object with eerepr
requests data from the server, so large objects may take a while or even time out. If eerepr
fails to retrieve data it will fall back to the string repr and warn you about the error it encountered. For example, if we try to display an invalid ee.Projection
...
ee.Projection("foo")
/home/az/eerepr/eerepr/repr.py:43: UserWarning: Getting info failed with: 'Projection: The CRS of a map projection could not be parsed.'. Falling back to string repr. warn(f"Getting info failed with: '{e}'. Falling back to string repr.")
<ee.Projection object at 0x7fe8d5bc7fa0>
eerepr
caches results within each Jupyter session, so a large request will run slowly the first time but should be nearly instant if you repeat it.
fc = ee.FeatureCollection("WRI/GPPD/power_plants").limit(1_000)
First run takes a few seconds to retrieve data.
fc
The Global Power Plant Database is a comprehensive, open source database of power plants around the world. It centralizes power plant data to make it easier to navigate, compare and draw insights. Each power plant is geolocated and entries contain information on plant capacity, generation, ownership, and fuel type. As of June 2018, the database includes around 28,500 power plants from 164 countries. It will be continuously updated as data becomes available.
The methodology for the dataset creation is given in the World Resources Institute publication "A Global Database of Power Plants".
Associated code for the creation of the dataset can be found on GitHub. The bleeding-edge version of the database (which may contain substantial differences from the release in Earth Engine) is available on GitHub as well.
If you use this dataset, the provider (WRI) has requested that you register your use and (optionally) sign up to receive update notifications.
Table Schema
Name | Type | Description |
---|---|---|
country | STRING | 3-character country code corresponding to the ISO 3166-1 alpha-3 specs |
country_lg | STRING | Longer form of the country designation |
name | STRING | Name or title of the power plant, generally in Romanized form |
gppd_idnr | STRING | 10- or 12-character identifier for the power plant |
capacitymw | DOUBLE | Electrical generating capacity in megawatts |
latitude | DOUBLE | Geolocation in decimal degrees |
longitude | DOUBLE | Geolocation in decimal degrees |
fuel1 | STRING | Energy source used in electricity generation or export |
fuel2 | STRING | Energy source used in electricity generation or export |
fuel3 | STRING | Energy source used in electricity generation or export |
fuel4 | STRING | Energy source used in electricity generation or export |
comm_year | STRING | Year of plant operation, weighted by unit-capacity when data is available |
owner | STRING | Majority shareholder of the power plant, generally in Romanized form |
source | STRING | Entity reporting the data; could be an organization, report, or document, generally in Romanized form |
url | STRING | Web document corresponding to the "source" field |
src_latlon | STRING | Attribution for geolocation information |
cap_year | DOUBLE | Year the capacity information was reported |
gwh_2013 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2013 |
gwh_2014 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2014 |
gwh_2015 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2015 |
gwh_2016 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2016 |
gwh_estimt | DOUBLE | Estimated annual electricity generation in gigawatt-hours for the year 2015 |
Terms of Use
This dataset is licensed under CC-BY 4.0.
Suggested citation(s)
Global Energy Observatory, Google, KTH Royal Institute of Technology in Stockholm, University of Groningen, World Resources Institute. 2018. Global Power Plant Database. Published on Resource Watch and Google Earth Engine; http://resourcewatch.org/https://earthengine.google.com/
Second run pulls data from the cache. Much faster!
fc
The Global Power Plant Database is a comprehensive, open source database of power plants around the world. It centralizes power plant data to make it easier to navigate, compare and draw insights. Each power plant is geolocated and entries contain information on plant capacity, generation, ownership, and fuel type. As of June 2018, the database includes around 28,500 power plants from 164 countries. It will be continuously updated as data becomes available.
The methodology for the dataset creation is given in the World Resources Institute publication "A Global Database of Power Plants".
Associated code for the creation of the dataset can be found on GitHub. The bleeding-edge version of the database (which may contain substantial differences from the release in Earth Engine) is available on GitHub as well.
If you use this dataset, the provider (WRI) has requested that you register your use and (optionally) sign up to receive update notifications.
Table Schema
Name | Type | Description |
---|---|---|
country | STRING | 3-character country code corresponding to the ISO 3166-1 alpha-3 specs |
country_lg | STRING | Longer form of the country designation |
name | STRING | Name or title of the power plant, generally in Romanized form |
gppd_idnr | STRING | 10- or 12-character identifier for the power plant |
capacitymw | DOUBLE | Electrical generating capacity in megawatts |
latitude | DOUBLE | Geolocation in decimal degrees |
longitude | DOUBLE | Geolocation in decimal degrees |
fuel1 | STRING | Energy source used in electricity generation or export |
fuel2 | STRING | Energy source used in electricity generation or export |
fuel3 | STRING | Energy source used in electricity generation or export |
fuel4 | STRING | Energy source used in electricity generation or export |
comm_year | STRING | Year of plant operation, weighted by unit-capacity when data is available |
owner | STRING | Majority shareholder of the power plant, generally in Romanized form |
source | STRING | Entity reporting the data; could be an organization, report, or document, generally in Romanized form |
url | STRING | Web document corresponding to the "source" field |
src_latlon | STRING | Attribution for geolocation information |
cap_year | DOUBLE | Year the capacity information was reported |
gwh_2013 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2013 |
gwh_2014 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2014 |
gwh_2015 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2015 |
gwh_2016 | DOUBLE | Electricity generation in gigawatt-hours reported for the year 2016 |
gwh_estimt | DOUBLE | Estimated annual electricity generation in gigawatt-hours for the year 2015 |
Terms of Use
This dataset is licensed under CC-BY 4.0.
Suggested citation(s)
Global Energy Observatory, Google, KTH Royal Institute of Technology in Stockholm, University of Groningen, World Resources Institute. 2018. Global Power Plant Database. Published on Resource Watch and Google Earth Engine; http://resourcewatch.org/https://earthengine.google.com/