From 0e710d7d45896f27c0ee507ae1f29a3507519f21 Mon Sep 17 00:00:00 2001 From: Sebastian Matysik Date: Sat, 24 Oct 2026 16:35:18 +0200 Subject: [PATCH] Release 1.6.0: charts, parity of the browser page and the Colab notebook, fixes Added - gridqueue.plots: charts for every result (coverage, quality rules, column shift, stage of the proceeding, capacity by class, Kaplan-Meier processing times, node loading, two-edition flows, transitions and linkage audit, location resolution, overview) and save_all; optional extra [plot] - CLI: gridqueue compare, gridqueue plot - parse_sources (one fresh adapter per file), split_editions, kaplan_meier_by_group, geocode_frame, node_loading(napiecie=...) for the 110 kV base variant of the article, gridqueue.examples - Browser page: simple view (drop documents, get the main charts and one ZIP; two editions of one register are recognised by their dates) and full view (later edition, gazetteer, analyses, every table, CSV/XLSX/JSON/ZIP export) - Colab notebook: installs v1.6.0, adds validation, column-shift audit, key sensitivity, ENERGA processing times and node loading checked against the paper, resolver, charts, results archive Fixed - processing_time censored open applications at the latest publication date of the whole frame, node rows included; each row is now censored at its own publication date - the two bounds of the Kaplan-Meier median interval were swapped - kaplan_meier raised KeyError for a group with no event Tests: 221 passed, 2 skipped (Python 3.10 and 3.12 checked locally). --- CHANGELOG.md | 46 ++ CITATION.cff | 4 +- CODE_METADATA.md | 14 +- README.md | 100 ++- docs/app/gridqueue-1.5.2-py3-none-any.whl | Bin 102771 -> 0 bytes docs/app/gridqueue-1.6.0-py3-none-any.whl | Bin 0 -> 124333 bytes docs/app/index.html | 945 ++++++++++++++++----- docs/cli.md | 12 + docs/colab.md | 35 +- docs/index.md | 4 +- docs/wykresy.md | 74 ++ notebooks/gridqueue_colab.ipynb | 377 +++++++-- pyproject.toml | 7 +- src/gridqueue/__init__.py | 31 +- src/gridqueue/analysis.py | 88 +- src/gridqueue/cli.py | 64 +- src/gridqueue/examples.py | 166 ++++ src/gridqueue/geoloc.py | 45 +- src/gridqueue/plots.py | 948 ++++++++++++++++++++++ src/gridqueue/registry.py | 76 +- tests/test_analysis_v16.py | 83 ++ tests/test_examples_geocode.py | 45 + tests/test_plots.py | 173 ++++ 23 files changed, 2997 insertions(+), 340 deletions(-) delete mode 100644 docs/app/gridqueue-1.5.2-py3-none-any.whl create mode 100644 docs/app/gridqueue-1.6.0-py3-none-any.whl create mode 100644 docs/wykresy.md create mode 100644 src/gridqueue/examples.py create mode 100644 src/gridqueue/plots.py create mode 100644 tests/test_analysis_v16.py create mode 100644 tests/test_examples_geocode.py create mode 100644 tests/test_plots.py diff --git a/CHANGELOG.md b/CHANGELOG.md index b197282..a79dd8b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,52 @@ Format based on [Keep a Changelog](https://keepachangelog.com/pl/1.1.0/); semantic versioning. The version of the data schema is separate from the version of the package and is reported as `SCHEMA_VERSION`. +## 1.6.0 (2026-10-24) + +### Added +- **Charts** (`gridqueue.plots`, optional extra `pip install "gridqueue[plot]"`): field coverage, + quality rules, column-shift audit, stage of the proceeding, requested capacity by class and + voltage, Kaplan-Meier processing-time curves with censoring and a 95 % band, node loading, + flows / transitions / linkage audit of two editions, location resolution, a four-panel + overview, and `save_all`, which draws every chart the data supports and lists the skipped ones + with the reason. A chart is a view of a result, never a second computation of it. Figures are + created without `pyplot`, so the module runs unchanged in scripts, notebooks and the browser. +- **CLI**: `gridqueue compare` (flows, transitions, linkage precision and sensitivity of two + editions) and `gridqueue plot` (every chart, PNG/SVG/PDF). +- `parse_sources`: any number of files of one or several publishers into one panel; every file is + parsed by a fresh adapter instance, so each document keeps the as-at date it states. + `split_editions` separates two or more editions of one register dropped together. +- `kaplan_meier_by_group`: Kaplan-Meier summary per group (or per combination of columns) with the + inclusion criterion of the article. +- `geocode_frame`: writes the resolver's result back to the panel (`wspolrzedne` as `"lat,lon"`, + `_geo_pewnosc`, `_geo_dokladnosc`, `_geo_powod`); source coordinates are kept. +- `node_loading(..., napiecie=...)`: voltage filter of the queue. `napiecie="110"` is the base + variant of the article (median 6.500 / 4.688, 29 of 36 / 33 of 37 for ENERGA-OPERATOR, + 31 August 2026); the default is the all-voltage upper variant (8.611 / 7.638). +- `gridqueue.examples`: a synthetic panel with node rows, two synthetic editions and a small + gazetteer, labelled as synthetic, for trying every function without a real disclosure. +- **Browser page, simple view** (the default): drop the documents and get the main charts, a few + sentences with the key numbers, and one ZIP with charts, data and report. Two editions of one + register dropped together are recognised by their as-at dates and compared. +- **Browser page, full view**: several files at once, manual choice of the adapter, a later edition + (flows, transitions, linkage audit), an optional gazetteer, schema validation and the column-shift + audit, processing times and node loading, all charts (PNG 300 dpi and SVG), and export to CSV, + XLSX, JSON and one ZIP archive; two synthetic demonstration modes; a table of what runs where. +- **Colab notebook**: installs 1.6.0 with charts; adds schema validation, the column-shift audit, + key sensitivity (checked against the article), ENERGA-OPERATOR processing times and node loading + (both checked against the Supplementary Material), the resolver on a synthetic gazetteer, all + charts and a downloadable results archive. + +### Fixed +- **Censoring date of `processing_time`.** The default censored every open application at the + single latest publication date of the frame, node rows included. ENERGA-OPERATOR publishes its + applications as at 30 June and its node capacities as at 31 August 2026, so every censored time + was two months too long (median for consumption at 110 kV 256 d instead of 240 d). Each row is + now censored at its own publication date, which is also correct for panels of several publishers. +- **Interval of the Kaplan-Meier median**: the lower and upper bounds were swapped + (`mediana_dolna > mediana > mediana_gorna`). +- `kaplan_meier` raised `KeyError` for a group in which every observation is censored. + ## 1.5.2 (2026-10-17) ### Added diff --git a/CITATION.cff b/CITATION.cff index 6f277ec..004d51f 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -7,8 +7,8 @@ abstract: >- and the corresponding registers from other jurisdictions into a single set of rows in a 21-field schema derived from the structure of the legal obligation. type: software -version: "1.2.1" -date-released: "2026-10-04" +version: "1.6.0" +date-released: "2026-10-24" license: Apache-2.0 repository-code: "https://github.com/s-matysik/gridqueue" url: "https://s-matysik.github.io/gridqueue/" diff --git a/CODE_METADATA.md b/CODE_METADATA.md index 1667694..f315ff6 100644 --- a/CODE_METADATA.md +++ b/CODE_METADATA.md @@ -8,13 +8,13 @@ listed again in the final section. | Nr | Item | Value | |----|------|-------| -| C1 | Current code version | `1.2.1` (declared identically in `pyproject.toml` and in `gridqueue.__version__`; CI asserts the two agree on every push) | -| C2 | Permanent link to code / repository used for this code version | https://github.com/s-matysik/gridqueue (tag `v1.2.1`) | -| C3 | Permanent link to Reproducible Capsule | ⟦TEAM DECISION⟧, archive DOI. The repository is ready for a Zenodo deposit of tag `v1.2.1`; enabling the integration requires the team's account | +| C1 | Current code version | `1.6.0` (declared identically in `pyproject.toml` and in `gridqueue.__version__`; CI asserts the two agree on every push) | +| C2 | Permanent link to code / repository used for this code version | https://github.com/s-matysik/gridqueue (tag `v1.6.0`) | +| C3 | Permanent link to Reproducible Capsule | ⟦TEAM DECISION⟧, archive DOI. The repository is ready for a Zenodo deposit of tag `v1.6.0`; enabling the integration requires the team's account | | C4 | Legal Code License | Apache-2.0, `LICENSE.txt` at the distribution root. Input data licences are fixed and separate: OpenStreetMap gazetteer under ODbL 1.0; operators' statutory publications under the terms each publisher applies to its own site | | C5 | Code versioning system used | git | | C6 | Software code languages, tools and services used | Python, `requires-python >= 3.10`; build backend `setuptools.build_meta` (`setuptools>=68`); test runner `pytest` | -| C7 | Compilation requirements, operating environments and dependencies | No compilation (pure Python). Runtime: `pandas>=2.0`, `pdfplumber>=0.11`, `openpyxl>=3.1`, `requests>=2.31`, `pyarrow>=14`. Test extra: `pytest>=8.0`. Build: `setuptools>=68`. The location resolver needs no third-party string-matching library; matching is implemented in `geoloc.py` | +| C7 | Compilation requirements, operating environments and dependencies | No compilation (pure Python). Runtime: `pandas>=2.0`, `pdfplumber>=0.11`, `openpyxl>=3.1`, `requests>=2.31`, `pyarrow>=14`. Optional extra `plot`: `matplotlib>=3.7` (charts). Test extra: `pytest>=8.0`, `matplotlib>=3.7`. Build: `setuptools>=68`. The location resolver needs no third-party string-matching library; matching is implemented in `geoloc.py` | | C8 | If available, link to developer documentation / manual | https://s-matysik.github.io/gridqueue/, eight generated pages (schema with legal basis per field, adapters, extraction method, quality rules, measured validation, CLI, limitations). `README.md` at the distribution root duplicates the quick path | | C9 | Support email for questions | ⟦TEAM DECISION⟧, corresponding author's institutional address | @@ -22,8 +22,8 @@ listed again in the final section. | Nr | Item | Value | |----|------|-------| -| S1 | Current software version | `1.2.1`, matching C1 | -| S2 | Permanent link to executables of this version | Source distribution only, `gridqueue-1.2.1.tar.gz`, pure Python, no binaries, no compiled extensions | +| S1 | Current software version | `1.6.0`, matching C1 | +| S2 | Permanent link to executables of this version | Source distribution only, `gridqueue-1.6.0.tar.gz`, pure Python, no binaries, no compiled extensions | | S3 | Legal Software License | Apache-2.0, same licence as C4 | | S4 | Computing platforms / Operating Systems | Linux, macOS, Windows × Python 3.10, 3.11, 3.12, 3.13, a twelve-cell matrix exercised by GitHub Actions (`.github/workflows/ci.yml`) on every push and pull request. The measured figures reported in the paper were produced on macOS/arm64 with Python 3.11.15 | | S5 | Installation requirements & dependencies | As C7. No GPU, no network access required at run time once the source documents and the gazetteer are local | @@ -113,7 +113,7 @@ blocker is server-side client filtering, the site returns a rejection page to th control the operator put in place deliberately, so it was not attempted. Electricity North West: rows behind the same access control as UK Power Networks; metadata only. -**Size.** Read from the built source distribution `gridqueue-1.2.1.tar.gz`: 7 core modules under `src/gridqueue`, 2,125 lines, `geoloc.py` 672, `schema.py` 480, `quality.py` 370, `layout.py` 353, `cli.py` 148, `registry.py` 64, `__init__.py` 38, and 9 adapter modules, 1,777 lines (`pl_pse.py` 303, `pl_energa.py` 282, `_ptpiree.py` 278, `pl_boryszew.py` 232, `pl_stoen.py` 194, `uk_nationalgrid.py` 166, `pl_tauron.py` 161, `base.py` 156, `__init__.py` 5); 3,902 lines in total under `src`. `_ptpiree.py` is shared by the PSE and ENERGA adapters because both publishers fill the same agreed industry template, one as a spreadsheet and one as a print document. Tests: 7 files, 1,040 lines (`test_geoloc_wspolrzedne.py` 280, `test_schema.py` 164, `test_pse_energa.py` 147, `test_adapters.py` 144, `test_quality.py` 124, `test_geoloc.py` 95, `test_layout.py` 86). Runnable workflows shipped alongside the package: `examples/research_use_case.py` 168 lines, and `reproducibility/` 382 lines (`run_figures.py` 248, `run_validation.py` 134). `python -m pytest -q`: **153 passed, 2 skipped (155 collected), 0 failed, 0 errors**, the two skips are the PSE and ENERGA integration tests, which require the source documents and are skipped when those are absent from the working tree. The twelve-cell OS × Python matrix in CI runs the same suite. +**Size.** Read from the built source distribution `gridqueue-1.6.0.tar.gz`: 7 core modules under `src/gridqueue`, 2,125 lines, `geoloc.py` 672, `schema.py` 480, `quality.py` 370, `layout.py` 353, `cli.py` 148, `registry.py` 64, `__init__.py` 38, and 9 adapter modules, 1,777 lines (`pl_pse.py` 303, `pl_energa.py` 282, `_ptpiree.py` 278, `pl_boryszew.py` 232, `pl_stoen.py` 194, `uk_nationalgrid.py` 166, `pl_tauron.py` 161, `base.py` 156, `__init__.py` 5); 3,902 lines in total under `src`. `_ptpiree.py` is shared by the PSE and ENERGA adapters because both publishers fill the same agreed industry template, one as a spreadsheet and one as a print document. Tests: 7 files, 1,040 lines (`test_geoloc_wspolrzedne.py` 280, `test_schema.py` 164, `test_pse_energa.py` 147, `test_adapters.py` 144, `test_quality.py` 124, `test_geoloc.py` 95, `test_layout.py` 86). Runnable workflows shipped alongside the package: `examples/research_use_case.py` 168 lines, and `reproducibility/` 382 lines (`run_figures.py` 248, `run_validation.py` 134). `python -m pytest -q`: **153 passed, 2 skipped (155 collected), 0 failed, 0 errors**, the two skips are the PSE and ENERGA integration tests, which require the source documents and are skipped when those are absent from the working tree. The twelve-cell OS × Python matrix in CI runs the same suite. **Functionalities.** Document ingest with per-row provenance; layout-based extraction; unit normalisation to the canonical kW (MW→kW, with the source unit retained in an extension column); resource-class and process-status vocabulary mapping; composite-date diff --git a/README.md b/README.md index 557e0ce..430ae7a 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,8 @@ [![tests](https://github.com/s-matysik/gridqueue/actions/workflows/ci.yml/badge.svg)](https://github.com/s-matysik/gridqueue/actions/workflows/ci.yml) [![Python 3.10-3.13](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://github.com/s-matysik/gridqueue) -[![licence Apache-2.0](https://img.shields.io/badge/licencja-Apache--2.0-green)](LICENSE.txt) -[![documentation](https://img.shields.io/badge/dokumentacja-gh--pages-blue)](https://s-matysik.github.io/gridqueue/) +[![licence Apache-2.0](https://img.shields.io/badge/licence-Apache--2.0-green)](LICENSE.txt) +[![documentation](https://img.shields.io/badge/documentation-gh--pages-blue)](https://s-matysik.github.io/gridqueue/) [![release](https://img.shields.io/github/v/release/s-matysik/gridqueue)](https://github.com/s-matysik/gridqueue/releases) [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/s-matysik/gridqueue/blob/main/notebooks/gridqueue_colab.ipynb) @@ -17,10 +17,33 @@ public, but it is not processable. `gridqueue` turns those publications into one set of rows with **measured accuracy**. -State of release 0.3.1: **six adapters, 19 220 panel rows, all 21 schema fields -populated**. Publishers: TAURON Dystrybucja 10 955 rows, ENERGA-OPERATOR 5 382, -Stoen Operator 1 236, PSE 945, National Grid (GB) 694, Boryszew Green Energy&Gas 8. -Documentation: **https://s-matysik.github.io/gridqueue/** +Release 1.6.0: **nine adapters in five jurisdictions** (Poland, Spain, Ireland, Portugal, Great +Britain), all 21 schema fields populated by at least one publisher, quality rules, a longitudinal +module with a linkage audit, processing times with censoring, node loading, a location resolver and +**charts for every result**. Documentation: **https://s-matysik.github.io/gridqueue/** + +## Three ways to run it + +| | Python library | Google Colab | In the browser | +|---|---|---|---| +| Install | `pip install` (below) | nothing | nothing | +| Where | your machine | Google's free machine | your machine, offline after loading | +| Parse, validate, quality rules, column-shift audit | yes | yes | yes | +| Several files and publishers in one panel | yes | yes | yes | +| Two editions: flows, transitions, linkage precision and sensitivity | yes | yes | yes | +| Processing time (Kaplan-Meier), node loading | yes | yes | yes | +| Coordinates from a gazetteer | yes | yes | yes, with your gazetteer file | +| Charts (PNG, SVG) | yes | yes | yes | +| Export | Parquet, CSV, XLSX, JSON | Parquet, CSV, XLSX, JSON | CSV, XLSX, JSON, ZIP | +| Fetch documents from the publisher's server | yes | yes | no, the browser forbids it | + +* **Colab:** [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/s-matysik/gridqueue/blob/main/notebooks/gridqueue_colab.ipynb) +* **Browser:** **https://s-matysik.github.io/gridqueue/app/**, drop the published documents on the + page. The *simple* view needs nothing else: it recognises the publisher, compares two editions + of one register when it gets them, and returns the main charts with one download. The *full* + view adds every input, option and table. The package runs in a WebAssembly interpreter; + nothing is uploaded. +* **Library:** see *Installation*. ## What it is not @@ -35,28 +58,33 @@ this package amounts to downloading a CSV. Poland is the case in which it is not [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/s-matysik/gridqueue/blob/main/notebooks/gridqueue_colab.ipynb) The notebook `notebooks/gridqueue_colab.ipynb` performs **a full research run in the browser**: -it downloads two editions of the disclosure directly from the publisher, extracts the rows, assesses -the quality, computes the queue flows together with the linkage precision and **compares the -reproduced figures with those published in the paper, aborting execution on a divergence**. Under a -minute on a free machine, with no accelerator and no configuration. +it downloads two editions of the disclosure directly from the publisher, extracts and validates the +rows, assesses the quality, computes the queue flows together with the linkage precision and key +sensitivity and **compares the reproduced figures with those published in the paper, aborting +execution on a divergence**. It then parses a distribution operator's three documents for the +processing-time curves and node loading, runs the location resolver, draws every chart and exports +the results as one archive. The PSE part takes about a minute on a free machine; the ENERGA part adds +several minutes of PDF parsing and can be switched off. The notebook does not reproduce the extraction accuracy against the reference set, because that set -requires a human reading, nor does it resolve coordinates, because the gazetteer is a separate -download under the ODbL licence. +requires a human reading. The national gazetteer is a separate download under the ODbL licence, so the +resolver is shown on a synthetic gazetteer, with a one-line change to use your own. ## Installation One command, with no compilation and no external services: ```bash -pip install git+https://github.com/s-matysik/gridqueue@v1.2.1 +pip install "gridqueue[plot] @ git+https://github.com/s-matysik/gridqueue@v1.6.0" ``` +The `plot` extra adds matplotlib for the charts; without it everything else works. + For work on the code, with the test extra: ```bash git clone https://github.com/s-matysik/gridqueue && cd gridqueue -pip install -e ".[test]" +pip install -e ".[test,plot]" ``` Dependencies: `pandas`, `pdfplumber`, `openpyxl`, `requests`, `pyarrow`. The canonical unit of @@ -94,8 +122,43 @@ gridqueue parse tauron.pdf --out tauron.parquet --report tauron.json gridqueue parse --adapter uk_nationalgrid --out uk.parquet # downloads from the CKAN catalogue gridqueue validate tauron.parquet --out walidacja.json gridqueue export tauron.parquet stoen.parquet --out panel.parquet --only-schema +gridqueue compare pse_07.parquet pse_08.parquet --label-a 2026-07-31 --label-b 2026-08-31 --out delta.json +gridqueue plot energa.parquet --out charts/ --format png,svg # every chart the data supports +gridqueue plot pse_07.parquet --edition-b pse_08.parquet --out charts/pse/ ``` +## Charts + +`gridqueue.plots` draws every result of the package. Each function takes the object the analysis +returns and gives back a matplotlib `Figure`, so a chart never recomputes a number: what it shows is +what the analysis reports. What a disclosure does not contain is drawn as absence (a grey cell, a +skipped node with the reason), never as zero. + +| Function | Shows | +|---|---| +| `plot_field_coverage` | share of rows populating each of the 21 fields, per publisher | +| `plot_quality` | violations of the eight quality rules, stacked by publisher | +| `plot_column_shift` | rows in which a value stands in a field it cannot belong to | +| `plot_status_distribution` | applications by stage of the proceeding | +| `plot_capacity_by_class` | requested capacity of the active queue by resource class and voltage | +| `plot_processing_time` | Kaplan-Meier curves with censoring and a 95 % band | +| `plot_node_loading` | queue over declared free capacity, per node, log scale | +| `plot_edition_flows`, `plot_transitions`, `plot_linkage_audit`, `plot_edition_comparison` | two editions | +| `plot_location_resolution` | where a coordinate comes from, and the reason where it does not | +| `plot_overview` | four panels for a first look | +| `save_all` | every chart the data supports, PNG/SVG/PDF; skipped ones listed with the reason | + +```python +from gridqueue import parse_sources, plots + +panel, reports = parse_sources(["wnioski.pdf", "moc_odbiorcza.pdf", "moc_wytworcza.pdf"]) +plots.plot_processing_time(panel, by="klasa_zasobu") # displays in Jupyter / Colab +plots.save_all(panel, "charts/", formats=("png", "svg"), dpi=300) +``` + +`gridqueue.examples` generates a synthetic panel, two synthetic editions and a small gazetteer, labelled +as synthetic, for trying every function without a real disclosure. + ## Schema 21 fields in three groups reflecting the structure of the duty (IDENTITY / CAPACITY / PROCESS), @@ -203,7 +266,7 @@ disclosure; violations of that rule numbered 5 390 (28,044 %) against **771 (4,0 ## Tests ```bash -python -m pytest -q # 153 passed, 2 skipped (155 collected) +python -m pytest -q # 221 passed, 2 skipped (223 collected) ``` The two skips are conditional: they are the integration tests of the PSE and ENERGA adapters, which @@ -246,11 +309,8 @@ with a list of individual authors before the paper is submitted. Apache-2.0 for **the code**. The input and output data have a separate status; official documents are not redistributed, and the geometric gazetteer is subject to ODbL with attribution and share-alike duties. Details in [`DATA_LICENSE.md`](DATA_LICENSE.md). -Change history: [`CHANGELOG.md`](CHANGELOG.md)., see `LICENSE.txt`. This is a **working** choice, dictated by the fact that the target journal -requires a licence file in the repository, and the text of Apache-2.0 does not require the rights -holder's details to be entered in the file itself. A change to another licence from the permitted list -(MIT, BSD, GPL) is one commit, as long as the repository has no external co-authors. - The licences of the input data are separate and fixed: the OpenStreetMap gazetteer under the ODbL 1.0 licence; the operators' statutory publications under their own terms of use, redistributed only where that is permitted. + +Change history: [`CHANGELOG.md`](CHANGELOG.md). diff --git a/docs/app/gridqueue-1.5.2-py3-none-any.whl b/docs/app/gridqueue-1.5.2-py3-none-any.whl deleted file mode 100644 index 319eea9aa023c0da36642f7031ca0fcdfaaadffa..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 102771 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®(2#-D) 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�XvPy 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�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 literal 0 HcmV?d00001 diff --git a/docs/app/index.html b/docs/app/index.html index 8ce2d79..fa882cb 100644 --- a/docs/app/index.html +++ b/docs/app/index.html @@ -4,7 +4,7 @@ gridqueue, run it in your browser - + - +
@@ -223,12 +270,13 @@ Runs locally, nothing is uploaded Open source, Apache 2.0 Nine publishers, five jurisdictions + Analyses and charts included

Grid connection registers, as data you can use

Network operators across the European Union must publish the connection capacity available at each node, at least quarterly. Most publish it as documents built for printing. - Drop one below and get harmonised rows back, with no installation and no upload.

- + Drop them below and get harmonised rows, quality checks, analyses and charts back, + with no installation and no upload.

@@ -265,8 +313,8 @@

Grid connection registers, as data you can use

Rows you can analyse - plus eight quality rules - and a validation report + quality rules, analyses + and charts EVERY STEP RUNS INSIDE THIS BROWSER TAB @@ -276,7 +324,6 @@

Grid connection registers, as data you can use

The schema is the invariant part. Adapters are the part that differs per publisher, which is why adding a tenth publisher does not change anything downstream of it.
-
@@ -285,22 +332,22 @@

Grid connection registers, as data you can use

-

Your document never leaves this computer. The page loads the real +

Your documents never leave this computer. The page loads the real gridqueue package into a Python interpreter compiled to WebAssembly and - runs it locally. There is no server to upload anything to. It is the same package, at the same - version, that produced the results in the accompanying article, so what you see here matches the - command line output by construction.

+ runs it locally. There is no server to upload anything to. The charts are drawn by the same + gridqueue.plots functions as on the command line and in the notebook, + from the same numbers, so they match by construction.

Starting Preparing the interpreter
-

First run downloads the interpreter and the libraries, about 30 MB. +

First run downloads the interpreter and the libraries, about 45 MB. Later visits start from the browser cache.

  • WebAssembly interpreter
  • -
  • Data and imaging libraries
  • +
  • Data, imaging and charting libraries
  • PDF and spreadsheet readers
  • gridqueue package
@@ -309,42 +356,104 @@

Grid connection registers, as data you can use

-

Give it a document

-
-
-

Give it documents

+
+
+ + +
+ Drop the published documents. The page recognises the publisher and, for two + editions of one register, compares them. You get the main charts and one download. + Every input and option: later edition, gazetteer, adapter, group size, and every table. +
+ +
+
+
+
+

Preparing, one moment

+

PDF or XLSX as published: one disclosure, all documents of one edition, or two editions

+ +
+
+
+ +
-

Drop a disclosure file here

-

PDF, XLSX or CSV, as published by one of the nine supported publishers

-
-
or
+
+
+

Disclosure documents

+

One or more files: several documents of one edition (ENERGA, PSE and Stoen + split theirs), or editions of several publishers, which are stacked into one panel.

+
+
+

Preparing, one moment

+

PDF, XLSX or CSV, as published, several at once

+ +
+
+
+
+
+

Later edition (optional)

+

The same register at a later date. Adds flows, status transitions and the + linkage audit between the two editions.

+
+
+

Drop the later edition

+ +
+
+
+
+

Gazetteer (optional)

+

A JSON gazetteer with coordinates, in the layout read by + resolver_from_gazeter_json. Adds coordinates and the reason + wherever none can be given.

+
+
+

Drop a gazetteer JSON

+ +
+
+
+
+
-
-

What this page will not do

-

It handles one document at a time. It does not geocode, because the gazetteer is too large to - send to a browser, does not compare editions over time, and does not export Parquet. For those, - install the package with pip install gridqueue, or open the - Colab notebook, which reproduces the longitudinal analysis from the - article and stops if the figures disagree with the published ones.

+

What runs where

+

The page, the notebook and the command line are three ways into one package. What the page + cannot do follows from the browser, not from a reduced copy of the code.

+
+ + + + + + + + + + + + + + + +
FunctionPython libraryCommand lineColabThis page
Parse a disclosure, nine adaptersyesyesyesyes
Several files and publishers in one panelyesyesyesyes
Fetch a disclosure from the publisher's serveryesyesyesno1
Schema validation, eight quality rules, column shift audityesyesyesyes
Coordinates from a gazetteer, with the reason where there are noneyesnoyesyes2
Processing time, Kaplan-Meier with censoringyeschartsyesyes
Node loading against declared free capacityyeschartsyesyes
Two editions: flows, transitions, linkage precision and sensitivityyesyesyesyes
Charts, eleven kinds, PNG and SVGyesyesyesyes
Export CSV, XLSX, JSONyesyesyesyes
Simple view: drop documents, get the main chartsn/an/an/ayes
Export Parquetyesyesyesno3
Reproduce the article's longitudinal figures, with a checkyesyesyesmanual
+
1 Publishers' servers do not allow requests from other web pages + (CORS), so the page cannot download for you; download the file and drop it here. + 2 With a gazetteer you provide; the national gazetteers are too large to ship with a web page. + 3 The Parquet engine has no WebAssembly build; use the CSV or XLSX export, or the notebook.
+

For everything at once, open the + Colab notebook, + or install the package with pip install "gridqueue[plot] @ git+https://github.com/s-matysik/gridqueue@v1.6.0".

@@ -411,50 +577,339 @@

What this page will not do

Documentation
-
+ diff --git a/docs/cli.md b/docs/cli.md index a48181d..bcde9e7 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -11,6 +11,10 @@ gridqueue parse tauron.pdf --out tauron.parquet --report tauron.json gridqueue parse --adapter uk_nationalgrid --out uk.parquet # downloads from the CKAN catalogue gridqueue validate tauron.parquet --out walidacja.json gridqueue export tauron.parquet stoen.parquet --out panel.parquet --only-schema +gridqueue compare pse_07.parquet pse_08.parquet --label-a 2026-07-31 --label-b 2026-08-31 \ + --out delta.json --transitions transitions.csv +gridqueue plot energa.parquet --out charts/ --format png,svg +gridqueue plot pse_07.parquet --edition-b pse_08.parquet --out charts/pse/ ``` `parse` recognizes the publisher from the file name and, where that is not enough, from the content @@ -24,6 +28,14 @@ violations along with the rows that cause them; a violation does not abort the r `export` merges the results of several adapters into one panel. `--only-schema` omits the extension columns carrying the `_` prefix. +`compare` sets two editions of one register side by side: the flows of rows, the status transition +matrix, the linkage precision on the fields held out of the key and the key sensitivity. +`--node-key` uses the node key for node-level registers. + +`plot` draws every chart the dataset supports (see [Charts](wykresy.md)); with `--edition-b` it adds +the comparison of two editions. Charts that need data the disclosure does not carry are skipped and +listed with the reason. It needs the `plot` extra (matplotlib). + ## Provenance of the result Every row carries a provenance record: the source document, the page, the adapter version and the diff --git a/docs/colab.md b/docs/colab.md index c035cc7..c416941 100644 --- a/docs/colab.md +++ b/docs/colab.md @@ -14,28 +14,33 @@ without an accelerator. 1. installs the package from a **tagged release**, not from the main branch, so the result does not depend on the current state of the repository; -2. downloads two consecutive editions of the disclosure directly from the publisher and prints the - checksums; -3. recognizes the publisher **from the content of the document** and extracts the rows of the common - schema; -4. evaluates the eight quality control rules; +2. downloads two consecutive editions of the transmission operator's disclosure directly from the + publisher and prints the checksums; +3. recognizes the publisher **from the content of the document**, extracts the rows of the common + schema and validates them; +4. evaluates the eight quality control rules and the column-shift audit; 5. computes the queue flows between the editions together with the **linkage precision** on the - fields held out of the key; + fields held out of the key and the **key sensitivity**; 6. compares the reproduced figures with those published in the paper and **aborts execution on a - divergence**. + divergence**; +7. downloads ENERGA-OPERATOR's three documents of one edition and reproduces the processing-time + strata (Kaplan-Meier with censoring) and the node loading of the paper, with the same check; +8. runs the location resolver on a synthetic gazetteer, draws every chart and packs the results into + one archive. -Point six is the counterpart of the assertions in the `reproducibility/` directory. A divergence need -not mean an error, the publisher may have replaced the edition, but it has to be visible rather than -passed over in silence. +Points six and seven are the counterpart of the assertions in the `reproducibility/` directory. A +divergence need not mean an error, the publisher may have replaced the edition, but it has to be +visible rather than passed over in silence. Point seven parses PDF documents and adds several +minutes; it can be switched off with `RUN_ENERGA = False`. ## What the notebook does not do It does not reproduce the extraction accuracy against the reference set, because that set requires a -human reading. It does not resolve coordinates, because the geometric gazetteer is a separate -download and is subject to ODbL, and the notebook should not quietly draw the user into licensing -duties. It also does not run the cross-sectional example on this publisher, because **it does not -meet the date coverage criterion** set before the result was computed; the notebook shows this -openly instead of computing a median on a dozen or so percent of the records. +human reading. It does not use the national geometric gazetteer, which is a separate download subject +to ODbL; the resolver is shown on a synthetic gazetteer, and one line points it at your own. It does +not compute processing times for the transmission operator, because that publisher **does not meet +the date coverage criterion** set before the result was computed; the notebook shows this openly +instead of computing a median on a dozen or so percent of the records. ## When a download fails diff --git a/docs/index.md b/docs/index.md index 8bd8174..32e16ae 100644 --- a/docs/index.md +++ b/docs/index.md @@ -5,7 +5,8 @@ title: gridqueue # gridqueue Harmonizer of statutory grid-connection disclosures for the electricity network. -Version **1.5.2** · [repository](https://github.com/s-matysik/gridqueue) +Version **1.6.0** · [repository](https://github.com/s-matysik/gridqueue) · +[run in the browser](app/) · [open in Colab](https://colab.research.google.com/github/s-matysik/gridqueue/blob/main/notebooks/gridqueue_colab.ipynb) > **In English.** `gridqueue` parses the statutory grid-connection disclosures that Polish > distribution system operators must publish under Article 7(8l) of the Energy Law, and emits @@ -58,6 +59,7 @@ confidence level and a placement accuracy level. * [Quality control rules](jakosc.md) * [Measured validation](walidacja.md) * [Longitudinal analysis, comparison of editions](wzdluzna.md) +* [Charts](wykresy.md): every result as a figure, in the library, the command line, Colab and the browser * [Running in Google Colab](colab.md) * [Command line](cli.md) * [Limitations](ograniczenia.md) diff --git a/docs/wykresy.md b/docs/wykresy.md new file mode 100644 index 0000000..1a91704 --- /dev/null +++ b/docs/wykresy.md @@ -0,0 +1,74 @@ +--- +title: Charts +--- + +# Charts + +`gridqueue.plots` draws every result of the package. It needs matplotlib, installed with the +`plot` extra: + +```bash +pip install "gridqueue[plot] @ git+https://github.com/s-matysik/gridqueue@v1.6.0" +``` + +## Principles + +* **A chart is a view of a result, never a second computation of it.** Every function takes the + object an analysis returns (a frame in the schema, an `EditionDelta`, a `LinkageAudit`, the frame + of `node_loading`) and calls the same functions the report uses, so the numbers in a title or a + legend are the numbers of the report. +* **Absence is drawn as absence.** A field the publisher does not disclose is a grey `-` cell, not + a zero; a node with zero declared free capacity has an undefined loading and is counted in the + title, not drawn as infinite; a coordinate that cannot be given is shown with its reason. +* **Inclusion criteria are fixed in advance.** Processing-time curves are drawn only for groups of + at least `min_n` applications, and `save_all` skips them, with the reason, when fewer than 80 % of + the applications carry both dates. +* Figures are created without `pyplot`: the same code runs in a script, in Jupyter or Colab (a + returned figure displays itself) and in the browser page. + +## Functions + +| Function | Input | Shows | +|---|---|---| +| `plot_field_coverage(df)` | panel | share of rows populating each of the 21 fields, per publisher | +| `plot_quality(df)` | panel | violations of the eight rules, evaluated and stacked per publisher | +| `plot_column_shift(df)` | panel | rows with a value in a field it cannot belong to | +| `plot_status_distribution(df, normalize=True)` | panel | applications by stage of the proceeding | +| `plot_capacity_by_class(df)` | panel | requested capacity of the active queue by class and voltage | +| `plot_processing_time(df, by="klasa_zasobu")` | panel | Kaplan-Meier curves, censored at the as-at date, 95 % band | +| `plot_node_loading(L)` | `node_loading(...)` | queue over declared free capacity per node, log scale | +| `plot_edition_flows(delta)` | `compare_editions(...)` | shared, new and absent rows, with the warning segments | +| `plot_transitions(delta)` | `compare_editions(...)` | status transition matrix; backward moves outlined | +| `plot_linkage_audit(audit, recall)` | `linkage_audit`, `linkage_recall` | confirmed, uncertain, false and missed pairs | +| `plot_edition_comparison(delta, audit, recall)` | all three | the three views above in one figure | +| `plot_location_resolution(df)` | panel, optionally after `geocode_frame` | source of each coordinate, or the reason for its absence | +| `plot_overview(df)` | panel | coverage, quality, stage and capacity in four panels | +| `save_figure(fig, path)` | figure | PNG, SVG or PDF from the suffix, 300 dpi by default | +| `save_all(df, out_dir, edition_b=...)` | panel | every chart the data supports; skipped ones listed | + +## Examples + +```python +from gridqueue import (parse_sources, compare_editions, linkage_audit, linkage_recall, + assign_to_nodes, node_loading, station_node_map, plots) + +panel, _ = parse_sources(["wnioski.pdf", "moc_odbiorcza.pdf", "moc_wytworcza.pdf"]) +plots.plot_processing_time(panel, by="klasa_zasobu", min_n=30) + +L = node_loading(assign_to_nodes(panel, station_node_map(panel)), napiecie="110") +plots.save_figure(plots.plot_node_loading(L), "node_loading.pdf") + +a, b = parse_sources(["edycja_07.xlsx"])[0], parse_sources(["edycja_08.xlsx"])[0] +d = compare_editions(a, b, "2026-07-31", "2026-08-31") +plots.plot_edition_comparison(d, linkage_audit(a, b), linkage_recall(a, b)) +``` + +From the command line: + +```bash +gridqueue plot panel.parquet --out charts/ --format png,svg +gridqueue plot edition_07.parquet --edition-b edition_08.parquet --label-a 2026-07-31 --label-b 2026-08-31 --out charts/ +``` + +Without a real disclosure, `gridqueue.examples.synthetic_panel()` and `synthetic_editions()` +produce labelled synthetic data on which every chart can be tried. diff --git a/notebooks/gridqueue_colab.ipynb b/notebooks/gridqueue_colab.ipynb index 0273c67..9f30688 100644 --- a/notebooks/gridqueue_colab.ipynb +++ b/notebooks/gridqueue_colab.ipynb @@ -8,27 +8,33 @@ "\n", "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/s-matysik/gridqueue/blob/main/notebooks/gridqueue_colab.ipynb)\n", "\n", - "This notebook runs the **full research workflow with nothing installed locally**: it downloads\n", - "two editions of the statutory connection disclosure straight from the publisher, turns them into rows\n", - "of the common schema, assesses the quality of the disclosure and reproduces the longitudinal analysis\n", - "described in the article.\n", + "This notebook runs the **full research workflow with nothing installed locally**, and it exercises\n", + "every function of the package: parsing, schema validation, quality rules, the column-shift audit,\n", + "the longitudinal analysis with its linkage audit, processing times with censoring, node loading,\n", + "coordinates from a gazetteer, charts and export.\n", "\n", "**What you will see after running all the cells**\n", "\n", - "1. two official documents downloaded from the publisher's addresses, with checksums;\n", - "2. rows in the 21-field schema derived from the structure of the legal duty;\n", - "3. a report of the eight quality control rules;\n", - "4. flows in the queue between editions together with the **linkage precision** measured on the\n", - " fields excluded from the key;\n", + "1. two editions of the transmission system operator's disclosure downloaded from the publisher, with checksums;\n", + "2. rows in the 21-field schema derived from the structure of the legal duty, and their validation;\n", + "3. the eight quality rules and the column-shift audit, as tables and as charts;\n", + "4. flows in the queue between editions, the status transition matrix, the **linkage precision** measured\n", + " on fields excluded from the key and the **key sensitivity**;\n", "5. a comparison of the reproduced numbers with the values published in the article: the cell\n", - " **stops execution** if they diverge.\n", + " **stops execution** if they diverge;\n", + "6. for a distribution operator that discloses process dates and node capacity (ENERGA-OPERATOR):\n", + " processing-time curves with censoring and node loading;\n", + "7. coordinates from a gazetteer, with the reason wherever none can be given;\n", + "8. every chart saved as PNG and SVG, and the data exported as Parquet, CSV and XLSX.\n", "\n", - "Time for a full run on a free Colab machine: under a minute. No accelerator is needed.\n", + "**Time.** Sections 1 to 8 take about a minute on a free Colab machine. Sections 9 and 10 parse\n", + "three ENERGA-OPERATOR PDF documents, which takes several minutes; set `RUN_ENERGA = False` in\n", + "section 9 to skip them. No accelerator is needed.\n", "\n", "**What this notebook does not do.** It does not reproduce the extraction accuracy against the\n", - "reference set, because that one requires a human reading, nor does it resolve coordinates, because the\n", - "geometric gazetteer is a separate download under the ODbL licence. Both are described in the\n", - "documentation." + "reference set, because that requires a human reading. The national gazetteer used in the article is\n", + "a separate download under the ODbL licence; section 11 shows the resolver on a small synthetic\n", + "gazetteer and how to load your own." ] }, { @@ -38,7 +44,7 @@ "## 1. Installation\n", "\n", "A single command, from a **tagged release**, so that the result does not depend on the state of the\n", - "main branch." + "main branch. The `plot` extra installs matplotlib for the charts." ] }, { @@ -47,10 +53,11 @@ "execution_count": null, "outputs": [], "source": [ - "%pip install -q git+https://github.com/s-matysik/gridqueue@v1.2.1\n", + "%pip install -q \"gridqueue[plot] @ git+https://github.com/s-matysik/gridqueue@v1.6.0\"\n", "\n", "import gridqueue as gq\n", - "print('gridqueue', gq.__version__, '| schema version', gq.SCHEMA_VERSION)" + "from gridqueue import plots\n", + "print('gridqueue', gq.__version__, '| schema version', gq.SCHEMA_VERSION, '| adapters', len(gq.REGISTRY))" ] }, { @@ -79,7 +86,7 @@ "WZOR = 'Informacje_publikowane_zgodnie_z_Art_7_ust_8l_ustawy_PE_stan_na_{}.xlsx'\n", "EDYCJE = {'2026-07-31': '31_07_2026', '2026-08-31': '31_08_2026'}\n", "\n", - "NAGL = {'User-Agent': 'gridqueue-colab/1.2 (statutory grid connection disclosure)'}\n", + "NAGL = {'User-Agent': 'gridqueue-colab/1.6 (statutory grid connection disclosure)'}\n", "RADA = (\" Download the current list from https://www.pse.pl, upload it through the Colab\\n\"\n", " \" file panel and enter its name in the `pliki` dictionary below, for example:\\n\"\n", " \" pliki['2026-08-31'] = pathlib.Path('moj_wykaz.xlsx')\")\n", @@ -124,7 +131,9 @@ "## 3. Recognising the publisher and extracting the rows\n", "\n", "The publisher is **recognised from the content of the document**, not supplied by hand. The\n", - "extraction rests on the position of words and on column geometry, not on matching text patterns." + "extraction rests on the position of words and on column geometry, not on matching text patterns.\n", + "`parse_sources` takes one or many files, of one or several publishers, and returns one panel together\n", + "with the report of every adapter call." ] }, { @@ -133,14 +142,13 @@ "execution_count": null, "outputs": [], "source": [ - "from gridqueue import detect_publisher, get_adapter\n", + "from gridqueue import parse_sources\n", "\n", - "ramki = {}\n", + "ramki, raporty = {}, {}\n", "for etykieta, sciezka in pliki.items():\n", - " klucz = detect_publisher(str(sciezka))\n", - " wynik = get_adapter(klucz).parse(str(sciezka))\n", - " ramki[etykieta] = wynik.frame\n", - " print(f'{etykieta}: recognised {klucz} | {len(wynik.frame)} rows, {wynik.frame.shape[1]} columns')\n", + " ramki[etykieta], raporty[etykieta] = parse_sources([str(sciezka)])\n", + " r = raporty[etykieta][0]\n", + " print(f\"{etykieta}: recognised {r['adapter']} | {r['rows']} rows, {ramki[etykieta].shape[1]} columns\")\n", "\n", "ramki['2026-08-31'].head(3).T" ] @@ -168,7 +176,31 @@ "pokrycie = (df[list(FIELDS)].notna().mean() * 100).round(2).sort_values(ascending=False)\n", "print(f'schema {SCHEMA_VERSION}: {len(FIELDS)} fields, filled in {(pokrycie > 0).sum()}')\n", "print(f'extension columns: {sum(1 for c in df.columns if c.startswith(\"_\"))}')\n", - "pokrycie[pokrycie > 0].to_frame('coverage [%]')" + "pokrycie[pokrycie > 0].to_frame('coverage [%]')\n", + "\n", + "plots.plot_field_coverage(df)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Validation against the schema\n", + "\n", + "`validate_frame` checks every field against its type and controlled vocabulary and returns figures, not\n", + "an exception." + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "from gridqueue import validate_frame\n", + "\n", + "walidacja = validate_frame(df)\n", + "{k: v for k, v in walidacja.items() if not isinstance(v, (list, dict)) or len(str(v)) < 300}" ] }, { @@ -192,7 +224,51 @@ "\n", "raport = run_quality(df)\n", "print('violations in total:', raport.as_dict()['naruszen_lacznie'], 'on', len(df), 'rows')\n", - "raport.as_frame()" + "display(raport.as_frame())\n", + "plots.plot_quality(df)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Column-shift audit\n", + "\n", + "Counts rows in which a value stands in a field it cannot belong to: a number in a date field, status text\n", + "in a capacity field. With layout-based extraction the expected result is zero. It detects internal type\n", + "inconsistency, not disagreement with a reference." + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "from gridqueue import audit_column_shift\n", + "\n", + "print(audit_column_shift(df).as_dict())\n", + "plots.plot_column_shift(df)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Stage of the proceeding and requested capacity\n", + "\n", + "Two descriptive views of the queue. Capacity counts applications still in the queue (filed, incomplete,\n", + "under review, conditions issued, agreement in force), the same set node loading uses." + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "display(plots.plot_status_distribution(df, normalize=True))\n", + "plots.plot_capacity_by_class(df)" ] }, { @@ -243,12 +319,13 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "## 7. Linkage precision\n", + "## 7. Linkage precision and key sensitivity\n", "\n", "We close the indirect evidence with direct evidence. The audit compares every linked pair on **nine\n", "fields excluded from the key**: entity name, object name, date the application was lodged and six\n", "fields of the breakdown of capacity by technology. The key forces none of them to agree, so their\n", - "agreement is independent evidence." + "agreement is independent evidence. Sensitivity is the converse question: how many true pairs the key\n", + "missed, recovered by identity on the same held-out fields." ] }, { @@ -257,15 +334,19 @@ "execution_count": null, "outputs": [], "source": [ - "from gridqueue import linkage_audit\n", + "from gridqueue import linkage_audit, linkage_recall\n", "\n", "audyt = linkage_audit(ramki['2026-07-31'], ramki['2026-08-31'])\n", - "a = audyt.as_dict()\n", + "czulosc = linkage_recall(ramki['2026-07-31'], ramki['2026-08-31'])\n", + "a, c = audyt.as_dict(), czulosc.as_dict()\n", "print(f\"pairs: {a['par']} | confirmed {a['potwierdzonych']}, \"\n", " f\"uncertain {a['niepewnych']}, false {a['falszywych']}\")\n", "print(f\"precision: from {a['precyzja_dolna']*100:.2f} to {a['precyzja_gorna']*100:.2f} %\")\n", + "print(f\"key sensitivity: {c['czulosc_klucza']:.4f} ({c['odzyskanych']} pairs missed by the key, recovered)\")\n", "print('\\ndistribution of divergences on the held-out fields:')\n", - "audyt.rozbieznosci['kategoria'].value_counts().to_frame('count')" + "display(audyt.rozbieznosci['kategoria'].value_counts().to_frame('count'))\n", + "\n", + "plots.plot_edition_comparison(delta, audyt, czulosc)" ] }, { @@ -292,9 +373,12 @@ " 'migawka_monotoniczna': False,\n", "}\n", "OPUBLIKOWANY_AUDYT = {'par': 804, 'potwierdzonych': 795, 'niepewnych': 6, 'falszywych': 3}\n", + "OPUBLIKOWANA_CZULOSC = 0.9652\n", "\n", "rozjazd = {k: (v, d[k]) for k, v in OPUBLIKOWANE.items() if d[k] != v}\n", "rozjazd |= {k: (v, a[k]) for k, v in OPUBLIKOWANY_AUDYT.items() if a[k] != v}\n", + "if round(c['czulosc_klucza'], 4) != OPUBLIKOWANA_CZULOSC:\n", + " rozjazd['czulosc_klucza'] = (OPUBLIKOWANA_CZULOSC, round(c['czulosc_klucza'], 4))\n", "\n", "if rozjazd:\n", " for k, (opub, otrzym) in rozjazd.items():\n", @@ -302,23 +386,27 @@ " raise AssertionError('the reproduced numbers do not match the published ones; see above')\n", "print('All numbers agree with the article.')\n", "print(f\"share of forward transitions: {d['udzial_przejsc_w_przod']*100:.2f} %\")\n", - "print(f\"linkage precision: from {a['precyzja_dolna']*100:.2f} to {a['precyzja_gorna']*100:.2f} %\")" + "print(f\"linkage precision: from {a['precyzja_dolna']*100:.2f} to {a['precyzja_gorna']*100:.2f} %\")\n", + "print(f\"key sensitivity: {c['czulosc_klucza']:.4f}\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "## 9. Cross-sectional analysis: why not on this publisher\n", + "## 9. Cross-sectional analysis: processing time with censoring\n", "\n", "The cross-sectional example in the article measures the time from lodging the application to the issue\n", "of conditions. The inclusion criterion was set **before** the result was computed: coverage of both\n", - "dates above 80 % and at least 30 observations in a group. This publisher does **not** meet the\n", - "criterion; the cell below shows why, and that is more honest than computing a median on a dozen or so\n", - "per cent of the records.\n", - "\n", - "To run the cross-sectional analysis, upload a document of a publisher that does meet the criterion\n", - "through the Colab file panel and give its path in the cell." + "dates above 80 % and at least 30 observations in a group. The transmission system operator does **not**\n", + "meet it; the first cell shows why, which is more honest than computing a median on a small share of\n", + "the records.\n", + "\n", + "A distribution operator that does meet it is ENERGA-OPERATOR, which splits one edition into three\n", + "documents: applications and refusals, and the available capacity of nodes in the demand and generation\n", + "directions. They are parsed **together**, so that application rows and node rows land in one panel.\n", + "Applications still open at the as-at date are **censored**, not dropped, and the curves are\n", + "Kaplan-Meier estimates with a Greenwood interval." ] }, { @@ -329,24 +417,143 @@ "source": [ "for etykieta, r in ramki.items():\n", " pokr = {p: round(float(r[p].notna().mean()) * 100, 2) for p in ('data_wniosku', 'data_warunkow')}\n", - " kwalifikuje = all(v > 80 for v in pokr.values())\n", - " stan = 'met' if kwalifikuje else 'NOT MET'\n", + " stan = 'met' if all(v > 80 for v in pokr.values()) else 'NOT MET'\n", " print(f\"{etykieta}: data_wniosku {pokr['data_wniosku']} %, \"\n", - " f\"data_warunkow {pokr['data_warunkow']} % -> 80 % criterion: {stan}\")\n", + " f\"data_warunkow {pokr['data_warunkow']} % -> 80 % criterion: {stan}\")" + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "RUN_ENERGA = True # set to False to skip sections 9 and 10 (several minutes of PDF parsing)\n", + "\n", + "ENERGA = {\n", + " 'energa_wnioski_odmowy_20260831.pdf':\n", + " 'https://cdn-netpr.pl/file/mediakit/3063617/fa/2026_08_31_pusop_wnioski_i_odmowy_eop.pdf',\n", + " 'energa_moc_dostepna_odbiorcza_20260831.pdf':\n", + " 'https://cdn-netpr.pl/file/mediakit/3063619/5c/informacja_o_wartosci_lacznej_dostepnej_odbiorczej_mocy_przylaczeniowej_31_08_2026.pdf',\n", + " 'energa_moc_dostepna_wytworcza_20260831.pdf':\n", + " 'https://cdn-netpr.pl/file/mediakit/3063621/4a/informacja_o_wartosci_lacznej_dostepnej_wytworczej_mocy_przylaczeniowej_31_08_2026.pdf',\n", + "}\n", + "en = None\n", + "if RUN_ENERGA:\n", + " sciezki = []\n", + " for nazwa, url in ENERGA.items():\n", + " try:\n", + " r = requests.get(url, headers=NAGL, timeout=300)\n", + " except requests.exceptions.RequestException as e:\n", + " print(f'{nazwa}: connection failed ({type(e).__name__}); upload the file and add it to `sciezki`.')\n", + " continue\n", + " if r.status_code != 200 or len(r.content) < 10_000:\n", + " print(f'{nazwa}: HTTP {r.status_code}; the publisher has replaced the file. '\n", + " 'Download the current edition from energa-operator.pl and upload it.')\n", + " continue\n", + " pathlib.Path(nazwa).write_bytes(r.content)\n", + " sciezki.append(nazwa)\n", + " print(f'{nazwa}: {len(r.content):,} B | sha256 {hashlib.sha256(r.content).hexdigest()[:16]}…')\n", + " if sciezki:\n", + " import time\n", + " t0 = time.time()\n", + " en, raport_en = parse_sources(sciezki)\n", + " print(f'\\n{len(en):,} rows in {time.time() - t0:.0f} s:',\n", + " en['_encja'].value_counts().to_dict())" + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "from gridqueue import kaplan_meier_by_group\n", + "\n", + "# Consumption strata of ENERGA-OPERATOR as published (Supplementary Material, Note S6):\n", + "# n, events, censored, KM median and its 95 % interval, in days.\n", + "OPUBLIKOWANE_KM = {'ODB / SN': (2073, 1982, 91, 57, 56, 58), 'ODB / 110 kV': (83, 43, 40, 240, 229, 265)}\n", + "\n", + "if en is not None:\n", + " km = kaplan_meier_by_group(en, by='klasa_zasobu', min_n=30)\n", + " display(km)\n", + " display(plots.plot_processing_time(en, by='klasa_zasobu', min_n=30))\n", + " # the same estimator split by resource class and voltage level, as in the article\n", + " km2 = kaplan_meier_by_group(en, by=['klasa_zasobu', 'poziom_napiecia'], min_n=30)\n", + " display(km2)\n", + " rozjazd_km = {}\n", + " for grupa, opub in OPUBLIKOWANE_KM.items():\n", + " r = km2.set_index('grupa').loc[grupa]\n", + " otrzym = (int(r.n), int(r.zdarzen), int(r.cenzurowanych), int(r.mediana),\n", + " int(r.mediana_dolna), int(r.mediana_gorna))\n", + " if otrzym != opub:\n", + " rozjazd_km[grupa] = (opub, otrzym)\n", + " if rozjazd_km:\n", + " raise AssertionError(f'processing times differ from the article (published, reproduced): {rozjazd_km}')\n", + " print('Processing times of the consumption strata agree with the article.')\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 10. Node loading\n", + "\n", + "Node loading λ(n) sets the requested capacity of the active queue at a node against the free capacity the\n", + "publisher declares there. Values above 1 mean the queue already exceeds what is declared available. A node\n", + "with zero declared free capacity has an undefined ratio and is reported separately, not as infinity.\n", "\n", - "# After uploading a qualifying document:\n", - "# df2 = get_adapter(detect_publisher('moj_plik.pdf')).parse('moj_plik.pdf').frame\n", - "# and then run examples/research_use_case.py on the exported panel." + "The article's **base variant** counts the 110 kV queue, because the free capacity a distribution operator\n", + "discloses for a node is that of its high-voltage busbars; the **upper variant** counts applications at\n", + "every voltage. Both are computed, and the base variant is checked against the published figures\n", + "(Supplementary Material, Note S7): the cell stops if they diverge.\n" + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "from gridqueue import assign_to_nodes, node_loading, station_node_map\n", + "\n", + "OPUBLIKOWANE_WEZLY = {'generation': (6.500, 29, 36), 'demand': (4.688, 33, 37)} # Note S7, base variant\n", + "\n", + "if en is not None:\n", + " przyp = assign_to_nodes(en, station_node_map(en))\n", + " rozjazd_w = {}\n", + " for pole, nazwa in (('moc_wprowadzana', 'generation'), ('moc_pobierana', 'demand')):\n", + " for wariant, napiecie in (('base, 110 kV queue', '110'), ('upper, all voltages', None)):\n", + " L = node_loading(przyp, pole_mocy=pole, napiecie=napiecie)\n", + " v = L['obciazenie'].dropna()\n", + " print(f'{nazwa}, {wariant}: {len(v)} of {len(L)} node-directions with a defined loading, '\n", + " f'median {v.median():.3f}, {(v > 1).sum()} above 1')\n", + " if napiecie == '110':\n", + " otrzym = (round(float(v.median()), 3), int((v > 1).sum()), int(len(v)))\n", + " if otrzym != OPUBLIKOWANE_WEZLY[nazwa]:\n", + " rozjazd_w[nazwa] = (OPUBLIKOWANE_WEZLY[nazwa], otrzym)\n", + " display(plots.plot_node_loading(L, title=(\n", + " f'Node loading, {nazwa} direction, 110 kV active queue: median {v.median():.3f}, '\n", + " f'{(v > 1).sum()} of {len(v)} above 1')))\n", + " if rozjazd_w:\n", + " raise AssertionError(f'node loading differs from the article (published, reproduced): {rozjazd_w}')\n", + " print('Node loading agrees with the article.')\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "## 10. Export\n", + "## 11. Coordinates from a gazetteer\n", + "\n", + "The resolver matches each place description against a gazetteer and returns a point **or the reason\n", + "why there is none**: no locality declared, a station code with no dictionary, a locality outside the\n", + "gazetteer, several candidates. Absence is reported, not guessed.\n", "\n", - "We save the panel in a columnar format and as CSV. In Colab both files can be downloaded from the\n", - "file panel." + "The national gazetteer used in the article is distributed under the ODbL and is not bundled. The cell\n", + "below runs the resolver on the **synthetic** panel and gazetteer of `gridqueue.examples`, which describe\n", + "no real grid. To use your own gazetteer, upload a JSON file in the layout documented in\n", + "`resolver_from_gazeter_json` and replace the path." ] }, { @@ -355,11 +562,81 @@ "execution_count": null, "outputs": [], "source": [ + "import json\n", + "from gridqueue import examples, geocode_frame, resolver_from_gazeter_json\n", + "\n", + "pathlib.Path('gazetteer_synthetic.json').write_text(json.dumps(examples.synthetic_gazetteer()))\n", + "resolver = resolver_from_gazeter_json('gazetteer_synthetic.json') # or your own gazetteer\n", + "syn = geocode_frame(examples.synthetic_panel(), resolver)\n", + "print(syn['_geo_pewnosc'].value_counts().to_dict())\n", + "print(syn.loc[syn['wspolrzedne'].isna(), '_geo_powod'].value_counts().to_dict())\n", + "plots.plot_location_resolution(syn)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 12. All charts at once\n", + "\n", + "`plots.save_all` draws every chart the data supports and saves it as PNG and SVG; a chart that needs data\n", + "the disclosure does not carry is skipped with the reason. The same function is behind\n", + "`gridqueue plot` on the command line and the charts of the browser page." + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "wynik = plots.save_all(ramki['2026-07-31'], 'charts/pse', edition_b=ramki['2026-08-31'],\n", + " labels=('2026-07-31', '2026-08-31'), formats=('png', 'svg'), dpi=300)\n", + "print('PSE skipped:', wynik.pop('_skipped'))\n", + "if en is not None:\n", + " wynik_en = plots.save_all(en, 'charts/energa', formats=('png', 'svg'), dpi=300)\n", + " print('ENERGA skipped:', wynik_en.pop('_skipped'))\n", + "plots.plot_overview(df if en is None else en)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 13. Export\n", + "\n", + "The panel in a columnar format, as CSV and as a workbook, together with the transition matrix, the audit\n", + "divergences and the charts, packed into one archive that Colab can download." + ] + }, + { + "cell_type": "code", + "metadata": {}, + "execution_count": null, + "outputs": [], + "source": [ + "import pandas as pd\n", + "import shutil\n", + "\n", "df.to_parquet('panel_pse_2026-08-31.parquet', index=False)\n", "df.to_csv('panel_pse_2026-08-31.csv', index=False)\n", + "with pd.ExcelWriter('panel_pse_2026-08-31.xlsx') as w:\n", + " df.to_excel(w, sheet_name='panel', index=False)\n", + " raport.as_frame().to_excel(w, sheet_name='quality', index=False)\n", + " delta.przejscia.to_excel(w, sheet_name='transitions')\n", "delta.przejscia.to_csv('przejscia_statusu.csv')\n", "audyt.rozbieznosci.to_csv('audyt_dopasowania.csv', index=False)\n", - "print('saved: panel (parquet, csv), transition matrix, audit divergences')" + "if en is not None:\n", + " en.to_parquet('panel_energa_2026-08-31.parquet', index=False)\n", + " km.to_csv('processing_time_energa.csv', index=False)\n", + "\n", + "archiwum = shutil.make_archive('gridqueue_results', 'zip', '.', 'charts')\n", + "print('saved: panels (parquet, csv, xlsx), transition matrix, audit divergences, charts ->', archiwum)\n", + "try:\n", + " from google.colab import files\n", + " files.download(archiwum)\n", + "except ImportError:\n", + " pass" ] }, { diff --git a/pyproject.toml b/pyproject.toml index 5377418..a8eac24 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,14 +4,15 @@ build-backend = "setuptools.build_meta" [project] name = "gridqueue" -version = "1.5.2" -description = "Harmonizator ustawowych ujawnien przylaczeniowych do sieci elektroenergetycznej" +version = "1.6.0" +description = "Harmonizer of statutory grid-connection disclosures into panel data for queue research" readme = "README.md" requires-python = ">=3.10" dependencies = ["pandas>=2.0", "pdfplumber>=0.11", "requests>=2.31", "pyarrow>=14", "openpyxl>=3.1"] [project.optional-dependencies] -test = ["pytest>=8.0"] +plot = ["matplotlib>=3.7"] +test = ["pytest>=8.0", "matplotlib>=3.7"] [project.scripts] gridqueue = "gridqueue.cli:main" diff --git a/src/gridqueue/__init__.py b/src/gridqueue/__init__.py index 7c34b36..10d03bf 100644 --- a/src/gridqueue/__init__.py +++ b/src/gridqueue/__init__.py @@ -19,9 +19,11 @@ extract_ruled_page, assign_words_to_columns, merge_continuation_rows, audit_column_shift, ShiftAudit, ) -from .geoloc import LocationResolver, Resolution, resolver_from_osm_json # noqa: F401 +from .geoloc import (LocationResolver, MultiLocalityResolver, Resolution, # noqa: F401 + geocode_frame, resolver_from_gazeter_json, resolver_from_osm_json) from .analysis import ( # noqa: F401 - PRZEDROSTKI_STACJI, KMResult, assign_to_nodes, kaplan_meier, node_loading, + PRZEDROSTKI_STACJI, KMResult, assign_to_nodes, kaplan_meier, kaplan_meier_by_group, + node_loading, normalizuj_nazwe, processing_time, station_node_map, ) from .quality import RULES, run_quality, QualityReport # noqa: F401 @@ -31,13 +33,27 @@ surrogate_key, EditionDelta, compare_editions, HELD_OUT_FIELDS, LinkageAudit, linkage_audit, ) -from .registry import REGISTRY, get_adapter, detect_publisher, declarations # noqa: F401 +from .registry import (REGISTRY, get_adapter, detect_publisher, declarations, # noqa: F401 + parse_sources, split_editions) -__version__ = "1.5.2" +# Charts live in `gridqueue.plots` and synthetic data in `gridqueue.examples`. Both are imported +# on first access, so that the core of the package does not require matplotlib: +# from gridqueue import plots +_LAZY_SUBMODULES = ("plots", "examples") + + +def __getattr__(name): + if name in _LAZY_SUBMODULES: + import importlib + + return importlib.import_module(f".{name}", __name__) + raise AttributeError(f"module 'gridqueue' has no attribute {name!r}") + +__version__ = "1.6.0" __all__ = [ "NODE_KEY_FIELDS", "RECALL_FIELDS", "LinkageRecall", "linkage_recall", - "PRZEDROSTKI_STACJI", "KMResult", "assign_to_nodes", "kaplan_meier", + "PRZEDROSTKI_STACJI", "KMResult", "assign_to_nodes", "kaplan_meier", "kaplan_meier_by_group", "node_loading", "normalizuj_nazwe", "processing_time", "station_node_map", "SCHEMA", "SCHEMA_VERSION", "FIELDS", "CORE_FIELDS", "OPTIONAL_FIELDS", "GROUPS", "CORE_ALTERNATIVES", "CORE_BY_ENTITY", "ENTITY_COLUMN", "DEFAULT_ENTITY", @@ -46,10 +62,11 @@ "empty_frame", "schema_table", "ColumnGeometry", "detect_ruled_columns", "detect_banded_columns", "extract_ruled_page", "assign_words_to_columns", "merge_continuation_rows", "audit_column_shift", "ShiftAudit", - "LocationResolver", "Resolution", "resolver_from_osm_json", + "LocationResolver", "Resolution", "resolver_from_osm_json", "resolver_from_gazeter_json", "geocode_frame", + "MultiLocalityResolver", "RULES", "run_quality", "QualityReport", "DEFAULT_KEY_FIELDS", "STATUS_ORDER", "TERMINAL_NEGATIVE", "surrogate_key", "EditionDelta", "compare_editions", "HELD_OUT_FIELDS", "LinkageAudit", "linkage_audit", - "REGISTRY", "get_adapter", "detect_publisher", "declarations", "__version__", + "REGISTRY", "get_adapter", "detect_publisher", "declarations", "parse_sources", "split_editions", "__version__", ] diff --git a/src/gridqueue/analysis.py b/src/gridqueue/analysis.py index 8b577d4..dd70636 100644 --- a/src/gridqueue/analysis.py +++ b/src/gridqueue/analysis.py @@ -35,6 +35,7 @@ "node_loading", "processing_time", "kaplan_meier", + "kaplan_meier_by_group", "KMResult", ] @@ -218,6 +219,7 @@ def node_loading( kolumna_grupy: str = "_nr_grupy", statusy_czynne: Iterable[str] | None = None, kolumna_encji: str = "_encja", + napiecie: str | None = None, ) -> pd.DataFrame: """Node loading: the capacity of the active queue against the disclosed available capacity. @@ -233,6 +235,12 @@ def node_loading( `moc_dostepna_zero` flag: the ratio there is UNDEFINED, not infinite, and averaging it would be an error. The row nonetheless retains the capacity applied for, because a queue at a node with no free capacity is information, not missing data. + + ``napiecie`` keeps only applications whose ``poziom_napiecia`` contains the given text. + The base variant of the article counts the 110 kV queue (``napiecie="110"``), because the + available capacity a distribution operator discloses for a node is the capacity of its + high-voltage busbars; the default (``None``) counts applications at every voltage level, + which is the article's upper variant. """ if statusy_czynne is None: statusy_czynne = ("WNIOSEK_ZLOZONY", "WNIOSEK_NIEKOMPLETNY", @@ -245,6 +253,9 @@ def node_loading( else df["moc_dostepna"].notna() wnioski = df[~jest_wezel] wnioski = wnioski[wnioski["status_procesu"].isin(set(statusy_czynne))] + if napiecie is not None and "poziom_napiecia" in wnioski.columns: + wnioski = wnioski[wnioski["poziom_napiecia"].astype("string") + .str.contains(napiecie, regex=False, na=False)] wnioski = wnioski[wnioski["_grupa"].notna()] suma = wnioski.groupby("_grupa")[pole_mocy].sum(min_count=1).rename("moc_wnioskowana") liczba = wnioski.groupby("_grupa").size().rename("wnioskow") @@ -279,24 +290,37 @@ def processing_time( both kinds of observations, as well as `zdarzenie` equal to 1 for resolved ones and 0 for censored ones, in the form expected by the survival estimator. - `na_dzien` by default takes the maximum of the publication-date field, and when that is - absent, the maximum of the resolution dates. + By default (``na_dzien=None``) every open application is censored at the publication + date of ITS OWN row (``data_publikacji``), so that a panel of several publishers, or a + publisher whose node and application documents carry different as-at dates, censors + each application at the date its document describes. Rows without a publication date + are censored at the latest publication date of the application rows, and failing that + at the latest resolution date. A date given explicitly applies to every row. + + Up to 1.5.2 the default was the single latest publication date of the whole frame, + node rows included; for ENERGA-OPERATOR (applications as at 30 June, nodes as at + 31 August 2026) that lengthened every censored time by two months. """ d = df.copy() for c in (od, do): d[c] = pd.to_datetime(d[c], errors="coerce") if na_dzien is None: - if "data_publikacji" in d: - na_dzien = pd.to_datetime(d["data_publikacji"], errors="coerce").max() - if na_dzien is None or pd.isna(na_dzien): - na_dzien = d[do].max() - na_dzien = pd.to_datetime(na_dzien) + wlasna = pd.to_datetime(d["data_publikacji"], errors="coerce") \ + if "data_publikacji" in d else pd.Series(pd.NaT, index=d.index) + wnioski = d["_encja"].fillna("WNIOSEK").astype(str).str.upper() != "WEZEL" \ + if "_encja" in d else pd.Series(True, index=d.index) + zapas = wlasna[wnioski].max() + if pd.isna(zapas): + zapas = d[do].max() + na_dzien = wlasna.fillna(zapas) + else: + na_dzien = pd.Series(pd.to_datetime(na_dzien), index=d.index) ma_start = d[od].notna() zdarzenie = ma_start & d[do].notna() czas = pd.Series(pd.NA, index=d.index, dtype="Float64") czas[zdarzenie] = (d.loc[zdarzenie, do] - d.loc[zdarzenie, od]).dt.days uciete = ma_start & ~zdarzenie - czas[uciete] = (na_dzien - d.loc[uciete, od]).dt.days + czas[uciete] = (na_dzien[uciete] - d.loc[uciete, od]).dt.days d["czas_dni"] = czas d["zdarzenie"] = zdarzenie.astype(int).where(ma_start) d["na_dzien"] = na_dzien @@ -357,18 +381,60 @@ def kaplan_meier(czas, zdarzenie, alpha: float = 0.05) -> KMResult: se = S * math.sqrt(kum_war) if S > 0 else 0.0 wiersze.append({"t": float(t), "n_ryzyka": n_ryz, "zdarzen": zd, "S": S, "S_dolne": max(0.0, S - z * se), "S_gorne": min(1.0, S + z * se)}) - tab = pd.DataFrame(wiersze) + # Explicit columns: a group in which every observation is censored has no event time, + # and a frame built from an empty list would have no columns at all (KeyError: 'S'). + tab = pd.DataFrame(wiersze, columns=["t", "n_ryzyka", "zdarzen", "S", "S_dolne", "S_gorne"]) def pierwszy_ponizej(kol): pod = tab[tab[kol] <= 0.5] return float(pod["t"].iloc[0]) if len(pod) else float("nan") + # The lower band reaches 0.5 FIRST, so it gives the LOWER bound of the median; the upper + # band reaches it last and gives the upper bound. Versions up to 1.5.2 had the two + # swapped, which returned an interval with mediana_dolna > mediana > mediana_gorna. return KMResult( tabela=tab, mediana=pierwszy_ponizej("S"), - mediana_dolna=pierwszy_ponizej("S_gorne"), - mediana_gorna=pierwszy_ponizej("S_dolne"), + mediana_dolna=pierwszy_ponizej("S_dolne"), + mediana_gorna=pierwszy_ponizej("S_gorne"), n=n0, zdarzen=int((d["e"] == 1).sum()), cenzurowanych=int((d["e"] == 0).sum()), ) + + +def kaplan_meier_by_group( + df: pd.DataFrame, + by: str | Sequence[str] | None = "klasa_zasobu", + od: str = "data_wniosku", + do: str = "data_warunkow", + min_n: int = 30, + na_dzien=None, +) -> pd.DataFrame: + """Kaplan-Meier summary per group: size, events, censoring, median and its interval. + + Combines :func:`processing_time` and :func:`kaplan_meier`. A group enters the table + when it has at least ``min_n`` measurable applications (start date present, time not + negative); this is the inclusion criterion of the article, fixed before the result is + computed. ``by`` may be a column, a list of columns (joined with ``" / "``) or ``None`` + for the whole frame. Sorted by group size, largest first. + """ + cols = ["grupa", "n", "zdarzen", "cenzurowanych", "udzial_cenzurowanych", + "mediana", "mediana_dolna", "mediana_gorna"] + if od not in df.columns or do not in df.columns: + return pd.DataFrame(columns=cols) + pt = processing_time(df, od=od, do=do, na_dzien=na_dzien) + if by is None: + klucz = pd.Series("all", index=pt.index) + else: + kol = [by] if isinstance(by, str) else list(by) + if any(k not in pt.columns for k in kol): + return pd.DataFrame(columns=cols) + klucz = pt[kol].astype("string").fillna("(empty)").agg(" / ".join, axis=1) + wiersze = [] + for g, sub in pt.groupby(klucz, sort=False): + km = kaplan_meier(sub["czas_dni"].astype("float64"), sub["zdarzenie"].astype("float64")) + if km.n >= min_n: + wiersze.append({"grupa": str(g), **km.as_dict()}) + out = pd.DataFrame(wiersze, columns=cols) + return out.sort_values("n", ascending=False, kind="stable").reset_index(drop=True) diff --git a/src/gridqueue/cli.py b/src/gridqueue/cli.py index 6c64af0..cf36c9b 100644 --- a/src/gridqueue/cli.py +++ b/src/gridqueue/cli.py @@ -1,4 +1,4 @@ -"""Command-line interface: ``gridqueue parse | validate | export``.""" +"""Command-line interface: ``gridqueue parse | validate | export | compare | plot``.""" from __future__ import annotations @@ -91,6 +91,42 @@ def cmd_export(args) -> int: return 0 +def cmd_compare(args) -> int: + from .longitudinal import (NODE_KEY_FIELDS, DEFAULT_KEY_FIELDS, compare_editions, + linkage_audit, linkage_recall) + + a, b = _read_table(args.edition_a), _read_table(args.edition_b) + fields = NODE_KEY_FIELDS if args.node_key else DEFAULT_KEY_FIELDS + delta = compare_editions(a, b, args.label_a, args.label_b, fields=fields) + out = {"klucz": list(fields), "porownanie": delta.as_dict(), + "audyt_dopasowania": linkage_audit(a, b, fields=fields).as_dict(), + "czulosc_dopasowania": linkage_recall(a, b, fields=fields).as_dict()} + text = json.dumps(out, ensure_ascii=False, indent=2, default=str) + if args.out: + Path(args.out).write_text(text, encoding="utf-8") + if args.transitions: + delta.przejscia.to_csv(args.transitions) + print(text) + return 0 + + +def cmd_plot(args) -> int: + try: + from .plots import save_all + except ImportError as e: # pragma: no cover + print(str(e), file=sys.stderr) + return 2 + df = _read_table(args.input) + b = _read_table(args.edition_b) if args.edition_b else None + saved = save_all(df, args.out, edition_b=b, labels=(args.label_a, args.label_b), + formats=[f.strip() for f in args.format.split(",") if f.strip()], + dpi=args.dpi, min_n=args.min_n, min_coverage=args.min_coverage) + skipped = saved.pop("_skipped", []) + print(json.dumps({"zapisane": {k: [str(p) for p in v] for k, v in saved.items()}, + "pominiete": skipped}, ensure_ascii=False, indent=2)) + return 0 + + def cmd_schema(args) -> int: t = schema_table() if args.out: @@ -130,6 +166,32 @@ def build_parser() -> argparse.ArgumentParser: help="omit extensions (columns with the _ prefix)") p.set_defaults(func=cmd_export) + p = sub.add_parser("compare", help="compare two editions of one register (flows, transitions, " + "linkage precision and sensitivity)") + p.add_argument("edition_a", help="earlier edition (.parquet/.csv in the schema)") + p.add_argument("edition_b", help="later edition") + p.add_argument("--label-a", default="A") + p.add_argument("--label-b", default="B") + p.add_argument("--node-key", action="store_true", + help="use the node key (publikujacy, id_wezla) for NODE-entity registers") + p.add_argument("--out", help="JSON report file") + p.add_argument("--transitions", help="CSV file for the status transition matrix") + p.set_defaults(func=cmd_compare) + + p = sub.add_parser("plot", help="draw every chart the dataset supports (needs matplotlib)") + p.add_argument("input", help="dataset in the schema (.parquet/.csv)") + p.add_argument("--edition-b", help="a later edition: adds the edition-comparison chart") + p.add_argument("--label-a", default="A") + p.add_argument("--label-b", default="B") + p.add_argument("--out", required=True, help="output directory") + p.add_argument("--format", default="png", help="comma-separated: png,svg,pdf") + p.add_argument("--dpi", type=int, default=200) + p.add_argument("--min-n", type=int, default=30, + help="minimum group size for the processing-time curves") + p.add_argument("--min-coverage", type=float, default=0.8, + help="minimum share of applications carrying both dates (default 0.8)") + p.set_defaults(func=cmd_plot) + p = sub.add_parser("schema", help="print the schema specification") p.add_argument("--out") p.set_defaults(func=cmd_schema) diff --git a/src/gridqueue/examples.py b/src/gridqueue/examples.py new file mode 100644 index 0000000..ad011a0 --- /dev/null +++ b/src/gridqueue/examples.py @@ -0,0 +1,166 @@ +"""Synthetic data in the schema, for trying the package without a real disclosure. + +Nothing here comes from a publisher. The frames are generated from a seed, they carry the +publisher names ``"Synthetic operator A"`` and ``"Synthetic operator B"`` so that they +cannot be mistaken for a register, and they are built to exercise every function of the +package: application and node rows (for node loading), process dates with censoring (for +the processing-time curves), two editions with linked, new, absent and status-changed rows +(for the longitudinal module), and a small gazetteer with coordinates (for the resolver). + +The browser page and the Colab notebook use these frames for their demonstration mode. +The figures they produce describe the generator, not any grid. +""" + +from __future__ import annotations + +import random +from datetime import date, timedelta + +import pandas as pd + +from .schema import empty_frame + +__all__ = ["SYNTHETIC_PUBLISHERS", "synthetic_panel", "synthetic_editions", + "synthetic_gazetteer"] + +SYNTHETIC_PUBLISHERS = ("Synthetic operator A", "Synthetic operator B") + +_STATIONS = { + 1: ("Alder", "Birch"), 2: ("Cedar",), 3: ("Elm", "Fir"), 4: ("Hazel",), + 5: ("Larch", "Maple"), 6: ("Oak",), 7: ("Pine", "Rowan"), 8: ("Spruce",), +} +_CLASSES = (("PV", 0.42), ("ODB", 0.28), ("BESS", 0.12), ("FW", 0.08), ("MIX", 0.06), + ("BIOGAZ", 0.04)) +_MEDIAN_DAYS = {"PV": 130, "ODB": 60, "BESS": 200, "FW": 210, "MIX": 125, "BIOGAZ": 150} +_TOWNS = {"RIVERTON": (53.43, 14.55), "HILLSIDE": (53.56, 14.20), "LAKEVIEW": (53.30, 14.90)} +_STREETS = ("Station Road", "Mill Lane", "Harbour Street", "Orchard Way", "Quarry Road") + + +def _iso(d: date) -> str: + return d.isoformat() + + +def _pick(rng: random.Random, weighted): + x, acc = rng.random(), 0.0 + for v, w in weighted: + acc += w + if x <= acc: + return v + return weighted[-1][0] + + +def synthetic_panel(n: int = 600, *, seed: int = 7, as_at: str = "2026-06-30", + with_nodes: bool = True) -> pd.DataFrame: + """A synthetic panel of ``n`` applications (plus node rows) in the 21-field schema.""" + rng = random.Random(seed) + asat = date.fromisoformat(as_at) + rows = [] + for i in range(n): + pub = SYNTHETIC_PUBLISHERS[0] if rng.random() < 0.6 else SYNTHETIC_PUBLISHERS[1] + klasa = _pick(rng, _CLASSES) + filed = asat - timedelta(days=rng.randint(20, 900)) + wait = int(rng.expovariate(1 / _MEDIAN_DAYS[klasa]) * 1.1) + 14 + cond = filed + timedelta(days=wait) + r = {"id_wniosku": f"SYN-{i:05d}", "publikujacy": pub, "klasa_zasobu": klasa, + "data_wniosku": _iso(filed), "data_publikacji": as_at, "_encja": "WNIOSEK"} + grp = rng.randint(1, len(_STATIONS)) + stn = rng.choice(_STATIONS[grp]) + town = rng.choice(list(_TOWNS)) + if rng.random() < 0.55: + r["lokalizacja_tekst"] = stn + else: + r["lokalizacja_tekst"] = f"{town.title()}, {rng.choice(_STREETS)}" + r["poziom_napiecia"] = "SN" if rng.random() < 0.7 else "110 kV" + mw = round(rng.lognormvariate(0.4 if klasa != "ODB" else -0.3, 1.0), 3) + r["moc_pobierana" if klasa == "ODB" else "moc_wprowadzana"] = round(mw * 1000, 1) + if cond <= asat: + r["data_warunkow"] = _iso(cond) + u = rng.random() + if u < 0.35: + r["data_umowy"] = _iso(min(asat, cond + timedelta(days=rng.randint(20, 200)))) + r["status_procesu"] = "UMOWA_OBOWIAZUJACA" + elif u < 0.42: + r["status_procesu"] = "WARUNKI_WYGASLE" + else: + r["status_procesu"] = "WARUNKI_WYDANE" + else: + u = rng.random() + if u < 0.08: + r["status_procesu"] = "ODMOWA" + r["data_odmowy"] = _iso(filed + timedelta(days=rng.randint(20, 120))) + r["powod_odmowy"] = "brak warunkow technicznych" + elif u < 0.14: + r["status_procesu"] = "WNIOSEK_NIEKOMPLETNY" + else: + r["status_procesu"] = "W_TRAKCIE_ANALIZY" + rows.append(r) + if with_nodes: + for grp, stations in _STATIONS.items(): + for kier in ("wytworcza", "odbiorcza"): + free = 0.0 if grp == 8 else round(rng.uniform(2, 60) * 1000, 1) + rows.append({"_encja": "WEZEL", "id_wezla": f"N{grp}-{kier[0].upper()}", + "nazwa_wezla": stations[0], "_nr_grupy": grp, "_kierunek": kier, + "lokalizacja_tekst": ", ".join(stations), "moc_dostepna": free, + "publikujacy": SYNTHETIC_PUBLISHERS[0], + "data_publikacji": as_at}) + df = pd.DataFrame(rows) + cols = list(empty_frame().columns) + [c for c in df.columns + if c not in empty_frame().columns] + return df.reindex(columns=cols) + + +_FORWARD = {"W_TRAKCIE_ANALIZY": "WARUNKI_WYDANE", "WNIOSEK_NIEKOMPLETNY": "W_TRAKCIE_ANALIZY", + "WARUNKI_WYDANE": "UMOWA_OBOWIAZUJACA", "UMOWA_OBOWIAZUJACA": "PRZYLACZONY"} + + +def synthetic_editions(n: int = 400, *, seed: int = 11) -> tuple[pd.DataFrame, pd.DataFrame]: + """Two consecutive synthetic editions of one register (applications only). + + Between them about 6 % of rows disappear, 5 % are added, 8 % advance one stage, and a + handful move backwards, so the flows, the transition matrix and the linkage audit all + have something to show. + """ + rng = random.Random(seed) + a = synthetic_panel(n, seed=seed, as_at="2026-05-31", with_nodes=False) + a["publikujacy"] = SYNTHETIC_PUBLISHERS[0] + b = a.copy() + b["data_publikacji"] = "2026-06-30" + keep = [rng.random() > 0.06 for _ in range(len(b))] + b = b[keep].copy() + back = 0 + for idx in b.index: + s = b.at[idx, "status_procesu"] + u = rng.random() + if u < 0.08 and s in _FORWARD: + b.at[idx, "status_procesu"] = _FORWARD[s] + if s == "W_TRAKCIE_ANALIZY": + b.at[idx, "data_warunkow"] = "2026-06-15" + elif back < 2 and u > 0.97 and s == "WARUNKI_WYDANE": + # two deliberate backward moves: the transition matrix should show what a + # register that rewrites its own history looks like + b.at[idx, "status_procesu"] = "W_TRAKCIE_ANALIZY" + back += 1 + new = synthetic_panel(int(n * 0.05) + 1, seed=seed + 1, as_at="2026-06-30", + with_nodes=False) + new["publikujacy"] = SYNTHETIC_PUBLISHERS[0] + new["id_wniosku"] = [f"SYN-NEW-{i:04d}" for i in range(len(new))] + new["data_wniosku"] = "2026-06-10" + new["data_warunkow"] = None + new["data_umowy"] = None + new["status_procesu"] = "WNIOSEK_ZLOZONY" + b = pd.concat([b, new], ignore_index=True) + return a.reset_index(drop=True), b + + +def synthetic_gazetteer() -> dict: + """A small gazetteer in the layout read by :func:`~gridqueue.geoloc.resolver_from_gazeter_json`.""" + out = {} + for k, (lat, lon) in _TOWNS.items(): + ulice = {} + for j, st in enumerate(_STREETS): + if k == "LAKEVIEW" and j > 2: + continue # streets missing from the gazetteer, to show an honest "no candidate" + ulice[st] = {"lat": round(lat + 0.004 * (j - 2), 6), + "lon": round(lon + 0.006 * (j - 2), 6), "dlugosc_m": 400 + 150 * j} + out[k] = {"nazwa": k.title(), "lat": lat, "lon": lon, "ulice": ulice} + return {"miejscowosci": out} diff --git a/src/gridqueue/geoloc.py b/src/gridqueue/geoloc.py index 102e4e7..b122f24 100644 --- a/src/gridqueue/geoloc.py +++ b/src/gridqueue/geoloc.py @@ -56,7 +56,7 @@ __all__ = [ "Resolution", "LocationResolver", "MultiLocalityResolver", "PEWNOSC", "DOKLADNOSC", "normalize", "tokens", - "resolver_from_osm_json", "resolver_from_gazeter_json", + "resolver_from_osm_json", "resolver_from_gazeter_json", "geocode_frame", ] PEWNOSC = ("EXACT", "UNIQUE_TOKEN", "TOKEN_SUBSET", "REVERSED", "SKRZYZOWANIE", "NONE") @@ -677,3 +677,46 @@ def resolver_from_osm_json(path) -> LocationResolver: lat, lon = item.get("lat"), item.get("lon") gaz[nm] = (float(lat), float(lon)) if lat is not None and lon is not None else None return LocationResolver(gaz) + + +def geocode_frame(df, resolver, *, column: str = "lokalizacja_tekst", + overwrite: bool = False, station_code_column: Optional[str] = None): + """Resolve the place descriptions of a frame and write the result back to it. + + Returns a copy of ``df`` with ``wspolrzedne`` filled as ``"lat,lon"`` (WGS84, the + format the schema validates) and three diagnostic columns that keep what the resolver + knows about each row: ``_geo_pewnosc`` (certainty of the name identification), + ``_geo_dokladnosc`` (precision of the returned point) and ``_geo_powod`` (reason, when + no point is returned). Coordinates disclosed by the publisher are kept unless + ``overwrite=True``; such rows get ``_geo_pewnosc = "ZRODLO"``. + + ``resolver`` is a :class:`LocationResolver` or :class:`MultiLocalityResolver`, for + example from :func:`resolver_from_gazeter_json`. ``station_code_column`` names a boolean + column marking descriptions that are station codes rather than place names. + """ + import pandas as pd + + out = df.copy() + if "wspolrzedne" not in out.columns: + out["wspolrzedne"] = None + src = out["wspolrzedne"] + have = src.notna() & src.astype(str).str.strip().ne("") & ~overwrite + pew, dok, pow_, wsp = [], [], [], [] + codes = out[station_code_column].fillna(False).astype(bool) \ + if station_code_column and station_code_column in out.columns else None + for i, (idx, q) in enumerate(out[column].items()): + if bool(have.loc[idx]): + pew.append("ZRODLO"); dok.append("ZRODLO"); pow_.append(""); wsp.append(src.loc[idx]) + continue + kw = {"is_station_code": bool(codes.loc[idx])} if codes is not None else {} + r = resolver.resolve(None if pd.isna(q) else str(q), **kw) + pew.append(r.pewnosc) + dok.append(getattr(r, "dokladnosc", "BRAK")) + has_pt = r.lat is not None and r.lon is not None + pow_.append(r.powod or ("" if has_pt else "brak_punktu")) + wsp.append(f"{r.lat:.6f},{r.lon:.6f}" if has_pt else None) + out["wspolrzedne"] = pd.Series(wsp, index=out.index, dtype=object) + out["_geo_pewnosc"] = pew + out["_geo_dokladnosc"] = dok + out["_geo_powod"] = pow_ + return out diff --git a/src/gridqueue/plots.py b/src/gridqueue/plots.py new file mode 100644 index 0000000..b549401 --- /dev/null +++ b/src/gridqueue/plots.py @@ -0,0 +1,948 @@ +"""Charts drawn from the harmonised panel and from the results of the analyses. + +Every function takes the same objects the rest of the package returns (a frame in the +21-field schema, an :class:`~gridqueue.longitudinal.EditionDelta`, a +:class:`~gridqueue.longitudinal.LinkageAudit`, the frame returned by +:func:`~gridqueue.analysis.node_loading`) and returns a :class:`matplotlib.figure.Figure`. +Nothing is computed here that the analysis functions do not already compute: a chart is a +view of a result, never a second implementation of it, so the numbers on a chart are the +numbers in the report by construction. + +The same module draws the charts in the command line (``gridqueue plot``), in the Colab +notebook and in the browser page, which loads this package into a WebAssembly interpreter. + +Design rules +------------ +* **Figures are created without** ``pyplot``. A figure does not enter the global state of + the interpreter, so a loop over many publishers does not accumulate open windows, and the + module works unchanged on a server, in a notebook and in the browser. In Jupyter and + Colab a returned figure is displayed automatically; in a script call + ``fig.savefig(path)`` or :func:`save_figure`. +* **What the register does not disclose is drawn as absence**, not as zero: a field a + publisher does not publish is a grey cell marked ``-``, a node with no declared free + capacity has an undefined loading and is drawn apart from the others. +* ``matplotlib`` is an optional dependency (``pip install "gridqueue[plot]"``); the core of + the package does not need it. +""" + +from __future__ import annotations + +from pathlib import Path +from typing import Iterable, Optional, Sequence + +import pandas as pd + +from .analysis import kaplan_meier, kaplan_meier_by_group, processing_time +from .layout import audit_column_shift +from .longitudinal import STATUS_ORDER, TERMINAL_NEGATIVE +from .quality import run_quality +from .schema import STATUSY, schema_table + +__all__ = [ + "PUBLISHER_SHORT", "PUBLISHER_COLORS", "STATUS_LABELS", "CLASS_LABELS", + "ACTIVE_STATUSES", "EVENT_LABELS", "publisher_label", + "plot_field_coverage", "plot_quality", "plot_column_shift", + "plot_status_distribution", "plot_capacity_by_class", "plot_processing_time", + "plot_node_loading", "plot_edition_flows", "plot_transitions", "plot_linkage_audit", + "plot_edition_comparison", "plot_location_resolution", "plot_overview", + "save_figure", "save_all", +] + +#: Short publisher names used on axes. Unknown publishers are shown under their own name. +PUBLISHER_SHORT: dict[str, str] = { + "TAURON Dystrybucja S.A.": "TAURON", + "ENERGA-OPERATOR S.A.": "ENERGA", + "Stoen Operator Sp. z o.o.": "Stoen", + "PSE S.A.": "PSE", + "National Grid Electricity Distribution": "National Grid", + "Boryszew Green Energy&Gas Sp. z o.o.": "Boryszew", + "e-Distribución Redes Digitales S.L.U.": "e-Distribución", + "ESB Networks DAC": "ESB Networks", + "E-REDES S.A.": "E-REDES", +} + +#: Colours of the publishers. The first six are those of the article figures. +PUBLISHER_COLORS: dict[str, str] = { + "TAURON": "#1b5e8c", "ENERGA": "#2e8b78", "Stoen": "#c77a1e", "PSE": "#7a4b9c", + "National Grid": "#6b7280", "Boryszew": "#a33b4e", "e-Distribución": "#d1495b", + "ESB Networks": "#e9b44c", "E-REDES": "#7fb7be", +} +_FALLBACK = ["#4e79a7", "#f28e2b", "#59a14f", "#b07aa1", "#9c755f", "#edc948", "#76b7b2"] + +#: English labels of the controlled status vocabulary. +STATUS_LABELS: dict[str, str] = { + "WNIOSEK_ZLOZONY": "filed", "WNIOSEK_NIEKOMPLETNY": "incomplete", + "W_TRAKCIE_ANALIZY": "under review", "WARUNKI_WYDANE": "conditions issued", + "UMOWA_OBOWIAZUJACA": "agreement in force", "PRZYLACZONY": "connected", + "WARUNKI_WYGASLE": "conditions expired", "ODMOWA": "refused", + "UMOWA_ROZWIAZANA": "agreement terminated", "WNIOSEK_WYCOFANY": "withdrawn", + "NIEOKRESLONY": "unspecified", +} + +#: English labels of the controlled resource-class vocabulary. +CLASS_LABELS: dict[str, str] = { + "PV": "photovoltaics", "FW": "wind", "EW": "hydro", "BIOGAZ": "biogas", "GAZ": "gas", + "WEGIEL": "coal", "BESS": "energy storage", "ODB": "consumption", "MIX": "mixed", + "SIEC": "network", "INNE": "other", "NIEOKRESLONA": "unspecified", +} + +#: Statuses of an application still in the queue (the default of ``node_loading``). +ACTIVE_STATUSES: tuple[str, ...] = ( + "WNIOSEK_ZLOZONY", "WNIOSEK_NIEKOMPLETNY", "W_TRAKCIE_ANALIZY", "WARUNKI_WYDANE", + "UMOWA_OBOWIAZUJACA") + +#: Readable names of the closing events of a proceeding, for chart titles. +EVENT_LABELS: dict[str, str] = { + "data_warunkow": "issue of connection conditions", "data_umowy": "connection agreement", + "data_odmowy": "refusal", "data_energizacji": "energisation", + "data_wniosku": "application", +} +_KIERUNEK = {"wytworcza": "generation direction", "odbiorcza": "demand direction"} + +_GREY = "#6b7280" +_INK = "#222222" +_STATUS_COLORS = { + "WNIOSEK_ZLOZONY": "#c9dcea", "WNIOSEK_NIEKOMPLETNY": "#a3c4dc", + "W_TRAKCIE_ANALIZY": "#5b93b8", "WARUNKI_WYDANE": "#1b5e8c", + "UMOWA_OBOWIAZUJACA": "#2e8b78", "PRZYLACZONY": "#14532d", + "WARUNKI_WYGASLE": "#e0a96d", "ODMOWA": "#a33b4e", "UMOWA_ROZWIAZANA": "#c77a1e", + "WNIOSEK_WYCOFANY": "#d4b8a0", "NIEOKRESLONY": "#d1d5db", +} + + +# --------------------------------------------------------------------------- +# helpers +# --------------------------------------------------------------------------- + +def _mpl(): + try: + import matplotlib # noqa: F401 + from matplotlib.figure import Figure + except ImportError as e: # pragma: no cover - exercised only without matplotlib + raise ImportError( + "charts need matplotlib: pip install \"gridqueue[plot]\"") from e + return Figure + + +def _figure(w: float, h: float, ax=None): + """Return (fig, ax): a new figure, or the figure of the axis supplied.""" + if ax is not None: + return ax.figure, ax + Figure = _mpl() + fig = Figure(figsize=(w, h), dpi=110, layout="constrained") + return fig, fig.add_subplot(1, 1, 1) + + +def _style(ax, grid_axis: str | None = "x") -> None: + for s in ("top", "right"): + ax.spines[s].set_visible(False) + for s in ("left", "bottom"): + ax.spines[s].set_color("#9ca3af") + ax.tick_params(colors="#374151", labelsize=7.5) + if grid_axis: + ax.grid(axis=grid_axis, color="#e5e7eb", lw=0.7, zorder=0) + ax.set_axisbelow(True) + + +def _th(n) -> str: + return f"{int(round(float(n))):,}" + + +def publisher_label(p) -> str: + """Short name of a publisher for an axis label.""" + if p is None or (isinstance(p, float) and p != p) or str(p).strip() == "": + return "(publisher not set)" + return PUBLISHER_SHORT.get(str(p), str(p)) + + +def _color(short: str, i: int) -> str: + return PUBLISHER_COLORS.get(short, _FALLBACK[i % len(_FALLBACK)]) + + +def _groups(df: pd.DataFrame, by: Optional[str]) -> list[tuple[str, pd.DataFrame]]: + """Split by publisher (or another column), largest group first.""" + if by is None or by not in df.columns or df[by].isna().all(): + return [("panel", df)] + keys = df[by].fillna("").astype(str) + order = keys.value_counts().index.tolist() + return [(publisher_label(k) if by == "publikujacy" else (k or "(empty)"), + df[keys == k]) for k in order] + + +def _filled(s: pd.Series) -> pd.Series: + txt = s.astype(str).str.strip() + return s.notna() & txt.ne("") & txt.str.lower().ne("nan") & txt.ne("") + + +def _empty_note(ax, text: str) -> None: + ax.text(0.5, 0.5, text, ha="center", va="center", fontsize=8, color=_GREY, + transform=ax.transAxes, wrap=True) + ax.set_xticks([]); ax.set_yticks([]) + for s in ax.spines.values(): + s.set_visible(False) + + +def _group_key(df: pd.DataFrame, by) -> pd.Series: + """The same group key as :func:`~gridqueue.analysis.kaplan_meier_by_group`.""" + kol = [by] if isinstance(by, str) else list(by) + return df[kol].astype("string").fillna("(empty)").agg(" / ".join, axis=1) + + +def _applications(df: pd.DataFrame) -> pd.DataFrame: + if "_encja" in df.columns: + return df[df["_encja"].fillna("WNIOSEK").astype(str).str.upper() != "WEZEL"] + return df + + +# --------------------------------------------------------------------------- +# what a disclosure contains +# --------------------------------------------------------------------------- + +def plot_field_coverage(df: pd.DataFrame, by: str = "publikujacy", ax=None, + annotate: bool = True): + """Heat map: share of rows in which each of the 21 schema fields is populated. + + One column per publisher (or per value of ``by``), with the row count under its name. + A field the publisher does not disclose at all is a grey ``-`` cell, distinct from a + sparsely populated one. Core fields are marked with a bullet. + """ + import numpy as np + from matplotlib.colors import LinearSegmentedColormap + + st = schema_table() + pola = st["pole"].tolist() + rdzen = dict(zip(st["pole"], st["rdzen"].astype(bool))) + grupy = _groups(df, by) + Z = np.zeros((len(pola), len(grupy))) + for j, (_, sub) in enumerate(grupy): + for i, f in enumerate(pola): + Z[i, j] = float(_filled(sub[f]).mean()) if f in sub.columns and len(sub) else 0.0 + + fig, ax = _figure(max(3.2, 1.6 + 0.62 * len(grupy)), 5.6, ax) + cmap = LinearSegmentedColormap.from_list("cov", ["#f7f7f7", "#c9dcea", "#5b93b8", "#1b5e8c"]) + im = ax.imshow(Z, cmap=cmap, vmin=0, vmax=1, aspect="auto") + ax.set_xticks(range(len(grupy))) + ax.set_xticklabels([f"{k}\n{_th(len(s))}" for k, s in grupy], fontsize=6.5) + ax.set_yticks(range(len(pola))) + ax.set_yticklabels([("\u2022 " if rdzen[f] else "") + f for f in pola], fontsize=6.5) + for i, f in enumerate(pola): + if rdzen[f]: + ax.get_yticklabels()[i].set_fontweight("bold") + if annotate: + for i in range(len(pola)): + for j in range(len(grupy)): + v = Z[i, j] + txt = "-" if v == 0 else ("<1" if v < 0.005 else + ("100" if v >= 0.995 else f"{v * 100:.0f}")) + ax.text(j, i, txt, ha="center", va="center", fontsize=5.6, + color="#ffffff" if v > 0.62 else ("#9ca3af" if v == 0 else _INK)) + ax.set_xticks(np.arange(-.5, len(grupy), 1), minor=True) + ax.set_yticks(np.arange(-.5, len(pola), 1), minor=True) + ax.grid(which="minor", color="#ffffff", lw=0.8) + ax.tick_params(which="both", length=0) + for s in ax.spines.values(): + s.set_visible(False) + ax.xaxis.tick_top() + n_pokr = int((Z.max(axis=1) > 0).sum()) + ax.set_title(f"Schema field coverage, % of rows: {n_pokr} of {len(pola)} fields populated" + "\n\u2022 core field - not disclosed", fontsize=8, loc="left", pad=6) + cb = fig.colorbar(im, ax=ax, shrink=0.35, pad=0.02, aspect=14) + cb.ax.tick_params(labelsize=6) + cb.set_ticks([0, 0.5, 1]); cb.set_ticklabels(["0", "50", "100 %"]) + cb.outline.set_visible(False) + return fig + + +def plot_quality(df: pd.DataFrame, by: str = "publikujacy", ax=None): + """Violations of the eight quality rules, stacked by publisher. + + The rules are evaluated per publisher with :func:`~gridqueue.quality.run_quality`, as + in the article, so a rule that depends on the set of fields a publisher discloses is + judged against that publisher only. A rule with no violation is drawn as a dot. + """ + import numpy as np + + rows = [] + for k, sub in _groups(df, by): + for x in run_quality(sub.reset_index(drop=True)).as_dict()["reguly"]: + rows.append({"kod": x["kod"], "nazwa": x["nazwa"], "pub": k, + "naruszenia": max(int(x["naruszenia"]), 0)}) + jak = pd.DataFrame(rows) + piv = (jak.pivot_table(index=["kod", "nazwa"], columns="pub", values="naruszenia", + aggfunc="sum", sort=False).fillna(0).astype(int)) + kol = [k for k, _ in _groups(df, by)] + piv = piv[[k for k in kol if k in piv.columns]] + tot = piv.sum(axis=1) + piv = piv.loc[tot.sort_values(kind="stable").index] + tot = tot.loc[piv.index] + n = len(df) + + fig, ax = _figure(6.8, 3.0, ax) + y = np.arange(len(piv)) + left = np.zeros(len(piv)) + for i, k in enumerate(piv.columns): + v = piv[k].values.astype(float) + if v.sum() == 0: + continue + ax.barh(y, v, left=left, height=0.62, color=_color(k, i), label=k, zorder=2) + left += v + szer = max(int(tot.max()) if len(tot) else 0, 1) + for yy, t in zip(y, tot.values): + if t == 0: + ax.plot([0], [yy], "o", ms=3.2, color="#444444", zorder=3, clip_on=False) + ax.text(szer * 0.015, yy, "0 violations", va="center", fontsize=6.5, color=_GREY) + else: + ax.text(t + szer * 0.012, yy, f"{_th(t)} ({t / max(n, 1) * 100:.3f} %)", + va="center", fontsize=6.5) + ax.set_yticks(y) + ax.set_yticklabels([f"{k} {nm}" for k, nm in piv.index], fontsize=7) + ax.set_xlim(0, szer * 1.45) + from matplotlib.ticker import MaxNLocator + ax.xaxis.set_major_locator(MaxNLocator(integer=True)) + ax.set_xlabel(f"rows violating the rule (of {_th(n)} rows)", fontsize=7.5) + ax.set_title("Quality rules: a count of disclosure defects, not software errors", + fontsize=8.5, loc="left") + if len(piv.columns) > 1 and left.sum() > 0: + ax.legend(loc="lower right", fontsize=6.5, ncol=2, frameon=False, + handlelength=1.1, columnspacing=1.0) + _style(ax) + ax.margins(y=0.06) + return fig + + +def plot_column_shift(df: pd.DataFrame, ax=None): + """Rows in which a value stands in a field it cannot belong to, by field. + + A view of :func:`~gridqueue.layout.audit_column_shift`. An empty chart (0 %) is the + expected result of a correct extraction. + """ + a = audit_column_shift(df) + d = a.as_dict() + per = pd.Series(d.get("per_pole", {}), dtype=float).sort_values() + fig, ax = _figure(5.6, max(1.6, 0.9 + 0.28 * max(len(per), 1)), ax) + title = (f"Column shift audit: {_th(d['n_przesunietych'])} of {_th(d['n_wierszy'])} rows " + f"({d['udzial'] * 100:.3f} %)") + if not len(per): + _empty_note(ax, "no value stands in a field it cannot belong to") + ax.set_title(title, fontsize=8.5, loc="left") + return fig + ax.barh(range(len(per)), per.values, color="#c77a1e", height=0.6, zorder=2) + for i, v in enumerate(per.values): + ax.text(v, i, f" {_th(v)}", va="center", fontsize=6.5) + ax.set_yticks(range(len(per))) + ax.set_yticklabels(per.index, fontsize=7) + ax.set_xlabel("rows with a type-inconsistent value", fontsize=7.5) + ax.set_xlim(0, per.max() * 1.25) + ax.set_title(title, fontsize=8.5, loc="left") + _style(ax) + return fig + + +# --------------------------------------------------------------------------- +# the state of the queue +# --------------------------------------------------------------------------- + +def _status_order(values: Iterable[str]) -> list[str]: + ordered = [s for s in STATUSY if s in set(values)] + ordered.sort(key=lambda s: (s in TERMINAL_NEGATIVE or s == "UMOWA_ROZWIAZANA", + STATUS_ORDER.get(s, 99), s)) + rest = sorted(set(values) - set(ordered)) + return ordered + rest + + +def plot_status_distribution(df: pd.DataFrame, by: str = "publikujacy", + normalize: bool = False, codes: bool = False, ax=None): + """Applications by stage of the proceeding, one bar per publisher. + + Stages are ordered as the proceeding runs (filed, under review, conditions issued, + agreement, connected), followed by the states that end it without a connection. + ``normalize=True`` shows shares instead of counts, which makes publishers of very + different size comparable. + """ + import numpy as np + + app = _applications(df) + if "status_procesu" not in app.columns or not _filled(app["status_procesu"]).any(): + fig, ax = _figure(5.5, 2.0, ax) + _empty_note(ax, "the disclosure carries no process status") + return fig + grupy = [(k, s) for k, s in _groups(app, by) if len(s)] + st = _status_order(app["status_procesu"].dropna().astype(str).unique()) + M = pd.DataFrame({k: s["status_procesu"].astype(str).value_counts() for k, s in grupy} + ).reindex(st).fillna(0).T + if normalize: + M = M.div(M.sum(axis=1).replace(0, 1), axis=0) * 100 + fig, ax = _figure(6.8, max(1.8, 1.2 + 0.36 * len(grupy)), ax) + y = np.arange(len(M))[::-1] + left = np.zeros(len(M)) + for s in st: + v = M[s].values.astype(float) + ax.barh(y, v, left=left, height=0.62, zorder=2, label=s if codes else + STATUS_LABELS.get(s, s), color=_STATUS_COLORS.get(s, "#d1d5db")) + left += v + for yy, t, (k, sub) in zip(y, left, grupy): + ax.text(t, yy, f" {_th(len(sub))}" if not normalize else f" n={_th(len(sub))}", + va="center", fontsize=6.5) + ax.set_yticks(y) + ax.set_yticklabels([k for k, _ in grupy], fontsize=7) + ax.set_xlim(0, left.max() * 1.12 if left.max() else 1) + ax.set_xlabel("share of applications, %" if normalize else "applications", fontsize=7.5) + ax.set_title("Applications by stage of the proceeding", fontsize=8.5, loc="left") + ax.legend(loc="center left", bbox_to_anchor=(1.0, 0.5), ncol=1 if len(st) <= 6 else 2, + fontsize=6.2, frameon=False, handlelength=1.0, columnspacing=0.8, + borderaxespad=0.3) + _style(ax) + return fig + + +def plot_capacity_by_class(df: pd.DataFrame, power: str = "auto", + by: str = "klasa_zasobu", hue: Optional[str] = "poziom_napiecia", + statuses: Optional[Sequence[str]] | str = "active", + codes: bool = False, ax=None): + """Requested capacity in MW by resource class, split by voltage level. + + ``power="auto"`` adds injected capacity for generating classes and consumed capacity for + consumption, which is how the schema core treats the capacity alternative; give a field + name to use one field only. ``statuses="active"`` keeps applications still in the + queue (the default of ``node_loading``); ``None`` keeps all rows. + """ + import numpy as np + + app = _applications(df).copy() + if statuses == "active": + statuses = ACTIVE_STATUSES + if statuses is not None and "status_procesu" in app.columns: + app = app[app["status_procesu"].isin(set(statuses))] + if by not in app.columns: + fig, ax = _figure(5.5, 2.0, ax) + _empty_note(ax, f"the disclosure carries no field {by}") + return fig + if power == "auto": + w = pd.to_numeric(app.get("moc_wprowadzana"), errors="coerce") \ + if "moc_wprowadzana" in app else pd.Series(np.nan, index=app.index) + p = pd.to_numeric(app.get("moc_pobierana"), errors="coerce") \ + if "moc_pobierana" in app else pd.Series(np.nan, index=app.index) + app["_mw"] = w.where(w.notna() & (w > 0), p) / 1000.0 + opis = "requested capacity (injected, or consumed where no injection is declared)" + else: + app["_mw"] = pd.to_numeric(app.get(power), errors="coerce") / 1000.0 + opis = power + app = app[app["_mw"].notna() & (app["_mw"] > 0)] + fig, ax = _figure(6.6, 3.0, ax) + if not len(app): + _empty_note(ax, "no row with a disclosed capacity in the selected statuses") + return fig + h = hue if hue and hue in app.columns else None + app["_k"] = app[by].astype(object).where(app[by].notna(), "(empty)").astype(str) + app["_h"] = app[h].astype(object).where(app[h].notna(), "(not disclosed)").astype(str) \ + if h else "all" + if h: + # At most five levels by capacity, the rest pooled: a multi-voltage publisher writes + # combinations such as "110; 220 kV", and a legend of ten shades is not readable. + top_h = app.groupby("_h")["_mw"].sum().sort_values(ascending=False).index[:5] + app.loc[~app["_h"].isin(top_h), "_h"] = "other levels" + P = app.pivot_table(index="_k", columns="_h", values="_mw", aggfunc="sum").fillna(0) + P = P.loc[P.sum(axis=1).sort_values().index] + N = app.groupby("_k").size().reindex(P.index) + y = np.arange(len(P)) + left = np.zeros(len(P)) + pal = ["#1b5e8c", "#8fb4cc", "#2e8b78", "#c77a1e", "#7a4b9c", "#9ca3af"] + for i, c in enumerate(P.columns): + ax.barh(y, P[c].values, left=left, height=0.62, color=pal[i % len(pal)], + label=c, zorder=2) + left += P[c].values + for yy, t, n in zip(y, left, N.values): + ax.text(t, yy, f" {t:,.0f} MW, {_th(n)} appl.", va="center", fontsize=6.3) + lab = (lambda k: k) if codes or by != "klasa_zasobu" else \ + (lambda k: CLASS_LABELS.get(k, k)) + ax.set_yticks(y) + ax.set_yticklabels([lab(k) for k in P.index], fontsize=7) + ax.set_xlim(0, left.max() * 1.42) + ax.set_xlabel(f"MW, {opis}", fontsize=7) + which = "applications in the queue" if statuses is not None else "all applications" + ax.set_title(f"Requested capacity by {'resource class' if by == 'klasa_zasobu' else by}, " + f"{which}", fontsize=8.5, loc="left") + if h: + ax.legend(title=h, title_fontsize=6.5, fontsize=6.3, frameon=False, + loc="center left", bbox_to_anchor=(1.0, 0.5), borderaxespad=0.3) + _style(ax) + return fig + + +def plot_processing_time(df: pd.DataFrame, by: Optional[str] = "klasa_zasobu", + od: str = "data_wniosku", do: str = "data_warunkow", + min_n: int = 30, max_groups: int = 6, ci: bool = True, + codes: bool = False, ax=None): + """Kaplan-Meier curves of the time from application to the event ``do``. + + Applications without the closing date are **censored** at the as-at date of the + edition, not dropped, exactly as :func:`~gridqueue.analysis.processing_time` and + :func:`~gridqueue.analysis.kaplan_meier` compute them. Only groups with at least + ``min_n`` measurable applications are drawn (the inclusion criterion of the article); + the legend gives the group size, the share censored and the median with its interval. + """ + tab = kaplan_meier_by_group(_applications(df), by=by, od=od, do=do, min_n=min_n) + fig, ax = _figure(6.4, 3.6, ax) + if not len(tab): + _empty_note(ax, f"no group with at least {min_n} applications carrying {od}") + ax.set_title("Time to " + EVENT_LABELS.get(do, do), fontsize=8.5, loc="left") + return fig + tab = tab.head(max_groups) + app = _applications(df) + cov = min(float(_filled(app[c]).mean()) for c in (od, do)) + pt = processing_time(app, od=od, do=do) + pal = ["#1b5e8c", "#c77a1e", "#2e8b78", "#a33b4e", "#7a4b9c", "#6b7280", "#e9b44c"] + xmax = 0.0 + for i, r in enumerate(tab.itertuples(index=False)): + sub = pt if by is None else pt[_group_key(pt, by) == r.grupa] + km = kaplan_meier(sub["czas_dni"].astype("float64"), sub["zdarzenie"].astype("float64")) + t = [0.0] + km.tabela["t"].tolist() + S = [1.0] + km.tabela["S"].tolist() + tmax = float(pd.to_numeric(sub["czas_dni"], errors="coerce").max()) + t.append(tmax); S.append(S[-1]) + below = [tt for tt, ss in zip(t, S) if ss <= 0.01] + xmax = max(xmax, below[0] if below else tmax) + c = pal[i % len(pal)] + name = r.grupa if (codes or by != "klasa_zasobu") else \ + f"{CLASS_LABELS.get(r.grupa, r.grupa)} ({r.grupa})" + med = "not reached" if pd.isna(r.mediana) else f"{r.mediana:.0f} d" + ax.step(t, [s * 100 for s in S], where="post", color=c, lw=1.4, zorder=3, + label=f"{name}: n={_th(r.n)}, censored {r.udzial_cenzurowanych * 100:.1f} %, " + f"median {med}") + if ci and len(km.tabela): + lo = [100.0] + (km.tabela["S_dolne"] * 100).tolist() + [km.tabela["S_dolne"].iloc[-1] * 100] + hi = [100.0] + (km.tabela["S_gorne"] * 100).tolist() + [km.tabela["S_gorne"].iloc[-1] * 100] + ax.fill_between(t, lo, hi, step="post", color=c, alpha=0.13, lw=0, zorder=2) + if not pd.isna(r.mediana): + ax.plot([r.mediana], [50], "o", ms=3.5, color=c, zorder=4) + ax.axhline(50, color="#9ca3af", lw=0.8, ls="--", zorder=1) + ax.set_ylim(0, 102) + ax.set_xlim(0, xmax * 1.05 if xmax else 1) + ax.set_ylabel("% still waiting", fontsize=7.5) + ax.set_xlabel(f"days from {od} to {do} (axis ends where the curves fall below 1 % or end)", + fontsize=7.5) + ax.set_title(f"Time from {EVENT_LABELS.get(od, od)} to {EVENT_LABELS.get(do, do)}: " + "Kaplan-Meier, censored at the as-at date, 95 % band" + f"\nboth dates populated in {cov * 100:.1f} % of applications" + + ("" if cov >= 0.8 else ", below the 80 % inclusion criterion of the article"), + fontsize=8.5, loc="left") + ax.legend(fontsize=6.3, frameon=False, loc="upper right") + _style(ax, "both") + return fig + + +def plot_node_loading(loading: pd.DataFrame, ax=None, label: str = "nazwa_wezla", + top: int = 12, title: Optional[str] = None): + """Node loading: requested capacity of the active queue over declared free capacity. + + Takes the frame returned by :func:`~gridqueue.analysis.node_loading`. Bars are on a + logarithmic axis with the line at 1 (queue equal to the declared capacity). Nodes with + zero declared free capacity have an undefined ratio; they are counted in the title and + not drawn, rather than drawn as infinite. + """ + import numpy as np + + d = loading.copy() + zero = int(d.get("moc_dostepna_zero", pd.Series(dtype=bool)).fillna(False).sum()) + d = d[pd.to_numeric(d["obciazenie"], errors="coerce").notna()].copy() + d["obciazenie"] = pd.to_numeric(d["obciazenie"], errors="coerce").astype(float) + fig, ax = _figure(6.4, 3.4, ax) + if not len(d): + _empty_note(ax, "no node with a defined loading") + return fig + d = d.sort_values("obciazenie", ascending=False).reset_index(drop=True) + nonzero = d["obciazenie"] > 0 + n_zero_queue = int((~nonzero).sum()) + floor = float(d.loc[nonzero, "obciazenie"].min()) * 0.4 if nonzero.any() else 0.1 + pos = d["obciazenie"].where(nonzero, np.nan) + cols = np.where(d["obciazenie"] > 1, "#a33b4e", "#2e8b78") + ax.bar(np.arange(len(d))[nonzero.values], pos[nonzero].values, color=cols[nonzero.values], + width=0.8, zorder=2) + if n_zero_queue: + # loading exactly 0 (free capacity declared, no active application assigned) cannot be + # drawn on a log axis; it is marked at the floor instead of being given a fake height + ax.plot(np.arange(len(d))[~nonzero.values], [floor * 1.15] * n_zero_queue, marker="v", + ls="none", ms=4, color=_GREY, zorder=3, + label=f"\u03bb = 0: no active application assigned ({n_zero_queue})") + ax.set_yscale("log") + ax.axhline(1, color=_INK, lw=0.9, ls="--", zorder=3, + label="\u03bb = 1: queue equal to the declared free capacity") + ax.legend(loc="upper right", fontsize=6.5, frameon=False) + if label in d.columns and top: + for i in range(min(top, len(d))): + if not nonzero.iloc[i]: + continue + ax.text(i, pos.iloc[i] * 1.12, str(d.loc[i, label])[:14], rotation=90, + ha="center", va="bottom", fontsize=5.4, color="#374151") + ax.set_xticks([]) + ax.set_xlim(-0.8, len(d) - 0.2) + ax.set_ylim(min(floor, 0.5), max(float(np.nanmax(pos.values)) if nonzero.any() else 1.0, 2.0) * 8) + ax.set_xlabel(f"node-directions, sorted ({_th(len(d))} with declared free capacity)", + fontsize=7.5) + ax.set_ylabel("loading \u03bb(n), log scale", fontsize=7.5) + over = int((d["obciazenie"] > 1).sum()) + kier = d["kierunek"].dropna().iloc[0] if "kierunek" in d and d["kierunek"].notna().any() else None + ax.set_title(title or ( + f"Node loading{f', {_KIERUNEK.get(kier, kier)}' if kier else ''}: median {d['obciazenie'].median():.3f}, " + f"{over} of {len(d)} above 1; {zero} {'node' if zero == 1 else 'nodes'} with zero free capacity not drawn"), + fontsize=8.5, loc="left") + _style(ax, "y") + return fig + + +# --------------------------------------------------------------------------- +# two editions +# --------------------------------------------------------------------------- + +def plot_edition_flows(delta, ax=None): + """Flows between two editions: shared, absent from the later one, new in it. + + The two hatched segments are the warning signs of a non-monotone register: rows that + disappear while still active, and rows that appear already closed. + """ + d = delta.as_dict() + fig, ax = _figure(6.4, 2.4, ax) + ea, eb = d["edycja_a"], d["edycja_b"] + shared, gone, new = d["wspolnych"], d["ubylych"], d["nowych"] + gone_act, new_closed = d["ubyle_czynne"], d["nowe_zamkniete"] + rej_a = d["odrzuconych_jako_niejednoznaczne_a"] + rej_b = d["odrzuconych_jako_niejednoznaczne_b"] + y = [1, 0] + ax.barh(1, shared, color="#1b5e8c", height=0.55, zorder=2, label="shared (linked)") + ax.barh(1, gone - gone_act, left=shared, color="#c9dcea", height=0.55, zorder=2, + label="absent from the later edition") + ax.barh(1, gone_act, left=shared + gone - gone_act, color="#c9dcea", hatch="////", + edgecolor="#a33b4e", lw=0, height=0.55, zorder=2, + label="absent while still active") + ax.barh(1, rej_a, left=shared + gone, color="#e5e7eb", height=0.55, zorder=2, + label="key collision, not linked") + ax.barh(0, shared, color="#1b5e8c", height=0.55, zorder=2) + ax.barh(0, new - new_closed, left=shared, color="#e9c46a", height=0.55, zorder=2, + label="new in the later edition") + ax.barh(0, new_closed, left=shared + new - new_closed, color="#e9c46a", hatch="////", + edgecolor="#a33b4e", lw=0, height=0.55, zorder=2, label="new, already closed") + ax.barh(0, rej_b, left=shared + new, color="#e5e7eb", height=0.55, zorder=2) + for yy, tot, n in ((1, shared + gone + rej_a, d["wierszy_a"]), + (0, shared + new + rej_b, d["wierszy_b"])): + ax.text(tot, yy, f" {_th(n)} rows", va="center", fontsize=6.8) + ax.text(shared / 2, 0.5, f"{_th(shared)} linked", ha="center", va="center", + fontsize=6.8, color="#1b5e8c") + ax.set_yticks(y) + ax.set_yticklabels([str(ea), str(eb)], fontsize=7.5) + ax.set_xlim(0, max(d["wierszy_a"], d["wierszy_b"]) * 1.18) + ax.set_xlabel("rows", fontsize=7.5) + mono = "monotone" if d["migawka_monotoniczna"] else "NOT a monotone snapshot" + ax.set_title(f"Flows between editions: {_th(new)} new, {_th(gone)} absent; register is {mono}", + fontsize=8.5, loc="left") + ax.legend(loc="upper center", bbox_to_anchor=(0.5, -0.32), ncol=3, fontsize=6.2, + frameon=False, handlelength=1.2) + _style(ax) + return fig + + +def plot_transitions(delta, ax=None, codes: bool = False): + """Status transition matrix among linked rows. + + Off-diagonal cells are coloured by direction: forward in the order of the proceeding + (or to a terminal negative state) in green, backward in red. A high forward share is the + independent test of the linkage described in the article. + """ + import numpy as np + from matplotlib.colors import LinearSegmentedColormap + + tr = delta.przejscia + fig, ax = _figure(5.0, 4.4, ax) + if tr is None or not len(tr): + _empty_note(ax, "no linked rows") + return fig + st = _status_order(set(tr.index) | set(tr.columns)) + M = tr.reindex(index=st, columns=st).fillna(0).astype(int) + off = M.values.copy() + np.fill_diagonal(off, 0) + vmax = max(int(off.max()), 1) + cmap = LinearSegmentedColormap.from_list("t", ["#ffffff", "#c9dcea", "#1b5e8c"]) + ax.imshow(np.where(off > 0, off, 0), cmap=cmap, vmin=0, vmax=vmax, aspect="equal") + for i, a in enumerate(st): + for j, b in enumerate(st): + n = int(M.iloc[i, j]) + if not n: + continue + if i == j: + ax.text(j, i, _th(n), ha="center", va="center", fontsize=6, color=_GREY) + continue + fwd = (a in STATUS_ORDER and b in STATUS_ORDER and STATUS_ORDER[b] > STATUS_ORDER[a]) \ + or (a in STATUS_ORDER and b in TERMINAL_NEGATIVE) + back = a in STATUS_ORDER and b in STATUS_ORDER and STATUS_ORDER[b] < STATUS_ORDER[a] + col = "#14532d" if fwd else ("#a33b4e" if back else _INK) + ax.text(j, i, _th(n), ha="center", va="center", fontsize=7, fontweight="bold", + color="#ffffff" if n > vmax * 0.6 and not back else col) + if back: + ax.add_patch(__import__("matplotlib").patches.Rectangle( + (j - .5, i - .5), 1, 1, fill=False, ec="#a33b4e", lw=1.2)) + lab = (lambda s: s) if codes else (lambda s: STATUS_LABELS.get(s, s)) + ax.set_xticks(range(len(st))) + ax.set_xticklabels([lab(s) for s in st], rotation=40, ha="right", fontsize=6.5) + ax.set_yticks(range(len(st))) + ax.set_yticklabels([lab(s) for s in st], fontsize=6.5) + ax.set_xlabel(f"status in {delta.edycja_b}", fontsize=7.5) + ax.set_ylabel(f"status in {delta.edycja_a}", fontsize=7.5) + ax.tick_params(length=0) + sh = delta.udzial_przejsc_w_przod + ax.set_title("Status transitions among linked rows" + + (f": {sh * 100:.2f} % forward" if sh is not None else ""), + fontsize=8.5, loc="left") + for s in ax.spines.values(): + s.set_color("#e5e7eb") + return fig + + +def plot_linkage_audit(audit, recall=None, ax=None): + """Confirmed, uncertain and false pairs on the fields excluded from the key. + + With a :class:`~gridqueue.longitudinal.LinkageRecall` the pairs the key missed are + added as a fourth segment, so precision and sensitivity are read from one bar. + """ + a = audit.as_dict() + fig, ax = _figure(6.4, 1.7, ax) + parts = [("confirmed", a["potwierdzonych"], "#2e8b78"), + ("uncertain", a["niepewnych"], "#e9c46a"), + ("false", a["falszywych"], "#a33b4e")] + if recall is not None: + parts.append(("missed by the key, recovered", recall.as_dict()["odzyskanych"], "#9ca3af")) + left = 0 + for name, v, c in parts: + ax.barh(0, v, left=left, color=c, height=0.5, label=f"{name} ({_th(v)})", zorder=2) + left += v + ax.set_yticks([]) + ax.set_xlim(0, max(left, 1) * 1.02) + ax.set_xlabel("linked pairs", fontsize=7.5) + ttl = (f"Linkage precision {a['precyzja_dolna'] * 100:.2f} to " + f"{a['precyzja_gorna'] * 100:.2f} % over {_th(a['par'])} pairs") + if recall is not None and recall.as_dict()["czulosc_klucza"] == recall.as_dict()["czulosc_klucza"]: + ttl += f"; key sensitivity {recall.as_dict()['czulosc_klucza']:.4f}" + ax.set_title(ttl, fontsize=8.5, loc="left") + ax.legend(loc="upper center", bbox_to_anchor=(0.5, -0.55), ncol=4, fontsize=6.3, + frameon=False, handlelength=1.1) + _style(ax) + return fig + + +def plot_edition_comparison(delta, audit=None, recall=None): + """Flows, transition matrix and linkage audit of two editions in one figure.""" + Figure = _mpl() + fig = Figure(figsize=(10.5, 5.2), dpi=110, layout="constrained") + gs = fig.add_gridspec(2, 2, width_ratios=[1.45, 1.0], height_ratios=[1.2, 0.8]) + plot_edition_flows(delta, ax=fig.add_subplot(gs[0, 0])) + if audit is not None: + plot_linkage_audit(audit, recall, ax=fig.add_subplot(gs[1, 0])) + plot_transitions(delta, ax=fig.add_subplot(gs[:, 1])) + return fig + + +# --------------------------------------------------------------------------- +# locations +# --------------------------------------------------------------------------- + +_GEO_KAT = { + "source coordinates": "#14532d", "placed by the gazetteer": "#2e8b78", + "locality centroid only": "#7fb7be", "name resolved, no geometry": "#b9d7c9", + "station code with no dictionary": "#1b5e8c", "no locality declared": "#8fb4cc", + "empty description": "#cfd8dd", "locality outside the gazetteer": "#c77a1e", + "several candidates": "#7a4b9c", "no candidate in the gazetteer": "#c9a0dc", + "not resolved, other reason": "#aaaaaa", + "resolver not run": "#e5e7eb", +} +_WITH_POINT = ("source coordinates", "placed by the gazetteer", "locality centroid only") +_PEWNOSC = {"EXACT": "exact", "UNIQUE_TOKEN": "unique member", "SKRZYZOWANIE": "intersection", + "REVERSED": "reversed order", "TOKEN_SUBSET": "subset of members"} + + +def _geo_category(wsp, pewnosc, powod, dokladnosc=None) -> str: + p = "" if pewnosc is None or (isinstance(pewnosc, float) and pewnosc != pewnosc) \ + else str(pewnosc) + if _filled(pd.Series([wsp])).iloc[0]: + if not p or p == "ZRODLO": + return "source coordinates" + if p == "NONE" or str(dokladnosc) == "CENTROID_MIEJSCOWOSCI": + return "locality centroid only" + return "placed by the gazetteer" + s = "" if powod is None or (isinstance(powod, float) and powod != powod) else str(powod) + if not s and not p: + return "resolver not run" + if "bez_geometrii" in s or (p and p != "NONE"): + return "name resolved, no geometry" + if "kod_stacji" in s: + return "station code with no dictionary" + if "brak_deklaracji_miejscowosci" in s: + return "no locality declared" + if "pusty_opis" in s: + return "empty description" + if "poza_gazeterem" in s: + return "locality outside the gazetteer" + if "wiele_kandydatow" in s or "niejednoznaczna" in s: + return "several candidates" + if "brak_kandydatow" in s or "brak_tokenow" in s or "opis_slowny" in s: + return "no candidate in the gazetteer" + return "not resolved, other reason" + + +def plot_location_resolution(df: pd.DataFrame, by: str = "publikujacy"): + """Where a coordinate comes from, and where it does not, by publisher. + + Left: share of rows with source coordinates, coordinates placed by the gazetteer, and + each stated reason for absence. Right: confidence levels of the gazetteer placements. + Reads the resolver diagnostics ``_geo_pewnosc`` and ``_geo_powod`` when present. + """ + import numpy as np + + Figure = _mpl() + d = df.copy() + wsp = d["wspolrzedne"] if "wspolrzedne" in d else pd.Series(None, index=d.index) + pew = d["_geo_pewnosc"] if "_geo_pewnosc" in d else pd.Series(None, index=d.index) + pow_ = d["_geo_powod"] if "_geo_powod" in d else pd.Series(None, index=d.index) + dok = d["_geo_dokladnosc"] if "_geo_dokladnosc" in d else pd.Series(None, index=d.index) + d["_kat"] = [_geo_category(w, p, r, k) for w, p, r, k in zip(wsp, pew, pow_, dok)] + grupy = _groups(d, by) + kat = [k for k in _GEO_KAT if (d["_kat"] == k).any()] + CT = pd.DataFrame({k: s["_kat"].value_counts() for k, s in grupy}).reindex(kat).fillna(0).T + placed = d.loc[d["_kat"].isin(["placed by the gazetteer", "name resolved, no geometry"]), + "_geo_pewnosc"] if "_geo_pewnosc" in d else pd.Series(dtype=object) + two = len(placed) > 0 + fig = Figure(figsize=(7.2 if two else 5.4, max(2.3, 1.4 + 0.3 * len(grupy))), dpi=110, + layout="constrained") + gs = fig.add_gridspec(1, 2 if two else 1, width_ratios=[1.6, 1.0] if two else [1]) + ax = fig.add_subplot(gs[0]) + y = np.arange(len(CT))[::-1] + frac = CT.div(CT.sum(axis=1).replace(0, 1), axis=0) * 100 + left = np.zeros(len(CT)) + for k in CT.columns: + ax.barh(y, frac[k].values, left=left, height=0.62, color=_GEO_KAT[k], label=k, zorder=2) + left += frac[k].values + for yy, k in zip(y, CT.index): + have = int(CT.loc[k, [c for c in CT.columns if c in _WITH_POINT]].sum()) + ax.text(101.5, yy, f"{_th(have)} / {_th(CT.loc[k].sum())}", va="center", fontsize=6.3) + ax.set_yticks(y) + ax.set_yticklabels(CT.index, fontsize=7) + ax.set_xlim(0, 120) + ax.set_xticks([0, 25, 50, 75, 100]) + ax.set_xlabel("share of the publisher's rows, %", fontsize=7.5) + n_have = int((d["_kat"].isin(_WITH_POINT)).sum()) + ax.set_title(f"Coordinates in {_th(n_have)} of {_th(len(d))} rows;\n" + "absence is returned with a reason, not guessed", fontsize=8.5, loc="left") + ax.legend(loc="upper center", bbox_to_anchor=(0.5, -0.25), ncol=2, fontsize=6, + frameon=False, handlelength=1.0, columnspacing=0.9) + _style(ax) + if two: + ax2 = fig.add_subplot(gs[1]) + pw = placed.astype(str).value_counts() + keys = [k for k in _PEWNOSC if k in pw.index] + [k for k in pw.index if k not in _PEWNOSC] + vv = [int(pw[k]) for k in keys] + yb = np.arange(len(keys))[::-1] + ax2.barh(yb, vv, height=0.6, color="#2e8b78", zorder=2) + for yy, v in zip(yb, vv): + ax2.text(v + max(vv) * 0.02, yy, f"{v} ({v / sum(vv) * 100:.1f} %)", + va="center", fontsize=6.3) + ax2.set_yticks(yb) + ax2.set_yticklabels([_PEWNOSC.get(k, k) for k in keys], fontsize=6.5) + ax2.set_xlim(0, max(vv) * 1.45) + ax2.set_xlabel("rows", fontsize=7.5) + ax2.set_title(f"Certainty of {_th(sum(vv))} identified place names", fontsize=8.5, + loc="left") + _style(ax2) + return fig + + +# --------------------------------------------------------------------------- +# one-call views +# --------------------------------------------------------------------------- + +def plot_overview(df: pd.DataFrame, by: str = "publikujacy"): + """Four panels for a first look: coverage, quality, status and capacity.""" + Figure = _mpl() + n_pub = len(_groups(df, by)) + fig = Figure(figsize=(13, 9.6), dpi=100, layout="constrained") + gs = fig.add_gridspec(3, 2, width_ratios=[0.22 + 0.06 * min(n_pub, 9), 1.0], + height_ratios=[1.0, 0.75, 1.15]) + plot_field_coverage(df, by=by, ax=fig.add_subplot(gs[:, 0])) + plot_quality(df, by=by, ax=fig.add_subplot(gs[0, 1])) + plot_status_distribution(df, by=by, normalize=True, ax=fig.add_subplot(gs[1, 1])) + plot_capacity_by_class(df, ax=fig.add_subplot(gs[2, 1])) + return fig + + +def save_figure(fig, path, dpi: int = 300) -> Path: + """Save a figure (format from the suffix: .png, .svg, .pdf) and return the path.""" + p = Path(path) + p.parent.mkdir(parents=True, exist_ok=True) + fig.savefig(p, dpi=dpi, bbox_inches="tight", facecolor="white") + return p + + +def save_all(df: pd.DataFrame, out_dir, *, edition_b: Optional[pd.DataFrame] = None, + labels: tuple[str, str] = ("A", "B"), formats: Sequence[str] = ("png",), + dpi: int = 200, min_n: int = 30, + min_coverage: float = 0.8) -> dict[str, list[Path]]: + """Draw every chart the data supports and save it to ``out_dir``. + + Charts that need data the disclosure does not carry are skipped and listed under the + key ``"_skipped"`` with the reason, rather than drawn empty. With ``edition_b`` the + edition-comparison charts are added, ``df`` being the earlier edition. + + The processing-time curves follow the inclusion criterion of the article, fixed before + the result is computed: both dates populated in at least ``min_coverage`` of the + applications and at least ``min_n`` applications in a group. + """ + from .analysis import assign_to_nodes, node_loading, station_node_map + from .longitudinal import compare_editions, linkage_audit, linkage_recall + + out = Path(out_dir) + saved: dict[str, list[Path]] = {} + skipped: list[str] = [] + + def put(name, fig): + saved[name] = [save_figure(fig, out / f"{name}.{fmt}", dpi=dpi) for fmt in formats] + + put("field_coverage", plot_field_coverage(df)) + put("quality_rules", plot_quality(df)) + put("column_shift", plot_column_shift(df)) + if "status_procesu" in df and _filled(_applications(df)["status_procesu"]).any(): + put("status_distribution", plot_status_distribution(df)) + else: + skipped.append("status_distribution: no process status disclosed") + if "klasa_zasobu" in df and _filled(_applications(df)["klasa_zasobu"]).any(): + put("capacity_by_class", plot_capacity_by_class(df)) + else: + skipped.append("capacity_by_class: no resource class disclosed") + app = _applications(df) + cov = min((float(_filled(app[c]).mean()) if c in app and len(app) else 0.0) + for c in ("data_wniosku", "data_warunkow")) + km = kaplan_meier_by_group(app, min_n=min_n) if cov >= min_coverage else [] + if cov < min_coverage: + skipped.append(f"processing_time: date coverage {cov * 100:.1f} % is below the " + f"{min_coverage * 100:.0f} % inclusion criterion") + elif len(km): + put("processing_time", plot_processing_time(df, min_n=min_n)) + else: + skipped.append(f"processing_time: no group of {min_n} applications with data_wniosku") + if "wspolrzedne" in df: + put("location_resolution", plot_location_resolution(df)) + if "moc_dostepna" in df and "_encja" in df and (df["_encja"] == "WEZEL").any() \ + and (df["_encja"] != "WEZEL").any(): + mapa = station_node_map(df) + if len(mapa): + przyp = assign_to_nodes(df, mapa) + for pole, nazwa in (("moc_wprowadzana", "generation"), ("moc_pobierana", "demand")): + L = node_loading(przyp, pole_mocy=pole) + if pd.to_numeric(L["obciazenie"], errors="coerce").notna().any(): + put(f"node_loading_{nazwa}", plot_node_loading(L)) + else: + skipped.append("node_loading: node rows carry no station list") + else: + skipped.append("node_loading: needs both node rows and application rows") + if edition_b is not None: + delta = compare_editions(df, edition_b, labels[0], labels[1]) + aud = linkage_audit(df, edition_b) + rec = linkage_recall(df, edition_b) + put("edition_comparison", plot_edition_comparison(delta, aud, rec)) + saved["_skipped"] = skipped # type: ignore[assignment] + return saved diff --git a/src/gridqueue/registry.py b/src/gridqueue/registry.py index 15a49e3..1956f93 100644 --- a/src/gridqueue/registry.py +++ b/src/gridqueue/registry.py @@ -17,7 +17,7 @@ from .adapters.pt_eredes import EredesAdapter from .adapters.uk_nationalgrid import NationalGridAdapter -__all__ = ["REGISTRY", "get_adapter", "detect_publisher", "declarations"] +__all__ = ["REGISTRY", "get_adapter", "detect_publisher", "declarations", "parse_sources"] REGISTRY: dict[str, Type[Adapter]] = { "pl_tauron": TauronAdapter, @@ -68,3 +68,77 @@ def detect_publisher(source, *, sniff_bytes: int = 4000) -> Optional[str]: def declarations() -> list[dict]: """Declarations of optional fields of all registered publishers.""" return [cls().declaration() for cls in REGISTRY.values()] + + + +def parse_sources(sources, adapter: Optional[str] = None): + """Parse any number of documents, of one or several publishers, into one panel. + + Each file is assigned to a publisher by :func:`detect_publisher` (or to ``adapter`` when + given) and parsed **on its own, by a fresh adapter instance**, so that every document keeps + the as-at date it states. This matters twice: a publisher that splits one edition into + several documents (ENERGA-OPERATOR's applications as at 30 June and node capacities as at + 31 August 2026) keeps both dates, and two editions of one register dropped together are + never stamped with a single date. The node and application rows of one publisher still end + up in one panel, which is all that :func:`~gridqueue.analysis.station_node_map` needs. + + Returns ``(frame, reports)``: the concatenated frame in the schema and one + ``{"adapter", "files", "rows", "data_publikacji", "report"}`` entry per file. A file no + adapter recognises raises ``ValueError`` naming it, rather than being skipped silently. + """ + import pandas as pd + + paths = [sources] if isinstance(sources, (str, Path)) else list(sources) + keys = [] + for p in paths: + key = adapter or detect_publisher(p) + if key is None: + raise ValueError(f"no adapter recognised {Path(str(p)).name!r}; keep the file " + f"name the publisher gave it, or choose the adapter explicitly") + keys.append(key) + frames, reports = [], [] + for key, p in zip(keys, paths): + res = get_adapter(key).parse(p) + frames.append(res.frame) + dates = res.frame["data_publikacji"].dropna().astype(str).unique().tolist() \ + if "data_publikacji" in res.frame else [] + reports.append({"adapter": key, "files": [Path(str(p)).name], "rows": int(len(res.frame)), + "data_publikacji": dates[0] if len(dates) == 1 else dates, + "report": dict(res.report)}) + frame = pd.concat(frames, ignore_index=True) if frames else pd.DataFrame() + return frame, reports + + +def split_editions(df): + """Split a panel into editions of one register by the as-at date of its application rows. + + Returns ``[(date, frame), ...]`` ordered by date when the panel holds exactly one + publisher whose application rows carry two or more publication dates; otherwise a + single ``(None, df)``. Node rows (``_encja == "WEZEL"``) go to the edition whose + application date is nearest to their own, later on a tie, because a publisher may date its + node and application documents of one edition differently. + """ + import pandas as pd + + if "data_publikacji" not in df or df.empty: + return [(None, df)] + is_node = df["_encja"].astype("string").fillna("WNIOSEK").str.upper().eq("WEZEL") \ + if "_encja" in df else pd.Series(False, index=df.index) + pubs = df["publikujacy"].dropna().unique() if "publikujacy" in df else [] + dates = sorted(df.loc[~is_node, "data_publikacji"].dropna().astype(str).unique()) + if len(pubs) != 1 or len(dates) < 2: + return [(None, df)] + d = pd.to_datetime(pd.Series(dates)) + own = df["data_publikacji"].astype(str) + + def edition_of(v): + if v in dates: + return v + t = pd.to_datetime(v, errors="coerce") + if pd.isna(t): + return dates[-1] + gap = (d - t).abs() + return dates[max(i for i in range(len(dates)) if gap[i] == gap.min())] + + lab = own.map(edition_of) + return [(x, df[lab == x].reset_index(drop=True)) for x in dates] diff --git a/tests/test_analysis_v16.py b/tests/test_analysis_v16.py new file mode 100644 index 0000000..de81e1c --- /dev/null +++ b/tests/test_analysis_v16.py @@ -0,0 +1,83 @@ +"""Regressions fixed in 1.6.0: censoring date per row, voltage filter of node loading.""" + +import pandas as pd + +import gridqueue as G + + +def test_censoring_uses_the_rows_own_publication_date(): + # Node rows published later must not lengthen the censored times of applications. + df = pd.DataFrame([ + {"_encja": "WNIOSEK", "data_wniosku": "2026-01-01", "data_publikacji": "2026-06-30"}, + {"_encja": "WNIOSEK", "data_wniosku": "2026-01-01", "data_warunkow": "2026-03-01", + "data_publikacji": "2026-06-30"}, + {"_encja": "WEZEL", "data_publikacji": "2026-08-31"}, + ]) + pt = G.processing_time(df) + assert pt.loc[0, "czas_dni"] == (pd.Timestamp("2026-06-30") - pd.Timestamp("2026-01-01")).days + assert pt.loc[0, "zdarzenie"] == 0 and pt.loc[1, "zdarzenie"] == 1 + + +def test_censoring_per_publisher_in_a_panel(): + df = pd.DataFrame([ + {"publikujacy": "A", "data_wniosku": "2026-01-01", "data_publikacji": "2026-03-31"}, + {"publikujacy": "B", "data_wniosku": "2026-01-01", "data_publikacji": "2026-06-30"}, + ]).assign(data_warunkow=None) + pt = G.processing_time(df) + assert list(pt["czas_dni"]) == [89, 180] + + +def test_explicit_as_at_date_applies_to_every_row(): + df = pd.DataFrame([{"data_wniosku": "2026-01-01", "data_publikacji": "2026-03-31", + "data_warunkow": None}]) + assert G.processing_time(df, na_dzien="2026-01-11")["czas_dni"].iloc[0] == 10 + + +def test_node_loading_voltage_filter(): + rows = [ + {"_encja": "WEZEL", "id_wezla": "G1", "nazwa_wezla": "Alfa", "_nr_grupy": 1, + "lokalizacja_tekst": "Alfa", "moc_dostepna": 1000.0, "_kierunek": "wytworcza"}, + {"_encja": "WNIOSEK", "lokalizacja_tekst": "Alfa", "moc_wprowadzana": 3000.0, + "status_procesu": "WARUNKI_WYDANE", "poziom_napiecia": "110 kV"}, + {"_encja": "WNIOSEK", "lokalizacja_tekst": "Alfa", "moc_wprowadzana": 500.0, + "status_procesu": "WARUNKI_WYDANE", "poziom_napiecia": "SN"}, + ] + df = pd.DataFrame(rows) + przyp = G.assign_to_nodes(df, G.station_node_map(df)) + assert G.node_loading(przyp, napiecie="110")["obciazenie"].iloc[0] == 3.0 + assert G.node_loading(przyp)["obciazenie"].iloc[0] == 3.5 + + +def test_split_editions_by_application_date(): + from gridqueue import examples as X + a, b = X.synthetic_editions(120) + eds = G.split_editions(pd.concat([b, a], ignore_index=True)) + assert [x for x, _ in eds] == ["2026-05-31", "2026-06-30"] + assert [len(f) for _, f in eds] == [len(a), len(b)] + + +def test_split_editions_keeps_one_edition_with_node_rows_of_another_date(): + df = pd.DataFrame([ + {"_encja": "WNIOSEK", "publikujacy": "P", "data_publikacji": "2026-06-30"}, + {"_encja": "WEZEL", "publikujacy": "P", "data_publikacji": "2026-08-31"}, + ]) + eds = G.split_editions(df) + assert len(eds) == 1 and eds[0][0] is None + + +def test_split_editions_assigns_node_rows_to_the_nearest_edition(): + df = pd.DataFrame([ + {"_encja": "WNIOSEK", "publikujacy": "P", "data_publikacji": "2026-03-31"}, + {"_encja": "WNIOSEK", "publikujacy": "P", "data_publikacji": "2026-06-30"}, + {"_encja": "WEZEL", "publikujacy": "P", "data_publikacji": "2026-07-15"}, + ]) + eds = dict(G.split_editions(df)) + assert len(eds["2026-03-31"]) == 1 and len(eds["2026-06-30"]) == 2 + + +def test_parse_sources_names_an_unrecognised_file(tmp_path): + p = tmp_path / "unknown.txt" + p.write_text("nothing here", encoding="utf-8") + import pytest + with pytest.raises(ValueError, match="unknown.txt"): + G.parse_sources([p]) diff --git a/tests/test_examples_geocode.py b/tests/test_examples_geocode.py new file mode 100644 index 0000000..b468a01 --- /dev/null +++ b/tests/test_examples_geocode.py @@ -0,0 +1,45 @@ +"""Synthetic examples and geocode_frame.""" + +import json + +import gridqueue as G +from gridqueue import examples as X + + +def test_synthetic_panel_is_clean_and_complete(): + df = X.synthetic_panel(300, seed=3) + assert set(df["publikujacy"].dropna()) <= set(X.SYNTHETIC_PUBLISHERS) + assert G.run_quality(df).as_dict()["naruszen_lacznie"] == 0 + assert (df["_encja"] == "WEZEL").sum() == 16 + assert len(G.kaplan_meier_by_group(df, min_n=20)) >= 2 + + +def test_synthetic_panel_is_reproducible(): + a, b = X.synthetic_panel(50, seed=1), X.synthetic_panel(50, seed=1) + assert a.equals(b) + + +def test_synthetic_editions_have_every_kind_of_flow(): + a, b = X.synthetic_editions(300) + d = G.compare_editions(a, b, "A", "B") + assert d.nowych > 0 and d.ubylych > 0 and d.zmian_statusu > 0 + assert d.przejscia_wstecz >= 1 + + +def test_geocode_frame_writes_schema_points_and_reasons(tmp_path): + p = tmp_path / "gaz.json" + p.write_text(json.dumps(X.synthetic_gazetteer()), encoding="utf-8") + res = G.resolver_from_gazeter_json(p) + df = X.synthetic_panel(200, seed=5, with_nodes=False) + df["wspolrzedne"] = df["wspolrzedne"].astype(object) + df.loc[df.index[0], "wspolrzedne"] = "50.0,20.0" + out = G.geocode_frame(df, res) + assert out.loc[out.index[0], "_geo_pewnosc"] == "ZRODLO" + assert out.loc[out.index[0], "wspolrzedne"] == "50.0,20.0" + placed = out["wspolrzedne"].notna() + assert placed.sum() > 1 + assert (out.loc[~placed, "_geo_powod"].str.len() > 0).all() + # every point is in the format the schema validates + assert G.validate_frame(out)["n_wierszy"] == len(out) + lat = out.loc[placed, "wspolrzedne"].str.split(",").str[0].astype(float) + assert lat.between(-90, 90).all() diff --git a/tests/test_plots.py b/tests/test_plots.py new file mode 100644 index 0000000..0199ed2 --- /dev/null +++ b/tests/test_plots.py @@ -0,0 +1,173 @@ +"""Charts: every function draws from constructed frames without raising, and the numbers +it puts on the chart are the numbers of the analysis it shows.""" + +import json + +import pandas as pd +import pytest + +pytest.importorskip("matplotlib") + +from gridqueue import (compare_editions, kaplan_meier, kaplan_meier_by_group, # noqa: E402 + linkage_audit, linkage_recall) +from gridqueue import cli, plots # noqa: E402 +from gridqueue.analysis import assign_to_nodes, node_loading, station_node_map # noqa: E402 +from gridqueue.schema import empty_frame # noqa: E402 + + +def _frame(rows): + return pd.DataFrame(rows).reindex(columns=list(empty_frame().columns) + [ + c for c in pd.DataFrame(rows).columns if c not in empty_frame().columns]) + + +def _panel(n=80): + rows = [] + for i in range(n): + klasa = "PV" if i % 2 else "ODB" + rows.append({ + "id_wniosku": f"A{i}", "lokalizacja_tekst": f"Stacja {i % 4}", + "klasa_zasobu": klasa, "poziom_napiecia": "SN" if i % 3 else "110 kV", + "moc_wprowadzana": 1000.0 + i if klasa == "PV" else None, + "moc_pobierana": 500.0 + i if klasa == "ODB" else None, + "status_procesu": "WARUNKI_WYDANE" if i % 5 else "WNIOSEK_ZLOZONY", + "data_wniosku": f"2025-01-{1 + i % 28:02d}", + "data_warunkow": f"2025-0{3 + i % 6}-15" if i % 5 else None, + "data_publikacji": "2025-12-31", + "publikujacy": "PSE S.A." if i < n // 2 else "ENERGA-OPERATOR S.A.", + }) + return _frame(rows) + + +def _texts(fig): + out = [] + for ax in fig.axes: + out.append(ax.get_title(loc="left")) + out += [t.get_text() for t in ax.texts] + return " ".join(out) + + +@pytest.fixture(scope="module") +def panel(): + return _panel() + + +def test_every_panel_chart_draws(panel): + for f in (plots.plot_field_coverage, plots.plot_quality, plots.plot_column_shift, + plots.plot_status_distribution, plots.plot_capacity_by_class, + plots.plot_processing_time, plots.plot_location_resolution, + plots.plot_overview): + fig = f(panel) + assert fig.axes, f.__name__ + + +def test_charts_tolerate_a_minimal_frame(): + df = _frame([{"id_wniosku": "X", "lokalizacja_tekst": "a", "klasa_zasobu": "ODB", + "status_procesu": "WNIOSEK_ZLOZONY", "moc_pobierana": 10.0}]) + for f in (plots.plot_field_coverage, plots.plot_quality, plots.plot_status_distribution, + plots.plot_capacity_by_class, plots.plot_processing_time, + plots.plot_location_resolution, plots.plot_overview): + assert f(df).axes + + +def test_coverage_counts_fields_like_the_schema(panel): + txt = plots.plot_field_coverage(panel).axes[0].get_title(loc="left") + populated = sum(1 for c in plots.schema_table()["pole"] if panel[c].notna().any()) + assert f"{populated} of 21 fields populated" in txt + + +def test_quality_chart_total_matches_run_quality(panel): + from gridqueue import run_quality + + fig = plots.plot_quality(panel, by=None) + expected = {r["kod"]: r["naruszenia"] for r in run_quality(panel).as_dict()["reguly"]} + shown = _texts(fig) + for kod, n in expected.items(): + if n > 0: + assert f"{n:,} (" in shown, kod + + +def test_km_chart_legend_uses_the_estimator(panel): + tab = kaplan_meier_by_group(panel, by="klasa_zasobu", min_n=10) + fig = plots.plot_processing_time(panel, min_n=10) + legend = " ".join(t.get_text() for t in fig.axes[0].get_legend().get_texts()) + for r in tab.itertuples(): + assert f"n={r.n:,}" in legend + assert f"median {r.mediana:.0f} d" in legend + + +def test_km_median_interval_is_ordered(): + # Regression: up to 1.5.2 the two bounds of the median interval were swapped. + t = list(range(1, 201)) + e = [1] * 200 + km = kaplan_meier(t, e) + assert km.mediana_dolna <= km.mediana <= km.mediana_gorna + + +def test_km_all_censored_group_does_not_raise(): + # Regression: a group with no event produced a frame without columns (KeyError 'S'). + km = kaplan_meier([10, 20, 30], [0, 0, 0]) + assert km.n == 3 and km.zdarzen == 0 and km.mediana != km.mediana + + +def test_km_by_group_respects_min_n(panel): + assert kaplan_meier_by_group(panel, min_n=10_000).empty + tab = kaplan_meier_by_group(panel, by=["publikujacy", "klasa_zasobu"], min_n=5) + assert tab["grupa"].str.contains(" / ").all() + + +def _editions(): + a = _panel(40) + b = a.copy() + b.loc[b.index[:5], "status_procesu"] = "UMOWA_OBOWIAZUJACA" + b = b.iloc[2:] + return a, b + + +def test_edition_charts_show_the_delta(): + a, b = _editions() + d = compare_editions(a, b, "A", "B") + fig = plots.plot_edition_comparison(d, linkage_audit(a, b), linkage_recall(a, b)) + assert len(fig.axes) == 3 + txt = _texts(fig) + assert f"{d.wspolnych:,} linked" in txt + + +def test_node_loading_chart_skips_zero_capacity(): + rows = [ + {"_encja": "WEZEL", "id_wezla": "G1", "nazwa_wezla": "Alfa", "_nr_grupy": 1, + "lokalizacja_tekst": "Alfa, Beta", "moc_dostepna": 1000.0, "_kierunek": "wytworcza"}, + {"_encja": "WEZEL", "id_wezla": "G2", "nazwa_wezla": "Gamma", "_nr_grupy": 2, + "lokalizacja_tekst": "Gamma", "moc_dostepna": 0.0, "_kierunek": "wytworcza"}, + {"_encja": "WNIOSEK", "lokalizacja_tekst": "Alfa", "moc_wprowadzana": 2500.0, + "status_procesu": "WARUNKI_WYDANE"}, + {"_encja": "WNIOSEK", "lokalizacja_tekst": "Gamma", "moc_wprowadzana": 500.0, + "status_procesu": "WARUNKI_WYDANE"}, + ] + df = pd.DataFrame(rows) + L = node_loading(assign_to_nodes(df, station_node_map(df)), pole_mocy="moc_wprowadzana") + fig = plots.plot_node_loading(L) + title = fig.axes[0].get_title(loc="left") + assert "median 2.500" in title and "1 node with zero free capacity" in title + + +def test_save_all_and_cli_plot(tmp_path, panel, capsys): + p = tmp_path / "panel.parquet" + panel.to_parquet(p, index=False) + assert cli.main(["plot", str(p), "--out", str(tmp_path / "figs"), "--format", "png,svg", + "--min-n", "10"]) == 0 + out = json.loads(capsys.readouterr().out) + assert "field_coverage" in out["zapisane"] + assert (tmp_path / "figs" / "quality_rules.svg").exists() + assert any("node_loading" in s for s in out["pominiete"]) + + +def test_cli_compare(tmp_path, capsys): + a, b = _editions() + pa, pb = tmp_path / "a.parquet", tmp_path / "b.parquet" + a.to_parquet(pa, index=False) + b.to_parquet(pb, index=False) + assert cli.main(["compare", str(pa), str(pb), "--transitions", + str(tmp_path / "tr.csv")]) == 0 + out = json.loads(capsys.readouterr().out) + assert out["porownanie"]["wspolnych"] == compare_editions(a, b).wspolnych + assert (tmp_path / "tr.csv").exists()