# 電験 学習用モデル・教材集

過去のChatGPT会話で作成した教材のうち、電験の学習に使えるものを [`yamaryosan/3d-model-archive`](https://github.com/yamaryosan/3d-model-archive) から分離したリポジトリです（2026-11-02 分離）。電験と関係のない一般的なモデル（天文・機械・材料など）は元のリポジトリに残しています。

## 収録数
- **17テーマ：3D・立体図解 9件／2D対話型教材 7件／GIF 1件。主要HTML 19ファイル・GLB 3ファイル・ソースZIP 3ファイル。**
- 科目別：理論 2件、電力 5件、機械 9件、法規 1件。科目の割り当ては主な出題分野の目安です。
- アーカイブを含む全チャットの完全な走査ではなく、**回収できた保存ファイルに基づく一覧**です。学術的な正確性や試験範囲との完全な対応を保証するものではありません。

## 閲覧方法

公開サイト：<https://denken-models.pages.dev/>（Cloudflare Pages。`main` ブランチへのpushで自動デプロイ）

手元で見る場合：

トップページ [`index.html`](index.html) から作品を選びます。多くはHTMLを直接ブラウザで開けますが、ブラウザ仕様やCDN依存によりローカルサーバーが必要になる場合があります。

```bash
python3 -m http.server 8000
```

ブラウザで `http://localhost:8000/` にアクセスします。

## 作品一覧

| 日付（JST） | 科目 | 出題分野 | 種別 | 作品 | 入口 |
|---|---|---|---|---|---|
| 2026-09-23 | 理論 | Y・Δ結線、相電圧・線間電圧 | 2D・対話型 | 三相交流（Y・Δ結線） | [three_phase_lab.html](labs/elec-three-phase/three_phase_lab.html) |
| 2026-10-20 | 理論 | 電子理論（半導体素子） | 2D・対話型 | nチャネルMOSFET | [mosfet_interactive.html](labs/elec-mosfet/mosfet_interactive.html) |
| 2026-07-04 | 電力 | 変電・遮断器 | GIF | SF6ガス遮断器のアニメーション | [sf6_circuit_breaker_animation.gif](animations/elec-sf6-breaker/sf6_circuit_breaker_animation.gif) |
| 2026-08-15 | 電力 | 電線・ケーブルの交流抵抗 | 3D・立体図解 | 表皮効果 | [skin_effect_3d_model_v3.html](models/elec-skin-effect/skin_effect_3d_model_v3.html) |
| 2026-09-22 | 電力 | 水力発電・水車／発電機の軸形式 | 3D・立体図解 | 立軸・横軸 | [shaft_orientation_3d.html](models/mech-shaft-orientation/shaft_orientation_3d.html) |
| 2026-10-12 | 電力 | 送配電・調相（分路リアクトル） | 2D・対話型 | フェランチ効果 | [ferranti_phasor_lab.html](labs/elec-ferranti-effect/ferranti_phasor_lab.html) |
| 2026-10-30 | 電力 | 水力発電・水車の比速度 | 3D・立体図解 | 水車の比速度 | [ぐる3D_水車の比速度.html](models/hydro-turbine-specific-speed/%E3%81%90%E3%82%8B3D_%E6%B0%B4%E8%BB%8A%E3%81%AE%E6%AF%94%E9%80%9F%E5%BA%A6.html) |
| 2026-08-23 | 機械 | パワーエレクトロニクス（サイリスタ位相制御） | 2D・対話型 | 単相全制御サイリスタブリッジの点弧角 | [thyristor_bridge_alpha_slider.html](labs/elec-thyristor-bridge/thyristor_bridge_alpha_slider.html) |
| 2026-09-20 | 機械 | 誘導機の原理 | 3D・立体図解 | アラゴの円板と誘導電動機 | [arago_3d.html](models/elec-arago-disc/arago_3d.html) |
| 2026-09-20 | 機械 | 誘導機・同期機の回転磁界 | 3D・立体図解 | 回転磁界 | [rotating_magnetic_field_3d.html](models/elec-rotating-field/rotating_magnetic_field_3d.html) |
| 2026-09-22 | 機械 | 同期機・電機子反作用 | 3D・立体図解 | 同期発電機の電機子反作用 | [armature_reaction_3d.html](models/elec-armature-reaction/armature_reaction_3d.html) |
| 2026-09-30 | 機械 | 同期機・制動巻線 | 3D・立体図解 | 制動巻線 | [damper_winding_3d.html](models/elec-damper-winding/damper_winding_3d.html) |
| 2026-10-01 | 機械 | パワーエレクトロニクス（整流回路） | 2D・対話型 | 単相ブリッジ整流 | [single_phase_bridge_rectifier.html](labs/elec-single-phase-bridge/single_phase_bridge_rectifier.html) |
| 2026-10-02 | 機械 | パワーエレクトロニクス（チョッパ） | 2D・対話型 | チョッパ回路 | [chopper_lab.html](labs/elec-chopper/chopper_lab.html) |
| 2026-10-02 | 機械 | 自動制御・シーケンス制御 | 3D・立体図解 | リレーシーケンス | [relay_sequence_3d.html](models/elec-relay-sequence/relay_sequence_3d.html) |
| 2026-10-02 | 機械 | パワーエレクトロニクス（インバータ） | 2D・対話型 | 単相ブリッジインバータ | [single_phase_inverter.html](labs/elec-single-phase-inverter/single_phase_inverter.html) |
| 2026-10-04 | 法規 | 電技解釈・離隔距離（第1次・第2次接近状態） | 3D・立体図解 | 架空電線と建物の接近 | [power-line-approach-3d.html](models/elec-power-line-approach/power-line-approach-3d.html) |

## 元パッケージとソースコード

ZIPにしかなかった元データと開発ソースも回収しています。ZIPの名前を変えずに `source-packages/` に保存し、内部のファイルを作品のディレクトリへ展開しています。

| 作品 | 元のZIP | 展開内容 |
|---|---|---|
| フェランチ効果 | [`ferranti_phasor_lab_package.zip`](source-packages/ferranti_phasor_lab_package.zip) | HTMLは既存版とバイト一致、同梱のREADMEを作品ディレクトリに保存。 |
| アラゴの円板 | [`arago_3d_package.zip`](source-packages/arago_3d_package.zip) | [`arago_disk.glb`](models/elec-arago-disc/models/arago_disk.glb)、[`induction_motor.glb`](models/elec-arago-disc/models/induction_motor.glb)、パッケージREADME。HTMLは既存版とバイト一致。 |
| チョッパ回路 | [`chopper_lab.zip`](source-packages/chopper_lab.zip) | [`source/`](labs/elec-chopper/source/) にJS・CSS・テスト・ビルドスクリプトなどを展開。HTMLは既存版とバイト一致。 |

## Gitで管理する

GitHub の非公開リポジトリ [`yamaryosan/denken-models`](https://github.com/yamaryosan/denken-models) で管理しています。

```bash
git clone https://github.com/yamaryosan/denken-models.git
cd denken-models
python3 -m http.server 8000   # → http://localhost:8000/
```

既に手元にある場合は `git pull` で最新にできます。

新しい作品を追加するときは:

1. 3D・擬似3Dは `models/<分類>-<テーマ>/`、2Dの対話型教材は `labs/<分類>-<テーマ>/`、アニメーションは `animations/` に置く。改訂版は上書きせず `_v2` などで並べる。
2. ページの見出しの上に「目次に戻る」リンクを入れる。既存ページの `archive-back-link` というコメントが付いた `<style>` と `<a>` をそのまま写せばよい（リンク先は `../../index.html`）。
3. `manifest.json`・`CATALOG.csv`・`index.html`・このREADMEの作品一覧に追記し、`python3 scripts/verify_manifest.py --update` でサイズとSHA-256を記録する。
4. `git add` → `git commit` → `git push`。`main` へのpushで公開サイトも自動で更新されます。

`.gitattributes` で改行コードの自動変換を無効にしているため、元ファイルの内容（`CATALOG.csv` のCRLFなど）はそのまま保存されます。

## データの性質と注意点

- `models/` には本当のWebGL 3DだけでなくCanvasによる擬似3D教材（表皮効果など）も含みます。
- `labs/` は電気回路や波形などの主として2Dの対話型教材です。
- `animations/` のSF6ガス遮断器はGIFだけが確認され、編集可能なアニメーション原版は含まれていません。
- GLBファイルはブラウザ用HTMLと別に使う形状データであり、HTMLが必ずそれらのGLBをロードするという意味ではありません。
- 各教材は説明用のモデルです。数値や法令の規定（離隔距離など）は、最新の電気設備技術基準・解釈や参考書で必ず確認してください。
- 依存関係、動作安全性、外部素材の権利をすべて確認したわけではありません。公開リポジトリにする前に確認してください。
- 著作権ライセンスを明示的に決めてもらっていないため、LICENSEファイルは追加していません。

## 検証結果

- 収録ファイルは、ChatGPT版アーカイブからバイト単位で無変更のまま移しました。その原本はコミット `01da070` に残っています（`git show 01da070:<パス>` で取り出せます）。
- 2026-11-03、全作品HTML（19本）の見出しの上に「← 目次に戻る」リンクを追加しました（3d-model-archive と同じ部品）。幅1280px・390pxで、リンクがほかの部品に重ならないこと、横スクロールが出ないこと、押すと `index.html` に戻ることを確認しました。これ以降、作品HTMLは必要に応じて直接書き換えます。
- 2026-11-02、全HTMLと入口ページをローカルHTTPサーバー経由でChromium（Playwright）で開き、JSエラーなしで描画されること、ボタン・タブ操作と3D視点のドラッグ操作でエラーが出ないことを確認しました。Three.jsなどをCDNから読み込む2作品（水車の比速度・架空電線と建物の接近）は、ネット接続のある実ブラウザ（Chrome）で操作確認しました。
- `labs/elec-chopper/source/tests/model.test.js` は Node.js 22.16.0 で **27件成功**しました（ChatGPT側での実行結果）。
- GLB 3ファイルのglTF 2.0構造と、SF6 GIFの56フレームを確認しました。

## 完全性確認

`manifest.json` に収録ファイルのパス・サイズ・SHA-256を記載しています。以下でファイルが欠損・改変していないか検証できます。

```bash
python3 scripts/verify_manifest.py
```