GeoModelingZ

这是一个地理建模与可视化工具库，专为Jupyter Notebook环境优化，提供了丰富的交互式地理数据可视化功能。

主要功能

• 环境检测: 自动检测Jupyter Notebook环境
• 交互式图表: 支持matplotlib交互式图表绘制
• 地理地图可视化: 强大的交互式地理地图功能
• GeoJSON支持: 完整支持GeoJSON数据格式
• 多几何类型: 支持点、线、多边形和Multi类型几何数据
• 自动聚焦: 智能聚焦到数据区域
• 多底图支持: 支持Mapbox和OpenStreetMap等多种底图

安装

基本安装

pip install GeoModelingZ

安装Jupyter支持（推荐）

pip install GeoModelingZ[jupyter]

使用方法

交互式图表(主版本待开发)

from GeoModelingZ import plot_simple_chart

# 创建简单的交互式图表
fig = plot_simple_chart(title="我的图表")

# 在Jupyter环境中，可以交互调整参数
# 在普通环境中，返回matplotlib图表对象

地理地图可视化

from GeoModelingZ import create_geo_map

# 创建基本地图
map_obj = create_geo_map(
    width=1000, 
    height=700,
    center=[39.9042, 116.4074],  # 北京坐标
    zoom_start=10
)

# 加载GeoJSON数据
map_with_data = create_geo_map(
    geojson_file="path/to/your/data.geojson",
    mapbox_token="your_mapbox_token",  # 可选
    basemap='dark'
)

# 显示地图（在Jupyter中）
map_with_data

支持的GeoJSON几何类型

• Point: 单点数据
• MultiPoint: 多点数据
• LineString: 线数据
• MultiLineString: 多线数据
• Polygon: 多边形数据
• MultiPolygon: 复杂多边形数据

底图类型

• streets: 矢量街道地图（默认）
• satellite: 卫星影像地图
• outdoors: 地形图
• light: 浅色底图
• dark: 深色底图
• OpenStreetMap: 开源街道地图

依赖

• Python >= 3.6
• numpy
• matplotlib
• ipython
• folium

可选依赖（用于Jupyter功能）

• ipywidgets >= 7.0.0
• jupyterlab_widgets

更新日志

v0.0.6

• 重构代码结构，移除冗余功能
• 专注于地理数据可视化核心功能
• 优化GeoJSON数据处理逻辑
• 改进地图渲染性能
• 增强错误处理和调试信息

贡献

欢迎提交Issue和Pull Request来改进这个库！

许可证

MIT License