ASCII 3D в класс объектов (Инструменты 3D Analyst)

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

Импортирует 3D-объекты из одного или нескольких текстовых файлов кодировки ASCII (форматов XYZ, XYZI или GENERATE) в новый класс пространственных объектов.

Иллюстрация

Пример ASCII 3D в класс объектов

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

Все входные файлы должны быть одного формата и с одним типом геометрии.
XYZ и форматы XYZI поддерживают строки заголовка и за начало записи точек принимают первую строку с тремя последовательными числами. Оба формата могут хранить точки, линии и полигоны, но каждый файл может содержать только один простой (не составной) линейный или полигональный объект. Полигональные объекты должны быть замкнутыми, т.е. координаты последней вершины должны совпадать с координатами первой, кроме того, они не должны иметь самопересечений.
XYZ файлы содержат координаты x, y и z в формате с плавающей точкой, при этом каждая строка характеризует отдельную точку. За координатами XYZ могут следовать буквенно-цифровые символы, но эта информация не перейдет в полученный класс пространственных объектов.
XYZI файлы содержат координаты x, y, z и значения интенсивности. В случае выходных объектов-мультипатчей значения интенсивности хранятся в поле типа BLOB (большой двоичный объект).

Примечание:

Если имеется файл ASCII в формате XYZI, но значения интенсивности из него не требуются, выберите формат XYZ. В этом случае при чтении файлов значения интенсивности будут пропущены.

Формат GENERATE не поддерживает строки заголовка, но каждая точка с координатами XYZ снабжена идентификатором, а последняя строка в файле может быть (но необязательно) отмечена ключевым словом END:

