ポイント ファイルの空間統計情報(Point File Information) (3D Analyst)
サマリ
1 つ以上のポイント ファイルに関する統計情報を含む新しい出力フィーチャクラスを生成します。
図
![]() |
使用法
-
入力ファイルは LAS、XYZ、XYZI、GENERATE のいずれかの形式でなければなりません。
-
ポイント データ ファイルを含むフォルダが入力として選択された場合は、接尾辞を入力する必要があります。入力として 1 つのファイルが選択された場合、接尾辞は必要ありません。
-
[サマリ] オプションを使用しない場合、フィーチャ属性テーブル内に存在する統計情報は、入力された各ポイント ファイルのポイント数、平均ポイント間隔、最小 Z 値、最大 Z 値で構成されます。検出された入力ファイルごとに、別々の行が作成されます。ポイント間隔は、入力ファイル内のポイントが、各入力ファイルの XY 範囲で等間隔に配置されているという前提で見積もられています。
-
出力ポリゴン フィーチャクラスは、入力ファイルの XY 範囲で作成されます。または、入力ファイルの最小 Z 範囲および最大 Z 範囲の情報を使用することで、マルチパッチ フィーチャを生成することができます。これらによって、ArcScene または ArcGlobe で表示できる 3D バウンディング ボックスの表現が提供されます。
入力ファイル内のクラス コードごとに統計情報をまとめるには、[サマリ] オプションが便利ですが、各ファイルをスキャンして解析する必要があるので負荷が高くなるおそれがあります。
[ポイント ファイルの空間統計情報(Point File Information)] によってレポートされるポイント間隔は正確なものではなく、推定です。指定されるポイント間隔は、ファイルのコレクションの傾向を調べたときのサマリです。このツールでは、ファイルのバウンディング ボックスの面積をポイント数との単純な概算比較が使用されます。最も正確なのは、調査対象のファイルの矩形範囲がデータで埋め尽くされている場合です。大規模な水域や調査エリアの外周にポイントが存在するファイルで、データが一部に偏って配置されているような場合は、正確な見積もりができません。
構文
パラメータ | 説明 | データ タイプ |
input |
1 つ以上のポイント データ ファイルまたはフォルダ。 | File; Folder |
out_feature_class |
出力フィーチャクラス。 | Feature Class |
in_file_type |
入力ファイルの形式。入力ファイルは LAS、XYZ、XYZI、GENERATE のいずれかの形式でなければなりません。 | String |
file_suffix |
入力に対してフォルダが指定されている場合にインポートするファイルの接尾辞。 | String |
input_coordinate_system (オプション) |
入力データの座標系。 | Coordinate System |
summarize_by_class_code (オプション) |
LAS ファイルをスキャンして、クラス コード値を解析します。出力フィーチャクラスの属性テーブルには、検出された各クラス コードの統計情報が格納されます。
| Boolean |
folder_recursion (オプション) |
サブフォルダ ディレクトリにデータの格納された入力フォルダが選択されたときに、サブフォルダまでスキャンします。出力フィーチャクラスは、ディレクトリ構造で検出された各ファイルの行で生成されます。
| Boolean |
extrude_geometry (オプション) |
3D マルチパッチ フィーチャクラスが、各入力ファイルの最小 Z 値と最大 Z 値に基づいて生成されます。
| Boolean |
decimal_separator (オプション) |
ASCII ファイルで使用される区切り記号。デフォルトは小数点です。ファイル内で使用する小数点記号をポイントにするのか、カンマにするのかをユーザが宣言できます。 | String |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Point File Information(ポイント ファイルの空間統計情報)関数を使用する方法を示しています。
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)
次の Python スクリプトは、スタンドアロン スクリプトで Point File Information(ポイント ファイルの空間統計情報)関数を使用する方法を示しています。
'''**************************************************************************** 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)