Initial dashboard deployment

README.md

@@ -1,11 +1,81 @@
+# Urban Vegetation Dashboard — Maricopa County, AZ
+
+Christian Anderson
+GIS 322
+Spring 2026
+Instructor: Debayan Mandal
+
+---
+
+## Description
+
+This interactive Solara dashboard explores the relationship between NDVI vegetation index, tree equity scores, and U.S. Census demographics at the block-group level across Maricopa County, Arizona. Users can visualize a bivariate choropleth map comparing greenness to demographic variables (Income, % Minority), toggle a Tree Equity Score overlay, and inspect a summary statistics table and chart of the top 15 block groups most in need of tree canopy investment.
+
+---
+
+## Screenshot
+
+![Dashboard preview](screenshot.png)
+
+---
+
+## Data Sources
+
+| Dataset | Source | License |
+|---|---|---|
+| NDVI (vegetation index) | [Google Earth Engine](https://earthengine.google.com) — Landsat/Sentinel composites | Free for research/education |
+| Block-group demographics | [U.S. Census Bureau ACS 5-Year Estimates](https://api.census.gov) | Public domain |
+| Tree Equity Scores | [American Forests — Tree Equity Score](https://treeequityscore.org/map/) | Free download |
+| Block-group boundaries | [U.S. Census TIGER/Line Shapefiles](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) | Public domain |
+
 ---
-title: GIS322FinalProject
-emoji: 🚀
-colorFrom: yellow
-colorTo: blue
-sdk: docker
-pinned: false
-short_description: GIS322 Final Project Dashboard in Solara
+
+## Environment Setup
+
+### 1. Virtual environment
+```anaconda prompt
+pip install -r requirements.txt
+```
+
+### 2. Census API key *(free)*
+Sign up at https://api.census.gov/data/key_signup.html, then either paste your key into `data_pipeline.py` when defining CENSUS_API_KEY
+
+### 3. Google Earth Engine *(free for students)*
+1. Sign up at https://earthengine.google.com with your Google account.
+2. Authenticate in anaconda prompt:
+   ```
+   python -c "import ee; ee.Authenticate()"
+   ```
+3. Create a project at https://console.cloud.google.com (free tier).
+4. Paste your project ID into `data_pipeline.py` where it says     ee.Initialize(project="gis322final").
+
+### 4. Tree Equity Scores *(free)*
+1. Go to https://treeequityscore.org/map/
+2. Click **Download Data** → Arizona → Shapefile
+3. Save to `data/raw/az_tes.shp`
+
+### 5. Build the database
+Run this once (~5 min) to fetch and process all data into `processed_dashboard.db`:
+```anaconda prompt
+python data_pipeline.py
+```
+
+---
+
+## Run Instructions
+
+```anaconda prompt
+solara run app.py
+```
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Project Files
+
+| File | Purpose |
+|---|---|
+| `data_pipeline.py` | Run once to fetch data and build `processed_dashboard.db` |
+| `app.py` | Solara dashboard — launch with `solara run app.py` |
+| `dashboard_helpers.py` | Map and chart builder functions used by `app.py` |
+| `requirements.txt` | Python dependencies |
+| `data/raw/` | Place downloaded raw files here |

app.py

@@ -0,0 +1,127 @@
+import duckdb
+import solara
+from dashboard_helpers import (
+    build_bivariate_map,
+    build_bivariate_legend,
+    build_summary_stats,
+    build_need_chart,
+    build_need_map,
+)
+
+# 1. Connect to database
+con = duckdb.connect("processed_dashboard.db", read_only=True)
+
+baseline_df       = con.sql("SELECT * FROM city_baselines").df()
+baseline_ndvi     = float(baseline_df["baseline_ndvi"].iloc[0])
+baseline_income   = float(baseline_df["baseline_income"].iloc[0])
+baseline_minority = float(baseline_df["baseline_minority_pct"].iloc[0])
+# 2. Reactive state
+
+# X axis:
+x_col = solara.reactive("ndvi_mean")
+
+X_OPTIONS = {
+    "ndvi_mean":          "NDVI (Vegetation)",
+    "tree_equity_score":  "Tree Equity Score",
+}
+
+# Y axis:
+y_col = solara.reactive("median_income")
+
+Y_OPTIONS = {
+    "median_income": "Median Income",
+    "pct_minority":  "% Minority",
+}
+
+# 3. Components
+
+@solara.component
+def BivariateMapCard():
+    x_label = X_OPTIONS[x_col.value]
+    y_label = Y_OPTIONS[y_col.value]
+    m       = build_bivariate_map(con, x_col.value, x_label, y_col.value, y_label)
+    solara.Markdown(f"#### Bivariate Choropleth — {x_label} × {y_label}")
+    solara.display(m)
+
+@solara.component
+def LegendCard():
+    x_label = X_OPTIONS[x_col.value]
+    y_label = Y_OPTIONS[y_col.value]
+    fig     = build_bivariate_legend(x_label, y_label, y_col.value)
+    with solara.Card(title="Legend"):
+        solara.FigureMatplotlib(fig, dependencies=[x_col.value, y_col.value])
+
+@solara.component
+def SummaryStatsCard():
+    x_label = X_OPTIONS[x_col.value]
+    y_label = Y_OPTIONS[y_col.value]
+    styled  = build_summary_stats(con, x_col.value, y_col.value)
+    with solara.Card(title=f"Summary Stats — {x_label} × {y_label}"):
+        solara.display(styled)
+
+@solara.component
+def NeedChartCard():
+    fig = build_need_chart(con, y_col.value)
+    with solara.Card(title="Top 15 Block Groups by Tree Program Need"):
+        solara.FigureMatplotlib(fig, dependencies=[y_col.value])
+
+@solara.component
+def NeedMapCard():
+    m = build_need_map(con, y_col.value)
+    with solara.Card(title="Top 15 Block Groups — Location"):
+        solara.display(m)
+
+# 4. Page
+
+@solara.component
+def Page():
+    solara.Title("Urban Vegetation Dashboard — Phoenix, AZ")
+
+    with solara.Column():
+
+        # Header
+        with solara.Column(align="center"):
+            solara.Markdown("# Understanding Urban Vegetation and Socioeconomic Demographics in Maricopa County",
+                            style={"text-align": "center"})
+            solara.Markdown(
+                "<div style='text-align:center;color:#8b949e'>"
+                "Exploring tree equity across Maricopa County block groups using NDVI, "
+                "Tree Equity Scores, and Census demographics.<br>"
+                "Data: Google Earth Engine · U.S. Census ACS 5-Year · American Forests"
+                "</div>"
+            )
+
+        with solara.GridFixed(columns=2):
+            with solara.Card(title="Maricopa County Baselines"):
+                with solara.Row():
+                    solara.Markdown(f"**Avg NDVI:** `{baseline_ndvi:.3f}`")
+                    solara.Markdown(f"**Median income:** `${baseline_income:,.0f}`")
+                    solara.Markdown(f"**% Minority:** `{baseline_minority:.1f}%`")
+
+            with solara.Card(title="Map Controls"):
+                with solara.Row():
+                    with solara.Column():
+                        solara.Select(
+                            label="X axis",
+                            value=x_col,
+                            values=list(X_OPTIONS.keys()),
+                        )
+                    with solara.Column():
+                        solara.Select(
+                            label="Y axis",
+                            value=y_col,
+                            values=list(Y_OPTIONS.keys()),
+                        )
+
+        # Bivariate map (full width)
+        BivariateMapCard()
+
+        # Legend + stats side by side
+        with solara.GridFixed(columns=2):
+            LegendCard()
+            SummaryStatsCard()
+
+        # Need chart + map full width
+        with solara.GridFixed(columns=2):
+            NeedChartCard()
+            NeedMapCard()

dashboard_helpers.py

@@ -0,0 +1,292 @@
+"""
+dashboard_helpers.py  —  Map-building and chart functions used by app.py
+"""
+
+import numpy as np
+import pandas as pd
+import geopandas as gpd
+import leafmap
+import matplotlib
+import matplotlib.pyplot as plt
+import matplotlib.patches as mpatches
+import matplotlib.colors as mcolors
+
+
+def _classify_terciles(series):
+    out = pd.Series(-1, index=series.index, dtype=int)
+    mask = series.notna()
+    if mask.sum() < 3:
+        return out
+    labels = pd.qcut(series[mask], q=3, labels=[0, 1, 2], duplicates="drop")
+    out[mask] = labels.astype(int)
+    return out
+
+
+# Bivariate palette
+# X axis = environmental variable (NDVI or TES): color (red=low, yellow=mid, green=high)
+# Y axis = demographic variable: shade (dark=high % community of concern, light=low % community of concern)
+
+BIVARIATE_COLORS = [
+    "#8B0000",
+    "#B8860B",
+    "#1B5E20",
+    "#CD5C5C",
+    "#DAA520",
+    "#4CAF50",
+    "#F4CCCC",
+    "#FFF9C4",
+    "#C8E6C9",
+]
+
+CMAP_NAME = "bivariate_9"
+
+
+# Bivariate choropleth map
+
+def build_bivariate_map(con, x_col, x_label, y_col, y_label):
+    df = con.sql(f"""
+        SELECT GEOID, geometry_wkt, {x_col}, {y_col}
+        FROM block_groups
+        WHERE total_pop > 0
+          AND {x_col} IS NOT NULL
+          AND {y_col} IS NOT NULL
+    """).df()
+
+    gdf = gpd.GeoDataFrame(
+        df,
+        geometry=gpd.GeoSeries.from_wkt(df["geometry_wkt"]),
+        crs="EPSG:4269"
+    ).drop(columns="geometry_wkt")
+
+    gdf["x_class"] = _classify_terciles(gdf[x_col])
+    # For minority %, invert so that high minority = dark
+    if y_col == "pct_minority":
+        gdf["y_class"] = _classify_terciles(gdf[y_col]).map({2: 0, 1: 1, 0: 2, -1: -1})
+    else:
+        gdf["y_class"] = _classify_terciles(gdf[y_col])
+    
+    gdf["bv_class"] = gdf.apply(
+        lambda r: int(r["y_class"]) * 3 + int(r["x_class"])
+        if r["x_class"] >= 0 and r["y_class"] >= 0 else float("nan"),
+        axis=1
+    )
+
+    gdf_valid = gdf[gdf["bv_class"].notna()].copy()
+    gdf_valid["bv_class"] = gdf_valid["bv_class"].astype(float)
+
+    cmap = mcolors.ListedColormap(BIVARIATE_COLORS, name=CMAP_NAME)
+    try:
+        matplotlib.colormaps.register(cmap, name=CMAP_NAME)
+    except Exception:
+        pass
+
+    gdf_valid["hex_color"] = gdf_valid["bv_class"].apply(
+        lambda c: BIVARIATE_COLORS[int(c)] if not np.isnan(c) else "#cccccc"
+    )
+
+    # Save to a temp file and load via leafmap
+    import tempfile, os
+    tmp = tempfile.NamedTemporaryFile(suffix=".geojson", delete=False)
+    tmp.close()
+    gdf_valid[["geometry", "bv_class", "hex_color", "GEOID"]].to_file(tmp.name, driver="GeoJSON")
+
+    import folium
+    m = folium.Map(location=[33.45, -112.07], zoom_start=10,
+                   tiles="CartoDB dark_matter")
+
+    for _, row in gdf_valid.iterrows():
+        folium.GeoJson(
+            row.geometry.__geo_interface__,
+            style_function=lambda f, c=row["hex_color"]: {
+                "fillColor": c,
+                "fillOpacity": 0.75,
+                "color": "#444",
+                "weight": 0.4,
+            }
+        ).add_to(m)
+
+    return m
+
+
+# Bivariate legend
+
+def build_bivariate_legend(x_label, y_label, y_col):
+    palette = [
+        ["#8B0000", "#B8860B", "#1B5E20"],  # low Y:  dark shades
+        ["#CD5C5C", "#DAA520", "#4CAF50"],  # mid Y:  medium shades
+        ["#F4CCCC", "#FFF9C4", "#C8E6C9"],  # high Y: light shades
+    ]
+
+    fig, ax = plt.subplots(figsize=(3.5, 3.5), facecolor="#1a1a2e")
+    ax.set_facecolor("#1a1a2e")
+
+    for row in range(3):
+        for col in range(3):
+            rect = mpatches.FancyBboxPatch(
+                (col, row), 1, 1,
+                boxstyle="square,pad=0",
+                facecolor=palette[row][col],
+                edgecolor="#333", linewidth=0.5
+            )
+            ax.add_patch(rect)
+
+    ax.set_xlim(0, 3)
+    ax.set_ylim(0, 3)
+
+    ax.set_xticks([0.5, 1.5, 2.5])
+    ax.set_xticklabels(["Low", "Med", "High"], color="#c9d1d9", fontsize=8)
+
+    ax.set_yticks([0.5, 1.5, 2.5])
+    if y_col == "pct_minority":
+        ax.set_yticklabels(["High", "Med", "Low"], color="#c9d1d9", fontsize=8)
+    else:
+        ax.set_yticklabels(["Low", "Med", "High"], color="#c9d1d9", fontsize=8)
+
+    ax.set_xlabel(x_label, color="#c9d1d9", fontsize=9, labelpad=8)
+    ax.set_ylabel(y_label, color="#c9d1d9", fontsize=9, labelpad=8)
+    ax.tick_params(length=0)
+    for spine in ax.spines.values():
+        spine.set_visible(False)
+
+    fig.subplots_adjust(left=0.22, bottom=0.18, right=0.95, top=0.95)
+    return fig
+
+# Summary stats table
+
+def build_summary_stats(con, x_col, y_col):
+    df = con.sql(f"""
+        SELECT {x_col}, {y_col}, tree_equity_score, ndvi_mean, total_pop
+        FROM block_groups
+        WHERE total_pop > 0
+          AND {x_col} IS NOT NULL
+          AND {y_col} IS NOT NULL
+    """).df()
+
+    df["x_tercile"] = _classify_terciles(df[x_col]).map(
+        {-1: "No data", 0: f"Low", 1: f"Mid", 2: f"High"}
+    )
+
+    summary = (
+        df.groupby("x_tercile")
+        .agg(
+            Block_Groups=(x_col, "count"),
+            **{f"Avg_{x_col}": (x_col, lambda x: round(x.mean(), 2))},
+            **{f"Avg_{y_col}": (y_col, lambda x: round(x.mean(), 1))},
+            Avg_TES=("tree_equity_score", lambda x: round(x.mean(), 1) if x.notna().any() else np.nan),
+            Avg_NDVI=("ndvi_mean", lambda x: round(x.mean(), 3) if x.notna().any() else np.nan),
+        )
+        .reindex(["Low", "Mid", "High"])
+        .reset_index()
+        .rename(columns={"x_tercile": "Group"})
+    )
+
+    styled = summary.style.background_gradient(
+        cmap="RdYlGn", subset=[f"Avg_{x_col}"]
+    ).hide(axis="index")
+
+    return styled
+
+
+# Tree-need bar chart
+
+def build_need_chart(con, y_col):
+    df = con.sql(f"""
+        SELECT GEOID, ndvi_mean, tree_equity_score, {y_col}
+        FROM block_groups
+        WHERE ndvi_mean IS NOT NULL AND tree_equity_score IS NOT NULL
+          AND {y_col} IS NOT NULL AND total_pop > 0
+    """).df()
+
+    if df.empty:
+        fig, ax = plt.subplots(facecolor="#161b22")
+        ax.text(0.5, 0.5, "No data yet", ha="center", va="center", color="#8b949e")
+        return fig
+
+    def minmax(s):
+        mn, mx = s.min(), s.max()
+        return (s - mn) / (mx - mn) if mx > mn else s * 0
+
+    df["ndvi_norm"] = minmax(df["ndvi_mean"])
+    df["tes_norm"]  = minmax(df["tree_equity_score"])
+    df["need"]      = (1 - df["ndvi_norm"]) * 0.5 + (1 - df["tes_norm"]) * 0.5
+
+    if y_col == "pct_minority":
+        df["shade_norm"] = minmax(df[y_col])         # high = darker
+    else:
+        df["shade_norm"] = 1 - minmax(df[y_col])     # low income = darker
+
+    top15 = df.nlargest(15, "need").reset_index(drop=True)
+    labels = [str(g)[-6:] for g in top15["GEOID"]]
+    x = np.arange(len(top15))
+
+    fig, ax = plt.subplots(figsize=(10, 3.2), facecolor="#161b22")
+    ax.set_facecolor("#161b22")
+
+    for i, row in top15.iterrows():
+        alpha = 0.3 + 0.7 * row["shade_norm"]
+        ax.bar(i, row["need"], color="#e05c5c", alpha=alpha, width=0.6)
+
+    # Shade legend
+    y_label = "% Minority" if y_col == "pct_minority" else "Median Income"
+    from matplotlib.patches import Patch
+    legend_elements = [
+        Patch(facecolor="#e05c5c", alpha=1.0,
+              label=f"High concern ({('high' if y_col == 'pct_minority' else 'low')} {y_label})"),
+        Patch(facecolor="#e05c5c", alpha=0.3,
+              label=f"Lower concern ({('low' if y_col == 'pct_minority' else 'high')} {y_label})"),
+    ]
+
+    ax.set_xticks(x)
+    ax.set_xticklabels(labels, rotation=45, ha="right", color="#8b949e", fontsize=8)
+    ax.set_ylabel("Tree Need Score", color="#8b949e", fontsize=8)
+    ax.set_title("Top 15 Block Groups by Tree Program Need  (GEOID suffix)",
+                 color="#c9d1d9", fontsize=9, pad=6)
+    ax.tick_params(colors="#8b949e", labelsize=8)
+    for sp in ax.spines.values():
+        sp.set_color("#30363d")
+    ax.legend(handles=legend_elements, frameon=False,
+              labelcolor="#8b949e", fontsize=8, loc="upper right")
+    fig.tight_layout(pad=0.5)
+    return fig
+
+def build_need_map(con, y_col):
+    df = con.sql(f"""
+        SELECT GEOID, geometry_wkt, ndvi_mean, tree_equity_score, {y_col}
+        FROM block_groups
+        WHERE ndvi_mean IS NOT NULL AND tree_equity_score IS NOT NULL
+          AND {y_col} IS NOT NULL AND total_pop > 0
+    """).df()
+
+    def minmax(s):
+        mn, mx = s.min(), s.max()
+        return (s - mn) / (mx - mn) if mx > mn else s * 0
+
+    df["ndvi_norm"] = minmax(df["ndvi_mean"])
+    df["tes_norm"]  = minmax(df["tree_equity_score"])
+    df["need"]      = (1 - df["ndvi_norm"]) * 0.5 + (1 - df["tes_norm"]) * 0.5
+
+    top15_geoids = set(df.nlargest(15, "need")["GEOID"].tolist())
+
+    gdf = gpd.GeoDataFrame(
+        df,
+        geometry=gpd.GeoSeries.from_wkt(df["geometry_wkt"]),
+        crs="EPSG:4269"
+    ).drop(columns="geometry_wkt")
+
+    import folium
+    m = folium.Map(location=[33.45, -112.07], zoom_start=9,
+                   tiles="CartoDB dark_matter")
+
+    for _, row in gdf.iterrows():
+        is_top15 = row["GEOID"] in top15_geoids
+        folium.GeoJson(
+            row.geometry.__geo_interface__,
+            style_function=lambda f, top=is_top15: {
+                "fillColor":   "#e05c5c" if top else "#444444",
+                "fillOpacity": 0.85 if top else 0.3,
+                "color":       "#e05c5c" if top else "#333333",
+                "weight":      1.5 if top else 0.3,
+            }
+        ).add_to(m)
+
+    return m

data/raw/az_tes.cpg

@@ -0,0 +1 @@
+ISO-8859-1

data/raw/az_tes.dbf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5e8488214fc81dfcde13c3847625b9442f868b817511fd55912ff29558a42cd9
+size 7506815

data/raw/az_tes.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]

data/raw/az_tes.shp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:71404d595ba3c309d7623bc471e1007f0e1ef1f9ace75f6f91ea05548e8f3e9e
+size 7430980

data/raw/az_tes.shx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f24fea442901a860a4e40a76ba3ee6f692f167df19779fbf38e68a1184313225
+size 34508

data/raw/data_dictionary.txt

@@ -0,0 +1,56 @@
+GEOID: the U.S. Census blockgroup id
+place: the city, town, village or unincorporated community the block group is mostly within
+state: the state the block group is in
+state_abbr: the state abbreviation
+county: the county the block group is in
+ua_name: the urban area the block group is located in
+ua_pop: the sum of the clipped block group population in the urban area
+congressio:  the congressional district of the block group
+cbg_pop: the total population of the clipped block group (the part of the block group within the urban area) from the 2020 Census
+acs_pop: the total population of the entire block group (includes non-urban population) from the ACS Community Survey 2017-2021 Estimates
+land_area: the land area of the blockgroup in square kilometers (omits water area)
+biome:  the biome of the blockgroup
+cnpysource: the source of the tree canopy data of the block group
+tc_goal: the tree canopy goal of the block group [range: 0-1]
+treecanopy: the tree canopy percentage of the block group [range: 0-1]
+tc_gap: the tree canopy gap of the block group (goal minus canopy) [range: 0-1]
+priority_i: the priority index of the block group [range: 0-1]
+pctpoc: the percent of people of color inside the block group [range: 0-1]
+pctpocnorm: the normalized percent people of color inside the block group [range: 0-1]
+pctpov: the percent of people in poverty inside the block group [range: 0-1]
+pctpovnorm: the normalized percent people in poverty inside the block group [range: 0-1]
+unemplrate: the unemployment rate inside of the block group [range: 0-1]
+unemplnorm: the normalized unemployment rate inside the block group [range: 0-1]
+dep_ratio: the dependency ratio (childrens + seniors / 18-64 adults)
+depratnorm: the normalized dependency ratio inside the block group [range: 0-1]
+dep_perc: the percent of the population that are children and seniors [range: 0-1]
+linguistic: the percent of households where no person age 14+ speaks only English, or no person age 14+ who speaks a language other than English speaks English "very well." inside the block group [range: 0-1]
+lingnorm: the normalized percent of linguistic isolation present in the block group [range: 0-1]
+healthnorm: the normalized health burden index of the block group [range: 0-1]
+temp_diff: the difference between the average block group heat extremity with the urban area average to measure variance in heat severity across an urban area
+temp_norm: the normalized temp_diff value of the block group [range: 0-1]
+tes: the Tree Equity Score of the block group [range: 0-100]
+tesctyscor: the composite score of the locality (ex: incorporated place, census designated place) aggregated from all block group Tree Equity Scores within the locality [range: 0-100, none if not in a locality]
+holc_grade: Home Owner's Loan Corporation grades from Mapping Inequality,  from �A,� the highest grade treated as low risk for mortgage lenders, to �D� the lowest grade deemed "hazardous."
+child_perc: the percent of children inside of the block group [range: 0-1]
+seniorperc: the percent of seniors inside of the block group [range: 0-1]
+ej_disadva: communities determined to be "disadvantaged" by the US Environmental Protection Agency under the Inflation Reduction Act
+rank: the rank of the Tree Equity Score compared to the other block groups in the municipalitity
+rankgrpsz: the number of block groups in the municipality which are ranked against one another
+_bld1200: percent shade cast by buildings at noon
+_veg1200: percent shade cast by trees and other non-building features at noon
+_bld1500: percent shade cast by buildings at 3 p.m.
+_veg1500: percent shade cast by trees and other non-building features at 3 p.m.
+_bld1800: percent shade cast by buildings at 6 p.m.
+_veg1800: percent shade cast by trees and other non-building features sat 6 p.m.
+_tot1200: total percent shade cast at noon
+_tot1500: total percent shade cast at 3 p.m.
+_tot1800: total percent shade cast at 6 p.m.
+geometry: the geometry of the block group (for geojson and shapefile)
+
+Questions about methodology or data sources? Visit https://www.treeequityscore.org/methodology/ for more details.
+
+
+
+
+

data/raw/tiger_maricopa/tl_2022_04_bg.cpg

@@ -0,0 +1 @@
+UTF-8

data/raw/tiger_maricopa/tl_2022_04_bg.dbf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:043f0c076c88a46cf6d0d6312767e051e0e1221dafe89de3db04b8852a0d5e38
+size 453853

data/raw/tiger_maricopa/tl_2022_04_bg.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137,298.257222101]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]]

