結果を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依存の図は安定した選択ではありません。自己完結ファイルはデータを追加する前から上限を超える場合があります。

共有用に整える

  1. 不要なnotebook出力を再実行または消す。
  2. アクセストークン、ローカルpath、username、内部URL、生のquery結果、隠れたhover fieldを除く。
  3. 機密行は集計するか公開可能なfixtureへ置き換える。
  4. 最終図や必要なレポート部分だけ出力する。
  5. 外部要求のないインラインのcodeとstyleを優先する。
  6. 容量をバイト単位で確認する。
  7. offlineでHTMLを開き操作を確認する。
  8. 短い期限で公開し、公開URLをprivate windowで確認する。

表示中の表を消してもそのデータが消えたとは限りません。trace、notebook出力、script変数、HTMLのsourceには、誰かがページを調べるまで現れない値が残る場合があります。

上限を超える場合

次の正直な代替から選びます。

  • 静的なSVG・PNGを短い解説とともに公開する。
  • 点数、精度、重複ラベル、未使用traceを減らす。
  • 複数図のレポートを目的別のページに分ける。
  • 大きなartifactとランタイム依存に合う環境へアプリとして載せる。

出典やアクセシビリティ文を削って容量だけ合わせません。ライブデータ、認証、callback、Python実行、大きなlibraryが必要なら、単一ファイルのプレビューではなくアプリケーションです。

受信者の体験を検証する

公開URLでキーボード操作、見えるラベル、hoverとzoom、凡例、モバイル幅、期限、ネットワークエラーの有無を確認します。操作できない場合にも結論が分かるよう、図の前に文章の要約を置きます。

整えたファイルはHTML URL変換ツールで公開します。エージェントが作ったレポートなら、アップロード前に秘密情報チェックも実行してください。