create_spatial_lag
書式
create_spatial_lag(table, column, strategy='mean', result_table=None, key_column=None,
weights=None, weights_def=None, save_weights_as=None, spatial_col=None, crs=None)パラメータ
次の表で、この事前定義済関数のパラメータについて説明します。
| パラメータ | 説明 |
|---|---|
table |
空間表の名前。 |
column |
値が空間ラグの計算に使用される対象列。 |
strategy |
空間ラグの計算に使用される戦略。meanと medianの2つの選択肢があります。 |
result_table |
指定した場合、関数oml.createをコールして、指定した名前の表内の空間ラグを含むpandas DataFrameを格納します。
|
key_column |
指定すると、指定した列が結果のDataFrameに追加されます。 それ以外の場合は、DataFrameの索引を持つ列が結果にアタッチされます。
|
weights |
データ・ストアにすでに格納されている空間重みを使用する場合に必要です。 内部的には、関数olm.ds.loadをコールします。 サポートされているパラメータは、それぞれデータ・ストア名とオブジェクト名を示すds_nameおよびobj_nameです。
|
weights_def |
パラメータweightsが定義されていない場合は必須です。 近隣の場所間の関係を確立します。
これは、重み定義のタイプとそのパラメータを指定するjsonオブジェクトとして渡されます。 各パラメータの詳細は、APIリファレンスのドキュメントを参照してください。 サポートされているタイプとパラメータは次のとおりです。
|
save_weights_as |
weights_defが定義されている場合にのみ使用されます。 空間ウェイトをデータ・ストアに格納する方法を指定します。 値は、oml.ds.saveのパラメータを決定するjsonファイルです。 サポートされているパラメータは、[ds_name, obj_name, overwrite_ds, append, overwrite_obj, grantable, compression]です。 一部のパラメータ名は、oml.ds.save関数のパラメータ名と若干異なります。 パラメータoverwrite_objは、既存のオブジェクトを現在のオブジェクトで置き換える必要があるかどうかを示すために使用されます。
|
spatial_col |
ジオメトリを含む列を指定します。 列は表のメタデータで指定できます。 指定しない場合、列名は表から取得されます。 |
crs |
座標参照システムを指定します。 指定しない場合、表から推測されます。 |
例
次のコードでは、特定の列の空間ラグを指定された空間重みに従って計算します。 各行について、隣接するロケーションから特定の列の平均値が計算されます。 データストアのmedian_income列および空間重みを使用します。
select *
from table(
pyqEval(
'{
"oml_connect": true,
"table": "oml_user.la_block_groups",
"key_column": "geoid",
"column": "median_income",
"weights": {"ds_name":"spatial", "obj_name": "la_bg_knn4"}
}',
'{ "geoid": "VARCHAR2(50)", "MEDIAN_INCOME_SLAG": "NUMBER" }',
'create_spatial_lag'
)
);結果には、各行の近隣のロケーションからの平均収入が含まれます。 索引は、key_columnパラメータ(この場合はgeoid列)から取得されることに注意してください。
