**********************************************************************
INTRODUCTION
**********************************************************************
"Low migratory connectivity is common in long-distance migrant birds" 
Finch, T, Butler, S, Franco, A & Cresswell, W. 
VERSION 17-12-2016

This readme file describes the data files and R scripts accompanying the above publication.  For any further queries please contact wrlc@st-andrews.ac.uk

**********************************************************************
CONTENTS
**********************************************************************
This data packages includes the following files:

DATA FILES:
* "data.csv"
	Raw data for Afro-Palearctic and Neotropic migrant land-birds (see description below)
* "worldmap.geojson"
	World countries shapefile (for plotting maps)

R SCRIPTS: (annotated and reproducible, these should be sourced in order, i.e. script2 will fail unless script1 has been sourced)
* "script1_data_processing.R"
* "script2_main_analysis.R"
* "script3_plots.R"

**********************************************************************
DATA DESCRIPTION
**********************************************************************
Data were extracted from the literature (see Materials & Methods), and essentially represent start and end points (i.e. breeding and non-breeding locations) of the migration routes of individual tracked migrants land-birds.

Named variables are defined as follows:

"system" (TEXT) - migration system; "afro" = Afro-Palearctice, "neo" = Neotropical
"study" (TEXT) - data source; see Supplementary Materials for full citations
"species" (TEXT) - species common name
"family" (TEXT) - taxonomic family
"order" (TEXT) - taxonomic order
"popunique" (NUMERIC) - arbitrary code grouping individuals from the same species into unique populations separated by < 100km. Typically, this means grouping individuals from the same study site into populations. 
"method" (NUMERIC) - tagging method; 1 = solar geolocator, 2 = GPS, 3 = satellite tag
"sampledat" (NUMERIC) - sampling site; 1 = breeding site, 2 = non-breeding site
"age" (NUMERIC) - age of bird; 0 = juvenile (first migration), 1 = adult, blank = unknown
"country" (TEXT) - tagging country
"state" (TEXT) - tagging state / province (for USA and Canada)
"year" (NUMERIC) - year of tagging (2014 = 2014/15 migration period); blank if unknown
"blat" (NUMERIC) - latitude of tagging site in decimal degrees
"blon" (NUMERIC) - longitude of tagging site in decimal degrees
"wlat1" (NUMERIC) - latitude of first winter site in decimal degrees
"wlon1" (NUMERIC) - longitude of first winter site in decimal degrees
"wlat2" (NUMERIC) - (if applicable) latitude of second winter site in decimal degrees 
"wlon2" (NUMERIC) - (if applicable) longitude of second winter site in decimal degrees
"wlat3" (NUMERIC) - (if applicable) latitude of third winter site in decimal degrees 
"wlon3" (NUMERIC) - (if applicable) longitude of third winter site in decimal degrees
"notes" (TEXT) - additional notes
