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

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

Rで解析:観測地点の座標から空間モデル用の三角形メッシュを作る「tulpaMesh」パッケージ

「tulpaMesh」パッケージは、観測地点の座標から、空間統計モデル(SPDEモデル)で使う三角形メッシュを作れるパッケージです。渡すのは、x座標とy座標の2列を持つ行列か、座標の列を含むデータフレームで、調査地域の境界を多角形の頂点座標で与えることもできます。メッシュの三角形がどれだけ整っているかを数値で確かめたり、空間モデルの推定に使う有限要素行列を取り出したりもでき、緯度・経度の地点を球面上のメッシュに載せることもできます。外部のソフトを入れずにR単体で動くので、地点データの空間モデルを試す下準備として手軽に使えるのではないかと考えます。

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

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

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

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

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

スポンサーリンク

コマンド例

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

メッシュは、調査地域を小さな三角形で敷き詰めた網目です。観測地点を三角形の頂点に置き、地点のあいだは三角形の上でなめらかにつなぐことで、観測していない場所の値も推定できるようにします。ここでは、宇治茶の産地である宇治市・和束町・宇治田原町・南山城村の茶畑40か所で、茶葉の香気スコアを測った架空のデータを作ります。説明のために経度・緯度をそのまま座標として使いますが、実際の解析では距離がそろう投影座標に直してから渡してください。

# 茶畑40か所の観測地点(経度・緯度)と香気スコアの架空データを作る
set.seed(1024)
chabatake <- data.frame(
  chiku = rep(c("宇治市", "和束町", "宇治田原町", "南山城村"), each = 10),
  x = c(
    runif(10, 135.78, 135.83), runif(10, 135.88, 135.93),
    runif(10, 135.93, 135.98), runif(10, 136.00, 136.05)
  ),
  y = c(
    runif(10, 34.87, 34.91), runif(10, 34.78, 34.82),
    runif(10, 34.83, 34.87), runif(10, 34.75, 34.79)
  ),
  kaori = round(rnorm(40, mean = 70, sd = 8), 1)
)

# 先頭の6行を確認
head(chabatake)
   chiku        x        y kaori
1 宇治市 135.7909 34.88453  68.8
2 宇治市 135.8294 34.90478  79.8
3 宇治市 135.7974 34.90159  64.6
4 宇治市 135.7991 34.90626  60.3
5 宇治市 135.7810 34.90783  78.2
6 宇治市 135.8175 34.87315  74.8

観測地点から三角形メッシュを作る:tulpa_meshコマンド

オプション意味初期値
coordsx・y列を持つ行列かデータフレーム、またはdataの中で評価する ~ x + y の形の式なし
data式を評価するデータフレームNULL
boundary境界の指定。境界の頂点座標の行列(N行2列)かsfの多角形。NULLなら観測地点の凸包NULL
max_edge辺の長さの上限。1つの値か c(内側, 外側) の2つの値。内側は調査地域(境界、または観測地点の凸包)の中の格子の間隔、外側は外周の拡張部分の格子の間隔と境界の辺の長さ。1つの値なら両方に使うNULL
cutoff頂点どうしの最小距離。これより近い地点はまとめる。0ならまとめない0
extend観測地点の凸包の外側に足す拡張部分の幅。地域の差し渡し(2地点間の最大距離)に対する割合で指定。0なら拡張しない。boundaryを与えたときは使わない0.1
min_angleRuppert法で三角形を細かくするときの最小角度(度)。これより小さい角を持つ三角形の外心に点を足す。理論上の上限は約20.7度で、30度まではたいてい通る。NULLなら細かくしないNULL
max_area三角形の面積の上限。これより大きい三角形は角度に関わらず細かくする。NULLなら面積の制約なしNULL
max_steinerRuppert法で足す点の数の上限10000L
# 観測地点から初期値のままメッシュを作る
mesh <- tulpa_mesh(~ x + y, data = chabatake)

# 頂点・三角形・辺の数を確認
mesh
tulpa_mesh:
  Vertices:   75
  Triangles:  113
  Edges:      187
  ( 40  input + 35  generated)

