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

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

Экспортирует 3D объекты в текстовые файлы ASCII, хранящие данные в формате GENERATE, XYZ или данные профиля.

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

Опция Профиль записывает двухстолбчатый ASCII-файл, который преобразует трехмерные линейные объекты в записи, которые можно использовать для построения линейных графов. Каждая строка из исходного класса пространственных объектов будет записана в отдельный файл, к его имени будет добавлен уникальный идентификатор этой строки. Каждая строка в файле ASCII будет содержать расстояние от начальной позиции линии до вершины (D), за которой следует высота в этой вершине. При загрузке полученного ASCII-файла в графическое приложение первый столбец используется для определения оси x, а второй столбец — оси y.

<!--```без выделения 0 z₁ D₁ z₂ D₂ z₃ D₃ z₄

Опция XYZ записывает координаты x, y и z в формате с плавающей точкой, при этом каждая строка характеризует отдельную точку.

<!--```без выделения x₁ _{y 1} z₁ x₂ _{y 2} z₂ x₃ _{y 3} z₃ x₄ y₄ z₄


> [!NOTE]
> Точечные и мультиточечные объекты записываются в один и тот же файл, тогда как каждый полигон и полилиния записываются в отдельный текстовый файл, к имени которого добавляется идентификатор объекта. Каждая часть составного объекта записывается в отдельный файл с номером части после идентификатора объекта в имени файла.

Формат GENERATE не поддерживает строки заголовка, но он сохраняет все входные данные в одном файле.
- Точечные объекты хранятся с соответствующими идентификаторами и XYZ координатами, а последняя строка обозначается ключевым словом END:
  
  <!--```без выделения id₁ x₁ y₁ z₁ id₂ x₂ y₂ z₂ id₃ x₃ y₃ z₃ id₄ x₄ y₄ z₄END
```
> [!NOTE]
> Мультиточечные объекты, происходящие из одной и той же записи в исходном классе пространственных объектов, будут иметь один и тот же идентификатор.
```
- Линейные и полигональные объекты разделяются ключевым словом END, а два последовательных ключевых слова END указывают на конец файла:
  
  <!--```без выделения id₁ x₁ _{y 1} z₁ x₂ _{y 2} z₂ x₃ _{y 3} z₃ x₄ y₄ z₄ END
  
  id₂ x₁ _{y 1} z₁ x₂ _{y 2} z₂ END
  
  END
```
> [!NOTE]
> Первая и последняя координаты XYZ для полигона всегда идентичны.
```

Подпись	Объяснение	Тип данных
Входные объекты	Класс точечных, мультиточечных или полигональных 3D-объектов, который будет экспортирован в файл ASCII.	Feature Layer
Выходное местоположение	Папка, в которую будут записаны выходные файлы.	Folder
Выходной текстовой файл	Имя результирующего файла ASCII. Если линейный или полигональный класс объектов экспортируется в формат XYZ, имя файла используется в качестве базового имени. Каждый объект будет иметь уникальный выходной файл, так как формат XYZ поддерживает только одну линию или полигон в одном файле. Каждая часть составного объекта также будет записываться в отдельный файл. К имени файла будет добавлен OID каждого объекта, а также любые дополнительные символы, необходимые для создания уникального имени каждого файла.	String
Формат ASCII (Дополнительный)	Определяет формат создаваемого файла ASCII. GENERATE–Writes output in the GENERATE format. This is the default. XYZ–Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. Profile–Writes profile information for line features that can be used in external graphing applications.	String
Разделитель (Дополнительный)	Задает разделитель, который будет обозначать разделение записей в столбцах таблицы текстового файла. Space–A space will be used to delimit field values. This is the default. Comma–A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
Десятичные обозначения (Дополнительный)	Задает метод, который определяет число значащих цифр, хранящихся в выходных файлах. Automatically Determined–The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. Specified Number–The number of significant digits is defined in the Digits after Decimal parameter.	String
Цифр после запятой (Дополнительный)	Количество цифр после запятой для значений с плавающей точкой, которые записываются в выходные файлы. Этот параметр используется, когда для параметра Десятичные обозначения задано значение Указанное число (`decimal_format=FIXED` в Python).	Long
Разделитель десятичных знаков (Дополнительный)	Задает десятичный символ, используемый в текстовом файле для отделения целой части числа от дробной. Point–A point is used as the decimal character. This is the default. Comma–A comma is used as the decimal character.	String

