Skip to contents

As of 8/18/2023 Version 2.0.1 is now available! This version has simplified EJfunction()’s input requirements and deprecated several secondary data visualization functions.

To streamline initial EJ analysis efforts over multiple locations of interest, the EJSCREENbatch R package was developed to leverage the national demographic and environmental datasets made available through the U.S. Environmental Protection Agency.

This package offers canned functions to extract and process Census block group EJSCREEN and ACS data for buffered areas surrounding user-provided sf geographies. Users can request different buffer distances or GIS inclusion methods. Moreover, buffers can be distance-based over land (i.e. drawing circles around lat/longs) or water (leveraging the NHDPlus network to measure up/downstream).

A secondary interactive mapping function, useful for preliminary analytical exploration, is also included.


You can install EJSCREENbatch from GitHub with the following:

# requires devtools to install

# install from repository


Below is a visual overview of the package, highlighting the input types, primary data sources, and examples of output graphics. Three primary data types can be input: coordinates, NHDplus common identifiers (ComIDs), and shape files (linestrings, polygons). The package offers two buffering methods and can accept multiple buffer distances at a time. The user can chose to output summary plots and tables in addition to the returned raw dataframe. Additional documentation and a demonstration on how to leverage the package’s functional are available in the vignette directory.


EPA Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an “as is” basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.


This project is covered under the MIT license.