Spiref: Spirometry Reference Value Calculator

This package contains the reference value calculator for spirometry. Can be installed immediately using pip:

pip install spiref

Currently supported:

• NHANES III
• GLI-2012 (https://www.ers-education.org/lrMedia/2013/pdf/266709.pdf)

Parameters:

• sex: either 'male' or 'female'.
• height: the height of the person in centimeter.
• age: the age in years.
• race: different options for NHANES III and GLI-2012 (see below).

NHANES III

Race options for NHANES III: 'Cau', 'AfrAm', 'MexAm' (Causasian, African-American or Mexican-American).

GLI-2012

Either the general calculation function (calc_lung_param) or the specific calculation functions (analogue to the NHANES calculator) can be used. Use the function calc_lln_lung_param with the same parameters as calc_lung_param to compute the lower limit of normal (LNN or 5th percentile).

Possible lung parameters are: 'FEV1', 'FVC', 'FEV1FVC', 'FEF2575', 'FEF75'.

Race options for GLI-2012: 'Cau', 'AfrAm', 'NEAsia', 'SEAsia', 'other' (Caucasian, African-American, North-East Asia, South-East Asia, other).

Usage

For NHANES III:

from spiref import nhanes3

# Load the calculator
rvc = nhanes3.NHANESReferenceValueCalculator()

# Use the calculator to compute FEV1 for a male of height 174cm, age 28 of the African-American race.
fev1 = rvc.calculate_fev1('male', 174, 28, race='AfrAm')

For GLI12:

from spiref import gli12

# Load the calculator
rvc = gli12.GLIReferenceValueCalculator()

# The general calculator function:
fev1 = rvc.cal_lung_param('FEV1', 'male', 174, 28, 'AfrAm')  # African-American male, height 174 cm, age 28
# Same can be achieved with the specific FEV1 function:
fev1 = rvc.calculate_fev1('male', 174, 28, race='AfrAm')

# Computing the lower limit of normal (5th percentile)
fev1_lln = rvc.calc_lln_lung_param('FEV1', 'male', 174, 28, 'AfrAm')