This codebook.txt file was generated on 20171025 by Tristan Van de Moortele


-------------------
GENERAL INFORMATION
-------------------


1. Title of Dataset 

	Morphological properties of the conducting human airways by in vivo CT


2. Author Information


  Principal Investigator Contact Information
        Name: Filippo Coletti
           Institution: University of Minnesota
           Address: 110 Union St SE, Minneapolis MN 55455
           Email: fcoletti@umn.edu


  Associate or Co-investigator Contact Information
        Name: Tristan Van de Moortele
           Institution: University of Minnesota
           Address: 110 Union St SE, Minneapolis MN 55455
           Email: vande935@umn.edu


  Associate or Co-investigator Contact Information
           Name: Christine Wendt
           Institution: University of Minnesota
           Address: 516 Delaware St SE, Minneapolis, MN 55455
           Email: wendt005@umn.edu 


3. Date of data collection (single date, range, approximate date) <suggested format YYYYMMDD>

	20170601 - 20170707


4. Geographic location of data collection (where was data collected?): 

	110 Union St SE, Minneapolis MN 55455


5. Information about funding sources that supported the collection of the data:

	Funding for this work was provided by the National Science Foundation (CBET-1453538) and the National Institutes of Health (NHLBI-R21HL129906).
	COPDGene was supported by Award Number R01 HL089897 and Award Number R01 HL089856 from the National Heart, Lung, and Blood Institute
	and by the COPD Foundation through contributions made to an Industry Advisory Board comprised of AstraZeneca, Boehringer Ingelheim,
	GlaxoSmithKline, Novartis, Pfizer, Siemens and Sunovion.


--------------------------
SHARING/ACCESS INFORMATION
-------------------------- 


1. Licenses/restrictions placed on the data:


2. Links to publications that cite or use the data:

	Van de Moortele T., Wendt C., Coletti F. (2017). Morphological and functional properties of the conducting airways in healthy subjects investigated by in vivo CT and in vitro MRI. Journal of Applied Physiology (submitted).
Preprint available in the University of Minnesota Digital Conservancy, http://hdl.handle.net/11299/190800.


3. Links to other publicly accessible locations of the data:


4. Links/relationships to ancillary data sets:


5. Was data derived from another source?
           If yes, list source(s): Regan EA et al. (2010). Genetic epidemiology of COPD (COPDGene) study design. COPD: Journal of Chronic Obstructive Pulmonary Disease, 7(1):32-43. http://dx.doi.org/10.3109/15412550903499522. 


6. Recommended citation for the data:

Van de Moortele, Tristan; Coletti, Filippo; Wendt, Christine. (2017). Morphological properties of the conducting human airways by in vivo CT. Retrieved from the Data Repository for the University of Minnesota, https://doi.org/10.13020/D6J38F. 


---------------------
DATA & FILE OVERVIEW
---------------------


1. File List
   A. Filename:         D.xlsx
      Short description:        Table of values of branch diameters


        
   B. Filename:        D_ratio.xlsx
      Short description:        Table of values of the ratio of sibling branch diameters


        
   C. Filename:        h.xlsx
      Short description:        Table of values of branch homethety ratio 


   D. Filename:         h_maj.xlsx
      Short description:        Table of values of major sibling branch homethety ratio


        
   E. Filename:        h_min.xlsx
      Short description:        Table of values of minor sibling branch homethety ratio


        
   F. Filename:        L.xlsx
      Short description:        Table of values of branch length 

	  
	  
   G. Filename:         L_ratio.xlsx
      Short description:        Table of values of the ratio of sibling branch lengths


        
   H. Filename:        LD.xlsx
      Short description:        Table of values of branch length to diameter ratios


        
   I. Filename:        LD_maj.xlsx
      Short description:        Table of values of major sibling branch length to diameter ratios 


   J. Filename:         LD_min.xlsx
      Short description:        Table of values of minor sibling branch length to diameter ratios


        
   K. Filename:        Phi.xlsx
      Short description:        Table of values of branch rotation angle


        
   L. Filename:        Theta.xlsx
      Short description:        Table of values of total branching angle

	  
	  
   M. Filename:        Theta_maj.xlsx
      Short description:        Table of values of major sibling branching angle

	  
	  
   N. Filename:        Theta_min.xlsx
      Short description:        Table of values of minor sibling branching angle

	  
	  
