Rで解析:海流の東西・南北成分を接続性のネットワークに変換する「SeaGraphs」パッケージ
「SeaGraphs」パッケージは、海流のデータを、海域のどこからどこへ流れがつながっているかを表すネットワークに変換できるパッケージです。渡すのは、東西方向(u)と南北方向(v)の流れの成分を格子に並べた2枚のラスター(terraのSpatRaster)で、海域を絞る多角形(sf)を添えることもできます。結果は、流れの向きと強さを重みにした有向グラフ、線の地図データ、隣接行列として受け取れ、そのままleafletの地図にプロットできます。海流で運ばれる幼生や漂流物のつながりを、ネットワーク解析の道具で調べたいときに使えるのではないかと考えます。
パッケージバージョンは0.1.4。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。
<おすすめのRに関する書籍です>
パッケージのインストール
下記コマンドを実行してください。
# パッケージのインストール
install.packages("SeaGraphs")
# パッケージの読み込み
library("SeaGraphs")
Warning message:
package 'SeaGraphs' was built under R version 4.6.2
<おすすめのRに関する書籍です>
コマンド例
詳細はコメント、パッケージのヘルプを確認してください。
海流は、格子の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_shapefile | component_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コマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| result | seagraphコマンドの結果(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コマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| result | seagraphコマンドの結果(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
<おすすめのRに関する書籍です>
この記事が誰かの役に立ちますように。