本文へスキップ
からだにいいもの

まだ知らない、役に立つ情報を。ゲーム攻略・R・ガジェット

Rで解析:海流の東西・南北成分を接続性のネットワークに変換する「SeaGraphs」パッケージ

「SeaGraphs」パッケージは、海流のデータを、海域のどこからどこへ流れがつながっているかを表すネットワークに変換できるパッケージです。渡すのは、東西方向(u)と南北方向(v)の流れの成分を格子に並べた2枚のラスター(terraのSpatRaster)で、海域を絞る多角形(sf)を添えることもできます。結果は、流れの向きと強さを重みにした有向グラフ、線の地図データ、隣接行列として受け取れ、そのままleafletの地図にプロットできます。海流で運ばれる幼生や漂流物のつながりを、ネットワーク解析の道具で調べたいときに使えるのではないかと考えます。

パッケージバージョンは0.1.4。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。

パッケージのインストール

下記コマンドを実行してください。

# パッケージのインストール
install.packages("SeaGraphs")

# パッケージの読み込み
library("SeaGraphs")
Warning message:
package 'SeaGraphs' was built under R version 4.6.2

スポンサーリンク

コマンド例

詳細はコメント、パッケージのヘルプを確認してください。

海流は、格子の1マスごとに「東向きにどれだけ」(u成分)と「北向きにどれだけ」(v成分)の2つの値で表します。SeaGraphsは格子の中心を点とし、近くの点どうしを線で結んで、その線に沿った流れの強さを重みにします。流れが逆向きの線は向きを入れ替えるので、結果は流れの向きを持ったネットワークになります。ここでは、宮津湾から天橋立の沖を想定した格子に、湾の中央を時計回りに巡る架空の海流を作ります。

# ラスターと地図データを扱うパッケージの読み込み
library("terra")
terra 1.9.34

library("sf")
Linking to GEOS 3.14.1, GDAL 3.12.1, PROJ 9.7.1; sf_use_s2() is TRUE

# 宮津湾の沖を想定した格子を作成(経度10列×緯度8行)
miyazu <- rast(
  nrows = 8, ncols = 10,
  xmin = 135.15, xmax = 135.35,
  ymin = 35.50, ymax = 35.66,
  crs = "EPSG:4326"
)

# 各マスの中心の経度・緯度を取り出す
xy <- crds(miyazu)

# 東向きの成分u:湾の中央より北で東向き、南で西向き(わずかに東へ流される)
u_miyazu <- miyazu
values(u_miyazu) <- round((xy[, "y"] - 35.58) * 5 + 0.05, 3)

# 北向きの成分v:湾の中央より西で北向き、東で南向き
v_miyazu <- miyazu
values(v_miyazu) <- round(-(xy[, "x"] - 135.25) * 5, 3)

# 天橋立の沖に絞るための範囲(説明用の四角形)
offshore <- st_sf(
  area = "天橋立の沖",
  geometry = st_sfc(st_polygon(list(rbind(
    c(135.17, 35.52), c(135.33, 35.52),
    c(135.33, 35.62), c(135.17, 35.62),
    c(135.17, 35.52)
  ))), crs = 4326)
)

# 2つの成分をプロット
plot(c(u_miyazu, v_miyazu), main = c("u成分(東向き)", "v成分(北向き)"))

2つの成分をプロット

海流を接続性のネットワークに変換:seagraphコマンド

オプション意味初期値
component_u東西方向(横方向)の流れの成分を持つSpatRasterなし
component_v南北方向(縦方向)の流れの成分を持つSpatRasterなし
mask_shapefilecomponent_uとcomponent_vを切り抜く範囲。sfかSpatVector。NULLなら切り抜かないNULL
k_neighbors各点から結ぶ近い点の数(k近傍のk)。正の整数7L

結果は、sfnetwork(有向グラフ)、sf(線の地図データ)、edge_list(起点・終点・重みの表)、adj_mat(隣接行列)、ID_coords(点の番号と座標)の5つを持つリストです。重みは最大値が1になるようにそろえてあります。

# 各点から近い4点と結んでネットワークに変換
miyazu_graph <- seagraph(
  component_u = u_miyazu,
  component_v = v_miyazu,
  k_neighbors = 4L
)

# 結果に含まれる要素の名前を確認
names(miyazu_graph)
[1] "sfnetwork" "sf"        "edge_list" "adj_mat"   "ID_coords"

# 起点・終点・重みの表の先頭を確認
head(miyazu_graph$edge_list)
  from to    weight
