ラベル | 説明 | データ タイプ |
入力フィーチャ |
バッファーを作成する入力のポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。 | Feature Layer |
出力フィーチャクラス |
出力バッファーを格納するフィーチャクラス。 | Feature Class |
バッファーの距離 [値またはフィールド] |
バッファー処理する入力フィーチャの周囲の距離。 距離は、直線距離を表す値か、各フィーチャをバッファー処理する距離を含む入力フィーチャのフィールドのいずれかとして指定できます。 距離の単位が指定されないか、不明と入力された場合、入力フィーチャの空間参照の距離単位が使用されます。 | Linear Unit; Field |
キャップの種類 (オプション) | バッファー処理される入力フィーチャのキャップ (端点) のタイプを指定します。 このパラメーターは、ポイント フィーチャとポリゴン フィーチャでのみサポートされています。
| String |
結合の種類 (オプション) | 2 つのセグメントが結合するコーナーのバッファーの形状を指定します。 このパラメーターは、ライン フィーチャとポリゴン フィーチャでのみサポートされています。
| String |
直角制限 (オプション) | ライン セグメントが鋭角に交差し、[結合の種類] パラメーター値に [直角] が指定されている場合、このパラメーターを使用して、バッファー出力で、どの程度鋭角なコーナーがポイントに発生するかを制御できます。 [直角] オプションを使用した場合、2 本のラインが結合する位置の外角が極めて大きくなることがあります。 これによって、コーナーのポイントが、意図したよりも長く伸びる場合があります。 | Double |
最大オフセット偏差 (オプション) |
出力バッファー境界が、トゥルー バッファー境界から乖離する最大距離。 トゥルー バッファー境界は曲線ですが、出力境界は密集化されます。 このパラメーターを使用し、出力ポリゴン境界がトゥルー バッファー境界に近似する程度を制御できます。 このパラメーターが設定されていない場合や 0 に設定されている場合、ツールによって最大偏差が特定されます。 デフォルトの値を使用することをおすすめします。 最大オフセット偏差が小さすぎる場合、ツールやそれ以降の解析においてパフォーマンスが低下する可能性があります。 | Linear Unit |
サマリー
指定した距離に基づき、入力フィーチャの周囲にバッファー ポリゴンを作成します。 フィーチャの周囲にバッファーを生成するとき、バッファーの端点 (キャップ) とコーナー (結合) には、さまざまなカートグラフィック形状が利用できます。
バッファー操作には、代替ツールが利用できます。 詳細については、[ペアワイズ バッファー (Pairwise Buffer)] および [バッファー (Buffer)] ツールのドキュメントをご参照ください。
図
使用法
入力フィーチャとして、ポイント、ライン、またはポリゴンを指定できます。
[キャップ タイプ] パラメーターはライン端点の形状を制御し、[結合タイプ] パラメーターはコーナーの形状を制御します。 [丸]、[斜角]、または [直角] 結合オプションと [丸]、[バット]、または [四角] キャップ オプションを使用し、出力バッファーの形状を変更します。
端点 (キャップ) とコーナー (結合) に使用できるパラメーターは、次のように入力フィーチャ タイプによって異なります。
- [キャップ タイプ] - ポイントとラインのみ
- [結合タイプ] - ポリゴンとラインのみ
「キャップ」と「結合」という用語は、グラフィックスで使用される一般的な用語です。
ツールの図では、異なる [キャップ タイプ] や [結合タイプ] パラメーター オプションを使用してバッファーを適用したポリライン フィーチャを示します。
出力フィーチャクラスの BUFF_DIST フィールドには、各フィーチャのバッファー処理に使用するバッファー距離が、入力フィーチャの座標系の距離単位で格納されます。
入力に BUFF_DIST というフィールドが存在する場合、そのフィールドの値は出力で上書きされます。
出力バッファー フィーチャは、常にユークリッドです。 測地線バッファー フィーチャはサポートされていません。 ユークリッドと測地線バッファーの違いについては、「バッファー (Buffer) の詳細 (解析)」をご参照ください。
出力フィーチャクラスの ORIG_FID フィールドには、バッファーが作成された入力フィーチャのフィーチャ ID が格納されます。 入力に ORIG_FID というフィールドが存在する場合、そのフィールドの値は出力で上書きされます。
ポリゴン フィーチャをバッファー処理する際には、負数のバッファー距離を使用してポリゴン フィーチャ内部にバッファーを作成することができます。 負数のバッファー距離を使用すると、ポリゴンの境界を指定距離分減らすことができます。
注意:
負数のバッファー距離が大きすぎてポリゴンが消失する場合は、NULL ジオメトリが生成されます。 警告メッセージが表示され、NULL ジオメトリのフィーチャは出力フィーチャクラスに書き出されません。
入力のフィールドを使用してバッファー距離を設定できます。 数値フィールドとテキスト フィールドを使用できます。 テキスト フィールドには、バッファー距離として 5 などの数字や、5 kilometers のような有効な距離単位を格納できます。
距離単位のない数値を使用すると、バッファーの単位は、入力の空間参照の距離単位になります。 入力が地理座標系の場合、バッファーの単位はメートルになります。
距離単位を認識できない場合、バッファーの単位は、入力の空間参照の距離単位になります。 有効な距離単位については「距離単位」をご参照ください。
このツールは、並列処理ファクター環境を優先します。 この環境が設定されていない場合 (デフォルト) や 100 に設定されている場合、フル並列処理が有効になり、ツールはコンピューター上のすべての論理コアに作業を分配しようとします。 この環境を 0 に設定した場合、並列処理は有効になりません。 ファクターを 1 ~ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を特定します。 この数式の結果が 0 または 1 の場合、並列処理は有効化されません。
注意:
バッファー操作の出力を使用して特定のエリア内のフィーチャを特定する場合は、一般的に [ペアワイズ バッファー (Pairwise Buffer)] と [バッファー (Buffer)] ツールが最も適しています。
パラメーター
arcpy.analysis.GraphicBuffer(in_features, out_feature_class, buffer_distance_or_field, {line_caps}, {line_joins}, {miter_limit}, {max_deviation})
名前 | 説明 | データ タイプ |
in_features |
バッファーを作成する入力のポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。 | Feature Layer |
out_feature_class |
出力バッファーを格納するフィーチャクラス。 | Feature Class |
buffer_distance_or_field |
バッファー処理する入力フィーチャの周囲の距離。 距離は、直線距離を表す値か、各フィーチャをバッファー処理する距離を含む入力フィーチャのフィールドのいずれかとして指定できます。 距離の単位が指定されないか、不明と入力された場合、入力フィーチャの空間参照の距離単位が使用されます。 スクリプト内で距離を指定する際、距離の単位が「Decimal Degrees」のように 2 つの単語に分かれている場合は、「20 DecimalDegrees」のように 1 つに結合します。 | Linear Unit; Field |
line_caps (オプション) | バッファー処理される入力フィーチャのキャップ (端点) のタイプを指定します。 このパラメーターは、ポイント フィーチャとポリゴン フィーチャでのみサポートされています。
| String |
line_joins (オプション) | 2 つのセグメントが結合するコーナーのバッファーの形状を指定します。 このパラメーターは、ライン フィーチャとポリゴン フィーチャでのみサポートされています。
| String |
miter_limit (オプション) | ライン セグメントが鋭角に交差し、line_joins パラメーターに MITER が指定されている場合、このパラメーターを使用して、バッファー出力で、どの程度鋭角なコーナーがポイントに発生するかを制御できます。 MITER オプションを使用した場合、2 本のラインが結合する位置の外角が極めて大きくなることがあります。 これによって、コーナーのポイントが、意図したよりも長く伸びる場合があります。 | Double |
max_deviation (オプション) |
出力バッファー境界が、トゥルー バッファー境界から乖離する最大距離。 トゥルー バッファー境界は曲線ですが、出力境界は密集化されます。 このパラメーターを使用し、出力ポリゴン境界がトゥルー バッファー境界に近似する程度を制御できます。 このパラメーターが設定されていない場合や 0 に設定されている場合、ツールによって最大偏差が特定されます。 デフォルトの値を使用することをおすすめします。 最大オフセット偏差が小さすぎる場合、ツールやそれ以降の解析においてパフォーマンスが低下する可能性があります。 | Linear Unit |
コードのサンプル
次の Python ウィンドウ スクリプトは、GraphicBuffer 関数の使用方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.GraphicBuffer("roads", "C:/output/majorrdsBuffered", "100 Feet",
"SQUARE", "MITER")
環境
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes