Bar
Краткая информация
Класс Bar создает линейчатые диаграммы. Линейчатая диаграмма суммирует и сравнивает категории данных, используя длину линейки для отображения данных.
Более подробно об использовании линейчатых диаграмм в ArcGIS Pro.
Обсуждение
При создании этого объекта дополнительные аргументы конструктора классов должны указываться с помощью имени аргумента; их нельзя указывать позицией аргумента. См. раздел с примерами кодов, содержащий пример того, как можно задавать аргументы, используя ключевые слова.
Синтаксис
Bar(x, {y}, {aggregation}, {splitCategory}, {multiSeriesDisplay}, {miniChartsPerRow}, {showPreviewChart}, {showMovingAverage}, {movingAveragePeriod}, {timeBinningProperties}, {rotated}, {title}, {description}, {xTitle}, {yTitle}, {dataSource}, {displaySize}, {theme})
| Имя | Объяснение | Тип данных |
|---|---|---|
|
x |
Имя поля для переменной оси x. Поле должно быть полем категории или даты. Если задана пустая строка, диаграмма будет соответствовать символам слоя. |
String |
|
y (Дополнительный) |
Имена для числовых полей. Укажите одно имя поля или список имен полей. |
String |
|
aggregation (Дополнительный) |
Задает статистическое вычисление, которое будет применяться к значениям, агрегированным в каждом столбце.
|
String |
|
splitCategory (Дополнительный) |
Поле второй категории, которое добавляет отдельные серии или столбец для каждого уникального значения в поле. |
String |
|
multiSeriesDisplay (Дополнительный) |
Задает тип отображения для линейчатой диаграммы с несколькими сериями.
|
String |
|
miniChartsPerRow (Дополнительный) |
Число мини диаграмм, которые будут отображаться в строке. |
Integer |
|
showPreviewChart (Дополнительный) |
Показывает, будет ли отображаться предварительный просмотр диаграмм в гриде.
(Значение по умолчанию — False) |
Boolean |
|
showMovingAverage (Дополнительный) |
Указывает, будет ли отображена линия скользящего среднего на временной линейчатой диаграмме.
(Значение по умолчанию — False) |
Boolean |
|
movingAveragePeriod (Дополнительный) |
Размер периода скользящего среднего. |
Integer |
|
timeBinningProperties (Дополнительный) |
Свойства биннинга времени, применяемые к временным диаграммам. Ожидает объект |
Object |
|
rotated (Дополнительный) |
Указывает, будут ли диаграммы отображаться вертикально или горизонтально.
(Значение по умолчанию — False) |
Boolean |
|
title (Дополнительный) |
Заголовок диаграммы. Текст заголовка отображается в верхней части диаграммы и используется в качестве подписи к диаграмме на панели Содержание. |
String |
|
description (Дополнительный) |
Описание диаграммы. Текст диаграммы отображается внизу вида диаграммы. |
String |
|
xTitle (Дополнительный) |
Заголовок оси х диаграммы. |
String |
|
yTitle (Дополнительный) |
Заголовок оси y диаграммы. |
String |
|
dataSource (Дополнительный) |
Источник данных диаграммы. Когда диаграмма экспортируется с использованием метода |
Object |
|
displaySize (Дополнительный) |
Размер диаграммы при экспорте с помощью метода |
List |
|
theme (Дополнительный) |
Задает тему, которая будет применена к диаграмме.
|
String |
Свойства
| Имя | Объяснение | Тип данных |
|---|---|---|
|
aggregation (Чтение / Запись) |
Задает статистический расчет, который будет применяться к значениям, агрегированным в каждом столбце.
|
String |
|
color (Чтение / Запись) |
Цвета, которые будут применены к каждой серии диаграмм. Значение должно представлять собой список шестнадцатеричных значений строки. Если это свойство не задано, цвета серии будут соответствовать цветам условных обозначений, где это применимо; в противном случае будет применена стандартная цветовая палитра. |
List |
|
dataSource (Чтение / Запись) |
Источник данных диаграммы. Когда диаграмма экспортируется с использованием метода |
Object |
|
description (Чтение / Запись) |
Описание диаграммы. Текст диаграммы отображается внизу вида диаграммы. |
String |
|
displaySize (Чтение / Запись) |
Размер диаграммы при экспорте с помощью метода |
List |
|
enableServerSideProcessing (Чтение / Запись) |
Указывает, будет ли использоваться обработка на стороне сервера при поступлении данных из многопользовательской базы данных или облачного хранилища данных.
|
Boolean |
|
legend (Чтение / Запись) |
Свойства легенды диаграммы.
|
Object |
|
miniChartsPerRow (Чтение / Запись) |
Число мини диаграмм, которые будут отображаться в строке. |
Integer |
|
movingAveragePeriod (Чтение / Запись) |
Размер периода скользящего среднего. |
Integer |
|
multiSeriesDisplay (Чтение / Запись) |
Задает тип отображения, который будет использоваться для линейчатой диаграммы с несколькими сериями.
|
String |
|
nullCategoryColor (Чтение / Запись) |
Шестнадцатеричное значение цвета для панели категорий null. |
String |
|
nullCategoryLabel (Чтение / Запись) |
Подпись x-axis для панели категорий null. |
String |
|
rotated (Чтение / Запись) |
Указывает, отображается ли диаграмма вертикально или горизонтально.
|
Boolean |
|
showMovingAverage (Чтение / Запись) |
Задает, будет ли отображена линия скользящего среднего на временной линейчатой диаграмме.
|
Boolean |
|
showNullCategory (Чтение / Запись) |
Указывает, будут ли значения null суммироваться с помощью дополнительной панели.
|
Boolean |
|
showPreviewChart (Чтение / Запись) |
Показывает, будет ли отображаться предварительный просмотр диаграмм в гриде.
|
Boolean |
|
splitCategory (Чтение / Запись) |
Поле второй категории, которое добавляет отдельные серии или столбец для каждого уникального значения в поле. |
String |
|
title (Чтение / Запись) |
Заголовок диаграммы. Текст заголовка появляется в верхней части вида диаграммы и используется как надпись на панели Содержание на вкладке |
String |
|
timeBinningProperties (Чтение / Запись) |
Свойства биннинга времени, которые будут применяться к временным столбчатым диаграммам. Значение должно быть объектом |
Object |
|
type (Только для чтения) |
Строковое значение, обозначающее тип диаграммы. |
String |
|
theme (Чтение / Запись) |
Задает тему, которая будет применена к диаграмме.
|
String |
|
x (Чтение / Запись) |
Имя поля для переменной оси x. Поле должно быть полем категории или даты. Если задана пустая строка, диаграмма будет соответствовать символам слоя. |
String |
|
xAxis (Чтение / Запись) |
Задает свойства оси x.
|
Object |
|
y (Чтение / Запись) |
Имена полей для числовых полей. Для этого свойства необходимо задать одно имя поля или список имен полей. |
String |
|
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
url = r"https://services1.arcgis.com/hLJbHVT9ZrDIzK0I/arcgis/rest/services/CrimesChiTheft/FeatureServer/0"
chart = arcpy.charts.Bar(x="BEAT", aggregation="count", title="Chicago Thefts by Beat", dataSource=url)
chart.exportToSVG('bar.svg', width=800, height=500)