cartopy.mpl.gridliner.Gridliner#

class cartopy.mpl.gridliner.Gridliner(axes, crs, draw_labels=False, xlocator=None, ylocator=None, collection_kwargs=None, xformatter=None, yformatter=None, dms=False, x_inline=None, y_inline=None, auto_inline=True, xlim=None, ylim=None, rotate_labels=None, xlabel_style=None, ylabel_style=None, labels_bbox_style=None, xpadding=5, ypadding=5, offset_angle=25, auto_update=None, formatter_kwargs=None)[源代码]#

基类：Artist

使用的艺术家 cartopy.mpl.geoaxes.GeoAxes.gridlines() 在地图上添加网格线和刻度标签。

参数:

  • axes -- 的 cartopy.mpl.geoaxes.GeoAxes 要绘制的对象。

  • crs -- 的 cartopy.crs.CRS 定义绘制网格线的坐标系。

  • draw_labels (optional) -- 切换是否绘制标签。为了更好地控制， Gridliner 可以单独修改。默认为假。 - 字符串：“x”或“y”仅绘制相应的标签 在CRS中协调。- 列表：可以包含侧面标识符和/或坐标 类型以选择要绘制的类型。 对于所有使用的标签 ["x", "y", "top", "bottom", "left", "right", "geo"] . - dict：密钥是侧标识符 （“顶部”、“底部”、“左”、“右”）并且值是 坐标（“x”、“y”）;这样您就可以精确地 决定绘制什么样的标签以及在哪里。 对于底部的x标签和右侧的y标签， 可以通过 {"bottom": "x", "left": "y"} . 请注意，默认情况下，x和y标签不会分别绘制在左/右和上/下边缘，除非明确要求。

  • xlocator (optional) -- A matplotlib.ticker.Locator 实例，该实例将用于确定网格线在给定CRS的x坐标中的位置。返回到无，这意味着自动定位网格线。

  • ylocator (optional) -- A matplotlib.ticker.Locator 实例，该实例将用于确定网格线在给定CRS的y坐标中的位置。返回到无，这意味着自动定位网格线。

  • xformatter (optional) -- A matplotlib.ticker.Formatter 实例来格式化x坐标网格线的标签。它默认为无，这意味着使用 cartopy.mpl.ticker.LongitudeFormatter 开始与 dms 论点，如果crs是 PlateCarree 类型.

  • yformatter (optional) -- A matplotlib.ticker.Formatter 实例来格式化y坐标网格线的标签。它默认为无，这意味着使用 cartopy.mpl.ticker.LatitudeFormatter 开始与 dms 论点，如果crs是 PlateCarree 类型.

  • collection_kwargs (optional) -- 字典控制行属性，传递给 matplotlib.collections.Collection .切换到无。

  • dms (bool) -- 使用默认定位器和格式器时，如果分钟设置为True，而不是分数度，则刻度可以在分钟和秒上停止。

  • x_inline (optional) -- 切换绘制的x标签是否应内联。

  • y_inline (optional) -- 切换绘制的y标签是否应内联。

  • auto_inline (optional) -- 根据投影自动设置x_inline和y_inline。

  • xlim (optional) -- 为网格线设置限制，以便它们不会一直延伸到边界的边缘。xlim可以是单个数字或（min，max）多元组。如果是单个数字，则限制为（-xlim，+xlim）。

  • ylim (optional) -- 为网格线设置限制，以便它们不会一直延伸到边界的边缘。ylim可以是单个数字或（min，max）多元组。如果是单个数字，则限制为（-ylim，+ylim）。

  • rotate_labels (optional, bool, str) -- 允许旋转非内联标签。 - 否：不旋转标签。- True：平行于网格线旋转标签。- 无：除某些投影外不旋转（默认）。- 浮动：按照此值（以度为单位）旋转标签。

  • xlabel_style (dict) -- 一本词典传递给 ax.text 在x标签上创建文本标签的样式。

  • ylabel_style (dict) -- 一本词典传递给 ax.text 在y标签上创建用于文本标签样式的标签。

  • labels_bbox_style (dict) -- 所有文本标签的bbox样式

  • xpadding (float) -- x标签的填充。如果为负，则在地图内部绘制标签。

  • ypadding (float) -- y标签的填充。如果为负，则在地图内部绘制标签。

  • offset_angle (float) -- 以度为单位的角度差以定义何时必须翻转标签以更具可读性。例如，值为10时，垂直顶部标签只能翻转100度。

  • auto_update (bool, default=True) -- 更新图形时是否重新绘制网格线和标签。 ..已废弃：：0.23 将来，网格线和标签总是会被重新绘制。

  • formatter_kwargs (dict, optional) -- 传递给默认格式器的选项。看到 LongitudeFormatter 和 LatitudeFormatter

