Класс объектов Z в файл ASCII—Справка

Краткая информация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензировании

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

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

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

Формат Profile предоставляет информацию о профиле для линейных объектов 3D, которую можно импортировать в специализированные графические приложения. Каждый линейный объект в исходном классе пространственных объектов будет записан в отдельный файл, и имя файла будет содержать приставку с уникальным идентификатором (ID) линии. Каждая строка в таблице профиля содержит расстояние от начального положения линии до вершины (D), за которой следует высота этой вершины.
```
0 z₁D₁ z₂D₂ z₃D₃ z₄
```
Формат XYZ хранит координаты x, y и z в виде значений с плавающей точкой, где каждая строка представляет отдельную запись точки.
```
x₁ y₁ z₁x₂ y₂ z₂x₃ y₃ z₃x₄ y₄ z₄
```
Примечание:
Объекты точек и мультиточек записываются в один файл, в то время как каждый полигональный и линейный объект записывается в отдельных текстовый файл, имя которого содержит приставку с уникальным ID объекта. Каждая часть объектов, состоящих из нескольких частей, записывается в отдельный файл, имя которого будет содержать номер части, указанный после ID объекта.
Формат GENERATE не поддерживает строки заголовков, он хранит все входные объекты в одном файле.
- Точечные объекты хранятся со своими ID и координатами XYZ, а последняя линия обозначена ключевым словом END:
```
id₁ x₁ y₁ z₁id₂ x₂ y₂ z₂id₃ x₃ y₃ z₃id₄ x₄ y₄ z₄END
```
  Примечание:
  Объекты мультиточек, созданные из одной записи исходного класса пространственных объектов, будут иметь одинаковый ID.
- Линейные и полигональные объекты отделяются ключевым словом END, а два следующих друг за другом ключевых слова END обозначают конец файла:
```
id₁x₁ y₁ z₁x₂ y₂ z₂x₃ y₃ z₃x₄ y₄ z₄END
id₂x₁ y₁ z₁x₂ y₂ z₂END
END
```
  Примечание:
  Первые и последние координаты XYZ для полигональных объектов всегда являются одинаковыми.

Синтаксис

FeatureClassZToASCII_3d (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 —Записывает выходные данные в формате GENERATE. Это значение используется по умолчанию. XYZ —Записывает информацию о координатах XYZ входных объектов. Будет создано по одному файлу для каждой линии или полигона из входного объекта. PROFILE —Записывает информацию о профиле для линейных объектов, которую можно использовать во внешних графических приложениях.	String
delimiter (дополнительно)	Для разделения записей в столбцах таблицы текстового файла используется разделитель. SPACE —Пробел используется для разделения значений полей. Это значение используется по умолчанию. COMMA —Для разделения значений полей будет использоваться запятая. Эта опция недоступна, если разделителем десятичных знаков также является запятая.	String
decimal_format (дополнительно)	Метод, используемый для определения количества значащих цифр, хранящихся в выходных файлах. AUTOMATIC —Количество значащих цифр, необходимое для сохранения доступной точности при удалении лишних конечных нулей, определяется автоматически. Это значение используется по умолчанию. FIXED —Количество значащих цифр задается с помощью параметра Цифр после запятой (Digits after Decimal).	String
digits_after_decimal (дополнительно)	Используется, когда в качестве параметра Десятичные обозначения (Decimal Notation) задано значение FIXED. Определяет, как много знаков после запятой записывается для значений с плавающей точкой, в выходные файлы.	Long
decimal_separator (дополнительно)	Десятичный символ, используемый для разделения целой часть числа от дробной. DECIMAL_POINT —Точка используется как десятичный символ. Это значение используется по умолчанию. DECIMAL_COMMA —Запятая используется как десятичный символ.	String

Пример кода

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

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.FeatureClassZToASCII_3d("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
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    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"
                #Execute FeatureClassZToASCII_3d
                arcpy.FeatureClassZToASCII_3d(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:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)