{ "checker": { "claims": [ { "claim": "power-grid-model-io can be used for conversions to power-grid-model; the PGM JSON example converts tiny-net input and runs state estimation", "command": " nbconvert --to notebook --execute pgm_json_example.ipynb --output-dir ", "evidence": "Writing 20651 bytes to \n", "expected": "notebook executes and writes an output notebook", "input": "docs/examples/pgm_json_example.ipynb executed on data/tiny-net", "kind": "claim", "outcome": "Real input produced the expected result: Writing 20651 bytes to", "returncode": 0, "source": "`power-grid-model-io` can be used for various conversions to the", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "README Examples section links a PGM JSON example that runs", "command": " nbconvert --to notebook --execute pgm_json_example.ipynb --output-dir ", "evidence": "Writing 20651 bytes to \n", "expected": "notebook executes and writes an output notebook", "input": "pgm_json_example.ipynb executed on data/tiny-net", "kind": "claim", "outcome": "Real input produced the expected result: Writing 20651 bytes to", "returncode": 0, "source": "* [PGM JSON Example](https://github.com/PowerGridModel/power-grid-model-io/tree/main/docs/examples)", "source_checked": true, "source_file": "README.md", "verdict": "yes" } ], "cycle_checks": [ { "claim": "Scheduled or looping main behavior", "command": "", "evidence": "Inspected README.md, pyproject.toml (no [project.scripts]/entry points), docs and docs/examples. power-grid-model-io is a conversion library with no scheduler, cron, loop, webhook, --once or --now trigger; each conversion runs only when called by user code.", "expected": "identify the product trigger", "input": "source inspection", "kind": "cycle", "outcome": "Inspected README.md, pyproject.toml (no [project.scripts]/entry points), docs and docs/examples. power-grid-model-io is a conversion library with no scheduler, cron, loop, webhook, --once or --now trigger; each conversion runs only when called by user code.", "source": "repository entry points", "verdict": "yes" } ], "details": { "argv": [ "", "nbconvert", "--to", "notebook", "--execute", "pgm_json_example.ipynb", "--output-dir", "" ], "kind": "cli", "needs_browser": false, "needs_credentials": false, "returncode": 0, "scope": "product operation", "stderr": "[NbConvertApp] Converting notebook pgm_json_example.ipynb to notebook\n[IPKernelApp] WARNING | Kernel is running over TCP without encryption. All communication (including code and outputs) is sent in plain text and is susceptible to eavesdropping. Use IPC transport or launch with kernel manager-provisioned CurveZMQ keys to enable transport encryption.\n[NbConvertApp] Writing 20651 bytes to ", "stdout": "", "working": true }, "evidence_strength": "readme_checked", "example_checks": [ { "claim": "Run the documented PGM JSON example notebook end to end", "command": " nbconvert --to notebook --execute pgm_json_example.ipynb --output-dir ", "deferred": false, "evidence": "[NbConvertApp] Converting notebook pgm_json_example.ipynb to notebook\n[IPKernelApp] WARNING | Kernel is running over TCP without encryption. All communication (including code and outputs) is sent in plain text and is susceptible to eavesdropping. Use IPC transport or launch with kernel manager-provisioned CurveZMQ keys to enable transport encryption.\n[NbConvertApp] Writing 20651 bytes to ", "expected": "all cells run with zero error outputs and an output notebook is written", "input": "tiny-net input.json converted by PgmJsonConverter then state estimation", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "docs/examples/pgm_json_example.ipynb (README Examples section)", "verdict": "yes" }, { "claim": "Pandapower and Vision example notebooks from the README Examples section", "command": "", "deferred": false, "evidence": "not run: pandapower is not installed in the venv (README installs only power-grid-model-io); vision notebook was not executed in this run; only the PGM JSON example was run", "expected": "documented command completes successfully", "input": "", "kind": "example", "outcome": "not run: pandapower is not installed in the venv (README installs only power-grid-model-io); vision notebook was not executed in this run; only the PGM JSON example was run", "source": "docs/examples/pandapower_example.ipynb, docs/examples/vision_example.ipynb", "verdict": "blocked" } ], "status": "PASS" }, "deviations": [ "README has no CLI or console script; the only documented runnable operation is the docs/examples PGM JSON notebook, so it was executed with jupyter nbconvert on a copy outside the checkout to avoid rewriting tracked sample output files.", "nbconvert and ipykernel were installed as extra setup packages (not in the README) to execute the notebook.", "pandapower_example.ipynb and vision_example.ipynb were not executed (pandapower not installed; vision not run) and are recorded as blocked examples with reasons in examples.json.", "Installed the PyPI release (2.0.36) via the README command rather than building from the checked-out source." ], "fault_owner": null, "main_blocker": null, "operation": "Install power-grid-model-io from PyPI and run the documented PGM JSON example (tiny-net input converted with PgmJsonConverter, then state estimation, saved via converter.save)", "operation_scope": "Ubuntu 24.04 guest, Python 3.12.3 (meets requires-python >=3.12), venv at , uv available; no network data or credentials needed; pinned commit 449946b. Pandapower and Vision examples not run.", "outcome": "working", "plain_failure": null, "steps": [ "git init; git remote add origin https://github.com/PowerGridModel/power-grid-model-io; git fetch --depth 1 origin 449946be3bbdef1467cd7328dc01f29ff960bee3; git reset --mixed FETCH_HEAD", "python3 -m venv ", "VIRTUAL_ENV= uv pip install --python power-grid-model-io (README: uv pip install power-grid-model-io) -> installed power-grid-model-io 2.0.36", "uv pip install nbconvert ipykernel (setup, to execute the documented notebook)", "jupyter nbconvert --to notebook --execute pgm_json_example.ipynb --output-dir run in a copy of docs/examples under " ], "stuck_step": null, "suggested_fix": "None required for the tested path. Optionally add a documented CLI entry point or a runnable quickstart script; the README currently only covers installation and links to notebooks." }