Rで解析:観測地点の座標から空間モデル用の三角形メッシュを作る「tulpaMesh」パッケージ
「tulpaMesh」パッケージは、観測地点の座標から、空間統計モデル(SPDEモデル)で使う三角形メッシュを作れるパッケージです。渡すのは、x座標とy座標の2列を持つ行列か、座標の列を含むデータフレームで、調査地域の境界を多角形の頂点座標で与えることもできます。メッシュの三角形がどれだけ整っているかを数値で確かめたり、空間モデルの推定に使う有限要素行列を取り出したりもでき、緯度・経度の地点を球面上のメッシュに載せることもできます。外部のソフトを入れずにR単体で動くので、地点データの空間モデルを試す下準備として手軽に使えるのではないかと考えます。
パッケージバージョンは0.1.4。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。
<おすすめのRに関する書籍です>
パッケージのインストール
下記コマンドを実行してください。
# パッケージのインストール
install.packages("tulpaMesh")
# パッケージの読み込み
library("tulpaMesh")
Warning message:
package 'tulpaMesh' was built under R version 4.6.2
<おすすめのRに関する書籍です>
コマンド例
詳細はコメント、パッケージのヘルプを確認してください。
メッシュは、調査地域を小さな三角形で敷き詰めた網目です。観測地点を三角形の頂点に置き、地点のあいだは三角形の上でなめらかにつなぐことで、観測していない場所の値も推定できるようにします。ここでは、宇治茶の産地である宇治市・和束町・宇治田原町・南山城村の茶畑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コマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| coords | x・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_angle | Ruppert法で三角形を細かくするときの最小角度(度)。これより小さい角を持つ三角形の外心に点を足す。理論上の上限は約20.7度で、30度まではたいてい通る。NULLなら細かくしない | NULL |
| max_area | 三角形の面積の上限。これより大きい三角形は角度に関わらず細かくする。NULLなら面積の制約なし | NULL |
| max_steiner | Ruppert法で足す点の数の上限 | 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コマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| mesh | tulpa_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
<おすすめのRに関する書籍です>
メッシュの品質をまとめて表示する:mesh_summaryコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| mesh | tulpa_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コマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| mesh | tulpa_meshオブジェクト | なし |
| obs_coords | 観測地点の座標(N行2列の行列)。NULLなら射影行列Aは単位行列(観測地点=メッシュの頂点) | NULL |
| barrier | 三角形の数と同じ長さの論理値ベクトル。TRUEの三角形は海岸線や川などの障壁として扱い、空間の場がそこを越えてなめらかにつながらないようにする | NULL |
| parallel | TRUEならRcppParallelで並列に組み立てる。三角形が5万個を超えるメッシュで効く | FALSE |
| lumped | TRUEなら質量行列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単位で6371 | 1 |
# 京都市役所・宇治市役所・京丹後市役所付近の経度・緯度
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)
<おすすめのRに関する書籍です>
この記事が誰かの役に立ちますように。