gsplat op• Data kinds: table → table
• Call: import fullseye as fs; fs.ledger.gs_viewer_html(gs, out_path=None, *, title='3D Gaussian Splatting', lang=('ja', 'en', 'zh', 'tw', 'ko', 'de', 'hi', 'fr'), note=None, hotspots=None, dims=True, unit_mm: 'float' = 1000.0, up=(0.0, 0.0, 1.0), bg: 'str' = 'gray', max_bytes: 'int' = 16777216, fov_deg: 'float' = 35.0, camera=None, spin: 'bool' = True, spin_deg_per_s: 'float' = 20.0, bake_light=(0.3, -0.5, 0.8), ambient: 'float' = 0.35, max_radius: 'int' = 64, mobile_quality=0.5, mobile_above: 'int' = 300000) -> 'dict' (implementation को सीधे call करना हो तो import gsviewer; gsviewer.gs_viewer_html(gs, out_path=None, *, title='3D Gaussian Splatting', lang=('ja', 'en', 'zh', 'tw', 'ko', 'de', 'hi', 'fr'), note=None, hotspots=None, dims=True, unit_mm: 'float' = 1000.0, up=(0.0, 0.0, 1.0), bg: 'str' = 'gray', max_bytes: 'int' = 16777216, fov_deg: 'float' = 35.0, camera=None, spin: 'bool' = True, spin_deg_per_s: 'float' = 20.0, bake_light=(0.3, -0.5, 0.8), ambient: 'float' = 0.35, max_radius: 'int' = 64, mobile_quality=0.5, mobile_above: 'int' = 300000) -> 'dict', registry से लेना हो तो opsdrive.get("gs_viewer_html"))
• GPU: नहीं (केवल CPU reference implementation)
3DGS को एक स्व-निहित HTML पेज बनाता है जिसे browser में घुमाकर देखा जा सके (कोई external URL या CDN नहीं, offline चलता है)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
データは位置 3×u16(軸ごとの範囲)・log 大きさ 3×u16・四元数 4×u8・RGBA 4×u8 = 1 個 20 バイトに量子化し、gzip → base64 でページに埋める。ブラウザは DecompressionStream('gzip') で伸ばし、WebGL2 のインスタンス化した四角形で描く。2-D 共分散は gsplatnp.gs_render と同じ Σ' = J W Σ Wᵀ Jᵀ + 0.3 px²(不透明度は √(det Σ / det(Σ + 0.3 I)) 倍)、窓は中心の丸めから ±⌈3√λ_max⌉ 画素(≤ max_radius)、手前から C = Σ c_i α_i T_i(半精度の浮動小数のバッファに足してから背景を合成)。前後の並べ替えは Web Worker が視点の変わったときだけ行う(ガウシアンの中心の深さを 16 bit の桶で数える)。
商品の閲覧の機能: ドラッグで回す(慣性つき)・ホイール / ピンチで拡大・自動の回転台(触ると止まる)・視点のプリセット(正面 / 側面 / 上 / 斜め)・背景(白 / 灰 / 黒)・注記点(押すと説明が開く、8 言語)・寸法(W × D × H mm)・不透明度のしきい値・品質つまみ(ガウシアンの数を重要度の高い順に減らす、スマホの既定 mobile_quality)。URL でも開ける: ?lang=en&bg=white&view=front&dims=1&hs=0&spin=0&quality=0.5。
gs : dict または パス
gsplatnp.gs_read_file / gsplatnp.gs_from_world の dict、または .ply / .splat のパス。
out_path : str または None
書き出す先。None なら書かずに返り値の html に入れる。
title, note : str または {lang: str}
題と、ページの「この表示について」に出す注記(例: 「メッシュから初期化した 3DGS で、写真から学習したものではない」)。
lang : str または 言語の並び
LANGS(ja, en, zh, tw, ko, de, hi, fr)の部分集合。先頭が既定、?lang と navigator.language で選ぶ。
hotspots : [{"pos": (x, y, z), "label": str|{lang}, "desc": str|{lang}}]
注記点。辞書で渡すなら要求した言語が全部要る(黙って補わない)。
dims : bool または {"upright", "obb"}
寸法を出すか。True = "upright"(上向きを H に固定した最小の箱)、"obb" = 向き自由の最小体積の箱。
どちらも向きは measure3d.smallest_box3 が決め、大きさは全部の不透明なガウシアンの中心で測る。
unit_mm : float
座標の 1 単位が何 mm か(既定 1000 = メートル)。
up : (3,)
上向きの軸(回転台の軸、寸法の H)。
bg : {"white", "gray", "black"}
最初の背景。
max_bytes : int
埋め込むデータの上限(base64 後のバイト数、既定 16 MB)。超えたら不透明度・大きさの小さい順に間引く。
fov_deg, camera, spin, spin_deg_per_s :
縦の画角・最初の視点({"yaw", "pitch", "dist", "target"} の一部でよい)・回転台を回して開くか・その速さ。
bake_light, ambient :
gs_from_world の dict のとき、世界の座標の光で陰影を色へ焼き込む(gs_render と同じ Lambert)。None で焼かない。
max_radius : int
1 個の窓の半径の上限(画素、gs_render の max_radius と同じ意味)。
mobile_quality, mobile_above : float または None, int
指で触る端末(pointer: coarse)で、ガウシアンが mobile_above 個を超えるときに最初に描く割合。
None なら全部。品質つまみは重要度の順(間引きと同じ順)の先頭から描くので、小さな部品から消える。
dict
path・bytes(HTML の大きさ)・n_input・n_kept・n_dropped・thinned・thinning(間引きの記録)・
dims_mm(W, D, H)・dims(箱の 8 隅つき)・camera・sh_degree_in・sh_degree_used(= 0)・
sh_dropped・embedded_bytes・external_urls(= 0 を確かめた数)。out_path が None なら html も。
ValueError
gs が空・形が合わない・非有限、未対応の言語、文言の言語の欠け、bg が 3 色以外、上限に 1 個も入らない。
空の入力(gs が空の dict)は ValueError。
>>> import gsplatnp, gsviewer
>>> r = gsviewer.gs_viewer_html("scene.ply", "view.html", title="My product") # doctest: +SKIP
>>> r["n_kept"], r["dims_mm"] # doctest: +SKIP
CLI: py -3.11 -m gsviewer in.ply --out view.html --title "My product"。
• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।
• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।
• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।
• gsplat_product_viewer — py -3.11 examples/gsplat_product_viewer.py
• gsplat_trained_product — py -3.11 examples/gsplat_trained_product.py
table को input के रूप में लेते हैं)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
gsplat)gs_from_world · gs_update · gs_render · gs_render_fn · gs_read_file · gs_catalog_html
*Provenance: gsviewer.py — DRIVE operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.