muRL: Mailmerge using R, LateX, and the Web
Ryan T. Moore and Andrew Reeves
Available as a CRAN package
is an R package that provides mailmerge methods for reading spreadsheets of addresses and other relevant information, creating standardized but customizable letters, and mapping US ZIP codes, including the locations of recipients. It provides a method for parsing and processing html code from online job postings of the American Political Science Association (APSA eJobs). The many options associated with this functionality are described in detail in the muRL
To install the latest version on CRAN, open R and type
To install the latest version (0.1-11) directly, download the package
) and install
using R CMD INSTALL.
Some helpful documents:
- Use muRL to produce high-quality letters using R
and LaTeX [PDF version].
- Use muRL to scrap APSA eJobs .html files to produce a
spreadsheet of jobs to apply for [PDF version].
- The full muRL manual [PDF version]
- How to get started with R (for beginners, 1 page) [PDF version]
The peer-reviewed journal article describing muRL
Moore, Ryan T. and Andrew Reeves. "The Job Market’s First Steps: Using Research
Tools to Simplify the Process". PS: Political Science &
Politics, 44(2):385-391, April 2011.
If you use this package, please cite the article. To cite the
package, use "Ryan T. Moore and Andrew Reeves (2017). muRL: Mailmerge
using R, LaTeX, and the Web. R package version 0.1-11. http://www.ryantmoore.org/software.muRL.html".
Missing ZIP codes:
If you find that some recipients do not appear on your recipient map,
their ZIP codes may be missing from the Census file. If you have a
ZIP code you would like included for plotting, please email the
package maintainer with four pieces of information:
- the state in which the ZIP code is located,
- the ZIP code itself,
- the latitude of the ZIP code to six decimal places (such as 38.643248),
- and the longitude of the ZIP code to six decimal places (such as
Please also provide the city and any other information required to verify the latitude and longitude for inclusion. Thanks!
Many thanks to Sonia Gerstenfield
for solving a regular expression problem for version 0.1-11!
Previous versions (CHANGELOG):
0.1-11 (13 June 2017)
0.1-10 (27 July 2015)
0.1-9 (23 August 2013)
0.1-8 (15 August 2013)
0.1-7 (28 August 2012)
0.1-6 (27 May 2011)
0.1-5 (25 August 2010)
0.1-4 (28 October 2009)
0.1-3 (18 October 2009)
0.1-2 (20 August 2009)
0.1-1 (17 July 2009)