Краткая информация
Класс Graph помогает создавать диаграммы различных типов. Также можно задать общие свойства диаграммы, такие как название, оси диаграммы и легенда.
Описание
Диаграммы представляют информацию о пространственных объектах карты и отношениях между ними визуальным, лёгким для понимания способом. На них можно показать дополнительную информацию о пространственных объектах карты, либо показать эту же информацию иным способом. Диаграммы дополняют карту, упрощая и визуализируя информацию, которую можно просуммировать или извлечь из таблиц. В диаграмме легче быстро сравнить объекты и понять функциональные отношения между объектами, и таким образом визуализировать распределение, тренды и структуру данных, что трудно заметить иным способом.
Свойства
Свойство | Объяснение | Тип данных | ||||||||||||
graphAxis (чтение и запись) | Задает название оси (левой, правой, верхней и нижней) диаграммы.
| Object | ||||||||||||
graphPropsGeneral (чтение и запись) | Задает общие свойства, такие как название, подзаголовок и колонтитул диаграммы.
| Object | ||||||||||||
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.
| String |
addSeriesAreaVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldY | Поле атрибута, которое будет использовано для размещения значения по оси Y диаграммы с областями по вертикали. | Field |
fieldX | Поле атрибута, которое будет использовано для размещения значения по оси X диаграммы с областями по вертикали. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных по вертикальной области диаграммы. | Field |
sortType | Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси X.
| String |
addSeriesBarHorizontal (dataSrc, fieldX, {fieldY}, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldX | Поле атрибута, которое будет использовано для размещения значения по оси X линейчатой диаграммы. | Field |
fieldY | Поле атрибута, которое будет использовано для размещения значения по оси Y линейчатой диаграммы. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных вдоль линеек диаграммы. | Field |
sortType | Укажите, как будут выполняться сортировка значений данных в поле атрибута, используемого для определения оси Y.
| String |
addSeriesBarMinMax (dataSrc, fieldYMax, fieldYMin, {fieldX}, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldYMax | Поле атрибута, которое будет использовано для размещения максимального значения по оси Y статистической диаграммы. | Field |
fieldYMin | Поле атрибута, которое будет использовано для размещения минимального значения по оси Y статистической диаграммы. | Field |
fieldX | Поле атрибута, которое будет использовано для размещения значения по оси X статистической диаграммы. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных вдоль линеек диаграммы. | Field |
sortType | Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси X.
| String |
addSeriesBarVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldY | Поле атрибута, которое будет использовано для размещения значений по оси Y столбчатой диаграммы. | Field |
fieldX | Поле атрибута, которое будет использовано для размещения значений по оси X столбчатой диаграммы. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных вдоль столбцов диаграммы. | Field |
sortType | Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси X.
| String |
addSeriesBoxPlot (dataSrc, fieldValue)
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.
| String |
addSeriesLineVertical (dataSrc, fieldY, {fieldX}, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldY | Поле атрибута, которое будет использовано для размещения значения по оси Y вертикального графика. | Field |
fieldX | Поле атрибута, которое будет использовано для размещения значения по оси X вертикального графика. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей для точек со значениями данных вдоль вертикальной линии диаграммы. | Field |
sortType | Укажите, как будет выполняться сортировка значений данных в поле атрибута, используемого для определения оси X.
| String |
addSeriesPie (dataSrc, fieldValue, fieldSort, {fieldLabel}, {sortType})
Параметр | Объяснение | Тип данных |
dataSrc | Слой или таблица, содержащие значения данных, которые будут использованы для создания диаграммы. | Layer |
fieldValue | Поле атрибута, которое будет использовано для размещения значений или клиньев на круговой диаграмме. | Field |
fieldSort | Поле атрибута, которое будет использовано для сортировки клиньев по возрастанию или убыванию. | Field |
fieldLabel | Поле атрибута, которое будет использовано для размещения подписей на круговой диаграмме. | Field |
sortType | Укажите, как будут выполняться сортировка значений данных в поле атрибута, используемого для сортировки.
| 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)