コンテンツにスキップ

リッチ出力

実行可能セルは複数の typed output artifact を返せます。通常の print や println! も使えますが、より構造化された出力は共通 UI component で表示されます。

Oxiquill は次の出力を表示します。

  • stdout、stderr、display output の text。
  • 構造化表示される JSON。
  • sort 可能な column を持つ table。
  • ECharts で render される chart。
  • Canvas 2D で表示するインタラクティブな3D点・辺シーン。
  • SVG、PNG、JPEG data から作る image。
  • iframe 内の sandboxed HTML。
  • 著者が宣言する計算条件の達成状況。

各 artifact は optional string の id、title、caption を持てます。worker から受け取る value は untrusted です。Oxiquill は renderer に渡す前に discriminator、field、plain-record structure、array shape、finite number、row width、MIME/base64 data、nested value を検証します。reject/render failure になった一つの artifact は local diagnostic を表示し、valid sibling を消しません。

既定では出力を生成順に縦に並べます。セルに outputLayout: columns を指定すると、セルの幅が十分なときにグラフと画像を同じ行に並べます。一行に並べる図は二つまでで、各図の幅は --oq-output-column-min-width(既定値 18rem)以上です。一つだけの図や奇数個目の最後の図は全幅を使います。表、テキスト、JSON、HTML、3Dシーン、計算結果は常に全幅で表示し、幅の狭いセルではすべての出力を縦に並べます。

Rust + Wasm

二つの見方を並べて比較する

Cell actions
emit_line_chart!(&[[0, 1], [1, 3], [2, 2], [3, 5], [4, 4]], "Step", "Signal");
emit_bar_chart!(&["low", "middle", "high"], &[2, 5, 3],
    options = &serde_json::json!({ "xLabel": "Band", "yLabel": "Count" }));
emit_text!("Text outputs keep the full width below the paired charts.");

Waiting for the runtime to start.

KindRequired fieldOptional behavior
textstream: "stdout" | "stderr" | "display", content: stringtruncated が bounded content を示します。
jsonvaluecycle-aware formatting が BigInt を明示表現し、truncated が bounded serialized data を示します。
tablecolumns、rectangular rowsrowCount が original size、truncated が preview を示します。
chart下記の valid specoversize/invalid chart は local artifact error。
scene3dpoints辺、グループ、軸、カメラは任意。3D点シーンを参照。
imagemime: image/png | image/jpeg | image/svg+xml、valid dataalt が image alternative。
htmlhtml: string, sandboxed: trueempty sandbox、no-referrer、下記の restrictive CSP で表示。
outcomestate、空白だけではない label正常な実行の計算結果を一つだけ指定。説明、ステータス、診断値は任意。

table column は key、label、optional type を持ちます。type は string、number、integer、boolean、date、datetime、null、unknown です。各 row は declared column count と正確に一致する必要があります。

すべての chart spec は optional title、xLabel、yLabel、xType、yType、legend、tooltip、dataZoom を受け取ります。axis type は value、category、time、log です。未指定 axis は value が default ですが、bar のカテゴリ軸(縦棒では x、横棒では y)と boxplot の x 軸は category です。heatmap は常に X/Y 両方が category axis であり、xType と yType は省略するか category にできますが、value、time、log は reject されます。

  • value coordinate は finite number、log coordinate は 0 より大きい finite number です。

  • time coordinate は finite epoch millisecond、または YYYY-MM-DDTHH:mm:ss[.sss]Z / YYYY-MM-DDTHH:mm:ss[.sss]±HH:mm 形式の ISO-8601 string です。calendar field と明示的な time zone も valid である必要があります。

  • category coordinate は string または finite number です。heatmap axis に明示的な xCategories / yCategories array がある場合、coordinate は完全一致する listed string、または範囲内の safe な zero-based integer index に限定されます。index はその位置の category name に解決され、数値らしい新しい category name には変換されません。

  • heatmap axis に明示的な categories array がない場合、finite number と string は String(coordinate) で正規化され、category は初出順に推論されます。1 と "1" のように同じ label に正規化される値は一つの category を共有します。片方の axis だけ categories を宣言した場合も、X と Y は独立して正規化されます。

  • line、scatter、area: optional name と [x, y] point を持つ series[]。

  • bar: string categories[] と同じ length の numeric-or-null values[] series。

  • histogram: lower < upper かつ count が non-negative の finite [lower, upper, count] tuple の bins[]。

  • heatmap: optional string xCategories/yCategories array と、二つの category axis 上の finite [x, y, value] cell。

  • errorbar / band: [x, center, lower, upper] の区間を持つ系列。

  • boxplot: カテゴリと集計済みの [min, q1, median, q3, max]。

  • bubble: [x, y, size, color?] の点とサイズ・色の対応指定。

  • field: 値軸の境界 xEdges / yEdges と行列 values。

empty chart と equal point domain は valid です。heatmap は X/Y の category 数と heat value の範囲を示します。色尺度は既定で実際の heat value を使い、empty dataset だけは 0–1 を fallback にします。colorMin・colorMax・colorScale を指定するとその範囲を優先します(ヒートマップの色尺度を参照)。chart は textual title/caption と bounded accessible summary または equivalent table を提供します。equivalent がある場合、implementation canvas は accessibility API から隠されます。

chart は html[data-theme] の変更時も同じ ECharts instance を使い、ズーム・凡例、および heatmap・field・色を対応付けた bubble の色範囲の選択を保持します。一時的な renderer load failure の後には retry action を表示します。

xMin/xMax/yMin/yMax は有限数で指定し、min を max より小さくします。time の境界は epoch milliseconds、log は正数に限定します。category 軸に数値境界は指定できません。xIncludeZero/yIncludeZero は value 軸だけに指定できます。固定境界を優先しますが、bar・histogram・area の value y 軸はゼロを含む必要があり、この基準を無効にできません。

データ更新ではズームを保持します。境界やゼロ包含の変更・解除では全範囲へ戻し、凡例の選択は保持します。境界を省略すると自動範囲に戻ります。

Rust の line・scatter・area・bar・histogram マクロでは、データ引数の後ろに options = &serde_json::json!({...}) を指定できます。heatmap とその他の種類は、spec 全体を emit_chart! に渡します。ラベルと nested style を含む公開設定を指定でき、kind やデータは上書きできません。従来の位置引数 style も利用できます。ロジスティック写像は 0–1 の固定範囲を使います。

パネルの連動とキーボード操作

Section titled “パネルの連動とキーボード操作”

ズーム可能な value・time・log の x 軸を持つ line・scatter・area・band・errorbar・xy は、link: { group: "residuals", zoom: true, cursor: true } を指定できます。必須の group は ASCII 英数字・アンダースコア・ハイフンの 1–64 文字です。二つの真偽値は既定で true となり、false はその操作の送受信を無効にします。category 軸、dataZoom: false、その他の種類では link を指定できません。xy の x 軸は引き続き value・time だけです。

