Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/awesome-spectral-indices/spectral

Awesome Spectral Indices for the Google Earth Engine JavaScript API (Code Editor).
https://github.com/awesome-spectral-indices/spectral

List: spectral

earth-engine geographic-information-systems gis google-earth-engine javascript landsat modis remote-sensing sentinel spectral spectral-data spectral-dataset spectral-index spectral-indices

Last synced: 4 days ago
JSON representation

Awesome Spectral Indices for the Google Earth Engine JavaScript API (Code Editor).

Host: GitHub
URL: https://github.com/awesome-spectral-indices/spectral
Owner: awesome-spectral-indices
License: mit
Created: 2021-05-16T19:24:20.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-05-17T01:22:22.000Z (7 months ago)
Last Synced: 2024-05-23T04:12:34.302Z (7 months ago)
Topics: earth-engine, geographic-information-systems, gis, google-earth-engine, javascript, landsat, modis, remote-sensing, sentinel, spectral, spectral-data, spectral-dataset, spectral-index, spectral-indices
Language: JavaScript
Homepage: https://ee-spectral.readthedocs.io/
Size: 17.2 MB
Stars: 165
Watchers: 10
Forks: 37
Open Issues: 0
Metadata Files:
- Readme: README.rst
- Contributing: docs/contributing.rst
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-ASI - spectral - Official ASI Google Earth Engine Module. Deploys ASI for the Code Editor. (Google Earth Engine / JavaScript)
Awesome-GEE - spectral - Awesome Spectral Indices for the Google Earth Engine JavaScript API (Code Editor). (JavaScript API / Repositories)

README

        .. raw:: html

   

     


       

       


       Awesome Spectral Indices for the Google Earth Engine JavaScript API (Code Editor)

     

   

.. image:: https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg

        :target: https://github.com/sindresorhus/awesome

        

.. image:: https://img.shields.io/badge/License-MIT-blue.svg

        :target: https://opensource.org/licenses/MIT

        

.. image:: https://readthedocs.org/projects/ee-spectral/badge/?version=latest

        :target: https://ee-spectral.readthedocs.io/en/latest/?badge=latest

        :alt: Documentation Status

.. image:: https://img.shields.io/badge/Paper-10.5194%2Fisprs--archives--XLVIII--4--W1--2022--301--2022-brightgreen

        :target: https://doi.org/10.5194/isprs-archives-XLVIII-4-W1-2022-301-2022

.. image:: https://zenodo.org/badge/367967462.svg

         :target: https://zenodo.org/badge/latestdoi/367967462

.. image:: https://img.shields.io/badge/GitHub%20Sponsors-Donate-ff69b4.svg

        :target: https://github.com/sponsors/davemlz

.. image:: https://img.shields.io/badge/Buy%20me%20a%20coffee-Donate-ff69b4.svg

        :target: https://www.buymeacoffee.com/davemlz

        

.. image:: https://img.shields.io/badge/kofi-Donate-ff69b4.svg

        :target: https://ko-fi.com/davemlz

.. image:: https://github.com/awesome-spectral-indices/spectral/actions/workflows/update_spectral_indices.yml/badge.svg

         :target: https://github.com/awesome-spectral-indices/spectral/actions/workflows/update_spectral_indices.yml

.. image:: https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/davemlz/5e9f08fa6a45d9d486e29d9d85ad5c84/raw/spectral.json

        :target: https://github.com/awesome-spectral-indices/awesome-spectral-indices/blob/main/output/spectral-indices-dict.json

        

.. image:: https://img.shields.io/twitter/follow/dmlmont?style=social

        :target: https://twitter.com/dmlmont

        

- GitHub: `https://github.com/awesome-spectral-indices/spectral `_

- Documentation: `https://ee-spectral.readthedocs.io/ `_

- Awesome Spectral Indices: `https://github.com/awesome-spectral-indices/awesome-spectral-indices `_

- Examples/Tutorials: `https://github.com/awesome-spectral-indices/spectral/tree/main/examples `_

Overview

-------------------

`Google Earth Engine `_ (GEE) is a cloud-based service for geospatial processing of vector and raster data. The Earth Engine platform has a `JavaScript and a Python API `_ with different methods to process geospatial objects. Google Earth Engine also provides a `HUGE PETABYTE-SCALE CATALOG `_ of raster and vector data that users can process online. The `Awesome Spectral Indices `_ is a standardized ready-to-use curated list of spectral indices that can be used as expressions for computing spectral indices in GEE. The spectral module extends the GEE JavaScript API with new functions to access and compute spectral indices from the `Awesome List of Spectral Indices `_.

Check the simple usage of spectral here:

