graph_rich_club_curve — GRAPH core op

• Data kinds: matrix → table

• Call: import fullseye as fs; fs.ledger.graph_rich_club_curve(adj, mode='total', n_null=20, swaps_per_edge=5, seed=0) (implementation को सीधे call करना हो तो import graphinv; graphinv.graph_rich_club_curve(adj, mode='total', n_null=20, swaps_per_edge=5, seed=0), registry से लेना हो तो opsgraph.get("graph_rich_club_curve"))

उपयोग

degree-preserving null के सापेक्ष हर k के लिए rich-club coefficient φ(k)।

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

φ(k) is the directed density of the subgraph spanned by the nodes whose degree exceeds

k: edges among them / (r (r − 1)), r = their number (Colizza et al. 2006; the same formula as conngraph.graph_rich_club, here for all k at once). mode is the degree used to rank nodes: "total" (in + out), "in" or "out" (Yadav & Singh 2026 rank by in- and out-degree separately). A rising φ(k) alone means little — high-degree nodes are dense in any graph — so φ is divided by its mean over n_null rewirings that keep every node's in- and out-degree exactly (Maslov & Sneppen 2002; every sample is checked, fail-closed). ratio > 1 is the rich-club regime; Towlson et al. 2013 call it significant where ratio > 1 + sd.

Returns a dict: k (all integers 0 .. max degree − 1), count (nodes with degree

> k), phi, null_mean, null_sd, ratio (nan where the null mean is 0),

z, regime (bool: ratio > 1 + null sd of the ratio), n_null, mode.

Identities: phi[k] == conngraph.graph_rich_club(adj, k) for every k with mode="total"; a complete graph has phi == 1 and ratio == 1 everywhere (no swap can change it); a rewired sample of the graph itself has ratio ≈ 1.

Raises ValueError: as graph_degree_preserving_null (non-square, negative, ... ; n_null < 2; swaps_per_edge < 1; fewer than 2 edges); mode not in / out / total.

संदर्भ (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_worm_core_persists — py -3.11 examples/poc_worm_core_persists.py

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

graph_edge_consensus · graph_core_persistence · tree_morphometry · tree_sholl · tree_run_length

इसी category के (core)

graph_kcore


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

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