Wolfram Function Repository

Instant-use add-on functions for the Wolfram Language

Function Repository Resource:

 PulmonaryDiffusingCapacity

Source Notebook

Calculate the rate of transfer of CO gas from air in the lungs to the blood

Contributed by: Claudio Lobo Chaib Filho

ResourceFunction["PulmonaryDiffusingCapacity"][gender,age,height]

gives the pulmonary diffusing capacity of carbon monoxide for a specific gender,age and height.

ResourceFunction["PulmonaryDiffusingCapacity"][gender, age, height, out]

returns the output specified by out.

Details and Options

ResourceFunction["PulmonaryDiffusingCapacity"] measures the transfer of CO gas from air in the lungs to the red blood cells in lung blood vessels. The default output unit is milliliters of CO per minutes per millimeters of Mercury.
Gender (gender) can be given as an Entity or String, e.g. Entity["Gender","Male"] or "Female".
The function can accept ages in the range of 18 to 65 years. If given as Quantity, any time unit is accepted. When not specified, the unit of time is taken to be years.
The height can be from 92 to 244 centimeters. If given as Quantity, any height unit is accepted. When not specified, the height unit is assumed to be centimeters.
The output specification out accepts the following values:
"DiffusingCapacity" (DLCO)diffusing capacity for carbon monoxide
"Plot"generate a plot for comparison
"PropertyAssociation"include all output in an Association
A plot is generated as a curve in which the x-axis is age (in years) and the y-axis is "DiffusingCapacity" (in milliliters of CO per minute per millimeter of Hg) for a given gender and height.

Examples

Basic Examples (1) 

Get the value of the pulmonary diffusing capacity of carbon monoxide for a specific male:

In[1]:=
ResourceFunction["PulmonaryDiffusingCapacity"][ Entity["Gender", "Male"], Quantity[45, "Years"], Quantity[165, "Centimeters"]]
Out[1]=

Scope (5) 

If values without Quantity are used, the age is interpreted as "Years" and the height as "Centimeters":

In[2]:=
ResourceFunction["PulmonaryDiffusingCapacity"]["Male", 35, 175]
Out[2]=
In[3]:=
ResourceFunction["PulmonaryDiffusingCapacity"]["Male", Quantity[35, "Years"], Quantity[175, "Centimeters"]]
Out[3]=

Other time and length units are accepted as well:

In[4]:=
ResourceFunction["PulmonaryDiffusingCapacity"][ Entity["Gender", "Female"], Quantity[380, "Months"], Quantity[65, "Inches"]]
Out[4]=

Create a plot using the "Plot" output. The x-axis is age (given in years) and the y-axis is "DiffusingCapacity" (DLCO) (in milliliters of CO per minute per millimeter of Hg) for a given gender and height:

In[5]:=
ResourceFunction["PulmonaryDiffusingCapacity"][ Entity["Gender", "Male"], Quantity[45, "Years"], Quantity[185, "Centimeters"], "Plot"]
Out[5]=

Specify "PropertyAssociation" as the output:

In[6]:=
ResourceFunction["PulmonaryDiffusingCapacity"][ Entity["Gender", "Female"], Quantity[4, "Decades"], Quantity[1780, "Millimeters"], "PropertyAssociation"]
Out[6]=

The default output is "DiffusingCapacity":

In[7]:=
ResourceFunction["PulmonaryDiffusingCapacity"]["Male", Quantity[45, "Years"], Quantity[185, "Centimeters"], "DiffusingCapacity"]
Out[7]=
In[8]:=
ResourceFunction["PulmonaryDiffusingCapacity"]["Male", Quantity[45, "Years"], Quantity[185, "Centimeters"]]
Out[8]=

Possible Issues (1) 

The x-axis of the plot is given in years, regardless of the inputs:

In[9]:=
ResourceFunction["PulmonaryDiffusingCapacity"]["Male", Quantity[350, "Months"], Quantity[6, "Feet"], "Plot"]
Out[9]=

Publisher

Claudio Lobo Chaib Filho

Version History

  • 1.0.0 – 12 November 2020

Source Metadata

  • Citation:
    • American Thoracic Society, "Single-breath Carbon Monoxide Diffusing Capacity (Transfer Tactor): Recommendations for a Standard Technique—1995 update." American journal of respiratory and critical care medicine, vol. 152, no. 6, 2185–2198, 1995. DOI: 10.1164/ajrccm.152.6.8520796

Related Resources

License Information