This readme.txt file was generated on <20221201 by <Lisa Elliott> and edited on 20221230 by <Lisa Elliott>
Recommended citation for the data:  
	Elliott, L.H., A.M. Bracey, G.J. Niemi, D.H. Johnson, T.M. Gehring, E.E. Gnass Giese, G.P. Grabas, R.W. Howe, C.J. Norment, D.C. Tozer and L.D. Igl. 23. Application of habitat association models across regions: useful explanatory power retained in wetland bird case study.

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


1. Title of Dataset: Wetland bird case study for application of habitat association models across Great Lakes and Prairie Pothole regions  


2. Author Information


  Principal Investigator Contact Information
        Name: Lisa Elliott
           Institution: Bureau of Reclamation; University of Minnesota; Birds Canada
           Address: Minneapolis, MN, USA
           Email: harnx012@umn.edu 
	   ORCID: 0000-0002-9089-3484

  Associate or Co-investigator Contact Information
        Name: Annie M. Bracey
           Institution: Natural Resources Research Institute; University of Minnesota
           Address: Duluth, Minnesota, USA
           Email: brace005@d.umn.edu
	   ORCID: 0000-0001-7797-7555

  Associate or Co-investigator Contact Information
        Name: Gerald J. Niemi
           Institution: Natural Resources Research Institute; University of Minnesota-Duluth
           Address: Duluth, Minnesota, USA
           Email: gniemi@d.umn.edu
	   ORCID: 0000-0002-3160-2237

 Associate or Co-investigator Contact Information
        Name: Douglas H. Johnson
           Institution: University of Minnesota; U.S. Geological Survey, Northern Prairie Wildlife Research Center
           Address: St. Paul, MN, USA
           Email: douglashjohnson@hotmail.com
	   ORCID: 0000-0002-7778-6641

 Associate or Co-investigator Contact Information
        Name: Thomas M. Gehring
           Institution: Central Michigan University
           Address: Mount Pleasant, Michigan, USA
           Email: gehri1tm@cmich.edu
	   ORCID: 0000-0001-6956-729X

 Associate or Co-investigator Contact Information
        Name: Erin E. Gnass Giese
           Institution: Cofrin Center for Biodiversity, University of Wisconsin-Green Bay
           Address: Green Bay, Wisconsin, USA
           Email: giesee@uwgb.edu
	   ORCID: 0000-0002-0707-354X

 Associate or Co-investigator Contact Information
        Name: Giuseppe E. Fiorino
           Institution: Environment and Climate Change Canada
           Address: Toronto, Ontario, Canada
           Email: Giuseppe.Fiorino@ec.gc.ca
	   ORCID: 0000-0002-1569-0767

 Associate or Co-investigator Contact Information
        Name: Robert W. Howe
           Institution: Cofrin Center for Biodiversity, University of Wisconsin-Green Bay
           Address: Green Bay, Wisconsin, USA
           Email: hower@uwgb.edu
	   ORCID: 0000-0001-8393-4981

 Associate or Co-investigator Contact Information
        Name: Gregory J. Lawrence
           Institution: Department of Environmental Science and Ecology, SUNY-Brockport
           Address: Brockport, New York, USA
           Email: glawrence@brockport.edu
	   ORCID: 0000-0001-8854-8123

 Associate or Co-investigator Contact Information
        Name: Christopher J. Norment
           Institution: Department of Environmental Science and Ecology, SUNY-Brockport
           Address: Brockport, New York, USA
           Email: cnorment@brockport.edu
	   ORCID: 0000-0002-5080-0271

 Associate or Co-investigator Contact Information
        Name: Douglas C. Tozer
           Institution: Birds Canada
           Address: Port Rowan, Ontario, Canada
           Email: dtozer@birdscanada.org
	   ORCID: 0000-0001-9516-876X

 Associate or Co-investigator Contact Information
        Name: Lawrence D. Igl
           Institution: U.S. Geological Survey, Northern Prairie Wildlife Research Center
           Address: Jamestown, North Dakota, USA
           Email: ligl@usgs.gov
	   ORCID: 0000-0003-0530-7266


3. Date published or finalized for release: 