<!--```без выделения id x y z id x y z . . END


Формат <mark>GENERATE</mark> может содержать несколько пространственных объектов в одном файле. Ключевое слово <mark>END</mark> обозначает конец записи одного линейного или полигонального объекта, каждый из которых должен быть простым. Два слова END подряд обозначают конец файла.

&lt;!--```без выделения
id
x y z
x y z
x y z
END
id
x y z
x y z
END
END
```-->

> [!NOTE]
> Полигоны должны быть ориентированы по часовой стрелке, не иметь самопересечений и быть замкнутыми (т.е. последняя вершина должна быть равна первой). Если одно из этих условий не выполняется, в результате будут получены некорректные полигоны. Инструмент [**Проверка геометрии**](../data-management/check-geometry.yml) может использоваться для проверки корректности полученных пространственных объектов, а инструмент [**Восстановление геометрии**](../data-management/repair-geometry.yml) – для исправления ошибок.

Подпись	Объяснение	Тип данных
Данные ASCII 3D	Файлы или папки с файлами кодировки ASCII, содержащие данные в формате XYZ, XYZI (с интенсивностью данных лазерного сканирования) или 3D GENERATE. Все входные файлы должны быть одного формата. Если указана папка, то необходимо также задать параметр Суффикс файла, при этом будут обработаны все файлы из папки, имеющие расширение, соответствующее заданному суффиксу. На панели Геообработка в качестве входных данных можно указать папку, выбрав ее в проводнике и перетащив в поле ввода параметра.	Folder; File
Формат файла	Формат файлов ASCII, которые будут конвертироваться в класс пространственных объектов. XYZ–Text file that contain geometry information stored as XYZ coordinates. XYZI–Text files that contain XYZ coordinates alongside intensity measurements. Generate–Text files structured in the Generate format.	String
Выходной класс пространственных объектов	Класс объектов, который будет получен.	Feature Class
Тип выходного класса пространственных объектов	Тип геометрии выходного класса пространственных объектов. Multipoint features–Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. Point features–Each XYZ coordinate will produce one point feature. Polyline features–The output will contain polyline features. Polygon features–The output will contain polygon features.	String
Коэффициент Z (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.	Double
Система координат (Дополнительный)	Система координат входных данных. По умолчанию используется Неизвестная система координат. Если задано, выходные данные могут быть спроецированы в другую систему координат, а могут и не быть спроецированы. Это зависит от того, определена ли в параметрах среды геообработки система координат для местоположения выходного класса пространственных объектов.	Coordinate System
Средний интервал между точками (Дополнительный)	Среднее расстояние на плоскости между точками во входных данных. Этот параметр используется только в том случае, если тип выходной геометрии задан как MULTIPOINT, и он служит для определения способа группировки точек. Это значение, в сочетании с ограничением числа точек на одну фигуру, применяется для построения виртуальной системы листов, предназначенной для группировки точек. Начало отсчета системы листов основано на домене целевого класса пространственных объектов. Укажите интервал в горизонтальных единицах целевого класса объектов.	Double
Суффикс (Дополнительный)	Суффикс файлов, которые будут импортированы из входной папки. Этот параметр также необходим, когда папка указана в качестве входных данных.	String
Разделитель десятичных знаков (Дополнительный)	Десятичный символ, который будет использоваться в текстовом файле, чтобы отделить целую часть числа от дробной. Point–A point will be used as the decimal character. This is the default. Comma–A comma will be used as the decimal character.	String

arcpy.3d.ASCII3DToFeatureClass(input, in_file_type, out_feature_class, out_geometry_type, {z_factor}, {input_coordinate_system}, {average_point_spacing}, {file_suffix}, {decimal_separator})

Имя	Объяснение	Тип данных
input [input,...]	Файлы или папки с файлами кодировки ASCII, содержащие данные в формате XYZ, XYZI (с интенсивностью данных лазерного сканирования) или 3D GENERATE. Все входные файлы должны быть одного формата. Если указана папка, то необходимо также задать параметр Суффикс файла, при этом будут обработаны все файлы из папки, имеющие расширение, соответствующее заданному суффиксу. На панели Геообработка в качестве входных данных можно указать папку, выбрав ее в проводнике и перетащив в поле ввода параметра.	Folder; File
in_file_type	Формат файлов ASCII, которые будут конвертироваться в класс пространственных объектов. `XYZ`–Text file that contain geometry information stored as XYZ coordinates. `XYZI`–Text files that contain XYZ coordinates alongside intensity measurements. `GENERATE`–Text files structured in the Generate format.	String
out_feature_class	Класс объектов, который будет получен.	Feature Class
out_geometry_type	Тип геометрии выходного класса пространственных объектов. `MULTIPOINT`–Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. `POINT`–Each XYZ coordinate will produce one point feature. `POLYLINE`–The output will contain polyline features. `POLYGON`–The output will contain polygon features.	String
z_factor (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.	Double
input_coordinate_system (Дополнительный)	Система координат входных данных. По умолчанию используется Неизвестная система координат. Если задано, выходные данные могут быть спроецированы в другую систему координат, а могут и не быть спроецированы. Это зависит от того, определена ли в параметрах среды геообработки система координат для местоположения выходного класса пространственных объектов.	Coordinate System
average_point_spacing (Дополнительный)	Среднее расстояние на плоскости между точками во входных данных. Этот параметр используется только в том случае, если тип выходной геометрии задан как MULTIPOINT, и он служит для определения способа группировки точек. Это значение, в сочетании с ограничением числа точек на одну фигуру, применяется для построения виртуальной системы листов, предназначенной для группировки точек. Начало отсчета системы листов основано на домене целевого класса пространственных объектов. Укажите интервал в горизонтальных единицах целевого класса объектов.	Double
file_suffix (Дополнительный)	Суффикс файлов, которые будут импортированы из входной папки. Этот параметр также необходим, когда папка указана в качестве входных данных.	String
decimal_separator (Дополнительный)	Десятичный символ, который будет использоваться в текстовом файле, чтобы отделить целую часть числа от дробной. `DECIMAL_POINT`–A point will be used as the decimal character. This is the default. `DECIMAL_COMMA`–A comma will be used as the decimal character.	String

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python:

arcpy.env.workspace = "C:/data"
#Create spatial reference object using WKID
sr = arcpy.SpatialReference(32136)
arcpy.ddd.ASCII3DToFeatureClass("masspntz.gen", "GENERATE", "elevation_points.shp",
                                "MULTIPOINT", z_factor=3.28,
                                input_coordinate_system=sr, average_point_spacing=2.5)

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

В следующем примере показано использование этого инструмента в автономном скрипте Python:

'''****************************************************************************
Name: ASCII3D_to_Feature_Class Example
Description: Creates a TIN surface using XYZI files in a folder and breaklines
             imported from ASCII files.
****************************************************************************'''
# Import system modules
import arcpy

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

# Define the spatial reference using the name
sr = arcpy.SpatialReference("Hawaii Albers Equal Area Conic")

# Create the elevation points
arcpy.ddd.ASCII3DToFeatureClass("Elevation Points", "XYZI",
                               "elevation_points.shp",
                               "MULTIPOINT", z_factor=3.28,
                               input_coordinate_system=sr,
                               average_point_spacing=2.5,
                               file_suffix="XYZ")

# Create the break lines
arcpy.ddd.ASCII3DToFeatureClass("brklines.gen", "GENERATE",
                               "breaklines.shp",
                               "POLYLINE", z_factor=3.28,
                               input_coordinate_system=sr)

arcpy.ddd.CreateTin("elevation_tin", sr,
                    [["breaklines.shp", "Shape", "hardline"],
                    ["elevation_points.shp", "Shape", "masspoints"]],
                    "CONSTRAINED_DELAUNAY")

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

Текущая рабочая область, Экстент, Выходная система координат, Географические преобразования, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Выходное ключевое слово конфигурации, Автоподтверждение

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

Basic: Да
Standard: Да
Advanced: Да