备注

定位器和格式器的“x”和“y”标签不一定对应于X和Y，而是对应于指定CRS的第一个和第二个坐标。对于PlateCarree网格线的常见情况，这些网格线对应于纬度和纬度。根据地图使用的投影，子午线和平行线可以同时穿过X轴和Y轴。

property bottom_label_artists#

绘制时创建的底部标签

bottom_labels#

是否在地图底部绘制标签。

collection_kwargs#

一本词典传递给 matplotlib.collections.LineCollection 关于网格线创建。

draw(renderer=None)[源代码]#

使用给定的渲染器绘制艺术家（及其孩子）。

如果艺术家不可见，则没有任何影响 (Artist.get_visible 返回False）。

参数:

renderer (RendererBase subclass.)

备注

此方法在Artist子类中被重写。

property geo_label_artists#

绘图时创建的地理脊柱标签

geo_labels#

是否在地图地理界限附近绘制标签。

get_tightbbox(renderer=None)[源代码]#

像 Artist.get_window_extent ，但包括任何剪辑。

参数:

renderer (RendererBase subclass, optional) -- 用于绘制图形的渲染器（即 fig.canvas.get_renderer() )

返回:

Bbox 或无--封闭的边界框（以图形像素坐标为单位）。如果剪裁导致没有交集，则返回无。

get_visible_children()[源代码]#

返回可见子项的列表 Artist s。

property label_artists#

抽奖时创建的所有标签

labels_bbox_style#

网格标签的bbox样式

property left_label_artists#

抽奖时创建的左侧标签

left_labels#

是否在地图左侧绘制标签。

n_steps#

用于绘制网格线的插值点的数量。

property right_label_artists#

抽奖时创建的正确标签

right_labels#

是否在地图右侧绘制标签。

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)#

一次设置多个属性。

支持的属性有

属性：

agg_滤镜：过滤器函数，它采用（m，n，3）浮点数组和pi值，并返回（m，n，3）数组和图像左下角的两个偏差Alpha：float或无动画：bool clip_box： BboxBase 或None clip_on：bool clip_path：Patch或（Path，Transform）或None图形： Figure 或 SubFigure gid：字符串in_layout：bool标签：对象鼠标悬停：bool路径_效果：列表 AbstractPathEffect 选择者：无或布尔或浮动或可调用网格化：布尔sketch_params：（比例：浮动，长度：浮动，随机性：浮动）捕捉：布尔或无变换： Transform url：url可见：bool zorder：float

property top_label_artists#

抽奖时创建的顶级标签

top_labels#

是否在地图顶部绘制标签。

x_inline#

是否内联绘制x标签

property x_inline_label_artists#

绘制时创建的x坐标内联标注

xformatter#

的 Formatter 用于长标签。

property xlabel_artists#

绘制时创建的x坐标标签

xlabel_style#

一本词典传递给 ax.text 在x标签上创建文本标签的样式。

xline_artists#

在绘图时创建的x网格线。

xlines#

是否绘制x网格线。

xpadding#

从地图边缘到x标签的填充点。

y_inline#

是否内联绘制y标注

property y_inline_label_artists#

绘制时创建的y坐标内联标签

yformatter#

的 Formatter 用于最新标签。

property ylabel_artists#

绘制时创建的y坐标标注

ylabel_style#

一本词典传递给 ax.text 在y标签上创建用于文本标签样式的标签。

yline_artists#

在抽签时创建的y网格线。

ylines#

是否绘制y网格线。

ypadding#

从地图边缘到y标签的填充点。