three_flood_mesh とは
Section titled “three_flood_mesh とは”@navaramap/three-flood-mesh は、洪水や津波のシミュレーション結果のように時間とともに変化する水面を、Navara の 3D 地球儀上に描画します。次のものを提供します。
TimeSeriesFloodMeshDesc: Zarr ストアから読んだ水面の高さの時系列を再生するメッシュ Descriptor。Navara の水として描くか、浸水深や流速のようなプロパティで色分けします。- 時系列の関数: 時系列を読み込む
loadTimeSeriesFlood、地点の水を読むsampleTimeSeriesFlood、時刻とフレームを相互に変換するtimeToFrame/frameToTime。 - 変換関数: シミュレーションの出力(CSV、netCDF、CZML)から Zarr グループを書き出す
@navaramap/three-flood-mesh/convertエントリーとnavara-flood-zarrコマンド。
動作は サンプル で確認できます。
インストール
Section titled “インストール”@navaramap/three-flood-mesh は nightly ビルド でのみ公開されています。同じ nightly ビルドの @navaramap/three が必要なので、両方を nightly dist-tag からインストールします。
npm install @navaramap/three@nightly @navaramap/three-flood-mesh@nightlyクイックスタート
Section titled “クイックスタート”import ThreeView from "@navaramap/three";import { TimeSeriesFloodMeshDesc } from "@navaramap/three-flood-mesh";
const view = new ThreeView({ animation: true });await view.init();view.registerMesh("timeSeriesFlood", TimeSeriesFloodMeshDesc);
const water = view.addMesh<TimeSeriesFloodMeshDesc>({ timeSeriesFlood: { url: "https://example.com/flood.zarr", frame: 0 },});再生、色分け、読み込みのレシピは 使用例 を参照してください。
他のパッケージとの関係
Section titled “他のパッケージとの関係”@navaramap/three (core: ThreeView, MeshDesc) └── @navaramap/three-flood-mesh ├── TimeSeriesFloodMeshDesc, loadTimeSeriesFlood (browser entry) └── convertRasters, convertMesh, convertPolygons (/convert entry, browsers and Node)/convert エントリーと navara-flood-zarr コマンドは、three も @navaramap/three も必要ありません。
AI コーディングエージェントとの開発
Section titled “AI コーディングエージェントとの開発”このパッケージには、Claude Code などの AI コーディングエージェント向けの navara-flood-mesh スキル が同梱されています。入力の確認、変換関数の選択と設定ファイルの作成、レポートの読み方、Zarr グループの配信、TimeSeriesFloodMeshDesc での再生と色分けまで、シミュレーション結果からビューアーまでの手順をエージェントに示します。シーンのそれ以外の部分は @navaramap/three の navara-usage スキルに従います(AI コーディングエージェントとの開発を参照)。
pnpm 12.11 以降では、インストール後に pnpm approve を実行すると、プロジェクトのエージェント用 skills ディレクトリ(.claude/skills など)にスキルがリンクされます。他のパッケージマネージャーでは、node_modules/@navaramap/three-flood-mesh/skills/navara-flood-mesh をそこにコピーしてください。