Adding Custom Lat-Long Data

To place sequences on a map, auspice needs to know where the locations you specify are on the globe. These coordinates are provided by augur and augur has preset coordinates for many places. For example, for region, country, and some divisions augur already knows many lat-long coordinates (see which ones it already knows by checking the list here).

Some places, however, are inevitably missing and you need to tell augur the latitudes and longitude of all locations not covered by defaults. The file for latitude and longitude needs to be a tab-delimited table with four columns:

country	brazil	-10.3333332	-53.1999999
country	colombia	2.893108	-73.7845142
country	dominican republic	18.50012	-69.98857
country	ecuador	-1.3397667	-79.3666964
country	french polynesia	-17.6797	-149.4068
country	guatemala	15.6356088	-89.8988086
[...]

The first columns specifies the type of location (country, city, region, …) corresponding to a field in your meta data. The second is the actual name of the location, while the third and fourth columns are latitude and longitude. Note that multipart country names like “Dominican Republic” can contain a space because the delimiter of difference columns are tabs.

Augur matches geographic location in lower case, so the casing doesn’t matter. Beyond that, make sure your trait (e.g. ‘country’) and the values (e.g. ‘brazil’) exactly match what’s in your metadata!

You can add geographic lat-long data at as many resolutions as you like - just ensure you give each different names (‘country’, ‘region’, ‘state’, ‘location’, ‘city’) and that these match columns in your metadata file.