同じページ内なら、別のセルから出力したグラフも同じグループに参加します。ズームと移動は x 座標値を共有するため、幅やデータ範囲が違うパネルでも位置が揃います。各パネルは受信範囲と自身の範囲の共通部分を表示し、重ならない場合は表示を保持して、選択範囲にデータがないことを読み上げます。リセットは各パネル固有の指定境界またはデータ全範囲へ戻します。後から表示されたパネルは現在のグループ範囲に参加します。x 軸の種類は全員同じにし、明示した style.xFormat.unit も一致させてください。軸ラベルから単位を推測することはありません。不正なグラフだけに artifact 単位の診断を表示し、隣の出力は引き続き操作できます。

カーソルは相手のデータ点の間でも同じ x 座標に線を表示し、ツールチップはポインターのあるパネルだけに表示します。グラフ操作でセルは再実行されず、ページ移動で連動状態は破棄されます。PNG・SVG の保存には各パネルの現在の表示範囲を使います。

ズーム可能なプロットにフォーカスし、+ または = で拡大、- で縮小、← / → で表示範囲の 10% 移動、0 でリセットします。連動の有無やポインター位置に依存しません。横棒グラフはカテゴリ y 軸、それ以外は x 軸を操作します。スクリーンリーダーにはフォーカス時に短い操作説明を伝えます。

次の二つのセルは x 軸の表示範囲とカーソルを共有します。

Rust + Wasm

観測値

Cell actions
emit_line_chart!(&[[0, 2], [20, 4], [40, 3], [60, 6], [80, 5], [100, 7]],
    options = &serde_json::json!({
        "link": { "group": "residuals" },
        "xLabel": "時間", "yLabel": "電圧",
        "style": { "xFormat": { "unit": "s" }, "yFormat": { "unit": "V" } }
    }));

Run the cell to show its output.

Rust + Wasm

残差

Cell actions
emit_line_chart!(&[[10, -1], [30, 1], [50, -2], [70, 2], [90, 0]],
    options = &serde_json::json!({
        "link": { "group": "residuals" },
        "xLabel": "時間", "yLabel": "残差",
        "style": { "xFormat": { "unit": "s" }, "yFormat": { "unit": "V" } }
    }));

Run the cell to show its output.

ヒストグラムの x 軸は数値軸です。各矩形は正確な [lower, upper) に対応し、負の境界、異なる幅、区間の空白を保ちます。重なるビンは拒否し、重ならないビンの入力順は変更しません。

既定の mode: 'count' は度数を高さにします。mode: 'density' は count / (upper - lower) を高さとし、面積が度数を表します。確率の総和を 1 にする正規化ではありません。y 軸名、tooltip、要約にモードを示します。value y 軸の基準はゼロ、log y 軸の基準は表示範囲の正の下端です。log は正の高さを必要とし、その矩形の面積は度数を表しません。

移行: 明示的な xType: 'category' は引き続き受理しますが、value に正規化します。新しいコードでは省略または value を指定してください。データの境界や度数は丸めません。

Rust + Wasm

Unequal-width histogram

Cell actions
let bins = [[-1.0, -0.5, 2.0], [0.0, 2.0, 4.0]];
emit_histogram!(&bins, options = &serde_json::json!({
    "mode": "density", "xLabel": "Measurement", "yLabel": "Frequency"
}));

Run the cell to show its output.

bar・histogram・area は量を表す value 軸(横棒では x 軸、それ以外は y 軸)にゼロを含み、line・scatter はデータの範囲に合わせます。負の値もゼロを基準に描画します。量を表す value 軸のデータがゼロをまたぐ場合はゼロ線を引きます。ゼロ線は系列を非表示にしても残り、ズーム中は描画領域で切り取られます。field は両軸が座標なのでゼロ線を引きません。必要な場合は値 0 の line 注釈を追加してください。log y 軸では軸の下端を基準にするため、棒の長さや塗りの面積を量として比較できません。移行: bar・histogram の yType: 'time' は拒否されます。量には value 軸、時刻には line・scatter を使ってください。

数値の表記は軸ごとの元データの範囲で決まり、ズーム中も変わりません。4 桁の年には桁区切りを付けず、大きな値や微小値には指数表記を使います。大きな値の近傍の狭い範囲では通常表記を維持します。目盛は値を区別できる精度を保ち、tooltip・色凡例・概要は有効 6 桁です。JSON と表の CSV の値は変更しません。負のゼロは 0 と表示します。

ゼロをまたぐ数値範囲では、データ値の絶対値が最大絶対値と浮動小数点イプシロンの積以下なら 0 と表示します。−1〜1 の範囲での sin(π) などの丸め誤差を除くためです。目盛と対数座標の微小値は維持します。時刻の目盛はズーム後の間隔に合わせて精度を変え、必要なミリ秒と日付を表示します。

移行: 時刻の目盛・tooltip・概要は、読者のローカル時刻ではなく UTC に統一されます。入力は引き続き epoch milliseconds またはタイムゾーンを明示した ISO-8601 文字列です。

題は図の上に一度だけ表示します。artifact と spec の題が異なる場合は spec の題を副題にします。両方の題を省略した場合、空文字または空白のみの場合は見出しを視覚的に隠し、読み上げ用にグラフの種類名を残します。caption は表示します。HTML凡例はキーボード操作可能な系列ボタンを1ページ25系列で表示し、無名の系列には既定名を付けます。長い軸名・カテゴリ名は短縮し、軸名の全文は概要、カテゴリ名・系列名の全文は tooltip で確認できます。カテゴリ目盛は回転してから必要に応じて間引きます。長いカテゴリ名が多い図は分割してください。長いカテゴリ名には orientation: "horizontal" を利用できます。

既定の 8 色は明暗テーマで共通です。既定背景に対し、隣接色(末尾から先頭への循環を含む)は通常視で OKLab 色差 15 以上、1・2・3 型色覚の模擬で 8 以上、各色と背景のコントラスト比は 3:1 以上を満たします。すべての系列の組合せの識別を保証するものではありません。色を再使用すると線種や散布図の記号が変わりますが、8 系列を超える図は分割を推奨します。独自パレットは著者が背景コントラストと色覚による違いを確認してください。heatmap・field・bubble の色の対応付けは、既定で明度が単調に変わる単色相の連続色を使います。発散色の heatmap は中心値を中間色とする 3 色の連続色を使います。

出力の保持とグラフのスタイル

Section titled “出力の保持とグラフのスタイル”

1系列が10万点で、x が厳密に増加する value/time 軸、y が value 軸の通常の折れ線は、表示に LTTB 間引きを使います。階段、平滑化、明示的な点マーカー、往復する軌跡、面グラフは従来どおり描画します。間引き中の tooltip は選択された元データ点を示し、zoom 時は元データから表示を再計算します。1万点以上の scatter は4px以上の塗りつぶし記号で large 描画を使います。小さい記号、白抜き、非表示の記号は通常の描画を維持し、バブル図は点ごとのサイズと色を維持します。概要と表は元の値を使い、表・CSV の既存の1万行上限も維持します。worker 出力、検証、著者による統計計算は変更しません。

