geoai-py 0.2.0__tar.gz → 0.2.2__tar.gz

{geoai_py-0.2.0 → geoai_py-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: geoai-py
-Version: 0.2.0
+Version: 0.2.2
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -24,8 +24,8 @@ Requires-Dist: jupyter-server-proxy
 Requires-Dist: leafmap
 Requires-Dist: localtileserver
 Requires-Dist: overturemaps
-Requires-Dist: planetary_computer
-Requires-Dist: pystac_client
+Requires-Dist: planetary-computer
+Requires-Dist: pystac-client
 Requires-Dist: rasterio
 Requires-Dist: rioxarray
 Requires-Dist: scikit-learn
@@ -62,6 +62,8 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 
 ## 🚀 Key Features
 
+❗ **Important notes:** The GeoAI package is under active development and new features are being added regularly. Not all features listed below are available in the current release. If you have a feature request or would like to contribute, please let us know!
+
 ### 📊 Advanced Geospatial Data Visualization
 
 -   Interactive multi-layer visualization of vector, raster, and point cloud data
@@ -112,6 +114,12 @@ pip install geoai-py
 conda install -c conda-forge geoai
 ```
 
+### Using mamba
+
+```bash
+mamba install -c conda-forge geoai
+```
+
 ## 📋 Documentation
 
 Comprehensive documentation is available at [https://geoai.gishub.org](https://geoai.gishub.org), including:

{geoai_py-0.2.0 → geoai_py-0.2.2}/README.md

@@ -18,6 +18,8 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 
 ## 🚀 Key Features
 
+❗ **Important notes:** The GeoAI package is under active development and new features are being added regularly. Not all features listed below are available in the current release. If you have a feature request or would like to contribute, please let us know!
+
 ### 📊 Advanced Geospatial Data Visualization
 
 -   Interactive multi-layer visualization of vector, raster, and point cloud data
@@ -68,6 +70,12 @@ pip install geoai-py
 conda install -c conda-forge geoai
 ```
 
+### Using mamba
+
+```bash
+mamba install -c conda-forge geoai
+```
+
 ## 📋 Documentation
 
 Comprehensive documentation is available at [https://geoai.gishub.org](https://geoai.gishub.org), including:

geoai_py-0.2.2/docs/examples/view_metadata.ipynb

@@ -0,0 +1,203 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# View Metadata\n",
+    "\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/examples/metadata.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,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install geoai-py"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Import the package"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import geoai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Define URLs for sample datasets: a NAIP imagery raster file and a building footprints vector file"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raster_url = (\n",
+    "    \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train.tif\"\n",
+    ")\n",
+    "vector_url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train_buildings.geojson\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Download the raster file (NAIP imagery) and save it locally"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "raster_path = geoai.download_file(raster_url)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Download the vector file (building footprints) and save it locally"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vector_path = geoai.download_file(vector_url)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Display metadata about the raster file, including dimensions, resolution, projection, and bands"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.print_raster_info(raster_path)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Display metadata about the vector file, including geometry type, feature count, extent, and attributes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.print_vector_info(vector_path)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Analyze the \"height\" attribute of buildings to obtain statistical information"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.analyze_vector_attributes(vector_path, \"height\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Create a visualization of building footprints colored by their height values"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.visualize_vector_by_attribute(vector_path, \"height\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "clip_raster_path = \"naip_clip.tif\"\n",
+    "geoai.clip_raster_by_bbox(\n",
+    "    raster_path,\n",
+    "    clip_raster_path,\n",
+    "    bbox=(0, 0, 1000, 1000),\n",
+    "    bands=[4, 1, 2],\n",
+    "    bbox_type=\"pixel\",\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "geoai.viz_image(clip_raster_path)"
+   ]
+  }
+ ],
+ "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.11.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

{geoai_py-0.2.0 → geoai_py-0.2.2}/docs/index.md

@@ -18,6 +18,8 @@ GeoAI bridges the gap between AI and geospatial analysis, providing tools for pr
 
 ## 🚀 Key Features
 
+❗ **Important notes:** The GeoAI package is under active development and new features are being added regularly. Not all features listed below are available in the current release. If you have a feature request or would like to contribute, please let us know!
+
 ### 📊 Advanced Geospatial Data Visualization
 
 -   Interactive multi-layer visualization of vector, raster, and point cloud data
@@ -68,6 +70,12 @@ pip install geoai-py
 conda install -c conda-forge geoai
 ```
 
+### Using mamba
+
+```bash
+mamba install -c conda-forge geoai
+```
+
 ## 📋 Documentation
 
 Comprehensive documentation is available at [https://geoai.gishub.org](https://geoai.gishub.org), including:

{geoai_py-0.2.0 → geoai_py-0.2.2}/docs/installation.md

@@ -25,27 +25,30 @@ To install GeoAI with all optional dependencies for additional features:
 pip install "geoai-py[all]"
 ```
 
-### 🐼 Using conda
+### 🐍 Using uv
 
-For Anaconda/Miniconda users, we recommend installing GeoAI via conda-forge, which handles dependencies like GDAL more elegantly:
+To install the latest stable release of GeoAI with [uv](https://docs.astral.sh/uv), a faster alternative to pip:
 
 ```bash
-conda install -c conda-forge geoai
+uv pip install geoai-py
 ```
 
-Consider creating a dedicated environment for your GeoAI projects:
+### 🐼 Using conda
+
+For Anaconda/Miniconda users, we recommend installing GeoAI via conda-forge, which handles dependencies like GDAL more elegantly:
 
 ```bash
-conda create -n geo python=3.12
-conda activate geo
 conda install -c conda-forge geoai
 ```
 
 ### 🦡 Using mamba
 
-Mamba provides faster dependency resolution compared to conda:
+Mamba provides faster dependency resolution compared to conda. This is especially useful for large packages like GeoAI:
 
 ```bash
+conda create -n geo python=3.12
+conda activate geo
+conda install -c conda-forge mamba
 mamba install -c conda-forge geoai
 ```
 
@@ -61,6 +64,18 @@ mamba install -c conda-forge geoai "pytorch=*=cuda*"
 
 This will install the appropriate PyTorch version with CUDA support.
 
+If you run into issues with the ipympl package, you can install it using the following command:
+
+```bash
+mamba install -c conda-forge geoai "pytorch=*=cuda*" jupyterlab ipympl
+```
+
+If you encounter issues with the sqlite package, you can update it using the following command:
+
+```bash
+mamba update -c conda-forge sqlite
+```
+
 ### 👩‍💻 Development Installation
 
 For contributing to GeoAI development, install directly from the source repository:

{geoai_py-0.2.0 → geoai_py-0.2.2}/geoai/__init__.py

@@ -2,7 +2,7 @@
 
 __author__ = """Qiusheng Wu"""
 __email__ = "giswqs@gmail.com"
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 
 import os
@@ -29,5 +29,7 @@ def set_proj_lib_path():
         return
 
 
-set_proj_lib_path()
+if "google.colab" not in sys.modules:
+    set_proj_lib_path()
+
 from .geoai import *

{geoai_py-0.2.0 → geoai_py-0.2.2}/geoai/common.py

@@ -114,6 +114,8 @@ def viz_image(
 
     if isinstance(image, torch.Tensor):
         image = image.cpu().numpy()
+    elif isinstance(image, str):
+        image = rio.open(image).read().transpose(1, 2, 0)
 
     plt.figure(figsize=figsize)
 

geoai_py-0.2.2/geoai/geoai.py

@@ -0,0 +1,4 @@
+"""Main module."""
+
+from .common import *
+from .preprocess import *