Draw charts from terminal with psql and termgraph

💡 Open Data and charting in terminal

As a big fan of both Open Data, PostgreSQL, terminal tricks and data analysis, I wondered what kind of story I could tell on these topics.

Since one year now I feed an Open Data repo with COVID-19 from New-Caledonia :

adriens / covid19-action-plan-nc

Projet de gestion de mes tâches liées aux actions autour de la crise saniatire du COVD-19 en Nouvelle-Calédonie

covid19-action-plan-nc

Projet de gestion de mes tâches liées aux actions autour de la crise sanitaire du COVID-19 en Nouvelle-Calédonie

• Chifres quotidiens
• Vaccination

⚠️ Convention sur les données

Depuis le mercredi 08/09/2021, cf #64, les chiffres suivants ne sont plus communiqués :

• nb. de personnes en quatorzaine
• nb. de tests quotidiens

En conséquence, et afin de garantir l'intégralité du modèle de données :

• Lorsqu'un champ n'a pas la donné numérique : remplir avec -1
• Un nouveau fichier simplifié covid19-nc-cas-actifs_deces.csv a été créé et sera maintenu avec moins de colonnes : y sont consignés les cas confirmés, le nb. de décès, le nb. de premières et secondes injections

Réalisations

• Tableau de bord Power BI
• Interview explicative de la démarche
• Données sur Open Data Gouv fr
• Pétition pour ouverture des données en Open Data
• Google Trends de COVID-19 en Nouvelle Calédonie
• Scénario KataCoda de démo
• Présentation de la repo sur Youtube
• Race…

View on GitHub

To "celebrate" this full year of daily datas, I decided to implement something cool around it and thought about the following scenario :

👉 The plan

1. Git clone the Open Data COVID cases I feed everyday
2. Load the csv data in the PostgreSQL table with the COPY statement
3. Prepare some ready to use reporting views
4. Dump these views as csv files
5. Produce charts from the command line, for the command line with the help of a great and cool tool called termgraph :

mkaz / termgraph

a python command-line tool which draws basic graphs in the terminal

Termgraph

A command-line tool that draws basic graphs in the terminal, written in Python.

Graph types supported:

• Bar Graphs
• Color charts
• Multi-variable
• Stacked charts
• Histograms
• Horizontal or Vertical
• Emoji!

Examples

termgraph data/ex1.dat

# Reading data from data/ex1.dat

2007: ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 183.32
2008: ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 231.23
2009: ▇ 16.43
2010: ▇▇▇▇ 50.21
2011: ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 508.97
2012: ▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇ 212.05
2014: ▏ 1.00

An example using emoji as custom tick:

termgraph data/ex1.dat --custom-tick "🏃" --width 20 --title "Running Data"

# Running Data

2007: 🏃🏃🏃🏃🏃🏃🏃 183.32
2008: 🏃🏃🏃🏃🏃🏃🏃🏃🏃 231.23
2009:  16.43
2010: 🏃 50.21
2011: 🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃🏃 508.97
2012: 🏃🏃🏃🏃🏃🏃🏃🏃 212.05
2014:  1.00

An example using stdin and emoji:

echo "Label,3,9,1" | termgraph --custom-tick "😀" --no-label


😀😀😀 3.00
😀😀😀😀😀😀😀😀😀 9.00
😀 1.00

Most results can be copied and pasted wherever you like, since they use standard block characters. However the color charts will not show, since they use terminal escape codes for color. A couple images to…

View on GitHub

Also, to make it available even for non technical people.

I decided to implement it on Katacoda, so everyone can enjoy it from any web browser and look like a kind of hacker 😎

🎦 Demo