.. code-block:: javascript

   var spectral = require("users/dmlmont/spectral:spectral");

   

   var dataset = "COPERNICUS/S2_SR";

   var S2 = ee.ImageCollection(dataset).first();

   var S2 = spectral.scale(S2,dataset);

   

   var parameters = {

       "N": S2.select("B8"),

       "R": S2.select("B4"),

       "G": S2.select("B3"),

       "L": 0.5

   };

   

   var S2 = spectral.computeIndex(S2,["NDVI","GNDVI","SAVI"],parameters);

   

List

-------

Check the full list of spectral indices `here `_.

How does it work?

-----------------------

The spectral module can be accepted `HERE `_. Once accepted, it can be required by running the following line in the `GEE JavaScript Code Editor `_:

.. code-block:: javascript

   var spectral = require("users/dmlmont/spectral:spectral");

The complete list of spectral indices can be accessed by using the :code:`indices` attribute:

.. code-block:: javascript

   print(spectral.indices);

The list of available attributes for a specific index can be accessed using dot notation:

.. code-block:: javascript

   print(spectral.indices.NDVI);

   

Or by using a key:

.. code-block:: javascript

   print(spectral.indices["NDVI"]);

   

An attribute can be accessed using also dot notation:

.. code-block:: javascript

   print(spectral.indices.NDVI.formula);

   

Or by using a key:

.. code-block:: javascript

   print(spectral.indices.NDVI["formula"]);

   

The available attributes of an index are:

- :code:`short_name`: Short name of the index (e.g. :code:`"NDWI"`).

- :code:`long_name`: Long name of the index (e.g. :code:`"Normalized Difference Water Index"`).

- :code:`formula`: Expression/formula of the index (e.g. :code:`"(G - N)/(G + N)"`).

- :code:`bands`: List of required bands/parameters for the index computation (e.g. :code:`["N","G"]`).

- :code:`reference`: Link to the index reference/paper/doi (e.g. :code:`"https://doi.org/10.1080/01431169608948714"`).

- :code:`type`: Type/application of the index (e.g. :code:`"water"`).

- :code:`date_of_addition`: Date of addition to the list (e.g. :code:`"2021-04-07"`).

- :code:`contributor`: GitHub user link of the contributor (e.g. :code:`"https://github.com/davemlz"`).

Finally, an index (e.g. NDVI) can be computed using the :code:`computeIndex(img, index, params)` function:

.. code-block:: javascript

   var dataset = "COPERNICUS/S2_SR";

   

   var S2 = ee.ImageCollection(dataset).first()

   var S2 = spectral.scale(S2,dataset);

   

   var parameters = {

       "N": S2.select("B8"),

       "R": S2.select("B4"),

   };

   

   var S2 = spectral.computeIndex(S2,"NDVI",parameters);

And multiple indices can be computed using an array of indices:

.. code-block:: javascript

   var dataset = "COPERNICUS/S2_SR";

   

   var S2 = ee.ImageCollection(dataset).first()

   var S2 = spectral.scale(S2,dataset);

   

   var parameters = {

       "N": S2.select("B8"),

       "R": S2.select("B4"),

       "G": S2.select("B3"),

       "L": 0.5

   };

   

   var S2 = spectral.computeIndex(S2,["NDVI","GNDVI","SAVI"],parameters);

All specified indices are added as new bands.

License

-------

The project is licensed under the MIT license.

How to cite

-----------

Do you like using :code:`spectral` and think it is useful? Share the love by citing it!

.. code-block::

   Montero, D., Aybar, C., Mahecha, M. D., Wieneke, S. (2022). spectral: Awesome Spectral Indices deployed

   via the Google Earth Engine JavaScript API. The International Archives of the Photogrammetry, Remote Sensing 

   and Spatial Information Sciences, Volume XLVIII-4/W1-2022. Free and Open Source Software for Geospatial 

   (FOSS4G) 2022 Academic Track, 22-28 August 2022, Florence, Italy. doi: 10.5194/isprs-archives-XLVIII-4-W1-2022-301-2022

If required, here is the BibTex!

.. code-block::

   @article{Montero2022,

      doi = {10.5194/isprs-archives-XLVIII-4-W1-2022-301-2022},

      url = {https://doi.org/10.5194/isprs-archives-XLVIII-4-W1-2022-301-2022},

      year = {2022},

      volume = {XLVIII-4/W1-2022},

      pages = {301-306},

      author = {David Montero, Cesar Aybar, Miguel D. Mahecha, Sebastian Wieneke},

      title = {spectral: Awesome Spectral Indices deployed via the Google Earth Engine JavaScript API},

      journal = {The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences}

   }