Amend, Augment and Aid Analysis of John Snow's Cholera Data

Amends errors, augments data and aids analysis of John Snow's map of the 1854 London cholera outbreak.

John Snow's map of the 1854 cholera outbreak in London is one of the best known examples of data visualization and information design.

By plotting the number and location of fatalities on a map, Snow was able to do something that is easily taken for granted today: the ability to create and disseminate a visualization of a spatial distribution. To our modern eye, the pattern is unmistakable. It seems self-evident that the map elegantly supports Snow's claims: cholera is a waterborne disease and the pump on Broad Street is the source of the outbreak. And yet, despite its virtues, the map failed to convince both the authorities and Snow's colleagues in the medical and scientific communities.

Beyond considerations of time and place, there are "scientific" reasons for this failure. The map shows a concentration of cases around the Broad Street pump, but that alone should not convince us that Snow is right. The map doesn't refute Snow's primary rival, miasma theory. The pattern we see is not unlike what airborne transmission might look like. And while the presence of a pump near or at the epicenter of the distribution of fatalities is strong circumstantial evidence, it is still circumstantial. There are a host of rival explanations that the map doesn't consider and cannot rule out: location of sewer grates, elevation, weather patterns, etc..

Arguably, this may be one reason why Snow added a graphical annotation in a second, lesser-known version of the map that was published in the official report on the outbreak (Report On The Cholera Outbreak In The Parish Of St. James, Westminster, During The Autumn Of 1854):

pump neighborhoods

The annotation outlines what we might call the Broad Street pump neighborhood: the set of addresses that are, according to Snow, within "close" walking distance to the pump. The notion of a pump neighborhood is important because it provides a prediction about where we should and should not expect to find cases. If water is cholera's mode of transmission and if water pumps are the primary source of drinking water, then most, if not all, fatalities should be found within the pump neighborhood. The disease should stop at the neighborhood's borders.

Creating this annotation is not a trivial matter. To identify the neighborhood of the Broad Street pump, you actually need to identify the neighborhoods of surrounding pumps. Snow writes: "The inner dotted line on the map shews [sic] the various points which have been found by careful measurement to be at an equal distance by the nearest road from the pump in Broad Street and the surrounding pumps ..." (Ibid., p. 109.).

I build on Snow's efforts by writing functions that allow you to compute pump neighborhoods. There are two flavors. The first is based on Voronoi tessellation. It works by computing the Euclidean distances between pumps. It's easy to compute and has been a popular choice for analysts of Snow's map. However, it has two drawbacks: 1) roads and buildings play no role. It assumes that people can walk directly to their preferred pump; and 2) it's not what Snow has in mind. For that, you'll need to consider the second flavor.


The second flavor is based on the walking distance along the roads on the map. While more accurate, it's computationally more demanding. To compute these distances, I transform the roads on the map into a network graph and turn the computation of walking distance into a graph theory problem. For each case (observed or simulated), I compute the shortest path, weighted by the length of roads, to the nearest pump. Then, applying the "rinse and repeat" principle, the different pump neighborhoods emerge:


To explore the data, you can consider a variety of scenarios by computing neighborhoods using any desired subset of pumps. Here's the result excluding the Broad Street pump.


You can also explore "expected" neighborhoods:

plot(neighborhoodWalking(case.set = "expected"))

Or highlight the area of "expected" neighborhoods:

plot(neighborhoodWalking(case.set = "expected"), area = TRUE)

other package features

  • Fixes three apparent coding errors in Dodson and Tobler's 1992 digitization of Snow's map.
  • "Unstacks" the data in two ways to improve analysis and visualization.
  • Adds the ability to overlay graphical features like kernel density, Voronoi diagrams, Snow's annotation, and notable landmarks (John Snow's residence, the Lion Brewery, etc.).
  • Includes a variety of functions to highlight specific cases, roads, pumps and walking paths.
  • Appends street names to the roads data set.
  • Includes the revised pump data used in the second version of Snow's map from the Vestry report. This includes the corrected location of the Broad Street pump.
  • Adds two different aggregate time series fatalities data sets, taken from the Vestry report.

getting started

To install 'cholera' from CRAN:


To install the current/development version of 'cholera' from GitHub:

# Note that you may need to install the 'devtools' package:
# install.packages("devtools")
devtools::install_github("lindbrook/cholera", build_vignettes = TRUE)

Read the package's vignettes. They include detailed discussions about the data, the functions and the methods used to "fix" the data and to compute walking distances and neighborhoods.


neighborhoodWalking() is computationally intensive. Using the current/development version on a single core of a 2.3 GHz Intel i7, plotting observed paths takes about 8 seconds while expected paths takes about 35 seconds. When using the function's parallel implementation, these times fall to approximately 6 and 15 seconds using 4 physical or 8 logical cores.

Note that the parallelized version is currently only available on Linux and Mac. Also, note that the developers of the 'parallel' package strongly discourage against using parallelization within a GUI or embedded environment.


cholera 0.3.0

Data Changes

  • ortho.proj: reclassify case 483: Pulteney Court (I) ("242-1") -> Little Windmill Street ("326-2"). reclassify cases 369, 434, 11, 53, 193: from Poland Street ("194-1") -> St James Workhouse ("148-1").

Function Changes

  • addSnow() "area", "street" and "boundary" graphical annotation.

  • caseLocator() highlight home road segment.

  • neighborhoodWalking() "case-set" argument: "observed", "expected" and "snow". updated implementation and improved performance. pre-computed configurations from version 0.2.1 removed.

  • segmentLocator(), streetNameLocator() and streetNumberLocator() highlight segment or street cases. option to plot all cases, anchor cases or no cases.

New S3 Implementations

  • timeSeries()
  • walkingDistance() incorporates and deprecates walkingPath().

New Functions

  • addIndexCase()
  • nearestPath()
  • nearestPump()
  • nodeData()
  • segmentLength()
  • snowNeighborhood()
  • streetLength()
  • unitMeter()

New S3 Functions

  • classifierAudit()
  • euclideanDistance()

cholera 0.2.1

  • Initial CRAN release.

Reference manual

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


0.4.0 by Peter Li, 3 months ago

Browse source code at

Authors: Peter Li [aut, cre]

Documentation:   PDF Manual  

GPL (>= 2) license

Imports deldir, HistData, grDevices, igraph, KernSmooth, pracma, RColorBrewer, scales, sp, stats

Suggests ggplot2, knitr, rmarkdown

See at CRAN