test

app.py

@@ -18,8 +18,7 @@ import ibis
 from ibis import _
 
 # SETTING PAGE CONFIG TO WIDE MODE AND ADDING A TITLE AND FAVICON
-st.set_page_config(layout="wide", page_title="GBIF Biodiversity Demo", page_icon=":butterfly:")
-
+st.set_page_config(layout="wide", page_title="GBIF Biodiversity Demo", page_icon=":globe:")
 
 
 # +
@@ -39,7 +38,7 @@ def load_data(zoom=7):
     return df_all
 
 @st.cache_data
-def load_class(taxa="Amphibia", zoom=7):
+def load_class(taxa, zoom=7):
     con = ibis.duckdb.connect()
     path = "gbif-vert-gb-h3z" + str(zoom) + ".csv"
     df = (con.
@@ -87,21 +86,25 @@ def map(data, lat, lon, zoom):
 # LAYING OUT THE TOP SECTION OF THE APP
 row1_1, row1_2 = st.columns((2, 3))
 
-## Interactive elements
+## Interactive elements, see https://docs.streamlit.io/library/api-reference/widgets
 with row1_1:
     st.title("GBIF Species Richness")
-    taxa = st.text_input('taxonomic class (Chordates only)')
+    taxa = st.text_input('taxonomic class (Chordates only)', value = "Amphibia")
 
-    zoom = st.slider(
-        "Select hex resolution", 4, 7, key="zoom"
-    )
+    zoom = st.slider("Select hex resolution", 4, 7, key="zoom", value = 5)
 
 
 with row1_2:
     st.write(
     """
-    ##
-    Testing 
+    ## GBIF Streamlit demo
+
+    This shows a simple interactive demonstration using a series of [pydeck maps](https://deckgl.readthedocs.io/) overlaid with
+    [h3 hexagons](https://h3geo.org/) whose height and color indicate species richness of the group.  
+
+    Adjust the [h3 hexagon size](https://h3geo.org/docs/core-library/restable/) to increase the geographic area over which richness coordinates are aggregated. Select a focal taxonomic group to compare, zoom in and out of maps. 
+
+    Data derived from GBIF 2024-02-01 and h3 aggregations are pre-computed for cell sizes 1-7 across the UK using [duckdb-hs](https://github.com/isaacbrodsky/h3-duckdb)
     """
     )
 
@@ -120,17 +123,17 @@ with row2_1:
     st.write(
         f"""**All**"""
     )
-    map(load_data(zoom=zoom), midpoint[0], midpoint[1], 5)
+    map(load_data(zoom=zoom), midpoint[0], midpoint[1], 3)
 
 with row2_2:
     st.write(f"Selected class is {taxa}")
-    map(load_class(taxa=taxa, zoom=zoom),  midpoint[0], midpoint[1], 5)
+    map(load_class(taxa=taxa, zoom=zoom),  midpoint[0], midpoint[1], 3)
 
 with row2_3:
     st.write("**Mammals**")
-    map(load_class("Mammalia", zoom=zoom),  midpoint[0], midpoint[1], 5)
+    map(load_class("Mammalia", zoom=zoom),  midpoint[0], midpoint[1], 4)
 
 with row2_4:
     st.write("**Birds**")
-    map(load_class("Aves", zoom=zoom), midpoint[0], midpoint[1], 5)
+    map(load_class("Aves", zoom=zoom), midpoint[0], midpoint[1], 4)