ポイントファイルの空間統計情報 (Point File Information) (3D Analyst)—ArcMap

概要
図
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

1 つ以上のポイントファイルに関する統計情報をポリゴンまたはマルチパッチ出力に生成します。

図

[ポイントファイルの空間統計情報 (Point File Information)] の出力

使用法

ポイントデータファイルを含むフォルダーが入力として選択された場合は、ファイル接尾辞を入力する必要があります。ただし、ファイル入力の場合には必要ありません。
[サマリー] オプションを使用しない場合、フィーチャ属性テーブル内に存在する統計情報は、入力された各ポイントファイルのポイント数、平均ポイント間隔、最小 Z 値、最大 Z 値で構成されます。検出された入力ファイルごとに、別々の行が作成されます。ポイント間隔は、入力ファイル内のポイントが、各入力ファイルの XY 範囲で等間隔に配置されているという前提で見積もられています。
作成される各フィーチャは、入力ファイルの XY 範囲を含みます。フィーチャは、2D ポリゴンまたは立ち上げられたマルチパッチフィーチャとして作成できます。これらは、上下の Z 値がファイルの標高値の範囲を表す 3D バウンディングボックスを提供します。ArcScene または ArcGlobe を使用して、マルチパッチを 3D で視覚化できます。
入力ファイル内のクラスコードごとに統計情報をまとめるには、[サマリー] オプションが便利ですが、各ファイルをスキャンして解析する必要があるので負荷が高くなるおそれがあります。
[ポイントファイルの空間統計情報 (Point File Information)] によってレポートされるポイント間隔は正確なものではなく、推定です。指定されるポイント間隔は、ファイルのコレクションの傾向を調べたときのサマリーです。このツールでは、ファイルのバウンディングボックスの面積をポイント数との単純な概算比較が使用されます。最も正確なのは、調査対象のファイルの矩形範囲がデータで埋め尽くされている場合です。大規模な水域や調査エリアの外周にポイントが存在するファイルで、データが一部に偏って配置されているような場合は、正確な見積もりができません。

構文

arcpy.ddd.PointFileInformation(input, out_feature_class, in_file_type, {file_suffix}, {input_coordinate_system}, {folder_recursion}, {extrude_geometry}, {decimal_separator}, {summarize_by_class_code}, {improve_las_point_spacing})

パラメーター	説明	データタイプ
input [input,...]	1 つ以上のポイントデータファイルまたはフォルダーが解析されます。 Windows エクスプローラーでフォルダーを選択して、パラメーターの入力ボックスにドラッグすると、ツールダイアログウィンドウでフォルダーを指定することもできます。	Folder; File
out_feature_class	このツールで生成されるフィーチャクラス。	Feature Class
in_file_type	入力ファイルの形式。 LAS —American Society of Photogrammetry and Remote Sensing (ASPRS) によって定義された航空機 LIDAR 形式。 XYZ —XYZ ファイル XYZI —XYZI ファイル GENERATE —GENERATE ファイル	String
file_suffix (オプション)	入力としてフォルダーが指定されたときにインポートするファイルの接尾辞。このパラメーターは、入力フォルダーが指定されたときに必要です。	String
input_coordinate_system (オプション)	入力データの座標系。	Coordinate System
folder_recursion (オプション)	サブフォルダーディレクトリにデータの格納された入力フォルダーが選択されたときに、サブフォルダーまでスキャンします。出力フィーチャクラスは、ディレクトリ構造で検出された各ファイルの行で生成されます。 NO_RECURSION —結果の生成に、入力フォルダーにあるデータのみが使用されます。これがデフォルトです。 RECURSION —結果の生成に、入力フォルダーおよびそのサブディレクトリにあるあらゆるデータが使用されます。	Boolean
extrude_geometry (オプション)	各ファイルにある標高範囲を反映した立ち上げられたフィーチャを使用して 2D ポリゴンフィーチャクラスとマルチパッチフィーチャクラスのどちらを作成するかを指定します。 NO_EXTRUSION —出力は 2D ポリゴンフィーチャクラスとして作成されます。これがデフォルトです。 EXTRUSION —出力はマルチパッチフィーチャクラスとして作成されます。	Boolean
decimal_separator (オプション)	整数部と小数部を区別するためにテキストファイルで使用される小数記号。 DECIMAL_POINT —ポイントが小数記号として使用されます。これがデフォルトです。 DECIMAL_COMMA —カンマが小数記号として使用されます。	String
summarize_by_class_code (オプション)	クラスコード単位で LAS ファイルを集計するか、LAS ファイル単位で集計するかを指定します。 NO_SUMMARIZE —各出力フィーチャは、LIDAR ファイルにあるすべてのクラスコードを表します。これがデフォルトです。 SUMMARIZE —各出力フィーチャは、LIDAR ファイルにある単一のクラスコードを表します。	Boolean
improve_las_point_spacing (オプション)	不規則なデータ分布が引き起こす過大な推定を減らすことができるように、LAS ファイルのポイント間隔の拡張評価を提供します。 LAS_SPACING —規則的なポイント間隔の推定が LAS ファイルに使用されます。ここでは、範囲はポイントの数で等しく分けられます。これがデフォルトです。 NO_LAS_SPACING —より正確にポイント間隔を推定するために、LAS ファイルにラスター化が使用されます。この場合、ツールの実行時間が長くなる可能性があります。	Boolean

派生した出力

名前	説明	データタイプ
min_point_spacing	平均ポイント間隔。	Double (倍精度浮動小数点数)

コードのサンプル

PointFileInformation (ポイントファイルの空間統計情報) の例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PointFileInformation_3d(env.workspace, "Test.gdb/two_las", "LAS", "las", "Coordinate Systems/Projected Coordinate Systems/UTM/NAD 1983/NAD 1983 UTM Zone 17N.prj", True, True, "DECIMAL_POINT", True)

PointFileInformation (ポイントファイルの空間統計情報) の例 2 (スタンドアロンスクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。

'''****************************************************************************
Name: PointFileInformation Example
Description: This script demonstrates how to use the 
             PointFileInformation tool to create an output file that contains
             all LAS files under a parent folder.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension("3D")
    # Set environment settings
    env.workspace = "C:/data"
    lidarList = arcpy.ListFiles("*.las")
    if lidarList:
        # Set Local Variables
        outputFC = "Test.gdb/output_las_info"
        prj = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
        extrudeGeom = True # Indicates whether to create extruded geometry shapes
        sumClass = True # Indicates whether to summarize output by class code
        decSep = "DECIMAL_POINT" # Identifies the decimal separator
        #Execute PointFileInformation
        arcpy.PointFileInformation_3d(lidarList, outputFC, "LAS", "las", prj, 
                                    "", extrudeGeom, decSep, sumClass)
        print "Finished executing Point File Information."
    else:
        print "There are no LAS files in {0}.".format(env.workspace)

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)

環境

ライセンス情報

Basic: 次のものが必要 3D Analyst
Standard: 次のものが必要 3D Analyst
Advanced: 次のものが必要 3D Analyst

概要

図

使用法

構文

派生した出力

コードのサンプル

PointFileInformation (ポイント ファイルの空間統計情報) の例 1 (Python ウィンドウ)

PointFileInformation (ポイント ファイルの空間統計情報) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

PointFileInformation (ポイントファイルの空間統計情報) の例 1 (Python ウィンドウ)

PointFileInformation (ポイントファイルの空間統計情報) の例 2 (スタンドアロンスクリプト)