Краткая информация
Проецирует пространственные данные из одной системы координат в другую.
Использование
Если входной класс объектов или набор данных имеет неизвестную или не заданную систему координат, ее можно задать с помощью параметра Входная система координат. Это позволит задать систему координат для данных без необходимости изменять входные данные (что иногда невозможно сделать, если входные данные имеют формат только для чтения). Также можно присвоить набору данных постоянную систему координат, используя инструмент Задать проекцию.
Все типы классов пространственных объектов (класс объектов базы геоданных, класс объектов покрытия, класс пространственных объектов SDC и шейп-файл), наборы классов в базе геоданных и слои объектов в приложениях ArcGIS (ArcMap, ArcScene и ArcGlobe) являются корректными входными данными.
Покрытия, покрытия VPF, наборы растровых данных и каталоги растров не поддерживаются этим инструментом в качестве входных данных. Используйте инструмент Проецировать растр, чтобы спроецировать наборы растровых данных.
Чтобы спроецировать Покрытие, следует использовать инструмент Проецировать в наборе инструментов Покрытие.
Параметр инструмента Географическое преобразование является дополнительным. Когда не требуется географического преобразования или преобразования датума, параметр будет содержать пустой, не раскрывающийся список. Если преобразование необходимо, будет создан раскрывающийся список, содержащий входные и выходные датумы и будет выбрано преобразование по умолчанию.
- Например, географическое преобразование не обязательно при проецировании из GCS_North_American_1983 в NAD_1983_UTM_Zone_12N, поскольку и входная и выходная системы координат имеют датум NAD_1983. Однако при проецировании из GCS_North_American_1983 в WGS_1984_UTM_Zone_12N требуется географическое преобразование, поскольку входная система координат использует датум NAD_1983, в то время, как выходная система координат использует датум WGS_1984.
- Список преобразований и сферы их использования см. в следующей статье базы знаний: 21327 (База знаний Esri. Статья №21327)
Рабочая область in_memory не поддерживается как выходное местоположение для записи набора данных.
При проецировании сложных типов данных, перечисленных ниже, с итоговыми данными нужно будет произвести определенные операции.
- Набор классов, содержащий набор сетевых данных: набор сетевых данных необходимо перестроить.
- Набор классов, содержащий топологию: повторно проверить всю топологию.
Если входные данные участвуют в классах отношений (как в случае со связанной с объектами аннотацией), класс отношений будет перенесен в выходные данные. Исключение из этого правила связано с участием автономных таблиц.
В зависимости от координат входного объекта и горизонта (правильный экстент) выходной системы координат, мультиточка, линия и полигон могут быть вырезаны или разбиты на несколько частей в ходе своей проекции. Объекты, которые полностью попадают за линию горизонта, будут записаны в выходной класс объектов с нулевой геометрией. Это можно удалить с помощью инструмента Восстановить геометрию .
Классы объектов, участвующие в геометрической сети, не могут быть спроецированы изолированно – необходимо проецировать весь набор классов объектов, содержащих сеть.
Многие инструменты геообработки учитывают установки выходной системы координат, и во многих рабочих процессах можно использовать эти настройки вместо инструмента Проецировать. Например, инструмент Объединение учитывает настройки выходной системы координат, а значит можно объединить несколько классов объектов, имеющих разные системы координат, вместе и записать объединенные выходные данные в класс объектов в совершенно другой системе координат.
Этот инструмент не поддерживает выборку и определяющий запрос для слоев: все объекты в наборе данных, на которые ссылается слой, будут спроецированы. Если вы хотите спроецировать только выбранные объекты, воспользуйтесь инструментом Копировать объекты, чтобы создать временный набор данных, в котором содержатся только выбранные объекты, а затем примените к нему инструмент Проецировать.
Когда в качестве входных данных используется класс объектов внутри набора классов, выходные данные не могут быть записаны в тот же набор классов объектов. Это происходит потому, что все классы объектов внутри набора классов должны иметь одинаковую систему координат. В этом случае выходной класс объектов будет записан в базу геоданных, содержащую набор классов.
Если отмечен параметр Сохранить форму, выходные объекты более точно соответствуют их истинному местоположению в проекции. Параметр Сохранить форму особенно полезен в случаях, когда линия или граница полигона оцифрована как длинная прямая линия с несколькими вершинами. Если параметр Сохранить форму не отмечен, существующие вершины входных линий или границ полигонов будут спроецированы, в результате, форма объекта может быть передана не совсем точно в новой проекции. Если параметр Сохранить форму отмечен (preserve_shape = "PRESERVE_SHAPE" in Python) – перед проецированием объекта к нему будут добавлены дополнительные вершины. Дополнительные вершины помогут сохранить форму объекта при перепроецировании. Параметр Отклонение максимального сдвига определяет, как много дополнительных вершин будет добавлено, его значение соответствует максимальному расстоянию, на которое проецируемый объект может быть сдвинут относительно текущего местоположения, рассчитанного инструментом. Чем меньше значение, тем больше вершин добавляется. Выберите значение, которое подходит вам больше всего. Например, если вы выполняете перепроецирование для отображения в мелком масштабе, лучше задать большее значение. И наоборот, для крупных масштабов лучше задавать небольшую величину отклонения.
Синтаксис
Project_management (in_dataset, out_dataset, out_coor_system, {transform_method}, {in_coor_system}, {preserve_shape}, {max_deviation})
Параметр | Объяснение | Тип данных |
in_dataset | Проецируемые класс пространственных объектов, векторный слой или набор классов объектов. | Feature Layer; Feature Dataset |
out_dataset | Выходной набор данных, в который будут записаны результаты. | Feature Class; Feature Dataset |
out_coor_system | Корректными значениями являются: Объект пространственной привязки (Spatial Reference object), файл с расширением .prj и строковое представление системы координат. | Coordinate System |
transform_method (дополнительно) | Этот метод может использоваться для конвертации данных между двумя географическими системами координат или датумами. Этот дополнительный параметр может потребоваться, если входная и выходная системы координат содержат разные датумы. | String |
in_coor_system (дополнительно) | Система координат входного класса пространственных объектов или набора данных. Когда система координат входных данных неизвестна или не задана, это позволяет задавать систему координат для данных без необходимости изменять входные данные (что иногда невозможно сделать, если входные данные имеют формат только для чтения). | Coordinate System |
preserve_shape (дополнительно) | Добавляет вершины в выходные линии или полигоны, таким образом повышая точность выходной геометрии.
| Boolean |
max_deviation (дополнительно) | Определяет, как далеко спроецированная линия или полигон может находиться от истинного местоположения, если отмечен параметр preserve_shape = "PRESERVE_SHAPE". Значение по умолчанию равно значению допуска по XY для набора данных в пространственной привязке, умноженному на 100. | Linear unit |
Пример кода
Project, пример 1 (окно Python)
Пример скрипта Python для выполнения функции Проецировать с запуском из окна Python в ArcGIS.
import arcpy
# input data is in NAD 1983 UTM Zone 11N coordinate system
input_features = r"C:/data/Redlands.shp"
# output data
output_feature_class = r"C:/data/Redlands_Project.shp"
# create a spatial reference object for the output coordinate system
out_coordinate_system = arcpy.SpatialReference('NAD 1983 StatePlane California V FIPS 0405 (US Feet)')
# run the tool
arcpy.Project_management(input_features, output_feature_class, out_coordinate_system)
Project, пример 2 (автономный скрипт)
Пример скрипта Python для выполнения функции Project в автономном скрипте.
# Name: Project_Example2.py
# Description: Project all feature classes in a geodatabase
# Requirements: os module
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data/Redlands.gdb"
arcpy.env.overwriteOutput = True
# Set local variables
outWorkspace = "C:/data/Redlands_utm11.gdb"
try:
# Use ListFeatureClasses to generate a list of inputs
for infc in arcpy.ListFeatureClasses():
# Determine if the input has a defined coordinate system, can't project it if it does not
dsc = arcpy.Describe(infc)
if dsc.spatialReference.Name == "Unknown":
print ('skipped this fc due to undefined coordinate system: ' + infc)
else:
# Determine the new output feature class path and name
outfc = os.path.join(outWorkspace, infc)
# Set output coordinate system
outCS = arcpy.SpatialReference('NAD 1983 UTM Zone 11N')
# run project tool
arcpy.Project_management(infc, outfc, outCS)
# check messages
print(arcpy.GetMessages())
except arcpy.ExecuteError:
print(arcpy.GetMessages(2))
except Exception as ex:
print(ex.args[0])
Параметры среды
Связанные темы
- Обзор группы инструментов Проекции и преобразования (Projections and Transformations)
- О картографических проекциях
- Список поддерживаемых картографических проекций
- Что такое географические системы координат?
- Что такое системы координат проекции?
- Что должны знать ГИС профессионалы об основных картографических проекциях
- Пространственная привязка и геообработка