geoai-py 0.5.5__tar.gz → 0.6.0__tar.gz

geoai_py-0.6.0/.github/workflows/docker-image.yml

@@ -0,0 +1,16 @@
+name: Docker Image CI
+
+on:
+    push:
+        branches: ["main"]
+    pull_request:
+        branches: ["main"]
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@v4
+            - name: Build the Docker image
+              run: docker build . --file Dockerfile --tag ${{ github.repository }}:$(date +%s)

geoai_py-0.6.0/.github/workflows/docker-publish.yml

@@ -0,0 +1,45 @@
+name: Publish Docker image
+
+on:
+    release:
+        types: [published]
+
+jobs:
+    push_to_registries:
+        name: Push Docker image to multiple registries
+        runs-on: ubuntu-latest
+        permissions:
+            packages: write
+            contents: read
+        steps:
+            - name: Check out the repo
+              uses: actions/checkout@v4
+
+            - name: Log in to Docker Hub
+              uses: docker/login-action@v3
+              with:
+                  username: ${{ secrets.DOCKER_USERNAME }}
+                  password: ${{ secrets.DOCKER_PASSWORD }}
+
+            - name: Log in to the Container registry
+              uses: docker/login-action@v3
+              with:
+                  registry: ghcr.io
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Extract metadata (tags, labels) for Docker
+              id: meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: |
+                      giswqs/geoai
+                      ghcr.io/${{ github.repository }}
+
+            - name: Build and push Docker images
+              uses: docker/build-push-action@v6
+              with:
+                  context: .
+                  push: true
+                  tags: ${{ steps.meta.outputs.tags }}
+                  labels: ${{ steps.meta.outputs.labels }}

{geoai_py-0.5.5 → geoai_py-0.6.0}/.github/workflows/docs-build.yml

@@ -17,7 +17,7 @@ jobs:
                   fetch-depth: 0
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v5
+              uses: astral-sh/setup-uv@v6
               with:
                   version: "0.4.16"
                   enable-cache: false

{geoai_py-0.5.5 → geoai_py-0.6.0}/.github/workflows/docs.yml

@@ -16,7 +16,7 @@ jobs:
                   fetch-depth: 0
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v5
+              uses: astral-sh/setup-uv@v6
               with:
                   version: "0.4.16"
                   enable-cache: false

{geoai_py-0.5.5 → geoai_py-0.6.0}/.github/workflows/macos.yml

@@ -22,7 +22,7 @@ jobs:
             - uses: actions/checkout@v4
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v5
+              uses: astral-sh/setup-uv@v6
               with:
                   version: "0.4.16"
                   enable-cache: false

{geoai_py-0.5.5 → geoai_py-0.6.0}/.github/workflows/ubuntu.yml

@@ -20,7 +20,7 @@ jobs:
             - uses: actions/checkout@v4
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v5
+              uses: astral-sh/setup-uv@v6
               with:
                   version: "0.4.16"
                   enable-cache: false

{geoai_py-0.5.5 → geoai_py-0.6.0}/.github/workflows/windows.yml

@@ -18,7 +18,7 @@ jobs:
             - uses: actions/checkout@v4
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v5
+              uses: astral-sh/setup-uv@v6
               with:
                   version: "0.4.16"
                   enable-cache: false

geoai_py-0.6.0/Dockerfile

