この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Plotly.jsの公式情報を参照し、固定版とライセンスを同梱した静的Web教材を制作しました。検証ステータス:🧪 計算ロジックは確認済み、ブラウザー表示は未確認
GitHubにあるlogic.mjsの純粋関数をV8隔離環境で確認しました。GitHub Pagesの実到達と操作、WordPress表示は今回未確認です。
Plotly.jsで3D曲面を操作する:高さ倍率と25格子点の可視化
5×5の架空の格子から3D曲面を作り、マウスによる視点変更と、高さ倍率を1〜3へ動かす操作を学びます。
静的サイトでも動きのあるJavaScript教材を実現できます。ただし、第三者ライブラリを使うことと、実際の業務システムに導入できることは別です。まず画面操作で結果の変化を確かめ、仕組みと検証条件を理解しましょう。
まず動かす
Plotly.jsのライブデモ(公開URL到達・実ブラウザー操作は未確認)
倍率1の最大高さは16、倍率3では48になります。どちらもXとYの5×5、合計25格子点であり、倍率を変更しても測定件数が増えたわけではありません。視点を回して見た目が変わることも、元データの変更とは区別してください。
初期の入力から条件を1つだけ変えて、元のデータが変わったのか、表示する条件だけが変わったのかを意識してください。操作を戻して期待結果が復元するかも確認します。特にグラフや図は見た目の変化が目立つため、数字での結果確認も重要です。
何が使われているのか
| 項目 | 内容 |
|---|---|
| ライブラリ | Plotly.js 3.1.0 |
| 配信 | GitHub Pagesの静的HTML/CSS/JavaScript |
| ライセンス | MIT(ライセンス全文をvendorに同梱) |
| コードの取得 | 公式GitHubの版を固定。実行時CDNなし |
| データ | 架空の値のみ |
| 確認済み | 分離したロジックのV8検査 |
| 未確認 | 公開URLの到達・ブラウザー実操作・WordPress表示 |
動く仕組みと役割分担
Plotly.jsのsurfaceトレースへZ行列を与えてWebGLで描画します。Zを作る関数は単独で検査でき、描画更新はPlotly.reactが受け持ちます。描画とロジックを分けたことが、ブラウザー依存の問題を切り分ける鍵になります。
次は教材の計算ロジックです。ブラウザーで描画できなくても、画面へ渡す値が期待通りかを別に確かめられます。完成した操作画面はHTML、CSS、app.mjs、vendorの全ファイルが必要です。この抜粋だけで動くと誤認しないようにしてください。
export const axis=[0,1,2,3,4];
export function surface(scale){const n=Number(scale);if(!Number.isFinite(n)||n<1||n>3)throw new RangeError("倍率1〜3");return axis.map(y=>axis.map(x=>x*y*n));}
export function maximum(z){return Math.max(...z.flat());}
この分離によって、計算の誤りと見た目の不具合を別々に診断できます。画面が出ないからといって元データが間違っているとは限りません。逆に画面が綺麗でも、元データや計算条件が間違っていれば役に立ちません。
一条件を変えたときの意味
3Dは奥行きが分かりやすい半面、視点や軸の倍率で値の差を誇張する恐れがあります。業務比較では最大値や単位を文字で表示し、必要に応じて2D表も添える方が誤解を避けられます。
変更した入力と結果を記録してから次の条件へ進みます。複数の値を同時にいじると、何が変化の原因になったか分からなくなるためです。まずダミー入力で動きを覚え、必要があれば公式仕様の境界値を照合しましょう。
動かないときの確認
WebGLが利用できないブラウザー、GPU設定、ファイルの読み込み、Z配列の次元などを確認します。画面が真っ白なときにレンダリング成功と報告しないことが重要です。
| 現象 | 確認する場所 | 切り分け |
|---|---|---|
| URLが開けない | Pagesの配信とHTTP応答 | 公開側の問題 |
| 画面が真っ白 | vendor・DOM・Console | 読込み/実行の問題 |
| 操作が反映されない | 入力イベントと更新処理 | 状態管理の問題 |
| 数字と画面が違う | 元配列と表示設定 | 計算と描画の問題 |
今回の検証で実施したのは計算部分の隔離確認です。ライブラリ本体の実ブラウザー動作や本番のWordPress表示は確認していません。実施していない操作を検証済みとしないことは、失敗を再現できる技術記事にとって重要です。
実務に応用する場合
倍率1の最大高さは16、倍率3では48になります。どちらもXとYの5×5、合計25格子点であり、倍率を変更しても測定件数が増えたわけではありません。視点を回して見た目が変わることも、元データの変更とは区別してください。 その一方で、業務データへ拡張する前に3Dは奥行きが分かりやすい半面、視点や軸の倍率で値の差を誇張する恐れがあります。業務比較では最大値や単位を文字で表示し、必要に応じて2D表も添える方が誤解を避けられます。
運用向けに広げるときは、アクセス権、保存の成否、更新の証跡、失敗時の復旧、データの取り違え防止を検討する必要があります。ブラウザーの静的デモは説明用であり、本番のDBや認証を備えたシステムの代わりではありません。
静的同梱と安全管理
ライブラリ本体は外部CDNへ毎回読み込むのではなく、docs/demos/plotly-3d-data-explorer/vendor/へ固定版を同梱しています。第三者が配布したソフトウェアなので、出典・バージョン・ライセンスをREADMEに明記し、ライブラリの更新は意図的に検証してから行います。外部CDNの突然の変更に左右されにくい一方、セキュリティ更新まで自動で行われるわけではありません。
架空データだけを使用し、実在する人・会社・機密システムの情報を公開教材に入れません。第三者製のコードであっても、利用者が実行するものとして権限やネットワーク接続、将来のライブラリ更新を確認する責任は残ります。WordPress記事本文に無断のスクリプトやiframeを挿入せず、従来の配信経路を維持しています。
まとめ
5×5の架空の格子から3D曲面を作り、マウスによる視点変更と、高さ倍率を1〜3へ動かす操作を学びます。 「操作して結果を確認する」「変化の理由を説明する」「1つだけ条件を変えて比較する」という順で、動くライブラリを技術の学びへ変えられます。完成版のREADMEとソースを見れば、静的サイトのまま再現する手順も確認できます。
公式資料とコード
ライブデモ(実到達・実ブラウザー操作は未確認)
検証範囲
計算ロジックをV8隔離環境で確認し、静的教材と版固定の第三者ライブラリ、ライセンスをGitHubへ保存しました。ブラウザー実機での操作、画面表示、WordPress本番での見え方、スマートフォン、Windows/macOS差は未確認です。
