diff --git a/README.md b/README.md index 5736304..3dbf149 100644 --- a/README.md +++ b/README.md @@ -203,7 +203,9 @@ gridqueue parse --out panel.parquet python examples/research_use_case.py panel.parquet ``` -The result on the panel of six publishers (median, days): **consumption** connections 40 at TAURON +The result on the panel, as the median number of days over RESOLVED applications only, since an +application still awaiting a decision is a censored observation and not a short one: **consumption** +connections 40 at TAURON and 57 at ENERGA, **photovoltaics** 105 and 127, **energy storage** 119 and 146, **wind** 156 and 158. Consumption connections are processed two to four times faster than generating ones, and the difference between publishers persists within a class. This is a descriptive result: the register describes @@ -293,10 +295,14 @@ detected by comparing the output with the reference set read from the document. * The location at TAURON is an internal substation code; the operator does not publish a dictionary of the codes, so the resolver returns missing with the reason `station_code_without_dictionary`. It does not guess. -* **None of the publishers reports coordinates.** The `coordinates` field is populated by - derivation from the place name against a gazetteer with geometry (13,149 names in 25 localities): - 1,225 of 19,220 panel rows. The evidential value of this field is therefore different from that of - the fields transcribed from the document, and it is described as such in the result. +* **Coordinates come from two different origins and the difference matters.** Two publishers, + ESB Networks and e-Distribucion, disclose them directly, which covers 48,363 rows. The Polish + publishers do not, so for them the `coordinates` field is populated by derivation from the place + name against a gazetteer with geometry (13,149 names in 25 localities), which covers 1,225 further + rows. Coordinates are present in 49,588 of 68,054 panel rows, that is 72.9 per cent. The evidential + value of a derived point differs from that of a disclosed one, and from that of the fields + transcribed from the document, so every resolution records a confidence level and a placement + accuracy level and the result states which origin a point has. * A street name does not determine a point: 431 of 6,057 Warsaw names (7.12%) have disjoint components more than 2 km apart. The register gives the street but not the district, so **this ambiguity cannot be removed from the published data**. Every result carries the number of components and their spread, diff --git a/docs/colab.md b/docs/colab.md index 0b3da75..5645389 100644 --- a/docs/colab.md +++ b/docs/colab.md @@ -7,8 +7,9 @@ title: Google 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) The notebook `notebooks/gridqueue_colab.ipynb` removes the installation barrier: a reviewer or an -analyst at the regulator runs the full workflow without installing anything, without an account and -without an accelerator. +analyst at the regulator runs the full workflow without installing anything and without an +accelerator. A Google account is needed to execute a notebook in Colab, which is a requirement of +that service and not of the package; the same notebook runs locally in Jupyter without one. ## What the notebook does diff --git a/docs/index.md b/docs/index.md index f8a9f83..d839914 100644 --- a/docs/index.md +++ b/docs/index.md @@ -37,17 +37,23 @@ ranking of locations, it contains no model of preferences. | publisher | rows in panel | fields from disclosure | fields including the derived one | |---|---:|---:|---:| +| ESB Networks DAC | 46527 | 7 | 7 | | TAURON Dystrybucja S.A. | 10955 | 15 | 15 | | ENERGA-OPERATOR S.A. | 5382 | 17 | 17 | +| e-Distribución Redes Digitales S.L.U. | 1838 | 9 | 9 | | Stoen Operator Sp. z o.o. | 1236 | 13 | 14 | | PSE S.A. | 945 | 17 | 17 | | National Grid Electricity Distribution | 694 | 10 | 10 | +| E-REDES S.A. | 469 | 6 | 6 | | Boryszew Green Energy&Gas Sp. z o.o. | 8 | 8 | 9 | -**All 21 schema fields are populated in the panel.** The coordinate field is not disclosed by any -publisher and arises by derivation from the place name, which is why the table separates the fields +**All 21 schema fields are populated in the panel.** The coordinate field is disclosed directly by +two publishers, ESB Networks and e-Distribucion, which together account for 48,363 rows. For the +Polish publishers it is not disclosed and arises by derivation from the place name, which covers +1,225 further rows; those two origins are kept apart, which is why the table separates the fields coming from the disclosure from the derived field, and why the result of every resolution records a -confidence level and a placement accuracy level. +confidence level and a placement accuracy level. Coordinates are present in 49,588 of 68,054 rows, +that is 72.9 per cent. ## Pages