@@ -0,0 +1,54 @@
+FROM quay.io/jupyter/base-notebook:latest
+
+# -------------------------------------------------------
+# 1. Install system-level packages (minimal, just git)
+# -------------------------------------------------------
+USER root
+RUN apt-get update && \
+    apt-get install -y git && \
+    rm -rf /var/lib/apt/lists/*
+
+# -------------------------------------------------------
+# 2. Install geospatial Python packages via conda (base env)
+# -------------------------------------------------------
+RUN mamba install -n base -c conda-forge \
+    geoai \
+    overturemaps -y && \
+    fix-permissions "${CONDA_DIR}"
+
+# -------------------------------------------------------
+# 3. Environment variables
+# -------------------------------------------------------
+ENV PROJ_LIB=/opt/conda/share/proj
+ENV GDAL_DATA=/opt/conda/share/gdal
+ENV LOCALTILESERVER_CLIENT_PREFIX='proxy/{port}'
+
+# -------------------------------------------------------
+# 4. Copy source code (do this *after* package installs to improve caching)
+# -------------------------------------------------------
+COPY . /home/jovyan/geoai
+WORKDIR /home/jovyan/geoai
+
+
+# -------------------------------------------------------
+# 5. Build and install geoai from source
+# -------------------------------------------------------
+# Prevent setuptools_scm issues if .git is missing
+ENV SETUPTOOLS_SCM_PRETEND_VERSION_FOR_GEOAI=0.0.0
+
+RUN rm -rf /home/jovyan/geoai/geoai.egg-info && \
+    pip install . && \
+    mkdir -p /home/jovyan/work && \
+    fix-permissions /home/jovyan
+
+# -------------------------------------------------------
+# 6. Set back to default user
+# -------------------------------------------------------
+WORKDIR /home/jovyan
+USER jovyan
+
+
+# -------------------------------------------------------
+# 7. Run the docker container
+# -------------------------------------------------------
+# docker run -it -p 8888:8888 -v $(pwd):/home/jovyan/work giswqs/geoai:latest

{geoai_py-0.5.5 → geoai_py-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.5.5
+Version: 0.6.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -26,6 +26,7 @@ Requires-Dist: leafmap
 Requires-Dist: localtileserver
 Requires-Dist: mapclassify
 Requires-Dist: maplibre
+Requires-Dist: opencv-python-headless
 Requires-Dist: overturemaps
 Requires-Dist: planetary-computer
 Requires-Dist: pystac-client

geoai_py-0.6.0/docs/examples/download_naip.ipynb

@@ -0,0 +1,175 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "0",
+   "metadata": {},
+   "source": [
+    "# Download NAIP Imagery\n",
+    "\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/examples/download_naip.ipynb)\n",
+    "\n",
+    "## Install package\n",
+    "\n",
+    "To use the `geoai-py` package, ensure it is installed in your environment. Uncomment the command below if needed."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install geoai-py"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2",
+   "metadata": {},
+   "source": [
+    "## Import library"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import geoai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4",
+   "metadata": {},
+   "source": [
+    "## Create an interactive map"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.Map(center=[47.031260, -99.156360], zoom=14)\n",
+    "m.add_basemap(\"Esri.WorldImagery\")\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6",
+   "metadata": {},
+   "source": [
+    "Use the drawing tool to select an area of interest (AOI) on the map. The selected area will be used to search for NAIP imagery."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "if m.user_roi is not None:\n",
+    "    bbox = m.user_roi_bounds()\n",
+    "else:\n",
+    "    bbox = [-99.1705, 47.0149, -99.1296, 47.0365]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8",
+   "metadata": {},
+   "source": [
+    "## Search for NAIP imagery"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items = geoai.pc_stac_search(\n",
+    "    collection=\"naip\",\n",
+    "    bbox=bbox,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "10",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "11",
+   "metadata": {},
+   "source": [
+    "## Visualize the search results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "12",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_items(items=items)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "13",
+   "metadata": {},
+   "source": [
+    "## Download NAIP imagery"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "14",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_stac_download(items, output_dir=\"naip\", assets=[\"image\"])"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "geo",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.2"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

geoai_py-0.6.0/docs/examples/globe_projection.ipynb

@@ -0,0 +1,300 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/maplibre/globe_projection.ipynb)\n",
+    "\n",
+    "**Visualize geospatial data on a 3D globe**\n",
+    "\n",
+    "Uncomment the following line to install geoai if needed."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install geoai-py"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Import library"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import geoai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Add globe control"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(center=[-100, 40], zoom=3, style=\"liberty\")\n",
+    "m.add_globe_control()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "![image](https://github.com/user-attachments/assets/d8d1ba3b-1e69-45ca-93c2-0d696c269b01)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Use globe projection"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(center=[-100, 40], zoom=3, style=\"positron\", projection=\"globe\")\n",
+    "m.add_basemap(\"Esri.WorldImagery\")\n",
+    "m.add_overture_3d_buildings()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "![image](https://github.com/user-attachments/assets/d61a6c02-c135-4aa0-9620-98f373d9ee20)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Create 3D choropleth maps"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(\n",
+    "    center=[19.43, 49.49], zoom=3, pitch=60, style=\"positron\", projection=\"globe\"\n",
+    ")\n",
+    "source = {\n",
+    "    \"type\": \"geojson\",\n",
+    "    \"data\": \"https://docs.maptiler.com/sdk-js/assets/Mean_age_of_women_at_first_marriage_in_2019.geojson\",\n",
+    "}\n",
+    "m.add_source(\"countries\", source)\n",
+    "layer = {\n",
+    "    \"id\": \"eu-countries\",\n",
+    "    \"source\": \"countries\",\n",
+    "    \"type\": \"fill-extrusion\",\n",
+    "    \"paint\": {\n",
+    "        \"fill-extrusion-color\": [\n",
+    "            \"interpolate\",\n",
+    "            [\"linear\"],\n",
+    "            [\"get\", \"age\"],\n",
+    "            23.0,\n",
+    "            \"#fff5eb\",\n",
+    "            24.0,\n",
+    "            \"#fee6ce\",\n",
+    "            25.0,\n",
+    "            \"#fdd0a2\",\n",
+    "            26.0,\n",
+    "            \"#fdae6b\",\n",
+    "            27.0,\n",
+    "            \"#fd8d3c\",\n",
+    "            28.0,\n",
+    "            \"#f16913\",\n",
+    "            29.0,\n",
+    "            \"#d94801\",\n",
+    "            30.0,\n",
+    "            \"#8c2d04\",\n",
+    "        ],\n",
+    "        \"fill-extrusion-opacity\": 1,\n",
+    "        \"fill-extrusion-height\": [\"*\", [\"get\", \"age\"], 5000],\n",
+    "    },\n",
+    "}\n",
+    "first_symbol_layer_id = m.find_first_symbol_layer()[\"id\"]\n",
+    "m.add_layer(layer, first_symbol_layer_id)\n",
+    "m.add_layer_control()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "data = \"https://github.com/opengeos/datasets/releases/download/vector/countries.geojson\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(style=\"liberty\", projection=\"globe\")\n",
+    "first_symbol_id = m.find_first_symbol_layer()[\"id\"]\n",
+    "m.add_data(\n",
+    "    data,\n",
+    "    column=\"POP_EST\",\n",
+    "    scheme=\"Quantiles\",\n",
+    "    cmap=\"Blues\",\n",
+    "    legend_title=\"Population\",\n",
+    "    name=\"Population\",\n",
+    "    before_id=first_symbol_id,\n",
+    "    extrude=True,\n",
+    "    scale_factor=1000,\n",
+    ")\n",
+    "m.add_layer_control()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "![image](https://github.com/user-attachments/assets/334f8ebf-7ee4-46a3-946b-c73b25625ced)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Vector data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(style=\"liberty\", projection=\"globe\")\n",
+    "train_raster_url = (\n",
+    "    \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_rgb_train.tif\"\n",
+    ")\n",
+    "train_vector_url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train_buildings.geojson\"\n",
+    "m.add_cog_layer(train_raster_url, name=\"NAIP\")\n",
+    "paint = {\"fill-color\": \"#ff0000\", \"fill-opacity\": 0.4, \"fill-outline-color\": \"#ffff00\"}\n",
+    "m.add_geojson(train_vector_url, name=\"Buildings\", layer_type=\"fill\", paint=paint)\n",
+    "m.add_layer_control()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Planetary Computer"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "collection = \"landsat-8-c2-l2\"\n",
+    "item = \"LC08_L2SP_047027_20201204_02_T1\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(projection=\"globe\")\n",
+    "m.add_stac_layer(\n",
+    "    collection=collection, item=item, assets=\"SR_B7,SR_B5,SR_B4\", name=\"False color\"\n",
+    ")\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(projection=\"globe\")\n",
+    "m.add_stac_layer(\n",
+    "    collection=collection,\n",
+    "    item=item,\n",
+    "    assets=[\"SR_B5\", \"SR_B4\", \"SR_B3\"],\n",
+    "    name=\"Color infrared\",\n",
+    ")\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre(projection=\"globe\")\n",
+    "m.add_stac_layer(\n",
+    "    collection=collection, item=item, assets=\"SR_B5,SR_B4,SR_B3\", name=\"Color infrared\"\n",
+    ")\n",
+    "m.add_stac_layer(\n",
+    "    collection=collection,\n",
+    "    item=item,\n",
+    "    expression=\"(SR_B5-SR_B4)/(SR_B5+SR_B4)\",\n",
+    "    rescale=\"-1,1\",\n",
+    "    colormap_name=\"greens\",\n",
+    "    name=\"NDVI Green\",\n",
+    ")\n",
+    "m"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.2"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}