2. Relationship between files:        




3. Additional related data collected that was not included in the current data package:




4. Are there multiple versions of the dataset? no






--------------------------
METHODOLOGICAL INFORMATION
--------------------------


1. Description of methods used for collection/generation of data: 

	All details can be find in the manuscript in the present folder, see citation below:
	Van de Moortele T., Wendt C., Coletti F. (2017). Morphological and functional properties of the conducting airways in healthy
	subjects investigated by in vivo CT and in vitro MRI. Journal of Applied Physiology (submitted).


2. Methods for processing the data: <describe how the submitted data were generated from the raw or collected data>

	CT scans from the COPDGene study were segmented into 3D airway volume using the software Mimics (Materialise, Belgium)
	Centerlines were generated for each subject in Mimics
	These centerlines were analyzed with in-house written Matlab codes and these data files were created from this analysis.
	For more details, see abovementioned manuscript.

3. Instrument- or software-specific information needed to interpret the data:
	None.		

4. Standards and calibration information, if appropriate:
	As described in abovementioned manuscript.

5. Environmental/experimental conditions:
	As described in abovementioned manuscript.		

6. Describe any quality-assurance procedures performed on the data:
	As described in abovementioned manuscript.

7. People involved with sample collection, processing, analysis and/or submission:

	Filippo Coletti, Tristan Van de Moortele, Christine Wendt (University of Minnesota).






-----------------------------------------
DATA-SPECIFIC INFORMATION FOR ALL FILES:
-----------------------------------------

All files are .xlsx tables, row 1 contains column headers.

The parameters are further described below:

D – branch diameter (units in mm)
L – branch length (units in mm)
LD – ratio of the length of a branch to its diameter
LD_min – LD ratio of the minor branch sibling
LD_maj – LD ratio of the major branch sibling
D_ratio – ratio of the diameters of the minor branch sibling to the major branch sibling (always < 1)
L_ratio – ratio of the lengths of the minor branch sibling to the major branch sibling
h – ratio of a child branch diameter to the diameter of its parent
h_min – ratio of a minor sibling branch diameter to the diameter of its parent
h_maj – ratio of a major sibling branch diameter to the diameter of its parent
Theta – the total branching angle of two sibling branches (units in degrees 0-360)
Theta_min – the branching angle of the minor child sibling to its parent (units in degrees 0-360)
Theta_maj – the branching angle of the major child sibling to its parent (units in degrees 0-360)
Phi – the rotation angle between two child branches and their parent and parent’s sibling branch (units in degrees 0-360)

The column headings are as follows:

Column 1: parameter values

Column 2: generation number of the target branch parameter

Column 3: lobe number of the target branch parameter
			1 - Right Upper Lobe
			2 - Right Middle Lobe
			3 - Right Lower Lobe
			4 - Left Upper Lobe
			5 - Left Lower Lobe
			0 - Upper airways not in the 5 lobes
			
Column 4: subject number (1 - 36)

Columns 5 through 8 describe the arbitrary branch numbers associated to the branches involved with the parameter. Useful when analyzing multiple parameters together.

If 5 total columns:
	Column 5: branch number
	
If 6 total columns:
	Column 5: parent branch number
	Column 6: child branch number
	
If 7 total columns:
	Column 5: parent branch number 
	Column 6: minor sibling branch number
	Column 7: major sibling branch number
	
If 7 total columns:
	Column 5: parent branch number 
	Column 6: minor sibling branch number
	Column 7: major sibling branch number
	Column 7: parent branch sibling branch number