Skip to main content

alspz

spz(Niantic 3D Gaussian Splat 压缩格式, MIT)的 Cython 绑定,供 ALTiler 3DGS 管线(T-063 输入 / T-069 GS5 SPZ 输出)使用。

构建

cd extern_build/alspz
uv build

依赖:CMake ≥3.15、Cython、numpy;zlib/zstd 缺失时经 FetchContent 自动下载 (需网络,代理环境变量 HTTPS_PROXY 生效)。

值约定(save_spz / load_spz = niantic GaussianCloud 空间)

不是 GSIR 线性空间,也不是 Cesium 最终显示值。完整链见仓库 docs/31_output_gs3dtiles.md (wasm unpack 之后 JS 还要对 scale 做 exp、对 alpha 做 sigmoid)。 load_spz 还原的是本表,不要用「alphas ∈ [0,1]」当 Cesium 验收。

字段 约定
scale log(m 的自然对数)——wasm 还原 log,Cesium JS Math.exp 后才进协方差
alpha logit(sigmoid 前)——wasm invSigmoid 还原 logit,Cesium JS 再 sigmoid 后 ×255;传线性会把近 0 噪声抬到 ~0.5
color SH DC f_dc(禁止 0.5+C0·f_dc;pack 为 f_dc*0.15*255+127.5)
rot 单位四元数 xyzw
sh (系数, RGB) 交织 = 3DGS f_rest 顺序;degree 0/1/2/3/4
坐标 UNSPECIFIED(无转换,约定处理在 Python 侧;对齐 CesiumJS GltfSpzLoader 的解码参数)

注意事项

  • 构建启用 SPZ_BUILD_EXTENSIONS(读第三方带坐标扩展的 spz 时可正确转换)。
  • 绑定不按值返回任何 C++ struct(AGENTS.md §5.4.21 教训),全部指针传出。

Metadata

Release files for alspz 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alspz 0.2.0
File Size Uploaded Provenance Actions
alspz-0.2.0.tar.gz 50.8 kB Without provenance Details for alspz-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for alspz 0.2.0
File Interpreter ABI Platform Actions
alspz-0.2.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for alspz-0.2.0-cp311-cp311-win_amd64.whl

Total release size: 1.8 MB

Release files / alspz-0.2.0.tar.gz

Download URL alspz-0.2.0.tar.gz
Size 50.8 kB
Tags Source
SHA-256 checksum
How to use checksums
666531ebbf1c5c402b01467c0e5a4dcb0a06166fbb4e3300079ddc7819490e94
BLAKE2b-256 checksum
How to use checksums
28f56fe6be393bf80b772e776a5353bb455a3aa976aa85a867e7d3bcdf2f569b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / alspz-0.2.0-cp311-cp311-win_amd64.whl

Download URL alspz-0.2.0-cp311-cp311-win_amd64.whl
Size 1.8 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
c3dc8ca7f3ba01cd47a71946c6fddbdd080b8961029db7572f0e3a168e8e84cb
BLAKE2b-256 checksum
How to use checksums
1934562a97807bfb9587a8a6a6abc9df3908c1c03b0417f7f3e40163108284b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Security for alspz 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page