geoskill-map-layout-automation

Automate map layout with title, legend, scale bar and north arrow to PDF or PNG

地图排版自动化 | Map Layout Automation

Automatically lay out a raster map into a finished cartographic product: map frame + title + legend (colorbar) + scale bar + north arrow, output as high-resolution PNG and vector PDF.

The scale bar length is converted from the map-frame width and the reference latitude into an integer number of kilometers following a 1-2-5 sequence; the north arrow is a standard north-pointing arrow.

Core Algorithm / 核心算法

meters_per_degree_lon=111320·cos(lat) → scale_bar_km=round(map_width×fraction) → draw_scale_bar/north_arrow data-coordinate decoration → matplotlib layout.

Dependencies / 依赖

bash

pip install numpy rasterio scipy matplotlib geopandas shapely pillow

Usage / 使用方法

Example 1 (synthetic data, offline)

bash

python geoskill-map-layout-automation.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out

Example 2 (custom title and color scheme)

bash

python geoskill-map-layout-automation.py --input dem.tif --title "terrain of the study area" --cmap viridis

Example 3 (omit the north arrow)

bash

python geoskill-map-layout-automation.py --input dem.tif --no-north

Example 4 (adjust the scale bar fraction)

bash

python geoskill-map-layout-automation.py --input dem.tif --bar-fraction 0.35

Example 5 (high-dpi output)

bash

python geoskill-map-layout-automation.py --input dem.tif --dpi 200

Output / 输出

File	Format	Description
layout.png	PNG	Layout map (main deliverable)
layout.pdf	PDF	Vector version
layout_data.tif	GeoTIFF	Data raster (verifiable deliverable)
layout_meta.json	JSON	Scale bar/element toggles/dpi

Each run also produces output-manifest.json (run manifest).

Data Source / 数据源 / Source

Local GeoTIFF / vector files; --synthetic mode generates physically consistent simulated data, fully offline.

Privacy / 隐私声明 / Privacy

• Runs offline by default; --synthetic mode requires no network at all.
• All processing is performed locally; no user data is uploaded.

License / License

MIT

---

---

name: geoskill-map-layout-automation description: 'Automate map layout with title, legend, scale bar and north arrow to PDF or PNG'

地图排版自动化 | Map Layout Automation

把栅格地图自动排版成制图成品：图幅 + 标题 + 图例(colorbar) + 比例尺 + 指北针，输出高分辨率 PNG 与矢量 PDF。

比例尺长度按图幅宽度与参考纬度换算成 1-2-5 序列的整数千米；指北针为标准北向箭头。

核心算法

meters_per_degree_lon=111320·cos(lat) → scale_bar_km=圆整(图幅宽×fraction) → draw_scale_bar/north_arrow 数据坐标整饰 → matplotlib 排版。

依赖

bash

pip install numpy rasterio scipy matplotlib geopandas shapely pillow

使用方法

示例 1（合成数据，离线）

bash

python geoskill-map-layout-automation.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out

示例 2（自定义标题与配色）

bash

python geoskill-map-layout-automation.py --input dem.tif --title "研究区地形" --cmap viridis

示例 3（省略指北针）

bash

python geoskill-map-layout-automation.py --input dem.tif --no-north

示例 4（调整比例尺占比）

bash

python geoskill-map-layout-automation.py --input dem.tif --bar-fraction 0.35

示例 5（高 dpi 输出）

bash

python geoskill-map-layout-automation.py --input dem.tif --dpi 200

输出

文件	格式	说明
layout.png	PNG	排版地图（主产物）
layout.pdf	PDF	矢量版
layout_data.tif	GeoTIFF	数据栅格（可验证产物）
layout_meta.json	JSON	比例尺/元素开关/dpi

每次运行还会产出 output-manifest.json（运行清单）。

数据源 / Source

本地 GeoTIFF / 矢量文件；--synthetic 模式生成物理一致的模拟数据，完全离线。

隐私声明 / Privacy

• 默认离线运行，--synthetic 模式完全无网络。
• 所有处理在本地完成，不上传用户数据。

License

MIT