mars.dataframe.Series.plot#

Series.plot()#

制作系列或数据框的图表。

使用选项 plotting.backend 指定的后端。默认情况下，使用 matplotlib。

Parameters

  • data (Series 或 DataFrame) – 方法所调用的对象。

  • x (标签 或 位置, 默认值 None) – 仅在数据为 DataFrame 时使用。

  • y (标签, 位置或标签的列表, 位置, 默认值为 None) – 允许绘制一列与另一列的关系。仅在数据为 DataFrame 时使用。

  • kind (str) –

    要生成的图表类型：

    • ’line’ : 折线图（默认）

    • ’bar’ : 纵向柱状图

    • ’barh’ : 横向柱状图

    • ’hist’ : 直方图

    • ’box’ : 箱形图

    • ’kde’ : 核密度估计图

    • ’density’ : 与‘kde’相同

    • ’area’ : 面积图

    • ’pie’ : 饼图

    • ’scatter’ : 散点图（仅限DataFrame）

    • ’hexbin’ : 六边形图（仅限DataFrame）

  • ax (matplotlib 轴对象, 默认值为 None) – 当前图形的一个轴。

  • subplots (bool, 默认值为 False) – 为每一列创建单独的子图。

  • sharex (bool, 如果 ax 为 None，则默认为 True，否则为 False) – 如果subplots=True，共享 x 轴并将一些 x 轴标签设置为不可见；默认值为 True 如果 ax 为 None，否则为 False 如果传入一个 ax；请注意，传入一个 ax 和sharex=True 将会改变图形中所有轴的所有 x 轴标签。

  • sharey (bool, 默认值为 False) – 如果 subplots=True，共享 y 轴并将某些 y 轴标签设置为不可见。

  • 布局 (元组, 可选) – 子图的布局（行，列）。

  • figsize (一个元组 (宽度, 高度) 以英寸为单位) – 图形对象的大小。

  • use_index (bool, 默认值为 True) – 将索引用作 x 轴的刻度。

  • 标题 (str 或 list) – 绘图使用的标题。如果传递一个字符串，那么在图的顶部打印该字符串。如果传递一个列表，并且subplots为真，那么在对应的子图上方打印列表中的每个项目。

  • 网格 (布尔, 默认值 无 (matlab 风格默认值)) – 轴网格线。

  • 图例 (布尔值 或 {'反向'}) – 将图例放置在轴子图上。

  • 样式 (列表 或 字典) – 每列的 matplotlib 线条样式。

  • logx (bool 或 'sym', 默认是 False) – 在 x 轴上使用对数缩放或对称对数缩放。 .. versionchanged:: 0.25.0

  • logy (bool 或 'sym' 默认 False) – 在 y 轴上使用对数缩放或对称对数缩放。 .. versionchanged:: 0.25.0

  • loglog (bool 或 'sym', 默认值为 False) – 在线性标度上使用对数缩放或双对数缩放。 .. versionchanged:: 0.25.0

  • xticks (序列) – 用于 xticks 的值。

  • yticks (sequence) – 用于yticks的值。

  • xlim (2-tuple/list) – 设置当前坐标轴的x轴范围。

  • ylim (2元组/列表) – 设置当前坐标轴的y轴限制。

  • xlabel (label, optional) –

    用于x轴的xlabel的名称。默认使用索引名称作为xlabel，或平面图的x列名称。

    在版本1.1.0中新增。

    在版本1.2.0中更改：现在适用于平面图（scatter，hexbin）。

  • ylabel (label, optional) –

    用于y轴的ylabel名称。默认情况下将不显示ylabel，或显示平面图的y列名称。

    在1.1.0版本中新增。

    在1.2.0版本中更改：现在适用于平面图（scatter，hexbin）。

  • rot (int, default None) – 刻度的旋转（垂直图的横坐标刻度，水平图的纵坐标刻度）。

  • fontsize (int, default None) – xticks 和 yticks 的字体大小。

  • colormap (str 或 matplotlib colormap对象, 默认值 None) – 要选择颜色的颜色映射。如果是字符串，则从matplotlib中加载那个名称的颜色映射。

  • colorbar (bool, 可选) – 如果为 True，则绘制颜色条（仅对“散点图”和“六边形图”相关）。

  • position (float) – 指定条形图布局的相对对齐方式。从0（左/底端）到1（右/顶端）。默认值为0.5（中心）。

  • table (bool, Series 或 DataFrame, 默认值为 False) – 如果为 True，则使用 DataFrame 中的数据绘制表格，数据将转置以符合 matplotlib 的默认布局。如果传入 Series 或 DataFrame，则使用传入的数据绘制表格。

  • yerr (数据框, 序列, 类似数组, 字典和字符串) – 查看 带误差条的绘图 以获取详细信息。

  • xerr (数据框, 序列, 类似数组, 字典和字符串) – 相当于 yerr.

  • 堆叠 (布尔值, 在线图和条形图中默认为 False, 在区域图中为 True) – 如果为 True，则创建堆叠图。

  • sort_columns (bool, 默认值为 False) – 对列名进行排序以确定图表顺序。

  • secondary_y (bool 或 序列, 默认为 False) – 如果是列表/元组，则是否在第二个 y 轴上绘图，以及要在第二个 y 轴上绘制的列。

  • mark_right (bool, default True) – 当使用 secondary_y 轴时，在图例中自动用“(right)”标记列标签。

  • include_bool (bool, 默认为 False) – 如果为 True，可以绘制布尔值。

  • backend (str, default None) –

    要使用的后端，代替选项中指定的后端 plotting.backend。例如，‘matplotlib’。或者，要为整个会话指定 plotting.backend，请设置 md.options.plotting.backend。

    在版本 1.0.0 中新增。

  • **kwargs – 传递给matplotlib绘图方法的选项。

Returns

如果后端不是默认的matplotlib后端，则返回值将是后端返回的对象。

Return type

matplotlib.axes.Axes 或它们的numpy.ndarray

备注

  • 有关此主题的更多信息，请参阅matplotlib在线文档

  • 如果 kind = ‘bar’ 或 ‘barh’，你可以通过 position 关键字指定条形图布局的相对对齐方式。从 0（左/底端）到 1（右/顶端）。默认值为 0.5（中心）