Краткая информация
Диаграммы хронометража данных визуально суммируют временные данные в двух измерениях, чтобы выявить сезонные или циклические закономерности и временные тренды.
Более подробно о диаграммах хронометража данных в ArcGIS Pro
Обсуждение
При создании объекта диаграммы необязательные аргументы для конструктора классов должны указываться с помощью имени аргумента; их нельзя указывать по позиции аргумента. См. раздел с примерами кодов, содержащий пример того, как можно задавать аргументы, используя ключевые слова.
Синтаксис
DataClock (dateField, {numberField}, {timeUnitsRingWedge}, {aggregation}, {nullPolicy}, {classificationMethod}, {classCount}, {title}, {description}, {dataSource}, {displaySize})
Параметр | Описание | Тип данных |
dateField | The name of the date field that is used to create the chart. | String |
numberField | The name of the field that is aggregated and used to determine the color of the chart cells. | String |
timeUnitsRingWedge | Specifies the time-unit pair that is supported in the data clock chart.
| String |
aggregation | Задает статистический расчет, применяемый к значениям, агрегированным в каждой ячейке.
| String |
nullPolicy | Определяет, как отображаются суммированные ячейки, возвращающие значение null.
| String |
classificationMethod | Задает метод классификации, используемый для визуализации цвета ячейки и классификации данных.
| String |
classCount | The number of classes used in the classification method. | Integer |
title |
The title of the chart. The title text appears at the top of the chart view and is used as the label for the chart in the Contents pane. | String |
description | The description of the chart. The description text appears at the bottom of the chart view. | String |
dataSource | The data source of the chart. When a chart is exported using the exportToSVG method or displayed in an ArcGIS Notebook, the data source will be read and rendered on the chart. Valid data sources include the following:
| Object |
displaySize [displaySize,...] | The size of the chart when exported using the exportToSVG method or displayed in an ArcGIS Notebook. The value must be specified as a two-item list in which the first item is the width of the chart and the second item is the height of the chart. | List |
Свойства
Свойство | Описание | Тип данных |
aggregation (чтение и запись) | Задает статистический расчет, применяемый к значениям, агрегированным в каждой ячейке.
| String |
classCount (чтение и запись) | Число классов, используемых в методе классификации. | Integer |
classificationMethod (чтение и запись) | Задает метод классификации, используемый для визуализации цвета ячейки и классификации данных.
| String |
dataSource (чтение и запись) | Источник данных диаграммы. Когда диаграмма экспортируется с использованием метода exportToSVG или отображается в ArcGIS Notebook, источник данных считывается и отображается на диаграмме. К допустимым источникам данных относятся следующие:
| Object |
dateField (чтение и запись) | Имя поля даты, которое используется для создания диаграммы. | String |
description (чтение и запись) | Описание диаграммы. Текст диаграммы отображается внизу вида диаграммы. | String |
displaySize (чтение и запись) | Размер диаграммы при экспорте с помощью метода exportToSVG или при отображении в ArcGIS Notebook. Значение должно быть указано как список из двух элементов, в котором первый элемент является шириной диаграммы, а второй - высотой. | List |
legend (чтение и запись) | Свойства легенды диаграммы.
| Object |
nullPolicy (чтение и запись) | Определяет, как отображаются суммированные ячейки, возвращающие значение null.
| String |
numberField (чтение и запись) | Имя поля, которое агрегируется и используется для определения цвета ячеек диаграммы. | String |
theme (чтение и запись) | Задает имя темы, применяемой к диаграмме. | String |
timeUnitsRingWedge (чтение и запись) | Задает пару единиц измерения времени, которые поддерживаются в диаграмме хронометража данных.
| String |
title (чтение и запись) | Заголовок диаграммы. Текст заголовка появляется в верхней части вида диаграммы и используется как надпись на панели Содержание на вкладке Содержание на вкладке По отображению. | String |
type (только чтение) | Строковое значение, обозначающее тип диаграммы. | String |
Обзор метода
Метод | Описание |
addToLayer (layer_or_layerfile) | Добавление объекта диаграммы в слой или в автономную таблицу. |
exportToSVG (path, width, height) | Экспортирует диаграмму в формат SVG. |
updateChart () | Обновляет свойства диаграммы для синхронизации изменений между объектом и диаграммой, предварительно добавленной к слою. |
Методы
addToLayer (layer_or_layerfile)
Параметр | Описание | Тип данных |
layer_or_layerfile | The chart will be added to the target object. The layer_or_layerfile argument can be a Layer or a Table object. | Object |
Обычно последним шагом после задания свойств диаграммы является добавление объекта диаграммы в слой или в таблицу, с помощью метода addToLayer.
Добавьте диаграмму к существующему слою.
import arcpy
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 Pro. Преимуществом экспорта в формат SVG является то, что графические элементы и текст сохраняются, как векторные объекты, каждый из которых можно изменять в программе, работающей с векторной графикой. Размер графики SVG также можно изменить на любой другой без потери качества.
Экспортируйте диаграмму, содержащую источник данных слоя проекта в файл .svg.
import arcpy
aprx = arcpy.mp.ArcGISProject('current')
censusLayer = aprx.listMaps()[0].listLayers('Census Block Groups')[0]
# Set data source of chart object to a layer within current project
chart.dataSource = censusLayer
# Save the chart to file with dimensions width=500, height=500
chart.exportToSVG('populationByState.svg', 500, 500)
Экспортируйте диаграмму, содержащую источник данных сервиса объектов в файл .svg.
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 для синхронизации изменений свойств диаграммы в слое.
chart.addToLayer(myLayer)
# Further modification is necessary
chart.description = "Data from the U.S. Census Bureau"
chart.updateChart()
Пример кода
Создайте диаграмму хронометража данных на основе слоя текущего проекта и экспортируйте диаграмму в файл .svg.
import arcpy
lyr = arcpy.mp.ArcGISProject("current").listMaps()[0].listLayers("car_accidents")[0]
chart = arcpy.charts.DataClock(dateField="Date", aggregation="count",
timeUnitsRingWedge="WEEKS_DAYS", dataSource=lyr)
chart.exportToSVG("data_clock.svg", width=750, height=500)