GeoAI 版本演进全解析：从 v0.0.1 到 v0.35.0 的功能清单与源码印证

人工智能计算机视觉GIS图像处理微调【免费下载链接】geoaiGeoAI: Artificial Intelligence for Geospatial Data项目地址https://gitcode.com/gh_mirrors/ge/geoai点击查看免费下载本文以 docs/changelog.md 为骨架逐版本梳理 GeoAIArtificial Intelligence for Geospatial Data从 2023 年首次发布到 2026 年 3 月的全部功能演进并结合仓库内源码、配置示例与测试用例进行印证。读完本文你将完整掌握 GeoAI 的能力全景——包括遥感影像下载、训练数据制作、语义/实例分割、目标检测、变化检测、基础模型、AI Agent 与 QGIS 插件等模块的引入时间与底层实现位置可直接据此定位功能、查阅源码、复现工作流。版本脉络与能力演进总览GeoAI 是一个将人工智能与地理空间数据分析相结合的 Python 包遵循 Semantic Versioning 语义化版本规范在 docs/changelog.md 中记录了自 2023 年 8 月首次发布v0.0.1以来的全部版本变更。截至本仓库当前快照changelog 覆盖到 2026 年 3 月 17 日发布的 v0.35.0而 geoai/init.py 中的__version__已推进至0.43.1说明该文档持续记录最新公开发布的版本代码库本身仍保持活跃迭代。从整体演进看GeoAI 的能力版图大致沿以下主线展开时间线主题主线代表性能力2023起步SamGeo 集成、基础发布v0.0.1 / v0.1.02024–2025 上半年经典深度学习任务建筑物提取、目标检测训练、水体检测、土地覆盖分类、变化检测v0.2.0–v0.10.02025 年中–年末基础模型与数据工程DINOv3、JPEG2000、AI Agents、timm/COCO/YOLO、Moondream VLM、QGIS 插件v0.11.0–v0.20.02026生产化与全栈能力批处理流水线、多架构检测、模型 Hub 推拉、MCP Server、推理优化v0.21.0–v0.35.0下文按版本从新到旧逐节展开每个版本的每个条目均结合源码给出可查证的位置与实现细节。v0.35.02026-03-17实例分割增强与推理链路完善实例分割推理保留类别标签与实例属性本版本在实例分割推理中保留类别标签class labels与实例属性instance attributes相关实现在 geoai/train.py 的instance_segmentation系列函数中。配套的clean_instance_mask修复了去除离散碎片的逻辑见 geoai/init.py 中懒加载导出的clean_instance_mask确保清理后的掩膜不再残留孤立片段。超分辨率Super-Resolution模块与 NotebookOpenSR 检查点默认缓存到 torch hub 目录而非当前工作目录避免污染项目文件夹。新增超分辨率 Notebookdocs/examples/esrgan.ipynb并改进sr模块其实现位于 geoai/tools/sr.py对外暴露super_resolution、plot_sr_comparison、plot_sr_uncertainty等函数。云检测Cloud Detection改进云检测 Notebookdocs/examples/cloud_detection.ipynb并导出 cloudmask 函数实现在 geoai/tools/cloudmask.py包括predict_cloud_mask、predict_cloud_mask_from_raster、predict_cloud_mask_batch、calculate_cloud_statistics与create_cloud_free_mask等。FTW 数据集与田间边界实例分割新增基于 FTWField Training in the Wild数据集的田间边界实例分割支持。FTW 相关下载与预处理函数集中在 geoai/ftw.pydownload_ftw、prepare_ftw、display_ftw_samples示例见 docs/examples/field_boundary_detection.ipynb。可视化与语义分割细节view_raster新增legend_args参数geoai/utils/visualization.py允许自定义图例样式。新增语义分割 workshopdocs/workshops/semantic/semantic_segmentation.ipynb并修复 DataParallelstate_dict加载兼容问题。为push_detector_to_hub与predict_detector_from_hubgeoai/object_detect.py增加错误处理提升模型上传/拉取链路的健壮性。v0.34.02026-03-15多架构目标检测与 Hub 生态train_timm_segmentation_model()新增class_weights参数geoai/timm_segment.py用于类别不平衡场景下加权损失。其底层TimmSegmentationModel支持unet、unetplusplus、deeplabv3、deeplabv3plus、fpn、pspnet、linknet、manet、pan等多种 SMP 架构并可通过use_timm_model直接加载 Hugging Face Hub 上的完整 timm 分割模型。修复验证损失曲线在出现非有限值NaN/Inf时的绘制问题。新增多架构目标检测支持DETECTION_MODELS、get_detection_model、model_has_masks等 API 位于 geoai/train.py训练与推理入口见 docs/examples/object_detection_nwpu.ipynb。解压 zip 时若只包含单一顶层目录则避免产生嵌套文件夹。修复训练曲线整数 epoch 刻度显示问题并移除已废弃的verbose参数。新增push_classifier_to_hub与predict_images_from_hubgeoai/recognize.py打通图像分类模型的 Hub 推送与远程预测。timm_semantic_segmentation新增概率输出支持。新增不透水面制图示例 Notebookdocs/examples/impervious_surface_mapping.ipynb。v0.33.02026-03-10内存高效瓦片推理带样条融合与 D4 TTA 的瓦片推理这是推理能力的重要升级核心实现位于 geoai/inference.py。该模块提供通用的滑动窗口推理管线适用于任意 PyTorch 分割/回归模型窗口化 I/O通过 rasterio 窗口直接读取瓦片避免整幅影像载入内存。多种融合策略BlendMode枚举定义了none均匀平均、linear线性斜坡、cosine升余弦/Hann 锥形与spline幂升余弦需满足overlap tile_size // 2四种权重掩膜由create_weight_mask(tile_size, overlap, mode, power)生成。D4 测试时增强d4_forward/d4_inverse/d4_tta_forward实现二面体群全部 8 种变换恒等、3 个 90° 旋转、水平/垂直翻转、2 个对角翻转推理时对 8 个增广结果取平均可提升预测质量但代价是 8 倍计算量。入口函数为predict_geotiff其返回类型在本次修复中明确为Tuple[str, float]。目标检测批处理与训练瓦片可视化修复.tiff输出文件名并更新object_detection_batchdocstring同时支持 list 与.tiff输入geoai/train.py。display_training_tiles新增image_subdir与mask_subdir参数geoai/utils/visualization.py便于按子目录组织训练瓦片相关测试见 tests/test_display_training_tiles_origin.py。v0.32.02026-03-03CLIP 零样本矢量分类与懒加载重构CLIP 零样本矢量分类新增基于 CLIP 的矢量要素零样本分类实现在 geoai/clip_classify.py。核心类CLIPVectorClassifier与便捷函数clip_classify_vectorgeoai/clip_classify.py对矢量中的每个多边形从栅格提取包围盒影像块经 CLIP 编码后与候选标签做余弦相似度匹配从而分配最佳类别。关键参数包括labels候选类别标签列表model_nameHugging Face 上的 CLIP 模型 ID默认openai/clip-vit-base-patch32label_prefix标签前缀默认a satellite image of top_k每个多边形保留的预测数默认 1batch_size推理批大小默认 16min_chip_size最小影像块尺寸像素默认 10devicecuda/mps/cpu缺省时按 CUDA MPS CPU 自动选择。示例见 docs/examples/clip_classify_vector.ipynb。其他变更修复 SamGeo 矢量输出对 GeoPackage 与 Shapefile 格式的支持。在 geoai/landcover_utils.py 中加入 LIRRN 辐射归一化normalize_radiometric。rasterio 加载时处理目标 NoData 值。将 geoai/init.py 中的急切导入替换为基于 PEP 562 的懒加载import geoai不再要求 torch / torchvision / transformers / leafmap 已安装重型依赖仅在首次访问具体符号时才被加载从而显著加快导入速度。修复多类别分割掩膜的处理逻辑。v0.31.12026-02-25QGIS 插件里程碑修复view_vector_interactive中tiles参数被忽略的问题。QGIS 插件升级至 v1.0.0见 qgis_plugin/并内置依赖安装器相关实现位于 qgis_plugin/geoai/core/uv_manager.py 与 qgis_plugin/geoai/core/venv_manager.py使插件可在 QGIS 内一键安装运行依赖。v0.31.02026-02-24批处理流水线与多模态能力多类别目标检测新增 NWPU-VHR-10 数据集支持相关模块为 geoai/object_detect.py提供download_nwpu_vhr10、prepare_nwpu_vhr10、train_multiclass_detector、multiclass_detection、detections_to_geodataframe、visualize_multiclass_detections等完整工作流。图像识别模块新增 EuroSAT 示例docs/examples/image_recognition.ipynb实现在 geoai/recognize.py。Google 卫星影像嵌入下载新增 docs/examples/google_satellite_embedding.ipynb底层函数download_google_satellite_embedding位于 geoai/embeddings.py。时序分析支持多时相卫星影像的时间序列分析模块见 geoai/tools/timeseries.py示例见 docs/examples/timelapse.ipynb。批处理流水线框架新增 geoai/pipeline.py提供Pipeline、PipelineStep、FunctionStep、GlobStep、PipelineResult等组件支持并行执行、进度条、YAML/JSON 配置定义与断点续跑。将utils.py重构为聚焦的子模块新增 CLI扩展测试并加入 CI 覆盖率。Pipeline 配置示例仓库自带语义分割流水线配置 docs/examples/pipelines/semantic_segmentation.yaml完整展示三阶段流水线name: semantic_segmentation max_workers: 1 executor_type: thread on_error: skip steps: - type: GlobStep name: find_images extensions: - .tif - .tiff - type: SemanticSegmentationStep name: segment model_path: path/to/model.pth architecture: unet encoder_name: resnet34 num_channels: 3 num_classes: 2 window_size: 512 overlap: 256 batch_size: 4 suffix: _mask - type: RasterToVectorStep name: vectorize output_format: .geojson input_key: output_path output_key: vector_path命令行运行方式geoai/cli.pygeoai pipeline run semantic_segmentation.yaml -i ./data/images -o ./data/results -c ./checkpoints -w 4其中-i覆盖输入目录、-o覆盖输出目录、-w设置并行 worker 数、-c指定 checkpoint 目录以支持断点续跑geoai pipeline show config.yaml可预览流水线结构与参数。v0.30.02026-02-22水体分割与 MCP ServerQGIS 插件新增水体分割面板qgis_plugin/geoai/dialogs/water_segmentation.py。集成 OmniWaterMask 进行水体分割核心模块 geoai/water.py 提供segment_water与BAND_ORDER_PRESETS示例见 docs/examples/water_detection.ipynb。新增 S2 地表水检测模型及推理 Notebookdocs/examples/water_detection_s2.ipynb。新增 WHU 建筑物检测模型与 HuggingFace Hub 推理支持docs/examples/building_detection_whu.ipynb。新增 TESSERA 支持模块 geoai/tessera.py 提供tessera_download、tessera_fetch_embeddings、tessera_coverage、tessera_visualize_rgb、tessera_sample_points等函数。新增 GeoAI MCP Server用于 AI Agent 集成代码位于 geoai-mcp-server/src/geoai_mcp_server/其中 server.py 定义工具注册tool_schemas.py 定义工具输入模式。支持 torchgeo 嵌入geoai/utils/sampling.py 中的create_torchgeo_segmentation_dataloaders、predict_torchgeo_segmentation_batch等示例见 docs/examples/torchgeo_embeddings.ipynb。修复ignore_index0处理并新增sparse_labelsIoU 模式。v0.29.x2026-02树冠高度与建筑物变化检测v0.29.12026-02-10修复 QGIS 中 pkg_resources 不可用时 SAM3 的加载问题并启用测试。v0.29.02026-02-06新增树冠高度估算支持模块 geoai/canopy.py 提供CanopyHeightEstimation、canopy_height_estimation、list_canopy_models示例见 docs/examples/canopy_height.ipynb。新增基于 ChangeStar 的建筑物变化检测模块 geoai/change_detection.py 提供ChangeStarDetection、changestar_detect、list_changestar_models示例见 docs/examples/changestar.ipynb。修复多类别语义分割掩膜中类别 ID 的保留问题。新增 JOSS 论文paper/paper.mdDOI: 10.21105/joss.09605。v0.28.02026-02-03ONNX Runtime 与数据增强新增 ONNX Runtime 地理空间模型推理支持模块 geoai/onnx.py 提供ONNXGeoModel、export_to_onnx、onnx_semantic_segmentation、onnx_image_classification示例见 docs/examples/onnx.ipynb。新增 Flip-n-Slide 数据增强策略函数flipnslide_augmentation、export_flipnslide_tiles位于 geoai/utils/示例见 docs/examples/flipnslide_augmentation.ipynb。QGIS 插件新增 DeepForest 分割面板qgis_plugin/geoai/dialogs/deepforest_panel.py。修复依赖冲突并进行代码质量改进。v0.27.02026-01-29像素级回归与多格式导出支持像素级回归任务模块 geoai/timm_regress.py 提供PixelRegressionModel、create_regression_tiles、train_pixel_regressor、predict_raster、evaluate_regression等。支持以 COCO 与 YOLO 格式导出数据geoai/utils/vector.py 相关导出工具示例 docs/examples/export_training_data_formats.ipynb。支持多种 Prithvi 模型变体get_available_prithvi_models、load_prithvi_model、prithvi_inferencegeoai/prithvi.py。修复 pixi 安装中的 Windows PyQt5 依赖问题改用懒加载 cv2 导入以避免 QGIS 中的 opencv 递归错误。v0.26.02026-01-22Prithvi EO 2.0 基础模型新增 Prithvi EO 2.0 地理空间基础模型支持模块 geoai/prithvi.py 提供PrithviProcessor、get_available_prithvi_models、load_prithvi_model、prithvi_inference示例见 docs/examples/prithvi.ipynb。v0.25.02026-01-08Moondream 滑动窗口与 utils 恢复恢复 utils 模块geoai/utils/。为 Moondream VLM 实现滑动窗口方法以处理大图moondream_caption_sliding_window、moondream_query_sliding_window、moondream_detect_sliding_window、moondream_point_sliding_windowgeoai/moondream.py示例 docs/examples/moondream_sliding_window.ipynb。修复 QGIS 插件 CUDA 问题。v0.24.02025-12-21GPKG 栅格与 CPU 安装SamGeo 支持 GPKG 栅格。新增 CPU 安装说明见 docs/installation.md。v0.23.02025-12-16QGIS 插件与测试矩阵QGIS 插件更新至 v0.3.0。新增 timelapse 示例 Notebookdocs/examples/timelapse.ipynb。GitHub Actions 新增 macOS 测试。v0.22.02025-12-13SamGeo 波段选择与更新检查器SamGeo 支持波段选择。SamGeo 支持自动展示结果。QGIS 插件新增更新检查器qgis_plugin/geoai/dialogs/update_checker.py。文档新增视频教程。v0.21.02025-12-12auto 模块与插件 LICENSE新增 auto 模块以支持 HuggingFace 模型入口函数get_model_config、get_model_input_channels、image_segmentation、mask_generation位于 geoai/auto.py示例见 docs/examples/AutoModel.ipynb。为 QGIS 插件添加 LICENSE 文件。v0.20.02025-12-11QGIS 插件诞生新增 QGIS 插件并加入 SamGeo 面板qgis_plugin/geoai/使用户能在 QGIS 桌面环境中无代码运行 AI 工作流这是 GeoAI「代码库 桌面工具」双轨形态的开端。v0.19.02025-12-10Moondream VLM 与多模型 Agent新增 Moondream VLM 支持核心类MoondreamGeo与moondream_caption/moondream_query/moondream_detect/moondream_point位于 geoai/moondream.py。新增 Moondream 交互式 GUImoondream_guigeoai/map_widgets.py示例 docs/examples/moondream_gui.ipynb。geoagents 集成 Gemini 模型支持create_gemini_model等模型工厂函数位于 geoai/agents/geo_agents.py。v0.18.02025-11-04调度器与 workshop修复调度器初始化中的语法错误。新增 ASA workshop Notebook。v0.17.02025-10-19Agent 状态与 STAC 搜索Agent 执行期间显示状态。新增目录搜索 AgentCatalogAgentgeoai/agents/geo_agents.py。新增 STAC Agent 用于交互式搜索STACAgent示例见 docs/examples/catalog_search_agent.ipynb 与 docs/examples/STAC_agents.ipynb。v0.16.02025-10-16训练指标增强支持为每个类别导出概率影像。新增精确率precision与召回率recall指标。训练新增早停耐心early stop patience。将 Dice 分数更名为 F1 分数对应工具calc_f1_scoregeoai/utils/metrics.py。v0.15.02025-10-05COCO/YOLO 全链路timm 支持 COCO 与 YOLO。支持 COCO 与 YOLO 格式的训练与导出geoai/train.py 中的COCODetectionDataset与evaluate_coco_metrics。v0.14.02025-10-04多矢量训练数据与实例分割支持从多个矢量文件创建训练数据。新增实例分割示例docs/examples/instance_segmentation.ipynb相关 APIinstance_segmentation、train_instance_segmentation_model、get_instance_segmentation_model位于 geoai/train.py。v0.13.02025-09-30Agent 生态扩展为 AI Agents 新增更多模型提供商create_ollama_model、create_anthropic_model、create_openai_model、create_gemini_model、create_bedrock_model、create_minimax_model、create_vllm_modelgeoai/agents/geo_agents.py。将 torchange 改为可选依赖。新增 DINOv3 湿地 Notebookdocs/examples/DINOv3_wetlands.ipynb。v0.12.02025-09-17AI Agents 初版新增 AI Agents 支持核心模块 geoai/agents/ 提供GeoAgent、CatalogAgent、STACAgent以及 MapTools、DataTools、CatalogTools、STACTools 等工具集。为 Agent 增加更多工具。修复 DINOv3 权重下载错误。v0.11.02025-09-10DINOv3 与 JPEG2000新增 DINOv3 支持模块 geoai/dinov3.py 提供DINOv3GeoProcessor、analyze_image_patches、create_similarity_map示例见 docs/examples/DINOv3.ipynb。新增 JPEG2000 格式支持示例见 docs/examples/JPEG2000.ipynb。v0.10.02025-09-07湿地制图修复 torchange 的 Python 3.10 兼容错误。新增湿地制图示例docs/examples/wetland_mapping.ipynb。v0.9.02025-07-17变化检测与多 GPU新增变化检测支持模块 geoai/change_detection.py示例 docs/examples/change_detection.ipynb。新增多 GPU 训练支持。修复 GDAL 安装问题相关环境路径处理见 geoai/init.py 的set_proj_lib_path。v0.8.02025-07-08影像切片与批量分割支持从多张影像生成影像切片image chips。新增批量分割支持semantic_segmentation_batch、instance_segmentation_batch等位于 geoai/train.py示例见 docs/examples/batch_segmentation.ipynb。支持非地理空间栅格格式。v0.7.02025-06-19土地覆盖分类与 smp 模型新增土地覆盖分类支持模块 geoai/landcover_train.py 提供DiceLoss、FocalLoss、UnifiedFocalLoss、TverskyLoss、LandcoverCrossEntropyLoss等损失函数及train_segmentation_landcover训练说明见 docs/landcover_train.md。支持 segmentation_models_pytorchsmp分割模型。支持自定义 MaskRCNN 模型。v0.6.02025-05-07Docker 与 samgeo新增 DockerfileDockerfile。新增 samgeo 模块geoai/sam.py示例见 docs/examples/samgeo.ipynb。v0.5.02025-03-26数据下载与镶嵌新增水体检测示例 Notebookdocs/examples/water_detection.ipynb。改进pc_stac_download函数geoai/download.py。新增get_overture_data函数geoai/download.py示例见 docs/examples/download_data.ipynb。新增mosaic_geotiffs函数geoai/utils/vector.py 对应工具或 utils 模块入口见 geoai/init.py 懒加载映射。v0.4.02025-03-12目标检测训练与 HF 模型支持训练目标检测模型object_detection、train_segmentation_model、train_MaskRCNN_model等位于 geoai/train.py示例见 docs/examples/train_object_detection_model.ipynb。新增停车位检测 Notebookdocs/examples/parking_spot_detection.ipynb。支持 Hugging Face 模型geoai/hf.py。v0.3.02025-03-04矢量后处理将 common 模块重命名为 utilsgeoai/utils/。新增建筑物规整化方法regularization、hybrid_regularization、adaptive_regularization示例 docs/examples/building_regularization.ipynb。新增masks_to_vector函数。v0.2.02025-03-03建筑物提取预训练模型新增建筑物提取预训练模型BuildingFootprintExtractor位于 geoai/extract.py示例见 docs/examples/building_footprints_usa.ipynb。新增预处理模块geoai/utils/。v0.1.02023-10-11SamGeo 与代码质量新增 samgeo 支持模块 geoai/sam.py提供SamGeo类相关文档见 docs/sam.md。新增 codespell 拼写检查。v0.0.12023-08-11首次发布初始发布标志着 GeoAI 作为「AI for Geospatial Data」包的正式起点此后逐步构建起覆盖数据下载、训练数据制作、模型训练、推理、可视化与桌面插件的一站式地理空间 AI 工作流。从 changelog 反推的实用查询路径对于开发者而言changelog 是最高效的「能力索引」查到你需要的功能后可直接按下列路径定位实现训练类 API分割/检测/实例分割geoai/train.py、geoai/timm_segment.py、geoai/landcover_train.py推理类 API瓦片化、TTA、融合geoai/inference.py数据工具下载/转换/切片geoai/download.py、geoai/utils/、geoai/landcover_utils.py批处理流水线geoai/pipeline.py 与 docs/examples/pipelines/ 下的 YAML/JSON 配置AI Agent 与 MCPgeoai/agents/、geoai-mcp-server/QGIS 插件qgis_plugin/Notebook 示例docs/examples/ 与 docs/workshops/上述每个模块在 geoai/init.py 的_LAZY_SYMBOL_MAP中均有对应的懒加载映射使用from geoai import 符号即可在需要时按需加载无需担心导入重型依赖拖慢启动。赞分享人工智能计算机视觉GIS图像处理微调【免费下载链接】geoaiGeoAI: Artificial Intelligence for Geospatial Data项目地址https://gitcode.com/gh_mirrors/ge/geoai点击查看免费下载相关推荐obsidian-git 完整版本演进史从 v0.0.1 到 v2.31.0 的功能迭代与源码印证obsidian git 完整版本演进史从 v0.0.1 到 v2.31.0 的功能迭代与源码印证 导读 本文以 obsidian gitObsidian开发工具版本控制从 v0.0.1 到 v0.5.9Spectre.css 版本演进全解析与源码验证指南从 v0.0.1 到 v0.5.9Spectre.css 版本演进全解析与源码验证指南 Spectre.css 是一款轻量、响应式、基于 Flexbox 的现前端UI组件ElastAlert 版本演进全解析从 v0.1.9 到 v0.2.4 的功能变迁与源码印证ElastAlert 版本演进全解析从 v0.1.9 到 v0.2.4 的功能变迁与源码印证 ElastAlert 是 Yelp 开源的简单而灵活的 Ela告警异常检测上一篇c12与Nuxt.js集成现代化前端项目的配置管理终极指南下一篇告别复杂配置AdGuardHome命令行参数完全指南从基础到高级用法创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考