Initial commit (#1)

* Initial commit

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

.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@v5
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Push to hub
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: git push --force https://giswqs:[email protected]/spaces/giswqs/duckdb-solara main

.gitignore

@@ -182,9 +182,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 

.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+repos:
+    - repo: https://github.com/pre-commit/pre-commit-hooks
+      rev: v5.0.0
+      hooks:
+          - id: check-toml
+          - id: check-yaml
+          - id: end-of-file-fixer
+            types: [python]
+          - id: trailing-whitespace
+          - id: requirements-txt-fixer
+          - id: check-added-large-files
+            args: ["--maxkb=500"]
+
+    - repo: https://github.com/psf/black
+      rev: 25.1.0
+      hooks:
+          - id: black-jupyter
+
+    - repo: https://github.com/codespell-project/codespell
+      rev: v2.4.1
+      hooks:
+          - id: codespell
+            args:
+                [
+                    "--ignore-words-list=aci,acount,acounts,fallow,ges,hart,hist,nd,ned,ois,wqs,watermask,tre,mape",
+                    "--skip=*.csv,*.geojson,*.json,*.yml*.js,*.html,*cff,*.pdf",
+                ]
+
+    - repo: https://github.com/kynan/nbstripout
+      rev: 0.8.1
+      hooks:
+          - id: nbstripout

Dockerfile

@@ -0,0 +1,16 @@
+FROM quay.io/jupyter/base-notebook:latest
+
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+
+RUN mkdir ./pages
+COPY /pages ./pages
+
+WORKDIR /home/jovyan
+USER jovyan
+
+EXPOSE 7860
+
+HEALTHCHECK CMD curl --fail http://localhost:7860/_stcore/health
+
+ENTRYPOINT ["solara", "run", "./pages", "--host=0.0.0.0", "--port=7860"]

README.md

@@ -0,0 +1,16 @@
+---
+title: DuckDB Solara
+emoji: 📚
+colorFrom: green
+colorTo: yellow
+sdk: docker
+pinned: false
+license: mit
+short_description: A solara web app template for DuckDB
+---
+
+This is a Solara web app for DuckDB. Click on the menu above to see the different examples.
+
+Source code: <https://github.com/opengeos/duckdb-solara>
+
+![](https://github.com/user-attachments/assets/216789ff-7e9d-46df-8bb0-9fbaca531a39)

pages/00_home.py

@@ -0,0 +1,17 @@
+import solara
+
+
+@solara.component
+def Page():
+    with solara.Column(align="center"):
+        markdown = """
+        ## A Solara web app for DuckDB
+
+        This is a Solara web app for DuckDB. Click on the menu above to see the different examples.
+        <br>
+        Source code: <https://github.com/opengeos/duckdb-solara>
+
+        ![](https://github.com/user-attachments/assets/216789ff-7e9d-46df-8bb0-9fbaca531a39)
+        """
+
+        solara.Markdown(markdown)

pages/01_h3.py

@@ -0,0 +1,156 @@
+import json
+import duckdb
+import solara
+import ipywidgets as widgets
+import leafmap.maplibregl as leafmap
+import matplotlib.pyplot as plt
+
+
+def create_map():
+
+    m = leafmap.Map(
+        add_sidebar=True,
+        add_floating_sidebar=False,
+        sidebar_visible=True,
+        layer_manager_expanded=False,
+        height="800px",
+    )
+    m.add_basemap("Esri.WorldImagery", before_id=m.first_symbol_layer_id, visible=False)
+    m.add_draw_control(controls=["polygon", "trash"])
+
+    con = duckdb.connect()
+    con.install_extension("httpfs")
+    con.install_extension("spatial")
+    con.install_extension("h3", repository="community")
+    con.load_extension("httpfs")
+    con.load_extension("spatial")
+    con.load_extension("h3")
+
+    url = "https://data.gishub.org/duckdb/h3_res4_geo.parquet"
+
+    con.sql(
+        f"CREATE TABLE IF NOT EXISTS h3_res4_geo AS SELECT * FROM read_parquet('{url}');"
+    )
+
+    colormaps = sorted(plt.colormaps())
+
+    checkbox = widgets.Checkbox(
+        description="3D Map",
+        value=True,
+        style={"description_width": "initial"},
+        layout=widgets.Layout(width="initial"),
+    )
+    outline_chk = widgets.Checkbox(
+        description="Add Hexagon Outline",
+        value=False,
+        style={"description_width": "initial"},
+        layout=widgets.Layout(width="initial"),
+    )
+
+    colormap_dropdown = widgets.Dropdown(
+        options=colormaps,
+        description="Colormap:",
+        value="inferno",
+        style={"description_width": "initial"},
+    )
+    class_slider = widgets.IntSlider(
+        description="Class:",
+        min=1,
+        max=10,
+        step=1,
+        value=5,
+        style={"description_width": "initial"},
+    )
+    apply_btn = widgets.Button(description="Apply")
+    close_btn = widgets.Button(description="Close")
+    output_widget = widgets.Output()
+    output_widget.append_stdout(
+        "Draw a polygon on the map. Then, \nclick on the 'Apply' button"
+    )
+
+    def on_apply_btn_click(change):
+        with output_widget:
+            try:
+                output_widget.outputs = ()
+                if len(m.draw_features_selected) > 0:
+                    geojson = m.draw_features_selected[0]["geometry"]
+                df = con.sql(
+                    f"""
+                SELECT * EXCLUDE (geometry), ST_AsText(geometry) AS geometry FROM h3_res4_geo
+                WHERE ST_Intersects(geometry, ST_GeomFromGeoJSON('{json.dumps(geojson)}'));
+                """
+                ).df()
+                gdf = leafmap.df_to_gdf(df)
+                if "H3 Hexagon" in m.layer_dict:
+                    m.remove_layer("H3 Hexagon")
+
+                if outline_chk.value:
+                    outline_color = "rgba(255, 255, 255, 255)"
+                else:
+                    outline_color = "rgba(255, 255, 255, 0)"
+
+                if checkbox.value:
+                    m.add_data(
+                        gdf,
+                        column="building_count",
+                        scheme="JenksCaspall",
+                        cmap=colormap_dropdown.value,
+                        k=class_slider.value,
+                        outline_color=outline_color,
+                        name="H3 Hexagon",
+                        before_id=m.first_symbol_layer_id,
+                        extrude=True,
+                        fit_bounds=False,
+                        add_legend=False,
+                    )
+                else:
+                    m.add_data(
+                        gdf,
+                        column="building_count",
+                        scheme="JenksCaspall",
+                        cmap=colormap_dropdown.value,
+                        k=class_slider.value,
+                        outline_color=outline_color,
+                        name="H3 Hexagon",
+                        before_id=m.first_symbol_layer_id,
+                        fit_bounds=False,
+                        add_legend=False,
+                    )
+
+                m.remove_from_sidebar(name="Legend")
+                m.add_legend_to_sidebar(
+                    title="Building Count",
+                    legend_dict=m.legend_dict,
+                )
+            except Exception as e:
+                with output_widget:
+                    output_widget.outputs = ()
+                    output_widget.append_stderr(str(e))
+
+    def on_close_btn_click(change):
+        m.remove_from_sidebar(name="H3 Hexagonal Grid")
+
+    apply_btn.on_click(on_apply_btn_click)
+    close_btn.on_click(on_close_btn_click)
+
+    widget = widgets.VBox(
+        [
+            widgets.HBox([checkbox, outline_chk]),
+            colormap_dropdown,
+            class_slider,
+            widgets.HBox([apply_btn, close_btn]),
+            output_widget,
+        ]
+    )
+    m.create_container()
+    m.add_to_sidebar(
+        widget, label="H3 Hexagonal Grid", widget_icon="mdi-hexagon-multiple"
+    )
+
+    return m
+
+
+@solara.component
+def Page():
+    m = create_map()
+    return m.to_solara()

requirements.txt

@@ -0,0 +1,6 @@
+anymap
+fiona
+geopandas
+leafmap>=0.57.8
+mapclassify
+solara