セルを再実行している間も、最後に成功した出力を表示し続けます。150ms の reactive debounce 中も同様です。更新中の表示はレイアウトを動かしません。再実行が失敗した場合は出力とエラーを併記し、セルの実行を再試行からやり直せます。キャンセルや入力不正でも出力を保持し、成功時に結果を置き換えてエラーを消します。出力の並びが動的に変わる場合は artifact に明示的な id を付けてください。重複 ID は出現番号で区別し、ID のない artifact は種類ごとの出現番号で対応付けます。

互換性のあるグラフは既存の canvas と ECharts instance を更新し、読者のズーム範囲を保持します。初回とデータ更新のアニメーションは既定で180ms、easing は cubicOut です。構造変更時は同じ instance の設定を置き換え、Starlight の light/dark 変更時は色と字体を更新し、読者の操作状態を保持します。グラフ更新が失敗しても最後の表示と概要を残し、局所的な再試行操作を表示します。OS の動作軽減設定は著者の animation 指定より優先され、グラフと更新表示のアニメーションを無効にします。

chart spec は次の optional style object を受け取ります。

interface ChartPalette {
light?: readonly string[];
dark?: readonly string[];
}
interface BaseChartStyle {
height?: number;
palette?: ChartPalette;
showGrid?: boolean;
animation?: boolean;
animationDurationMs?: number;
}
interface LineChartStyle extends BaseChartStyle {
lineWidth?: number;
}
interface ScatterChartStyle extends BaseChartStyle {
symbolSize?: number;
}

line と area は LineChartStyle、scatter は ScatterChartStyle、bar・histogram・heatmap は BaseChartStyle を使います。

Field許可される値と既定値
palettelight / dark の少なくとも片方を指定。各テーマに重複しない #RGB / #RRGGBB を1〜12色。heatmap は2色以上。短縮表記を展開し、大文字小文字を区別せず重複判定します。
showGridboolean。既定値は true。
height200〜800px の整数。既定値は 360px。heatmap は行数に応じて 240〜720px に自動調整します。
animationboolean。既定値は true。動作軽減設定を優先します。
animationDurationMs0〜2,000の整数。初回と更新の既定値は180。
lineWidth1〜8の有限値。既定値2.25。line / area のみ。
symbolSize2〜32の有限値。既定値7。scatter のみ。

palette は系列色を選び、heatmap では visual-map のグラデーションになります。片方のテーマが未指定なら、そのテーマの Oxiquill 既定色を使います。文字やグラフ周辺の色は Starlight に従います。不明な nested field、別の種類専用の field、生の ECharts options、callback、formatter、HTML は拒否します。style も通常の artifact byte 制限に含まれます。

既存の Rust macro signature はすべて利用できます。次の overload では末尾に JSON-serializable な style(例: &serde_json::json!({ "lineWidth": 3 }))を追加できます。

emit_line_chart!(series, style)
emit_line_chart!(series, x_label, y_label, style)
emit_scatter_chart!(series, style)
emit_scatter_chart!(series, x_label, y_label, style)
emit_bar_chart!(categories, values, style)
emit_histogram!(bins, style)
emit_heatmap!(data, style)
emit_line_plot!(points, x_label, y_label, style)

macro は spec.style にシリアライズし、通常のグラフ検証が同じ制限を適用します。

value/log 軸には style.xFormat と style.yFormat、heatmap・field・bubble の色の値には style.valueFormat を指定できます。目盛、ポインター、tooltip、要約に同じ設定を使います。category と time は専用の表示書式を保ちます。

各書式は significantDigits(整数 1–17)、fractionDigits(整数 0–20)、unit(文字列)、notation(auto、standard、scientific、si)を受け付けます。2 種類の桁指定は併用できません。固定小数では末尾のゼロを保持し、小さい値がゼロに丸まる場合があります。負のゼロはゼロと表示します。未指定の書式は従来の規則に従い、設定を削除すると既定値へ戻ります。

単位は数値の後ろに表示し、軸名は xLabel/yLabel で指定します。SI はデータ範囲から共通の接頭辞(10⁻²⁴〜10²⁴)を選び、境界での丸めを考慮します。範囲外は指数表記に戻ります。元データを変更せず、callback、書式文字列、HTML、生の ECharts options は受け付けません。

Rust + Wasm

Voltage measurements

Cell actions
let points = [[0.0, 1500.0], [1.0, 2400.0]];
emit_line_chart!(&points, "Time", "Voltage", &serde_json::json!({
    "xFormat": { "fractionDigits": 1, "unit": "s" },
    "yFormat": { "significantDigits": 3, "notation": "si", "unit": "V" }
}));

Run the cell to show its output.

series[] を持つすべての種類の系列には、空でない一意の id を付けられます。同じ結果内では、安定した ID により並べ替えや改名後も系列の識別と凡例の選択を保持します。新しいセル実行が成功すると、すべての系列を表示する初期状態に戻ります。name は表示名であり、同名の系列も個別に選択できます。ID がなければ系列の位置で対応付けます。系列の追加・削除ではズームをリセットしません。既定の配色は記述順に従うため、系列の色を固定するには明示的に指定してください。

series.style.color は #RGB/#RRGGBB または { light, dark } で指定し、少なくとも一方のテーマを含めます。未指定のテーマは chart palette を使います。line・area はさらに lineType(solid/dashed/dotted)、step(false/start/middle/end)、smooth(boolean)、symbol、showSymbol を使えます。scatter・bubble は色と記号、bar・errorbar・band・boxplot は色に対応します。記号は circle/emptyCircle/rect/triangle/diamond/none です。

smooth と step は同時に有効化できません。既定では平滑化せず、明示した線種・記号は配色循環の自動設定より優先します。showSymbol の指定は孤立点の自動検出より優先します。設定を削除すると既定値へ戻り、従来の chart 全体の lineWidth・symbolSize は引き続きサイズを指定します。

Rust + Wasm

Measured and reference series

Cell actions
let series = serde_json::json!([
    { "id": "measured", "name": "Measurement", "points": [[0, 1], [1, 2]],
      "style": { "color": { "light": "#3987e5", "dark": "#9085e9" }, "symbol": "diamond", "showSymbol": true } },
    { "id": "reference", "name": "Reference", "points": [[0, 1.5], [1, 1.5]],
      "style": { "lineType": "dashed", "step": "end" } }
]);
emit_line_chart!(&series, "Observation", "Value");

Run the cell to show its output.

producer は各 language worker 内で postMessage より前に limit を適用し、main thread でも bounded response を独立して再検証します。limit は UTF-8 byte 単位で、記載のものは run ごとに累積します。

