Древовидная схема (Dendrogram) (Spatial Analyst)
Резюме
Строит древовидную диаграмму, представляющую расстояния между последовательно объединёнными классами в файле эталона.
Более подробно о том, как работает инструмент Древовидная схема
Использование
-
Входной файл сигнатур должен быть в установленном формате файла сигнатур. Файл сигнатур может быть создан с помощью инструментов Изокластер или Создать сигнатуры. Файл должен содержать, по меньшей мере, два класса. Файл сигнатур имеет расширение .gsg.
-
Выходными данными инструмента Древовидная схема служит текстовой ASCII-файл. Файл состоит из двух частей: таблицы и диаграммы.
Первый компонент — это таблица расстояний между парами классов, представленных в последовательности для объединения. Второй компонент - это графическое представление с помощью символов ASCII классов, показывающее отношения между классами и иерархию объединения. Схема иллюстрирует относительные расстояния между парами объединяемых классов в файле сигнатур, которые основываются на статистически определяемом сходстве. Классы представляют собой кластеры ячеек или ячейки из обучающих эталонов, получаемых путем оцифровки участков на изучаемой территории.
Проанализировав схему и связанную с ней таблицу, вы можете определить потенциал объединения классов.
-
Используемое по умолчанию расширение выходного текстового файла ― .txt. Также может использоваться расширение .asc.
-
Близость пары классов в файле сигнатур измеряется атрибутивным расстоянием.
-
Значение, вводимое для ширины линии определяет ширину схемы, основанную на числе символов. Используемое по умолчанию значение, равное 78, представляет собой минимальное действительное число символов. Если вводятся числа, меньшие 78, будет применено предлагаемое по умолчанию значение (78). При определении значений выше, чем предлагаемое по умолчанию, разрешение схемы будет увеличиваться, что может привести к более точной интерполяции расстояний.
-
Чтобы сделать отображение древовидной схемы значимым, ASCII-файл должен быть показан с применением непропорционального шрифта, например, Courier.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_signature_file |
Входной файл сигнатур, сигнатуры классов которого используются для построения древовидной схемы. Требуется расширение .gsg. | File |
out_dendrogram_file |
Выходной ASCII-файл древовидной схемы. Расширение может быть .txt или .asc. | File |
distance_calculation (дополнительно) |
Задает способ определения расстояний между классами в многомерном атрибутивном пространстве.
| Boolean |
line_width (дополнительно) |
Задает ширину древовидной схемы в количестве символов на линии. Значение по умолчанию равно 78. | Long |
Пример кода
В этом примере из входного файла сигнатур создается вид Древовидная схема (Dendrogram).
import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")
В этом примере из входного файла сигнатур создается вид Древовидная схема (Dendrogram).
# Name: Dendrogram_Ex_02.py
# Description: Constructs a tree diagram showing attribute distances between
# sequentially merged classes in a signature file.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set local variables
inSig = "c:/sapyexamples/data/zsamp12.gsg"
outDendro = "c:/sapyexamples/output/z12dend.txt"
lineLength = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Dendrogram
Dendrogram(inSig, outDendro, "VARIANCE", lineLength)