# 辺の長さの上限(内側0.02、外側0.05)と最小角度25度を指定して細かいメッシュを作る
mesh_fine <- tulpa_mesh(~ x + y,
  data = chabatake,
  max_edge = c(0.02, 0.05), min_angle = 25
)
mesh_fine
tulpa_mesh:
  Vertices:   206
  Triangles:  344
  Edges:      549
  ( 40  input + 166  generated)

# メッシュをプロット
plot(mesh_fine)

メッシュをプロット

三角形ごとの形の良さを数値で出す:mesh_qualityコマンド

オプション意味初期値
meshtulpa_meshオブジェクトなし

三角形ごとに最小角(min_angle)、最大角(max_angle)、縦横比(aspect_ratio)、面積(area)をデータフレームで返します。細長い三角形(最小角が小さく、縦横比が大きい物)が少ないほど、空間モデルの推定が安定します。

# 細かいメッシュの三角形ごとの品質を計算
q <- mesh_quality(mesh_fine)

# 最小角と縦横比を要約
summary(q[, c("min_angle", "aspect_ratio")])
   min_angle      aspect_ratio
 Min.   :25.71   Min.   :1.000
 1st Qu.:32.21   1st Qu.:1.196
 Median :39.73   Median :1.541
 Mean   :41.69   Mean   :1.533
 3rd Qu.:51.19   3rd Qu.:1.818
 Max.   :60.00   Max.   :2.294

メッシュの品質をまとめて表示する:mesh_summaryコマンド

オプション意味初期値
meshtulpa_meshオブジェクトなし
# 三角形の数と、角度・縦横比・面積の最小/中央値/最大を表示
mesh_summary(mesh_fine)
Mesh quality summary:
  Triangles:      344
  Min angle:      25.7 / 39.7 / 60.0 (min / median / max)
  Max angle:      60.0 / 76.9 / 122.6
  Aspect ratio:   1.00 / 1.54 / 2.29
  Area:           0.0000 / 0.0001 / 0.0008

空間モデルに渡す有限要素行列を作る:fem_matricesコマンド

オプション意味初期値
meshtulpa_meshオブジェクトなし
obs_coords観測地点の座標(N行2列の行列)。NULLなら射影行列Aは単位行列(観測地点=メッシュの頂点)NULL
barrier三角形の数と同じ長さの論理値ベクトル。TRUEの三角形は海岸線や川などの障壁として扱い、空間の場がそこを越えてなめらかにつながらないようにするNULL
parallelTRUEならRcppParallelで並列に組み立てる。三角形が5万個を超えるメッシュで効くFALSE
lumpedTRUEなら質量行列Cに加えて、対角の集中質量行列C0(頂点ごとの面積)も返すFALSE

質量行列C、剛性行列G、観測地点からメッシュの頂点への射影行列A、頂点の数n_meshをリストで返します。SPDEモデルの精度行列はCとGから組み立て、Aで観測値とつなぎます。

# 茶畑の観測地点を射影行列に入れて有限要素行列を作る
fem <- fem_matrices(mesh_fine,
  obs_coords = as.matrix(chabatake[, c("x", "y")])
)

# 返ってくる要素の名前
names(fem)
[1] "C"      "G"      "A"      "n_mesh"

# 射影行列の大きさ(観測地点の数 × メッシュの頂点の数)
dim(fem$A)
[1]  40 206

球面上の三角形メッシュを作る:tulpa_mesh_sphereコマンド

オプション意味初期値
subdivisions正二十面体を再帰的に分割する回数。1段ごとに三角形が4倍になる(0で20個、1で80個、2で320個、3で1280個、4で5120個、5で20480個)3L
coordsメッシュに入れる経度・緯度(度)の行列。球面に射影し、頂点として足すNULL
radius球の半径。1なら単位球。地球ならkm単位で63711
# 京都市役所・宇治市役所・京丹後市役所付近の経度・緯度
kyoto_pt <- cbind(c(135.77, 135.80, 135.13), c(35.01, 34.89, 35.57))

# 地球の半径(km)の球に、2回分割したメッシュを作って3地点を足す
sphere <- tulpa_mesh_sphere(
  subdivisions = 2, coords = kyoto_pt,
  radius = 6371
)
sphere
tulpa_mesh (sphere, radius = 6371 ):
  Vertices:   165
  Triangles:  320
  Edges:      480
  ( 3  input + 162  generated)


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

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