This README.txt file was generated on March 23 2019 by Bethany Bradley 


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


1. Title of Dataset: Abundance vs. Impact (AvI) databases and code

 
First/Corresponding Author Contact Information
      Name: Bethany Bradley
         Institution: University of Massachusetts, Amherst
         Address: 160 Holdsworth Way, Amherst, MA 01003 USA
         Email: bbradley@eco.umass.edu


Source paper citation
	Bradley, B.A., B.B. Laginhas, R. Whitlock, J.M. Allen, A.E. Bates, G. Bernatchez, J.M. Diez, R. Early, J. Lenoir, M. Vilà, and C.J.B. Sorte 
		"Disentangling the abundance-impact relationship for invasive species", Proceedings of the National Academy of Sciences, 2019


Description: 	These data represent 1258 empirical studies presented in 201 scientific publications used to meta-analyze the relationship between
		invasive species abundance and ecological impact.
 



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

#
# Directory of Files in Dataset: List and define the different 
# files included in the dataset. This serves as its table of 
# contents. 
#

Directory of Files
   A. Filename: AvI_combined_data.xlsx     
      Short description:        Excel file containing raw data values, associated attributes, and meta-data descriptions of data collection methods.
				This file contains the information in AvI_data_sheet.txt and AvI_attribute_sheet.txt plus some extra information.
        
   B. Filename: AvI_attribute_sheet.txt
      Short description:	Text file containing the attributes (e.g., trophic position, invader taxon, invaded habitat) of each study
        
   C. Filename: AvI_data_sheet.txt
      Short description:	Text file containing the raw data values of invader abundanve vs. native population/community response within each study


   D. Filename: AvI_metaanalysis_partial-r_24_03_19.R     
      Short description:        R code for the partial-r meta-analysis.  Code is also on Github (see paper for DOI). This code requires AvI_attribute_sheet.txt and AvI_data_sheet.txt as well as the Bar_plot_error_bars.R script
        
   E. Filename: AvI_metaanalysis_slopes__24_03_19.R
      Short description:	R code for the slopes meta-analysis. Code is also on Github (see paper for DOI). This code requires AvI_attribute_sheet.txt and AvI_data_sheet.txt
       
   F. Filename: Bar_plot_error_bars_24_03_19.R
      Short description:	R code to add error bars to an x,y plot.  Used in the partial-r meta-analysis plots.

   F. Filename: AvI_sensitivity_analyses_24_03_19.R
      Short description:	Sensitivity analysis of the results to different variable combinations.


R scripts (Files D-G) were written by Raj Whitlock and are also available at https://github.com/rajwhitlock/Invasive-abundance-native-impact or DOI: 10.5281/zenodo.2605254

-----------------------------------------
A. AvI_combined_data.xlsx 

Excel file contains multiple sheets.  See metadata tabs for variable definitions.


B. AvI_attribute_sheet.txt

1. Number of variables: 25


2. Number of cases/rows: 1263


3. Missing data codes:
        NA        Not Applicable

4. Variable List

	See AvI_combined_data.xlsx metadata tabs for variable definitions


C. AvI_attribute_sheet.txt

1. Number of variables: 5


2. Number of cases/rows: 54130


4. Variable List

	Article_ID: 	First four letters of the lead author plus year.  A unique identified for each paper
	Study_ID:	A number (1-n) for each unique study within the Article_ID
	Art_stud:	A unique identified for each study created by combining Article_ID with Study_ID
	Abundance:	Invasive species abundance extracted for that data point
	Response:	Native population or community-level response for that data point

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



1. Software-specific information: Code was written in R version 3.5.1. 
2. Equipment-specific information: N/A 
3. Date of data collection 2015-2017