Древовидная схема (Инструменты Spatial Analyst)

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

Строит древовидную диаграмму, представляющую расстояния между последовательно объединёнными классами в файле эталона.

Более подробно о том, как работает инструмент Древовидная схема

Использование

Входной файл сигнатур должен быть в заданном формате сигнатур. Файл сигнатур можно создать с помощью инструментов Изокластер или Создать сигнатуры. Файл должен содержать, по меньшей мере, два класса. Файл сигнатур можно распознать по расширению .gsg.
Выходной файл древовидной схемы — это текстовый файл ASCII. Файл состоит из двух компонентов: таблицы и диаграммы.

Первый компонент — это таблица расстояний между парами классов, представленная в последовательности слияния. Второй компонент — графическое представление с использованием ASCII-символов классов, демонстрирующее взаимоотношения и иерархию слияния. График показывает относительные расстояния между парами объединённых классов в файле сигнатур, основанные на статистически определённых сходствах. Сами классы представляют собой кластеры клеток или клеток из обучающих образцов, извлечённых на месте исследования.

Анализируя граф и ассоциированную таблицу, можно определить потенциал слияния классов.
По умолчанию расширение для выходного текстового файла — .txt. Это также может быть .asc.
Близость пары классов в файле сигнатур измеряется атрибутивным расстоянием.
Введённое значение ширины линии указывает ширину диаграммы на основе количества символов. Значение по умолчанию 78 также является минимальным допустимым числом символов. Если вводятся числа меньше этого, применяется значение по умолчанию — 78. При задании значений выше стандартного разрешение графика увеличивается, что может обеспечить более точную интерполяцию расстояний.
Чтобы отображение древовидной схемы было информативным, файл ASCII должен отображаться непропорциональным шрифтом, таким как Courier.

Подпись	Объяснение	Тип данных
Входной файл сигнатур	Входной файл сигнатур, чьи сигнатуры классов используются для построения древовидной схемы. Требуется расширение `.gsg`.	File
Выходной файл древовидной схемы	Выходной файл древовидной схемы в формате ASCII. Расширение может быть .txt или .asc.	File
Использовать вероятность при расчете расстояния (Дополнительный)	Задает способ определения расстояний между классами в многомерном пространстве атрибутов. Отмечено–Расстояния между классами вычисляются на основе дисперсий и Евклидового расстояния между средами их сигнатур. Используется по умолчанию. Не отмечено–Расстояния между классами будут определяться только Евклидовыми расстояниями между средними значениями сигнатур классов.	Boolean
Ширина линии древовидной схемы (Дополнительный)	Задаёт ширину древовидной схемы в числе символов на линии. Значение по умолчанию — 78.	Long

Dendrogram(in_signature_file, out_dendrogram_file, {distance_calculation}, {line_width})

Имя	Объяснение	Тип данных
in_signature_file	Входной файл сигнатур, чьи сигнатуры классов используются для построения древовидной схемы. Требуется расширение `.gsg`.	File
out_dendrogram_file	Выходной файл древовидной схемы в формате ASCII. Расширение может быть .txt или .asc.	File
distance_calculation (Дополнительный)	Задает способ определения расстояний между классами в многомерном пространстве атрибутов. `VARIANCE`–Расстояния между классами вычисляются на основе дисперсий и Евклидового расстояния между средами их сигнатур. Используется по умолчанию. `MEAN_ONLY`–Расстояния между классами будут определяться только Евклидовыми расстояниями между средними значениями сигнатур классов.	Boolean
line_width (Дополнительный)	Задаёт ширину древовидной схемы в числе символов на линии. Значение по умолчанию — 78.	Long

Пример кода

Dendrogram пример 1 (окно Python)

В этом примере используется входной файл сигнатур, на основе которого создаётся представление древовидной схемы.

import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
           "c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")

Dendrogram пример 2 (автономный скрипт)

# 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 = ""

# Run Dendrogram
Dendrogram(inSig, outDendro, "VARIANCE", lineLength)

Параметры среды

Текущая рабочая область, Временная рабочая область

Информация о лицензировании