Creating chart revisions

This tutorial might be partial or incomplete. Please check with the team if you have questions.

Once a dataset is available on the Grapher database, you can create charts from its variables. In some cases, the dataset is a newer version from an already existing one. In such cases, we have to update the charts that rely on variables from the old dataset.

To this end, we use walkthrough charts. This tool will guide you through the whole process of creating chart revisions.

Chart revision

Charts at Our World in Data are based on a config file, which contains several configuration parameters (variable IDs in use, title, subtitle, etc.). The walkthrough charts creates a new configuration, based on the new dataset. This new configuration still needs some human revision. That is, needs revision.

To start creating your chart revisions, run

poetry run walkthrough charts

This should open the webapp in localhost:8082.

To generate the chart revisions, the tool needs to know how variables in the old dataset map to the ones in the new one. To this end, the tool will ask you which is the dataset being updated (old and new one) and how each variable is mapped.

Explore mode

Under the expandable window "Parameters", check the "Explore variable mappings" option to display variable comparisons on the fly.

Once you have finished, your chart revisions are submitted to the Grapher database, and are ready to be reviewed from the admin.

Info

All chart suggestions are stored in the grapher database table suggested_chart_revisions.