PyPI - geoai-py - Versions diffs - 0.3.1__tar.gz → 0.3.3__tar.gz - Mend

geoai-py 0.3.1tar.gz → 0.3.3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

{geoai_py-0.3.1 → geoai_py-0.3.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: geoai-py
-Version: 0.3.1
+Version: 0.3.3
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -30,8 +30,8 @@ Requires-Dist: planetary-computer
 Requires-Dist: pystac-client
 Requires-Dist: rasterio
 Requires-Dist: rioxarray
+Requires-Dist: scikit-image
 Requires-Dist: scikit-learn
-Requires-Dist: segment-geospatial
 Requires-Dist: torch
 Requires-Dist: torchgeo
 Requires-Dist: tqdm
@@ -50,9 +50,9 @@ Requires-Dist: geoai[download]; extra == "all"
 [![image](https://static.pepy.tech/badge/geoai-py)](https://pepy.tech/project/geoai-py)
 [![image](https://img.shields.io/conda/vn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
 [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
-[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
+[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/giswqs/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![image](https://img.shields.io/badge/YouTube-Channel-red)](https://youtube.com/@giswqs)
+[![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://bit.ly/GeoAI-Tutorials)
 **A powerful Python package for integrating Artificial Intelligence with geospatial data analysis and visualization**
@@ -86,7 +86,7 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 -   Integration with Meta's Segment Anything Model (SAM) for automatic feature extraction
 -   Specialized segmentation algorithms optimized for satellite and aerial imagery
 -   Streamlined workflows for segmenting buildings, roads, vegetation, and water bodies
--   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage)
+-   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage, GeoParquet)
 ### 🔍 Image Classification
@@ -131,6 +131,12 @@ Comprehensive documentation is available at [https://geoai.gishub.org](https://g
 -   Explanation of algorithms and models
 -   Best practices for geospatial AI
+## 📺 Video Tutorials
+Check out our [YouTube channel](https://bit.ly/GeoAI-Tutorials) for video tutorials on using GeoAI for geospatial data analysis and visualization.
+[![cover](https://github.com/user-attachments/assets/3cde9547-ab62-4d70-b23a-3e5ed27c7407)](https://bit.ly/GeoAI-Tutorials)
 ## 🤝 Contributing
 We welcome contributions of all kinds! See our [contributing guide](https://geoai.gishub.org/contributing) for ways to get started.

{geoai_py-0.3.1 → geoai_py-0.3.3}/README.md RENAMED Viewed

@@ -4,9 +4,9 @@
 [![image](https://static.pepy.tech/badge/geoai-py)](https://pepy.tech/project/geoai-py)
 [![image](https://img.shields.io/conda/vn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
 [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
-[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
+[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/giswqs/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![image](https://img.shields.io/badge/YouTube-Channel-red)](https://youtube.com/@giswqs)
+[![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://bit.ly/GeoAI-Tutorials)
 **A powerful Python package for integrating Artificial Intelligence with geospatial data analysis and visualization**
@@ -40,7 +40,7 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 -   Integration with Meta's Segment Anything Model (SAM) for automatic feature extraction
 -   Specialized segmentation algorithms optimized for satellite and aerial imagery
 -   Streamlined workflows for segmenting buildings, roads, vegetation, and water bodies
--   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage)
+-   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage, GeoParquet)
 ### 🔍 Image Classification
@@ -85,6 +85,12 @@ Comprehensive documentation is available at [https://geoai.gishub.org](https://g
 -   Explanation of algorithms and models
 -   Best practices for geospatial AI
+## 📺 Video Tutorials
+Check out our [YouTube channel](https://bit.ly/GeoAI-Tutorials) for video tutorials on using GeoAI for geospatial data analysis and visualization.
+[![cover](https://github.com/user-attachments/assets/3cde9547-ab62-4d70-b23a-3e5ed27c7407)](https://bit.ly/GeoAI-Tutorials)
 ## 🤝 Contributing
 We welcome contributions of all kinds! See our [contributing guide](https://geoai.gishub.org/contributing) for ways to get started.

{geoai_py-0.3.1 → geoai_py-0.3.3}/docs/examples/building_footprints_usa.ipynb RENAMED Viewed

@@ -156,7 +156,8 @@
     "    confidence_threshold=0.5,\n",
     "    overlap=0.25,\n",
     "    nms_iou_threshold=0.5,\n",
-    "    small_building_area=100,\n",
+    "    min_object_area=100,\n",
+    "    max_object_area=None,\n",
     "    mask_threshold=0.5,\n",
     "    simplify_tolerance=1.0,\n",
     ")"
@@ -256,7 +257,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "torch",
+   "display_name": "geo",
    "language": "python",
    "name": "python3"
   },
@@ -270,7 +271,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.12.2"
   }
  },
  "nbformat": 4,

{geoai_py-0.3.1 → geoai_py-0.3.3}/docs/examples/building_regularization.ipynb RENAMED Viewed

@@ -50,7 +50,20 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "raster_url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_building_masks.tif\""
+    "naip_url = (\n",
+    "    \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train.tif\"\n",
+    ")\n",
+    "masks_url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_building_masks.tif\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "masks_path = geoai.download_file(masks_url)\n",
+    "naip_path = geoai.download_file(naip_url)"
    ]
   },
   {
@@ -59,7 +72,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "raster_path = geoai.download_file(raster_url)"
+    "geoai.view_image(masks_path, figsize=(18, 10))"
    ]
   },
   {
@@ -68,7 +81,17 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "geoai.view_image(raster_path, figsize=(18, 10))"
+    "geoai.create_split_map(\n",
+    "    left_layer=masks_url,\n",
+    "    right_layer=naip_url,\n",
+    "    left_label=\"Building Masks\",\n",
+    "    right_label=\"NAIP Imagery\",\n",
+    "    left_args={\n",
+    "        \"colormap\": {\"255\": \"#0000ff\"},\n",
+    "        \"opacity\": 0.5,\n",
+    "    },\n",
+    "    basemap=naip_url,\n",
+    ")"
    ]
   },
   {
@@ -84,7 +107,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "gdf = geoai.raster_to_vector(raster_path, output_path=\"naip_building_masks.geojson\")"
+    "gdf = geoai.raster_to_vector(masks_path, output_path=\"naip_building_masks.geojson\")"
    ]
   },
   {
@@ -94,7 +117,23 @@
    "outputs": [],
    "source": [
     "geoai.view_vector_interactive(\n",
-    "    gdf, style_kwds={\"color\": \"blue\", \"fillOpacity\": 0}, tiles=\"Satellite\"\n",
+    "    gdf, style_kwds={\"color\": \"blue\", \"fillOpacity\": 0.4}, tiles=naip_url\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.create_split_map(\n",
+    "    left_layer=gdf,\n",
+    "    right_layer=naip_url,\n",
+    "    left_label=\"Buildings\",\n",
+    "    right_label=\"NAIP Imagery\",\n",
+    "    left_args={\"style\": {\"color\": \"blue\"}, \"fillOpacity\": 0.4},\n",
+    "    basemap=naip_url,\n",
     ")"
    ]
   },
@@ -127,7 +166,23 @@
    "outputs": [],
    "source": [
     "geoai.view_vector_interactive(\n",
-    "    gdf_regularized, style_kwds={\"color\": \"red\", \"fillOpacity\": 0}, tiles=\"Satellite\"\n",
+    "    gdf_regularized, style_kwds={\"color\": \"red\", \"fillOpacity\": 0.4}, tiles=naip_url\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.create_split_map(\n",
+    "    left_layer=gdf_regularized,\n",
+    "    right_layer=naip_url,\n",
+    "    left_label=\"Regularized Buildings\",\n",
+    "    right_label=\"NAIP Imagery\",\n",
+    "    left_args={\"style\": {\"color\": \"red\"}, \"fillOpacity\": 0.4},\n",
+    "    basemap=naip_url,\n",
     ")"
    ]
   },
@@ -154,7 +209,23 @@
    "outputs": [],
    "source": [
     "geoai.view_vector_interactive(\n",
-    "    gdf_hybrid, style_kwds={\"color\": \"green\", \"fillOpacity\": 0}, tiles=\"Satellite\"\n",
+    "    gdf_hybrid, style_kwds={\"color\": \"green\", \"fillOpacity\": 0.4}, tiles=naip_url\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.create_split_map(\n",
+    "    left_layer=gdf_regularized,\n",
+    "    right_layer=naip_url,\n",
+    "    left_label=\"Regularized Buildings\",\n",
+    "    right_label=\"NAIP Imagery\",\n",
+    "    left_args={\"style\": {\"color\": \"green\", \"fillOpacity\": 0.4}},\n",
+    "    basemap=naip_url,\n",
     ")"
    ]
   },
@@ -186,7 +257,23 @@
    "outputs": [],
    "source": [
     "geoai.view_vector_interactive(\n",
-    "    gdf_adaptive, style_kwds={\"color\": \"yellow\", \"fillOpacity\": 0}, tiles=\"Satellite\"\n",
+    "    gdf_adaptive, style_kwds={\"color\": \"yellow\", \"fillOpacity\": 0.4}, tiles=naip_url\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.create_split_map(\n",
+    "    left_layer=gdf_adaptive,\n",
+    "    right_layer=naip_url,\n",
+    "    left_label=\"Adaptive Regularization Buildings\",\n",
+    "    right_label=\"NAIP Imagery\",\n",
+    "    left_args={\"style\": {\"color\": \"yellow\", \"fillOpacity\": 0.4}},\n",
+    "    basemap=naip_url,\n",
     ")"
    ]
   },
@@ -235,7 +322,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "torch",
+   "display_name": "geo",
    "language": "python",
    "name": "python3"
   },
@@ -249,7 +336,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.12.2"
   }
  },
  "nbformat": 4,

geoai_py-0.3.3/docs/examples/geometric_properties.ipynb ADDED Viewed

@@ -0,0 +1,199 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Geometric Properties\n",
+    "\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/examples/geometric_properties.ipynb)\n",
+    "\n",
+    "This notebook demonstrates how to calculate geometric properties of objects in a vector dataset and filter out unwanted objects based on these properties.\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 package"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import geoai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Load data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vector_url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_buildings_masks.geojson\"\n",
+    "raster_url = (\n",
+    "    \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train.tif\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gdf = geoai.read_vector(vector_url)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gdf.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_vector_interactive(gdf, column=\"confidence\", tiles=raster_url)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Add geometric properties"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gdf_props = geoai.add_geometric_properties(gdf, area_unit=\"m2\", length_unit=\"m\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gdf_props.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize geometric properties"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_vector_interactive(gdf_props, column=\"area_m2\", tiles=raster_url)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_vector_interactive(gdf_props, column=\"elongation\", tiles=raster_url)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Filter objects based on geometric properties"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gdf_filtered = gdf_props[(gdf_props[\"area_m2\"] < 2000) & (gdf_props[\"elongation\"] < 5)]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Visualize filtered objects"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.view_vector_interactive(gdf_filtered, column=\"elongation\", tiles=raster_url)"
+   ]
+  }
+ ],
+ "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": 2
+}

{geoai_py-0.3.1 → geoai_py-0.3.3}/docs/index.md RENAMED Viewed

@@ -4,9 +4,9 @@
 [![image](https://static.pepy.tech/badge/geoai-py)](https://pepy.tech/project/geoai-py)
 [![image](https://img.shields.io/conda/vn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
 [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/geoai.svg)](https://anaconda.org/conda-forge/geoai)
-[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
+[![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/giswqs/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![image](https://img.shields.io/badge/YouTube-Channel-red)](https://youtube.com/@giswqs)
+[![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://bit.ly/GeoAI-Tutorials)
 **A powerful Python package for integrating Artificial Intelligence with geospatial data analysis and visualization**
@@ -40,7 +40,7 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 -   Integration with Meta's Segment Anything Model (SAM) for automatic feature extraction
 -   Specialized segmentation algorithms optimized for satellite and aerial imagery
 -   Streamlined workflows for segmenting buildings, roads, vegetation, and water bodies
--   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage)
+-   Export capabilities to standard geospatial formats (GeoJSON, Shapefile, GeoPackage, GeoParquet)
 ### 🔍 Image Classification
@@ -85,6 +85,12 @@ Comprehensive documentation is available at [https://geoai.gishub.org](https://g
 -   Explanation of algorithms and models
 -   Best practices for geospatial AI
+## 📺 Video Tutorials
+Check out our [YouTube channel](https://bit.ly/GeoAI-Tutorials) for video tutorials on using GeoAI for geospatial data analysis and visualization.
+[![cover](https://github.com/user-attachments/assets/3cde9547-ab62-4d70-b23a-3e5ed27c7407)](https://bit.ly/GeoAI-Tutorials)
 ## 🤝 Contributing
 We welcome contributions of all kinds! See our [contributing guide](https://geoai.gishub.org/contributing) for ways to get started.

{geoai_py-0.3.1 → geoai_py-0.3.3}/geoai/__init__.py RENAMED Viewed

@@ -2,7 +2,7 @@
 __author__ = """Qiusheng Wu"""
 __email__ = "giswqs@gmail.com"
-__version__ = "0.3.1"
+__version__ = "0.3.3"
 import os

geoai-py 0.3.1__tar.gz → 0.3.3__tar.gz

geoai-py 0.3.1tar.gz → 0.3.3tar.gz