spiref 1.0.3

This package contains the reference value calculator for spirometry

Reference Value Calculator

This package contains the reference value calculator for spirometry. Install the packages from the requirements file in order for the calculator to work. The Excel files are used for computing the reference values.

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:

import sys
sys.path.insert(0, 'NHANESIII')
from NHANESIII.nhanes3 import NHANESReferenceValueCalculator

# Load the calculator
rvc = 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:

import sys
sys.path.insert(0, 'GLI12')
from GLI12.gli12 import GLIReferenceValueCalculator

# Load the calculator
rvc = 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')