NEWS

cholera 0.7.0.9032
==================

- migration prep.
- amend GitHub "Roads" vignette.


cholera 0.7.0.9031
==================

- use dontrun for examples with parallel code (R 4.0.0).


cholera 0.7.0.9030
==================

- theta() -> radians().


cholera 0.7.0.9029
==================

- road.segments2: "lon" and "lat" -> "longitude" and "latitude".


cholera 0.7.0.9028
==================

- amend latitudeLongitude().
- rotatePoint(point.type) -> rotatePoint(dataset).
- amend referenceRadians().


cholera 0.7.0.9027
==================

- consolidate of pointCentroids(), pointsFromGeoTIFF(), roadsLatLong() and
  rotatePoint() into latitudeLongitude().


cholera 0.7.0.9026
==================

- add rotatePoint(point.type = c("fatalities.address").
- use :: in snowMap2() prototype.
- add longitude and latitude to fatalities.address2 and pumps.vestry2 (experimental).


cholera 0.7.0.9025
==================

- add longitude and latitude to pumps2 (experimental).
- add snowMap2() prototype.


cholera 0.7.0.9024
==================

- remove roadsPlot().
- add rotatePoint(point.type = c("fatalities", "pumps", "pumps.vestry", "roads").
- add longitude and latitude to fatalities2 (experimental).


cholera 0.7.0.9023
==================

- "back of envelope" lat-long difference estimate.


cholera 0.7.0.9022
==================

- add unitMeter(input.unit = "latlong").


cholera 0.7.0.9021
==================

- roads2: x2 -> longitude; y2 -> latitude.
- add roadsLatLong() prototype.
- fix meter benchmnark typo: Silver Street -> Cross Street.
- add roadSegments2() prototype.
- add road.segments2 prototype.


cholera 0.7.0.9020
==================

- add roads2 prototype.


cholera 0.7.0.9019
==================

- amend roads2 (experimental).


cholera 0.7.0.9018
==================

- add rotatePoint(unique.coords = TRUE).
- use roads$id as index in rotatePoint().
- fix quadrants I & IV in rotatePoint().


cholera 0.7.0.9017
==================

- amend rotatePoint() prototype.


cholera 0.7.0.9016
==================

- add rotatePoint() prototype.


cholera 0.7.0.9015
==================

- add longitude and latitude to roads2 (experimental).


cholera 0.7.0.9014
==================

- add pointCentroids() prototype.


cholera 0.7.0.9013
==================

- add road.gcp.points (experimental).


cholera 0.7.0.9012
==================

- add pointsFromGeoTIFF().
- add roadsPlot().


cholera 0.7.0.9011
==================

- change README figures from 6" to 5.5".
- test multi.core = TRUE.


cholera 0.7.0.9010
==================

- fix unneeded warnings in addEuclideanPath().
- add subtitles for selected pumps in plot.euclidean().


cholera 0.7.0.9009
==================

- use 'viridisLite' in isoLines().
- copyedit "note on computational performance".


cholera 0.7.0.9008
==================

- add discussion of Euclidean/Voronoi "expected" neighborhoods.


cholera 0.7.0.9007
==================

- add parLapply() for isoVertices() for Windows.


cholera 0.7.0.9006
==================

- change 'RColorBrewer' to 'viridisLite' in plot.iso().


cholera 0.7.0.9005
==================

- add plot.iso(selected.post = "all").


cholera 0.7.0.9004
==================

- add amended isoVertices() prototype.


cholera 0.7.0.9003
==================

- note parallelization vignette in cholera-package.Rd.
- add and set default neighborhoodVoronoi(pump.location = "nominal").


cholera 0.7.0.9002
==================

- set neighborhoodVoronoi(case.location = "address") as default.


cholera 0.7.0.9001
==================

- add amended isoLines() prototype.


cholera 0.7.0.9000
==================

- amend references: Paumgarten and Winter.


cholera 0.7.0
==================

# New Feature #

- support for parallel computation on Windows.

# Fixes #

- fix computation of core in neighborhoodWalking().
- fix nearestPump(metric = "euclidean", case.set = ("observed", "expected")).

# Function Changes #

- rename and amend simWalkingDistance() to simulateWalkingDistance().
- deprecate case.set argument in addNeighborhoodCases().
- add nearestPump(metric = "walking", case.set = "expected").
- amend expectedCount() for summary.walking().
- add unstackAuxiliaryFunctions.R

# Vignettes #

- add Parallelization vignette.


cholera 0.6.5
==================

# Fixes #

- fix plot.walking_path() timeposts.
- fix plot.walking_path(observed = FALSE).
- fix St James Workhouse for walkingPath(type = "cases").
- fix St James Workhouse for euclideanPath(type = "cases").
- fix city squares for plot.euclidean_path().
- fix computed time in nearestPump() and amend sim.walking.distance.

# New Data #

- add sim.walking.distance.

# Function Changes #

- add nearestPump(metric = "euclidean").
- add distance.unit argument to addWhitehead().
- add pch and point.size arguments to addNeighborhoodCases().
- add pos argument to addCase().
- add output argument to voronoiPolygons().
- add summary.euclidean(), summary.voronoi() and summary.walking().
- add multi.core argument to simWalkingDistance().
- add case.location to addEuclideanPath().
- add 'case' argument to pumpCase().
- amend travelingSalesman() argument in addSnow().
- amend print.euclidean(), print.voronoi() and print.walking().
- amend argument 'case' to 'data' in addKernelDensity().
- amend plot.walking() titles.
- deprecate pearlString() in favor of travelingSalesman().
- deprecate statistic argument in neighborhoodVoronoi().
- enable col argument in addRoads().
- enable 'address' and 'nominal' cases in plot.voronoi().
- exclude landmarks from case.set - "expected".
- rename deldirVertices() back to voronoiPolygons().

# Vignettes #

- rename "deldirPolygons()" to "voronoiPolygons()".
- remove Pump Neighborhoods vignette.

# DESCRIPTION #

- remove 'scales" from Imports.


cholera 0.6.0
==================

# Fixes #

- fix title in euclideanPath(type = "case-pump").
- fix destination label for walkingPath(destination = NULL).

# Data Changes #

- add Earl of Aberdeen residence (Argyll House).
- nominal and orthogonal coordinates for landmarks.

# Function Changes #

- addNeighborhood() -> addNeighborhoodWalking()

# Function Changes - new arguments #

- addSnow(type = "perimeter", line.width = 2)
- neighborhoodData(embed = TRUE, embed.landmarks = TRUE)
- neighborhoodEuclidean(case.set = "expected")
- plot.voronoi(voronoi.cells = TRUE, delauny.triangles = FALSE)
- snowMap(...)
- streetNameLocator(add.subtitle = TRUE, token = id)
- streetNumberLocator(add.subtitle = TRUE, token = id)

# Function Changes - polygon.method argument #

- addNeighborhoodEuclidean(polygon.method = "traveling.salesman")
- plot.euclidean(polygon.method = "traveling.salesman")

- addNeighborhoodWalking(polygon.method = "pearl.string")
- plot.walking(polygon.method = "pearl.string")

# Function Change - landmarks as origin and/or destination (treated as cases) #

- euclideanPath()
- walkingPath()
- find nearest case or landmark, given pump (i.e., reverse lookup)

# Function Changes - case.location argument: "address" or "nominal" #

- addVoronoi(case.location = "nominal")
- euclideanPath(case.location = "nominal")
- neighborhoodEuclidean(case.location = "nominal")
- addNeighborhoodEuclidean(case.location = "nominal")

# New Functions #

- addCase()
- addDelauny()
- addNeighborhoodCases()
- deldirVertices()
- orthogonalProjection()
- profile2D()
- profile3D()
- streetHighlight()

# New Exported Functions #

- fixFatalities()
- landmarkData()

# New S3 Function #

- pearsonResiduals()
- plot.neighborhood_data()

# New Vignette #

- "deldirVertices(): Tiles, Triangles and Polygons"

# Deprecated Functions #

- euclideanDistance()
- walkingDistance()


cholera 0.5.1
==================

# Fixes #

- backward compatibility (R 3.4.4) related to base::isFALSE() & bug fix.
- fix for multiple results in walkingDistance() and walkingPath().

# Function Changes #

- enable ellipses (...) in plot.time_series() (#1).
- enable ellipses and negative selection in addPump().
- consolidate addEuclideanPath(), euclideanDistance(), euclideanPath(),
  walkingDistance() and walkingPath()

# New Functions #

- addBorder()
- addRoads()
- mapRange()


cholera 0.5.0
==================

# Data Changes #

- regular.cases and sim.ortho.proj:
  increase number of observations from 5K to 20K.

# Function Changes #

- "alpha.level" argument to control path transparency
    addEuclideanPath() and addWalkingPath()

- distance and time based "mileposts"
    addEuclideanPath() and addWalkingPath().
    plot.euclidean_path() and plot.walking_path().
    addMilePosts().

- "pump.subset" and "pump.select" arguments
    addCase(), addKernelDensity(), addMilePosts(), addNeighborhood(),
    neighborhoodEuclidean(), neighborhoodWalking()

- "walking.speed" argument added to:
    addMilePosts(), nearestPump(),
    addEuclideanPath(), euclideanDistance(), euclideanPath(),
    addWalkingPath(), walkingDistance(), walkingPath()

- euclideanDistance() no longer S3.
    generic S3 functionality moved to euclideanPath().

- multiCore() moved to multiCore.R.

- neighborhoodVoronoi()
    plot.voronoi() adds "euclidean.paths" argument for star graph.

- neighborhoodWalking()
    "area.polygons" related functions for plot_walking() moved to
    pearlString.R.

- simulateFatalities():
  default is now 20K observations.
  use proximate in addition to orthogonal distances to find "addresses".

- snowMap() new arguments:
  "add.cases", "add.pumps", "add.roads".

- unitMeter() default unit of measurement is now "meter".

- walkingAuxillaryFunctions.R:
    location of walking related helper functions.

- walkingDistance() no longer S3.
    generic S3 functionality moved to walkingPath().

# New Functions #

- addCase()
- addEuclideanPath()
- addMilePosts()
- addNeighborhood()
- addWalkingPath()()
- distanceTime()

# New S3 Functions #

- euclideanPath()
- walkingPath()
- neighborhoodEuclidean()

# Vignette Changes #

- Lab Notes available online and on GitHub:
  "duplicate.missing.cases.notes"
  "pump.neighborhoods.notes"
  "unstacking.bars.notes"


cholera 0.4.0
==================

# Data Changes #

- ortho.proj.pump and ortho.proj.pump.vestry now include node ID.

- roads and road.segments amend street names:
    "Unknown-B" to "Tent Court" (Edmund Cooper's map).
    "Unknown-D" to "St James's Market" (https://maps.nls.uk).
    "Unknown-E" to "Market Street (II)" (https://maps.nls.uk).

# Function Changes #

- addKernelDensity()
  uses "pump.subset" and "pump.select" arguments.

- addLandmarks()
  add landmarks from Edmund Cooper's map.

- classifierAudit() can return coordinates of address.

- nearestPump() now incorporates nearestPath().

- neighborhoodWalking()
  segment and sub-segment implementation.

- pumpData()
  returns node ID.

- timeSeries()
  includes day of the week.

- walkingDistance()
  add "simulated" expected cases.

# New Functions #

- addNeighborhood()

# New S3 Implementations #

- plot.walking
  type = "area.points" and type = "area-polygons".
  type = "area-polygons" via pearlString() replaces alphahull::ashape().

- print.walking() uses expectedCount().

# Vignette Changes #

- add "Kernel Density Plot".
- update "Pump Neighborhoods" with discussion of area plots.


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:
      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.