Skip to main content

A Python script to visualize blood pressure data.

Project description

BP Diag parses blood preasure statistics from data files, generates some statistics and prints them to STDERR. You can export the data (and the gathered statistics) to JSON (dump to STDOUT). And you can also generate SVG or PNG charts from it.

To see a list of possible command line options run: --help


Lets say we got a file called bp.csv containing the following values:

136/83/65, 132/82/70
144/82/86, 137/81/75, -,         143/80/68
131/82/60, 144/82/64, 136/79/67, 140/80/62
136/83/68, 138/80/99, -,         133/74/65
136/79/67, 131/76/64, 135/81/72, 136/75/61

BP Diag first tries to split multiple entries on each line using the string given with the --delimiter option (default is ,). Each entry found is then split into sys, dia and pulse values with the string given with the --seperator option (default: /).

So if we run BP Diag on the file like this bp.csv, we got the following results:

Read 17 value(s) from 1 file(s)...
Statistics (min, max, avg):
:: SYS...: 127, 144, 136
:: DIA...:  74,  83,  79
:: PULSE.:  60,  99,  69


As you see parsing errors are ignored. We can dump JSON with the --json option. Only the JSON dump is written to STDOUT, other output goes to STDERR, so we can redirect the dump to a file (use --compact to prevent spaces after , and :): --json --compact bp.csv > bp.json

The file bp.json will then contain one long line with the JSON data. You can also dump the statistic gatherd from the data to JSON with the --json- stats option. Use the --sort and --indent 2 options if you want a more readable output.

Generate Charts

To generate SVG charts, you need to have PyGal installed (see below). Other than that, just use the --chart option to have a chart called bp.svg generated in your current directory. There are more options to this, take a look at the --help output.

Instead of the interactive SVG charts you can use PNG as output format. Just use the --png option along with --chart. You need a couple more dependencies for that though, take a look below.

Number of measurements per line

Per default all values are gathered one after the other and parsing errors are ignored. But you can use the --entries option to set a fixed number of measurements per line.

What this means is that only that much values are used per line (even if there are more) and if a line contains less than entries values, the remaining ones are filled with None values. Also values that conatin - (or any other combination of characters that does not parse to a three integer tuple) are not ignored but stored as a None value too.

This can be helpful in cases where you have a given number of measurements per line and you want to keep them aligned even if sometimes a measurement is skipped / missing.: --json --compact --entries 4 bp.csv

Will result in the following JSON:



You can install BP Diag with pip or from source.

Install with pip

pip is “a tool for installing and managing Python packages”. If you don’t have it installed, see the pip install instructions:

pip install --user bpdiag

Install from source

You can fetch the latest sourceball from github and unpack it, or just clone this repository: git clone git:// If you got the source, change into the directory and use

python install


PyGal is used to generate the charts. If you want to generate charts, you need to install it. With pip it’s as easy as this:

pip install --user pygal

If you want to export to PNG files, you need CairoSVG, tinycss and cssselect too. You can install them like this:

pip install --user CairoSVG tinycss cssselect

Bugs and Contribution

BP Diag is at home at:

If you find any bugs, issues or anything, please use the issue tracker.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bpdiag-0.3.tar.gz (20.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page