{ "_id": "6ae6accf818c9e3ef6dbb369", "Package": "pft", "Type": "Package", "Title": "Reference Values and Interpretation for Pulmonary Function Tests", "Version": "1.0.4", "Authors@R": "c(\nperson(given = \"Pat\", family = \"Johnson\", email = \"johnson.pat@mayo.edu\",\nrole = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0001-8365-1375\")),\nperson(given = \"Scott\", family = \"Helgeson\",\nrole = \"aut\",\ncomment = c(ORCID = \"0000-0001-7590-2293\")),\nperson(given = \"Zach\", family = \"Quicksall\",\nrole = \"ctb\"),\nperson(given = \"Jairo\", family = \"Pena\",\nrole = \"ctb\")\n)", "Description": "Computes predicted values and lower/upper limits of normal\nfor pulmonary function tests according to American Thoracic\nSociety (ATS) and European Respiratory Society (ERS) reference\nstandards. Supports spirometry (Global Lung Function Initiative\nGLI 2012, Quanjer et al. (2012)\n; and the race-neutral GLI 2022\n/ GLI Global equations, Bowerman et al. (2023)\n), static lung volumes (GLI\n2021, Hall et al. (2021) ),\nand the carbon monoxide transfer factor / diffusion capacity\n(GLI 2017, Stanojevic et al. (2017)\n, including the 2020 author\ncorrection ). Also assigns\ninterpretive pattern labels (Normal, Non-specific, Obstructed,\nRestricted, Mixed) from spirometry and lung-volume measurements\nfollowing the ERS/ATS 2022 interpretation algorithm, Stanojevic\net al. (2022) .", "License": "MIT + file LICENSE", "URL": "https://github.com/overdodactyl/pft", "BugReports": "https://github.com/overdodactyl/pft/issues", "Encoding": "UTF-8", "LazyData": "true", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.2", "VignetteBuilder": "knitr", "Config/testthat/edition": "3", "Repository": "https://overdodactyl.r-universe.dev", "Date/Publication": "2026-11-01 01:51:20 UTC", "RemoteUrl": "https://github.com/overdodactyl/pft", "RemoteRef": "HEAD", "RemoteSha": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "NeedsCompilation": "no", "Packaged": { "Date": "2026-11-01 03:02:39 UTC", "User": "root" }, "Author": "Pat Johnson [aut, cre] (ORCID: ),\nScott Helgeson [aut] (ORCID: ),\nZach Quicksall [ctb],\nJairo Pena [ctb]", "Maintainer": "Pat Johnson ", "_user": "overdodactyl", "_type": "src", "_file": "pft_1.0.4.tar.gz", "_fileid": "https://r2.ropensci.org/7537255545644f9d001d46440c74d422a074f3f2d23c3126bfa02e859b3d4b73", "_filesize": 1003603, "_sha256": "7537255545644f9d001d46440c74d422a074f3f2d23c3126bfa02e859b3d4b73", "_expires": "2027-02-09T03:06:53.000Z", "_created": "2026-11-01T03:02:39.000Z", "_published": "2026-11-01T03:06:54.915Z", "_upstream": "https://github.com/overdodactyl/pft", "_status": "success", "_maintainer": { "name": "Pat Johnson", "email": "johnson.pat@mayo.edu", "login": "overdodactyl", "description": "Data Scientist and Developer", "uuid": 33071129, "orcid": "0000-0001-8365-1375" }, "_jobs": [ { "job": 124733518967, "time": 135, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "13068336678" }, { "job": 124733519036, "time": 171, "config": "linux-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "13067522424" }, { "job": 124733519029, "time": 213, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "13067413976" }, { "job": 124733519046, "time": 198, "config": "macos-release-arm64", "r": "4.6.2", "check": "OK", "artifact": "13067497359" }, { "job": 124732789246, "time": 224, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "13067542062" }, { "job": 124733518947, "time": 107, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "13067787891" }, { "job": 124733519080, "time": 109, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "13067568387" }, { "job": 124733519005, "time": 95, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "13067753066" }, { "job": 124733519001, "time": 69, "config": "windows-release-x86_64", "r": "4.6.2", "check": "OK", "artifact": "13067588307" } ], "_buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398", "_commit": { "id": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "author": "Pat Johnson ", "committer": "Pat Johnson ", "message": "docs(zenodo): pin CITATION and README to v1.0.4 Zenodo DOI\n", "time": 1793497880 }, "_distro": "resolute", "_host": "GitHub-Actions", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.1", "role": "Depends" }, { "package": "rlang", "role": "Imports" }, { "package": "tibble", "role": "Imports" }, { "package": "broom", "role": "Suggests" }, { "package": "covr", "role": "Suggests" }, { "package": "dplyr", "role": "Suggests" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" } ], "_owner": "overdodactyl", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-21", "n": 50 }, { "week": "2026-22", "n": 96 }, { "week": "2026-27", "n": 12 }, { "week": "2026-28", "n": 2 }, { "week": "2026-37", "n": 3 }, { "week": "2026-44", "n": 3 } ], "_tags": [ { "name": "v1.0.0", "date": "2026-07-04" }, { "name": "v1.0.1", "date": "2026-07-04" }, { "name": "v1.0.2", "date": "2026-09-07" }, { "name": "v1.0.3", "date": "2026-09-07" }, { "name": "v1.0.4", "date": "2026-11-01" } ], "_stars": 0, "_contributors": [ { "user": "overdodactyl", "count": 208, "uuid": 33071129 } ], "_userbio": { "uuid": 33071129, "type": "user", "name": "Pat Johnson", "followers": 55, "description": "Data Scientist and Developer" }, "_downloads": { "count": 278, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/pft" }, "_devurl": "https://github.com/overdodactyl/pft", "_searchresults": 8, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/pft.html", "extra/readme.html", "extra/readme.md", "LICENSE" ], "_homeurl": "https://github.com/overdodactyl/pft", "_realowner": "overdodactyl", "_cranurl": true, "_releases": [ { "version": "1.0.1", "date": "2026-07-11" } ], "_exports": [ "as_tibble", "pft_bdr", "pft_bdr_2005", "pft_change", "pft_classify", "pft_diffusion", "pft_diffusion_interpret", "pft_dlco_hb_correct", "pft_fev1q", "pft_gold", "pft_interpret", "pft_long", "pft_plot", "pft_prism", "pft_quality", "pft_severity", "pft_severity_2005", "pft_spirometry", "pft_volume_subpattern", "pft_volumes" ], "_datasets": [ { "name": "pft_example", "title": "Synthetic example PFT cohort", "object": "pft_example", "class": [ "tbl_df", "tbl", "data.frame" ], "fields": [ "patient_id", "sex", "age", "height", "race", "fev1_measured", "fvc_measured", "fev1fvc_measured", "tlc_measured", "fev1_pre", "fev1_post" ], "rows": 20, "table": true, "tojson": true } ], "_help": [ { "page": "pft_bdr", "title": "Bronchodilator response per the ERS/ATS 2022 criterion", "topics": [ "pft_bdr" ] }, { "page": "pft_bdr_2005", "title": "Bronchodilator response per the Pellegrino 2005 standard", "topics": [ "pft_bdr_2005" ] }, { "page": "pft_change", "title": "Conditional change score for serial PFT measurements", "topics": [ "pft_change" ] }, { "page": "pft_classify", "title": "Classify ATS spirometry patterns from spirometry and lung-volume measurements", "topics": [ "pft_classify" ] }, { "page": "pft_diffusion", "title": "Compute carbon monoxide diffusion capacity or transfer factor reference values for given demographics", "topics": [ "pft_diffusion" ] }, { "page": "pft_diffusion_interpret", "title": "Classify a diffusion result into a clinical pattern category", "topics": [ "pft_diffusion_interpret" ] }, { "page": "pft_dlco_hb_correct", "title": "Adjust a measured DLCO / TLCO for the patient's hemoglobin", "topics": [ "pft_dlco_hb_correct" ] }, { "page": "pft_example", "title": "Synthetic example PFT cohort", "topics": [ "pft_example" ] }, { "page": "pft_fev1q", "title": "FEV1Q: ratio of FEV1 to a sex-specific survivable lower limit", "topics": [ "pft_fev1q" ] }, { "page": "pft_gold", "title": "GOLD 2026 spirometric airflow-limitation grade", "topics": [ "pft_gold" ] }, { "page": "pft_interpret", "title": "One-call ATS/ERS PFT interpretation workflow", "topics": [ "pft_interpret" ] }, { "page": "pft_long", "title": "Pivot a 'pft_result' to long form", "topics": [ "pft_long" ] }, { "page": "pft_plot", "title": "Clinical visualisation for a single PFT result", "topics": [ "pft_plot" ] }, { "page": "pft_prism", "title": "Screen for Preserved Ratio Impaired Spirometry (PRISm)", "topics": [ "pft_prism" ] }, { "page": "pft_quality", "title": "Compute the ATS/ERS 2019 spirometry session grade from maneuvers already judged acceptable", "topics": [ "pft_quality" ] }, { "page": "pft_severity", "title": "Grade severity of lung function impairment from a z-score", "topics": [ "pft_severity" ] }, { "page": "pft_severity_2005", "title": "Severity grading per the Pellegrino 2005 standard", "topics": [ "pft_severity_2005" ] }, { "page": "pft_spirometry", "title": "Compute spirometry reference values for given demographics", "topics": [ "pft_spirometry" ] }, { "page": "pft_volume_subpattern", "title": "Classify lung-volume sub-pattern per Stanojevic 2022 Figure 10", "topics": [ "pft_volume_subpattern" ] }, { "page": "pft_volumes", "title": "Compute lung volume reference values for given demographics", "topics": [ "pft_volumes" ] } ], "_pkglogo": "https://github.com/overdodactyl/pft/raw/HEAD/man/figures/logo.png", "_readme": "https://github.com/overdodactyl/pft/raw/HEAD/README.md", "_rundeps": [ "cli", "glue", "lifecycle", "magrittr", "pillar", "pkgconfig", "rlang", "tibble", "utf8", "vctrs" ], "_vignettes": [ { "source": "diffusion-capacity.Rmd", "filename": "diffusion-capacity.html", "title": "Diffusion capacity (DLCO / TLCO): reference, Hb correction, interpretation", "engine": "knitr::rmarkdown", "headings": [ "1. Reference values", "Choosing the unit system", "Source population", "Example", "2. Hemoglobin correction", "3. Clinical sub-pattern (Hughes & Pride 2012)", "4. How VA shapes the classifier output", "5. Cohort-level diffusion summaries", "See also" ], "created": "2026-05-25 05:34:00", "modified": "2026-11-01 01:22:09", "commits": 7 }, { "source": "pft.Rmd", "filename": "pft.html", "title": "Getting started with pft", "engine": "knitr::rmarkdown", "headings": [ "1. Reference values from demographics alone", "2. Z-scores and percent predicted from measured values", "3. Severity grading", "4. ATS pattern classification", "5. Bronchodilator response", "6. PRISm screening", "7. Serial change", "8. The one-call workflow", "9. Visualisation", "10. Cohort analyses", "11. Long-form tidier for downstream analysis", "12. Diffusion clinical category", "Citations" ], "created": "2026-05-23 22:06:33", "modified": "2026-11-01 01:22:09", "commits": 16 }, { "source": "glossary.Rmd", "filename": "glossary.html", "title": "Glossary", "engine": "knitr::rmarkdown", "headings": [ "Measure abbreviations", "Statistical terms", "Patterns and clinical entities", "Tests and gradings", "Notation: the 4-character pattern combination", "Race / ancestry categories (GLI 2012 only)", "Common validation errors" ], "created": "2026-05-24 02:07:31", "modified": "2026-11-01 01:22:09", "commits": 10 }, { "source": "input-format.Rmd", "filename": "input-format.html", "title": "Input data format", "engine": "knitr::rmarkdown", "headings": [ "Required vs. optional columns", "Units and types", "Precision and plausibility", "Using non-canonical column names", "Common errors" ], "created": "2026-05-24 17:20:53", "modified": "2026-11-01 01:22:09", "commits": 7 }, { "source": "interpretation-guide.Rmd", "filename": "interpretation-guide.html", "title": "Interpretation reference: severity bands, patterns, and standards", "engine": "knitr::rmarkdown", "headings": [ "Severity bands", "Pattern decision tree", "Choosing between the 2022 and 2005 interpretive standards", "Worked examples", "Example 1: low FEV1/FVC with low FEV1", "Example 2: low TLC with preserved KCO", "Example 3: PRISm without TLC", "Applying vector helpers inside a data-frame workflow", "See also" ], "created": "2026-05-25 05:29:52", "modified": "2026-11-01 01:22:09", "commits": 14 }, { "source": "longitudinal-analysis.Rmd", "filename": "longitudinal-analysis.html", "title": "Longitudinal PFT analysis: change and FEV1Q", "engine": "knitr::rmarkdown", "headings": [ "1. Two-point conditional change score: pft_change()", "2. FEV1Q in adults: pft_fev1q()", "3. Plotting trajectories", "See also" ], "created": "2026-05-25 05:32:10", "modified": "2026-05-25 21:16:07", "commits": 7 } ], "_score": 5.2552725051033065, "_indexed": true, "_nocasepkg": "pft", "_universes": [ "overdodactyl" ], "_previous": "1.0.3", "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "1.0.4", "date": "2026-11-01T03:04:51.000Z", "distro": "resolute", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/54259ad764e3c716129db75c3f1c78abc8b063c057ca81202712b6a95f70621f", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.6.1", "os": "linux", "version": "1.0.4", "date": "2026-11-01T03:05:24.000Z", "distro": "resolute", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/2d1465ee4979127d6f1498d3f9ee61e60e2bfe6e90a835d26b6e49185addcb6b", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.5.3", "os": "mac", "version": "1.0.4", "date": "2026-11-01T03:05:56.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/a74388f63447c50e87217b6c00e6d61f262e956e817306f0e41bb1ded8151f3a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.6.2", "os": "mac", "version": "1.0.4", "date": "2026-11-01T03:05:18.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/eacdc02316d2f86570084beddd33855cab13c0f6a70b4a1aa47dd8f5e8b41d82", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.6.0", "os": "wasm", "version": "1.0.4", "date": "2026-11-01T03:04:39.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/aa65e08140ef8a1736e2fdd92e404c98fef9de3b1aa3f15fe7f2e547060b56e4", "status": "success", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.7.0", "os": "win", "version": "1.0.4", "date": "2026-11-01T03:04:07.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/0771c21839d508f8f93c8ede63b6f7adff3a12deae7e9f356feb1635d73a4828", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.5.3", "os": "win", "version": "1.0.4", "date": "2026-11-01T03:03:54.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/ae084e813ba8f222f33571712e9d8777f76feafb04c8f0fec3ced740d30d46cc", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" }, { "r": "4.6.2", "os": "win", "version": "1.0.4", "date": "2026-11-01T03:03:42.000Z", "commit": "7489d487bb5bffd5418e66362ebeb0a7332c9916", "fileid": "https://r2.ropensci.org/fbe1601ae08c8709983fb4bfb4b52ada380963edc767f99ce65c6ba12a20ea71", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/overdodactyl/actions/runs/41267326398" } ] }