tree_sholl — GRAPH tree op

• Data kinds: table → table

• Call: import fullseye as fs; fs.ledger.tree_sholl(tree, radii=None, n_radii=50, plane=None, center=None) (implementation को सीधे call करना हो तो import treemorph; treemorph.tree_sholl(tree, radii=None, n_radii=50, plane=None, center=None), registry से लेना हो तो opsgraph.get("tree_sholl"))

उपयोग

Sholl analysis: root के चारों ओर spheres (3-D) या circles (projection) को पार करने वाले segments।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

radii are the shell radii (ascending, positive); if omitted, n_radii shells at the mid-points of equal steps up to the largest distance from the centre (never exactly on a node's distance). A shell passing exactly through a node is ambiguous under rounding — a rotation may move that node by one ulp to either side. plane=None measures in 3-D; plane="xy" | "xz" | "yz" drops the third axis first — what a single image sees. center defaults to the root position.

A segment (parent-child) crosses radius r when its end points lie strictly on opposite sides of r (the endpoint rule). Returns radii, crossings (int array), max_crossings, radius_at_max and integral — the exact area under the whole continuous Sholl curve, computed from the segments' intervals (independent of where the shells are placed).

Identities: in 3-D the crossings are invariant, integer for integer, under any rotation about the centre; and integral equals sum |d_child - d_parent| (the tests also check that the mid-point sum of the sampled crossings converges to it — a second implementation).

Raises ValueError: not a tree table; plane not one of None/xy/xz/yz; radii not 1-D, not finite, not positive or not strictly increasing; n_radii < 1.

संदर्भ (sample data, साहित्य)

• 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 में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_swc_tree_truth — py -3.11 examples/poc_swc_tree_truth.py

• poc_worm_neurites_grow — py -3.11 examples/poc_worm_neurites_grow.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

graph_edge_consensus · graph_core_persistence · tree_morphometry · tree_run_length

इसी category के (tree)

tree_from_swc · tree_morphometry · tree_run_length


*Provenance: treemorph.py — GRAPH operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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