okstra 0.130.4 → 0.131.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/README.md +0 -1
  2. package/docs/architecture.md +2 -2
  3. package/docs/cli.md +1 -1
  4. package/docs/for-ai/README.md +0 -2
  5. package/docs/for-ai/skills/okstra-run.md +13 -2
  6. package/docs/for-ai/skills/okstra-setup.md +4 -1
  7. package/docs/project-structure-overview.md +5 -4
  8. package/docs/task-process/implementation-planning.md +13 -0
  9. package/docs/task-process/implementation.md +17 -2
  10. package/package.json +1 -1
  11. package/runtime/BUILD.json +2 -2
  12. package/runtime/agents/workers/report-writer-worker.md +7 -0
  13. package/runtime/bin/lib/okstra/usage.sh +4 -4
  14. package/runtime/prompts/lead/okstra-lead-contract.md +2 -2
  15. package/runtime/prompts/lead/plan-body-verification.md +26 -5
  16. package/runtime/prompts/lead/report-writer.md +6 -2
  17. package/runtime/prompts/profiles/_common-contract.md +2 -1
  18. package/runtime/prompts/profiles/_implementation-deliverable.md +6 -1
  19. package/runtime/prompts/profiles/_implementation-executor.md +2 -2
  20. package/runtime/prompts/profiles/_implementation-verifier.md +33 -10
  21. package/runtime/prompts/profiles/final-verification.md +21 -6
  22. package/runtime/prompts/profiles/implementation-planning.md +16 -4
  23. package/runtime/python/okstra_ctl/codex_dispatch.py +31 -0
  24. package/runtime/python/okstra_ctl/conformance.py +49 -11
  25. package/runtime/python/okstra_ctl/report_finalize.py +52 -1
  26. package/runtime/python/okstra_ctl/run.py +15 -3
  27. package/runtime/python/okstra_ctl/worker_prompt_contract.py +14 -6
  28. package/runtime/python/okstra_ctl/worker_prompt_policy.py +19 -1
  29. package/runtime/python/okstra_vendor/__init__.py +0 -44
  30. package/runtime/schemas/final-report-v1.0.schema.json +99 -5
  31. package/runtime/skills/okstra-run/SKILL.md +11 -4
  32. package/runtime/skills/okstra-setup/SKILL.md +3 -2
  33. package/runtime/skills/okstra-setup/references/project-config.md +16 -7
  34. package/runtime/templates/reports/final-report.template.md +15 -9
  35. package/runtime/templates/reports/i18n/en.json +1 -0
  36. package/runtime/templates/reports/i18n/ko.json +1 -0
  37. package/runtime/validators/lib/fixtures.sh +6 -0
  38. package/runtime/validators/validate-run.py +2019 -96
  39. package/src/cli-registry.mjs +0 -7
  40. package/src/commands/lifecycle/doctor.mjs +0 -9
  41. package/src/lib/skill-catalog.mjs +0 -1
  42. package/docs/for-ai/skills/okstra-graphify.md +0 -64
  43. package/runtime/python/okstra_ctl/graphify_cmd.py +0 -225
  44. package/runtime/python/okstra_vendor/graphify/.vendored-version +0 -1
  45. package/runtime/python/okstra_vendor/graphify/__init__.py +0 -28
  46. package/runtime/python/okstra_vendor/graphify/__main__.py +0 -1371
  47. package/runtime/python/okstra_vendor/graphify/analyze.py +0 -540
  48. package/runtime/python/okstra_vendor/graphify/benchmark.py +0 -129
  49. package/runtime/python/okstra_vendor/graphify/build.py +0 -107
  50. package/runtime/python/okstra_vendor/graphify/cache.py +0 -169
  51. package/runtime/python/okstra_vendor/graphify/cluster.py +0 -137
  52. package/runtime/python/okstra_vendor/graphify/detect.py +0 -510
  53. package/runtime/python/okstra_vendor/graphify/export.py +0 -1014
  54. package/runtime/python/okstra_vendor/graphify/extract.py +0 -3277
  55. package/runtime/python/okstra_vendor/graphify/hooks.py +0 -220
  56. package/runtime/python/okstra_vendor/graphify/ingest.py +0 -297
  57. package/runtime/python/okstra_vendor/graphify/manifest.py +0 -4
  58. package/runtime/python/okstra_vendor/graphify/report.py +0 -175
  59. package/runtime/python/okstra_vendor/graphify/security.py +0 -203
  60. package/runtime/python/okstra_vendor/graphify/serve.py +0 -373
  61. package/runtime/python/okstra_vendor/graphify/skill-aider.md +0 -1184
  62. package/runtime/python/okstra_vendor/graphify/skill-claw.md +0 -1184
  63. package/runtime/python/okstra_vendor/graphify/skill-codex.md +0 -1242
  64. package/runtime/python/okstra_vendor/graphify/skill-copilot.md +0 -1268
  65. package/runtime/python/okstra_vendor/graphify/skill-droid.md +0 -1239
  66. package/runtime/python/okstra_vendor/graphify/skill-kiro.md +0 -1183
  67. package/runtime/python/okstra_vendor/graphify/skill-opencode.md +0 -1238
  68. package/runtime/python/okstra_vendor/graphify/skill-trae.md +0 -1208
  69. package/runtime/python/okstra_vendor/graphify/skill-vscode.md +0 -253
  70. package/runtime/python/okstra_vendor/graphify/skill-windows.md +0 -1245
  71. package/runtime/python/okstra_vendor/graphify/skill.md +0 -1319
  72. package/runtime/python/okstra_vendor/graphify/transcribe.py +0 -182
  73. package/runtime/python/okstra_vendor/graphify/validate.py +0 -72
  74. package/runtime/python/okstra_vendor/graphify/watch.py +0 -188
  75. package/runtime/python/okstra_vendor/graphify/wiki.py +0 -214
  76. package/runtime/python/okstra_vendor/networkx/__init__.py +0 -62
  77. package/runtime/python/okstra_vendor/networkx/algorithms/__init__.py +0 -134
  78. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/__init__.py +0 -26
  79. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/clique.py +0 -259
  80. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/clustering_coefficient.py +0 -71
  81. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/connectivity.py +0 -412
  82. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/density.py +0 -396
  83. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/distance_measures.py +0 -150
  84. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/dominating_set.py +0 -149
  85. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/kcomponents.py +0 -369
  86. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/matching.py +0 -44
  87. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/maxcut.py +0 -143
  88. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/ramsey.py +0 -53
  89. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/steinertree.py +0 -265
  90. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/traveling_salesman.py +0 -1508
  91. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/treewidth.py +0 -255
  92. package/runtime/python/okstra_vendor/networkx/algorithms/approximation/vertex_cover.py +0 -83
  93. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/__init__.py +0 -5
  94. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/connectivity.py +0 -122
  95. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/correlation.py +0 -302
  96. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/mixing.py +0 -255
  97. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/neighbor_degree.py +0 -160
  98. package/runtime/python/okstra_vendor/networkx/algorithms/assortativity/pairs.py +0 -127
  99. package/runtime/python/okstra_vendor/networkx/algorithms/asteroidal.py +0 -164
  100. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/__init__.py +0 -88
  101. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/basic.py +0 -322
  102. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/centrality.py +0 -290
  103. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/cluster.py +0 -289
  104. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/covering.py +0 -57
  105. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/edgelist.py +0 -360
  106. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/extendability.py +0 -105
  107. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/generators.py +0 -603
  108. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/link_analysis.py +0 -316
  109. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/matching.py +0 -590
  110. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/matrix.py +0 -232
  111. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/projection.py +0 -526
  112. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/redundancy.py +0 -112
  113. package/runtime/python/okstra_vendor/networkx/algorithms/bipartite/spectral.py +0 -69
  114. package/runtime/python/okstra_vendor/networkx/algorithms/boundary.py +0 -168
  115. package/runtime/python/okstra_vendor/networkx/algorithms/bridges.py +0 -205
  116. package/runtime/python/okstra_vendor/networkx/algorithms/broadcasting.py +0 -164
  117. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/__init__.py +0 -20
  118. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/betweenness.py +0 -591
  119. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/betweenness_subset.py +0 -236
  120. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/closeness.py +0 -282
  121. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_betweenness.py +0 -364
  122. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_betweenness_subset.py +0 -227
  123. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/current_flow_closeness.py +0 -96
  124. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/degree_alg.py +0 -150
  125. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/dispersion.py +0 -107
  126. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/eigenvector.py +0 -357
  127. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/flow_matrix.py +0 -130
  128. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/group.py +0 -787
  129. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/harmonic.py +0 -88
  130. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/katz.py +0 -331
  131. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/laplacian.py +0 -150
  132. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/load.py +0 -200
  133. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/percolation.py +0 -128
  134. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/reaching.py +0 -209
  135. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/second_order.py +0 -141
  136. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/subgraph_alg.py +0 -361
  137. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/trophic.py +0 -181
  138. package/runtime/python/okstra_vendor/networkx/algorithms/centrality/voterank_alg.py +0 -95
  139. package/runtime/python/okstra_vendor/networkx/algorithms/chains.py +0 -172
  140. package/runtime/python/okstra_vendor/networkx/algorithms/chordal.py +0 -443
  141. package/runtime/python/okstra_vendor/networkx/algorithms/clique.py +0 -818
  142. package/runtime/python/okstra_vendor/networkx/algorithms/cluster.py +0 -732
  143. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/__init__.py +0 -4
  144. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/equitable_coloring.py +0 -505
  145. package/runtime/python/okstra_vendor/networkx/algorithms/coloring/greedy_coloring.py +0 -565
  146. package/runtime/python/okstra_vendor/networkx/algorithms/communicability_alg.py +0 -163
  147. package/runtime/python/okstra_vendor/networkx/algorithms/community/__init__.py +0 -28
  148. package/runtime/python/okstra_vendor/networkx/algorithms/community/asyn_fluid.py +0 -153
  149. package/runtime/python/okstra_vendor/networkx/algorithms/community/bipartitions.py +0 -354
  150. package/runtime/python/okstra_vendor/networkx/algorithms/community/centrality.py +0 -171
  151. package/runtime/python/okstra_vendor/networkx/algorithms/community/community_utils.py +0 -30
  152. package/runtime/python/okstra_vendor/networkx/algorithms/community/divisive.py +0 -216
  153. package/runtime/python/okstra_vendor/networkx/algorithms/community/kclique.py +0 -79
  154. package/runtime/python/okstra_vendor/networkx/algorithms/community/label_propagation.py +0 -338
  155. package/runtime/python/okstra_vendor/networkx/algorithms/community/leiden.py +0 -162
  156. package/runtime/python/okstra_vendor/networkx/algorithms/community/local.py +0 -220
  157. package/runtime/python/okstra_vendor/networkx/algorithms/community/louvain.py +0 -384
  158. package/runtime/python/okstra_vendor/networkx/algorithms/community/lukes.py +0 -227
  159. package/runtime/python/okstra_vendor/networkx/algorithms/community/modularity_max.py +0 -452
  160. package/runtime/python/okstra_vendor/networkx/algorithms/community/quality.py +0 -347
  161. package/runtime/python/okstra_vendor/networkx/algorithms/components/__init__.py +0 -6
  162. package/runtime/python/okstra_vendor/networkx/algorithms/components/attracting.py +0 -115
  163. package/runtime/python/okstra_vendor/networkx/algorithms/components/biconnected.py +0 -394
  164. package/runtime/python/okstra_vendor/networkx/algorithms/components/connected.py +0 -282
  165. package/runtime/python/okstra_vendor/networkx/algorithms/components/semiconnected.py +0 -71
  166. package/runtime/python/okstra_vendor/networkx/algorithms/components/strongly_connected.py +0 -359
  167. package/runtime/python/okstra_vendor/networkx/algorithms/components/weakly_connected.py +0 -196
  168. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/__init__.py +0 -11
  169. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/connectivity.py +0 -811
  170. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/cuts.py +0 -616
  171. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/disjoint_paths.py +0 -408
  172. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/edge_augmentation.py +0 -1270
  173. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/edge_kcomponents.py +0 -592
  174. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/kcomponents.py +0 -220
  175. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/kcutsets.py +0 -235
  176. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/stoerwagner.py +0 -152
  177. package/runtime/python/okstra_vendor/networkx/algorithms/connectivity/utils.py +0 -88
  178. package/runtime/python/okstra_vendor/networkx/algorithms/core.py +0 -588
  179. package/runtime/python/okstra_vendor/networkx/algorithms/covering.py +0 -142
  180. package/runtime/python/okstra_vendor/networkx/algorithms/cuts.py +0 -416
  181. package/runtime/python/okstra_vendor/networkx/algorithms/cycles.py +0 -1234
  182. package/runtime/python/okstra_vendor/networkx/algorithms/d_separation.py +0 -677
  183. package/runtime/python/okstra_vendor/networkx/algorithms/dag.py +0 -1392
  184. package/runtime/python/okstra_vendor/networkx/algorithms/distance_measures.py +0 -1095
  185. package/runtime/python/okstra_vendor/networkx/algorithms/distance_regular.py +0 -272
  186. package/runtime/python/okstra_vendor/networkx/algorithms/dominance.py +0 -142
  187. package/runtime/python/okstra_vendor/networkx/algorithms/dominating.py +0 -268
  188. package/runtime/python/okstra_vendor/networkx/algorithms/efficiency_measures.py +0 -167
  189. package/runtime/python/okstra_vendor/networkx/algorithms/euler.py +0 -470
  190. package/runtime/python/okstra_vendor/networkx/algorithms/flow/__init__.py +0 -11
  191. package/runtime/python/okstra_vendor/networkx/algorithms/flow/boykovkolmogorov.py +0 -370
  192. package/runtime/python/okstra_vendor/networkx/algorithms/flow/capacityscaling.py +0 -407
  193. package/runtime/python/okstra_vendor/networkx/algorithms/flow/dinitz_alg.py +0 -238
  194. package/runtime/python/okstra_vendor/networkx/algorithms/flow/edmondskarp.py +0 -241
  195. package/runtime/python/okstra_vendor/networkx/algorithms/flow/gomory_hu.py +0 -178
  196. package/runtime/python/okstra_vendor/networkx/algorithms/flow/maxflow.py +0 -611
  197. package/runtime/python/okstra_vendor/networkx/algorithms/flow/mincost.py +0 -356
  198. package/runtime/python/okstra_vendor/networkx/algorithms/flow/networksimplex.py +0 -662
  199. package/runtime/python/okstra_vendor/networkx/algorithms/flow/preflowpush.py +0 -425
  200. package/runtime/python/okstra_vendor/networkx/algorithms/flow/shortestaugmentingpath.py +0 -300
  201. package/runtime/python/okstra_vendor/networkx/algorithms/flow/utils.py +0 -194
  202. package/runtime/python/okstra_vendor/networkx/algorithms/graph_hashing.py +0 -435
  203. package/runtime/python/okstra_vendor/networkx/algorithms/graphical.py +0 -483
  204. package/runtime/python/okstra_vendor/networkx/algorithms/hierarchy.py +0 -57
  205. package/runtime/python/okstra_vendor/networkx/algorithms/hybrid.py +0 -196
  206. package/runtime/python/okstra_vendor/networkx/algorithms/isolate.py +0 -107
  207. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/__init__.py +0 -7
  208. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/ismags.py +0 -1306
  209. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/isomorph.py +0 -336
  210. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/isomorphvf2.py +0 -1262
  211. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/matchhelpers.py +0 -352
  212. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/temporalisomorphvf2.py +0 -308
  213. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/tree_isomorphism.py +0 -264
  214. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/vf2pp.py +0 -1102
  215. package/runtime/python/okstra_vendor/networkx/algorithms/isomorphism/vf2userfunc.py +0 -192
  216. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/__init__.py +0 -2
  217. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/hits_alg.py +0 -337
  218. package/runtime/python/okstra_vendor/networkx/algorithms/link_analysis/pagerank_alg.py +0 -498
  219. package/runtime/python/okstra_vendor/networkx/algorithms/link_prediction.py +0 -687
  220. package/runtime/python/okstra_vendor/networkx/algorithms/lowest_common_ancestors.py +0 -280
  221. package/runtime/python/okstra_vendor/networkx/algorithms/matching.py +0 -1148
  222. package/runtime/python/okstra_vendor/networkx/algorithms/minors/__init__.py +0 -27
  223. package/runtime/python/okstra_vendor/networkx/algorithms/minors/contraction.py +0 -738
  224. package/runtime/python/okstra_vendor/networkx/algorithms/mis.py +0 -78
  225. package/runtime/python/okstra_vendor/networkx/algorithms/moral.py +0 -59
  226. package/runtime/python/okstra_vendor/networkx/algorithms/node_classification.py +0 -219
  227. package/runtime/python/okstra_vendor/networkx/algorithms/non_randomness.py +0 -155
  228. package/runtime/python/okstra_vendor/networkx/algorithms/operators/__init__.py +0 -4
  229. package/runtime/python/okstra_vendor/networkx/algorithms/operators/all.py +0 -324
  230. package/runtime/python/okstra_vendor/networkx/algorithms/operators/binary.py +0 -468
  231. package/runtime/python/okstra_vendor/networkx/algorithms/operators/product.py +0 -633
  232. package/runtime/python/okstra_vendor/networkx/algorithms/operators/unary.py +0 -77
  233. package/runtime/python/okstra_vendor/networkx/algorithms/perfect_graph.py +0 -73
  234. package/runtime/python/okstra_vendor/networkx/algorithms/planar_drawing.py +0 -464
  235. package/runtime/python/okstra_vendor/networkx/algorithms/planarity.py +0 -1463
  236. package/runtime/python/okstra_vendor/networkx/algorithms/polynomials.py +0 -306
  237. package/runtime/python/okstra_vendor/networkx/algorithms/reciprocity.py +0 -98
  238. package/runtime/python/okstra_vendor/networkx/algorithms/regular.py +0 -167
  239. package/runtime/python/okstra_vendor/networkx/algorithms/richclub.py +0 -138
  240. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/__init__.py +0 -5
  241. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/astar.py +0 -239
  242. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/dense.py +0 -264
  243. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/generic.py +0 -716
  244. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/unweighted.py +0 -625
  245. package/runtime/python/okstra_vendor/networkx/algorithms/shortest_paths/weighted.py +0 -2542
  246. package/runtime/python/okstra_vendor/networkx/algorithms/similarity.py +0 -2107
  247. package/runtime/python/okstra_vendor/networkx/algorithms/simple_paths.py +0 -966
  248. package/runtime/python/okstra_vendor/networkx/algorithms/smallworld.py +0 -404
  249. package/runtime/python/okstra_vendor/networkx/algorithms/smetric.py +0 -30
  250. package/runtime/python/okstra_vendor/networkx/algorithms/sparsifiers.py +0 -296
  251. package/runtime/python/okstra_vendor/networkx/algorithms/structuralholes.py +0 -374
  252. package/runtime/python/okstra_vendor/networkx/algorithms/summarization.py +0 -564
  253. package/runtime/python/okstra_vendor/networkx/algorithms/swap.py +0 -406
  254. package/runtime/python/okstra_vendor/networkx/algorithms/threshold.py +0 -981
  255. package/runtime/python/okstra_vendor/networkx/algorithms/time_dependent.py +0 -142
  256. package/runtime/python/okstra_vendor/networkx/algorithms/tournament.py +0 -406
  257. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/__init__.py +0 -5
  258. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/beamsearch.py +0 -90
  259. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/breadth_first_search.py +0 -576
  260. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/depth_first_search.py +0 -529
  261. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/edgebfs.py +0 -185
  262. package/runtime/python/okstra_vendor/networkx/algorithms/traversal/edgedfs.py +0 -182
  263. package/runtime/python/okstra_vendor/networkx/algorithms/tree/__init__.py +0 -7
  264. package/runtime/python/okstra_vendor/networkx/algorithms/tree/branchings.py +0 -1042
  265. package/runtime/python/okstra_vendor/networkx/algorithms/tree/coding.py +0 -413
  266. package/runtime/python/okstra_vendor/networkx/algorithms/tree/decomposition.py +0 -88
  267. package/runtime/python/okstra_vendor/networkx/algorithms/tree/distance_measures.py +0 -219
  268. package/runtime/python/okstra_vendor/networkx/algorithms/tree/mst.py +0 -1281
  269. package/runtime/python/okstra_vendor/networkx/algorithms/tree/operations.py +0 -106
  270. package/runtime/python/okstra_vendor/networkx/algorithms/tree/recognition.py +0 -273
  271. package/runtime/python/okstra_vendor/networkx/algorithms/triads.py +0 -500
  272. package/runtime/python/okstra_vendor/networkx/algorithms/vitality.py +0 -76
  273. package/runtime/python/okstra_vendor/networkx/algorithms/voronoi.py +0 -86
  274. package/runtime/python/okstra_vendor/networkx/algorithms/walks.py +0 -77
  275. package/runtime/python/okstra_vendor/networkx/algorithms/wiener.py +0 -278
  276. package/runtime/python/okstra_vendor/networkx/classes/__init__.py +0 -13
  277. package/runtime/python/okstra_vendor/networkx/classes/coreviews.py +0 -435
  278. package/runtime/python/okstra_vendor/networkx/classes/digraph.py +0 -1363
  279. package/runtime/python/okstra_vendor/networkx/classes/filters.py +0 -95
  280. package/runtime/python/okstra_vendor/networkx/classes/function.py +0 -1549
  281. package/runtime/python/okstra_vendor/networkx/classes/graph.py +0 -2082
  282. package/runtime/python/okstra_vendor/networkx/classes/graphviews.py +0 -269
  283. package/runtime/python/okstra_vendor/networkx/classes/multidigraph.py +0 -977
  284. package/runtime/python/okstra_vendor/networkx/classes/multigraph.py +0 -1294
  285. package/runtime/python/okstra_vendor/networkx/classes/reportviews.py +0 -1447
  286. package/runtime/python/okstra_vendor/networkx/convert.py +0 -502
  287. package/runtime/python/okstra_vendor/networkx/convert_matrix.py +0 -1314
  288. package/runtime/python/okstra_vendor/networkx/drawing/__init__.py +0 -7
  289. package/runtime/python/okstra_vendor/networkx/drawing/layout.py +0 -2036
  290. package/runtime/python/okstra_vendor/networkx/drawing/nx_agraph.py +0 -470
  291. package/runtime/python/okstra_vendor/networkx/drawing/nx_latex.py +0 -570
  292. package/runtime/python/okstra_vendor/networkx/drawing/nx_pydot.py +0 -361
  293. package/runtime/python/okstra_vendor/networkx/drawing/nx_pylab.py +0 -2978
  294. package/runtime/python/okstra_vendor/networkx/exception.py +0 -131
  295. package/runtime/python/okstra_vendor/networkx/generators/__init__.py +0 -34
  296. package/runtime/python/okstra_vendor/networkx/generators/atlas.dat.gz +0 -0
  297. package/runtime/python/okstra_vendor/networkx/generators/atlas.py +0 -227
  298. package/runtime/python/okstra_vendor/networkx/generators/classic.py +0 -1091
  299. package/runtime/python/okstra_vendor/networkx/generators/cographs.py +0 -68
  300. package/runtime/python/okstra_vendor/networkx/generators/community.py +0 -1070
  301. package/runtime/python/okstra_vendor/networkx/generators/degree_seq.py +0 -886
  302. package/runtime/python/okstra_vendor/networkx/generators/directed.py +0 -572
  303. package/runtime/python/okstra_vendor/networkx/generators/duplication.py +0 -174
  304. package/runtime/python/okstra_vendor/networkx/generators/ego.py +0 -66
  305. package/runtime/python/okstra_vendor/networkx/generators/expanders.py +0 -499
  306. package/runtime/python/okstra_vendor/networkx/generators/geometric.py +0 -1037
  307. package/runtime/python/okstra_vendor/networkx/generators/harary_graph.py +0 -163
  308. package/runtime/python/okstra_vendor/networkx/generators/internet_as_graphs.py +0 -443
  309. package/runtime/python/okstra_vendor/networkx/generators/intersection.py +0 -125
  310. package/runtime/python/okstra_vendor/networkx/generators/interval_graph.py +0 -70
  311. package/runtime/python/okstra_vendor/networkx/generators/joint_degree_seq.py +0 -664
  312. package/runtime/python/okstra_vendor/networkx/generators/lattice.py +0 -405
  313. package/runtime/python/okstra_vendor/networkx/generators/line.py +0 -501
  314. package/runtime/python/okstra_vendor/networkx/generators/mycielski.py +0 -110
  315. package/runtime/python/okstra_vendor/networkx/generators/nonisomorphic_trees.py +0 -259
  316. package/runtime/python/okstra_vendor/networkx/generators/random_clustered.py +0 -117
  317. package/runtime/python/okstra_vendor/networkx/generators/random_graphs.py +0 -1416
  318. package/runtime/python/okstra_vendor/networkx/generators/small.py +0 -1070
  319. package/runtime/python/okstra_vendor/networkx/generators/social.py +0 -554
  320. package/runtime/python/okstra_vendor/networkx/generators/spectral_graph_forge.py +0 -120
  321. package/runtime/python/okstra_vendor/networkx/generators/stochastic.py +0 -54
  322. package/runtime/python/okstra_vendor/networkx/generators/sudoku.py +0 -131
  323. package/runtime/python/okstra_vendor/networkx/generators/time_series.py +0 -74
  324. package/runtime/python/okstra_vendor/networkx/generators/trees.py +0 -1070
  325. package/runtime/python/okstra_vendor/networkx/generators/triads.py +0 -94
  326. package/runtime/python/okstra_vendor/networkx/lazy_imports.py +0 -188
  327. package/runtime/python/okstra_vendor/networkx/linalg/__init__.py +0 -13
  328. package/runtime/python/okstra_vendor/networkx/linalg/algebraicconnectivity.py +0 -650
  329. package/runtime/python/okstra_vendor/networkx/linalg/attrmatrix.py +0 -466
  330. package/runtime/python/okstra_vendor/networkx/linalg/bethehessianmatrix.py +0 -77
  331. package/runtime/python/okstra_vendor/networkx/linalg/graphmatrix.py +0 -168
  332. package/runtime/python/okstra_vendor/networkx/linalg/laplacianmatrix.py +0 -512
  333. package/runtime/python/okstra_vendor/networkx/linalg/modularitymatrix.py +0 -166
  334. package/runtime/python/okstra_vendor/networkx/linalg/spectrum.py +0 -186
  335. package/runtime/python/okstra_vendor/networkx/readwrite/__init__.py +0 -17
  336. package/runtime/python/okstra_vendor/networkx/readwrite/adjlist.py +0 -330
  337. package/runtime/python/okstra_vendor/networkx/readwrite/edgelist.py +0 -489
  338. package/runtime/python/okstra_vendor/networkx/readwrite/gexf.py +0 -1084
  339. package/runtime/python/okstra_vendor/networkx/readwrite/gml.py +0 -879
  340. package/runtime/python/okstra_vendor/networkx/readwrite/graph6.py +0 -427
  341. package/runtime/python/okstra_vendor/networkx/readwrite/graphml.py +0 -1053
  342. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/__init__.py +0 -19
  343. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/adjacency.py +0 -156
  344. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/cytoscape.py +0 -190
  345. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/node_link.py +0 -261
  346. package/runtime/python/okstra_vendor/networkx/readwrite/json_graph/tree.py +0 -137
  347. package/runtime/python/okstra_vendor/networkx/readwrite/leda.py +0 -108
  348. package/runtime/python/okstra_vendor/networkx/readwrite/multiline_adjlist.py +0 -393
  349. package/runtime/python/okstra_vendor/networkx/readwrite/p2g.py +0 -113
  350. package/runtime/python/okstra_vendor/networkx/readwrite/pajek.py +0 -286
  351. package/runtime/python/okstra_vendor/networkx/readwrite/sparse6.py +0 -379
  352. package/runtime/python/okstra_vendor/networkx/readwrite/text.py +0 -851
  353. package/runtime/python/okstra_vendor/networkx/relabel.py +0 -285
  354. package/runtime/python/okstra_vendor/networkx/utils/__init__.py +0 -8
  355. package/runtime/python/okstra_vendor/networkx/utils/backends.py +0 -2171
  356. package/runtime/python/okstra_vendor/networkx/utils/configs.py +0 -396
  357. package/runtime/python/okstra_vendor/networkx/utils/decorators.py +0 -1233
  358. package/runtime/python/okstra_vendor/networkx/utils/heaps.py +0 -338
  359. package/runtime/python/okstra_vendor/networkx/utils/mapped_queue.py +0 -297
  360. package/runtime/python/okstra_vendor/networkx/utils/misc.py +0 -703
  361. package/runtime/python/okstra_vendor/networkx/utils/random_sequence.py +0 -198
  362. package/runtime/python/okstra_vendor/networkx/utils/rcm.py +0 -159
  363. package/runtime/python/okstra_vendor/networkx/utils/union_find.py +0 -106
  364. package/runtime/skills/okstra-graphify/SKILL.md +0 -169
  365. package/src/commands/graphify.mjs +0 -32
