結果をHTMLへ出力し、実ファイルを確認して共有します。GitHubのnotebook表示では独自JavaScriptが動かない場合がありますが、Plotly HTMLはhover、zoom、凡例とインラインスクリプトを維持できます。一方で容量が増え、画面に見える図より多くのデータが埋め込まれる危険があります。
対話型リンクを約束する前に容量を確認する
匿名アップロードは1MiB(1,048,576バイト)、Proは**10MiB(10,485,760バイト)**までです。上限が広がっても、外部スクリプトやPythonバックエンドが使えるようになるわけではありません。実際の接続の上限は get_publish_limits で確認します。表示されたProの価格は、決済が利用できる証拠ではありません。
静的レポートのサンプルをダウンロード。UTF-8で1514バイト、合成値A=12、B=18、C=9を表とインラインSVGで示します。hoverやzoomはなく、Plotlyの出力でもありません。顧客事例や実際の公開結果は主張しません。
自分のPlotly図は自己完結ファイルとして生成し、アップロード前にUTF-8のソース容量を測ります。次は各自のPlotly環境で実行する手順で、ここで計測した結果ではありません。
from pathlib import Path
import plotly.graph_objects as go
fig = go.Figure(go.Bar(x=["A", "B", "C"], y=[12, 18, 9]))
source = fig.to_html(full_html=True, include_plotlyjs=True)
size = len(source.encode("utf-8"))
print({"bytes": size, "within_anonymous_limit": size <= 1_048_576,
"within_pro_limit": size <= 10_485_760})
Path("report.html").write_text(source, encoding="utf-8")
include_plotlyjs="cdn" はソースファイルを小さくしますが外部スクリプトを必要とし、HTMLビューアーが遮断します。自己完結ファイルが上限を超える場合は静的レポートか別のホスティングを使い、収まる場合でも実際に共有した図のhover、zoom、ラベルを確認します。
出力形式を選ぶ
| 形式 | 対話操作 | 主な制限 |
|---|---|---|
| PNG・SVG | なし | 小さく予測しやすいがhover・filterなし |
| GitHub notebook | 制限あり | notebookは表示されるが独自JavaScriptが動かない場合あり |
| CDN利用のPlotly HTML | libraryが読み込めれば可能 | 外部通信に依存 |
| 自己完結Plotly HTML | あり | Plotlyによると5MB超になる場合あり |
HTML2WEBの匿名フローは1ファイル1MiBまでで、Proは10MiBまでです。ビューアーが外部通信を止めるため、CDN依存の図は安定した選択ではありません。自己完結ファイルはデータを追加する前から上限を超える場合があります。
共有用に整える
- 不要なnotebook出力を再実行または消す。
- アクセストークン、ローカルpath、username、内部URL、生のquery結果、隠れたhover fieldを除く。
- 機密行は集計するか公開可能なfixtureへ置き換える。
- 最終図や必要なレポート部分だけ出力する。
- 外部要求のないインラインのcodeとstyleを優先する。
- 容量をバイト単位で確認する。
- offlineでHTMLを開き操作を確認する。
- 短い期限で公開し、公開URLをprivate windowで確認する。
表示中の表を消してもそのデータが消えたとは限りません。trace、notebook出力、script変数、HTMLのsourceには、誰かがページを調べるまで現れない値が残る場合があります。
上限を超える場合
次の正直な代替から選びます。
- 静的なSVG・PNGを短い解説とともに公開する。
- 点数、精度、重複ラベル、未使用traceを減らす。
- 複数図のレポートを目的別のページに分ける。
- 大きなartifactとランタイム依存に合う環境へアプリとして載せる。
出典やアクセシビリティ文を削って容量だけ合わせません。ライブデータ、認証、callback、Python実行、大きなlibraryが必要なら、単一ファイルのプレビューではなくアプリケーションです。
受信者の体験を検証する
公開URLでキーボード操作、見えるラベル、hoverとzoom、凡例、モバイル幅、期限、ネットワークエラーの有無を確認します。操作できない場合にも結論が分かるよう、図の前に文章の要約を置きます。
整えたファイルはHTML URL変換ツールで公開します。エージェントが作ったレポートなら、アップロード前に秘密情報チェックも実行してください。
