Сохранить в файл слоя (Управление данными)

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

Создает выходной файл слоя (.lyrx) из слоя карты. Файл слоя хранит множество свойств входного слоя, например, символы, надписи и настройки всплывающих окон.

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

  • В дополнение к файлам слоев, этот инструмент использует слои, созданные такими инструментами, как Создать векторный слой или Создать слой событий XY.

  • Если входные данные являются слоем с выбранными объектами, выборка будет сохранена в выходном файле слоя.

Параметры

ПодписьОписаниеТип данных
Входной слой

Слой карты, сохраняемый на диск как файл слоя.

Layer; Table View
Выходной слой

Создаваемый выходной файл слоя (.lyrx).

Layer File
Хранить относительный путь
(Дополнительный)

Определяет, будет ли выходной файл слоя хранить абсолютные или относительные пути к источнику данных.

  • Не отмечено – Выходной файл слоя (.lyr) будет хранить абсолютные пути к источнику данных на диске. Это значение по умолчанию
  • Отмечено – Выходной файл слоя (.lyr) будет хранить относительные пути к источнику данных на диске. Если выходной файл слоя будет перемещен, путь к источнику данных будет обновлен.
Boolean
Версия слоя
(Дополнительный)

Задает версию выходного файла слоя.

  • ТекущаяТекущая версия. Это значение по умолчанию
Прежние версии:

Этот параметр более не поддерживается. Он останется только для обратной совместимости скриптов и моделей.

Файлы слоев, созданные в определенной версии, поддерживаются во всех второстепенных версиях той же серии. Например, файл слоя, сохраненный в версии ArcGIS AllSource 3.1, можно использовать во всех версиях ArcGIS AllSource 3.x.

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

String

arcpy.management.SaveToLayerFile(in_layer, out_layer, {is_relative_path}, {version})
ИмяОписаниеТип данных
in_layer

Слой карты, сохраняемый на диск как файл слоя.

Layer; Table View
out_layer

Создаваемый выходной файл слоя (.lyrx).

Layer File
is_relative_path
(Дополнительный)

Определяет, будет ли выходной файл слоя хранить абсолютные или относительные пути к источнику данных.

  • ABSOLUTEВыходной файл слоя будет хранить абсолютные пути к источнику данных на диске. Это значение по умолчанию
  • RELATIVEВыходной файл слоя будет хранить относительные пути к источнику данных на диске. Если выходной файл слоя будет перемещен, путь к источнику данных будет обновлен.
Boolean
version
(Дополнительный)

Задает версию выходного файла слоя.

Прежние версии:

Этот параметр более не поддерживается. Он останется только для обратной совместимости скриптов и моделей.

Файлы слоев, созданные в определенной версии, поддерживаются во всех второстепенных версиях той же серии. Например, файл слоя, сохраненный в версии ArcGIS AllSource 3.1, можно использовать во всех версиях ArcGIS AllSource 3.x.

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

  • CURRENTТекущая версия. Это значение по умолчанию
String

Пример кода

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

Пример скрипта окна Python для использования функции SaveToLayerFile в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SaveToLayerFile("studyquads.shp", "C:/output/studyquadsLyr.lyrx", "ABSOLUTE")
SaveToLayerFile, пример 2 (автономный скрипт Python)

Следующий скрипт Python демонстрирует использование функции SaveToLayerFile в качестве автономного скрипта.

# Description: Save a layer to a file on disk

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "study_quads.shp"
where_clause = '"NAME" = \'LA MESA\''
in_layer = "studyquadsLyr"
out_layer_file = "studyquadsLyr.lyrx"

# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(in_features, "study_quads_lyr", where_clause)

# Run SaveToLayerFile
arcpy.management.SaveToLayerFile("study_quads_lyr", out_layer_file, "ABSOLUTE")