Authors: Noam Ross, Allison White, Carlos Zambrana-Torrelio, Evan Eskew
The lemis package provides access to U.S. Fish and Wildlife Service (USFWS) data on wildlife and wildlife product imports to and exports from the United States. This data was obtained via more than 14 years of Freedom of Information Act (FOIA) requests by EcoHealth Alliance.
Install the lemis package with this command:
As this is currently a private repository, you must have a GitHub personal access token set up to install and use the package. Instructions for this can be found here.
The main function in lemis is
lemis_data(). This returns the main
cleaned LEMIS database as a dplyr tibble.
lemis makes use of
datastorr to manage
data download. The first time you run
lemis_data(), the package will
download the most recent version of the database (~160 MB at present).
Subsequent calls will load the database from storage on your computer.
The LEMIS database is stored as an efficiently compressed
file, and loading it loads it a
remote dplyr source. This means
that it does not load fully into memory but can be filtered and
manipulated on-disk. If you wish to manipulate it as a data frame,
dplyr::collect() to load it fully into memory, like so:
all_lemis <- lemis_data() %>% collect()
Note that the full database will be ~1 GB in memory.
lemis_codes() returns a data frame with descriptions of the codes used
by USFWS in the various columns of
lemis_data(). This is useful for
lookup or joining with the main data for more descriptive outputs. The
?lemis_code help file also has a searchable table of these codes.
Our paper (Smith et. al. 2017) provides a broader introduction to this data and its relevance to infectious disease. See the vignette for a more in-depth tutorial and example use cases for the package. See the developer README for more on the data cleaning process.
Please give us feedback or ask questions by filing issues.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.