@@ -1,78 +0,0 @@
1
- """
2
- Algorithm to find a maximal (not maximum) independent set.
3
-
4
- """
5
-
6
- import networkx as nx
7
- from networkx.utils import not_implemented_for, py_random_state
8
-
9
- __all__ = ["maximal_independent_set"]
10
-
11
-
12
- @not_implemented_for("directed")
13
- @py_random_state(2)
14
- @nx._dispatchable
15
- def maximal_independent_set(G, nodes=None, seed=None):
16
- """Returns a random maximal independent set guaranteed to contain
17
- a given set of nodes.
18
-
19
- An independent set is a set of nodes such that the subgraph
20
- of G induced by these nodes contains no edges. A maximal
21
- independent set is an independent set such that it is not possible
22
- to add a new node and still get an independent set.
23
-
24
- Parameters
25
- ----------
26
- G : NetworkX graph
27
-
28
- nodes : list or iterable
29
- Nodes that must be part of the independent set. This set of nodes
30
- must be independent.
31
-
32
- seed : integer, random_state, or None (default)
33
- Indicator of random number generation state.
34
- See :ref:`Randomness<randomness>`.
35
-
36
- Returns
37
- -------
38
- indep_nodes : list
39
- List of nodes that are part of a maximal independent set.
40
-
41
- Raises
42
- ------
43
- NetworkXUnfeasible
44
- If the nodes in the provided list are not part of the graph or
45
- do not form an independent set, an exception is raised.
46
-
47
- NetworkXNotImplemented
48
- If `G` is directed.
49
-
50
- Examples
51
- --------
52
- >>> G = nx.path_graph(5)
53
- >>> nx.maximal_independent_set(G) # doctest: +SKIP
54
- [4, 0, 2]
55
- >>> nx.maximal_independent_set(G, [1]) # doctest: +SKIP
56
- [1, 3]
57
-
58
- Notes
59
- -----
60
- This algorithm does not solve the maximum independent set problem.
61
-
62
- """
63
- if not nodes:
64
- nodes = {seed.choice(list(G))}
65
- else:
66
- nodes = set(nodes)
67
- if not nodes.issubset(G):
68
- raise nx.NetworkXUnfeasible(f"{nodes} is not a subset of the nodes of G")
69
- neighbors = set.union(*[set(G.adj[v]) for v in nodes])
70
- if set.intersection(neighbors, nodes):
71
- raise nx.NetworkXUnfeasible(f"{nodes} is not an independent set of G")
72
- indep_nodes = list(nodes)
73
- available_nodes = set(G.nodes()).difference(neighbors.union(nodes))
74
- while available_nodes:
75
- node = seed.choice(list(available_nodes))
76
- indep_nodes.append(node)
77
- available_nodes.difference_update(list(G.adj[node]) + [node])
78
- return indep_nodes
@@ -1,59 +0,0 @@
1
- r"""Function for computing the moral graph of a directed graph."""
2
-
3
- import itertools
4
-
5
- import networkx as nx
6
- from networkx.utils import not_implemented_for
7
-
8
- __all__ = ["moral_graph"]
9
-
10
-
11
- @not_implemented_for("undirected")
12
- @nx._dispatchable(returns_graph=True)
13
- def moral_graph(G):
14
- r"""Return the Moral Graph
15
-
16
- Returns the moralized graph of a given directed graph.
17
-
18
- Parameters
19
- ----------
20
- G : NetworkX graph
21
- Directed graph
22
-
23
- Returns
24
- -------
25
- H : NetworkX graph
26
- The undirected moralized graph of G
27
-
28
- Raises
29
- ------
30
- NetworkXNotImplemented
31
- If `G` is undirected.
32
-
33
- Examples
34
- --------
35
- >>> G = nx.DiGraph([(1, 2), (2, 3), (2, 5), (3, 4), (4, 3)])
36
- >>> G_moral = nx.moral_graph(G)
37
- >>> G_moral.edges()
38
- EdgeView([(1, 2), (2, 3), (2, 5), (2, 4), (3, 4)])
39
-
40
- Notes
41
- -----
42
- A moral graph is an undirected graph H = (V, E) generated from a
43
- directed Graph, where if a node has more than one parent node, edges
44
- between these parent nodes are inserted and all directed edges become
45
- undirected.
46
-
47
- https://en.wikipedia.org/wiki/Moral_graph
48
-
49
- References
50
- ----------
51
- .. [1] Wray L. Buntine. 1995. Chain graphs for learning.
52
- In Proceedings of the Eleventh conference on Uncertainty
53
- in artificial intelligence (UAI'95)
54
- """
55
- H = G.to_undirected()
56
- for preds in G.pred.values():
57
- predecessors_combinations = itertools.combinations(preds, r=2)
58
- H.add_edges_from(predecessors_combinations)
59
- return H
@@ -1,219 +0,0 @@
1
- """This module provides the functions for node classification problem.
2
-
3
- The functions in this module are not imported
4
- into the top level `networkx` namespace.
5
- You can access these functions by importing
6
- the `networkx.algorithms.node_classification` modules,
7
- then accessing the functions as attributes of `node_classification`.
8
- For example:
9
-
10
- >>> from networkx.algorithms import node_classification
11
- >>> G = nx.path_graph(4)
12
- >>> G.edges()
13
- EdgeView([(0, 1), (1, 2), (2, 3)])
14
- >>> G.nodes[0]["label"] = "A"
15
- >>> G.nodes[3]["label"] = "B"
16
- >>> node_classification.harmonic_function(G)
17
- ['A', 'A', 'B', 'B']
18
-
19
- References
20
- ----------
21
- Zhu, X., Ghahramani, Z., & Lafferty, J. (2003, August).
22
- Semi-supervised learning using gaussian fields and harmonic functions.
23
- In ICML (Vol. 3, pp. 912-919).
24
- """
25
-
26
- import networkx as nx
27
-
28
- __all__ = ["harmonic_function", "local_and_global_consistency"]
29
-
30
-
31
- @nx.utils.not_implemented_for("directed")
32
- @nx._dispatchable(node_attrs="label_name")
33
- def harmonic_function(G, max_iter=30, label_name="label"):
34
- """Node classification by Harmonic function
35
-
36
- Function for computing Harmonic function algorithm by Zhu et al.
37
-
38
- Parameters
39
- ----------
40
- G : NetworkX Graph
41
- max_iter : int
42
- maximum number of iterations allowed
43
- label_name : string
44
- name of target labels to predict
45
-
46
- Returns
47
- -------
48
- predicted : list
49
- List of length ``len(G)`` with the predicted labels for each node.
50
-
51
- Raises
52
- ------
53
- NetworkXError
54
- If no nodes in `G` have attribute `label_name`.
55
-
56
- Examples
57
- --------
58
- >>> from networkx.algorithms import node_classification
59
- >>> G = nx.path_graph(4)
60
- >>> G.nodes[0]["label"] = "A"
61
- >>> G.nodes[3]["label"] = "B"
62
- >>> G.nodes(data=True)
63
- NodeDataView({0: {'label': 'A'}, 1: {}, 2: {}, 3: {'label': 'B'}})
64
- >>> G.edges()
65
- EdgeView([(0, 1), (1, 2), (2, 3)])
66
- >>> predicted = node_classification.harmonic_function(G)
67
- >>> predicted
68
- ['A', 'A', 'B', 'B']
69
-
70
- References
71
- ----------
72
- Zhu, X., Ghahramani, Z., & Lafferty, J. (2003, August).
73
- Semi-supervised learning using gaussian fields and harmonic functions.
74
- In ICML (Vol. 3, pp. 912-919).
75
- """
76
- import numpy as np
77
- import scipy as sp
78
-
79
- X = nx.to_scipy_sparse_array(G) # adjacency matrix
80
- labels, label_dict = _get_label_info(G, label_name)
81
-
82
- if labels.shape[0] == 0:
83
- raise nx.NetworkXError(
84
- f"No node on the input graph is labeled by '{label_name}'."
85
- )
86
-
87
- n_samples = X.shape[0]
88
- n_classes = label_dict.shape[0]
89
- F = np.zeros((n_samples, n_classes))
90
-
91
- # Build propagation matrix
92
- degrees = X.sum(axis=0)
93
- degrees[degrees == 0] = 1 # Avoid division by 0
94
- D = sp.sparse.dia_array((1.0 / degrees, 0), shape=(n_samples, n_samples)).tocsr()
95
- P = (D @ X).tolil()
96
- P[labels[:, 0]] = 0 # labels[:, 0] indicates IDs of labeled nodes
97
- # Build base matrix
98
- B = np.zeros((n_samples, n_classes))
99
- B[labels[:, 0], labels[:, 1]] = 1
100
-
101
- for _ in range(max_iter):
102
- F = (P @ F) + B
103
-
104
- return label_dict[np.argmax(F, axis=1)].tolist()
105
-
106
-
107
- @nx.utils.not_implemented_for("directed")
108
- @nx._dispatchable(node_attrs="label_name")
109
- def local_and_global_consistency(G, alpha=0.99, max_iter=30, label_name="label"):
110
- """Node classification by Local and Global Consistency
111
-
112
- Function for computing Local and global consistency algorithm by Zhou et al.
113
-
114
- Parameters
115
- ----------
116
- G : NetworkX Graph
117
- alpha : float
118
- Clamping factor
119
- max_iter : int
120
- Maximum number of iterations allowed
121
- label_name : string
122
- Name of target labels to predict
123
-
124
- Returns
125
- -------
126
- predicted : list
127
- List of length ``len(G)`` with the predicted labels for each node.
128
-
129
- Raises
130
- ------
131
- NetworkXError
132
- If no nodes in `G` have attribute `label_name`.
133
-
134
- Examples
135
- --------
136
- >>> from networkx.algorithms import node_classification
137
- >>> G = nx.path_graph(4)
138
- >>> G.nodes[0]["label"] = "A"
139
- >>> G.nodes[3]["label"] = "B"
140
- >>> G.nodes(data=True)
141
- NodeDataView({0: {'label': 'A'}, 1: {}, 2: {}, 3: {'label': 'B'}})
142
- >>> G.edges()
143
- EdgeView([(0, 1), (1, 2), (2, 3)])
144
- >>> predicted = node_classification.local_and_global_consistency(G)
145
- >>> predicted
146
- ['A', 'A', 'B', 'B']
147
-
148
- References
149
- ----------
150
- Zhou, D., Bousquet, O., Lal, T. N., Weston, J., & Schölkopf, B. (2004).
151
- Learning with local and global consistency.
152
- Advances in neural information processing systems, 16(16), 321-328.
153
- """
154
- import numpy as np
155
- import scipy as sp
156
-
157
- X = nx.to_scipy_sparse_array(G) # adjacency matrix
158
- labels, label_dict = _get_label_info(G, label_name)
159
-
160
- if labels.shape[0] == 0:
161
- raise nx.NetworkXError(
162
- f"No node on the input graph is labeled by '{label_name}'."
163
- )
164
-
165
- n_samples = X.shape[0]
166
- n_classes = label_dict.shape[0]
167
- F = np.zeros((n_samples, n_classes))
168
-
169
- # Build propagation matrix
170
- degrees = X.sum(axis=0)
171
- degrees[degrees == 0] = 1 # Avoid division by 0
172
- D2 = sp.sparse.dia_array(
173
- (1.0 / np.sqrt(degrees), 0), shape=(n_samples, n_samples)
174
- ).tocsr()
175
- P = alpha * ((D2 @ X) @ D2)
176
- # Build base matrix
177
- B = np.zeros((n_samples, n_classes))
178
- B[labels[:, 0], labels[:, 1]] = 1 - alpha
179
-
180
- for _ in range(max_iter):
181
- F = (P @ F) + B
182
-
183
- return label_dict[np.argmax(F, axis=1)].tolist()
184
-
185
-
186
- def _get_label_info(G, label_name):
187
- """Get and return information of labels from the input graph
188
-
189
- Parameters
190
- ----------
191
- G : Network X graph
192
- label_name : string
193
- Name of the target label
194
-
195
- Returns
196
- -------
197
- labels : numpy array, shape = [n_labeled_samples, 2]
198
- Array of pairs of labeled node ID and label ID
199
- label_dict : numpy array, shape = [n_classes]
200
- Array of labels
201
- i-th element contains the label corresponding label ID `i`
202
- """
203
- import numpy as np
204
-
205
- labels = []
206
- label_to_id = {}
207
- lid = 0
208
- for i, n in enumerate(G.nodes(data=True)):
209
- if label_name in n[1]:
210
- label = n[1][label_name]
211
- if label not in label_to_id:
212
- label_to_id[label] = lid
213
- lid += 1
214
- labels.append([i, label_to_id[label]])
215
- labels = np.array(labels)
216
- label_dict = np.array(
217
- [label for label, _ in sorted(label_to_id.items(), key=lambda x: x[1])]
218
- )
219
- return (labels, label_dict)
@@ -1,155 +0,0 @@
1
- r"""Computation of graph non-randomness."""
2
-
3
- import math
4
-
5
- import networkx as nx
6
- from networkx.utils import not_implemented_for
7
-
8
- __all__ = ["non_randomness"]
9
-
10
-
11
- @not_implemented_for("directed")
12
- @not_implemented_for("multigraph")
13
- @nx._dispatchable(edge_attrs="weight")
14
- def non_randomness(G, k=None, weight="weight"):
15
- """Compute the non-randomness of a graph.
16
-
17
- The first value $R_G$ is the sum of non-randomness values of all
18
- edges within the graph (where the non-randomness of an edge tends to be
19
- small when the two nodes linked by that edge are from two different
20
- communities).
21
-
22
- The second value $R_G^*$ is a relative measure that indicates
23
- to what extent `G` is different from a random graph in terms
24
- of probability. The closer it is to 0, the higher the likelihood
25
- the graph was generated by an Erdős--Rényi model.
26
-
27
- Parameters
28
- ----------
29
- G : NetworkX graph
30
- Graph must be undirected, connected, and without self-loops.
31
-
32
- k : int or None, optional (default=None)
33
- The number of communities in `G`.
34
- If `k` is not set, the function uses a default community detection
35
- algorithm (:func:`~networkx.algorithms.community.label_propagation_communities`)
36
- to set it.
37
-
38
- weight : string or None, optional (default="weight")
39
- The name of an edge attribute that holds the numerical value used
40
- as a weight. If `None`, then each edge has weight 1, i.e., the graph is
41
- binary.
42
-
43
- Returns
44
- -------
45
- (float, float) tuple
46
- The first value is $R_G$, the non-randomness of the graph,
47
- the second is $R_G^*$, the relative non-randomness
48
- w.r.t. the Erdős--Rényi model.
49
-
50
- Raises
51
- ------
52
- NetworkXNotImplemented
53
- If the input graph is directed or a multigraph.
54
-
55
- NetworkXException
56
- If the input graph is not connected.
57
-
58
- NetworkXError
59
- If the input graph contains self-loops or has no edges.
60
-
61
- ValueError
62
- If `k` is not in $\\{1, \\dots, n-1\\}$, where $n$ is the number of nodes,
63
- or if `k` is such that the computed edge probability
64
- $p = \\frac{2km}{n(n-k)}$ does not satisfy $0 < p < 1$.
65
-
66
- Examples
67
- --------
68
- >>> G = nx.karate_club_graph()
69
- >>> nr, nr_rd = nx.non_randomness(G, 2)
70
- >>> nr, nr_rd = nx.non_randomness(G, 2, "weight")
71
-
72
- When the number of communities `k` is not specified,
73
- :func:`~networkx.algorithms.community.label_propagation_communities`
74
- is used to compute it.
75
- This algorithm can give different results depending on
76
- the order of nodes and edges in the graph.
77
- For example, while the following graphs are identical,
78
- computing the non-randomness of each of them yields different results:
79
-
80
- >>> G1, G2 = nx.Graph(), nx.Graph()
81
- >>> G1.add_edges_from([(0, 1), (1, 2), (1, 3), (3, 4)])
82
- >>> G2.add_edges_from([(0, 1), (1, 3), (1, 2), (3, 4)])
83
- >>> [round(r, 6) for r in nx.non_randomness(G1)]
84
- [-1.847759, -5.842437]
85
- >>> [round(r, 6) for r in nx.non_randomness(G2)]
86
- Traceback (most recent call last):
87
- ...
88
- ValueError: invalid number of communities for graph with 5 nodes and 4 edges: 2
89
-
90
- This is because the community detection algorithm finds
91
- 1 community in `G1` and 2 communities in `G2`.
92
- This can be resolved by specifying the number of communities `k`:
93
-
94
- >>> [round(r, 6) for r in nx.non_randomness(G2, k=1)]
95
- [-1.847759, -5.842437]
96
-
97
- Notes
98
- -----
99
- If a `weight` argument is passed, this algorithm will use the eigenvalues
100
- of the weighted adjacency matrix instead.
101
-
102
- The output of this function corresponds to (4.4) and (4.5) in [1]_.
103
- A lower value of $R^*_G$ indicates a more random graph;
104
- one can think of $1 - \\Phi(R_G^*)$ as the similarity
105
- between the graph and a random graph,
106
- where $\\Phi(x)$ is the cumulative distribution function
107
- of the standard normal distribution.
108
-
109
- Theorem 2 in [2]_ states that for any graph $G$
110
- with $n$ nodes, $m$ edges, and $k$ communities,
111
- its non-randomness is bounded below by the non-randomness of an
112
- $r$-regular graph (a graph where each node has degree $r$),
113
- and bounded above by the non-randomness of an $l$-complete graph
114
- (a graph where each community is a clique of $l$ nodes).
115
-
116
- References
117
- ----------
118
- .. [1] Xiaowei Ying and Xintao Wu,
119
- On Randomness Measures for Social Networks,
120
- SIAM International Conference on Data Mining. 2009
121
- https://doi.org/10.1137/1.9781611972795.61
122
- .. [2] Ying, Xiaowei & Wu, Leting & Wu, Xintao. (2012).
123
- A Spectrum-Based Framework for Quantifying Randomness of Social Networks.
124
- IEEE Transactions on Knowledge and Data Engineering 23(12):1842--1856.
125
- https://dl.acm.org/doi/abs/10.1109/TKDE.2010.218
126
- """
127
- import numpy as np
128
-
129
- # corner case: graph has no edges
130
- if nx.is_empty(G):
131
- raise nx.NetworkXError("non_randomness not applicable to empty graphs")
132
- if not nx.is_connected(G):
133
- raise nx.NetworkXException("Non connected graph.")
134
- if len(list(nx.selfloop_edges(G))) > 0:
135
- raise nx.NetworkXError("Graph must not contain self-loops")
136
-
137
- n = G.number_of_nodes()
138
- m = G.number_of_edges()
139
-
140
- if k is None:
141
- k = len(tuple(nx.community.label_propagation_communities(G)))
142
- if not 1 <= k < n or not 0 < (p := (2 * k * m) / (n * (n - k))) < 1:
143
- err = (
144
- f"invalid number of communities for graph with {n} nodes and {m} edges: {k}"
145
- )
146
- raise ValueError(err)
147
-
148
- # eq. 4.4
149
- eigenvalues = np.linalg.eigvals(nx.to_numpy_array(G, weight=weight))
150
- nr = float(np.real(np.sum(eigenvalues[:k])))
151
-
152
- # eq. 4.5
153
- nr_rd = (nr - ((n - 2 * k) * p + k)) / math.sqrt(2 * k * p * (1 - p))
154
-
155
- return nr, nr_rd
@@ -1,4 +0,0 @@
1
- from networkx.algorithms.operators.all import *
2
- from networkx.algorithms.operators.binary import *
3
- from networkx.algorithms.operators.product import *
4
- from networkx.algorithms.operators.unary import *