Graph (arcpy)

Краткая информация

Класс 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	Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы.	Layer
fieldX	Поле атрибута, которое будет использовано для размещения значения по оси X диаграммы с областями по горизонтали.	Field
fieldY	Поле атрибута, которое будет использовано для размещения значения по оси Y диаграммы с областями по горизонтали.	Field
fieldLabel	Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных вдоль горизонтальной области диаграммы.	Field
sortType	Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси Y. VALUE —Сортировка значений данных на основе порядка значений во входном слое или таблице. Это значение используется по умолчанию. ASC —Сортировка значений данных в порядке возрастания (от наименьшего к наибольшему). DESC —Сортировка значений данных в порядке убывания (от наибольшего к наименьшему).	String

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

Параметр	Объяснение	Тип данных
dataSrc	Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы.	Layer
fieldY	Поле атрибута, которое будет использовано для размещения значения по оси Y диаграммы с областями по вертикали.	Field
fieldX	Поле атрибута, которое будет использовано для размещения значения по оси X диаграммы с областями по вертикали.	Field
fieldLabel	Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных по вертикальной области диаграммы.	Field
sortType	Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси X. VALUE —Сортировка значений данных на основе порядка значений во входном слое или таблице. Это значение используется по умолчанию. ASC —Сортировка значений данных в порядке возрастания (от наименьшего к наибольшему). DESC —Сортировка значений данных в порядке убывания (от наибольшего к наименьшему).	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	Поле атрибута, которое будет использовано для размещения значения по оси X статистической диаграммы.	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)