Экспорт объектов (Конвертация)

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

Преобразует класс пространственных объектов или векторный слой в новый класс пространственных объектов.

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

  • Используйте параметр Список полей для управления полями и их содержанием в входных наборах данных.

    • Добавляйте и удаляйте поля из списка полей, изменяйте порядок и переименовывайте поля.
    • Тип данных выходного поля по умолчанию будет таким же, как тип данных первого входного поля (того имени), которое он находит. Вы можете изменить тип данных на другой допустимый тип.
    • Используйте действие, чтобы определить, как значения из одного или нескольких входных полей будут объединены в одно выходное поле. Доступны следующие действия: Первое, Последнее, Соединить, Сумма, Среднее, Медиана, Режим, Минимум, Максимум, Стандартное отклонение и Число.
    • При использовании действия Соединить, вы можете задать разделитель, например, точку или другой символ. Щелкните начало текстового поля Разделитель, чтобы добавить символы-разделители.
    • Стандартное отклонение не является допустимым параметром для одиночных входных значений.
    • Используйте кнопку Фрагмент текста в исходных текстовых полях, чтобы выбрать, какие символы из входного значения будут извлечены в поле вывода. Чтобы получить доступ к кнопке Фрагмент текста, наведите курсор на текстовое поле в списке входных полей, затем укажите начальную и конечную позиции символов.
    • Поля также можно сопоставить, используя скрипты Python.

  • SQL-выражение может использоваться для выбора поднабора ячеек растра. Более подробно о синтаксисе параметра Выражение см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.

  • Строки можно переупорядочивать в порядке возрастания или убывания, указав значение параметра Сортировка полей. Если указано более одного поля, строки сначала будут отсортированы по первому полю, потом в этом порядке по второму полю и т. д.

  • При конвертации данных базы геоданных с подтипами или доменами, если при этом выходная рабочая область не является базой геоданных, и коды, и описания домена могут быть включены в выходные данные. Для управления этим поведением используйте параметр среды Перенос описаний домена поля. По умолчанию в выходные данные будут включены только коды доменов и подтипов, но не описания.

    Примечание:

    Конвертация в шейп-файлы с описаниями подтипа и домена может занять больше времени (более низкая производительность), чем то же действие без использования описаний. Если описания подтипов и доменов не требуются в выходных данных, оставьте поле переноса описания домена в среде не отмеченным для достижения наилучшей производительности.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входные объекты для экспорта в новый класс объектов.

Feature Layer
Выходной класс пространственных объектов

Выходной класс объектов, содержащий экспортированные объекты.

Feature Class
Выражение
(Дополнительный)

SQL-выражение, использованное для выбора поднабора пространственных объектов.

SQL Expression
Использовать псевдоним поля в качестве имени
(Дополнительный)

Указывает, будут ли в качестве имени выходного поля использоваться имена входных полей или псевдонимы полей.

  • Не отмечено — в качестве имен выходных полей будут использоваться имена входных полей. Это значение по умолчанию
  • Отмечено — в качестве имен выходных полей будут использоваться псевдонимы входных полей.
Boolean
Список полей
(Дополнительный)

Поля, которые будут перенесены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из входного набора данных.

Используйте Список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей.

Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное.

Field Mappings
Поля сортировки
(Дополнительный)

Поле или поля, значения которых будут использоваться для изменения порядка входных записей, а также направление, в котором будут отсортированы записи.

  • По возрастанию – записи будут отсортированы от меньшего значения к большему.
  • По убыванию – записи будут отсортированы от большего значения к меньшему.

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
ИмяОписаниеТип данных
in_features

Входные объекты для экспорта в новый класс объектов.

Feature Layer
out_features

Выходной класс объектов, содержащий экспортированные объекты.

Feature Class
where_clause
(Дополнительный)

SQL-выражение, использованное для выбора поднабора пространственных объектов. Информацию о синтаксисе SQL вы найдете в разделе справки Литература по SQL для выражений запросов, используемых в ArcGIS

SQL Expression
use_field_alias_as_name
(Дополнительный)

Указывает, будут ли в качестве имени выходного поля использоваться имена входных полей или псевдонимы полей.

  • NOT_USE_ALIASВ качестве имен выходных полей будут использоваться имена входных полей. Это значение по умолчанию
  • USE_ALIASВ качестве имен выходных полей будут использоваться псевдонимы входных полей.
Boolean
field_mapping
(Дополнительный)

Поля, которые будут перенесены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из входного набора данных.

Используйте Список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей.

Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное.

Field Mappings
sort_field
[sort_field,...]
(Дополнительный)

Поле или поля, значения которых будут использоваться для изменения порядка входных записей, а также направление, в котором будут отсортированы записи.

  • ASCENDING – записи будут отсортированы от меньшего значения к большему.
  • DESCENDING – записи будут отсортированы от большего значения к меньшему.

Value Table

Пример кода

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

В следующем скрипте окна Python показано, как используется функция ExportFeatures в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")
ExportFeatures, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции ExportFeatures.

# Name: ExportFeatures_Example2.py
# Description: Use Export Features with an expression to create a subset of the
# original feature class.

# Import system modules

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
                               "NOT_USE_ALIAS")