| Подпись | Описание | Тип данных |
Входные точечные объекты | Точечные объекты, представляющие местоположения, где присутствие интересующего явления известно. | Feature Layer |
Содержит точки фона (Дополнительный) | Указывает, содержат ли входные точечные объекты точки фона. Если входные точечные объекты не содержат точки фона, инструмент создаст точки фона, используя ячейки независимых обучающих растров. Инструмент использует точки фона для моделирования характеристик ландшафта в неизвестных местоположениях и сравнения их с характеристиками ландшафта в известных местоположениях. То есть точки фона определяют область изучения. В общем, это местоположения, где присутствие интересующего явления известно. Тем не менее, если какая-либо информация о точках фона известна, можно использовать параметр Относительный вес присутствия к фону для указания этой информации.
| Boolean |
Поле индикатора присутствия (Дополнительный) | Поле входных точечных объектов, содержащие бинарные значения, указывающие, является ли точка присутствием (1) или фоном (0). Поле Y должно быть числовым. | Field |
Независимые переменные обучения (Дополнительный) | Список полей, представляющих независимые переменные, которые помогут прогнозировать вероятность присутствия. Вы можете указать, является ли переменная категорийной или числовой. Включите опцию Категорийная для любых переменных, которые представляют классы или категории. | Value Table |
Независимые объекты расстояния обучения (Дополнительный) | Список векторных слоев или классов объектов, которые используются для автоматического создания независимых переменных, представляя расстояние от входных точечных объектов до ближайших объектов расстояния. Если входные независимые обучающие объекты расстояния являются полигонами или линиями, атрибуты расстояния вычисляются как расстояние между ближайшими сегментом и точкой. | Feature Layer |
Независимые обучающие растры (Дополнительный) | Список растров, которые будут использованы для автоматического создания в модели независимых обучающих переменных, значения которых извлекаются из растров. Для каждого объекта (точек присутствия или фона) во входных точечных объектах значение ячейки растра извлекается в именно в этом местоположении. Билинейный пересчет растра используется, если значение растра извлекается из непрерывных растров. Метод ближайшего соседа используется, если значение растра извлекается из категориальных растров. Вы можете указать, является ли значение растра категорийным или числовым. Включите опцию Категорийная для каждого растра, который представляют классы или категории (например почвенно-растительный покров). | Value Table |
Расширения независимой переменной (базисные функции) (Дополнительный) | Указывает базисную функцию, которая будет использована для преобразования указанных независимых переменных, используемых в модели. Если выбрано несколько базисных функций, инструмент попытается выполнить преобразование нескольких переменных для использования их в модели.
| String |
Число узлов (Дополнительный) | Число узлов, которое будет использовано расширениями независимой переменной Петля или Порог Значение определяет количество создаваемых пороговых значений, которые используются для создания нескольких расширений независимых переменных с использованием каждого порога. Значение должно быть в диапазоне от 2 до 50. Значение по умолчанию равно 10. | Long |
Область изучения (Дополнительный) | Указывает тип области изучения, который будет использован для определения, где присутствие возможно, если входные точечные объекты не содержат точки фона.
| String |
Полигон изучаемой области (Дополнительный) | Класс объектов, содержащий полигоны, которые определяют пользовательскую изучаемую область. Входные точечные объекты должны быть расположены в пределах пользовательской изучаемой области, покрываемой полигональными объектами. Изучаемая область состоит из нескольких полигонов. | Feature Layer |
Применить пространственное прореживание (Дополнительный) | Устанавливает, будет ли пространственное прореживание применено к точкам присутствия и фона перед обучением модели. Пространственное прореживание помогает снизить смещение выборки путем удаления точек и проверки того, что оставшиеся точки содержат минимальное расстояние ближайшего соседства, установленное в параметре Минимум ближайших соседей. Пространственное прореживание также применяется к точкам фона, независимо от того, указываются ли они как входные точечные объекты, или создаются инструментом.
| Boolean |
Минимальное расстояние ближайшего соседства (Дополнительный) | Минимальное расстояние между двумя любыми точками присутствия или фона, если применено пространственное прореживание. | Linear Unit |
Число итераций прореживания (Дополнительный) | Число запусков, которое будетиспользовано для поиска оптимального решения пространственного прореживания, возвращаясь к началу с настолько минимальным количеством точек присутствия и фона, насколько возможно, пока не будет достигнуто состояние, при котором в пределах Минимального расстояния ближайшего соседства не будет двух точек присутствия или двух точек фона. Минимально возможное число итераций - 1, а максимально - 50. Значение по умолчанию равно 10. Этот параметр применяется только для пространственного прореживания, используемого для точек присутствия и фона во входных точечных объектах. Пространственное прореживание, применяемое к точкам фона, созданным из ячеек растра, к которым применено пространственное прореживание путем пересчета ячеек растра в указанное значение параметра Минимальное ближайшее расстояние без необходимости повторения для оптимального решения. | Long |
Относительный вес присутствия к фону (Дополнительный) | Значение от 1 до 100, которое указывает относительный вес информации о точке присутствия к точке фона. По умолчанию используется 100. Более высокое значение указывает на то, что точки присутствия являются главным источником информации; неизвестно, представляют ли точки фона присутствие или отсутствие, и точки фона получают меньший вес в модели. Более низкое значение указывает на то, что точки фона также дополняют информацию, которая может использоваться в комбинации с информацией о точках присутствия; есть высокая вероятность, что точки фона представляют отсутствие, и эта информация может использовать в модели для указания местоположений отсутствия. | Long |
Преобразование вероятности присутствия (функция связи) (Дополнительный) | Определяет функцию, которая преобразует неограниченные выходные данные модели в число от 0 до 1. Значение можно интерпретировать как вероятность присутствия в местоположении. Каждая опция конвертирует одно и то же непрерывное значение в разную вероятность.
| String |
Предельное значение вероятности присутствия (Дополнительный) | Предельное значение между 0.01 и 0.99, которое определяет, какие вероятности соответствуют присутствию в результирующей классификации. Предельное значение используется для оценки производительности модели с помощью обучающих данных и известных точек присутствия. Диагностики классификации доступны из сообщений геообработки и в выходных обученных объектах. | Double |
Выходные обученные объекты (Дополнительный) | Выходной класс объектов, который будет содержать все объекты и независимые переменные, используемые в обучении модели. | Feature Class |
Выходной обученный растр (Дополнительный) | Выходной растр со значениями ячеек, указывающими на вероятность присутствия, вычисленную с помощью выбранной функцией связи. По умолчанию в качестве размера ячейки используется максимальный размер ячеек входных независимых обучающих растров. Выходной обученный растр создается только если входные точечные объекты не содержат точки фона. | Raster Dataset |
Выходная таблица кривой ответов (Дополнительный) | Выходная таблица, которая будет содержать диагностики обучающей модели, отражающие вклад каждой независимой переменной в вероятность присутствия после учета усредненных эффектов всех независимых переменных в модели. К таблице могут быть добавлены до двух диаграмм частичной зависимости: набор линейных графиков для непрерывных переменных, и набор столбчатых диаграмм для категорийных переменных. | Table |
Выходная таблица чувствительности (Дополнительный) | Выходная таблица, которая будет содержать диагностики точности обучающей модели, выраженные через предельное значение вероятности присутствия, меняющееся от 0 до 1. | Table |
Входные объекты прогнозирования (Дополнительный) | Класс объектов, представляющих местоположения, где будет выполняться прогнозирование. Этот класс объектов должен содержать любые независимые переменные, представленные в виде полей, входных точечных объектов. При применении пространственного прореживания вы можете использовать исходные входные точечные объекты как входные объекты прогнозирования для вычисления прогнозов по всему набору данных. | Feature Layer |
Выходные объекты прогнозирования (Дополнительный) | Выходной класс объектов, который будет содержать результаты модели прогнозирования, примененные к входным объектам прогнозирования. | Feature Class |
Выходной растр прогнозирования (Дополнительный) | Выходной растр, содержащий результаты прогнозирования в каждой ячейке сопоставленных независимых растров. По умолчанию в качестве размера ячейки используется максимальный размер ячеек входных независимых обучающих растров. | Raster Dataset |
Сопоставление независимых переменных (Дополнительный) | Сопоставление полей независимой переменной входных точечных объектов и входных объектов прогнозирования. | Value Table |
Сопоставление объектов расстояния (Дополнительный) |
Сопоставление объектов расстояния для обучения и прогнозирования. | Value Table |
Сопоставление независимых растров (Дополнительный) | Сопоставление растров для обучения и прогнозирования. | Value Table |
Разрешить прогнозирование вне диапазонов данных (Дополнительный) | Определяет, будет ли прогнозирование допускать экстраполяцию, если значения независимой переменной находятся за пределами диапазона значений, используемых для обучения.
| Boolean |
Схема пересчета (Дополнительный) | Определяет метод, который будет использован для выполннения перекрестной проверки модели прогнозирования. Перекрестная проверка исключает фрагмент данных в процессе обучения модели и использует их для проверки производительности модели после обучения.
| String |
Число групп (Дополнительный) | Число групп, которое будет использовано в перекрестной проверке для произвольной схемы пересчета. Поле выходных обученных объектов, указывающее группу, которая назначена каждой точке. Значение по умолчанию равно 3. Допускается минимум 2, и максимум 10 групп. | Long |
Выходной файл обученной модели. (Дополнительный) | Файл выходной модели, в котором будет сохранена обученная модель, которую позже можно будет использовать для прогнозирования. | File |
Краткая информация
Моделирует присутствие явления на основании известных местоположений присутствия и независимых переменных, используя подход максимальной энтропии (MaxEnt) Инструмент создает выходные объекты и растры, которые включают вероятность присутствия, и он применяется к тем задачам, где присутствие явления известно, а отсутствие неизвестно.
Более подробно о том, как работает Прогнозирование только присутствия (MaxEnt)
Иллюстрация
Использование
Инструмент работает с тремя основными входными элементами для создания модели прогнозирования присутствия: известные местоположения присутствия, область изучения, где присутствие возможно, и независимые переменные.
- Параметр Входные точечные объекты используется для определения известных местоположений присутствия изучаемого явления.
- Область изучения характеризуется точками фона. Точки фона - это местоположения, распределенные по изучаемой области, где присутствие интересующего явления возможно, но неизвестно. Они могут создаваться инструментом автоматически, или вручную добавляться во входные точечные объекты включением параметра Содержит точки фона.
- Инструмент использует независимые переменные в виде растров, полей или объектов расстояния.
Инструмент можно запустить с одной из двух моделей, которые определяются параметром Содержит точки фона:
- Не отмечено - инструмент будет запущен в режиме только точки присутствия и будет использовать в качестве независимых переменных только растры.
- Отмечено - инструмент будет запущен с использованием точек присутствия и фона, и допускает такие источники независимых переменных, как растры, поля и объекты расстояния.
Для использования растров в качестве входных данных или выходных данных инструмента требуется лицензия ArcGIS Spatial Analyst extension.
Параметр Выходной файл обученной модели можно использовать для сохранения результатов обученной модели в виде файла многократного использования. Инструмент Прогнозировать, используя файл модели пространственной статистики можно использовать для прогнозирования новых объектов с использованием файла модели.
Для выполнения инструмента и построения модели необходимо, как минимум, две точки присутствия. Если входные объекты содержат точки фона, инструменту также необходимо, как минимум, две точки фона для построения модели.
Параметр Независимые обучающие объекты расстояния не активен, если параметр Содержит точки фона не отмечен. Для добавления расстояний до объектов в качестве независимых переменных для данных только присутствия, можно вычислить растры расстояния с помощью инструментов Накопление расстояния, и включите их в параметр Независимые обучающие растры.
Пространственное разрешение Независимых обучающих растров важно по следующим причинам:
- Размер ячейки имеет существенное влияние на время обработки. Чем выше разрешение растра, тем больше время обработки.
- Инструмент будет использовать центроиды ячеек растра для создания точек фона если параметр Содержит точки фона не отмечен. Соотношение точек фона к точкам присутствия влияет на модель; рекомендуется учитывать размер ячейки растровых данных и анализировать результирующие точки фона, с использованием параметра Выходные обученные объекты, чтобы убедиться, что ваши предположения по области изучения соответствуют вопросу.
Примечание:
Для понижения пространственного разрешения независимых обучающих растров можно использовать инструмент Изменить разрешение.
Заданная изучаемая область, либо с помощью параметра Изучаемая область, либо на основании местоположений входных точечных объектов, которые включают точки фона, влияет на результат модели. Указанный экстент определяет, какие ячейки растра будут использованы в качестве точек фона. Это определяет условия среды, которые сравниваются с условиями присутствия, и, таким образом, устанавливается относительная частота встречаемости, влияющая на результаты прогнозирования.
Используйте параметр Относительный вес присутствия к фону для определения значимости точек фона. Используйте значение 100, если точки фона представляют местоположения с неизвестным присутствием. Используйте значение 1, если точки фона представляют местоположения с наблюдаемым отсутствием.
- Значение влияет на обработку модели, и на результирующие прогнозирования. Если значение близко к 100, модель определяет каждую неверно классифицированную точку присутствия в 100 раз больше, чем каждую неверно классифицированную точку фона (предполагая, что верная классификация точки фона - отсутствие), и применяется традиционный подход MaxEnt. Если значение равно 1, модель определяет каждую точку присутствия и фона одинаково, и процесс подобен логистической регрессии.
- Значение 1 следует использовать с осторожностью в режиме только присутствия (параметр Содержит точки фона отключен), так как инструмент создает точки фона, которые интерпретируются как отсутствие, и им присваивается равный вес с точками присутствия.
Смещение выборки присуще большинству данных присутствия и влияет на результаты анализа. Чтобы снизить этот эффект, вы можете использовать параметр Пространственное прореживание. Но, хотя пространственное прореживание является действенным способом устранения влияния смещения выборки, рекомендуется использовать данные структурированных обследований для минимизации последствий смещения выборки.
Диагностики классификации доступны из сообщений геообработки и в диаграмме Процент результатов классификации, которая есть в результирующем слое, указанном в параметре Выходные обученные объекты. Диаграмма показывает результат сравнения наблюдаемой и прогнозируемой классификаций, и может быть использована для оценки способности модели в производительности прогнозирования известных точек присутствия. Например, вы можете оценить пригодность модели для прогнозирования присутствия, в частности, частей неверно классифицированных точек присутствия в обучающих входных точечных объектах. В случае, если важно прогнозирование присутствия точек фона, диаграмму также можно использовать для просмотра и выбора точек фона, которые прогнозируются как точки присутствия.
Инструмент можно использовать двумя способами. Вы можете сфокусироваться на обучении и оценке моделей-кандидатов, или на прогнозировании возможности присутствия в новом наборе данных.
- Обучение и оценка моделей-кандидатов — запустите инструмент без оказания опций для анализа диагностик модели, включенных в сообщения геообработки. Если результаты диагностики выглядят подходящими, укажите Выходные обученные объекты и используйте диаграмму диагностик классификаций для будущей оценки производительности прогнозирования в обучающих данных. Диаграммы, включенные в Выходную таблицу чувствительности и Выходную таблицу кривой ответов, являются метриками диагностики для обучающих данных и их также можно использовать для настройки и поиска подходящей модели.
- Прогнозирование — укажите параметры в Результатах прогнозирования для применения модели к новым местоположениям, не являющимся частью обучающих данных. Параметры Входные объекты прогнозирования и результирующие Выходные объекты прогнозирования представляют новые точечные местоположения, в которых требуется прогнозирование. В дополнение к точечным объектам можно создать поверхность прогнозирования, указав параметр Выходной растр прогнозирования. Объекты прогнозирование и растры прогнозирования должны использоваться в комплексе, с совпадающими независимыми переменными, в той же форме, которая применялась в обучающих данных (растрах, полях и объектах расстояний).
Пространственное прореживание может привести к тому, что в обучающих данных будут не все входные точечные объекты. Чтобы протестировать производительность модели по всем точкам, если применялось пространственное прореживание, укажите одинаковый класс объектов для Входных точечных объектов и Входных объектов прогнозирования.
Инструмент определяет систему координат выходных наборов данных, поддерживая систему координат набора классов объектов, указанного в выходном пути. Или инструмент будет использовать систему координат, указанную в параметре среды Выходная система координат. Если вы не указали набор классов объектов или параметр среды, инструмент использует следующий подход для каждого выходного набора:
- Для Выходных обучающих объектов и Выходных обучающих растров инструмент будет использовать систему координат из Входных точечных объектов.
- Для Выходных объектов прогнозирования инструмент будет использовать систему координат из Входных объектов прогнозирования.
- Для Выходные растров прогнозирования инструмент будет использовать систему координат из Входных объектов прогнозирования. Если Выходные объекты прогнозирования не указаны, инструмент будет использовать систему координат первого растра, указанного в параметре Сопоставление независимых растров.
Для параметра Расширения объясняющей переменной (Базисные функции) есть ограничения. Опции Сглаженный шаг (Петля) и Дискретный шаг (Порог) взаимоисключающие - если выбрана одна, вторая не может быть указана. Если независимая переменная указана как Категорийная, может использоваться только опция Исходный (Линейный).
Если параметр Схема пересчета установлен на Произвольный, инструмент будет группировать данные и проверять производительность модели на поднаборе группированных данных. Для каждой обучающей группы соблюдаются те же требования, что и для основной модели - необходимо, как минимум, две точки присутствия и две точки фона. Если требования не соблюдены после 10 попыток, инструмент прекратит выполнять перекрестную проверку и выдаст предупреждение, что перекрестная проверка невозможна.
Параметры
arcpy.stats.PresenceOnlyPrediction(input_point_features, {contains_background}, {presence_indicator_field}, {explanatory_variables}, {distance_features}, {explanatory_rasters}, {basis_expansion_functions}, {number_knots}, {study_area_type}, {study_area_polygon}, {spatial_thinning}, {thinning_distance_band}, {number_of_iterations}, {relative_weight}, {link_function}, {presence_probability_cutoff}, {output_trained_features}, {output_trained_raster}, {output_response_curve_table}, {output_sensitivity_table}, {features_to_predict}, {output_pred_features}, {output_pred_raster}, {explanatory_variable_matching}, {explanatory_distance_matching}, {explanatory_rasters_matching}, {allow_predictions_outside_of_data_ranges}, {resampling_scheme}, {number_of_groups}, {output_trained_model})| Имя | Описание | Тип данных |
input_point_features | Точечные объекты, представляющие местоположения, где присутствие интересующего явления известно. | Feature Layer |
contains_background (Дополнительный) | Указывает, содержат ли входные точечные объекты точки фона. Если входные точечные объекты не содержат точки фона, инструмент создаст точки фона, используя ячейки независимых обучающих растров. Инструмент использует точки фона для моделирования характеристик ландшафта в неизвестных местоположениях и сравнения их с характеристиками ландшафта в известных местоположениях. То есть точки фона определяют область изучения. В общем, это местоположения, где присутствие интересующего явления известно. Тем не менее, если какая-либо информация о точках фона известна, можно использовать параметр relative_weight для указания этой информации.
| Boolean |
presence_indicator_field (Дополнительный) | Поле входных точечных объектов, содержащие бинарные значения, указывающие, является ли точка присутствием (1) или фоном (0). Поле Y должно быть числовым. | Field |
explanatory_variables [[Variable, Categorical],...] (Дополнительный) | Список полей, представляющих независимые переменные, которые помогут прогнозировать вероятность присутствия. Вы можете указать, является ли переменная категорийной или числовой. Включите опцию CATEGORICAL для любых переменных, которые представляют классы или категории (например, почвенно-растительный покров). | Value Table |
distance_features [distance_features,...] (Дополнительный) | Список векторных слоев или классов объектов, которые используются для автоматического создания независимых переменных, представляя расстояние от входных точечных объектов до ближайших объектов расстояния. Если входные независимые обучающие объекты расстояния являются полигонами или линиями, атрибуты расстояния вычисляются как расстояние между ближайшими сегментом и точкой. | Feature Layer |
explanatory_rasters [[Variable, Categorical],...] (Дополнительный) | Список растров, которые будут использованы для автоматического создания в модели независимых обучающих переменных, значения которых извлекаются из растров. Для каждого объекта (точек присутствия или фона) во входных точечных объектах значение ячейки растра извлекается в именно в этом местоположении. Билинейный пересчет растра используется, если значение растра извлекается из непрерывных растров. Метод ближайшего соседа используется, если значение растра извлекается из категориальных растров. Вы можете указать, является ли значение растра категорийным или числовым. Включите опцию CATEGORICAL для любых растров, которые представляют классы или категории (например, почвенно-растительный покров). | Value Table |
basis_expansion_functions [basis_expansion_functions,...] (Дополнительный) | Указывает базисную функцию, которая будет использована для преобразования указанных независимых переменных, используемых в модели. Если выбрано несколько базисных функций, инструмент попытается выполнить преобразование нескольких переменных для использования их в модели.
| String |
number_knots (Дополнительный) | Число узлов, которое будет использовано расширениями независимой переменной Петля или Порог Значение определяет количество создаваемых пороговых значений, которые используются для создания нескольких расширений независимых переменных с использованием каждого порога. Значение должно быть в диапазоне от 2 до 50. Значение по умолчанию равно 10. | Long |
study_area_type (Дополнительный) | Указывает тип области изучения, который будет использован для определения, где присутствие возможно, если входные точечные объекты не содержат точки фона.
| String |
study_area_polygon (Дополнительный) | Класс объектов, содержащий полигоны, которые определяют пользовательскую изучаемую область. Входные точечные объекты должны быть расположены в пределах пользовательской изучаемой области, покрываемой полигональными объектами. Изучаемая область состоит из нескольких полигонов. | Feature Layer |
spatial_thinning (Дополнительный) | Устанавливает, будет ли пространственное прореживание применено к точкам присутствия и фона перед обучением модели. Пространственное прореживание помогает снизить смещение выборки путем удаления точек и проверки того, что оставшиеся точки содержат минимальное расстояние ближайшего соседства, установленное в параметре thinning_distance_band. Пространственное прореживание также применяется к точкам фона, независимо от того, указываются ли они как входные точечные объекты, или создаются инструментом.
| Boolean |
thinning_distance_band (Дополнительный) | Минимальное расстояние между двумя любыми точками присутствия или фона, если применено пространственное прореживание. | Linear Unit |
number_of_iterations (Дополнительный) | Число запусков, используемое для поиска оптимального решения пространственного прореживания, возвращаясь к началу с настолько минимальным количеством точек присутствия и фона, насколько возможно, пока не будет достигнуто состояние, при котором в пределах thinning_distance_band не будет двух точек присутствия или двух точек фона. Минимально возможное число итераций - 1, а максимально - 50. Значение по умолчанию равно 10. Этот параметр применяется только для пространственного прореживания, используемого для точек присутствия и фона во входных точечных объектах. Пространственное прореживание, применяемое к точкам фона, созданным из ячеек растра, к которым применено пространственное прореживание путем пересчета ячеек растра в указанное значение параметра thinning_distance_band без необходимости повторения для оптимального решения. | Long |
relative_weight (Дополнительный) | Значение от 1 до 100, которое указывает относительный вес информации о точке присутствия к точке фона. По умолчанию используется 100. Более высокое значение указывает на то, что точки присутствия являются главным источником информации; неизвестно, представляют ли точки фона присутствие или отсутствие, и точки фона получают меньший вес в модели. Более низкое значение указывает на то, что точки фона также дополняют информацию, которая может использоваться в комбинации с информацией о точках присутствия; есть высокая вероятность, что точки фона представляют отсутствие, и эта информация может использовать в модели для указания местоположений отсутствия. | Long |
link_function (Дополнительный) | Определяет функцию, которая преобразует неограниченные выходные данные модели в число от 0 до 1. Значение можно интерпретировать как вероятность присутствия в местоположении. Каждая опция конвертирует одно и то же непрерывное значение в разную вероятность.
| String |
presence_probability_cutoff (Дополнительный) | Предельное значение между 0.01 и 0.99, которое определяет, какие вероятности соответствуют присутствию в результирующей классификации. Предельное значение используется для оценки производительности модели с помощью обучающих данных и известных точек присутствия. Диагностики классификации доступны из сообщений геообработки и в выходных обученных объектах. | Double |
output_trained_features (Дополнительный) | Выходной класс объектов, который будет содержать все объекты и независимые переменные, используемые в обучении модели. | Feature Class |
output_trained_raster (Дополнительный) | Выходной растр со значениями ячеек, указывающими на вероятность присутствия, вычисленную с помощью выбранной функцией связи. По умолчанию в качестве размера ячейки используется максимальный размер ячеек входных независимых обучающих растров. Выходной обученный растр создается только если входные точечные объекты не содержат точки фона. | Raster Dataset |
output_response_curve_table (Дополнительный) | Выходная таблица, которая будет содержать диагностики обучающей модели, отражающие вклад каждой независимой переменной в вероятность присутствия после учета усредненных эффектов всех независимых переменных в модели. К таблице могут быть добавлены до двух диаграмм частичной зависимости: набор линейных графиков для непрерывных переменных, и набор столбчатых диаграмм для категорийных переменных. | Table |
output_sensitivity_table (Дополнительный) | Выходная таблица, которая будет содержать диагностики точности обучающей модели, выраженные через предельное значение вероятности присутствия, меняющееся от 0 до 1. | Table |
features_to_predict (Дополнительный) | Класс объектов, представляющих местоположения, где будет выполняться прогнозирование. Этот класс объектов должен содержать любые независимые переменные, представленные в виде полей, входных точечных объектов. При применении пространственного прореживания вы можете использовать исходные входные точечные объекты как входные объекты прогнозирования для вычисления прогнозов по всему набору данных. | Feature Layer |
output_pred_features (Дополнительный) | Выходной класс объектов, который будет содержать результаты модели прогнозирования, примененные к входным объектам прогнозирования. | Feature Class |
output_pred_raster (Дополнительный) | Выходной растр, содержащий результаты прогнозирования в каждой ячейке сопоставленных независимых растров. По умолчанию в качестве размера ячейки используется максимальный размер ячеек входных независимых обучающих растров. | Raster Dataset |
explanatory_variable_matching [[Prediction, Training],...] (Дополнительный) | Сопоставление полей независимой переменной входных точечных объектов и входных объектов прогнозирования. | Value Table |
explanatory_distance_matching [[Prediction, Training],...] (Дополнительный) |
Сопоставление объектов расстояния для обучения и прогнозирования. | Value Table |
explanatory_rasters_matching [[Prediction, Training],...] (Дополнительный) | Сопоставление растров для обучения и прогнозирования. | Value Table |
allow_predictions_outside_of_data_ranges (Дополнительный) |
| Boolean |
resampling_scheme (Дополнительный) | Определяет метод, который будет использован для выполннения перекрестной проверки модели прогнозирования. Перекрестная проверка исключает фрагмент данных в процессе обучения модели и использует их для проверки производительности модели после обучения.
| String |
number_of_groups (Дополнительный) | Число групп, которое будет использовано в перекрестной проверке для произвольной схемы пересчета. Поле выходных обученных объектов, указывающее группу, которая назначена каждой точке. Значение по умолчанию равно 3. Допускается минимум 2, и максимум 10 групп. | Long |
output_trained_model (Дополнительный) | Файл выходной модели, в котором будет сохранена обученная модель, которую позже можно будет использовать для прогнозирования. | File |
Пример кода
Скрипт Python, демонстрирующий использование функции PresenceOnlyPrediction.
# Import system modules
import arcpy
# Call Presence-only Prediction (MaxEnt)
arcpy.stats.PresenceOnlyPrediction(
input_point_features=r"C:\MyData.gdb\Presence_Points",
contains_background="PRESENCE_ONLY_POINTS",
presence_indicator_field=None,
explanatory_variables=None,
distance_features=None,
explanatory_rasters=[[r"C:\MyData.gdb\Elevation", "false"],
[r"C:\MyData.gdb\Canopy", "false"],
[r"C:\MyData.gdb\ClimacticWaterDeficit", "false"],
[r"C:\MyData.gdb\LandCoverClassification", "true"],
[r"C:\MyData.gdb\UpperSlope", "false"],
[r"C:\MyData.gdb\LowerSlope", "false"]],
basis_expansion_functions="LINEAR;QUADRATIC;PRODUCT;HINGE",
number_knots=10,
study_area_type="CONVEX_HULL",
study_area_polygon=None,
spatial_thinning="THINNING",
thinning_distance_band="500 Meters",
number_of_iterations=10
relative_weight=100
link_function="CLOGLOG"
presence_probability_cutoff=0.5
output_trained_features=r"C:\MyData.gdb\Out_Trained_Features"
output_trained_raster=r"C:\MyData.gdb\Out_Trained_Raster"
output_response_curve_table=r"C:\MyData.gdb\Out_Response_Curve_Table"
output_sensitivity_table=r"C:\MyData.gdb\Out_Sensitivity_Table"
features_to_predict=r"C:\MyData.gdb\In_Prediction_Features"
output_pred_features=r"C:\MyData.gdb\Out_Prediction_Features"
output_pred_raster=r"C:\MyData.gdb\Out_Prediction_Raster",
explanatory_variable_matching=None
explanatory_distance_matching=None
explanatory_rasters_matching=[[r"C:\MyData.gdb\Prediction_Elevation", "false"],
[r"C:\MyData.gdb\Prediction_Canopy", "false"],
[r"C:\MyData.gdb\Prediction_ClimacticWaterDeficit", "false"],
[r"C:\MyData.gdb\Prediction_LandCoverClassification", "true"],
[r"C:\MyData.gdb\Prediction_UpperSlope", "false"],
[r"C:\MyData.gdb\Prediction_LowerSlope", "false"]],
allow_predictions_outside_of_data_ranges="ALLOWED"
resampling_scheme="RANDOM"
number_of_groups=3)Скрипт Python, демонстрирующий использование функции PresenceOnlyPrediction.
# This example is a simple run of the tool using presence-only points and
# explanatory training rasters to train an initial model. No outputs are
# specified, as the intent is to interrogate geoprocessing messages to gain
# an initial sense of model performance.
# Import system modules
import arcpy
try:
# Set the workspace and overwrite properties
arcpy.env.workspace = r"C:\MyData.gdb"
arcpy.env.overwriteOutput = True
# Set the input point feature parameters
in_point_features = "presence_observations"
contains_background = "PRESENCE_ONLY_POINTS”
# Set the explanatory Training variables, using only explanatory rasters
# Note the categorical setting for the LandCoverClassification raster
explanatory_rasters = [["Elevation", "false"],
["Canopy", "false"],
["ClimacticWaterDeficit", "false"],
["LandCoverClassification", "true"],
["UpperSlope", "false"],
["LowerSlope", "false"]]
# Set basis functions, adding quadratic to use the square of each variable
basis_functions = "LINEAR;QUADRATIC"
number_knots = 10
# Set the study area
study_area_type = "CONVEX_HULL"
study_area_polygon = None
# Set cross-validation options
resampling_scheme = "RANDOM"
number_of_groups = 3
# Call the tool using the parameters defined above.
arcpy.stats.PresenceOnlyPrediction(
input_point_features=in_point_features,
contains_background=contains_background,
explanatory_rasters=explanatory_rasters,
basis_expansion_functions=basis_functions,
study_area_type=study_area_type,
resampling_scheme=resampling_scheme,
number_of_groups=number_of_groups)Скрипт Python, демонстрирующий использование функции PresenceOnlyPrediction.
# This example uses presence and background points and explanatory
# variables from rasters, fields, and distance features to train a
# model, using additional parameters to apply basis functions, use
# spatial thinning, perform cross-validation, and receive diagnostic
# training outputs.
# Import system modules
import arcpy
try:
# Set the workspace and overwrite properties
arcpy.env.workspace = r"C:\MyData.gdb"
arcpy.env.overwriteOutput = True
### MODEL INPUTS ###
# Set the input point feature parameters
in_point_features = "presence_observations"
contains_background = "PRESENCE_AND_BACKGROUND_POINTS
presence_indicator_field = "Presence"
# Set the explanatory Training variables
explanatory_fields = [["Survey_Region", "true"],
["Temperature", "false"],
["Humidity", "false"]]
explanatory_rasters = [["Elevation", "false"],
["Canopy", "false"],
["ClimacticWaterDeficit", "false"],
["LandCoverClassification", "true"],
["UpperSlope", "false"],
["LowerSlope", "false"]]
explanatory_dist_features = [["Streams", "false"],
["Lakes", "false"],
["Roads", "false"]]
### MODEL CONFIGURATION ###
# Set basis functions
basis_functions = "LINEAR;QUADRATIC;PRODUCT;HINGE"
number_knots = 10
# Set the study area
study_area_type = "CONVEX_HULL"
study_area_polygon = None
# Set spatial thinning
spatial_thinning = "THINNING"
min_nearest_neighbor_distance = "500 Meters"
number_of_iterations = 10
# Set the relative weight of presence to background and link function, using
# background points as observed absence
relative_weight = 1
link_function = "LOGISTIC"
# Set the presence probability cutoff
cutoff = 0.3
### MODEL OUTPUTS AND VALIDATION ###
# Set training outputs for model evaluation
out_trained_features = "Out_Trained_Features"
out_trained_raster = "Out_Trained_Raster"
out_response_curve_table = "Out_Response_Curves"
out_sensitivity_table = "Out_Sensitivity_Table"
# Set cross-validation options
resampling_scheme = "RANDOM"
number_of_groups = 3
# Call the tool using the parameters defined above.
arcpy.stats.PresenceOnlyPrediction(
input_point_features=in_point_features,
contains_background=contains_background,
explanatory_variables=explanatory_fields,
explanatory_rasters=explanatory_rasters,
distance_features=explanatory_dist_features,
basis_expansion_functions=basis_functions,
number_knots=number_knots,
study_area_type=study_area_type,
spatial_thinning=spatial_thinning,
thinning_distance_band=min_nearest_neighbor_distance,
number_of_iterations=number_of_iterations,
relative_weight=relative_weight,
link_function=link_function,
presence_probability_cutoff=cutoff,
output_trained_features=out_trained_features,
output_trained_raster=out_trained_raster,
output_response_curve_table=out_response_curve_table,
output_sensitivity_table=out_sensitivity_table,
resampling_scheme=resampling_scheme,
number_of_groups=number_of_groups)Параметры среды
Особые случаи
- Коэффициент параллельной обработки
Параллельные процессы используются только если выполняются прогнозы.
- Генератор случайных чисел
В качестве генератора случайных чисел всегда используется Mersenne Twister.