# 灯りの虫の飛行模型 — 再現資料

論文「背中を光に向ける反射の飛行模型では、高く飛ぶ虫を含む層で灯りの近くに来る虫が灯りと空の明るさの比の約 0.9 乗で増え、月明かりの効果は灯りより上への高さの差に強く左右される」の計算コード・計算結果・図。

Code, raw results and figures for a dorsal-light-response (DLR) flight model of insects around a light trap.

## 中身

| 場所 | 中身 |
|---|---|
| `code/xsec.py` | 流れの計算（遠くから流れてくる虫が灯りの近くに来る面積 σ）。`run(I, B, k, ...)` |
| `code/release.py` | 放す計算（灯りから距離 d で放した虫が戻る割合 P(d)） |
| `code/*.py` | 各節の計算スクリプトと図のスクリプト（`fig_*.py`） |
| `code/history/` | 古い計算に使った版の `xsec.py`・`release.py` |
| `data/*.jsonl` | 計算結果。1 行 1 条件 |
| `figures/` | 図 |
| `manifest.json` | 全ファイルの SHA-256、jsonl ごとの作成コミット、そのとき対応する模型コード |

## 動かし方

Python 3.13、NumPy、Matplotlib（図のみ）。`code/` で実行する。

```bash
cd code
python fscan.py          # 3.2 節: 層の上端を変えた σ（I/B = 64）→ 標準出力に jsonl
python lateral_edge_v.py # 3.2 節: 横の境目と飛ぶ速さ
python xsec.py moonk16   # 3.3 節: 新月と満月の比（k = 16）
python release.py 100 1  # 3.5 節: 放す計算（I = 100、戻る強さ c = 1）
```

図のスクリプトは日本語の字形に Windows の游ゴシック（`/mnt/c/Windows/Fonts/YuGothM.ttc`）を読む。ほかの環境ではその行を手元の日本語フォントに置き換える。

## 節とファイルの対応（主なもの）

| 節 | スクリプト | 結果 |
|---|---|---|
| 3.1 落ちる輪 | `crashdiag.py`、`xsec.py hold` / `bigr` / `bigr10`、`fig_traj.py` | `crashdiag_1109`、`hold_1109`、`bigr_1109`、`bigr10_1109` |
| 3.2 傾き | `rc_total.py`、`rev4_a.py`、`rev4_c.py`、`slope_v.py`、`nearr.py`、`xsec.py hitk` / `think16` / `speed` | `rctotal_1109`、`rev4_a_1109`、`rev4_c_1109`、`slope_v_1109`、`nearr_1109`、`hitk_1109`、`think16_1109`、`speed_1109` |
| 3.2 σ = r*² F(H/r*) | `fscan.py`、`fsmall.py`、`fscan_rel.py`、`fscan_v.py`、`fscan_gain.py`、`fig_F.py`、`fig_sigma.py` | `fscan_1109`、`fsmall_1109`、`fscan_rel_1109`、`fscan_v_1109`、`fscan_gain_1110` |
| 3.2 横の範囲 | `lateral.py`、`lateral2.py`、`lateral_k.py`、`lateral_prof.py`、`lateral_prof_speed.py`、`lateral_edge_v.py`、`lateral_edge_c.py`、`lateral_edge_g.py`、`fig_lateral.py`、`fig_edge_v.py` | `lateral*_1109`、`lateral_edge_*_1110` |
| 3.3 月の比 | `xsec.py moonk16` / `moon`、`ratio_ci.py` | `moonk16_1109`、`moon_1109` |
| 3.4 見通し | `xsec.py occl` / `rcsweep` / `canopy`、`rc_total.py`、`fig_moon.py` | `occl5_1109`、`occl10_1109`、`rcsweep_1109`、`canopy_1109`、`rctotal_1109` |
| 3.5 放す計算 | `release.py`、`xsec.py taxis`、`fig_release.py` | `release_*_1109`、`taxis_1109` |
| 3.6 灯りのそばの制御・高さの帯 | `below.py`、`release_ctl.py`、`release_ctl2.py`、`release_thick.py`、`band.py`、`lampband.py`、`moon_v.py` | `below_1109`、`releasectl_1109`、`releasectl2_1109`、`releasethick_1109`、`band_1109`、`lampband_1109`、`moon_v_1109` |
| 3.7 収束 | `xsec.py conv` / `domain` / `hitconv` / `hitns`、`rev4_a.py`（I/B = 400 の行）、`rev4_b.py`、`rev5_conv.py`、`rev5_x0seeds.py` | `conv_1109`、`domain_1109`、`rev4_a_1109`、`hitconv_1109`、`hitconv96_1109`、`hitns_1109`、`rev4_b_1109`、`rev5_conv_1109`、`rev5_x0seeds_1109` |
| 3.2・3.6 (a) での回し直し | `rerun_a1.py`（種5本）、`rerun_a2.py`（速さの傾き・層の上端）、`rerun_a3.py`（速さの月の比）、`slope_v2.py`（I/B = 16→400 の速さ依存） | `rerun_a1_1110`、`rerun_a2_1110`、`rerun_a3_1110`、`slope_v2_1110` |
| 3.7 (a) の収束（内訳） | `conv_a.py` | `conv_a_A_1110`、`conv_a_B_1110`、`conv_a_C_1110` |
| 3.8 灯り無しの背景と判定の距離 | `background.py`、`bg_adjust.py`、`moon_r.py` | `background_1110`、`bg_adjust_1110`、`moon_r_1110` |
| 3.2 閉じた式（縦の切れ目・横の捕獲半径・面積の近似） | `vband.py`（帯ごと、推力の上限 2g・3g）、`edge_ode.py`・`edge_ode2.py`（準定常の方程式）、`edge_gap.py`、`fig_formula.py` | `vband_1110`、`edge_ode_1110.txt`、`edge_ode2_1110.txt`、`edge_gap_1110` |

`data/` のどの jsonl も、各行に計算の条件（I/B、層、k、速さなど）が入っている。

## 古い結果とコードの版

模型のコードは計算の途中で書き足した（線分での判定、最小距離の記録、灯りのそばの制御、横ずれごとの割合など）。既定の値では前の結果が変わらないように足したが、古い jsonl は古い版で計算した。`manifest.json` の `data` に、jsonl ごとに「その jsonl を足したコミット」と「そのコミット時点の `xsec.py`・`release.py`」（`code/history/` の該当ファイル、いまと同じなら `code/xsec.py`）を書いた。これは jsonl を足したコミット時点のコードで、計算に使ったコードと同じとは限らない。コードの変更を後のコミットで足したことがありうる。

## 出典

模型の考え方は Fabian ら（2024, Nature Communications 15:689）の DLR の模型による。比べた実測は Truxa & Fiedler（2012）と Yela & Holyoak（1997）。
