Справка

Graph

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

Класс 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)

Связанные темы

Отзыв по этому разделу?