data/raw/tiger_maricopa/tl_2022_04_bg.shp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:fce7d8811a46f3ac379c3f9fdb00f52e3497ebaf6e35b99a1af440b5da8baf25
+size 21182396

data/raw/tiger_maricopa/tl_2022_04_bg.shp.ea.iso.xml

@@ -0,0 +1,406 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<gfc:FC_FeatureCatalogue xmlns:xlink="http://www.w3.org/1999/xlink"
+                         xmlns:gmd="http://www.isotc211.org/2005/gmd"
+                         xmlns:gco="http://www.isotc211.org/2005/gco"
+                         xmlns:gml="http://www.opengis.net/gml/3.2"
+                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                         xmlns:gmi="http://www.isotc211.org/2005/gmi"
+                         xmlns:srv="http://www.isotc211.org/2005/srv"
+                         xmlns:gmx="http://www.isotc211.org/2005/gmx"
+                         xmlns:gfc="http://www.isotc211.org/2005/gfc">
+   <gmx:name>
+      <gco:CharacterString>Feature Catalog for the Current Block Groups TIGER/Line Shapefiles</gco:CharacterString>
+   </gmx:name>
+   <gmx:scope>
+      <gco:CharacterString>Block Groups</gco:CharacterString>
+   </gmx:scope>
+   <gmx:versionNumber>
+      <gco:CharacterString>2022</gco:CharacterString>
+   </gmx:versionNumber>
+   <gmx:versionDate>
+      <gco:Date>2022-09-29</gco:Date>
+   </gmx:versionDate>
+   <gmx:language>
+      <gco:CharacterString>eng; USA</gco:CharacterString>
+   </gmx:language>
+   <gmx:characterSet>
+      <gmd:MD_CharacterSetCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_CharacterSetCode"
+                               codeListValue="utf8">utf8</gmd:MD_CharacterSetCode>
+   </gmx:characterSet>
+   <gfc:producer>
+      <gmd:CI_ResponsibleParty>
+         <gmd:organisationName>
+            <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+         </gmd:organisationName>
+         <gmd:contactInfo>
+            <gmd:CI_Contact>
+               <gmd:phone>
+                  <gmd:CI_Telephone>
+                     <gmd:voice>
+                        <gco:CharacterString>301-763-1128</gco:CharacterString>
+                     </gmd:voice>
+                     <gmd:facsimile>
+                        <gco:CharacterString>301-763-4710</gco:CharacterString>
+                     </gmd:facsimile>
+                  </gmd:CI_Telephone>
+               </gmd:phone>
+               <gmd:address>
+                  <gmd:CI_Address>
+                     <gmd:deliveryPoint>
+                        <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                     </gmd:deliveryPoint>
+                     <gmd:city>
+                        <gco:CharacterString>Washington</gco:CharacterString>
+                     </gmd:city>
+                     <gmd:administrativeArea>
+                        <gco:CharacterString>DC</gco:CharacterString>
+                     </gmd:administrativeArea>
+                     <gmd:postalCode>
+                        <gco:CharacterString>20233-7400</gco:CharacterString>
+                     </gmd:postalCode>
+                     <gmd:country>
+                        <gco:CharacterString>United States</gco:CharacterString>
+                     </gmd:country>
+                     <gmd:electronicMailAddress>
+                        <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                     </gmd:electronicMailAddress>
+                  </gmd:CI_Address>
+               </gmd:address>
+            </gmd:CI_Contact>
+         </gmd:contactInfo>
+         <gmd:role>
+            <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                             codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+         </gmd:role>
+      </gmd:CI_ResponsibleParty>
+   </gfc:producer>
+   <gfc:featureType>
+      <gfc:FC_FeatureType>
+         <gfc:typeName>
+            <gco:LocalName>BG.shp</gco:LocalName>
+         </gfc:typeName>
+         <gfc:definition>
+            <gco:CharacterString>Current Block Group State-based</gco:CharacterString>
+         </gfc:definition>
+         <gfc:isAbstract>
+            <gco:Boolean>false</gco:Boolean>
+         </gfc:isAbstract>
+         <gfc:featureCatalogue uuidref="tl_2022_bg.shp.ea.iso.xml"/>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>STATEFP</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current state Federal Information Processing Series (FIPS) code</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>National Standard Codes (ANSI INCITS 38-2009), Federal Information Processing Series (FIPS) - States/State Equivalents</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>COUNTYFP</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current county Federal Information Processing Series (FIPS) code</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>National Standard Codes (ANSI INCITS 31-2009), Federal Information Processing Series (FIPS) - Counties/County Equivalents</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>TRACTCE</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current census tract code</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>000100 to 998999</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definition>
+                        <gco:CharacterString>Census tract number</gco:CharacterString>
+                     </gfc:definition>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>990000 to 990099</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definition>
+                        <gco:CharacterString>Water tract (2010 and continuing)</gco:CharacterString>
+                     </gfc:definition>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>990100 to 998999</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definition>
+                        <gco:CharacterString>Census tract number</gco:CharacterString>
+                     </gfc:definition>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>BLKGRPCE</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current block group number. A block group number of 0 represents a water block group.</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality>
+                  <gco:Multiplicity>
+                     <gco:range>
+                        <gco:MultiplicityRange>
+                           <gco:lower>
+                              <gco:Integer>0</gco:Integer>
+                           </gco:lower>
+                           <gco:upper>
+                              <gco:UnlimitedInteger>9</gco:UnlimitedInteger>
+                           </gco:upper>
+                        </gco:MultiplicityRange>
+                     </gco:range>
+                  </gco:Multiplicity>
+               </gfc:cardinality>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>GEOID</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Census block group identifier; a concatenation of the current state Federal Information Processing Series (FIPS) code, county FIPS code, census tract code, and block group number</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label gco:nilReason="inapplicable"/>
+                     <gfc:definition>
+                        <gco:CharacterString>The GEOID attribute is a concatenation of the state FIPS code, followed by the county FIPS code, followed by the census tract code, followed by the block group number. No spaces are allowed between the two codes. The State FIPS code is taken from "National Standard Codes (ANSI INCITS 38-2009), Federal Information Processing Series (FIPS) - States". The county FIPS code is taken from "National Standard Codes (ANSI INCITS 31-2009), Federal Information Processing Series (FIPS) - Counties/County Equivalents". The census tract code is taken from the "TRACTCE" attribute. The block group number is taken from the "BLKGRPCE" attribute.</gco:CharacterString>
+                     </gfc:definition>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>NAMELSAD</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current translated legal/statistical area description and the block group number</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label gco:nilReason="inapplicable"/>
+                     <gfc:definition>
+                        <gco:CharacterString>Refer to the block group number that appears in BLKGRPCE and translated legal/statistical area description code BG, Block Group</gco:CharacterString>
+                     </gfc:definition>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>MTFCC</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>MAF/TIGER feature class code</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>G5030</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definition>
+                        <gco:CharacterString>Block Group</gco:CharacterString>
+                     </gfc:definition>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>FUNCSTAT</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current functional status</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality gco:nilReason="unknown"/>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+               <gfc:listedValue>
+                  <gfc:FC_ListedValue>
+                     <gfc:label>
+                        <gco:CharacterString>S</gco:CharacterString>
+                     </gfc:label>
+                     <gfc:definition>
+                        <gco:CharacterString>Statistical entity</gco:CharacterString>
+                     </gfc:definition>
+                     <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                              xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+                  </gfc:FC_ListedValue>
+               </gfc:listedValue>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>ALAND</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current land area (square meters)</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality>
+                  <gco:Multiplicity>
+                     <gco:range>
+                        <gco:MultiplicityRange>
+                           <gco:lower>
+                              <gco:Integer>0</gco:Integer>
+                           </gco:lower>
+                           <gco:upper>
+                              <gco:UnlimitedInteger>9,999,999,999,999</gco:UnlimitedInteger>
+                           </gco:upper>
+                        </gco:MultiplicityRange>
+                     </gco:range>
+                  </gco:Multiplicity>
+               </gfc:cardinality>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>AWATER</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current water area (square meters)</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality>
+                  <gco:Multiplicity>
+                     <gco:range>
+                        <gco:MultiplicityRange>
+                           <gco:lower>
+                              <gco:Integer>0</gco:Integer>
+                           </gco:lower>
+                           <gco:upper>
+                              <gco:UnlimitedInteger>9,999,999,999,999</gco:UnlimitedInteger>
+                           </gco:upper>
+                        </gco:MultiplicityRange>
+                     </gco:range>
+                  </gco:Multiplicity>
+               </gfc:cardinality>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>INTPTLAT</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current latitude of the internal point</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality>
+                  <gco:Multiplicity>
+                     <gco:range>
+                        <gco:MultiplicityRange>
+                           <gco:lower>
+                              <gco:Integer>-90</gco:Integer>
+                           </gco:lower>
+                           <gco:upper>
+                              <gco:UnlimitedInteger>90</gco:UnlimitedInteger>
+                           </gco:upper>
+                        </gco:MultiplicityRange>
+                     </gco:range>
+                  </gco:Multiplicity>
+               </gfc:cardinality>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+         <gfc:carrierOfCharacteristics>
+            <gfc:FC_FeatureAttribute>
+               <gfc:memberName>
+                  <gco:LocalName>INTPTLON</gco:LocalName>
+               </gfc:memberName>
+               <gfc:definition>
+                  <gco:CharacterString>Current longitude of the internal point</gco:CharacterString>
+               </gfc:definition>
+               <gfc:cardinality>
+                  <gco:Multiplicity>
+                     <gco:range>
+                        <gco:MultiplicityRange>
+                           <gco:lower>
+                              <gco:Integer>-180</gco:Integer>
+                           </gco:lower>
+                           <gco:upper>
+                              <gco:UnlimitedInteger>180</gco:UnlimitedInteger>
+                           </gco:upper>
+                        </gco:MultiplicityRange>
+                     </gco:range>
+                  </gco:Multiplicity>
+               </gfc:cardinality>
+               <gfc:definitionReference xlink:title="U.S Census Bureau"
+                                        xlink:href="http://www.ngdc.noaa.gov/docucomp/eb139e38-ee29-4d59-b157-5e874d4420c4"/>
+            </gfc:FC_FeatureAttribute>
+         </gfc:carrierOfCharacteristics>
+      </gfc:FC_FeatureType>
+   </gfc:featureType>
+</gfc:FC_FeatureCatalogue>

