gridstate 2.9.0__tar.gz → 2.10.0__tar.gz

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 (232) hide show
  1. {gridstate-2.9.0 → gridstate-2.10.0}/CHANGELOG.md +68 -0
  2. {gridstate-2.9.0 → gridstate-2.10.0}/PKG-INFO +51 -1
  3. {gridstate-2.9.0 → gridstate-2.10.0}/README.md +50 -0
  4. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/_version.py +3 -3
  5. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/api.py +377 -71
  6. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/derived.py +18 -1
  7. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/derived_tables.py +79 -1
  8. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/version.py +3 -1
  9. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/measurement_ids.py +4 -0
  10. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/config.py +263 -3
  11. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/context.py +3 -0
  12. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/passes.py +16 -1
  13. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/preparation.py +32 -4
  14. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/steps.py +12 -1
  15. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/__init__.py +5 -1
  16. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/ipm_setup.py +12 -1
  17. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/pseudo_measurements.py +80 -4
  18. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/result.py +5 -1
  19. gridstate-2.10.0/gridstate/supernodes.py +589 -0
  20. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/apply_resolved.py +204 -25
  21. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/load_only_injection.py +11 -2
  22. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/noise.py +4 -0
  23. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/sigma_floor.py +9 -0
  24. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/voltage_filter.py +27 -1
  25. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/PKG-INFO +51 -1
  26. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/SOURCES.txt +3 -0
  27. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/scm_file_list.json +3 -0
  28. gridstate-2.10.0/gridstate.egg-info/scm_version.json +8 -0
  29. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case118.json +24 -0
  30. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case118_degraded.json +24 -0
  31. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case14.json +24 -0
  32. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case14_degraded.json +24 -0
  33. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case30.json +24 -0
  34. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case30_degraded.json +24 -0
  35. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/manifest.json +130 -4
  36. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_derived_tables.py +10 -0
  37. gridstate-2.10.0/tests/test_external_sigma2.py +578 -0
  38. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm_balance_modes.py +60 -0
  39. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm_injection_roles.py +14 -0
  40. gridstate-2.10.0/tests/test_supernodes.py +358 -0
  41. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_voltage_calibration_gen_nodes.py +5 -1
  42. gridstate-2.9.0/gridstate.egg-info/scm_version.json +0 -8
  43. {gridstate-2.9.0 → gridstate-2.10.0}/.github/workflows/ci.yml +0 -0
  44. {gridstate-2.9.0 → gridstate-2.10.0}/.github/workflows/release.yml +0 -0
  45. {gridstate-2.9.0 → gridstate-2.10.0}/.gitignore +0 -0
  46. {gridstate-2.9.0 → gridstate-2.10.0}/.pre-commit-config.yaml +0 -0
  47. {gridstate-2.9.0 → gridstate-2.10.0}/LICENSE +0 -0
  48. {gridstate-2.9.0 → gridstate-2.10.0}/Makefile +0 -0
  49. {gridstate-2.9.0 → gridstate-2.10.0}/build_cython.py +0 -0
  50. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/__init__.py +0 -0
  51. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/__pyinstaller/__init__.py +0 -0
  52. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/__pyinstaller/hook-gridstate.py +0 -0
  53. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/_arrays.py +0 -0
  54. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/adapters/__init__.py +0 -0
  55. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/adapters/from_pandapower.py +0 -0
  56. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/__init__.py +0 -0
  57. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/_selinv_kernels.py +0 -0
  58. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/base.py +0 -0
  59. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/estimators.py +0 -0
  60. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/jacobian_pattern.py +0 -0
  61. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algebra/normalized_residuals.py +0 -0
  62. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/__init__.py +0 -0
  63. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/_gram_numba.py +0 -0
  64. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/ipm.py +0 -0
  65. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/ipm_pd.py +0 -0
  66. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/kkt_solver.py +0 -0
  67. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/status.py +0 -0
  68. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/algorithms/wls.py +0 -0
  69. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/bad_data_repass.py +0 -0
  70. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/bounds.py +0 -0
  71. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/constants.py +0 -0
  72. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/__init__.py +0 -0
  73. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/_legacy.py +0 -0
  74. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/containers.py +0 -0
  75. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/serialize.py +0 -0
  76. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/tables.py +0 -0
  77. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/contract/validate.py +0 -0
  78. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/ipm_hints.py +0 -0
  79. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/load_characteristics.py +0 -0
  80. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/losses.py +0 -0
  81. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/__init__.py +0 -0
  82. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/manifest.py +0 -0
  83. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/orchestration.py +0 -0
  84. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/pipeline/runner.py +0 -0
  85. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/post_processing.py +0 -0
  86. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/_scan.py +0 -0
  87. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/meas_rows.py +0 -0
  88. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/mirror_voltage.py +0 -0
  89. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/preprocessing/node_props.py +0 -0
  90. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/py.typed +0 -0
  91. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/quality_summary.py +0 -0
  92. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/resolve_pass.py +0 -0
  93. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/runtime.py +0 -0
  94. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/shunt_sanity.py +0 -0
  95. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/solution_hints.py +0 -0
  96. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/state.py +0 -0
  97. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/__init__.py +0 -0
  98. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/_filters.py +0 -0
  99. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/generators.py +0 -0
  100. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/kinds.py +0 -0
  101. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/loss_filter.py +0 -0
  102. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/measurements.py +0 -0
  103. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/on_line.py +0 -0
  104. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/quality.py +0 -0
  105. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/rpn.py +0 -0
  106. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/shunts.py +0 -0
  107. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/units.py +0 -0
  108. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/telemetry/voltage_nominal.py +0 -0
  109. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/topology.py +0 -0
  110. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/units.py +0 -0
  111. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/utils.py +0 -0
  112. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/v_mirror.py +0 -0
  113. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/v_refine.py +0 -0
  114. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/validation/__init__.py +0 -0
  115. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/validation/_diagnostics.py +0 -0
  116. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/validation/bad_data.py +0 -0
  117. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/validation/chi2_test.py +0 -0
  118. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/validation/observability.py +0 -0
  119. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/working.py +0 -0
  120. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/ybus.py +0 -0
  121. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate/z_vector.py +0 -0
  122. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/dependency_links.txt +0 -0
  123. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/entry_points.txt +0 -0
  124. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/requires.txt +0 -0
  125. {gridstate-2.9.0 → gridstate-2.10.0}/gridstate.egg-info/top_level.txt +0 -0
  126. {gridstate-2.9.0 → gridstate-2.10.0}/pyproject.toml +0 -0
  127. {gridstate-2.9.0 → gridstate-2.10.0}/setup.cfg +0 -0
  128. {gridstate-2.9.0 → gridstate-2.10.0}/tests/__init__.py +0 -0
  129. {gridstate-2.9.0 → gridstate-2.10.0}/tests/_golden.py +0 -0
  130. {gridstate-2.9.0 → gridstate-2.10.0}/tests/conftest.py +0 -0
  131. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_adapters_lazy_import.py +0 -0
  132. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_aggregate_generators.py +0 -0
  133. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_algebra_base.py +0 -0
  134. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_anti_overshoot.py +0 -0
  135. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_arrays_helpers.py +0 -0
  136. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_bad_data.py +0 -0
  137. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_bad_data_repass.py +0 -0
  138. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_bounds.py +0 -0
  139. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_boxed_balance.py +0 -0
  140. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_breaker_reactance.py +0 -0
  141. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_chain_mirror.py +0 -0
  142. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_contract.py +0 -0
  143. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_contract_edge_cases.py +0 -0
  144. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_contract_runtime.py +0 -0
  145. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case118.npz +0 -0
  146. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case118_degraded.npz +0 -0
  147. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case14.npz +0 -0
  148. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case14_degraded.npz +0 -0
  149. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case30.npz +0 -0
  150. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/golden/case30_degraded.npz +0 -0
  151. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case118.npz +0 -0
  152. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case118_truth.npz +0 -0
  153. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case14.npz +0 -0
  154. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case14_truth.npz +0 -0
  155. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case30.npz +0 -0
  156. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_data/ieee/case30_truth.npz +0 -0
  157. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_enum_codes.py +0 -0
  158. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_flow_sigma_floor.py +0 -0
  159. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_from_pandapower.py +0 -0
  160. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_generator_shunt_kernels.py +0 -0
  161. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_golden.py +0 -0
  162. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_gram_numba.py +0 -0
  163. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ieee_cases.py +0 -0
  164. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm.py +0 -0
  165. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm_hints.py +0 -0
  166. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm_integration.py +0 -0
  167. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ipm_pd.py +0 -0
  168. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_jacobian_pattern.py +0 -0
  169. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_kkt_solver.py +0 -0
  170. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_load_characteristic_segments.py +0 -0
  171. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_load_only_injection.py +0 -0
  172. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_losses_breakdown.py +0 -0
  173. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_losses_q_convention.py +0 -0
  174. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_losses_trafo_classification.py +0 -0
  175. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_materialize_kernel.py +0 -0
  176. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_measurement_filter_kernels.py +0 -0
  177. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_measurement_ids.py +0 -0
  178. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_mirror_voltage_kernel.py +0 -0
  179. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_near_critical_ranking.py +0 -0
  180. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_neutral_wording.py +0 -0
  181. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_noise_model.py +0 -0
  182. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_normalized_residuals.py +0 -0
  183. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_numpy_only_runtime.py +0 -0
  184. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_observability.py +0 -0
  185. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_on_line_kernel.py +0 -0
  186. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_perf_synthetic_network.py +0 -0
  187. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline.py +0 -0
  188. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_config_validation.py +0 -0
  189. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_idempotent.py +0 -0
  190. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_invariant_errors.py +0 -0
  191. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_step_order.py +0 -0
  192. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_warm_start.py +0 -0
  193. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pipeline_working_layer.py +0 -0
  194. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_post_processing.py +0 -0
  195. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_preparation_steps.py +0 -0
  196. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_prepare_network.py +0 -0
  197. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pseudo_unknown_load.py +0 -0
  198. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pseudo_v_scope.py +0 -0
  199. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_pseudo_v_unobservable.py +0 -0
  200. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_quality_summary_paths.py +0 -0
  201. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_reconcile_balance.py +0 -0
  202. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_refine_merge.py +0 -0
  203. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_resolve_pass.py +0 -0
  204. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_result_quality_summary.py +0 -0
  205. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_rn_selected_inversion.py +0 -0
  206. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_serialize_npz.py +0 -0
  207. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_shunt_sanity.py +0 -0
  208. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_solution_hints.py +0 -0
  209. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_solve_status.py +0 -0
  210. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_state.py +0 -0
  211. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_state_range.py +0 -0
  212. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_telemetry_apply_kernel.py +0 -0
  213. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_telemetry_bounds.py +0 -0
  214. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_telemetry_physics_kernels.py +0 -0
  215. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_tm_code_quality.py +0 -0
  216. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_topology_kernels.py +0 -0
  217. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_topology_port.py +0 -0
  218. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_transformer_from_shunt.py +0 -0
  219. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_units.py +0 -0
  220. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_units_array_kernels.py +0 -0
  221. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_v_mirror.py +0 -0
  222. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_v_refine.py +0 -0
  223. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_variance_charging.py +0 -0
  224. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_version.py +0 -0
  225. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_voltage_range_filter_fallback.py +0 -0
  226. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_wls.py +0 -0
  227. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_wls_robustness.py +0 -0
  228. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_working_container.py +0 -0
  229. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_ybus.py +0 -0
  230. {gridstate-2.9.0 → gridstate-2.10.0}/tests/test_z_vector.py +0 -0
  231. {gridstate-2.9.0 → gridstate-2.10.0}/tools/gen_ieee_fixtures.py +0 -0
  232. {gridstate-2.9.0 → gridstate-2.10.0}/tools/golden.py +0 -0