4. Date of data collection (single date, range, approximate date) <suggested format YYYYMMDD>
	1995-1997, 2016-2017

5. Geographic location of data collection (where was data collected?): 
	Great Lakes basin; North Dakota & South Dakota  

6. Information about funding sources that supported the collection of the data: 
	USGS
	USFWS
	Great Lakes Restoration Initiative
	Great Lakes National Program Office of the United States Environmental Protection Agency, grant number GL-00E01567
	Ducks Unlimited Canada
	Eastern Habitat Joint Venture
	Environment and Climate Change Canada
	USEPA
	Government of Ontario
	John and Pat McCutcheon Charitable Foundation
	Nature Conservancy of Canada
	TD Friends of the Environment Foundation
	Wildlife Habitat Canada

7. Overview of the data (abstract): 
	Species often exhibit regionally specific habitat associations, and, thus, habitat association models developed in one region might not be accurate or even appropriate for other regions. Three programs to survey wetland-breeding birds covering (respectively) North American wetland breeding bird survey programs in Great Lakes coastal wetlands, inland Great Lakes wetlands, and the Prairie Pothole Region offer an opportunity to test whether regionally specific models of habitat use by wetland-obligate breeding birds are transferrable across regions. This dataset includes wetland bird point count and habitat characteristics data from the Great Lakes Coastal Wetland Monitoring Program (2016-2017) and Great Lakes Marsh Monitoring Program (1995-1997 and 2016-2017). These data are then combined with publicly available data from the Dakotas Wetland Survey (1995-1997). The included code files cover the creation and selection of habitat association models, and test the transferability of these models across datasets. These data are now released to accompany publication of "Application of habitat association models across regions: useful explanatory power retained in wetland bird case study."

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


1. Licenses/restrictions placed on the data:

2. Links to publications that cite or use the data:
	Elliott, L.H., A.M. Bracey, G.J. Niemi, D.H. Johnson, T.M. Gehring, E.E. Gnass Giese, G.P. Grabas, R.W. Howe, C.J. Norment, D.C. Tozer and L.D. Igl. 23. Application of habitat association models across regions: useful explanatory power retained in wetland bird case study.

3. Was data derived from another source?
           If yes, list source(s):
		Elliott, L.H., Igl, L.D., and Johnson, D.H., 2019, Wetland birds of the Prairie Pothole Region of North and South Dakota, 1995-1997, data release: U.S. Geological Survey data release, https://doi.org/10.5066/P94GV3LC.
		North American Land Change Monitoring System (NALCMS). 2017. 2010 Land Cover of North America at 30 meters. http://www.cec.org/north-american-environmental-atlas/land-cover-2010-landsat-30m/

4. Terms of Use: Data Repository for the U of Minnesota (DRUM) By using these files, users agree to the Terms of Use. https://conservancy.umn.edu/pages/drum/policies/#terms-of-use




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

1. File List
   A. Filename:  GL_Data.csv      
      Short description: point count data for Pied-billed Grebe, Virginia Rail, Sora, and American Bittern and associated environmental variables from the Coastal Wetland Monitoring Program (2016-2017) and the Great Lakes Marsh Monitoring Program (1995-1997, 2016-2017).       

   B. Filename:  variableList.csv      
      Short description:   a list of environmental variables used in the data analysis     
        
   C. Filename: wetland classifications.csv       
      Short description: a list of hydroperiods associated with five classes of wetlands
   
   D. Filename: Data prep_Ecosphere.R      
      Short description: Load DWS data and combine with GL_Data.csv into a single dataset (wetlandData)

   E. Filename:  DataSetCreation_Ecosphere.Rmd     
      Short description: Use the wetlandData dataset to create training and validation datasets.

   F. Filename: RegionalAnalysis_Ecosphere.Rmd      
      Short description: Conduct analysis of training dataset, evaluate model performances with validation dataset

   G. Filename: RegionalAnalysis_landscapeOnly_Ecosphere.Rmd    
      Short description: Re-run analysis using only landscape-scale environmental covariates

   H. Filename: TablesResultsDiscussion_Ecosphere.Rmd     
      Short description: Markdown script for tables, appendices, and additional calculations for Results and Discussion sections of accompanying manuscript 

   I. Filename: Figures2_Ecosphere.Rmd      
      Short description: Markdown script for Figure 2 of the accompanying manuscript   

   J. Filename: Readme.txt      
      Short description: Metadata associated with dataset and code files  


