Graph

描述

图表类有助于您创建不同类型的图表。而且，您可指定常规图表属性，例如标题、图表轴和图例信息。

说明

可借助图表以直观易懂的方式呈现地图要素的相关信息以及它们之间的关系。也可以为非空间表格数据创建图表，并且可以通过图表显示地图中要素的附加信息或以另一种不同的方式显示这些信息。图表与地图是相辅相成的，因为图表简单、直观地传达了通常以数字形式汇总或从表格中发掘的信息。通过图表可以快速轻松地比较各要素，从而深入了解各要素之间的函数关系，由此以可视化方法显示其他方式难以呈现的数据分布、趋势和模式。

属性

属性	说明	数据类型
graphAxis （可读写）	设置图表的轴（左、右、下和上）标题。 graphAxis 属性 说明 aType 应用于图表且无需考虑图表中系列数目或类型的图表类型属性。graphAxis 属性是常规图表属性。 左 图表左轴的标题。例如，可将 graphAxis[0] 设置为 "Left Axis"，以指定左轴的标题。 右 图表右轴的标题。例如，可以将 graphAxis[1] 设置为 "Right Axis"，以指定右轴的标题。 下 图表下轴的标题。例如，可以将 graphAxis[2] 设置为 "Bottom Axis"，以指定下轴的标题。 上 图表上轴的标题。例如，可以将 graphAxis[3] 设置为 "Top Axis"，以指定上轴的标题。	Object
graphPropsGeneral （可读写）	设置常规属性，如图表的标题、子标题和页脚等。 graphPropsGeneral 属性 说明 aType 应用于图表且无需考虑图表中系列数目或类型的图表类型属性。graphPropsGeneral 属性是常规图表属性。 页脚 指定显示在图表页脚中的文本。 子标题 指定显示在图表子标题中的文本。 标题 指定显示在图表标题中的文本。	Object
graphPropsLegend （可读写）	设置图表中的图例标题。 graphPropsLegend 属性 说明 aType 应用于图表且无需考虑图表中系列数目或类型的图表类型属性。graphPropsLegend 属性是常规图表属性。 标题 指定显示在图表的图例标题中的文本。	Object
graphSeries （可读写）	获得与图表相关的图表系列。图表中有多个系列时，您即可获得与各个系列相关的信息。	Object

方法概述

方法	说明
addSeriesAreaHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})	创建可添加到图表的新“水平面积图”系列。 了解有关水平面积图表的详细信息
addSeriesAreaVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})	创建可添加到图表的新“垂直面积图”系列。 了解有关垂直面积图表的详细信息
addSeriesBarHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})	创建可添加到图表的新“水平条形图”系列。 了解有关水平条形图的详细信息
addSeriesBarMinMax (dataSrc, fieldYMax, fieldYMin, {fieldX}, {fieldLabel}, {sortType})	创建可添加到图表的新“条最小值和最大值图”系列。 了解有关条最小值和最大值图的详细信息
addSeriesBarVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})	创建可添加到图表的新“垂直条形图”系列。 了解有关垂直条形图的详细信息
addSeriesBoxPlot (dataSrc, fieldValue)	创建可添加到图表的新箱形图系列。 了解有关箱形图的详细信息
addSeriesBubble (dataSrc, fieldRadius, fieldY, {fieldX}, {fieldLabel})	创建可添加到图表的新“气泡图”系列。 了解有关气泡图的详细信息
addSeriesHistogram (dataSrc, fieldValue, countBin)	创建可添加到图表的新“直方图”系列。 了解有关直方图的详细信息
addSeriesLineHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})	创建可添加到图表的新“水平线图”系列。 了解有关水平线图的详细信息
addSeriesLineVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})	创建可添加到图表的新“垂直线图”系列。 了解有关垂直线图的详细信息
addSeriesPie (dataSrc, fieldValue, fieldSort, {fieldLabel}, {sortType})	创建可添加到图表的新“饼图”系列。 了解有关饼图的详细信息
addSeriesPolar (dataSrc, fieldRadius, {fieldAngle}, {fieldLabel})	创建可添加到图表的新“极线图”系列。 了解有关极线图的详细信息
addSeriesScatterPlot (dataSrc, fieldY, {fieldX}, {fieldLabel})	创建可添加到图表的新“散点图”系列。 了解有关散点图的详细信息