Производные выходные данные

Подпись	Объяснение	Тип данных
Обновленная папка	Папка, в которую будут записаны выходные файлы.	Folder; File

arcpy.3d.FeatureClassZToASCII(in_feature_class, output_location, out_file, {format}, {delimiter}, {decimal_format}, {digits_after_decimal}, {decimal_separator})

Имя	Объяснение	Тип данных
in_feature_class	Класс точечных, мультиточечных или полигональных 3D-объектов, который будет экспортирован в файл ASCII.	Feature Layer
output_location	Папка, в которую будут записаны выходные файлы.	Folder
out_file	Имя результирующего файла ASCII. Если линейный или полигональный класс объектов экспортируется в формат XYZ, имя файла используется в качестве базового имени. Каждый объект будет иметь уникальный выходной файл, так как формат XYZ поддерживает только одну линию или полигон в одном файле. Каждая часть составного объекта также будет записываться в отдельный файл. К имени файла будет добавлен OID каждого объекта, а также любые дополнительные символы, необходимые для создания уникального имени каждого файла.	String
format (Дополнительный)	Определяет формат создаваемого файла ASCII. `GENERATE`–Writes output in the GENERATE format. This is the default. `XYZ`–Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. `PROFILE`–Writes profile information for line features that can be used in external graphing applications.	String
delimiter (Дополнительный)	Задает разделитель, который будет обозначать разделение записей в столбцах таблицы текстового файла. `SPACE`–A space will be used to delimit field values. This is the default. `COMMA`–A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
decimal_format (Дополнительный)	Задает метод, который определяет число значащих цифр, хранящихся в выходных файлах. `AUTOMATIC`–The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. `FIXED`–The number of significant digits is defined in the Digits after Decimal parameter.	String
digits_after_decimal (Дополнительный)	Количество цифр после запятой для значений с плавающей точкой, которые записываются в выходные файлы. Этот параметр используется, когда для параметра Десятичные обозначения задано значение Указанное число (`decimal_format=FIXED` в Python).	Long
decimal_separator (Дополнительный)	Задает десятичный символ, используемый в текстовом файле для отделения целой части числа от дробной. `DECIMAL_POINT`–A point is used as the decimal character. This is the default. `DECIMAL_COMMA`–A comma is used as the decimal character.	String

Производные выходные данные

Имя	Объяснение	Тип данных
derived_output	Папка, в которую будут записаны выходные файлы.	Folder; File

Пример кода

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.FeatureClassZToASCII("LidarPts.shp", "", "ASCII_LidarPts.txt",
                            "GENERATE", "COMMA", "FIXED", 6, "DECIMAL_POINT")

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

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

'''****************************************************************************
Name: FeatureClassZToASCII Example
Description: This script demonstrates how to use the
             FeatureClassZToASCII tool to create generate files for all
             z-aware point features in a given workspace.
****************************************************************************'''
import arcpy

try:
    # Set environment settings
    arcpy.env.workspace = 'C:/data'
    # List all points in the target workspace
    fcList = arcpy.ListFeatureClasses("*", "POINT")
    if fcList:
        # Set Local Variables
        outFolder = "C:/output"
        outFormat = "GENERATE"
        delimeter = "SPACE"
        decimal = "FIXED"
        digits = 3
        dec_sep = "DECIMAL_POINT"
        for fc in fcList:
            # Use Describe method to evaluate whether the feature class is z-aware
            desc = arcpy.Describe(fc)
            if desc.hasZ == True:
                # Define the output file name by replacing '.shp' with _ascii.txt
                outName = fc.replace('.shp', '') + "_ascii.txt"
                # Run FeatureClassZToASCII_3d
                arcpy.ddd.FeatureClassZToASCII(fc, outFolder, outName, outFormat, delimeter, decimal, digits, dec_sep)
    else:
        print("There are no feature classes in the " + env.workspace + " directory.")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

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

Текущая рабочая область, Экстент, Выходная система координат, Географические преобразования

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

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

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

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

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

Параметры

Производные выходные данные

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

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

Связанные разделы