✍️ 朱邓达 , 田冬冬 , 陈箫翰 • 📅 2025-07-06

# MAP参数

## 边框相关参数

MAP_FRAME_TYPE

  底图边框类型 [fancy]

  可选值包括 inside|plain|graph|graph-origin|fancy|fancy+|fancy-rounded。

  - 通常，地理投影默认使用 fancy 边框类型，而笛卡尔投影则默认使用 plain 边框类型。 但某些地理投影比较特殊，例如倾斜墨卡托投影（Oblique Mercator），只能使用 plain 边框类型。

  - 对于所有边界刻度和标注必须在地图内部的情况（例如，准备输出GeoTIFF），使用 inside。

  - fancy+ 相对于 fancy 的区别在于，边框的拐角为圆角。与 fancy-rounded 效果一致。

  - 对于 graph 类型，默认箭头的顶端超过坐标轴顶点 7.5%。可以通过使用 graph,length[%] 的方式指定超过的长度(c|i|p)或百分比(%)。 坐标轴的宽度由 MAP_FRAME_WIDTH 决定，箭头的长度和宽度则分别是该宽度的 10 倍 和 5 倍。箭头的形状还可以由 MAP_VECTOR_SHAPE 控制。

  - graph-origin 类型在 graph 类型基础上将 W 轴 和 S 轴移动到数据原点[0/0]。 在该类型下，仅可选择 W 和 S 轴（或 w,s,l,b 轴），而忽略 E 和 N 轴（或 e,n,r,t 轴）。 轴交点处不作刻度标注。可使用 +o xorig/yorig 自定义数据原点作为轴交点， 或者简写为 +oc 选择当前数据范围的中点。

  下图给出了不同的底图边框类型的效果：

  `Source Code`

MAP_FRAME_PEN

  底图为笛卡尔坐标系或边框类型为 plain 的地理坐标系时，边框的画笔属性 [thicker,black]

MAP_FRAME_PERCENT

  设置底图类型为 fancy 时边框内部粗线条的宽度占 MAP_FRAME_WIDTH 的百分比 [100]

MAP_FRAME_WIDTH

  设置底图类型为 fancy 时的边框宽度 [5p]

  注意： 该参数对笛卡尔坐标系底图无效。 对于 fancy 底图类型，MAP_FRAME_PEN 自动设置为 MAP_FRAME_WIDTH 的0.1倍。

MAP_FRAME_AXES

  使用 -B 选项时默认要绘制/标注的轴 [WSENZ]

  默认值 WSENZ 表示2D底图下绘制并标注四条边，3D底图下则绘制四条边和 一条Z轴。加上 + 则3D底图下会绘制完整的长方体边框。

  备注

  不建议设置该参数。建议使用 -B 选项控制实际绘制的边，详情见 -B 选项。

## 标注相关参数

MAP_ANNOT_OFFSET

  同时设置 MAP_ANNOT_OFFSET_PRIMARY 和 MAP_ANNOT_OFFSET_SECONDARY 的值

MAP_ANNOT_OFFSET_PRIMARY

  一级标注的开始位置与刻度尾端间的距离 [5p]

MAP_ANNOT_OFFSET_SECONDARY

  二级标注的顶部与一级标注的底部之间的距离 [5p]

MAP_DEGREE_SYMBOL

  在地图上绘制“度”时所使用的符号 [degree]

  可以取 ring|degree|colon|none。下图给出了取不同值时的绘图效果：

  `Source Code`

MAP_ANNOT_ORTHO

  控制笛卡尔投影下哪些轴的标注垂直于轴 [we]

  该参数可以将 wesnz 做任意组合，以设置每个轴的标注是否垂直于轴。 该参数的效果可以被 -B 选项的 +a 子选项所覆盖。

  下图给出了取不同值时的绘图效果：

  `Source Code`

  备注

  此参数仅对笛卡尔投影有效。对于地理投影，可使用 MAP_ANNOT_OBLIQUE。

MAP_ANNOT_OBLIQUE

  控制倾斜地理投影下标注和刻度的显示 [anywhere]

  该参数可以取如下几个关键词的任何组合，关键词之间以逗号分隔：

  - separate 表示经度仅标注在上边界和下边界，纬度仅标注在左边界和右边界

  - anywhere 表示在任何一个假想的网格线穿过地图边界时均标注

  - lon_horizontal 表示将经度标注水平绘制

  - lat_horizontal 表示将纬度标注水平绘制

  - tick_extend 倾斜的刻度线会扩展使得其长度等于指定刻度线长度

  - tick_normal 忽略网格线与边框的夹角，刻度线总是垂直于底图边框

  - lat_parallel 纬度标注平行于底图边框

MAP_ANNOT_MIN_ANGLE

  对于某些倾斜投影方式而言，如果标注的基线与地图边界间的夹角小于该值， 则不绘制标注。合理的取值范围为0到90 [20]

MAP_ANNOT_MIN_SPACING

  在某些倾斜投影中，相邻两个标注之间的最小距离，若标注的距离小于该值，则不绘制 [0p]

## 标签相关参数

MAP_LABEL_OFFSET

  MAP_LABEL_MODE 位置与轴标签间的偏移距离 [8p]

MAP_LABEL_MODE

  指定从何处测量标签偏移量：

  - annot : 从轴标注开始测量

  - axis : 从轴开始测量

  使用斜线分隔可为x轴和y轴设置不同的模式 [annot/axis]

