Histogram
汇总
Histogram 类可创建直方图。 通过测量某些值在数据集中显示的频数，直方图直观地概述了一个或多个连续数值变量的分布。
讨论
创建此对象时，必须使用参数名指定类构造函数的可选参数；这些可选参数不能通过参数位置指定。 有关如何使用关键字指定参数的示例，请参阅代码示例部分。
语法
Histogram(x, {splitCategory}, {miniChartsPerRow}, {showPreviewChart}, {binCount}, {showMean}, {showMedian}, {showStandardDeviation}, {showComparisonDistribution}, {dataTransformationType}, {dataTransformationParameters}, {title}, {description}, {xTitle}, {yTitle}, {dataSource}, {displaySize}, {theme})
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
x |
The field names for the x-axis variables. The field must be a single numeric field name or a list of numeric field names. For a raster layer, specify a band name. |
String |
|
splitCategory （可选） |
A categorical field that adds a separate series for each unique value in the field. |
String |
|
miniChartsPerRow （可选） |
每行显示的迷你图表的数量。 |
Integer |
|
showPreviewChart （可选） |
指定是否在格网图表中显示预览图表。
(默认值为 False) |
Boolean |
|
binCount （可选） |
The number of bins that will be displayed in the histogram. |
Integer |
|
showMean （可选） |
Specifies whether the mean statistical line will be visible in the histogram.
|
Boolean |
|
showMedian （可选） |
Specifies whether the median statistical line will be visible in the histogram.
|
Boolean |
|
showStandardDeviation （可选） |
Specifies whether the standard deviation lines will be visible in the histogram.
|
Boolean |
|
showComparisonDistribution （可选） |
Specifies whether the normal distribution comparison line will be visible in the histogram.
|
Boolean |
|
dataTransformationType （可选） |
Specifies the data transformation type that will be applied. When multiple x-axis fields are defined, use a list of strings—in the same order as the
|
String |
|
dataTransformationParameters （可选） |
The data transformation parameters for the boxCox transformation. This parameter accepts a two-item list in which the first item is the power parameter and the second item is the shift parameter. When multiple x-axis fields are defined, use a two-dimensional list—in the same order as the |
List |
|
title （可选） |
图表的标题。 标题文本显示在图表视图的顶部，并在 内容 窗格中用作图表的标注。 |
String |
|
description （可选） |
图表的描述。 该描述文本会显示于图表视图底部。 |
String |
|
xTitle （可选） |
图表 x 轴的标题。 |
String |
|
yTitle （可选） |
图表 y 轴的标题。 |
String |
|
dataSource （可选） |
图表的数据源。 当通过 |
Object |
|
displaySize （可选） |
当使用 |
List |
|
theme （可选） |
指定将应用于图表的主题。
|
String |
属性
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
binCount （读取和写入） |
将在直方图中显示的 立方图格数量 。 |
Integer |
|
color （读取和写入） |
将应用于每个图表系列的颜色。 该值应为十六进制字符串值的列表。 如果未设置此属性，则系列颜色将匹配符号系统颜色（如果适用）。否则，将应用标准调色板。 |
List |
|
dataSource （读取和写入） |
图表的数据源。 当通过 |
Object |
|
dataTransformationParameters （读取和写入） |
Box-Cox 变换的数据 变换 参数。 此参数接受两个项目的列表，其中第一个项目是幂参数，第二个项目是偏移参数。 在定义多个 x 轴字段时，使用两维列表，顺序与 |
List |
|
dataTransformationType （读取和写入） |
指定将应用的数据 变换 类型。 在定义多个 x 轴字段时，使用字符串列表，顺序与
|
String |
|
description （读取和写入） |
图表的描述。 该描述文本会显示于图表视图底部。 |
String |
|
displaySize （读取和写入） |
当使用 |
List |
|
enableServerSideProcessing （读取和写入） |
指定当数据来自企业级数据库或云数据仓库时，是否将使用 服务器端处理 。
|
Boolean |
|
legend （读取和写入） |
图表图例的属性。
|
Object |
|
miniChartsPerRow （读取和写入） |
每行显示的迷你图表的数量。 |
Integer |
|
showComparisonDistribution （读取和写入） |
指定是否将在直方图中显示正态分布比较线。
|
Boolean |
|
showMean （读取和写入） |
指定是否将在直方图中显示平均统计线。
|
Boolean |
|
showMedian （读取和写入） |
指定是否将在直方图中显示中值统计线。
|
Boolean |
|
showPreviewChart （读取和写入） |
指定是否在格网图表中显示预览图表。
|
Boolean |
|
showStandardDeviation （读取和写入） |
指定是否将在直方图中显示标准差线。
|
Boolean |
|
splitCategory （读取和写入） |
类别字段，将为字段中每一个唯一值添加单独的系列。 |
String |
|
theme （读取和写入） |
指定将应用于图表的主题。
|
String |
|
title （读取和写入） |
图表的标题。 标题文本显示于图表视图顶部，并用作 内容 窗格中 按绘制顺序列出 选项卡 |
String |
|
type （只读） |
用于指示图表类型的字符串值。 |
String |
|
x （读取和写入） |
x 轴变量的字段名称。 字段必须为单一数值字段名称或数字字段名称列表。 对于栅格图层，指定波段名称。 |
String |
|
xAxis （读取和写入） |
指定 x 轴的属性。
|
Object |
|
yAxis （读取和写入） |
指定 y 轴的属性。
|
Object |
的标注。方法
addToLayer(layer_or_layerfile)
addToLayer 方法可将图表对象添加到图层或表视图。
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
layer_or_layerfile |
The chart will be added to the target object. This argument can be a |
Object |
将图表添加到现有图层。
import arcpy
# Insert creation of chart object here
# ...
aprx = arcpy.mp.ArcGISProject("current")
map = aprx.listMaps()[0]
censusLayer = map.listLayers('Census Block Groups')[0]
# Add chart object to a layer
chart.addToLayer(censusLayer)
exportToJPEG(path, width, height)
exportToJPEG 方法用于将图表导出为 JPEG 格式。
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
path |
The path where the chart will be exported in JPEG format. |
String |
|
width |
The width of the output graphic. |
Integer |
|
height |
The height of the output graphic. |
Integer |
将具有要素服务数据源的图表导出到 .jpeg 文件中。
import arcpy
# Insert creation of chart object here
# ...
featureServiceURL = r'https://services1.arcgis.com/hLJbHVT9ZrDIzK0I/arcgis/rest/services/CrimesChiTheft/FeatureServer/0'
# Set data source of chart object to a feature service URL
chart.dataSource = featureServiceURL
# Save the chart to file with dimensions width=800, height=600
chart.exportToJPEG('theftsPerBeat.jpg', 800, 600)
exportToPNG(path, width, height)
exportToPNG 方法用于将图表导出为 PNG 格式。
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
path |
The path where the chart will be exported in PNG format. |
String |
|
width |
The width of the output graphic. |
Integer |
|
height |
The height of the output graphic. |
Integer |
从图层访问现有图表，更新标题，然后将其导出为 .png 文件。
import arcpy
lyr = arcpy.mp.ArcGISProject('current').listLayers()[0]
# Retrieve the first chart belonging to the layer
chart = lyr.listCharts()[0]
# Update chart title
chart.title = 'Voter Turnout by State'
# Save the chart to PNG file with dimensions width=800, height=600
chart.exportToPNG('populationByState.png', 800, 600)
exportToSVG(path, width, height)
exportToSVG 方法可将图表导出为 SVG 格式。
| 名称 | 说明 | 数据类型 |
|---|---|---|
|
path |
将图表以 SVG 格式导出时的路径。 |
String |
|
width |
输出图形的宽度。 |
Integer |
|
height |
输出图形的高度。 |
Integer |
将具有工程图层数据源的图表导出到 .svg 文件中。
import arcpy
# Insert creation of chart object here
# ...
aprx = arcpy.mp.ArcGISProject('current')
censusLayer = aprx.listMaps()[0].listLayers('Census Block Groups')[0]
# Set data source of chart object to a layer in current project
chart.dataSource = censusLayer
# Save the chart to file with dimensions width=500, height=500
chart.exportToSVG('populationByState.svg', 500, 500)
updateChart()
该 updateChart 方法可更新图表属性，以同步对象与之前添加到图层的图表之间的更改。
可以使用 updateChart 方法将图表属性更改同步到图层中。
import arcpy
# Insert creation of chart object here
# ...
chart.addToLayer(myLayer)
# Further modification is necessary
chart.description = "Data from the U.S. Census Bureau"
chart.updateChart()
代码示例
可以使用图层名称作为数据源来创建直方图，然后将该直方图导出至 .svg 文件。
import arcpy
chart = arcpy.charts.Histogram("price", binCount=20, showMedian=True)
chart.dataSource = "airbnb_listings"
chart.title = "Distribution of AirBnB Listing Price"
chart.exportToSVG("histogram.svg", width=1000, height=800)