curve op• Data kinds: points → measurement
• Call: import fullseye as fs; fs.ledger.arc_length(curve) (to call the implementation directly, import curve3d; curve3d.arc_length(curve); from the registry, ops3d.get("arc_length"))
• Return value through the ledger: fullseye.ledger.arc_length(...) returns **only the declared out type measurement** (the underlying function also returns auxiliary values). When you need what was dropped, use fullseye.ledger.arc_length.raw(...) or call curve3d.arc_length directly.
• Underlying return: (cumulative, total) → 全長 float
The cumulative arc length of a curve and its total. → (cumulative (N,), total float).
> The detailed description below is the original text — the summary and the headings are translated.
順序付き点列 `curve` (N,3) を index 順に折れ線とみなし、隣接点間のユークリッド距離
を累積する。`cumulative[0]=0、cumulative[i]` = 先頭から i 番目までの折れ線長、
`total = cumulative[-1]`。単位は座標と同じ。
• 入力は `float` に変換されるだけで形状検証は無い(列数が 3 以外でも計算は通る)。
• N=1 では `cumulative=[0.0]・total=0.0`。閉曲線でも終点→始点の区間は数えない
(閉じたい場合は先頭点を末尾に複製してから渡す)。
• 重複点(距離 0 の区間)はそのまま 0 として累積されるので `cumulative` は単調非減少
だが狭義増加ではない。
`resample_uniform` はこの累積弧長をパラメータに線形補間する。曲率の弧長積分など
`curvature_torsion` と組み合わせるときの ds はこの差分から取る。
• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).
• Operator provenance and references — the sources of the research/methods this op family came from.
• space_curve — py -3.11 examples_3d/space_curve.py
• torus_knot_curve — py -3.11 examples_3d/torus_knot_curve.py
measurement as input)vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle
curve)curvature_torsion · frenet_frame · resample_uniform · fit_spline_curve
*Provenance: curve3d.py — 3D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.