cview
, pronounced "sea view", 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!
Caution
cview
only works with Calliope 0.7 or higher. If you are running Calliope 0.6 or lower, use the built-in visualisation tools instead.
- Install a version of Calliope >= 0.7
- In the Python environment in which Calliope >= 0.7 is installed, run:
pip install git+https://github.com/calliope-project/cview.git#egg=cview
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 cview
in the command line:
$ cview your_model_results.nc
This launches the cview
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:
import calliope
m = calliope.examples.urban_scale(time_subset=None)
m.run()
m.to_netcdf("urban_scale.nc")
Then:
$ cview urban_scale.nc
- The page layout is inflexible and particularly suboptimal on the maps page. This will be improved once Panel 1.4.1 is available with a fix for #6653.
- If left running for a while with no interaction, the web interface may become unresponsive and has to be refreshed manually.
- Code is badly documented and needs some cleaning up.