ee.Image

Extended methods for the ee.Image class:

eemont.image.index(self, index='NDVI', G=2.5, C1=6.0, C2=7.5, L=1.0)[source]

Computes one or more spectral indices (indices are added as bands) for an image.

Parameters

  • self (ee.Image [this]) – Image to compute indices on. Must be scaled to [0,1]. Check the supported platforms in User Guide > Spectral Indices > Supported Platforms.

  • index (string | list[string], default = 'NDVI') –

    Index or list of indices to compute.

    Available options:

    • ’vegetation’ : Compute all vegetation indices.

    • ’burn’ : Compute all burn indices.

    • ’water’ : Compute all water indices.

    • ’snow’ : Compute all snow indices.

    • ’all’ : Compute all indices listed below.

    Vegetation indices:

    • ’BNDVI’ : Blue Normalized Difference Vegetation Index.

    • ’CIG’ : Chlorophyll Index - Green.

    • ’CVI’ : Chlorophyll Vegetation Index.

    • ’EVI’ : Enhanced Vegetation Index.

    • ’EVI2’ : Two-Band Enhanced Vegetation Index.

    • ’GBNDVI’ : Green-Blue Normalized Difference Vegetation Index.

    • ’GNDVI’ : Green Normalized Difference Vegetation Index.

    • ’GRNDVI’ : Green-Red Normalized Difference Vegetation Index.

    • ’MNDVI’ : Modified Normalized Difference Vegetation Index.

    • ’NDVI’ : Normalized Difference Vegetation Index.

    • ’NGRDI’ : Normalized Green Red Difference Index.

    • ’RVI’ : Ratio Vegetation Index.

    • ’SAVI’ : Soil-Adjusted Vegetation Index.

    Burn and fire indices:

    • ’BAI’ : Burned Area Index.

    • ’BAIS2’ : Burned Area Index for Sentinel 2.

    • ’CSIT’ : Char Soil Index Thermal.

    • ’NBR’ : Normalized Burn Ratio.

    • ’NBRT’ : Normalized Burn Ratio Thermal.

    • ’NDVIT’ : Normalized Difference Vegetation Index Thermal

    • ’SAVIT’ : Soil-Adjusted Vegetation Index Thermal.

    Water indices:

    • ’MNDWI’ : Modified Normalized Difference Water Index.

    • ’NDWI’ : Normalized Difference Water Index.

    Snow indices:

    • ’NDSI’ : Normalized Difference Snow Index.

  • G (float, default = 2.5) – Gain factor. Used just for index = ‘EVI’.

  • C1 (float, default = 6.0) – Coefficient 1 for the aerosol resistance term. Used just for index = ‘EVI’.

  • C2 (float, default = 7.5) – Coefficient 2 for the aerosol resistance term. Used just for index = ‘EVI’.

  • L (float, default = 1.0) – Canopy background adjustment. Used just for index = [‘EVI’,’SAVI’].

Returns

Image with the computed spectral index, or indices, as new bands.

Return type

ee.Image

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> S2 = ee.ImageCollection('COPERNICUS/S2_SR').first().scale().index(['NDVI','EVI','GNDVI'])

See also

scale

Scales bands on an image collection.

eemont.image.maskClouds(self, method='cloud_prob', prob=60, maskCirrus=True, maskShadows=True, scaledImage=False, dark=0.15, cloudDist=1000, buffer=250, cdi=None)[source]

Masks clouds and shadows in an image (valid just for Surface Reflectance products).

Parameters

  • self (ee.Image [this]) – Image to mask. Check the supported platforms in User Guide > Masking Clouds and Shadows > Supported Platforms.

  • method (string, default = 'cloud_prob') –

    Method used to mask clouds.

    Available options:

    • ’cloud_prob’ : Use cloud probability.

    • ’qa’ : Use Quality Assessment band.

    This parameter is ignored for Landsat products.

  • prob (numeric [0, 100], default = 60) – Cloud probability threshold. Valid just for method = ‘prob’. This parameter is ignored for Landsat products.

  • maskCirrus (boolean, default = True) – Whether to mask cirrus clouds. Valid just for method = ‘qa’. This parameter is ignored for Landsat products.

  • maskShadows (boolean, default = True) – Whether to mask cloud shadows. For more info see ‘Braaten, J. 2020. Sentinel-2 Cloud Masking with s2cloudless. Google Earth Engine, Community Tutorials’.

  • scaledImage (boolean, default = False) – Whether the pixel values are scaled to the range [0,1] (reflectance values). This parameter is ignored for Landsat products.

  • dark (float [0,1], default = 0.15) – NIR threshold. NIR values below this threshold are potential cloud shadows. This parameter is ignored for Landsat products.

  • cloudDist (int, default = 1000) – Maximum distance in meters (m) to look for cloud shadows from cloud edges. This parameter is ignored for Landsat products.

  • buffer (int, default = 250) – Distance in meters (m) to dilate cloud and cloud shadows objects. This parameter is ignored for Landsat products.

  • cdi (float [-1,1], default = None) – Cloud Displacement Index threshold. Values below this threshold are considered potential clouds. A cdi = None means that the index is not used. For more info see ‘Frantz, D., HaS, E., Uhl, A., Stoffels, J., Hill, J. 2018. Improvement of the Fmask algorithm for Sentinel-2 images: Separating clouds from bright surfaces based on parallax effects. Remote Sensing of Environment 2015: 471-481’. This parameter is ignored for Landsat products.

Returns

Cloud-shadow masked image.

Return type

ee.Image

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> S2 = ee.ImageCollection('COPERNICUS/S2_SR').first().maskClouds(prob = 75,buffer = 300,cdi = -0.5)

Notes

This method may mask water as well as clouds for the Sentinel-3 Radiance product.

eemont.image.scale(self)[source]

Scales bands on an image.

Parameters

self (ee.Image [this]) – Image to scale. Check the supported platforms in User Guide > Image Scaling > Supported Platforms.

Returns

Scaled image.

Return type

ee.Image

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> S2 = ee.ImageCollection('COPERNICUS/S2_SR').first().scale()