Краткая информация
Класс Bar создает линейчатые диаграммы. Линейчатая диаграмма суммирует и сравнивает категории данных, используя длину линейки для отображения данных.
Более подробно об использовании линейчатых диаграмм в ArcGIS AllSource.
Обсуждение
При создании этого объекта дополнительные аргументы конструктора классов должны указываться с помощью имени аргумента; их нельзя указывать позицией аргумента. См. раздел с примерами кодов, содержащий пример того, как можно задавать аргументы, используя ключевые слова.
Синтаксис
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 | Свойства биннинга времени, применяемые к временным диаграммам. Ожидает объект TimeBinningProperties. | Object |
rotated | Указывает, будут ли диаграммы отображаться вертикально или горизонтально.
(Значение по умолчанию — False) | Boolean |
title |
Заголовок диаграммы. Текст заголовка отображается в верхней части диаграммы и используется в качестве подписи к диаграмме на панели Содержание. | String |
description | Описание диаграммы. Текст диаграммы отображается внизу вида диаграммы. | String |
xTitle | Заголовок оси х диаграммы. | String |
yTitle | Заголовок оси y диаграммы. | String |
dataSource | Источник данных диаграммы. Когда диаграмма экспортируется с использованием метода exportToSVG или отображается в ArcGIS Notebooks , источник данных считывается и отображается на диаграмме. К допустимым источникам данных относятся следующие: | Object |
displaySize [displaySize,...] | Размер диаграммы при экспорте с помощью метода exportToSVG или при отображении в ArcGIS Notebooks. Значение должно быть указано как список из двух элементов, в котором первый элемент является шириной диаграммы, а второй - высотой. | List |
theme | Задает тему, которая будет применена к диаграмме.
| String |
Свойства
Свойство | Описание | Тип данных |
aggregation (чтение и запись) | Задает статистический расчет, который будет применяться к значениям, агрегированным в каждом столбце.
| String |
MISSING_PROPNAME (чтение и запись) | List | |
dataSource (чтение и запись) | Источник данных диаграммы. Когда диаграмма экспортируется с использованием метода exportToSVG или отображается в ArcGIS Notebook, источник данных считывается и отображается на диаграмме. К допустимым источникам данных относятся следующие: | Object |
description (чтение и запись) | Описание диаграммы. Текст диаграммы отображается внизу вида диаграммы. | String |
displaySize (чтение и запись) | Размер диаграммы при экспорте с помощью метода exportToSVG или при отображении в ArcGIS Notebook. Значение должно быть указано как список из двух элементов, в котором первый элемент является шириной диаграммы, а второй - высотой. | List |
MISSING_PROPNAME (чтение и запись) | Boolean | |
legend (чтение и запись) | Свойства легенды диаграммы.
| Object |
miniChartsPerRow (чтение и запись) | Число минидиаграмм, которые будут отображаться в строке. Число строк будет определяться количеством серий, деленным на значение 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 (чтение и запись) | Свойства биннинга времени, которые будут применяться к временным столбчатым диаграммам. Значение должно быть объектом TimeBinningProperties. | Object |
type (только чтение) | Строковое значение, обозначающее тип диаграммы. | String |
theme (чтение и запись) | Имя темы, которая будет применена к диаграмме. | String |
x (чтение и запись) | Имя поля для переменной оси x. Поле должно быть полем категории или даты. Если задана пустая строка, диаграмма будет соответствовать символам слоя. | String |
xAxis (чтение и запись) | Задает свойства оси x.
| Object |
y (чтение и запись) | Имена полей для числовых полей. Для этого свойства необходимо задать одно имя поля или список имен полей. | String |
yAxis (чтение и запись) | Задает свойства оси Y.
| Object |
Обзор метода
Метод | Описание |
addToLayer (layer_or_layerfile) | Метод addToLayer добавляет объект диаграммы в представление слоя или таблицы. |
exportToSVG (path, width, height) | Метод exportToSVG экспортирует диаграмму в формат SVG. |
updateChart () | Метод updateChart обновляет свойства диаграммы для синхронизации изменений между объектом и диаграммой, предварительно добавленной к слою. |
Методы
addToLayer (layer_or_layerfile)
Параметр | Описание | Тип данных |
layer_or_layerfile | The chart will be added to the target object. This argument can be a Layer or Table object. | Object |
Добавление объекта диаграммы в слой или таблицу с использованием метода addToLayer часто является последним шагом после определения свойств диаграммы.
Добавьте диаграмму к существующему слою.
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)
exportToSVG (path, width, height)
Параметр | Описание | Тип данных |
path | The path where the chart will be exported in SVG format. | String |
width | The width of the output graphic. | Integer |
height | The height of the output graphic. | Integer |
В некоторых случаях вам может понадобиться сохранить диаграмму в графический формат, который можно совместно использовать и просматривать вне ArcGIS AllSource. Преимуществом экспорта в формат SVG является то, что графические элементы и текст сохраняются, как векторные объекты, каждый из которых можно изменять в программе, работающей с векторной графикой. Размер графики SVG также можно изменить на любой другой без потери качества.
Экспортируйте диаграмму, содержащую источник данных слоя проекта в файл .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)
Экспортируйте диаграмму, содержащую источник данных сервиса объектов в файл .svg.
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.exportToSVG('theftsPerBeat.svg', 800, 600)
updateChart ()
Добавление объекта диаграммы в слой с использованием метода addToLayer часто является последним шагом после определения свойств диаграммы.
Вы также можете изменить свойства исходной диаграммы вместо создания новой Затем можно использовать метод 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)