方法

addSeriesAreaHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	The layer or table containing the data values that will be used to create the graph.	Layer
fieldX	The attribute field that will be used to plot value along the X-axis of the Horizontal Area graph.	Field
fieldY	The attribute field that will be used to plot value along the Y-axis of the Horizontal Area graph.	Field
fieldLabel	The attribute field that will be used to plot labels for data points along the horizontal area in the graph.	Field
sortType	Specify how the data values in the attribute field used for defining the Y-axis will be sorted. VALUE —Sort the data values based on the order of values in the input layer or table. This is the default. ASC —Sort the data values in ascending order (lowest to highest). DESC —Sort the data values in descending order (highest to lowest).	String

addSeriesAreaVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	The layer or table containing the data values that will be used to create the graph.	Layer
fieldY	The attribute field that will be used to plot value along the Y-axis of the Vertical Area graph.	Field
fieldX	The attribute field that will be used to plot value along the X-axis of the Vertical Area graph.	Field
fieldLabel	The attribute field that will be used to plot labels for data points along the vertical area in the graph.	Field
sortType	Specify how the data values in the attribute field used for defining the X-axis will be sorted. VALUE —Sort the data values based on the order of values in the input layer or table. This is the default. ASC —Sort the data values in ascending order (lowest to highest). DESC —Sort the data values in descending order (highest to lowest).	String

addSeriesBarHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldX	将用于沿水平条形图的 X 轴绘制值的属性字段。	Field
fieldY	将用于沿水平条形图的 Y 轴绘制值的属性字段。	Field
fieldLabel	将用于沿图表中的水平条绘制数据点标注的属性字段。	Field
sortType	指定如何对用于定义 Y 轴的属性字段中的数据值进行排序。 VALUE —根据输入图层或表格中的值顺序对数据值进行排序。这是默认设置。 ASC —按升序（从最低到最高）对数据值进行排序。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesBarMinMax (dataSrc, fieldYMax, fieldYMin, {fieldX}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldYMax	将用于沿条最小值和最大值图的 Y 轴绘制最大值的属性字段。	Field
fieldYMin	将用于沿条最小值和最大值图的 Y 轴绘制最小值的属性字段。	Field
fieldX	将用于沿条最小值和最大值图的 Y 轴绘制值的属性字段。	Field
fieldLabel	将用于沿图表中的条绘制数据点标注的属性字段。	Field
sortType	指定如何对用于定义 X 轴的属性字段中的数据值进行排序。 VALUE —根据输入图层或表格中的值顺序对数据值进行排序。这是默认设置。 ASC —按升序（从最低到最高）对数据值进行排序。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesBarVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldY	将用于沿垂直条形图的 Y 轴绘制值的属性字段。	Field
fieldX	将用于沿垂直条形图的 X 轴绘制值的属性字段。	Field
fieldLabel	将用于沿图表中的垂直条绘制数据点标注的属性字段。	Field
sortType	指定如何对用于定义 X 轴的属性字段中的数据值进行排序。 VALUE —根据输入图层或表格中的值顺序对数据值进行排序。这是默认设置。 ASC —按升序（从最低到最高）对数据值进行排序。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesBoxPlot (dataSrc, fieldValue)

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldValue	用于在箱形图中绘制值的属性字段。	Field

addSeriesBubble (dataSrc, fieldRadius, fieldY, {fieldX}, {fieldLabel})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldRadius	用于定义气泡图中的气泡半径的属性字段。	Field
fieldY	将用于沿气泡图的 Y 轴绘制值的属性字段。	Field
fieldX	将用于沿气泡图的 X 轴绘制值的属性字段。	Field
fieldLabel	将用于在图表中绘制数据点标注的属性字段。	Field

addSeriesHistogram (dataSrc, fieldValue, countBin)

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldValue	用于在直方图的条柱中显示频率分布的属性字段。直方图中的条柱高度表示落在每个条柱中的项目数的频数。	Field
countBin	直方图中的条柱数。	Integer

addSeriesLineHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldX	将用于沿水平线图的 X 轴绘制值的属性字段。	Field
fieldY	将用于沿水平线图的 Y 轴绘制值的属性字段。	Field
fieldLabel	将用于沿图表中的水平线绘制数据点标注的属性字段。	Field
sortType	指定如何对用于定义 Y 轴的属性字段中的数据值进行排序。 VALUE —根据输入图层或表格中的值顺序对数据值进行排序。这是默认设置。 ASC —按升序（从最低到最高）对数据值进行排序。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesLineVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldY	将用于沿垂直线图的 Y 轴绘制值的属性字段。	Field
fieldX	将用于沿垂直线图的 X 轴绘制值的属性字段。	Field
fieldLabel	将用于沿图表中的垂直线绘制数据点标注的属性字段。	Field
sortType	指定如何对用于定义 X 轴的属性字段中的数据值进行排序。 VALUE —根据输入图层或表格中的值顺序对数据值进行排序。这是默认设置。 ASC —按升序（从最低到最高）对数据值进行排序。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesPie (dataSrc, fieldValue, fieldSort, {fieldLabel}, {sortType})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldValue	将用于在饼图中绘制值或楔形的属性字段。	Field
fieldSort	将用于按升序或降序对楔形进行排序的属性字段。	Field
fieldLabel	将用于在饼图中绘制标注的属性字段。	Field
sortType	指定如何在用于排序的属性字段中对数据值进行排序。 ASC —按升序（从最低到最高）对数据值进行排序。这是默认设置。 DESC —按降序（从最高到最低）对数据值进行排序。	String

addSeriesPolar (dataSrc, fieldRadius, {fieldAngle}, {fieldLabel})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldRadius	将在极线图的径向轴上绘制其值的属性字段。	Field
fieldAngle	将为极线图中的每个数据点提供角度位置的属性字段。	Field
fieldLabel	将用于在图表上绘制表示数据值的标注的属性字段。	Field

addSeriesScatterPlot (dataSrc, fieldY, {fieldX}, {fieldLabel})

参数	说明	数据类型
dataSrc	包含将用于创建图表的数据值的图层或表格。	Layer
fieldY	将用于沿散点图的 Y 轴绘制值的属性字段。	Field
fieldX	将用于沿散点图的 X 轴绘制值的属性字段。	Field
fieldLabel	将用于在图表中绘制数据点标注的属性字段。	Field

代码示例

图表示例

以下脚本创建了垂直条形图并将其保存为影像。

import arcpy

out_graph_name = "VerticalBarGraph"
out_graph_bmp = "c:/temp/VerticalBarGraph.bmp"
input_template = "c:/data/makegraph/VerticalBar.tee"
input_data = "c:/data/makegraph/Rainfall.gdb/Rainfall"

# Create the graph
graph = arcpy.Graph()

# Add a vertical bar series to the graph
graph.addSeriesBarVertical(input_data, "Rainfall_Stations_OBJECTID")

# Specify the title of the left axis
graph.graphAxis[0].title = "Rainfall"

# Specify the title of the bottom axis
graph.graphAxis[2].title = "Days"

# Specify the title of the Graph
graph.graphPropsGeneral.title = "Amount of Rainfall"

# Output a graph, which is created in-memory
arcpy.MakeGraph_management(input_template, graph, out_graph_name)

# Save the graph as an image
arcpy.SaveGraph_management(out_graph_name, out_graph_bmp,
                           "MAINTAIN_ASPECT_RATIO", 600, 375)