Warning
This package is in an early stage of development so features may change or be removed. If using this package it is recommended to set a specific version and check before upgrading to a new version.
Visualisation functionality and tools for transport related data.
Tip
For more detailed information including a user guide, tutorials and API reference see the full caf.viz documentation
Important
This section of the README hasn't been written yet, but it will contain a brief description of what the tool is intended to do.
- Simplified 2D graphs - wrappers around matplotlib to simplify the creation of basic 2D plots (scatter, line and hexbin) and to simplify the creation of figures with multiple Axes.
- TfN Stylesheet - custom stylesheet for matplotlib using TfN's colour scheme.
- Static Heatmaps - wrapper around GeoPandas and matplotlib to simplify the creation of heatmap images (see #24).
Warning
These features are work-in-progress and are not available in a released version of caf.viz, to access these features a specific branch of caf.viz should be installed, see Installation from GitHub.
- Target audience: GIS Analysts, Transport Analysts, Data Analysts
- CAF Analytical Stage: Analysis, Appraisal, Evaluation
For more details on CAF Analytical Stages see the description within TfN's GitHub homepage
The latest released version are available at the Python Package Index (PyPI) and on Conda.
conda install -c conda-forge caf.vizpip install caf.vizTip
- See the Quick Start Guide for more detailed instructions.
- See the requirements.txt for the full list of package dependencies.
Warning
Unreleased GitHub versions should not be considered stable.
The latest, unreleased, version can be installed directly from GitHub using:
pip install "git+https://github.com/transport-for-the-north/caf.viz"Tip
pip install can install a specific tag, or branch, using @{tag-name}
after the git URL.
CAF.viz doesn't currently provide a CLI or GUI so should be called from Python to use, see the Tool Usage section of the user guide for more details.
The code documentation is hosted at https://cafviz.readthedocs.io/en/stable/.
This tool is part of TfN's Common Analytical Framework (CAF). CAF is Transport for the North's structured suite of analytical tools designed to support transport modelling, appraisal, and strategic decision-making.
More information on CAF and details on other CAF tools can be found on TfN's GitHub Homepage.
We encourage use of, and contributions to, the repositories within this organisation, licenses are provided within the repositories and the organisation contribution guide provides details for contributions.
For further information about using this tool or CAF tools in your projects and work contact Transport for the North - TfNOffer@transportforthenorth.com