2. Relationship between files:        

	"GL_Data.csv" and "Wetland_Bird_Study_1995to1997_Dataset.csv" (obtained from https://doi.org/10.5066/P94GV3LC) are inputs to "Data prep_Ecosphere.csv"; 
	Output from "Data prep_Ecosphere.csv" are inputs into "DataSetCreation_Ecosphere.Rmd"; 
	Outputs from "DataSetCreation_Ecosphere.Rmd" are inputs into "RegionalAnalysis_Ecosphere.Rmd" and "RegionalAnalysis_landscapeOnly_Ecosphere.Rmd"
	Outputs from "RegionalAnalysis_Ecosphere.Rmd" and "RegionalAnalysis_landscapeOnly_Ecosphere.Rmd" are inputs into "TablesResultsDiscussion_Ecosphere.Rmd" and "Figures2_Ecosphere.Rmd" 

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

1. Description of methods used for collection/generation of data: 
	Bird survey data and local scale habitat data were collected with point count surveys as part of the Coastal Wetland Monitoring Program and Great Lakes Marsh Monitoring Program.
	Landscape-scale variables were obtained from We used the 2010 North American Land Cover 30-m dataset from North American Land Change Monitoring System (NALCMS 2017) and quantified within 400-m buffers of each sampling point using ArcGIS 10.6.1 (Esri, Redlands, California, USA). The percentages of land-cover classifications within each buffer size were calculated using packages raster (Hijmans & van Etten 2012) and rgdal (Bivand et al. 2019) in program R v. 3.4.3 (R Core Team 2018).
	A detailed description of the methods used for collection/generation is available in the asscociated manuscript "Elliott, L.H., A.M. Bracey, G.J. Niemi, D.H. Johnson, T.M. Gehring, E.E. Gnass Giese, G.P. Grabas, R.W. Howe, C.J. Norment, D.C. Tozer and L.D. Igl. 23. Application of habitat association models across regions: useful explanatory power retained in wetland bird case study."

2. Methods for processing the data: <describe how the submitted data were generated from the raw or collected data>
	Data were filtered for focal species records, and limited to wetlands with <20% tree coverage.

3. Instrument- or software-specific information needed to interpret the data:
	All analyses included in the code files were conducted in R version 4.1.2 (R Core Team 2018). 




-----------------------------------------
DATA-SPECIFIC INFORMATION FOR: GL_Data.csv
-----------------------------------------
1. Number of variables:21


2. Number of cases/rows: 9006




3. Missing data codes:
        Code/symbol: NA        Definition: Not Applicable


4. Variable List
                  

    A. Name: key
       Description: unique descriptor for wetland site and year
                    Value labels if appropriate

    B. Name: site
       Description: identifier for individual wetlands
                    Value labels if appropriate

   C. Name: year
       Description: year of data collection

   D. Name: OW
       Description: Percentage of open water (%)
                    

   E. Name: SM
       Description: Percentage of shoreline/mudflat (%)

   F. Name: EV
       Description: Percentage of Emergent Vegetation (%)

   G. Name: WM
       Description: Percentage of Wet meadow (%)

   H. Name: localSum
       Description: total percentage of OW, SM, EV, and WM (%)

   I. Name: localDiversity
       Description: Inverse Simpson Diversity Index of local-scale habitat characteristics or natural land cover (grass, forest, and wetland but not cropland)
                    Value labels if appropriate

   J. Name: Grass400
       Description: percentage of grassland cover within 400 m of the wetland edge
                    Value labels if appropriate

   K. Name: Forest400
       Description: percentage of forest cover within 400 m of the wetland edge
                    Value labels if appropriate

   L. Name: Totwet400
       Description: percentage of wetland cover within 400 m of the wetland edge
                    Value labels if appropriate

   M. Name: Crop400
       Description: percentage of cropland within 400 m of the wetland edge
                    Value labels if appropriate

   N. Name: nLandSum
       Description: total percentage of all natural land cover (grass, forest, and wetland but not cropland; %)

   O. Name: naturalLandDiversity
       Description: Inverse Simpson Diversity Index of natural land cover (grass, forest, and wetland but not cropland; %)

   P. Name: class
       Description: wetland class: temporary (TEMP), seasonal (SEAS), semipermanent (SEMI), permanent (PERM)
              
   Q. Name: size
       Description: surveyed area (only the area within 100m of the survey point). For the CWMP this is a full circle, for the GLMMP this is a half circle. Reported in ha.  
                    

   R. Name: area
       Description: the amount of wetland habitat within a 400-m buffer of the survey (“wetland area”), including wetland area within the survey area. Reported in ha.
                  
   S. Name: species
       Description: wetland bird species:
			Pied-billed Grebe (PBGR)
			Virginia Rail (VIRA)
			Sora (SORA)
			American Bittern (AMBI)
                
   T. Name: count
       Description: number counted during survey
                    
   U. Name: data
       Description: dataset (GLCWMP, GLMMP, or PPDWMP)
                   
-----------------------------------------
DATA-SPECIFIC INFORMATION FOR: variableList.csv
-----------------------------------------


1. Number of variables: 5


2. Number of cases/rows: 185


3. No data are missing 


4. Variable List

                  

    A. Name: Dataset
       Description: dataset: (GLCWMP, GLMMP, PPDWMP)


    B. Name: Species
       Description: focal species: Pied-billed Grebe (PBGR), Virginia Rail (VIRA), Sora (SORA), and American Bittern (AMBI)

    C. Name: Variable
       Description: variable name

    D. Name: In
       Description: Binomial indicating whether the variable should be included (1) or not (0) in models that include both local and landscape-scale variables

    E. Name: Landscape
       Description: Binomial indicating whether the variable should be included (1) or not (0) in landscape-only models

-----------------------------------------
DATA-SPECIFIC INFORMATION FOR: wetland classifications.csv
-----------------------------------------


1. Number of variables: 3


2. Number of cases/rows: 5


class	hydroperiod	months


3. No data are missing


4. Variable List
                  

    A. Name: class
       Description: wetland class: temporary (TEMP), seasonal (SEAS), semipermanent (SEMI), permanent (PERM)


    B. Name: hydroperiod
       Description: estimated number of days wetlands of the class of interest are inundated 
               

    C. Name: months
       Description: number of months wetlands of the class of interest are inundated
                    Value labels if appropriate


---------------------------------------------------------------------------
Session Info for: Data prep_Ecosphere.R and DataSetCreation_Ecosphere.Rmd
---------------------------------------------------------------------------
R version 4.1.2 (2021-11-01)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19045)

