This is a command line tool that can be used to get relative percentiles for individuals based on sex, age, and relative vo2 max scores. The percentiles are based on equations gathered from the following sources:
- University of Kansas Medical Center
- Saarland University
- Note: su sources only support age ranges of 22-75 and relative vo2 max scores between 11-61
Install tool:
pip install git+https://github.com/zkhan12/vo2app.git
Clone repo:
git clone https://github.com/zkhan12/vo2app.git
Enter repo:
cd vo2app
Install tool:
pip install .
The tool will need to be reinstalled whenever a a pull is made from the repo, to update run git pull origin master
followed by pip install .
Run the command below to get percentile outputs, note outputfile
and datasource
are optional parameters, for more info run voconv -h
voconv <inputfile> <outputfile> <datasource>
By default all output files will be stored in the directory where voconv is called unless a specified location is given. The default data source is KUMC.
voconv -i ./sample.csv
Produces a .csv file with the current date as the file name
voconv -i ./sample.csv -o ./output.csv -s su
Produces an output file called output.csv
in the same directory as where the command is called and uses the Saarland University data to generate percentiles.
The inputfile must be a csv. If the input file contains a header, it must have sex, age, and vo2 columns, in any order. If it contains no header, the order is assumed to be sex, age, and vo2, in that order. For the sex column, all values must be either [m, Male, MALE, M] or [f, Female, FEMALE, F]. Other values in the sex column will not be processed. Below is a possible sample format for the input file.
sample.csv
sex,age,vo2
m,22,35.1
m,45,35.72
f,25,30.3
m,44,38.05