Добавить информацию Z (3D Analyst)

Уровень лицензии:BasicStandardAdvanced

Резюме

Добавляет сведения свойствах высоты объектов в класс объектов с поддержкой Z-значений.

Каждая 3D фигура изучается, а выбранные свойства добавляются в таблицу атрибутов входного класса объектов. Различия выходных опций зависят от типа геометрии объекта.

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

Синтаксис

AddZInformation_3d (in_feature_class, out_property, {noise_filtering})
ПараметрОбъяснениеТип данных
in_feature_class

Входной класс объектов.

Feature Layer
out_property
[out_property,...]

Z-свойства, которое добавляется в таблицу атрибутов входного класса объектов. Доступны следующие опции:

  • ZОтметка высоты одноточечного объекта.
  • POINT_COUNTЧисло точек в каждом мультиточечном массиве.
  • Z_MINМинимальная высота, найденная в каждом мультиточечном, полигональном или мультипатч объекте.
  • Z_MAXМаксимальная высота, найденная в каждом мультиточечном, полигональном или мультипатч объекте.
  • Z_MEANСредняя высота, найденная в каждом мультиточечном, полигональном или мультипатч объекте.
  • LENGTH_3DТрехмерная длина каждого полилинейного или полигонального объекта.
  • VERTEX_COUNTОбщее число вершин у каждого полилинейного или полигонального объекта.
  • MIN_SLOPEМинимальное значение уклона, вычисленное для каждого полилинейного, полигонального или мультипатч объекта.
  • MAX_SLOPEМаксимальное значение уклона, вычисленное для каждого полилинейного, полигонального или мультипатч объекта.
  • AVG_SLOPEСреднее значение уклона, вычисленное для каждого полилинейного, полигонального или мультипатч объекта.
  • VOLUMEОбъем каждого замкнутого объекта-мультипатч.
String
noise_filtering
(дополнительно)

Позволяет исключать из обработки небольшие части объектов, согласно статистическим данным. Эта опция полезна для получения качественной оценки максимального уклона, так как небольшие части пространственных объектов часто содержат более крутые склоны, что может отражаться на статистических данных.

Значения опций Площадь (Area) или Длина (Length) могут использоваться для исключения частей таких объектов. Этот параметр не применяется к точечным и мультиточеным объектам.

  • NO_FILTERФильтр помех выключен. Это значение используется по умолчанию.
  • AREA <…>Фильтр по площади, который применяется к частям объектов из класса объектов мультипатч. Значение опции AREA, равное 0,001, означает, что составные части мультипатч с площадью менее 0,001 будут игнорироваться.
  • LENGTH <…> Фильтр длины, который применяется к частям объектов из класса линейных или полигональных объектов. Значение опции LENGTH, равное 0,001, означает, что части объектов с длиной менее 0,001 будут игнорироваться.
String

Пример кода

Пример AddZInformation 1 (окно Python)

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.AddZInformation_3d('lines_3D.shp', 'Z_MEAN; LENGTH_3D; AVG_SLOPE', 
                        'NO_FILTER')
Пример AddZInformation 2 (автономный скрипт)

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

'''******************************************************************
Name: AddZInformation Example
Description: This script demonstrates AddZInformation on all 
             z-aware features in a target workspace.
******************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # Create list of feature classes
    fcList = arcpy.ListFeatureClasses()
    if fcList:
        for fc in fcList:
            desc = arcpy.Describe(fc)
            if desc.hasZ:
                # Set Local Variables
                noise = 'No_Filter'
                if desc.shapeType == 'Polygon':
                    Prop = ['Z_MIN', 'Z_MAX', 'VERTEX_COUNT']
                elif desc.shapeType == 'Point':
                    Prop = 'Z'
                elif desc.shapeType == 'Multipoint':
                    Prop = ['Z_MIN', 'Z_MAX', 'Z_MEAN']
                elif desc.shapeType == 'Polyline':
                    Prop = 'LENGTH_3D'
                print 'Completed adding Z information.'
                # Execute AddZInformation
                arcpy.AddZInformation_3d(inFC, Prop, noise)
    arcpy.CheckInExtension('3D')
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)

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует 3D Analyst
ArcGIS for Desktop Standard: Требует 3D Analyst
ArcGIS for Desktop Advanced: Требует 3D Analyst
9/10/2013