ResourceLimit超過時
Artifact1 run 100個追加 artifact を local reject。
stdout / stderrstream ごとに 1 MiBlimit までだけ保持し、truncated として表示。
Text、serialized JSON、HTMLartifact ごとに 1 MiBText/JSON は truncated: true 可、HTML は reject。
Table10,000 row、100 columnbounded table は truncated: true と rowCount を使用可。
Chart合計100,000 point/bin/cellartifact-local error。
Chart annotation1 chart につき 100 件。label は 1 行・256 byte 以内artifact-local error。
Imagedecoded 10 MiBartifact-local error。
全 validated output1 run 16 MiBremaining budget を超える artifact を local reject。
complete worker response16 MiBworker から page へ渡す前に後続 artifact を省略。
worker error16 KiBUTF-8 message を truncate。
artifact diagnostic1件 8 KiB、1 run 64 KiB各 limit 内で diagnostic を truncate。

truncated: true を使えるのは text、JSON、table だけです。chart、image、HTML は黙って truncate しません。invalid/cyclic/over-deep JSON、ragged table、non-finite chart value、invalid base64/MIME pair、unsafe structural record が cell component を crash させることはありません。実行結果は outputs に統一され、ストリームのテキストと JSON 値を結果直下に重複して保持しません。

幅が36rem未満のグラフでは、操作を「データ」「表示を戻す」(利用可能な場合)「保存 ▾」の1行にまとめます。「保存」から従来と同じPNG・SVGを選べます。判定にはページ全体ではなくグラフのコンテナー幅を使います。Escapeキーまたは外側のクリックで開閉パネルを閉じると、開いたボタンにフォーカスが戻ります。

各凡例には「この系列のみ」があり、「すべての系列を表示」で全ページの系列を復元できます。すべてを非表示にすることも可能です。幅の狭いグラフで凡例が7件以上ある場合は「系列(表示数/総数)」にまとめます。開くと同じ操作と25件ずつのページ送りを使えます。テーマ変更、ズームとリセット、画像保存では系列選択を保持します。要約には表示中の系列数を示し、表とCSVには既存の行数上限の範囲で非表示の系列も「表示中」列とともに保持します。

Rust + Wasm

Twelve series

Cell actions
let series: Vec<_> = (0..12).map(|i| serde_json::json!({
    "id": format!("series-{i}"), "name": format!("Series {}", i + 1),
    "points": [[0, i], [1, i + 2], [2, i + 1]]
})).collect();
emit_chart!(serde_json::json!({ "kind": "line", "title": "Twelve series", "series": series }));

Waiting for the runtime to start.

「データを表で表示」で、非表示の系列を含む元の値、ヒストグラムの両端と度数、heatmapの座標、区間の上下限、箱ひげ図の統計量、バブルのサイズと色、fieldのセル境界を確認できます。時刻軸の整数のepochミリ秒は、グラフと同じUTCのISO-8601時刻で表示します。開いた時だけ変換し、最大10,000行を保持して総数と省略を表示します。表の並べ替え、ページ送り、CSV保存はキーボードで操作できます。系列ボタンは aria-pressed で選択状態を伝え、色・線種・記号を併用します。「ズームを戻す」は系列選択を保持して著者指定の全範囲に戻します。既存のグラフ要約も維持します。

「PNGを保存」「SVGを保存」は現在のテーマ、ズーム、系列の選択、色範囲を反映します。PNGのピクセル数は描画領域の幅・高さの2倍で、SVGは同じ論理寸法です。背景と凡例を含み、animation、title、captionは含みません。一時rendererで保存するため、表示中のグラフは置き換えません。

著者はグラフの style: { renderer: "svg" } を指定できます。Rustのstyle引数やPythonの display_chart からも使えます。既定は "canvas" です。SVGは拡大・印刷向けのベクター出力ですが、大量データで常に高速とは限りません。印刷時は操作ボタンを隠し、グラフとcaptionを保持します。

「全取得行をCSV保存」はページを跨いだ全保持行を、現在の並べ替え順で保存します。「表示中の行をCSVとしてコピー」は現在のページだけをコピーします。省略された結果では、報告された総行数ではなく取得済みの部分だけを保存します。ダウンロードはクリップボードを使わず、元の数値を保持します。保存するファイルは BOM 付きの UTF-8 で、Excel などの表計算ソフトが日本語を含むテキストの文字コードを判別できます。コピーした CSV テキストには BOM を付けません。

表の整数は、すべての整数を正確に表せる±9,007,199,254,740,991(Number.MAX_SAFE_INTEGER)までは全桁を表示します。それより大きな値と非整数は有効6桁とし、絶対値が 1e6 以上または 1e-4 未満なら指数表記にします。負のゼロは 0 と表示します。列内に絶対値10,000以上の数がある場合だけ桁区切りを付け、ページ間でも統一します。数値セルのtitle属性で元の値を確認できます。並べ替えとCSVには元の値を使います。

default table action は表示中の row を spreadsheet-safe CSV として copy します。最初の meaningful character が =、+、-、@、tab、carriage return の string header/cell には、RFC-style の comma/quote/line-break escape より前に apostrophe を付けます。この決定的な規則により、一般的な spreadsheet application が string data を formula として評価することを防ぎます。数値は変更しないため、実際の number -42 は -42 のままです。

破壊的変更: 実行結果は必須の outputs 配列だけを持ちます。結果直下の stdout/stderr/value/plots と公開型 PlotSpec/LinePlotSpec は削除されました。JsonArtifact.value と入力の value は引き続き利用できます。

以前は outputs が存在すると空配列でも旧フィールドより優先され、存在しない場合だけ stdout・stderr・value・plots の順で変換されていました。現在は旧形式だけの結果や配列以外の outputs を受け付けず、再生成を案内する診断を表示します。既存の outputs と併存する旧フィールドは無視します。

const result = {
outputs: [
{ kind: 'text', stream: 'stdout', content: 'Printed output' },
{ kind: 'text', stream: 'stderr', content: 'Diagnostic output' },
{ kind: 'json', value: { answer: 42 } },
{ kind: 'chart', spec: { kind: 'line', series: [{ points: [[0, 1]] }] } }
]
};

Rust の早期 return も artifact を明示してください。通常の出力には引き続き println! と emit_* を使えます。

return Ok(CellOutput {
outputs: vec![OutputArtifact::Text(TextArtifact {
stream: "stdout",
content: "Early return".to_owned(),
truncated: false,
})],
});

任意 helper crate doc-rust の PlotSpec/LinePlot/line_plot も削除されました。SeriesPoint を [f64::from(point.n), point.x] に明示変換し、emit_line_chart! に渡してください。互換マクロ emit_line_plot! は残っています。

出力順は、Rust は stdout の後に emit 順、Python は stdout・stderr・display・自動 matplotlib 図・最終値、Haskell は stdout のテキスト・Oxiquill.Output の artifact・stderr のテキストを書き込んだ順です。Python の最終値が None または空文字列なら暗黙の JSON 出力はありません。明示した JSON artifact の null・空文字列・false・0 は保持します。捕捉したストリームは display 呼び出しと交互には並びません。

