Initial commit

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.github/workflows/sync-hf.yml

@@ -0,0 +1,20 @@
+name: Sync to Hugging Face hub
+on:
+  push:
+    branches: [main]
+
+  # to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Push to hub
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: git push --force https://giswqs:$HF_TOKEN@huggingface.co/spaces/giswqs/solara-geemap main

.gitignore

@@ -0,0 +1,161 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+private/
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

Dockerfile

@@ -0,0 +1,21 @@
+FROM jupyter/base-notebook:latest
+
+RUN mamba install -c conda-forge leafmap geopandas localtileserver -y && \
+    fix-permissions "${CONDA_DIR}" && \
+    fix-permissions "/home/${NB_USER}"
+
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+
+RUN mkdir ./pages
+COPY /pages ./pages
+
+ENV PROJ_LIB='/opt/conda/share/proj'
+
+USER root
+RUN chown -R ${NB_UID} ${HOME}
+USER ${NB_USER}
+
+EXPOSE 8765
+
+CMD ["solara", "run", "./pages", "--host=0.0.0.0"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Open Geospatial Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,58 @@
+---
+title: Solara Geemap
+emoji: 🏃
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+app_port: 8765
+---
+
+## Earth Engine Web Apps
+
+### Introduction
+
+**A collection of Earth Engine web apps developed using [Solara](https://github.com/widgetti/solara) and geemap**
+
+- Web App: <https://giswqs-solara-geemap.hf.space>
+- GitHub: <https://github.com/opengeos/solara-geemap>
+- Hugging Face: <https://huggingface.co/spaces/giswqs/solara-geemap>
+
+### How to deploy this app on Hugging Face Spaces
+
+1. Go to <https://huggingface.co/spaces/giswqs/solara-geemap/tree/main> and duplicate the space to your own space.
+
+   ![](https://i.imgur.com/gTg4V2x.png)
+
+2. You need to set `EARTHENGINE_TOKEN` in order to use Earth Engine. The token value should be copied from the following file depending on your operating system:
+
+   ```text
+   Windows: C:\\Users\\USERNAME\\.config\\earthengine\\credentials
+   Linux: /home/USERNAME/.config/earthengine/credentials
+   MacOS: /Users/USERNAME/.config/earthengine/credentials
+   ```
+
+   Simply open the file and copy **ALL** the content to the `EARTHENGINE_TOKEN` environment variable.
+
+   ![](https://i.imgur.com/i04gzyH.png)
+
+   ![](https://i.imgur.com/Ex37Ut7.png)
+
+   Alternatively, you can run the following code to retrieve your Earth Engine token:
+
+   ```python
+   import geemap
+   geemap.get_ee_token()
+   ```
+
+   Copy all the content of the printed token and set it as the `EARTHENGINE_TOKEN` environment variable.
+
+3. After the space is built successfully, click the `Embed this Space` menu and find the `Direct URL` for the app, such as <https://giswqs-solara-geemap.hf.space>.
+
+   ![](https://i.imgur.com/DNM36sk.png)
+
+   ![](https://i.imgur.com/KX82lSf.png)
+
+4. Add your own apps (\*.py) to the `pages` folder.
+5. Commit and push your changes to the repository. Wait for the space to be built successfully.

pages/00_home.py

@@ -0,0 +1,59 @@
+import solara
+
+
+@solara.component
+def Page():
+    with solara.Column(align="center"):
+        markdown = """
+        ## Earth Engine Web Apps
+        
+        ### Introduction
+
+        **A collection of Earth Engine web apps developed using [Solara](https://github.com/widgetti/solara) and geemap**
+
+        - Web App: <https://giswqs-solara-geemap.hf.space>
+        - GitHub: <https://github.com/opengeos/solara-geemap>
+        - Hugging Face: <https://huggingface.co/spaces/giswqs/solara-geemap>
+
+        
+        ### How to deploy this app on Hugging Face Spaces
+
+        1. Go to <https://huggingface.co/spaces/giswqs/solara-geemap/tree/main> and duplicate the space to your own space.
+
+            ![](https://i.imgur.com/gTg4V2x.png)
+
+        2. You need to set `EARTHENGINE_TOKEN` in order to use Earth Engine. The token value should be copied from the following file depending on your operating system:
+
+            ```text
+            Windows: C:\\Users\\USERNAME\\.config\\earthengine\\credentials
+            Linux: /home/USERNAME/.config/earthengine/credentials
+            MacOS: /Users/USERNAME/.config/earthengine/credentials
+            ```
+
+            Simply open the file and copy **ALL** the content to the `EARTHENGINE_TOKEN` environment variable.
+
+            ![](https://i.imgur.com/i04gzyH.png)
+
+            ![](https://i.imgur.com/Ex37Ut7.png)
+
+
+            ```python
+            import geemap
+            geemap.get_ee_token()
+            ```
+
+            Copy all the content of the printed token and set it as the `EARTHENGINE_TOKEN` environment variable.
+
+        3. After the space is built successfully, click the `Embed this Space` menu and find the `Direct URL` for the app, such as <https://giswqs-solara-geemap.hf.space>.
+
+            ![](https://i.imgur.com/DNM36sk.png)
+
+            ![](https://i.imgur.com/KX82lSf.png)
+
+        4. Add your own apps (*.py) to the `pages` folder.
+
+        5. Commit and push your changes to the repository. Wait for the space to be built successfully.
+
+        """
+
+        solara.Markdown(markdown)

pages/02_inspector.py

@@ -0,0 +1,47 @@
+import ee
+import geemap
+
+import solara
+
+
+class Map(geemap.Map):
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.add_ee_data()
+        self.add("layer_manager")
+        self.add("inspector")
+
+    def add_ee_data(self):
+        # Add Earth Engine dataset
+        dem = ee.Image('USGS/SRTMGL1_003')
+        landsat7 = ee.Image('LANDSAT/LE7_TOA_5YEAR/1999_2003').select(
+            ['B1', 'B2', 'B3', 'B4', 'B5', 'B7']
+        )
+        states = ee.FeatureCollection("TIGER/2018/States")
+
+        # Set visualization parameters.
+        vis_params = {
+            'min': 0,
+            'max': 4000,
+            'palette': ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5'],
+        }
+
+        # Add Earth Engine layers to Map
+        self.addLayer(
+            landsat7,
+            {'bands': ['B4', 'B3', 'B2'], 'min': 20, 'max': 200, 'gamma': 2.0},
+            'Landsat 7',
+            True,
+        )
+        self.addLayer(dem, vis_params, 'SRTM DEM', True, 1)
+        self.addLayer(states, {}, "US States")
+
+
+@solara.component
+def Page():
+    with solara.Column(style={"min-width": "500px"}):
+        Map.element(
+            center=[40, -100],
+            zoom=4,
+            height="600px",
+        )

pages/03_plotting.py

@@ -0,0 +1,40 @@
+import ee
+import geemap
+
+import solara
+
+
+class Map(geemap.Map):
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.add_ee_data()
+        self.add_plot_gui()
+
+    def add_ee_data(self):
+        landsat7 = ee.Image('LANDSAT/LE7_TOA_5YEAR/1999_2003').select(
+            ['B1', 'B2', 'B3', 'B4', 'B5', 'B7']
+        )
+
+        landsat_vis = {'bands': ['B4', 'B3', 'B2'], 'gamma': 1.4}
+        self.addLayer(landsat7, landsat_vis, "Landsat")
+
+        hyperion = ee.ImageCollection('EO1/HYPERION').filter(
+            ee.Filter.date('2016-01-01', '2017-03-01')
+        )
+
+        hyperion_vis = {
+            'min': 1000.0,
+            'max': 14000.0,
+            'gamma': 2.5,
+        }
+        self.addLayer(hyperion, hyperion_vis, 'Hyperion')
+
+
+@solara.component
+def Page():
+    with solara.Column(style={"min-width": "500px"}):
+        Map.element(
+            center=[40, -100],
+            zoom=4,
+            height="600px",
+        )

pages/04_split_map.py

@@ -0,0 +1,55 @@
+import ee
+import geemap
+
+import solara
+
+
+class Map(geemap.Map):
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.add_ee_data()
+
+    def add_ee_data(self):
+        # Select the eight NLCD epochs after 2000.
+        years = ['2001', '2004', '2006', '2008', '2011', '2013', '2016', '2019']
+
+        # Get an NLCD image by year.
+        def getNLCD(year):
+            # Import the NLCD collection.
+            dataset = ee.ImageCollection('USGS/NLCD_RELEASES/2019_REL/NLCD')
+
+            # Filter the collection by year.
+            nlcd = dataset.filter(ee.Filter.eq('system:index', year)).first()
+
+            # Select the land cover band.
+            landcover = nlcd.select('landcover')
+            return landcover
+
+        ## Create an NLCD image collection for the selected years.
+        collection = ee.ImageCollection(ee.List(years).map(lambda year: getNLCD(year)))
+
+        # Create a list of labels to populate the dropdown list.
+        labels = [f'NLCD {year}' for year in years]
+
+        # Add a split-panel map for visualizing NLCD land cover change.
+        self.ts_inspector(
+            left_ts=collection,
+            right_ts=collection,
+            left_names=labels,
+            right_names=labels,
+        )
+
+        # Add the NLCD legend to the map.
+        self.add_legend(
+            title='NLCD Land Cover Type', builtin_legend='NLCD', height="460px", add_header=False
+        )
+
+
+@solara.component
+def Page():
+    with solara.Column(style={"min-width": "500px"}):
+        Map.element(
+            center=[40, -100],
+            zoom=4,
+            height="600px",
+        )

requirements.txt

@@ -0,0 +1,4 @@
+geemap
+solara
+geopandas
+pydantic< 2.0