@@ -9,6 +9,74 @@ types of the merged pull requests; breaking and behavior-changing items are
9
9
  listed separately under "Breaking changes" and "Behavior changes". A release is
10
10
  cut by tagging the merged main commit; the version is derived from that tag.
11
11
 
12
+ ## v2.10.0 (2026-10-20)
13
+
14
+ ### Feat
15
+
16
+ - External measurement variances: `DerivedInputs.measurement_sigma2`
17
+ (`{(object_id, kind): sigma2}`, keyed like the telemetry plan, in the squared
18
+ units of the value). The values summed into one row sum their variances.
19
+ `PipelineConfig.external_sigma2`: `"final"` (default) keeps the variance
20
+ through every pre-solve adjustment (QUESTIONABLE multiplier, producer scale
21
+ plans, Q-loss downweight, V range downweight, load box widening, gen-V
22
+ calibration, flow sigma floor), and a partly covered row is an error;
23
+ `"base"` replaces only the built-in rule. Without the plan nothing changes.
24
+ - External pseudo-measurements: `DerivedInputs.pseudo_measurements`
25
+ (`{(node_id, kind): (value, sigma2)}`, `kind` in `v` / `p_inj` / `q_inj`),
26
+ added as given by the new `external_pseudo` step before the built-in priors.
27
+ - New switches, defaults keep the current behavior: `questionable_sigma2_multiplier`
28
+ (100), `q_loss_filter` (`"downweight"` / `"deactivate"` / `"off"`),
29
+ `flow_sign_check`, `v_below_half_nominal_check`, `pseudo_v`,
30
+ `pseudo_injections`.
31
+ - `PipelineConfig.no_extras(**overrides)`: every extra off (robust weights,
32
+ post-solve passes, variance adjustments, injection releases, V mirror,
33
+ built-in pseudo-measurements, the prior of the unmeasured injection part),
34
+ so the objective is the plain weighted sum of squares; the algorithm and the
35
+ statement of the problem stay with the caller.
36
+ - `ipm_unmeasured_part_prior` (default on): with `ipm_injection_roles`, the
37
+ unmeasured part of a node whose other part is measured gets its prior;
38
+ off, it is held by its box and the node balance only
39
+ (`build_ipm_setup(..., unmeasured_part_prior=...)`).
40
+ - Supernodes (ipm / ipm_pd): `ipm_merge_breakers` (default off) and
41
+ `ipm_merge_breakers_z_ohm_per_kv` (default 4.4e-4 = 110·4e-6), or
42
+ `estimate(..., merge_breakers_z_ohm_per_kv=...)`. Nodes joined by active
43
+ branches with `|r + jx| ≤ value · Vnom(from)` Ohm get one V and δ (a merged
44
+ transformer keeps its ratio and phase shift between its ends); the merged
45
+ branches leave the network, their flow measurements are not used, the
46
+ node balances add up per supernode and a member's net injection
47
+ measurement measures the box variables of its node. The flows of the merged
48
+ branches are recovered from the member balances (unique in a tree, split
49
+ as over equal impedances in a loop) and added to `p/q_inj_calc` of their
50
+ ends; the quality summary is computed on the rows and the state of the
51
+ solve (`SEResult.solved_rows`). New module `gridstate.supernodes`.
52
+ - `huber_c=0` is documented as "no robust weights" (it already was for every
53
+ solver).
54
+ - Settings of the ipm_pd voltage guard (`ipm_voltage_guard_*`, `api.VoltageGuard`,
55
+ `estimate(..., voltage_guard_settings=...)`): the plausibility limits of
56
+ `voltage_min` / `voltage_max` (`_lo_min` 0.5, `_hi_max` 2.0 p.u.), their
57
+ fallbacks (`_lo_fallback` 0.55, `_hi_fallback` 1.8), the box of a node with
58
+ neither limit (`_unset_lo` / `_unset_hi`) and the step limits (`_v_step` 0.2,
59
+ `_angle_step` 0.6 rad, `_branch_angle_step` 0.35 rad).
60
+
61
+ ### Contract
62
+
63
+ - Contract 3.3.0: the optional derived tables `measurement_sigma2` and
64
+ `pseudo_measurements`.
65
+
66
+ ### Behavior changes
67
+
68
+ - ipm_pd voltage guard: a node with neither `voltage_min` nor `voltage_max`
69
+ gets the fallback box 0.55…1.8 p.u. (was 0.7…1.5), the same as a node with
70
+ unset or implausible limits. The previous box is
71
+ `ipm_voltage_guard_unset_lo=0.7`, `ipm_voltage_guard_unset_hi=1.5`. The
72
+ golden references do not use ipm_pd; on the IEEE inputs with the ipm_pd
73
+ variant of the full configuration the estimates move by at most 1.3e-7 p.u.
74
+ (the barrier term), with the same iteration counts.
75
+ - The event stream has a new step, `external_pseudo` (`step_skipped` without
76
+ derived inputs or when switched off, `step_done` with `stats["skipped"]`
77
+ without the plan). Results are unchanged: the golden references differ only
78
+ in that event.
79
+
12
80
  ## v2.9.0 (2026-10-18)
