The Lung Tracker is freely available for software implementation to visualize lung function data.
This tool is intended for research and educational purposes and should not be used for patient treatment. The resulting plot should be interpreted in conjunction with other clinical and medical data.
For treatment and diagnostic purposes, please utilize the GLI reference equations as implemented by medical device companies.
This documentation outlines the usage of web-based calculators for single- or multi-record individual lung function trajectory and individual reference lines. The lung tracker function offers individual lung function trajectory charts that display raw values or GLI-based z-scores, covering ages 4 to 90. It is specifically designed for visualizing the lung function trajectory of a single participant at a time. Additionally, the lung tracker provides a growth chart for lung function, spanning ages 4 to 25, with a fixed age range for output. Users also have the flexibility to customize the age range for their output plots.The report also incorporates a height chart, providing additional contextual data to support comprehensive analysis.
Fill out the form on the left side of the page, providing measurements obtained from the individual. Refer to the list below for the mandatory input values for each test. The system will prompt you if any required information is missing or if errors are detected.
Prepare your Excel or Text file (.csv, .xls, .xlsx or .txt) containing the mandatory and lung function parameters for the participants. Upload the file to the dedicated input field located on the left side of the calculator page.
All the test points (outlined below) are utilized for the lung function tracker. Therefore, when preparing your Excel or Text file, ensure to include the mandatory variables: age(year),age(month), height, sex,ethnicity, measure spirometry type and at least one lung function parameters. Refer to the variables documentation below for details on optional input values. Ethnicity is a crucial variable for calculating reference lines, and valid values are specified below. Please use the column names in your Excel or text file as specified below.
Whenever possible, use fractional ages (in years and months) for pediatric cases to improve calculation accuracy while avoiding duplication of age information. Additionally, you can label the figure with either percentiles or standard deviation scores, placing the lower limit accordingly. Users can also select the graph display option—pre, post, both, or best—on the left side of the page.
Please be aware that for modern browsers like Chrome, Firefox, Safari, IE 10+, and Edge, no data will be written to the server. However, for IE 9 and below, a results file will be generated and automatically deleted within 24 hours.
Keep in mind that missing values on non-mandatory variables are replaced by NA values and will be skipped in the output.
The general data provided for the lung function tracker is regularly updated at the bottom of the table. It becomes visible in the output when downloaded using the “Download” button. You can conveniently print the table contents along with the plots in PDF format.
Mandatory variables include Age(year),Age(month), Height, Sex, Ethnicity, measure spirometry type, and at least one lung function parameter at each measurement.
Variable | Description | Type | Range |
---|---|---|---|
Age(year) | Age (years) at the time of each measurement | Integer | 4-90 |
Age(month) | Age (years) at the time of each measurement | Integer | 0-11 |
Height | Height (cm) at the time of each measurement | Decimal | 50-230 |
Sex | Participant’s sex (Male=1, Female=2) | String | 1,2 |
Ethnicity | Ethnicity (Race-neutral=1, Caucasian=2, African American=3,North East Asian=4, South East Asian=5, Other or Mixed=6) | String | 1,2,3,4,5,6 |
FEV1 | Forced Expiratory Volume (1 sec) measured during spirometry (L) | Decimal | 0-10 |
FVC | Forced Vital Capacity measured during spirometry (L) | Decimal | 0-10 |
spirometry | measure spirometry type | Binary | pre or post |
Example data input file format:
Age(year) | Age(month) | Height | Sex | Ethnicity | FEV1 | FVC | Spirometry |
---|---|---|---|---|---|---|---|
6 | 8 | 120.9 | 1 | 1 | 1.16 | 1.24 | pre |
6 | 8 | 120.9 | 1 | 1 | 1.1 | 1.2 | post |
11 | 4 | 142 | 1 | 1 | 1.8 | 1.94 | pre |
11 | 4 | 142 | 1 | 1 | 1.6 | 1.7 | post |
14 | 0 | 150 | 1 | 1 | 2.01 | 2.16 | pre |
14 | 0 | 150 | 1 | 1 | 1.98 | 2 | post |
Erik Melén, Rosa Faner, James P Allinson, Dinh Bui, Andrew Bush, Adnan Custovic, Judith Garcia-Aymerich, Stefano Guerra, Robab Breyer-Kohansal, Jenny Hallberg, Lies Lahousse, Fernando D Martinez, Simon Kebede Merid, Pippa Powell, Hilary Pinnock, Sanja Stanojevic, Lowie E G W Vanfleteren, Gang Wang, Shyamali C Dharmage, Jadwiga Wedzicha, Alvar Agusti, CADSET Investigators. Lung function trajectories: relevance and implementation in clinical practice. Lancet. Published online March 12, 2024.
Publication metrics
Dimensions Badge
Altmetric
This work was supported by ERS CADSET collaboration, Swedish Research Council, Swedish Heart-Lung Foundation, European Research Council, Karolinska Institutet, and Södersjukhuset.