Tools for Data Handling and Analysis in Macroecology

R functions for handling, processing, and analyzing geographic data on species' distributions and environmental variables.

Travis-CI Build Status Coverage Status CRAN_Status_Badge rstudio mirror downloads rstudio mirror downloads Research software impact Due to changes in the IUCN API and to limitations in data distribution stabilished IUCN terms of use, we are no longer mataining the functions lets.iucn, lets.iucn.hist and lets.iucn.ha. These functions will be removed from the package in the next version. We apologize for any incovinience this may cause.

Package letsR

The letsR package is being developed to help researchers in the handling, processing, and analysis of macroecological data. Its purpose is to integrate these methodological processes into a single software platform for macroecological analyses. The package's main functions allow users to build presence-absence matrices, the basic analytical tool in macroecology, from species' geographical distributions and merge them with species' traits, conservation information(downloadable using functions from this package) and spatial environmental layers. In addition, other package's functions enable users to summarize and visualize information from presence-absence matrices.

All functions in this package use a prefix and a suffix separated by a dot. The prefix refers to the package's name and the suffix to the actual function. This is done to avoid confusion with potentially similarly-named functions from other R packages. For instance, the letsR function used to create presence-absence matrices is called lets.presab (but see also lets.presab.birds and lets.presab.points) whereas the one used to add variables to a presence-absence matrix is called lets.addvar.
The package's basic functions create and work on a particular S3 object class called PresenceAbsence. Such PresenceAbsence object class allows storing information beyond presence-absence data (e.g. user-defined grid-cell system) and using the generic plot, summary and print functions of R. Also, some package's functions allow the user to input customary R objects (e.g. vector, matrix, data.frame.

Another set of functions in this package allow the user to download species' information related to their description and conservation status as provided by the IUCN's REdList database (lets.iucn, lets.iucn.ha, lets.iucn.his). For this, such functions use the IUCN's RedList API to retrieve information from its webpage.

The letsR package is in continuous development and suggestions are more than welcome!

We hope you enjoy it and find it useful.

Package publication



Install letsR from CRAN


Install letsR developers version from github


OBS.: To download the developers version you will need to have the git software installed ( If you are a windows user you will also need to download the Rtools (


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


3.1 by Bruno Vilela, a year ago,

Report a bug at

Browse source code at

Authors: Bruno Vilela & Fabricio Villalobos

Documentation:   PDF Manual  

GPL-2 license

Imports XML, geosphere, fields, maptools, sp, rgdal, rgeos, methods

Depends on raster, maps

Suggests testthat, devtools

See at CRAN