geoai-py 0.5.1__tar.gz → 0.5.2__tar.gz

{geoai_py-0.5.1 → geoai_py-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.5.1
+Version: 0.5.2
 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.2/docs/examples/edit_vector.ipynb

@@ -0,0 +1,124 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Edit vector labels for training deep learning models\n",
+    "\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/geoai/blob/main/docs/examples/edit_vector.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": [
+    "## Add sample datasets"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = geoai.MapLibre()\n",
+    "m.add_basemap(\"Google Satellite\")\n",
+    "url = \"https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train_buildings.geojson\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Set default properties"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "properties = {\n",
+    "    \"class\": [\"apartments\", \"terrace\", \"detached\", \"house\", \"shed\", None],\n",
+    "    \"height\": 0.0,\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Display the interactive widget"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "widget = geoai.edit_vector_data(m, url, properties=properties)\n",
+    "m.add_layer_control()\n",
+    "widget"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "![image](https://github.com/user-attachments/assets/c86f78ee-1f50-418e-981e-b01fe61b2b53)"
+   ]
+  }
+ ],
+ "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
+}

{geoai_py-0.5.1 → geoai_py-0.5.2}/geoai/__init__.py

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

{geoai_py-0.5.1 → geoai_py-0.5.2}/geoai/geoai.py

@@ -118,3 +118,90 @@ def create_vector_data(
         frame_border=frame_border,
         **kwargs,
     )
+
+
+def edit_vector_data(
+    m: Optional[Map] = None,
+    filename: str = None,
+    properties: Optional[Dict[str, List[Any]]] = None,
+    time_format: str = "%Y%m%dT%H%M%S",
+    column_widths: Optional[List[int]] = (9, 3),
+    map_height: str = "600px",
+    out_dir: Optional[str] = None,
+    filename_prefix: str = "",
+    file_ext: str = "geojson",
+    add_mapillary: bool = False,
+    style: str = "photo",
+    radius: float = 0.00005,
+    width: int = 300,
+    height: int = 420,
+    frame_border: int = 0,
+    controls: Optional[List[str]] = None,
+    position: str = "top-right",
+    fit_bounds_options: Dict = None,
+    **kwargs: Any,
+):
+    """Generates a widget-based interface for creating and managing vector data on a map.
+
+    This function creates an interactive widget interface that allows users to draw features
+    (points, lines, polygons) on a map, assign properties to these features, and export them
+    as GeoJSON files. The interface includes a map, a sidebar for property management, and
+    buttons for saving, exporting, and resetting the data.
+
+    Args:
+        m (Map, optional): An existing Map object. If not provided, a default map with
+            basemaps and drawing controls will be created. Defaults to None.
+        filename (str or gpd.GeoDataFrame): The path to a GeoJSON file or a GeoDataFrame
+            containing the vector data to be edited. Defaults to None.
+        properties (Dict[str, List[Any]], optional): A dictionary where keys are property names
+            and values are lists of possible values for each property. These properties can be
+            assigned to the drawn features. Defaults to None.
+        time_format (str, optional): The format string for the timestamp used in the exported
+            filename. Defaults to "%Y%m%dT%H%M%S".
+        column_widths (Optional[List[int]], optional): A list of two integers specifying the
+            relative widths of the map and sidebar columns. Defaults to (9, 3).
+        map_height (str, optional): The height of the map widget. Defaults to "600px".
+        out_dir (str, optional): The directory where the exported GeoJSON files will be saved.
+            If not provided, the current working directory is used. Defaults to None.
+        filename_prefix (str, optional): A prefix to be added to the exported filename.
+            Defaults to "".
+        file_ext (str, optional): The file extension for the exported file. Defaults to "geojson".
+        add_mapillary (bool, optional): Whether to add a Mapillary image widget that displays the
+            nearest image to the clicked point on the map. Defaults to False.
+        style (str, optional): The style of the Mapillary image widget. Can be "classic", "photo",
+            or "split". Defaults to "photo".
+        radius (float, optional): The radius (in degrees) used to search for the nearest Mapillary
+            image. Defaults to 0.00005 degrees.
+        width (int, optional): The width of the Mapillary image widget. Defaults to 300.
+        height (int, optional): The height of the Mapillary image widget. Defaults to 420.
+        frame_border (int, optional): The width of the frame border for the Mapillary image widget.
+            Defaults to 0.
+        controls (Optional[List[str]], optional): The drawing controls to be added to the map.
+            Defaults to ["point", "polygon", "line_string", "trash"].
+        position (str, optional): The position of the drawing controls on the map. Defaults to "top-right".
+        **kwargs (Any): Additional keyword arguments that may be passed to the function.
+
+    Returns:
+        widgets.VBox: A vertical box widget containing the map, sidebar, and control buttons.
+    """
+    return maplibregl.edit_vector_data(
+        m=m,
+        filename=filename,
+        properties=properties,
+        time_format=time_format,
+        column_widths=column_widths,
+        map_height=map_height,
+        out_dir=out_dir,
+        filename_prefix=filename_prefix,
+        file_ext=file_ext,
+        add_mapillary=add_mapillary,
+        style=style,
+        radius=radius,
+        width=width,
+        height=height,
+        frame_border=frame_border,
+        controls=controls,
+        position=position,
+        fit_bounds_options=fit_bounds_options,
+        **kwargs,
+    )

{geoai_py-0.5.1 → geoai_py-0.5.2}/geoai_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.5.1
+Version: 0.5.2
 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.1 → geoai_py-0.5.2}/geoai_py.egg-info/SOURCES.txt

@@ -48,6 +48,7 @@ docs/examples/create_vector.ipynb
 docs/examples/data_visualization.ipynb
 docs/examples/download_data.ipynb
 docs/examples/download_sentinel2.ipynb
+docs/examples/edit_vector.ipynb
 docs/examples/geometric_properties.ipynb
 docs/examples/image_chips.ipynb
 docs/examples/jupytext.toml

{geoai_py-0.5.1 → geoai_py-0.5.2}/mkdocs.yml

@@ -104,6 +104,7 @@ nav:
           - examples/planetary_computer.ipynb
           - examples/view_metadata.ipynb
           - examples/create_vector.ipynb
+          - examples/edit_vector.ipynb
           - examples/image_chips.ipynb
           - examples/building_footprints_usa.ipynb
           - examples/building_footprints_africa.ipynb

{geoai_py-0.5.1 → geoai_py-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "geoai-py"
-version = "0.5.1"
+version = "0.5.2"
 dynamic = [
     "dependencies",
 ]
@@ -44,7 +44,7 @@ universal = true
 
 
 [tool.bumpversion]
-current_version = "0.5.1"
+current_version = "0.5.2"
 commit = true
 tag = true