## 刻度相关参数

MAP_TICK_PEN

  同时设置 MAP_TICK_PEN_PRIMARY 和 MAP_TICK_PEN_SECONDARY 的值

MAP_TICK_PEN_PRIMARY

  一级刻度的画笔属性 [thinner,black]

MAP_TICK_PEN_SECONDARY

  二级刻度的画笔属性 [thinner,black]

MAP_TICK_LENGTH

  同时设置 MAP_TICK_LENGTH_PRIMARY 和 MAP_TICK_LENGTH_SECONDARY 的值

MAP_TICK_LENGTH_PRIMARY

  一级刻度的主刻度和次刻度的长度 [5p/2.5p]

  若只给定一个长度值，则次刻度的长度假定为主刻度的一半

MAP_TICK_LENGTH_SECONDARY

  二级刻度的主刻度和次刻度的长度 [15p/3.75p]

  若只给定一个长度值，则次刻度的长度假定为主刻度的25%

## 网格线相关参数

MAP_GRID_PEN

  同时设置 MAP_GRID_PEN_PRIMARY 和 MAP_GRID_PEN_SECONDARY 的值

MAP_GRID_PEN_PRIMARY

  一级网格线的线条属性 [0.25p,black]

MAP_GRID_PEN_SECONDARY

  二级网格线的线条属性 [thinner,black]

MAP_GRID_CROSS_SIZE

  同时设置 MAP_GRID_CROSS_SIZE_PRIMARY 和 MAP_GRID_CROSS_SIZE_SECONDARY 的值

MAP_GRID_CROSS_SIZE_PRIMARY

  一级网格十字线的大小 [0p]

  - 0表示绘制连续的网格线

  - 非零值表示绘制对称的网格十字线

  - 负值表示非对称网格十字线，即只绘制远离赤道和本初子午线的刻度

MAP_GRID_CROSS_SIZE_SECONDARY

  二级网格十字线的大小 [0p]

  - 0表示绘制连续的网格线

  - 非零值表示绘制对称的网格十字线

  - 负值表示非对称网格十字线，即只绘制远离赤道和本初子午线的刻度

MAP_POLAR_CAP

  控制某些投影下两极附近网格线的显示 [85/90]

  在某些投影下，由于极点是单个点，常规的网格线绘制方法会导致极点处网格线 非常密且不美观。该选项则用于解决这一问题。

  若取值为 none，则表示不对极点附近的网格线做特殊处理。 否则可以指定 pc_lat/pc_dlon，表示在 -pc_lat 到 +pc_lat 纬度 范围内正常绘制网格线；在大于 +pc_lat 和小于 -pc_lat 纬度区域内，则 按照 pc_dlon 指定的经线间隔绘制网格线。GMT会在 ±pc_lat 纬度处绘制一个 圈圈以分隔这两个纬度区间。

  下图展示了该参数取不同值时的绘图效果：

  `Source Code`

## 标题相关参数

MAP_TITLE_OFFSET

  图标题的底部与轴标注（或轴标签）的顶部之间的距离 [14p] 。可以设置为负数进一步减小距离。

MAP_HEADING_OFFSET

  子图标题的顶部与总标题的底部之间的距离 [18p]

## 其它参数

MAP_DEFAULT_PEN

  设置所有与 -W 选项相关的画笔属性的默认值 [0.25p,black]

  在参数值的前面加上 + 可以覆盖其他 MAP_*_PEN 相关参数中的颜色。

MAP_ORIGIN_X

  新绘图在纸张上的原点的X坐标（仅适用于GMT经典模式）[72p]

MAP_ORIGIN_Y

  新绘图在纸张上的原点的Y坐标（仅适用于GMT经典模式）[72p]

MAP_LOGO

  是否在左下角绘制GMT时间戳 [false]

  可以取 true|false，等效于在命令行中使用 -U 选项。

  备注

  该参数存在已知BUG，见 https://github.com/GenericMappingTools/gmt/issues/3902

MAP_LOGO_POS

  GMT时间戳相对于当前绘图原点的对齐方式与位置 [BL/-54p/-54p]

MAP_SCALE_HEIGHT

  地图比例尺的高度 [5p]

MAP_LINE_STEP

  绘制线段时所使用的最大步长 [0.75p]

  地理投影下，两点之间会用大圆路径连接，因而GMT需要先计算大圆路径上的其他 中间点的坐标，并将这些点用直线连起来。若该步长太大，会导致大圆路径看上去 很不光滑；若太小，则会导致数据点太密，图片太大。

MAP_VECTOR_SHAPE

  矢量箭头的形状 [0]

  可以取-2到2之间的任意实数。下面展示了取-2、-1、0、1和2时的矢量箭头的形状：

  `Source Code`

MAP_EMBELLISHMENT_MODE

  确定地图修饰物（如方向或磁场玫瑰图、地图比例尺或垂直数据比例尺） 是否应该具有随特征大小缩放的属性（auto）或完全使用手动设置（manual）。[auto]

MAP_SYMBOL_PEN_SCALE

  指定一个0-1之间的比例或百分比，用于将不可填充的符号（x, y, + 和 -） 大小转换为用于描划这些符号的笔的宽度 [15%]。 如果设置为0，则不做此类转换，并且画笔设置必须依赖于 -W 或模块默认值。