更新後は pnpm exec oxiquill docgen --wasm dev または本番の pnpm build で runtime を再生成してください。生成物は直接編集しないでください。

Python セルには display helper が含まれます。

  • display(value) は value から JSON、table、image、HTML、text の出力を選びます。
  • display_json(value) は JSON を出力します。
  • display_html(html) は sandboxed HTML を出力します。
  • display_table(rows_or_dataframe) は table を出力します。
  • display_scene3d(points, ...) は 3D点シーンを出力します。
  • display_image(data, mime) は SVG、PNG、JPEG image data を出力します。

runtime は pandas DataFrame/Series、matplotlib figure、_repr_mimebundle_、_repr_json_、_repr_html_、_repr_svg_、_repr_png_、_repr_jpeg_ などの rich representation も扱います。

表示の移行: matplotlib はセルごとに、グラフと共通の配色、sans-serif、淡い格子、上・右枠線なし、白背景を既定にします。暗色テーマでも白い紙面として表示します。セル内で matplotlib.rcParams を上書きするか、図の作成前に matplotlib.rcdefaults() を呼ぶと元の既定値に戻せます。

各セルはスタイル設定をリセットしてから既定値を適用するため、前のセルの plt.style.use("dark_background") は影響しません。格子線は imshow の画像にも重なります。写真やヒートマップで重ねたくない場合は ax.grid(False) を呼んでください。

図の題と軸名から画像の代替テキストを生成します。SVG は svg.fonttype: 'none' を使い、読者のブラウザのフォントで日本語を描きます。SVG が 10 MiB を超えると 150 DPI の PNG に切り替え、stderr に診断を出します。PNG で日本語を描くには Python 環境内のフォントが必要です。画像と実行全体の上限は維持し、PNG も大きすぎる場合は artifact エラーになります。

display_chart(spec, *, id=None, title=None, caption=None) は dict/list だけで対応するすべての種類の対話的チャートを出力します。pandas は不要です。spec の style と artifact の metadata を別々に指定できます。

display_line(df, *, x, y, id=None, title=None, caption=None, style=None) は DataFrame の列から line チャートを作ります。y は列名または重複のない列名リストです。行順・列順を保ち、総点数は 10 万点までです。x は数値・文字列カテゴリ・タイムゾーン付き日時、y は有限数値を扱います。日時は UTC の epoch milliseconds に変換します。欠損値、NaN、無限大、NaT、タイムゾーンなし日時は行位置と列名付きの出力エラーになり、有効な隣接出力は残ります。欠損の前後を線で接続しません。

display_chart({
"kind": "area",
"series": [{"points": [[0, 1], [1, 2]]}],
"style": {"animation": False},
}, id="area", title="Measurements", caption="Two samples")
import pandas as pd
values = pd.DataFrame({"time": [0, 1], "a": [1, 2], "b": [3, 4]})
display_line(values, x="time", y=["a", "b"], title="Two series")

Python + Pyodide

Python table, matplotlib, HTML, and JSON outputs

Cell actions
import pandas as pd
import matplotlib.pyplot as plt

scores = pd.DataFrame({"label": ["alpha", "beta", "gamma"], "score": [3, 5, 4]})

display(scores, title="Pandas table")
display_json({"status": "ok", "rows": len(scores)}, title="Summary")
display_html("<p><strong>Sandboxed HTML</strong> emitted from Python.</p>", title="HTML")

plt.bar(scores["label"], scores["score"])
_ = plt.title("Scores")
_ = plt.xlabel("label")
_ = plt.ylabel("score")

Run the cell to show its output.

Rust セルでは明示的な emit_* macro を使います。対応 macro:

  • 3D点シーンを出力する emit_scene3d!。
  • emit_text!
  • emit_json!
  • emit_html!
  • emit_svg! と emit_image_svg!
  • emit_png_base64! と emit_image_png!
  • emit_table!、emit_table_with_columns!、emit_records_table!
  • emit_chart!、emit_area_chart!、emit_line_chart!、emit_scatter_chart!、emit_bar_chart!、emit_histogram!、emit_heatmap!
  • 互換用の emit_line_plot!。新規利用では座標を明示的に変換し、emit_line_chart! を使ってください。

emit_chart!(spec) は対応するすべての種類のチャートを受け付けます。metadata = ... の id/title/caption は artifact に属し、spec の title/xLabel/yLabel とは別です。表示タイトルは artifact の title を優先します。metadata の null は省略として扱い、それ以外のフィールドはその出力の診断になります。emit_table!、emit_table_with_columns!、emit_records_table! も末尾に同じ metadata = ...(id/title/caption)を受け付けます。表に id を付けると、宣言的テストでは出力の位置ではなく artifact: で表を選べます。emit_area_chart! は line と同じ点列・系列、軸ラベル、末尾 style、options = ... 形式を使えます。既存マクロの引数形式は維持されます。不正な spec は有効な隣接出力を残して、その出力の診断として表示されます。

emit_chart!(serde_json::json!({
"kind": "area",
"title": "Spec title",
"xLabel": "Time",
"yLabel": "Value",
"series": [{ "points": [[0, 1], [1, 2]] }],
"style": { "animation": false }
}), metadata = serde_json::json!({
"id": "measurements", "title": "Measurement report", "caption": "Two samples"
}));
emit_area_chart!(&[[0, 1], [1, 2]], "Time", "Value");

Rust + Wasm

Rust table, chart, JSON, SVG, and HTML outputs

Cell actions
let rows = vec![
    serde_json::json!({"label": "alpha", "score": 3}),
    serde_json::json!({"label": "beta", "score": 5}),
    serde_json::json!({"label": "gamma", "score": 4}),
];
let columns = vec![
    serde_json::json!({"key": "label", "label": "Label", "type": "string"}),
    serde_json::json!({"key": "score", "label": "Score", "type": "integer"}),
];
let heatmap = [[0, 0, 1], [1, 0, 3], [0, 1, 2], [1, 1, 4]];