13
81
 
14
82
  ### Feat
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gridstate
3
- Version: 2.9.0
3
+ Version: 2.10.0
4
4
  Summary: Power system State Estimation: pure-Python WLS/IPM on numpy/scipy, input via a versioned file contract (npz).
5
5
  Author-email: Evgeny Istomin <gena@alpisto.eu>
6
6
  License: MIT
@@ -274,6 +274,56 @@ defaults = {p["name"]: p["default"] for p in manifest["params"]}
274
274
  assert defaults["algorithm"] == "ipm"
275
275
  ```
276
276
 
277
+ ### External variances and the plain objective
278
+
279
+ By default the telemetry layer assigns every measurement its variance (V 1 % of
280
+ the nominal voltage, branch flows 2 % of the value, injections 5 %) and later
281
+ steps adjust it. A data producer that knows the measurement accuracy can give
282
+ the variances instead, and every adjustment of the weights or of the problem
283
+ can be switched off.
284
+
285
+ - `DerivedInputs.measurement_sigma2` — `{(object_id, kind): sigma2}`, keyed like
286
+ the telemetry plan (`v`, `p_from` / `p_to` / `q_from` / `q_to`,
287
+ `p_gen` / `p_load` / `q_gen` / `q_load`, components such as `p_gen:3`), in the
288
+ squared units of the value (kV², MW², Mvar²). The values summed into one row
289
+ (the components of a node injection, repeated readings) sum their variances.
290
+ - `PipelineConfig.external_sigma2`:
291
+ - `"final"` (default): the variance is final. No QUESTIONABLE multiplier, no
292
+ producer sigma² scale plans, no Q-loss downweight, no V range downweight, no
293
+ load box widening, no gen-V calibration, no flow sigma floor. A row that
294
+ only some of its values have a variance for is an error.
295
+ - `"base"`: the variance replaces only the built-in rule, and every
296
+ adjustment applies as usual. A partly covered row keeps the built-in rule,
297
+ with a warning.
298
+
299
+ Validity decisions (bad quality, dead V sensors, inconsistent flows,
300
+ released injections) apply in both modes and have their own switches.
301
+ - `DerivedInputs.pseudo_measurements` — `{(node_id, kind): (value, sigma2)}`
302
+ with `kind` in `v` / `p_inj` / `q_inj`, added as given by the
303
+ `external_pseudo` step before the built-in priors. A node with an external
304
+ prior of a kind gets no built-in prior of that kind.
305
+ - Switches of the adjustments: `huber_c=0` (no robust weights, every solver),
306
+ `questionable_sigma2_multiplier=1`, `q_loss_filter="off"`,
307
+ `flow_sign_check`, `v_below_half_nominal_check`, `apply_voltage_range_filter`,
308
+ `widen_generation_only_injections`, `release_load_only_injections`,
309
+ `apply_gen_v_calibration`, `flow_sigma_floor_kv_frac=None`,
310
+ `mirror_voltage_unit_tap`, `add_pseudo` (with `pseudo_v` /
311
+ `pseudo_injections` for the two kinds), and the post-solve passes `bad_data`,
312
+ `v_refine`, `v_mirror`, `v_mirror_chain`, `refine_merge`, `anti_overshoot`,
313
+ `shunt_sanity`.
314
+
315
+ `PipelineConfig.no_extras(**overrides)` switches all of them off, so the
316
+ objective is the plain weighted sum of squares of the given measurements and
317
+ pseudo-measurements. The preset works with any algorithm (wls / ipm /
318
+ ipm_pd); the algorithm, the balance modes, the voltage guard, the boxes and
319
+ the initial point are the statement of the problem and stay with the caller.
320
+ The data validity checks stay on. A weighted least squares problem with hard
321
+ boxes and hard node balances is, for example:
322
+
323
+ ```python
324
+ cfg = PipelineConfig.no_extras(algorithm="ipm_pd", ipm_balance_mode="hard")
325
+ ```
326
+
277
327
  ## Data contract
278
328
 
279
329
  Input and output are governed by an explicit, versioned schema
@@ -222,6 +222,56 @@ defaults = {p["name"]: p["default"] for p in manifest["params"]}
222
222
  assert defaults["algorithm"] == "ipm"
223
223
  ```
