# Calligraph: Calliope model result graphing and visualisation tool
`Calligraph` is a tool to interactively explore and visualise Calliope model results.
> [!IMPORTANT]
> Note that this is pre-release software and there are likely to bugs. Please [report issues and feedback on GitHub](https://github.com/calliope-project/calligraph)!
> [!CAUTION]
> Calligraph only works with Calliope 0.7 or higher. If you are running Calliope 0.6 or lower, use the built-in visualisation tools instead.
## Installation
`pip install calligraph`
## Use
Save a solved Calliope model to a NetCDF file with `model.to_netcdf()` or by using the appropriate settings with the Calliope command-line interface. Then run `calligraph` in the command line:
```shell
$ calligraph your_model_results.nc
```
This launches Calligraph's web interface in the default web browser on your system. To use a custom port, supply the `--port PORTNUMBER` option; if you do not want the default web browser to open, specify `-nb` or `--no-browser`.
To experiment with the built-in urban-scale model:
```python
import calliope
m = calliope.examples.urban_scale(time_subset=None)
m.run()
m.to_netcdf("urban_scale.nc")
```
Then:
```shell
$ calligraph urban_scale.nc
```
Raw data
{
"_id": null,
"home_page": null,
"name": "calligraph",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Stefan Pfenninger <stefan@pfenninger.org>, Bryn Pickering <17178478+brynpickering@users.noreply.github.com>",
"keywords": "energy systems, visualisation",
"author": null,
"author_email": "Stefan Pfenninger <stefan@pfenninger.org>",
"download_url": "https://files.pythonhosted.org/packages/e6/5f/7701c8026638b33b5bbd9934efcba87cf0d707e6ca55d54c3f67cc344486/calligraph-0.1.1.dev7.tar.gz",
"platform": null,
"description": "# Calligraph: Calliope model result graphing and visualisation tool\n\n`Calligraph` is a tool to interactively explore and visualise Calliope model results.\n\n> [!IMPORTANT]\n> Note that this is pre-release software and there are likely to bugs. Please [report issues and feedback on GitHub](https://github.com/calliope-project/calligraph)!\n\n> [!CAUTION]\n> Calligraph only works with Calliope 0.7 or higher. If you are running Calliope 0.6 or lower, use the built-in visualisation tools instead.\n\n## Installation\n\n`pip install calligraph`\n\n## Use\n\nSave a solved Calliope model to a NetCDF file with `model.to_netcdf()` or by using the appropriate settings with the Calliope command-line interface. Then run `calligraph` in the command line:\n\n```shell\n$ calligraph your_model_results.nc\n```\n\nThis launches Calligraph's web interface in the default web browser on your system. To use a custom port, supply the `--port PORTNUMBER` option; if you do not want the default web browser to open, specify `-nb` or `--no-browser`.\n\nTo experiment with the built-in urban-scale model:\n\n```python\nimport calliope\nm = calliope.examples.urban_scale(time_subset=None)\nm.run()\nm.to_netcdf(\"urban_scale.nc\")\n```\n\nThen:\n\n```shell\n$ calligraph urban_scale.nc\n```\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Visualisation tool for Calliope.",
"version": "0.1.1.dev7",
"project_urls": {
"changelog": "https://github.com/calliope-project/calligraph/CHANGELOG.md",
"repository": "https://github.com/calliope-project/calligraph",
"website": "https://www.callio.pe/"
},
"split_keywords": [
"energy systems",
" visualisation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9584fe11049d7df1985e090f4cefb2354ebad439e522b73a3096278f16afc27e",
"md5": "0986c291badb0fd4d8f3676e23990de4",
"sha256": "e87a0af65be6897b5b8d19acb28bdc475ba9df9c495cad87885461c029314a1c"
},
"downloads": -1,
"filename": "calligraph-0.1.1.dev7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0986c291badb0fd4d8f3676e23990de4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 18483,
"upload_time": "2025-09-07T16:42:21",
"upload_time_iso_8601": "2025-09-07T16:42:21.859507Z",
"url": "https://files.pythonhosted.org/packages/95/84/fe11049d7df1985e090f4cefb2354ebad439e522b73a3096278f16afc27e/calligraph-0.1.1.dev7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e65f7701c8026638b33b5bbd9934efcba87cf0d707e6ca55d54c3f67cc344486",
"md5": "4b65737f9af7e32daaa5162a989d5566",
"sha256": "578343f8f2cf93d0e29690d3f4ca4371de40c81d4a3e08c8a1883339d397c361"
},
"downloads": -1,
"filename": "calligraph-0.1.1.dev7.tar.gz",
"has_sig": false,
"md5_digest": "4b65737f9af7e32daaa5162a989d5566",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 17654,
"upload_time": "2025-09-07T16:42:23",
"upload_time_iso_8601": "2025-09-07T16:42:23.100272Z",
"url": "https://files.pythonhosted.org/packages/e6/5f/7701c8026638b33b5bbd9934efcba87cf0d707e6ca55d54c3f67cc344486/calligraph-0.1.1.dev7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 16:42:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "calliope-project",
"github_project": "calligraph",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "calliope",
"specs": [
[
">=",
"0.7.0dev5"
]
]
},
{
"name": "panel",
"specs": [
[
">=",
"1.5.2"
]
]
},
{
"name": "plotly",
"specs": [
[
">=",
"5"
]
]
},
{
"name": "pyproj",
"specs": [
[
">=",
"3.6.1"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.1"
]
]
}
],
"lcname": "calligraph"
}
JSON
