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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.