geoai-py 0.4.2__tar.gz → 0.5.0__tar.gz

{geoai_py-0.4.2 → geoai_py-0.5.0}/.gitignore

@@ -14,6 +14,7 @@ docs/examples/*.md
 *.xml
 docs/examples/output/
 docs/examples/*.png
+docs/examples/data/
 *.pth
 
 # Distribution / packaging

{geoai_py-0.4.2 → geoai_py-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.4.2
+Version: 0.5.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License

geoai_py-0.5.0/docs/classify.md

@@ -0,0 +1,3 @@
+# classify module
+
+::: geoai.classify

{geoai_py-0.4.2 → geoai_py-0.5.0}/docs/examples/building_footprints_africa.ipynb

@@ -76,9 +76,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "extractor = geoai.BuildingFootprintExtractor(\n",
-    "    model_path=\"building_footprints_africa.pth\"\n",
-    ")"
+    "extractor = geoai.BuildingFootprintExtractor(model_path=\"building_footprints_usa.pth\")"
    ]
   },
   {

{geoai_py-0.4.2 → geoai_py-0.5.0}/docs/examples/building_footprints_china.ipynb

@@ -77,7 +77,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "extractor = geoai.BuildingFootprintExtractor(model_path=\"building_footprints_china.pth\")"
+    "extractor = geoai.BuildingFootprintExtractor(model_path=\"building_footprints_usa.pth\")"
    ]
   },
   {

{geoai_py-0.4.2 → geoai_py-0.5.0}/docs/examples/download_data.ipynb

@@ -122,10 +122,7 @@
     "# Download buildings\n",
     "data_file = download_overture_buildings(\n",
     "    bbox=bbox,\n",
-    "    output_file=\"buildings.geojson\",\n",
-    "    output_format=\"geojson\",\n",
-    "    data_type=\"building\",\n",
-    "    verbose=True,\n",
+    "    output=\"buildings.geojson\",\n",
     ")"
    ]
   },
@@ -143,9 +140,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "if data_file:\n",
-    "    stats = extract_building_stats(data_file)\n",
-    "    print(stats)"
+    "stats = extract_building_stats(data_file)\n",
+    "print(stats)"
    ]
   },
   {
@@ -177,7 +173,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "geo",
    "language": "python",
    "name": "python3"
   },
@@ -191,7 +187,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.12.9"
   }
  },
  "nbformat": 4,

geoai_py-0.5.0/docs/examples/planetary_computer.ipynb

@@ -0,0 +1,338 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Download Data from Planetary Computer\n",
+    "\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/examples/planetary_computer.ipynb)\n",
+    "\n",
+    "## Install package\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,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install geoai-py"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Import libraries"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import geoai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Retrieve collections"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "collections = geoai.pc_collection_list()\n",
+    "collections"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Search NAIP imagery"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items = geoai.pc_stac_search(\n",
+    "    collection=\"naip\",\n",
+    "    bbox=[-76.6657, 39.2648, -76.6478, 39.2724],  # Baltimore area\n",
+    "    time_range=\"2013-01-01/2014-12-31\",\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize NAIP imagery"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_item_asset_list(items[0])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_item(item=items[0])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Download NAIP imagery"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "downloaded = geoai.pc_stac_download(\n",
+    "    items, output_dir=\"data\", assets=[\"image\", \"thumbnail\"]\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Search land cover data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items = geoai.pc_stac_search(\n",
+    "    collection=\"chesapeake-lc-13\",\n",
+    "    bbox=[-76.6657, 39.2648, -76.6478, 39.2724],  # Baltimore area\n",
+    "    time_range=\"2013-01-01/2014-12-31\",\n",
+    "    max_items=10,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize land cover data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_item_asset_list(items[0])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_item(item=items[0], colormap_name=\"tab10\", basemap=\"SATELLITE\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Download land cover data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_stac_download(items[0], output_dir=\"data\", assets=[\"data\", \"rendered_preview\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ds = geoai.read_pc_item_asset(items[0], asset=\"data\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ds"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Search Landsat data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items = geoai.pc_stac_search(\n",
+    "    collection=\"landsat-c2-l2\",\n",
+    "    bbox=[-76.6657, 39.2648, -76.6478, 39.2724],  # Baltimore area\n",
+    "    time_range=\"2024-10-27/2024-12-31\",\n",
+    "    query={\"eo:cloud_cover\": {\"lt\": 1}},\n",
+    "    max_items=10,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "items"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize Landsat data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_item_asset_list(items[0])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_item(item=items[0], assets=[\"red\", \"green\", \"blue\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_item(item=items[0], assets=[\"nir08\", \"red\", \"green\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_pc_item(\n",
+    "    item=items[0],\n",
+    "    expression=\"(nir08-red)/(nir08+red)\",\n",
+    "    rescale=\"-1,1\",\n",
+    "    colormap_name=\"greens\",\n",
+    "    name=\"NDVI Green\",\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Download Landsat data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.pc_stac_download(\n",
+    "    items[0], output_dir=\"data\", assets=[\"nir08\", \"red\", \"green\", \"blue\"]\n",
+    ")"
+   ]
+  }
+ ],
+ "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.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}