emit_json!(&serde_json::json!({"status": "ok", "rows": rows.len()}));
emit_records_table!(&rows);
emit_table_with_columns!(&columns, &rows);
emit_bar_chart!(&["alpha", "beta", "gamma"], &[3, 5, 4], &serde_json::json!({
    "palette": { "light": ["#7c3aed"], "dark": ["#c4b5fd"] },
    "animationDurationMs": 180
}));
emit_heatmap!(&heatmap);
emit_svg!(
    r##"<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 48"><rect width="160" height="48" fill="#ecfeff"/><circle cx="32" cy="24" r="14" fill="#0f766e"/><rect x="64" y="12" width="72" height="24" rx="4" fill="#2563eb"/></svg>"##,
    "Simple generated SVG"
);
emit_html!(r#"<p><strong>Sandboxed HTML</strong> emitted from Rust.</p>"#);

Run the cell to show its output.

Haskell セルは同梱の Oxiquill.Output module を import して、JSON 値・表・グラフの spec を出力します。依存は GHC の base だけです。Haskell の show は JSON encoder ではないため、JsonValue の constructor で値を組み立てます。構造化出力は putStrLn のテキストと書き込んだ順に並びます。frame の形式と上限は構造化出力を参照してください。次のセルは欠損セルを一つ含む小さな格子場を出力します。

Haskell + WASI

haskell-grid-field

Cell actions
import Oxiquill.Output
let edges values = JsonArray (map JsonNumber values)
displayChart (JsonObject
  [("kind", JsonString "field"), ("xEdges", edges [-2, 0, 3]),
   ("yEdges", edges [-1, 1]),
   ("values", JsonArray [JsonArray [JsonNumber 2, JsonNull]])])

Run the cell to show its output.

以下の種類と設定は、chart schema を拡張します。どの spec も Rust の emit_chart!、Python の display_chart、Haskell の displayChart にそのまま渡せます。例は短く書ける言語で示します。

kind: "xy" と順序付きの layers 配列を使います。各レイヤーには空でない一意の id と kind(line・scatter・band)が必須です。name と各種類の系列 style は省略できます。line・scatter は [x, y]、band は [x, center, lower, upper] と既存の区間・欠損ルールを使います。配列順で描画するため、背景の帯を先に置いてください。

全レイヤーが value/time の X 軸と value/log の Y 軸(既定は両方 value)、範囲、数値書式、注釈を共有します。チャートの style は lineWidth と symbolSize にも対応します。レイヤー別の軸と積み上げは使えません。100,000 件の上限は全レイヤーを合計し、空のレイヤーも 1 件と数えます。表にはレイヤー ID・種類・元の座標・区間端点を表示し、凡例と書き出しは更新後も ID を保持します。

Offset を動かして、接続されない標本と破線の基準曲線、不確実性の帯を比較できます。

Rust + Wasm

mixed-xy-layers

Cell actions
Cell inputs
0.1
let samples: Vec<[f64; 2]> = (0..=4).map(|i| {
    let x = f64::from(i);
    [x, x + offset]
}).collect();
emit_chart!(serde_json::json!({
    "kind": "xy", "title": "Reference and samples", "xLabel": "X", "yLabel": "Y",
    "xMin": 0, "xMax": 4, "yMin": -1, "yMax": 5,
    "annotations": [{ "kind": "line", "axis": "y", "value": 2, "label": "Threshold" }],
    "layers": [
        { "id": "uncertainty", "kind": "band", "name": "Uncertainty", "style": { "color": "#6688bb" },
          "points": [[0, 0, -0.5, 0.5], [2, 2, 1.5, 2.5], [4, 4, 3.5, 4.5]] },
        { "id": "reference", "kind": "line", "name": "Reference", "style": { "lineType": "dashed", "color": { "light": "#225588", "dark": "#88bbff" } },
          "points": [[0, 0], [4, 4]] },
        { "id": "samples", "kind": "scatter", "name": "Samples", "style": { "symbol": "diamond", "color": "#cc6633" },
          "points": samples }
    ]
}));

Waiting for the runtime to start.

Haskell + WASI

haskell-mixed-xy

Cell actions
let point = JsonArray [JsonInteger 0, JsonInteger 1]
    layer = JsonObject [("id", JsonString "samples"), ("kind", JsonString "scatter"),
                        ("points", JsonArray [point])]
displayChart (JsonObject [("kind", JsonString "xy"), ("layers", JsonArray [layer])])

Run the cell to show its output.

bar と area の系列には空でない stack グループを指定できます。正値と負値は value 軸のゼロから別々に積み上がり、棒の欠損は加算されません。同じグループの area は X 座標と順序を一致させ、数値・時刻は昇順にします。tooltip とデータ表は各系列の元の値を示します。百分率への正規化は行いません。

Rust + Wasm

stacked-charts

Cell actions
let series = serde_json::json!([
    { "name": "First", "stack": "total", "points": [[0, 2], [1, -2]] },
    { "name": "Second", "stack": "total", "points": [[0, 3], [1, -3]] }
]);
emit_area_chart!(&series, "Observation", "Amount");
emit_bar_chart!(&["A", "B"], &serde_json::json!([
    { "name": "First", "stack": "total", "values": [2, -2] },
    { "name": "Second", "stack": "total", "values": [3, null] }
]));

Run the cell to show its output.

bar の orientation: "horizontal" は x を数値軸、y をカテゴリ軸にします。ラベル、書式、範囲指定は画面上の x/y に対応し、先頭カテゴリを上に表示します。

Rust + Wasm

horizontal-bars

Cell actions
emit_bar_chart!(&["North America", "South America", "Europe"], &[12, -4, 8],
    options = serde_json::json!({ "orientation": "horizontal", "xLabel": "Change", "yLabel": "Region" }));

Run the cell to show its output.

errorbar と band は [x, center, lower, upper] の点を持ち、lower ≤ center ≤ upper を満たす必要があります。全ての y 値を null にすると欠損になり、帯はそこで分断します。帯の x は昇順の数値・時刻・log 座標、y は value または log です。log の区間は全て正値にします。統計量はセル側で計算してください。

Python + Pyodide

interval-charts

Cell actions
for kind in ("errorbar", "band"):
    display_chart({"kind": kind, "xLabel": "Observation", "yLabel": "Estimate",
        "series": [{"name": "Estimate and interval", "points": [
            [0, -3, -5, -2], [1, 0, -2, 3], [2, 4, 3, 6]]}]})

Run the cell to show its output.

annotations に軸上の線と範囲を指定できます。注釈は軸範囲を拡大せず、表示領域で切り取られます。空データでは明示した軸範囲内に表示できます。カテゴリは既存の名前またはインデックスで参照します。最大100件、ラベルは改行を含まない256 UTF-8 bytes以内のテキストです。

Python + Pyodide

chart-annotations

Cell actions
display_chart({"kind": "line", "xMin": 0, "xMax": 10, "yMin": 0, "yMax": 1,
    "series": [], "annotations": [
        {"kind": "line", "axis": "y", "value": 0.5, "label": "Threshold"},
        {"kind": "range", "axis": "x", "from": 2, "to": 4, "label": "Window"}]})

Run the cell to show its output.

colorMin と colorMax で色範囲を固定できます。colorScale: "diverging" は既定0の center を中間色に置き、自動範囲を中心から対称に取ります。明示した境界は優先され、中心は範囲の内側に必要です。範囲外は端色に飽和し、元の値は表と tooltip に残ります。パレットは style.palette に指定し、発散色では中央色を持つ3色以上の奇数個にします。

Python + Pyodide

heatmap-color-scales

Cell actions
display_chart({"kind": "heatmap", "colorScale": "diverging",
    "colorMin": -2, "colorMax": 8, "center": 0,
    "data": [[0, 0, -2], [1, 0, 0], [2, 0, 8]]})

Run the cell to show its output.

boxplot はカテゴリごとに [min, q1, median, q3, max] の集計済み五数要約を受け取ります。値は有限で昇順、系列の長さはカテゴリ数と一致させます。欠損は null にします。統計量の計算と、ひげの意味の説明は著者が行ってください。

Python + Pyodide

boxplot-charts

Cell actions
display_chart({"kind": "boxplot", "categories": ["First", "Second"],
    "series": [{"name": "Measurements", "values": [
        [-5, -3, -2, 0, 4], [1, 2, 3, 4, 8]]}]},
    caption="Whiskers show the observed minimum and maximum.")

Run the cell to show its output.

bubble の点は [x, y, size] または [x, y, size, color] です。サイズは有限の非負値で、既定では面積比例、直径0–40pxに対応します。0は表示しません。sizeMapping の maxValue、minPixels、maxPixels、scale(area/radius)で対応を指定できます。色値がある場合は colorMapping: { min, max, palette? } が必要で、色の欠損は系列色になります。

Python + Pyodide

bubble-charts

Cell actions
display_chart({"kind": "bubble", "sizeMapping": {"maxValue": 100},
    "colorMapping": {"min": 0, "max": 10},
    "series": [{"name": "Observations", "points": [
        [0, 2, 25, 2], [1, 3, 100, 8], [2, 1, 50, None]]}]})

Run the cell to show its output.

field は有限で単調増加する xEdges と yEdges、行が y、列が x の values を持ちます。行列の寸法は (yEdges.length - 1) × (xEdges.length - 1) です。null は透明な欠損セル、空の格子は3配列全て空で表します。非等間隔の境界を保持し、初期範囲は格子の外周です。補間や等高線は行いません。

Python + Pyodide

grid-field-charts

Cell actions
from math import sin, cos
x_edges = [-3, -1, 0, 0.5, 2, 4]
y_edges = [-2, -0.5, 0, 1, 3]
values = [[sin((x0 + x1) / 2) * cos((y0 + y1) / 2)
    for x0, x1 in zip(x_edges, x_edges[1:])]
    for y0, y1 in zip(y_edges, y_edges[1:])]
display_chart({"kind": "field", "xEdges": x_edges, "yEdges": y_edges,
    "values": values, "xLabel": "X", "yLabel": "Y"})

Run the cell to show its output.

短い説明文には stdout を使います。正確な構造を見せたい場合は JSON、比較可能な record には table、傾向や分布には chart、生成された視覚情報には image、他の artifact で表せない markup には sandboxed HTML を使います。

copy、sort、pagination、validation、running、completion、failure state は keyboard 操作可能で、localized English/Japanese label とともに announce されます。sandboxed HTML には意図的に script/same-origin permission がなく、referrer を送らず、external subresource を default で block します。正確な policy と trust boundary は サポートとセキュリティ を参照してください。

table interaction state は一つの execution result に限定されます。新しい result では page、sort、copy status を reset します。同じ result の rerender は互換性のある sort/page を維持しますが、row が減った場合は clamp 後の page を保存し、sort 対象 column が削除・置換された場合は sort を解除します。

表とグラフは NumberFormat を共有します。significantDigits(1–17)と fractionDigits(0–20)は併用できません。notation は auto、standard、scientific、si、unit はプレーンテキストです。ChartNumberFormat は別名として残ります。standard は指数を使わず、scientific はゼロ以外を指数表示します。SI はヨクトからヨタまでの接頭辞を使い、その範囲外は指数表示します。表ではセルごと、グラフでは軸全体で接頭辞を選びます。fractionDigits を指定した auto 表記では、表もグラフも通常の表記を維持するため、大きな値は整数部をすべて表示し、小さな値は 0 に丸められることがあります。既定の表示は変わりません。

表の列は { key, label, type?, format?, nullText? } です。format は number と integer 列だけに指定できます。nullText はすべての列で使えます。単位は画面と CSV の見出しに Label (unit) と表示され、セルには付かず、値の変換もしません。null は nullText(既定は null)で表示し、CSV では空欄です。表のゼロと負のゼロは 0、既存の固定小数点グラフは末尾のゼロを維持します。精度指定は倍精度数の値を丸め、余分な桁を作りません。並べ替え、数値のツールチップ、コピー、CSV は元の値と数式対策を維持します。

outcome は実行の成否と別に、著者が定めた計算条件の達成を示します。satisfied は達成、partial は未完了、failed は有効な結果なし、unavailable は環境上実行不可です。いずれもコードの実行自体は成功しています。収束を自動判定しません。結果ごとに一つだけ指定でき、他の出力より上にアイコンと翻訳された状態名で表示します。実行完了と計算結果は別々に読み上げます。ワーカーの失敗ではエラーを表示し、失敗前に出力された outcome を成功結果として表示しません。

必須フィールドは kind: "outcome"、state、空白だけではない label(1–256 UTF-8 バイト)です。任意の explanation は 16 KiB、status は 256 バイトで原文表示します。diagnostics は最大 16 件の { name, value, unit? } で、名前は空白だけではない 1–64 バイト、値は有限数、単位は 32 バイトまでです。共通の id、title、caption も使えます。マークアップを含めテキストはそのまま表示します。未知のフィールド、不正な形式、重複 outcome は成果物エラーになり、他の出力は残ります。列のエラーには列番号も含まれます。列の単位と null テキストは 16 KiB のメタデータ制限に従います。

次のセルは整数の件数、指数表示の残差、単位付き固定小数点の量、null の代替テキストを示します。実行後に Iterations を変更すると、前の入力による結果であることを示す表示が出ます。現在の入力で実行が成功するまで表示は残ります。

Rust + Wasm

column-formats

Cell actions
Cell inputs
let residual = 1.0 / f64::from(iterations);
let columns = serde_json::json!([
    { "key": "0", "label": "Count", "type": "integer" },
    { "key": "1", "label": "Residual", "type": "number", "format": { "notation": "scientific", "significantDigits": 3 } },
    { "key": "2", "label": "Time", "type": "number", "format": { "fractionDigits": 2, "unit": "s" } },
    { "key": "3", "label": "Optional", "type": "number", "nullText": "Not measured" }
]);
emit_table_with_columns!(columns, serde_json::json!([
    [iterations, residual, 1.2349, null],
    [iterations, residual, 1.2341, 0]
]));
let outcome = if iterations >= 1000 {
    Outcome::satisfied("Target iteration count reached")
} else {
    Outcome::partial("Iteration limit reached")
        .explanation("Stopped before the demonstration target of 1000 iterations.")
        .status("MaxIterations")
};
emit_outcome!(outcome.diagnostic("residual", residual, None));

Run the cell to show its output.

Rust の emit_table_with_columns! は serde で直列化できる列記述子、従来のラベル文字列、キーとラベルのタプルに対応します。Outcome::satisfied、::partial、::failed、::unavailable を作り、.explanation(...)、.status(...)、.diagnostic(name, value, unit) を連結して emit_outcome! に渡します。

Python の display_table(value, columns=...) にはラベル一覧、または列キー・ラベルから記述子フィールドへのマッピングを渡せます。キーがラベルより優先され、どの列にも一致しないマッピングのエントリはエラー出力になります。通常の行一覧では推定型が unknown なので、数値形式を指定する列には type: "number" も指定します。次の例は環境の制限も明示します。

Python + Pyodide

unavailable-outcome

Cell actions
display_table([[1.234, None]], columns={
    "0": {"label": "Time", "type": "number", "format": {"fractionDigits": 2, "unit": "s"}},
    "1": {"label": "Acceleration", "nullText": "Unavailable"},
})
display_outcome("unavailable", "GPU computation unavailable",
                explanation="This example provides a CPU preview only.", status="NoGpu")

Run the cell to show its output.

Haskell は従来の displayTable に加えて TableColumn と displayTableWith を提供します。tableColumn key label と defaultNumberFormat のレコードを更新して使います。Outcome と OutcomeDiagnostic レコードは displayOutcome で出力します。outcome state label は任意フィールドを空にした初期値を作ります。

Haskell + WASI

satisfied-outcome

Cell actions
import Oxiquill.Output
let quantity = (tableColumn "time" "Time")
      { columnType = Just "number"
      , columnFormat = Just (defaultNumberFormat { fractionDigits = Just 2, unit = Just "s" })
      , columnNullText = Just "Not measured" }
displayTableWith [quantity] [[JsonNumber 1.234], [JsonNull]]
displayOutcome ((outcome "satisfied" "Criterion met")
  { outcomeDiagnostics = [OutcomeDiagnostic "residual" 0.00001 Nothing] })

Run the cell to show its output.

scene3d は点集合と任意の無向辺を、遅延読み込みされる依存ライブラリ不要の Canvas 2D ビューアーで表示します。カメラは正投影です。メッシュ、モデルの読み込み、スクリプト、透視投影には対応しません。

必須フィールドは kind: "scene3d" と points です。edges、groups、axes、camera、id、title、caption は任意です。

フィールド制約
points0〜10,000件。一意の id(UTF-8で1〜64バイト)、有限数3個の position、任意の平文 label(256バイト)と空でない group ID。
edges0〜20,000件の {from, to}。異なる既存の点を参照します。同じ組と逆順の組は重複です。
groups順序付きの {id, label?}。IDは空でなく一意です。未宣言の使用グループは初出順で続き、IDをラベルにします。
axes任意の x、y、z に平文 label と unit(32バイト)を指定できます。
camera有限の角度 yaw、−90〜90の pitch、有限の正数 zoom。既定値は30°、20°、1です。

その他のテキストメタデータは各16 KiBまでです。シーン全体は既存の実行・ワーカーレスポンス上限16 MiBに含まれます。不正な値、未知のフィールド、件数・バイト上限違反は該当する出力だけの診断になります。シーンを暗黙に切り詰めません。マークアップは文字として表示します。

ドラッグで回転、ホイールやピンチで拡大・縮小します。ビューにフォーカスして矢印キーで15°回転、+ / − で拡大・縮小、0 で最新の指定カメラに戻せます。操作方法 を開くと説明を確認できます。グループは既存のチャート配色と丸・四角・三角・ひし形で区別され、凡例で表示切替・単独表示・全表示ができます。アニメーションはありません。

点から12 CSSピクセル以内をクリックまたはタップすると、元の座標と単位を表示します。2点を選ぶとユークリッド距離を測定し、3点目は古い選択を置き換えます。選択済みの点を再び選ぶと解除します。3軸すべてに同一の空白でない単位がある場合だけ距離を表示し、それ以外は計算できない理由を示します。単位は推測しません。

データを表で表示 から全点と全辺を並べ替え・ページ送りし、生の値をCSVで保存できます。点の表にある選択ボタンでも距離を測定でき、凡例で非表示のグループも選べます。PNGは現在のビュー、印刷は全グループの指定初期投影を使います。サイズやテーマ変更ではビューを保持します。同じセルの再実行でも、出力の識別子と点ID集合が同じならカメラと選択を保持し、いずれかが変わるとリセットします。複数出力の並べ替えには明示的な出力IDを使ってください。

以下の四面体では原点から各軸への距離は scale nm、他の辺は sqrt(2) × scale nmです。Scaleを変更してもカメラと選択IDを保持します。

Rust + Wasm

Tetrahedron

Cell actions
Cell inputs
1.0
let points = [
    ("a", [0.0, 0.0, 0.0], "core"),
    ("b", [scale, 0.0, 0.0], "shell"),
    ("c", [0.0, scale, 0.0], "shell"),
    ("d", [0.0, 0.0, scale], "shell"),
].into_iter().map(|(id, position, group)| serde_json::json!({
    "id": id, "position": position, "group": group
})).collect::<Vec<_>>();
emit_scene3d!(serde_json::json!({
    "points": points,
    "edges": [
        {"from": "a", "to": "b"}, {"from": "a", "to": "c"},
        {"from": "a", "to": "d"}, {"from": "b", "to": "c"},
        {"from": "b", "to": "d"}, {"from": "c", "to": "d"}
    ],
    "groups": [{"id": "core", "label": "Core"}, {"id": "shell", "label": "Shell"}],
    "axes": {"x": {"unit": "nm"}, "y": {"unit": "nm"}, "z": {"unit": "nm"}},
    "camera": {"yaw": 30, "pitch": 20, "zoom": 1}
}), metadata = serde_json::json!({"id": "tetrahedron", "title": "Tetrahedron"}));

Waiting for the runtime to start.

Rust の emit_scene3d!(scene, metadata = ...) と Haskell の displayScene3d scene には kind を除いたシーンを渡します。Python は display_scene3d(points, *, edges=None, groups=None, axes=None, camera=None, id=None, title=None, caption=None) を使います。3言語とも kind を追加し、同じ検証を受けます。

Python + Pyodide

Python 3D points

Cell actions
display_scene3d([
    {"id": "a", "position": [0, 0, 0], "label": "Origin"},
    {"id": "b", "position": [1, 0, 0]},
], edges=[{"from": "a", "to": "b"}],
   axes={axis: {"unit": "nm"} for axis in ("x", "y", "z")}, title="Python scene")

Run the cell to show its output.

Haskell + WASI

Haskell 3D points

Cell actions
import Oxiquill.Output
let point name x = JsonObject [("id", JsonString name),
      ("position", JsonArray [JsonNumber x, JsonNumber 0, JsonNumber 0])]
displayScene3d (JsonObject [
    ("title", JsonString "Haskell scene"),
    ("points", JsonArray [point "a" 0, point "b" 1]),
    ("edges", JsonArray [JsonObject [("from", JsonString "a"), ("to", JsonString "b")]])])

Run the cell to show its output.