Matrix products: default

Random number generation:
 RNG:     Mersenne-Twister 
 Normal:  Inversion 
 Sample:  Rounding 
 
locale:
[1] LC_COLLATE=English_United States.1252 
[2] LC_CTYPE=English_United States.1252   
[3] LC_MONETARY=English_United States.1252
[4] LC_NUMERIC=C                          
[5] LC_TIME=English_United States.1252    

attached base packages:
[1] stats     graphics  grDevices utils     datasets 
[6] methods   base     

other attached packages:
 [1] sessioninfo_1.2.2 broom_0.7.12     
 [3] dotwhisker_0.7.4  ggplot2_3.3.5    
 [5] msme_0.5.3        lattice_0.20-45  
 [7] pscl_1.5.5        MASS_7.3-54      
 [9] dplyr_1.0.8       stringr_1.4.0    
[11] MuMIn_1.46.0      lme4_1.1-28      
[13] Matrix_1.3-4     

loaded via a namespace (and not attached):
 [1] Rcpp_1.0.8        mvtnorm_1.1-3    
 [3] tidyr_1.2.0       zoo_1.8-10       
 [5] assertthat_0.2.1  digest_0.6.29    
 [7] utf8_1.2.2        R6_2.5.1         
 [9] backports_1.4.1   stats4_4.1.2     
