Documentation

You can find the documentation for Rijksplotlib on our GitLab pages

Installation

To install the rijksplotlib package, you need to have Python 3.10 or higher installed.

pip install rijksplotlib

Want to install the Pylint rules included in rijksplotlib in your CI/CD pipeline? Have a look at the CI/CD setup guide.

git clone https://gitlab.com/rwsdatalab/public/codebase/tools/rijksplotlib.git
cd rijksplotlib
pip install .

pip install ".[dev]"
pytest

pip install ".[doc]"
make --directory=doc html # if using Windows use .\doc\make.bat html

Getting started

Plot your figure in the way you are used to. Then, use rlt.show() or rlt.savefig instead of using plt.show() or plt.savefig() to show or save the figure.

import rijksplotlib.pyplot as rlt

# plot your graph here #

rlt.show()
# or #
rlt.savefig()

This package helps you optimize your figures for RWS reports. Using the rijksplotlib.pyplot.show or rijksplotlib.pyplot.savefig helper functions, it provides feedback when you are missing elements necessary for a good figure. Furthermore, the resulting figure fits precisely within the RWS report preset margins. When you place your figure in a report, the font sizes of all elements are readable and fit in with the rest of the text well.

For more background information on making representative and good figures, see the Stijlgids Datavisualisatie RWS (intranet).

License

Copyright 2023 Rijkswaterstaat

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.