data/raw/tiger_maricopa/tl_2022_04_bg.shp.iso.xml

@@ -0,0 +1,852 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<gmi:MI_Metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                 xmlns:gmd="http://www.isotc211.org/2005/gmd"
+                 xmlns:gco="http://www.isotc211.org/2005/gco"
+                 xmlns:gml="http://www.opengis.net/gml/3.2"
+                 xmlns:gmi="http://www.isotc211.org/2005/gmi"
+                 xmlns:xlink="http://www.w3.org/1999/xlink"
+                 xmlns:srv="http://www.isotc211.org/2005/srv"
+                 xsi:schemaLocation="http://www.isotc211.org/2005/gmi https://data.noaa.gov/resources/iso19139/schema.xsd">
+   <gmd:fileIdentifier>
+      <gco:CharacterString>tl_2022_04_bg.shp.iso.xml</gco:CharacterString>
+   </gmd:fileIdentifier>
+   <gmd:language>
+      <gco:CharacterString>eng; USA</gco:CharacterString>
+   </gmd:language>
+   <gmd:characterSet>
+      <gmd:MD_CharacterSetCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_CharacterSetCode"
+                               codeListValue="utf8">utf8</gmd:MD_CharacterSetCode>
+   </gmd:characterSet>
+   <gmd:parentIdentifier>
+      <gco:CharacterString>series_tl_2022_bg.shp.iso.xml</gco:CharacterString>
+   </gmd:parentIdentifier>
+   <gmd:hierarchyLevel>
+      <gmd:MD_ScopeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ScopeCode"
+                        codeListValue="dataset">dataset</gmd:MD_ScopeCode>
+   </gmd:hierarchyLevel>
+   <gmd:contact>
+      <gmd:CI_ResponsibleParty>
+         <gmd:organisationName>
+            <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+         </gmd:organisationName>
+         <gmd:contactInfo>
+            <gmd:CI_Contact>
+               <gmd:phone>
+                  <gmd:CI_Telephone>
+                     <gmd:voice>
+                        <gco:CharacterString>301-763-1128</gco:CharacterString>
+                     </gmd:voice>
+                     <gmd:facsimile>
+                        <gco:CharacterString>301-763-4710</gco:CharacterString>
+                     </gmd:facsimile>
+                  </gmd:CI_Telephone>
+               </gmd:phone>
+               <gmd:address>
+                  <gmd:CI_Address>
+                     <gmd:deliveryPoint>
+                        <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                     </gmd:deliveryPoint>
+                     <gmd:city>
+                        <gco:CharacterString>Washington</gco:CharacterString>
+                     </gmd:city>
+                     <gmd:administrativeArea>
+                        <gco:CharacterString>DC</gco:CharacterString>
+                     </gmd:administrativeArea>
+                     <gmd:postalCode>
+                        <gco:CharacterString>20233-7400</gco:CharacterString>
+                     </gmd:postalCode>
+                     <gmd:country>
+                        <gco:CharacterString>United States</gco:CharacterString>
+                     </gmd:country>
+                     <gmd:electronicMailAddress>
+                        <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                     </gmd:electronicMailAddress>
+                  </gmd:CI_Address>
+               </gmd:address>
+            </gmd:CI_Contact>
+         </gmd:contactInfo>
+         <gmd:role>
+            <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                             codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+         </gmd:role>
+      </gmd:CI_ResponsibleParty>
+   </gmd:contact>
+   <gmd:dateStamp>
+      <gco:Date>2022-09-29</gco:Date>
+   </gmd:dateStamp>
+   <gmd:metadataStandardName>
+      <gco:CharacterString>ISO 19115-2 Geographic Information - Metadata - Part 2: Extensions for Imagery and Gridded Data</gco:CharacterString>
+   </gmd:metadataStandardName>
+   <gmd:metadataStandardVersion>
+      <gco:CharacterString>ISO 19115-2:2009(E)</gco:CharacterString>
+   </gmd:metadataStandardVersion>
+   <gmd:dataSetURI>
+      <gco:CharacterString>https://meta.geo.census.gov/data/existing/decennial/GEO/GPMB/TIGERline/Current_19115/tl_2022_04_bg.shp.iso.xml</gco:CharacterString>
+   </gmd:dataSetURI>
+   <gmd:spatialRepresentationInfo>
+      <gmd:MD_VectorSpatialRepresentation>
+         <gmd:geometricObjects>
+            <gmd:MD_GeometricObjects>
+               <gmd:geometricObjectType>
+                  <gmd:MD_GeometricObjectTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_GeometricObjectTypeCode"
+                                                  codeListValue="complex">complex</gmd:MD_GeometricObjectTypeCode>
+               </gmd:geometricObjectType>
+               <gmd:geometricObjectCount>
+                  <gco:Integer>4773</gco:Integer>
+               </gmd:geometricObjectCount>
+            </gmd:MD_GeometricObjects>
+         </gmd:geometricObjects>
+      </gmd:MD_VectorSpatialRepresentation>
+   </gmd:spatialRepresentationInfo>
+   <gmd:referenceSystemInfo>
+      <gmd:MD_ReferenceSystem uuid="65f8b220-95ed-11e0-aa80-0800200c9a66">
+         <gmd:referenceSystemIdentifier>
+            <gmd:RS_Identifier>
+               <gmd:authority>
+                  <gmd:CI_Citation>
+                     <gmd:title>
+                        <gco:CharacterString>North American Datum of 1983</gco:CharacterString>
+                     </gmd:title>
+                     <gmd:alternateTitle>
+                        <gco:CharacterString>NAD83</gco:CharacterString>
+                     </gmd:alternateTitle>
+                     <gmd:date>
+                        <gmd:CI_Date>
+                           <gmd:date>
+                              <gco:Date>2007-01-19</gco:Date>
+                           </gmd:date>
+                           <gmd:dateType>
+                              <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                                   codeListValue="revision">revision</gmd:CI_DateTypeCode>
+                           </gmd:dateType>
+                        </gmd:CI_Date>
+                     </gmd:date>
+                     <gmd:citedResponsibleParty>
+                        <gmd:CI_ResponsibleParty>
+                           <gmd:organisationName gco:nilReason="withheld"/>
+                           <gmd:contactInfo>
+                              <gmd:CI_Contact>
+                                 <gmd:onlineResource>
+                                    <gmd:CI_OnlineResource>
+                                       <gmd:linkage>
+                                          <gmd:URL>https://spatialreference.org/ref/epsg/4269/gml/</gmd:URL>
+                                       </gmd:linkage>
+                                       <gmd:name>
+                                          <gco:CharacterString>NAD83</gco:CharacterString>
+                                       </gmd:name>
+                                       <gmd:description>
+                                          <gco:CharacterString>Link to Geographic Markup Language (GML) description of reference system.</gco:CharacterString>
+                                       </gmd:description>
+                                       <gmd:function>
+                                          <gmd:CI_OnLineFunctionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode"
+                                                                     codeListValue="information">information</gmd:CI_OnLineFunctionCode>
+                                       </gmd:function>
+                                    </gmd:CI_OnlineResource>
+                                 </gmd:onlineResource>
+                              </gmd:CI_Contact>
+                           </gmd:contactInfo>
+                           <gmd:role>
+                              <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                               codeListValue="resourceProvider">resourceProvider</gmd:CI_RoleCode>
+                           </gmd:role>
+                        </gmd:CI_ResponsibleParty>
+                     </gmd:citedResponsibleParty>
+                  </gmd:CI_Citation>
+               </gmd:authority>
+               <gmd:code>
+                  <gco:CharacterString>urn:ogc:def:crs:EPSG::4269</gco:CharacterString>
+               </gmd:code>
+            </gmd:RS_Identifier>
+         </gmd:referenceSystemIdentifier>
+      </gmd:MD_ReferenceSystem>
+   </gmd:referenceSystemInfo>
+   <gmd:identificationInfo>
+      <gmd:MD_DataIdentification>
+         <gmd:citation>
+            <gmd:CI_Citation>
+               <gmd:title>
+                  <gco:CharacterString>TIGER/Line Shapefile, Current, State, Arizona, Block Group</gco:CharacterString>
+               </gmd:title>
+               <gmd:alternateTitle>
+                  <gco:CharacterString>TIGER/Line Shapefile, 2022, State, Arizona, AZ, Block Group</gco:CharacterString>
+               </gmd:alternateTitle>
+               <gmd:date>
+                  <gmd:CI_Date>
+                     <gmd:date>
+                        <gco:Date>2022</gco:Date>
+                     </gmd:date>
+                     <gmd:dateType>
+                        <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                             codeListValue="publication">publication</gmd:CI_DateTypeCode>
+                     </gmd:dateType>
+                  </gmd:CI_Date>
+               </gmd:date>
+               <gmd:date>
+                  <gmd:CI_Date>
+                     <gmd:date>
+                        <gco:Date>2022-08</gco:Date>
+                     </gmd:date>
+                     <gmd:dateType>
+                        <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                             codeListValue="creation">creation</gmd:CI_DateTypeCode>
+                     </gmd:dateType>
+                  </gmd:CI_Date>
+               </gmd:date>
+               <gmd:date>
+                  <gmd:CI_Date>
+                     <gmd:date>
+                        <gco:Date>2022-08</gco:Date>
+                     </gmd:date>
+                     <gmd:dateType>
+                        <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                             codeListValue="lastUpdate">lastUpdate</gmd:CI_DateTypeCode>
+                     </gmd:dateType>
+                  </gmd:CI_Date>
+               </gmd:date>
+               <gmd:identifier>
+                  <gmd:MD_Identifier>
+                     <gmd:code>
+                        <gco:CharacterString>tl_2022_04_bg</gco:CharacterString>
+                     </gmd:code>
+                  </gmd:MD_Identifier>
+               </gmd:identifier>
+               <gmd:citedResponsibleParty>
+                  <gmd:CI_ResponsibleParty>
+                     <gmd:organisationName>
+                        <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+                     </gmd:organisationName>
+                     <gmd:contactInfo>
+                        <gmd:CI_Contact>
+                           <gmd:phone>
+                              <gmd:CI_Telephone>
+                                 <gmd:voice>
+                                    <gco:CharacterString>301-763-1128</gco:CharacterString>
+                                 </gmd:voice>
+                                 <gmd:facsimile>
+                                    <gco:CharacterString>301-763-4710</gco:CharacterString>
+                                 </gmd:facsimile>
+                              </gmd:CI_Telephone>
+                           </gmd:phone>
+                           <gmd:address>
+                              <gmd:CI_Address>
+                                 <gmd:deliveryPoint>
+                                    <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                                 </gmd:deliveryPoint>
+                                 <gmd:city>
+                                    <gco:CharacterString>Washington</gco:CharacterString>
+                                 </gmd:city>
+                                 <gmd:administrativeArea>
+                                    <gco:CharacterString>DC</gco:CharacterString>
+                                 </gmd:administrativeArea>
+                                 <gmd:postalCode>
+                                    <gco:CharacterString>20233-7400</gco:CharacterString>
+                                 </gmd:postalCode>
+                                 <gmd:country>
+                                    <gco:CharacterString>United States</gco:CharacterString>
+                                 </gmd:country>
+                                 <gmd:electronicMailAddress>
+                                    <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                                 </gmd:electronicMailAddress>
+                              </gmd:CI_Address>
+                           </gmd:address>
+                        </gmd:CI_Contact>
+                     </gmd:contactInfo>
+                     <gmd:role>
+                        <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                         codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+                     </gmd:role>
+                  </gmd:CI_ResponsibleParty>
+               </gmd:citedResponsibleParty>
+               <gmd:presentationForm>
+                  <gmd:CI_PresentationFormCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_PresentationFormCode"
+                                               codeListValue="mapDigital">mapDigital</gmd:CI_PresentationFormCode>
+               </gmd:presentationForm>
+            </gmd:CI_Citation>
+         </gmd:citation>
+         <gmd:abstract>
+            <gco:CharacterString>This resource is a member of a series. The TIGER/Line shapefiles and related database files (.dbf) are an extract of selected geographic and cartographic information from the U.S. Census Bureau's Master Address File / Topologically Integrated Geographic Encoding and Referencing (MAF/TIGER) Database (MTDB).  The MTDB represents a seamless national file with no overlaps or gaps between parts, however, each TIGER/Line shapefile is designed to stand alone as an independent data set, or they can be combined to cover the entire nation.
+Block Groups (BGs) are clusters of blocks within the same census tract. Each census tract contains at least one BG, and BGs are uniquely numbered within census tracts.  BGs have a valid code range of 0 through 9. BGs have the same first digit of their 4-digit census block number from the same decennial census.  For example, tabulation blocks numbered 3001, 3002, 3003,.., 3999 within census tract 1210.02 are also within BG 3 within that census tract.  BGs coded 0 are intended to only include water area, no land area, and they are generally in territorial seas, coastal water, and Great Lakes water areas. Block groups generally contain between 600 and 3,000 people.  A BG usually covers a contiguous area but never crosses county or census tract boundaries. They may, however, cross the boundaries of other geographic entities like county subdivisions, places, urban areas, voting districts, congressional districts, and American Indian / Alaska Native / Native Hawaiian areas.
+The BG boundaries in this release are those that were delineated as part of the Census Bureau's Participant Statistical Areas Program (PSAP) for the 2020 Census.</gco:CharacterString>
+         </gmd:abstract>
+         <gmd:purpose>
+            <gco:CharacterString>The Census Bureau releases extracts of the MAF/TIGER database in the form of TIGER/Line Shapefiles for others to use in geographic information systems (GIS) or for other geographic applications.</gco:CharacterString>
+         </gmd:purpose>
+         <gmd:status>
+            <gmd:MD_ProgressCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ProgressCode"
+                                 codeListValue="completed">completed</gmd:MD_ProgressCode>
+         </gmd:status>
+         <gmd:pointOfContact>
+            <gmd:CI_ResponsibleParty>
+               <gmd:organisationName>
+                  <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+               </gmd:organisationName>
+               <gmd:contactInfo>
+                  <gmd:CI_Contact>
+                     <gmd:phone>
+                        <gmd:CI_Telephone>
+                           <gmd:voice>
+                              <gco:CharacterString>301-763-1128</gco:CharacterString>
+                           </gmd:voice>
+                           <gmd:facsimile>
+                              <gco:CharacterString>301-763-4710</gco:CharacterString>
+                           </gmd:facsimile>
+                        </gmd:CI_Telephone>
+                     </gmd:phone>
+                     <gmd:address>
+                        <gmd:CI_Address>
+                           <gmd:deliveryPoint>
+                              <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                           </gmd:deliveryPoint>
+                           <gmd:city>
+                              <gco:CharacterString>Washington</gco:CharacterString>
+                           </gmd:city>
+                           <gmd:administrativeArea>
+                              <gco:CharacterString>DC</gco:CharacterString>
+                           </gmd:administrativeArea>
+                           <gmd:postalCode>
+                              <gco:CharacterString>20233-7400</gco:CharacterString>
+                           </gmd:postalCode>
+                           <gmd:country>
+                              <gco:CharacterString>United States</gco:CharacterString>
+                           </gmd:country>
+                           <gmd:electronicMailAddress>
+                              <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                           </gmd:electronicMailAddress>
+                        </gmd:CI_Address>
+                     </gmd:address>
+                  </gmd:CI_Contact>
+               </gmd:contactInfo>
+               <gmd:role>
+                  <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                   codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+               </gmd:role>
+            </gmd:CI_ResponsibleParty>
+         </gmd:pointOfContact>
+         <gmd:resourceMaintenance>
+            <gmd:MD_MaintenanceInformation>
+               <gmd:maintenanceAndUpdateFrequency>
+                  <gmd:MD_MaintenanceFrequencyCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_MaintenanceFrequencyCode"
+                                                   codeListValue="notPlanned">notPlanned</gmd:MD_MaintenanceFrequencyCode>
+               </gmd:maintenanceAndUpdateFrequency>
+            </gmd:MD_MaintenanceInformation>
+         </gmd:resourceMaintenance>
+         <gmd:graphicOverview>
+            <gmd:MD_BrowseGraphic>
+               <gmd:fileName>
+                  <gco:CharacterString>https://tigerweb.geo.census.gov/arcgis/services/TIGERweb/tigerWMS_Current/MapServer/WmsServer?REQUEST=GetMap&amp;SERVICE=WMS&amp;VERSION=1.3.0&amp;LAYERS=Census_Block_Groups59805,Census_Block_Groups_Labels32376&amp;STYLES=default,default&amp;FORMAT=image/png+xml&amp;BGCOLOR=0xFFFFFF&amp;TRANSPARENT=TRUE&amp;CRS=EPSG:4326&amp;BBOX=+38.8810,-77.0401,+38.9008,-77.0035&amp;WIDTH=256&amp;HEIGHT=256</gco:CharacterString>
+               </gmd:fileName>
+               <gmd:fileDescription>
+                  <gco:CharacterString>URL for the TIGERWeb Mapping Service</gco:CharacterString>
+               </gmd:fileDescription>
+               <gmd:fileType>
+                  <gco:CharacterString>URL</gco:CharacterString>
+               </gmd:fileType>
+            </gmd:MD_BrowseGraphic>
+         </gmd:graphicOverview>
+         <gmd:descriptiveKeywords>
+            <gmd:MD_Keywords>
+               <gmd:keyword>
+                  <gco:CharacterString>State or equivalent entity</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>Polygon</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>Block Group</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>BG</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:type>
+                  <gmd:MD_KeywordTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode"
+                                          codeListValue="theme"/>
+               </gmd:type>
+               <gmd:thesaurusName>
+                  <gmd:CI_Citation>
+                     <gmd:title>
+                        <gco:CharacterString>None</gco:CharacterString>
+                     </gmd:title>
+                     <gmd:date gco:nilReason="unknown"/>
+                  </gmd:CI_Citation>
+               </gmd:thesaurusName>
+            </gmd:MD_Keywords>
+         </gmd:descriptiveKeywords>
+         <gmd:descriptiveKeywords>
+            <gmd:MD_Keywords>
+               <gmd:keyword>
+                  <gco:CharacterString>State or Equivalent Entity</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>Arizona</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>AZ</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:keyword>
+                  <gco:CharacterString>04</gco:CharacterString>
+               </gmd:keyword>
+               <gmd:type>
+                  <gmd:MD_KeywordTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode"
+                                          codeListValue="place"/>
+               </gmd:type>
+               <gmd:thesaurusName>
+                  <gmd:CI_Citation>
+                     <gmd:title>
+                        <gco:CharacterString>INCITS 38-2009[R2019]: Information Technology - Codes for the Identification of the States and Equivalent Areas within the United States, Puerto Rico, and the Insular Areas.</gco:CharacterString>
+                     </gmd:title>
+                     <gmd:date gco:nilReason="unknown"/>
+                  </gmd:CI_Citation>
+               </gmd:thesaurusName>
+            </gmd:MD_Keywords>
+         </gmd:descriptiveKeywords>
+         <gmd:resourceConstraints>
+            <gmd:MD_LegalConstraints>
+               <gmd:accessConstraints>
+                  <gmd:MD_RestrictionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_RestrictionCode"
+                                          codeListValue="otherRestrictions">otherRestrictions</gmd:MD_RestrictionCode>
+               </gmd:accessConstraints>
+               <gmd:useConstraints>
+                  <gmd:MD_RestrictionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_RestrictionCode"
+                                          codeListValue="otherRestrictions">otherRestrictions</gmd:MD_RestrictionCode>
+               </gmd:useConstraints>
+               <gmd:otherConstraints>
+                  <gco:CharacterString>Access constraints: None</gco:CharacterString>
+               </gmd:otherConstraints>
+               <gmd:otherConstraints>
+                  <gco:CharacterString>Use Constraints: The TIGER/Line Shapefile products are not copyrighted however TIGER/Line and Census TIGER are registered trademarks of the U.S. Census Bureau. These products are free to use in a product or publication, however acknowledgement must be given to the U.S. Census Bureau as the source.
+The boundary information in the TIGER/Line Shapefiles are for statistical data collection and tabulation purposes only; their depiction and designation for statistical purposes does not constitute a determination of jurisdictional authority or rights of ownership or entitlement and they are not legal land descriptions. Coordinates in the TIGER/Line shapefiles have six implied decimal places, but the positional accuracy of these coordinates is not as great as the six decimal places suggest.</gco:CharacterString>
+               </gmd:otherConstraints>
+            </gmd:MD_LegalConstraints>
+         </gmd:resourceConstraints>
+         <gmd:aggregationInfo>
+            <gmd:MD_AggregateInformation>
+               <gmd:aggregateDataSetName>
+                  <gmd:CI_Citation>
+                     <gmd:title>
+                        <gco:CharacterString>Series Information for Block Group State-based TIGER/Line Shapefiles, Current</gco:CharacterString>
+                     </gmd:title>
+                     <gmd:date>
+                        <gmd:CI_Date>
+                           <gmd:date>
+                              <gco:Date>2022</gco:Date>
+                           </gmd:date>
+                           <gmd:dateType>
+                              <gmd:CI_DateTypeCode codeList="https://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                                   codeListValue="publication">publication</gmd:CI_DateTypeCode>
+                           </gmd:dateType>
+                        </gmd:CI_Date>
+                     </gmd:date>
+                     <gmd:identifier>
+                        <gmd:MD_Identifier>
+                           <gmd:code>
+                              <gco:CharacterString>series_tl_2022_bg</gco:CharacterString>
+                           </gmd:code>
+                        </gmd:MD_Identifier>
+                     </gmd:identifier>
+                     <gmd:citedResponsibleParty>
+                        <gmd:CI_ResponsibleParty>
+                           <gmd:organisationName>
+                              <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+                           </gmd:organisationName>
+                           <gmd:contactInfo>
+                              <gmd:CI_Contact>
+                                 <gmd:phone>
+                                    <gmd:CI_Telephone>
+                                       <gmd:voice>
+                                          <gco:CharacterString>301-763-1128</gco:CharacterString>
+                                       </gmd:voice>
+                                       <gmd:facsimile>
+                                          <gco:CharacterString>301-763-4710</gco:CharacterString>
+                                       </gmd:facsimile>
+                                    </gmd:CI_Telephone>
+                                 </gmd:phone>
+                                 <gmd:address>
+                                    <gmd:CI_Address>
+                                       <gmd:deliveryPoint>
+                                          <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                                       </gmd:deliveryPoint>
+                                       <gmd:city>
+                                          <gco:CharacterString>Washington</gco:CharacterString>
+                                       </gmd:city>
+                                       <gmd:administrativeArea>
+                                          <gco:CharacterString>DC</gco:CharacterString>
+                                       </gmd:administrativeArea>
+                                       <gmd:postalCode>
+                                          <gco:CharacterString>20233-7400</gco:CharacterString>
+                                       </gmd:postalCode>
+                                       <gmd:country>
+                                          <gco:CharacterString>United States</gco:CharacterString>
+                                       </gmd:country>
+                                       <gmd:electronicMailAddress>
+                                          <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                                       </gmd:electronicMailAddress>
+                                    </gmd:CI_Address>
+                                 </gmd:address>
+                              </gmd:CI_Contact>
+                           </gmd:contactInfo>
+                           <gmd:role>
+                              <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                               codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+                           </gmd:role>
+                        </gmd:CI_ResponsibleParty>
+                     </gmd:citedResponsibleParty>
+                     <gmd:presentationForm>
+                        <gmd:CI_PresentationFormCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_PresentationFormCode"
+                                                     codeListValue="mapDigital">mapDigital</gmd:CI_PresentationFormCode>
+                     </gmd:presentationForm>
+                  </gmd:CI_Citation>
+               </gmd:aggregateDataSetName>
+               <gmd:associationType>
+                  <gmd:DS_AssociationTypeCode codeList="https://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#DS_AssociationTypeCode"
+                                              codeListValue="largerWorkCitation">largerWorkCitation</gmd:DS_AssociationTypeCode>
+               </gmd:associationType>
+            </gmd:MD_AggregateInformation>
+         </gmd:aggregationInfo>
+         <gmd:spatialRepresentationType>
+            <gmd:MD_SpatialRepresentationTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_SpatialRepresentationTypeCode"
+                                                  codeListValue="vector">vector</gmd:MD_SpatialRepresentationTypeCode>
+         </gmd:spatialRepresentationType>
+         <gmd:language>
+            <gco:CharacterString>eng; USA</gco:CharacterString>
+         </gmd:language>
+         <gmd:characterSet>
+            <gmd:MD_CharacterSetCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_CharacterSetCode"
+                                     codeListValue="utf8">utf8</gmd:MD_CharacterSetCode>
+         </gmd:characterSet>
+         <gmd:topicCategory>
+            <gmd:MD_TopicCategoryCode>boundaries</gmd:MD_TopicCategoryCode>
+         </gmd:topicCategory>
+         <gmd:environmentDescription>
+            <gco:CharacterString>The TIGER/Line shapefiles contain geographic data only and do not include display mapping software or statistical data.  For information on how to use the TIGER/Line shapefile data with specific software package users shall contact the company that produced the software.</gco:CharacterString>
+         </gmd:environmentDescription>
+         <gmd:extent>
+            <gmd:EX_Extent id="boundingExtent">
+               <gmd:geographicElement>
+                  <gmd:EX_GeographicBoundingBox id="boundingGeographicBoundingBox">
+                     <gmd:westBoundLongitude>
+                        <gco:Decimal>-114.8163</gco:Decimal>
+                     </gmd:westBoundLongitude>
+                     <gmd:eastBoundLongitude>
+                        <gco:Decimal>-109.045172</gco:Decimal>
+                     </gmd:eastBoundLongitude>
+                     <gmd:southBoundLatitude>
+                        <gco:Decimal>31.332341</gco:Decimal>
+                     </gmd:southBoundLatitude>
+                     <gmd:northBoundLatitude>
+                        <gco:Decimal>37.003725</gco:Decimal>
+                     </gmd:northBoundLatitude>
+                  </gmd:EX_GeographicBoundingBox>
+               </gmd:geographicElement>
+               <gmd:temporalElement>
+                  <gmd:EX_TemporalExtent id="boundingTemporalExtent">
+                     <gmd:extent>
+                        <gml:TimePeriod gml:id="boundingTemporalExtentA">
+                           <gml:description>publication date</gml:description>
+                           <gml:beginPosition>2021-06</gml:beginPosition>
+                           <gml:endPosition>2022-08</gml:endPosition>
+                        </gml:TimePeriod>
+                     </gmd:extent>
+                  </gmd:EX_TemporalExtent>
+               </gmd:temporalElement>
+            </gmd:EX_Extent>
+         </gmd:extent>
+      </gmd:MD_DataIdentification>
+   </gmd:identificationInfo>
+   <gmd:contentInfo>
+      <gmd:MD_FeatureCatalogueDescription>
+         <gmd:includedWithDataset>
+            <gco:Boolean>1</gco:Boolean>
+         </gmd:includedWithDataset>
+         <gmd:featureTypes>
+            <gco:LocalName codeSpace="unknown">Block Groups</gco:LocalName>
+         </gmd:featureTypes>
+         <gmd:featureCatalogueCitation>
+            <gmd:CI_Citation>
+               <gmd:title>
+                  <gco:CharacterString>Feature Catalog for the Current Block Groups TIGER/Line Shapefiles</gco:CharacterString>
+               </gmd:title>
+               <gmd:date>
+                  <gmd:CI_Date>
+                     <gmd:date>
+                        <gco:Date>2022</gco:Date>
+                     </gmd:date>
+                     <gmd:dateType>
+                        <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode"
+                                             codeListValue="publication">publication</gmd:CI_DateTypeCode>
+                     </gmd:dateType>
+                  </gmd:CI_Date>
+               </gmd:date>
+               <gmd:citedResponsibleParty>
+                  <gmd:CI_ResponsibleParty>
+                     <gmd:organisationName>
+                        <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, Geography Division, Spatial Data Collection and Products Branch</gco:CharacterString>
+                     </gmd:organisationName>
+                     <gmd:contactInfo>
+                        <gmd:CI_Contact>
+                           <gmd:phone>
+                              <gmd:CI_Telephone>
+                                 <gmd:voice>
+                                    <gco:CharacterString>301-763-1128</gco:CharacterString>
+                                 </gmd:voice>
+                                 <gmd:facsimile>
+                                    <gco:CharacterString>301-763-4710</gco:CharacterString>
+                                 </gmd:facsimile>
+                              </gmd:CI_Telephone>
+                           </gmd:phone>
+                           <gmd:address>
+                              <gmd:CI_Address>
+                                 <gmd:deliveryPoint>
+                                    <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                                 </gmd:deliveryPoint>
+                                 <gmd:city>
+                                    <gco:CharacterString>Washington</gco:CharacterString>
+                                 </gmd:city>
+                                 <gmd:administrativeArea>
+                                    <gco:CharacterString>DC</gco:CharacterString>
+                                 </gmd:administrativeArea>
+                                 <gmd:postalCode>
+                                    <gco:CharacterString>20233-7400</gco:CharacterString>
+                                 </gmd:postalCode>
+                                 <gmd:country>
+                                    <gco:CharacterString>United States</gco:CharacterString>
+                                 </gmd:country>
+                                 <gmd:electronicMailAddress>
+                                    <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                                 </gmd:electronicMailAddress>
+                              </gmd:CI_Address>
+                           </gmd:address>
+                        </gmd:CI_Contact>
+                     </gmd:contactInfo>
+                     <gmd:role>
+                        <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                         codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
+                     </gmd:role>
+                  </gmd:CI_ResponsibleParty>
+               </gmd:citedResponsibleParty>
+               <gmd:otherCitationDetails>
+                  <gco:CharacterString>https://meta.geo.census.gov/data/existing/decennial/GEO/GPMB/TIGERline/Current_19110/tl_2022_bg.shp.ea.iso.xml</gco:CharacterString>
+               </gmd:otherCitationDetails>
+            </gmd:CI_Citation>
+         </gmd:featureCatalogueCitation>
+      </gmd:MD_FeatureCatalogueDescription>
+   </gmd:contentInfo>
+   <gmd:distributionInfo>
+      <gmd:MD_Distribution>
+         <gmd:distributionFormat>
+            <gmd:MD_Format>
+               <gmd:name>
+                  <gco:CharacterString>ZIP</gco:CharacterString>
+               </gmd:name>
+               <gmd:version gco:nilReason="unknown"/>
+            </gmd:MD_Format>
+         </gmd:distributionFormat>
+         <gmd:distributor>
+            <gmd:MD_Distributor>
+               <gmd:distributorContact>
+                  <gmd:CI_ResponsibleParty>
+                     <gmd:organisationName>
+                        <gco:CharacterString>U.S. Department of Commerce, U.S. Census Bureau, 
+       Geography Division, Geographic Customer Services Branch
+      </gco:CharacterString>
+                     </gmd:organisationName>
+                     <gmd:contactInfo>
+                        <gmd:CI_Contact>
+                           <gmd:phone>
+                              <gmd:CI_Telephone>
+                                 <gmd:voice>
+                                    <gco:CharacterString>301-763-1128</gco:CharacterString>
+                                 </gmd:voice>
+                                 <gmd:facsimile>
+                                    <gco:CharacterString>301-763-4710</gco:CharacterString>
+                                 </gmd:facsimile>
+                              </gmd:CI_Telephone>
+                           </gmd:phone>
+                           <gmd:address>
+                              <gmd:CI_Address>
+                                 <gmd:deliveryPoint>
+                                    <gco:CharacterString>4600 Silver Hill Road, Stop 7400</gco:CharacterString>
+                                 </gmd:deliveryPoint>
+                                 <gmd:city>
+                                    <gco:CharacterString>Washington</gco:CharacterString>
+                                 </gmd:city>
+                                 <gmd:administrativeArea>
+                                    <gco:CharacterString>DC</gco:CharacterString>
+                                 </gmd:administrativeArea>
+                                 <gmd:postalCode>
+                                    <gco:CharacterString>20233-7400</gco:CharacterString>
+                                 </gmd:postalCode>
+                                 <gmd:country>
+                                    <gco:CharacterString>United States</gco:CharacterString>
+                                 </gmd:country>
+                                 <gmd:electronicMailAddress>
+                                    <gco:CharacterString>geo.geography@census.gov</gco:CharacterString>
+                                 </gmd:electronicMailAddress>
+                              </gmd:CI_Address>
+                           </gmd:address>
+                        </gmd:CI_Contact>
+                     </gmd:contactInfo>
+                     <gmd:role>
+                        <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode"
+                                         codeListValue="distributor">distributor</gmd:CI_RoleCode>
+                     </gmd:role>
+                  </gmd:CI_ResponsibleParty>
+               </gmd:distributorContact>
+               <gmd:distributionOrderProcess>
+                  <gmd:MD_StandardOrderProcess>
+                     <gmd:fees>
+                        <gco:CharacterString>The online copy of the TIGER/Line Shapefiles may be accessed without charge.</gco:CharacterString>
+                     </gmd:fees>
+                  </gmd:MD_StandardOrderProcess>
+               </gmd:distributionOrderProcess>
+            </gmd:MD_Distributor>
+         </gmd:distributor>
+         <gmd:transferOptions>
+            <gmd:MD_DigitalTransferOptions>
+               <gmd:onLine>
+                  <gmd:CI_OnlineResource>
+                     <gmd:linkage>
+                        <gmd:URL>https://www2.census.gov/geo/tiger/TIGER2022/BG/tl_2022_04_bg.zip</gmd:URL>
+                     </gmd:linkage>
+                     <gmd:applicationProfile>
+                        <gco:CharacterString>Shapefile Zip File</gco:CharacterString>
+                     </gmd:applicationProfile>
+                     <gmd:name>
+                        <gco:CharacterString>tl_2022_04_bg.zip</gco:CharacterString>
+                     </gmd:name>
+                     <gmd:description>
+                        <gco:CharacterString>The TIGER/Line Shapefiles are the fully supported, core geographic product from the U.S. Census Bureau. They are extracts of selected geographic and cartographic information from the U.S. Census Bureau's Master Address File/Topologically Integrated Geographic Encoding and Referencing (MAF/TIGER) database. </gco:CharacterString>
+                     </gmd:description>
+                     <gmd:function>
+                        <gmd:CI_OnLineFunctionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnlineFunctionCode"
+                                                   codeListValue="download">download</gmd:CI_OnLineFunctionCode>
+                     </gmd:function>
+                  </gmd:CI_OnlineResource>
+               </gmd:onLine>
+            </gmd:MD_DigitalTransferOptions>
+         </gmd:transferOptions>
+         <gmd:transferOptions>
+            <gmd:MD_DigitalTransferOptions>
+               <gmd:onLine>
+                  <gmd:CI_OnlineResource>
+                     <gmd:linkage>
+                        <gmd:URL>https://meta.geo.census.gov/data/existing/decennial/GEO/GPMB/TIGERline/Current_19110/tl_2022_bg.shp.ea.iso.xml</gmd:URL>
+                     </gmd:linkage>
+                     <gmd:applicationProfile>
+                        <gco:CharacterString>XML</gco:CharacterString>
+                     </gmd:applicationProfile>
+                     <gmd:name>
+                        <gco:CharacterString>tl_2022_bg.shp.ea.iso.xml</gco:CharacterString>
+                     </gmd:name>
+                     <gmd:description>
+                        <gco:CharacterString>Entity and attribute file</gco:CharacterString>
+                     </gmd:description>
+                     <gmd:function>
+                        <gmd:CI_OnLineFunctionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnlineFunctionCode"
+                                                   codeListValue="download">download</gmd:CI_OnLineFunctionCode>
+                     </gmd:function>
+                  </gmd:CI_OnlineResource>
+               </gmd:onLine>
+            </gmd:MD_DigitalTransferOptions>
+         </gmd:transferOptions>
+         <gmd:transferOptions>
+            <gmd:MD_DigitalTransferOptions>
+               <gmd:onLine>
+                  <gmd:CI_OnlineResource>
+                     <gmd:linkage>
+                        <gmd:URL>https://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/tigerWMS_Current/MapServer</gmd:URL>
+                     </gmd:linkage>
+                     <gmd:applicationProfile>
+                        <gco:CharacterString>https://www.ogc.org/standards/wms</gco:CharacterString>
+                     </gmd:applicationProfile>
+                     <gmd:name>
+                        <gco:CharacterString>TIGERweb/tigerWMS_Current (MapServer)</gco:CharacterString>
+                     </gmd:name>
+                     <gmd:description>
+                        <gco:CharacterString>The Open Geospatial Consortium, Inc. (OGC) Web Map Service interface standard (WMS) provides a simple HTTP interface for requesting geo-registered map images from our geospatial database. The response to the request is one or more geo-registered map images that can be displayed in a browser or WMS client application. By gaining access to our data through our WMS, users can produce maps containing TIGERweb layers combined with layers from other servers.</gco:CharacterString>
+                     </gmd:description>
+                     <gmd:function>
+                        <gmd:CI_OnLineFunctionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnlineFunctionCode"
+                                                   codeListValue="search">search</gmd:CI_OnLineFunctionCode>
+                     </gmd:function>
+                  </gmd:CI_OnlineResource>
+               </gmd:onLine>
+            </gmd:MD_DigitalTransferOptions>
+         </gmd:transferOptions>
+         <gmd:transferOptions>
+            <gmd:MD_DigitalTransferOptions>
+               <gmd:onLine>
+                  <gmd:CI_OnlineResource>
+                     <gmd:linkage>
+                        <gmd:URL>https://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/Tracts_Blocks/MapServer</gmd:URL>
+                     </gmd:linkage>
+                     <gmd:applicationProfile>
+                        <gco:CharacterString>https://geoservices.github.io</gco:CharacterString>
+                     </gmd:applicationProfile>
+                     <gmd:name>
+                        <gco:CharacterString>TIGERweb/Tracts_Blocks (MapServer)</gco:CharacterString>
+                     </gmd:name>
+                     <gmd:description>
+                        <gco:CharacterString>The GeoServices REST Specification provides a way for Web clients to communicate with geographic information system (GIS) servers through Representational State Transfer (REST) technology.</gco:CharacterString>
+                     </gmd:description>
+                     <gmd:function>
+                        <gmd:CI_OnLineFunctionCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_OnlineFunctionCode"
+                                                   codeListValue="search">search</gmd:CI_OnLineFunctionCode>
+                     </gmd:function>
+                  </gmd:CI_OnlineResource>
+               </gmd:onLine>
+            </gmd:MD_DigitalTransferOptions>
+         </gmd:transferOptions>
+      </gmd:MD_Distribution>
+   </gmd:distributionInfo>
+   <gmd:dataQualityInfo>
+      <gmd:DQ_DataQuality>
+         <gmd:scope>
+            <gmd:DQ_Scope>
+               <gmd:level>
+                  <gmd:MD_ScopeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_ScopeCode"
+                                    codeListValue="dataset">dataset</gmd:MD_ScopeCode>
+               </gmd:level>
+            </gmd:DQ_Scope>
+         </gmd:scope>
+         <gmd:report>
+            <gmd:DQ_ConceptualConsistency>
+               <gmd:measureDescription>
+                  <gco:CharacterString>
+					The Census Bureau performed automated tests to ensure logical consistency and limits of shapefiles. Segments making up the outer and inner boundaries of a polygon tie end-to-end to completely enclose the area. All polygons are tested for closure.
+					The Census Bureau uses its internally developed geographic update system to enhance and modify spatial and attribute data in the Census MAF/TIGER database.  Standard geographic codes, such as FIPS codes for states, counties, municipalities, county subdivisions, places, American Indian/Alaska Native/Native Hawaiian areas, and congressional districts are used when encoding spatial entities.  The Census Bureau performed spatial data tests for logical consistency of the codes during the compilation of the original Census MAF/TIGER database files.  Most of the codes for geographic entities except states, counties, urban areas, Core Based Statistical Areas (CBSAs), American Indian Areas (AIAs), and congressional districts were provided to the Census Bureau by the USGS, the agency responsible for maintaining the Geographic Names Information System (GNIS).  Feature attribute information has been examined but has not been fully tested for consistency. 
+					For the TIGER/Line Shapefiles, the Point and Vector Object Count for the G-polygon SDTS Point and Vector Object Type reflects the number of records in the shapefile attribute table.  For multi-polygon features, only one attribute record exists for each multi-polygon rather than one attribute record per individual G-polygon component of the multi-polygon feature. TIGER/Line Shapefile multi-polygons are an exception to the G-polygon object type classification. Therefore, when multi-polygons exist in a shapefile, the object count will be less than the actual number of G-polygons.					
+				</gco:CharacterString>
+               </gmd:measureDescription>
+               <gmd:result gco:nilReason="unknown"/>
+            </gmd:DQ_ConceptualConsistency>
+         </gmd:report>
+         <gmd:report>
+            <gmd:DQ_CompletenessOmission>
+               <gmd:evaluationMethodDescription>
+                  <gco:CharacterString>Data completeness of the TIGER/Line Shapefiles reflects the contents of the Census MAF/TIGER database at the time the TIGER/Line Shapefiles were created.</gco:CharacterString>
+               </gmd:evaluationMethodDescription>
+               <gmd:result gco:nilReason="unknown"/>
+            </gmd:DQ_CompletenessOmission>
+         </gmd:report>
+         <gmd:report>
+            <gmd:DQ_CompletenessCommission>
+               <gmd:evaluationMethodDescription>
+                  <gco:CharacterString>Data completeness of the TIGER/Line Shapefiles reflects the contents of the Census MAF/TIGER database at the time the TIGER/Line Shapefiles were created.</gco:CharacterString>
+               </gmd:evaluationMethodDescription>
+               <gmd:result gco:nilReason="unknown"/>
+            </gmd:DQ_CompletenessCommission>
+         </gmd:report>
+      </gmd:DQ_DataQuality>
+   </gmd:dataQualityInfo>
+   <gmd:metadataMaintenance>
+      <gmd:MD_MaintenanceInformation>
+         <gmd:maintenanceAndUpdateFrequency>
+            <gmd:MD_MaintenanceFrequencyCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_MaintenanceFrequencyCode"
+                                             codeListValue="annually">annually</gmd:MD_MaintenanceFrequencyCode>
+         </gmd:maintenanceAndUpdateFrequency>
+         <gmd:maintenanceNote>
+            <gco:CharacterString>This was transformed from the Census Bureau Geospatial Product Metadata Content Standard.</gco:CharacterString>
+         </gmd:maintenanceNote>
+      </gmd:MD_MaintenanceInformation>
+   </gmd:metadataMaintenance>
+</gmi:MI_Metadata>