[11] evaluate_0.15     ggstance_0.3.5   
[13] pillar_1.7.0      rlang_1.0.1      
[15] multcomp_1.4-19   rstudioapi_0.13  
[17] minqa_1.2.4       nloptr_2.0.0     
[19] rmarkdown_2.12    splines_4.1.2    
[21] munsell_0.5.0     tinytex_0.37     
[23] compiler_4.1.2    xfun_0.29        
[25] pkgconfig_2.0.3   parameters_0.16.0
[27] htmltools_0.5.2   insight_0.16.0   
[29] tidyselect_1.1.2  tibble_3.1.6     
[31] codetools_0.2-18  fansi_1.0.2      
[33] crayon_1.5.0      withr_2.5.0      
[35] grid_4.1.2        nlme_3.1-153     
[37] xtable_1.8-4      gtable_0.3.0     
[39] lifecycle_1.0.1   DBI_1.1.2        
[41] magrittr_2.0.2    bayestestR_0.11.5
[43] scales_1.1.1      datawizard_0.3.0 
[45] estimability_1.3  cli_3.2.0        
[47] stringi_1.7.6     ellipsis_0.3.2   
[49] generics_0.1.2    vctrs_0.3.8      
[51] boot_1.3-28       sandwich_3.0-1   
[53] TH.data_1.1-1     tools_4.1.2      
[55] glue_1.6.2        purrr_0.3.4      
[57] emmeans_1.7.2     fastmap_1.1.0    
[59] survival_3.2-13   yaml_2.3.5       
[61] colorspace_2.0-3  knitr_1.37 


------------------------------------------------
Session Info for: RegionalAnalysis_Ecosphere.Rmd, RegionalAnalysis_landscapeOnly_Ecosphere.Rmd, & TablesResultsDiscussion_Ecosphere.Rmd  
------------------------------------------------
R version 4.1.2 (2021-11-01)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19045)

Matrix products: default

Random number generation:
 RNG:     Mersenne-Twister 
 Normal:  Inversion 
 Sample:  Rounding 
 
locale:
[1] LC_COLLATE=English_United States.1252 
[2] LC_CTYPE=English_United States.1252   
[3] LC_MONETARY=English_United States.1252
[4] LC_NUMERIC=C                          
[5] LC_TIME=English_United States.1252    

attached base packages:
[1] stats     graphics  grDevices utils     datasets 
[6] methods   base     

other attached packages:
 [1] sessioninfo_1.2.2 broom_0.7.12     
 [3] dotwhisker_0.7.4  ggplot2_3.3.5    
 [5] msme_0.5.3        lattice_0.20-45  
 [7] pscl_1.5.5        MASS_7.3-54      
 [9] dplyr_1.0.8       stringr_1.4.0    
[11] MuMIn_1.46.0      lme4_1.1-28      
[13] Matrix_1.3-4     

loaded via a namespace (and not attached):
 [1] Rcpp_1.0.8         mvtnorm_1.1-3     
 [3] tidyr_1.2.0        zoo_1.8-10        
 [5] assertthat_0.2.1   digest_0.6.29     
 [7] utf8_1.2.2         plyr_1.8.6        
 [9] R6_2.5.1           backports_1.4.1   
[11] stats4_4.1.2       evaluate_0.15     
[13] ggstance_0.3.5     pillar_1.7.0      
[15] rlang_1.0.1        multcomp_1.4-19   
[17] performance_0.8.0  rstudioapi_0.13   
[19] minqa_1.2.4        nloptr_2.0.0      
[21] effectsize_0.6.0.1 rmarkdown_2.12    
[23] labeling_0.4.2     splines_4.1.2     
[25] munsell_0.5.0      tinytex_0.37      
[27] compiler_4.1.2     xfun_0.29         
[29] pkgconfig_2.0.3    parameters_0.16.0 
[31] htmltools_0.5.2    insight_0.16.0    
[33] tidyselect_1.1.2   tibble_3.1.6      
[35] codetools_0.2-18   fansi_1.0.2       
[37] crayon_1.5.0       withr_2.5.0       
[39] grid_4.1.2         nlme_3.1-153      
[41] xtable_1.8-4       gtable_0.3.0      
[43] lifecycle_1.0.1    DBI_1.1.2         
[45] magrittr_2.0.2     bayestestR_0.11.5 
[47] scales_1.1.1       datawizard_0.3.0  
[49] estimability_1.3   cli_3.2.0         
[51] stringi_1.7.6      farver_2.1.0      
[53] ellipsis_0.3.2     generics_0.1.2    
[55] vctrs_0.3.8        boot_1.3-28       
[57] sandwich_3.0-1     TH.data_1.1-1     
[59] tools_4.1.2        glue_1.6.2        
[61] purrr_0.3.4        emmeans_1.7.2     
[63] fastmap_1.1.0      survival_3.2-13   
[65] yaml_2.3.5         colorspace_2.0-3  
[67] knitr_1.37


