3D フィーチャクラス → ASCII (Feature Class Z To ASCII)—ヘルプ

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

サマリ

ジェネレート、XYZ、またはプロファイルデータを格納する ASCII テキストファイルに 3D フィーチャをエクスポートします。

使用法

プロファイル形式は、特殊なグラフアプリケーションにインポートできる 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 とパート番号がこの順序で付加されます。
ジェネレート形式は、ヘッダー行をサポートしていませんが、すべての入力フィーチャを 1 つのファイルに格納します。
- ポイントフィーチャはそれぞれの ID および XYZ 座標とともに格納され、END キーワードは最後の行を示します。
```
id₁ x₁ y₁ z₁id₂ x₂ y₂ z₂id₃ x₃ y₃ z₃id₄ x₄ y₄ z₄END
```
  注意:
  元のフィーチャクラス内の同一レコードから生成されたマルチポイントフィーチャは同じ ID を共有します。
- ラインおよびポリゴンフィーチャは END キーワードによって区切られ、END キーワードが 2 つ連続していればファイルの末尾であることを示します。
```
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 形式はファイルにつき 1 つのラインまたはポリゴンのみをサポートするため、各フィーチャに一意のファイル出力が割り当てられます。マルチパートフィーチャの各パートも個別のファイルに書き出されます。このファイル名には各フィーチャの OID と、各ファイル名を一意にするために必要な追加の文字が付加されます。	String
format (オプション)	ASCII ファイルの作成形式 GENERATE —ジェネレート形式で出力を書き出します。これがデフォルトです。 XYZ —入力フィーチャの XYZ 情報を書き出します。入力フィーチャの 1 つのラインまたはポリゴンに対して 1 つのファイルが作成されます。 PROFILE —外部グラフアプリケーションで使用できるラインフィーチャの断面図情報を書き出します。	String
delimiter (オプション)	テキストファイルテーブルの列内のエントリの区切りを示すための区切り文字。 SPACE —フィールド値の区切りにスペースを使用します。これがデフォルトです。 COMMA —フィールド値の区切りにカンマを使用します。小数点の記号がカンマの場合、このオプションは適用されません。	String
decimal_format (オプション)	出力ファイルに格納される有効桁数を決定する方法。 AUTOMATIC —不要な末尾のゼロを削除して、使用可能な精度を維持するのに必要な有効桁数が自動的に決定されます。これがデフォルトです。 FIXED —有効桁数を [小数点より後の桁数] パラメーターで定義します。	String
digits_after_decimal (オプション)	[10 進表記] が FIXED に設定されているときに使用されます。これによって、出力ファイルに書き込まれる浮動小数点値の小数点以下の桁数が決定します。	Long
decimal_separator (オプション)	整数部と小数部を区別するために使用される小数記号。 DECIMAL_POINT —点が小数記号として使用されます。これがデフォルトです。 DECIMAL_COMMA —カンマが小数記号として使用されます。	String

コードのサンプル

FeatureClassZToASCII (3D フィーチャクラス → ASCII) の例 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 (3D フィーチャクラス → ASCII) の例 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)

環境

ライセンス情報

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

サマリ

使用法

構文

コードのサンプル

FeatureClassZToASCII (3D フィーチャクラス → ASCII) の例 1 (Python ウィンドウ)

FeatureClassZToASCII (3D フィーチャクラス → ASCII) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

FeatureClassZToASCII (3D フィーチャクラス → ASCII) の例 2 (スタンドアロンスクリプト)