shape_explained_variance — SHAPESTAT model op

数据种类:shapemodelsignal

调用: import fullseye as fs; fs.ledger.shape_explained_variance(model)(要直接调用实现,import shapestats; shapestats.shape_explained_variance(model);从台账取用则 opsshapestat.get("shape_explained_variance"))

用法

> 该算子的说明尚无译文,以下照原文给出。

各主成分の寄与率(合計 1)。→ `(k,)`。

式: `variance / total_variance。分母は model["total_variance"](shape_pca`

特異値から計算した総分散)で、無ければ `variance.sum()`。

• `model: shape_pca の返り値。必須キーが無ければ ValueError`。

• 返り値: `(k,) float64、各要素は [0, 1]shape_pca(n_components=0)`

(全成分)なら合計は 1。**`n_components` で打ち切ったモデルでは合計が 1 未満**

になる(切り捨てた成分の分だけ足りない)―― 「上位 k 本でどれだけ説明できるか」

を読むにはむしろその方が正しい。

• 総分散が 0(全個体が同じ形)なら全要素 0 を返す(0 除算にしない)。

`shape_pca の分散は標本分散(K-1` で割る)なので、個体数が少ないと

固有値の絶対値は膨らむが、比であるこの量は影響を受けにくい。累積和

(`cumsum)で「99 % に何本要るか」を決め、shape_mahalanobiscumulative`

や `shape_synthesizen_modes` に渡す。

详细使用指南

shape_statistics 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南

可运行的示例(实际调用该算子并已验证的样例)

shapestat_landmark_tourpy -3.11 examples/shapestat_landmark_tour.py

类型可衔接的下一个算子(可接受 signal 作为输入)

shape_reconstruct

同类别(model)

shape_pca · shape_project · shape_reconstruct · shape_mahalanobis · shape_synthesize


*Provenance: shapestats.py — SHAPESTAT 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.