1    1  2 0.7542472
2    2  3 0.7542472
3    4  5 0.7542472
4    5  6 0.7542472
5    7  8 0.7542472
6    8  9 0.7542472

# 隣接行列の左上を確認(行が起点、列が終点)
round(miyazu_graph$adj_mat[1:5, 1:5], 3)
  1     2     3     4     5
1 0 0.754 0.754 0.000 0.000
2 0 0.000 0.754 0.000 0.000
3 0 0.000 0.000 0.754 0.000
4 0 0.000 0.000 0.000 0.754
5 0 0.000 0.000 0.000 0.000

# 点の番号と座標を確認
head(miyazu_graph$ID_coords, 3)
  ID      X     Y
1  1 135.16 35.65
2  2 135.18 35.65
3  3 135.20 35.65

# 天橋立の沖の範囲だけでネットワークに変換
offshore_graph <- seagraph(
  component_u = u_miyazu,
  component_v = v_miyazu,
  mask_shapefile = offshore,
  k_neighbors = 4L
)

# 残った点と線の数を確認
nrow(offshore_graph$ID_coords)
[1] 40

nrow(offshore_graph$edge_list)
[1] 92

流れを動く線でプロット:antpath_sfnコマンド

オプション意味初期値
resultseagraphコマンドの結果(SeaGraph)、sfnetwork、またはfrom・to・weightの列を持つsfなし
lowcut重みのパーセンタイルで指定する下限。これより弱い線はプロットしない(任意)NULL
uppcut重みのパーセンタイルで指定する上限。これより強い線はプロットしない(任意)NULL

leafletの地図に、流れの向きに動く線を重ねます。背景の衛星画像はネットから読み込みます。lowcutとuppcutは0から1の割合で指定します。

# 宮津湾の沖の流れを動く線でプロット
antpath_sfn(miyazu_graph)

# 重みが下位半分の弱い線を除いてプロット
antpath_sfn(miyazu_graph, lowcut = 0.5)

流れの強さを色分けしてプロット:flows_sfnコマンド

オプション意味初期値
resultseagraphコマンドの結果(SeaGraph)、sfnetwork、またはfrom・to・weightの列を持つsfなし
lowcut重みのパーセンタイルで指定する下限。これより弱い流れはプロットしない(任意)NULL
uppcut重みのパーセンタイルで指定する上限。これより強い流れはプロットしない(任意)NULL

流れを矢印で示し、強さを黄色から赤の色の濃さで表します。

# 天橋立の沖の流れを色分けしてプロット
flows_sfn(offshore_graph)

# 重みの下位10%と上位10%を除いてプロット
flows_sfn(offshore_graph, lowcut = 0.1, uppcut = 0.9)

見本のu成分を読み込む:get_component_uコマンド

パッケージに入っている見本の海流データ(黒海の沿岸)を読み込みます。オプションはありません。自前のデータを用意するときに、どんな形のラスターを渡せばよいかを確かめるのに使えます。

# 見本のu成分を読み込む
u_sample <- get_component_u()

# 行数・列数・層の数を確認
dim(u_sample)
[1] 13 25  1

# 格子の大きさ(経度方向・緯度方向)を確認
res(u_sample)
[1] 0.03703703 0.02777775

見本のv成分を読み込む:get_component_vコマンド

u成分と同じ格子の、南北方向の成分を読み込みます。オプションはありません。

# 見本のv成分を読み込む
v_sample <- get_component_v()

# 値の分布を確認
summary(values(v_sample)[, 1])
    Min.  1st Qu.   Median     Mean  3rd Qu.     Max.
-0.15873 -0.07890 -0.05048 -0.06001 -0.03554 -0.01509

見本の切り抜き範囲を読み込む:get_mask_shapefileコマンド

seagraphコマンドのmask_shapefileに渡せる、見本の多角形(sf)を読み込みます。オプションはありません。読み込み時にファイルの場所が表示されるので、ここではcapture.outputで表示を止めています。

# 見本の切り抜き範囲を読み込む(読み込み時の表示は出さない)
invisible(capture.output(mask_sample <- get_mask_shapefile()))

# 範囲の経度・緯度を確認
st_bbox(mask_sample)
    xmin     ymin     xmax     ymax
34.43481 43.74194 34.89778 43.92250


この記事が誰かの役に立ちますように。

スポンサーリンク
価格および配送状況は変更される場合があります。購入時は商品ページをご確認ください。
当サイトに表示されている商品情報はAmazonから提供されたものであり、更新または削除される場合があります。
karada-goodはAmazonアソシエイトとして、適格販売により収入を得ています。