------------------------------------------------
Session Info for: Figures2_Ecosphere.Rmd 
------------------------------------------------

R version 4.1.2 (2021-11-01)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19045)

Matrix products: default

Random number generation:
 RNG:     Mersenne-Twister 
 Normal:  Inversion 
 Sample:  Rounding 
 
locale:
[1] LC_COLLATE=English_United States.1252 
[2] LC_CTYPE=English_United States.1252   
[3] LC_MONETARY=English_United States.1252
[4] LC_NUMERIC=C                          
[5] LC_TIME=English_United States.1252    

attached base packages:
[1] stats     graphics  grDevices utils     datasets 
[6] methods   base     

other attached packages:
 [1] gridExtra_2.3     Cairo_1.5-14     
 [3] sessioninfo_1.2.2 broom_0.7.12     
 [5] dotwhisker_0.7.4  ggplot2_3.3.5    
 [7] msme_0.5.3        lattice_0.20-45  
 [9] pscl_1.5.5        MASS_7.3-54      
[11] dplyr_1.0.8       stringr_1.4.0    
[13] MuMIn_1.46.0      lme4_1.1-28      
[15] Matrix_1.3-4     

loaded via a namespace (and not attached):
 [1] tidyr_1.2.0        splines_4.1.2     
 [3] datawizard_0.3.0   assertthat_0.2.1  
 [5] stats4_4.1.2       ggstance_0.3.5    
 [7] yaml_2.3.5         bayestestR_0.11.5 
 [9] pillar_1.7.0       backports_1.4.1   
[11] glue_1.6.2         digest_0.6.29     
[13] minqa_1.2.4        colorspace_2.0-3  
[15] sandwich_3.0-1     htmltools_0.5.2   
[17] plyr_1.8.6         pkgconfig_2.0.3   
[19] purrr_0.3.4        xtable_1.8-4      
[21] mvtnorm_1.1-3      scales_1.1.1      
[23] emmeans_1.7.2      tibble_3.1.6      
[25] generics_0.1.2     farver_2.1.0      
[27] ellipsis_0.3.2     TH.data_1.1-1     
[29] withr_2.5.0        cli_3.2.0         
[31] survival_3.2-13    magrittr_2.0.2    
[33] crayon_1.5.0       effectsize_0.6.0.1
[35] estimability_1.3   evaluate_0.15     
[37] fansi_1.0.2        nlme_3.1-153      
[39] tools_4.1.2        lifecycle_1.0.1   
[41] multcomp_1.4-19    munsell_0.5.0     
[43] compiler_4.1.2     tinytex_0.37      
[45] rlang_1.0.1        grid_4.1.2        
[47] nloptr_2.0.0       parameters_0.16.0 
[49] rstudioapi_0.13    labeling_0.4.2    
[51] rmarkdown_2.12     boot_1.3-28       
[53] gtable_0.3.0       codetools_0.2-18  
[55] DBI_1.1.2          R6_2.5.1          
[57] zoo_1.8-10         knitr_1.37        
[59] performance_0.8.0  fastmap_1.1.0     
[61] utf8_1.2.2         insight_0.16.0    
[63] stringi_1.7.6      Rcpp_1.0.8        
[65] vctrs_0.3.8        tidyselect_1.1.2  
[67] xfun_0.29