data/raw/tiger_maricopa/tl_2022_04_bg.shx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d6f0a5288ca52d18a2f1502ef9a0d6f0603455192c5798ca1b92ea63648eb0a1
+size 38284

data/raw/tree_equity_scores.geojson

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:776f00f8f0cc601942728c50508d3c420da84ed5f1245f0a1479e034b7448c55
+size 18017531

data_pipeline.py

@@ -0,0 +1,202 @@
+import os
+import io
+import zipfile
+import pathlib
+import requests
+import numpy as np
+import pandas as pd
+import geopandas as gpd
+import duckdb
+
+# Keys and paths
+
+CENSUS_API_KEY = os.getenv("CENSUS_API_KEY", "5f2c79bff648d3c5220c0f519359df561ac2eec6")
+TES_PATH       = pathlib.Path("data/raw/az_tes.shp")
+DB_PATH        = "processed_dashboard.db"
+
+# Step 1: Import block group boundaries
+
+print("Step 1: Downloading Phoenix block-group boundaries...")
+
+tiger_dir = pathlib.Path("data/raw/tiger_maricopa")
+tiger_dir.mkdir(parents=True, exist_ok=True)
+
+tiger_url = "https://www2.census.gov/geo/tiger/TIGER2022/BG/tl_2022_04_bg.zip"
+print("  Downloading Arizona block groups from Census TIGER...")
+resp = requests.get(tiger_url, timeout=120)
+resp.raise_for_status()
+
+z = zipfile.ZipFile(io.BytesIO(resp.content))
+z.extractall(tiger_dir)
+
+shp_files = list(tiger_dir.glob("*.shp"))
+print(f"  Found shapefile: {shp_files[0].name}")
+
+gdf = gpd.read_file(shp_files[0])
+gdf = gdf[gdf["COUNTYFP"] == "013"].copy()
+gdf = gdf.reset_index(drop=True)
+
+gdf["GEOID"] = gdf["STATEFP"] + gdf["COUNTYFP"] + gdf["TRACTCE"] + gdf["BLKGRPCE"]
+gdf = gdf.rename(columns={"NAMELSAD": "NAME"})
+gdf = gdf[["GEOID", "NAME", "geometry"]].copy()
+
+print(f"  Got {len(gdf)} Maricopa County block groups")
+print(f"  CRS: {gdf.crs}")
+print(f"  Bounds: {gdf.total_bounds}")
+print(f"  Sample GEOIDs: {gdf['GEOID'].head(3).tolist()}")
+
+# Step 2: Import and join ACS demographic data
+
+print("Step 2 — Fetching ACS 5-year demographics...")
+
+vars_str = "B19013_001E,B03002_001E,B03002_003E,B03002_012E,B03002_004E"
+acs_url = (
+    f"https://api.census.gov/data/2022/acs/acs5"
+    f"?get=NAME,{vars_str}"
+    f"&for=block+group:*&in=state:04+county:013"
+    f"&key={CENSUS_API_KEY}"
+)
+resp = requests.get(acs_url, timeout=60)
+resp.raise_for_status()
+raw  = resp.json()
+demo = pd.DataFrame(raw[1:], columns=raw[0])
+
+demo["GEOID"] = demo["state"] + demo["county"] + demo["tract"] + demo["block group"]
+print(f"  ACS sample GEOIDs:   {demo['GEOID'].head(3).tolist()}")
+print(f"  TIGER sample GEOIDs: {gdf['GEOID'].head(3).tolist()}")
+
+for col in ["B19013_001E","B03002_001E","B03002_003E","B03002_012E","B03002_004E"]:
+    demo[col] = pd.to_numeric(demo[col], errors="coerce")
+
+demo["B19013_001E"] = demo["B19013_001E"].where(demo["B19013_001E"] > 0)
+demo = demo.rename(columns={
+    "B19013_001E": "median_income",
+    "B03002_001E": "total_pop",
+    "B03002_003E": "pop_white",
+    "B03002_012E": "pop_hispanic",
+    "B03002_004E": "pop_black",
+})
+
+total_pop = np.where(demo["total_pop"] > 0, demo["total_pop"], np.nan)
+demo["pct_white"]    = demo["pop_white"]    / total_pop * 100
+demo["pct_hispanic"] = demo["pop_hispanic"] / total_pop * 100
+demo["pct_black"]    = demo["pop_black"]    / total_pop * 100
+demo["pct_minority"] = 100 - demo["pct_white"]
+
+gdf = gdf.merge(
+    demo[["GEOID","median_income","total_pop","pct_white","pct_hispanic","pct_black","pct_minority"]],
+    on="GEOID", how="inner"
+)
+print(f"  Merged onto {len(gdf)} block groups — {gdf['median_income'].notna().sum()} matched income values")
+
+# Step 3: Import and join NDVI from Google Earth Engine
+
+print("Step 3 — Computing NDVI via Google Earth Engine...")
+
+try:
+    import ee
+    ee.Initialize(project="gis322final")
+
+    valid_gdf = gdf[gdf.geometry.notnull() & gdf.is_valid].copy()
+    bounds    = valid_gdf.total_bounds
+    print(f"  Bounding box: {bounds}")
+
+    aoi = ee.Geometry.Rectangle([
+        float(bounds[0]), float(bounds[1]),
+        float(bounds[2]), float(bounds[3])
+    ])
+
+    s2 = (
+        ee.ImageCollection("COPERNICUS/S2_SR_HARMONIZED")
+        .filterBounds(aoi)
+        .filterDate("2023-01-01", "2023-12-31")
+        .filter(ee.Filter.lt("CLOUDY_PIXEL_PERCENTAGE", 1))
+        .mosaic()
+        .clip(aoi)
+    )
+    ndvi_composite = s2.normalizedDifference(["B8", "B4"]).rename("NDVI")
+
+    all_results = []
+    batch_size  = 750
+    rows        = list(valid_gdf.iterrows())
+
+    for i in range(0, len(rows), batch_size):
+        batch = rows[i:i + batch_size]
+        print(f"  Processing batch {i//batch_size + 1} of {len(rows)//batch_size + 1}...")
+
+        features = [
+            ee.Feature(ee.Geometry(row.geometry.__geo_interface__), {"GEOID": row["GEOID"]})
+            for _, row in batch
+        ]
+        fc      = ee.FeatureCollection(features)
+        sampled = ndvi_composite.reduceRegions(
+            collection=fc, reducer=ee.Reducer.mean(), scale=30
+        )
+        results = sampled.getInfo()["features"]
+        all_results.extend(results)
+
+    ndvi_df = pd.DataFrame([
+        {"GEOID":     f["properties"]["GEOID"],
+         "ndvi_mean": f["properties"].get("mean", np.nan)}
+        for f in all_results
+    ])
+    print(f"  NDVI computed for {len(ndvi_df)} block groups")
+
+except Exception as e:
+    print(f"  ⚠  GEE unavailable ({e})")
+    print("  ℹ  Using placeholder NDVI values")
+    ndvi_df = pd.DataFrame({
+        "GEOID":     gdf["GEOID"].values,
+        "ndvi_mean": np.random.uniform(0.05, 0.45, len(gdf))
+    })
+
+gdf = gdf.merge(ndvi_df, on="GEOID", how="left")
+# Step 4: Import and join Tree Equity Scores
+
+print("Step 4 — Loading Tree Equity Scores...")
+
+if TES_PATH.exists():
+    tes    = gpd.read_file(TES_PATH, engine="pyogrio")
+    tes_df = tes[["GEOID","tes"]].copy().rename(columns={"tes": "tree_equity_score"})
+
+    tes_df["TRACT_GEOID"] = tes_df["GEOID"].str[:11]
+    gdf["TRACT_GEOID"]    = gdf["GEOID"].str[:11]
+
+    gdf = gdf.merge(tes_df[["TRACT_GEOID","tree_equity_score"]], on="TRACT_GEOID", how="left")
+    gdf = gdf.drop(columns="TRACT_GEOID")
+    gdf = gdf.drop_duplicates(subset="GEOID", keep="first")
+    print(f"  Joined TES for {gdf['tree_equity_score'].notna().sum()} block groups")
+else:
+    print("  ⚠  File not found — using NaN placeholders")
+    gdf["tree_equity_score"] = np.nan
+
+# Step 5: Save to DuckDB
+
+print("Step 5 — Saving to DuckDB...")
+
+gdf_out               = gdf.copy()
+gdf_out["geometry_wkt"] = gdf_out["geometry"].to_wkt()
+df_out                = pd.DataFrame(gdf_out.drop(columns="geometry"))
+
+print(f"  Columns: {df_out.columns.tolist()}")
+print(f"  Income non-null:  {df_out['median_income'].notna().sum()}")
+print(f"  NDVI non-null:    {df_out['ndvi_mean'].notna().sum()}")
+print(f"  TES non-null:     {df_out['tree_equity_score'].notna().sum()}")
+
+con = duckdb.connect(DB_PATH)
+con.execute("DROP TABLE IF EXISTS block_groups")
+con.execute("CREATE TABLE block_groups AS SELECT * FROM df_out")
+
+con.execute("DROP TABLE IF EXISTS city_baselines")
+con.execute("""
+    CREATE TABLE city_baselines AS
+    SELECT
+        ROUND(AVG(pct_minority), 1) AS baseline_minority_pct,
+        ROUND(AVG(ndvi_mean),    4) AS baseline_ndvi,
+        ROUND(AVG(median_income),0) AS baseline_income
+    FROM block_groups
+    WHERE total_pop > 0
+""")
+
+print(f"\n✅  Done!  Saved {len(df_out)} block groups -> {DB_PATH}")
+print("   Now run:  solara run app.py")

processed_dashboard.db

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c748604d73c1798511ea30169d8750a94da0260bb333dd71211164298de752fd
+size 18624512

requirements.txt

@@ -0,0 +1,13 @@
+solara>=1.32.0
+duckdb>=1.0.0
+pandas>=2.0.0
+geopandas>=0.14.0
+leafmap>=0.36.0
+ipywidgets>=8.0.0
+shapely>=2.0.0
+pyproj>=3.6.0
+mapclassify>=2.5.0
+matplotlib>=3.8.0
+numpy>=1.26.0
+requests>=2.31.0
+earthengine-api>=0.1.370