224
224
 
225
+ ### External variances and the plain objective
226
+
227
+ By default the telemetry layer assigns every measurement its variance (V 1 % of
228
+ the nominal voltage, branch flows 2 % of the value, injections 5 %) and later
229
+ steps adjust it. A data producer that knows the measurement accuracy can give
230
+ the variances instead, and every adjustment of the weights or of the problem
231
+ can be switched off.
232
+
233
+ - `DerivedInputs.measurement_sigma2` — `{(object_id, kind): sigma2}`, keyed like
234
+ the telemetry plan (`v`, `p_from` / `p_to` / `q_from` / `q_to`,
235
+ `p_gen` / `p_load` / `q_gen` / `q_load`, components such as `p_gen:3`), in the
236
+ squared units of the value (kV², MW², Mvar²). The values summed into one row
237
+ (the components of a node injection, repeated readings) sum their variances.
238
+ - `PipelineConfig.external_sigma2`:
239
+ - `"final"` (default): the variance is final. No QUESTIONABLE multiplier, no
240
+ producer sigma² scale plans, no Q-loss downweight, no V range downweight, no
241
+ load box widening, no gen-V calibration, no flow sigma floor. A row that
242
+ only some of its values have a variance for is an error.
243
+ - `"base"`: the variance replaces only the built-in rule, and every
244
+ adjustment applies as usual. A partly covered row keeps the built-in rule,
245
+ with a warning.
246
+
247
+ Validity decisions (bad quality, dead V sensors, inconsistent flows,
248
+ released injections) apply in both modes and have their own switches.
249
+ - `DerivedInputs.pseudo_measurements` — `{(node_id, kind): (value, sigma2)}`
250
+ with `kind` in `v` / `p_inj` / `q_inj`, added as given by the
251
+ `external_pseudo` step before the built-in priors. A node with an external
252
+ prior of a kind gets no built-in prior of that kind.
253
+ - Switches of the adjustments: `huber_c=0` (no robust weights, every solver),
254
+ `questionable_sigma2_multiplier=1`, `q_loss_filter="off"`,
255
+ `flow_sign_check`, `v_below_half_nominal_check`, `apply_voltage_range_filter`,
256
+ `widen_generation_only_injections`, `release_load_only_injections`,
257
+ `apply_gen_v_calibration`, `flow_sigma_floor_kv_frac=None`,
258
+ `mirror_voltage_unit_tap`, `add_pseudo` (with `pseudo_v` /
259
+ `pseudo_injections` for the two kinds), and the post-solve passes `bad_data`,
260
+ `v_refine`, `v_mirror`, `v_mirror_chain`, `refine_merge`, `anti_overshoot`,
261
+ `shunt_sanity`.
262
+
263
+ `PipelineConfig.no_extras(**overrides)` switches all of them off, so the
264
+ objective is the plain weighted sum of squares of the given measurements and
265
+ pseudo-measurements. The preset works with any algorithm (wls / ipm /
266
+ ipm_pd); the algorithm, the balance modes, the voltage guard, the boxes and
267
+ the initial point are the statement of the problem and stay with the caller.
268
+ The data validity checks stay on. A weighted least squares problem with hard
269
+ boxes and hard node balances is, for example:
270
+
271
+ ```python
272
+ cfg = PipelineConfig.no_extras(algorithm="ipm_pd", ipm_balance_mode="hard")
273
+ ```
274
+
225
275
  ## Data contract
226
276
 
227
277
  Input and output are governed by an explicit, versioned schema
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '2.9.0'
22
- __version_tuple__ = version_tuple = (2, 9, 0)
21
+ __version__ = version = '2.10.0'
22
+ __version_tuple__ = version_tuple = (2, 10, 0)
23
23
 
24
- __commit_id__ = commit_id = 'gaa9a1ec6e'
24
+ __commit_id__ = commit_id = 'g991d15b9a'