reportPlans {BARD}R Documentation

evaluate a set of plans

Description

This function evaluates scores, and differences among a set of plans.

Usage

  reportPlans(
  plans,
  scoreFUNs=list(
    "Contiguity"=calcContiguityScore,
    "Holes"=calcHolesScore,
    "LW Compact"=calcLWCompactScore,
    "Reock"=calcReockScore
  ),
  doplot=FALSE,
  domatch=TRUE,
  dodiff=TRUE,
  dodetails=FALSE,
  doprofileextras=TRUE,
  plotOpts=NULL
  )

Arguments

plans a list of bard plans.
scoreFUNs a list of named score functions that accept a plan as an argument, and return a vector of scores
domatch logical, whether to attempt to reorder district ID's to match
doplot Logical. Whether to plot differences.
dodetails Logical. Print detailed information
dodiff Logical. Report differences between pairs of plans
doprofileextras Logical. Report profile summaries for bardSample results
plotOpts List of plotting options to send to plan plotting command

Details

This is the externally visible routine for comparing a list of plans. If multiple plans are given, each is compared against the first plan in the list.

Value

Nothing. The function is used for printing and plotting effect.

Note

Note the following limitation: all plans being compared must have the same number of districts and basemap

Author(s)

Micah Altman Micah_Altman@harvard.edu http://www.hmdc.harvard.edu/micah_altman/

References

Micah Altman, 1997. ``Is Automation the Answer? The Computational Complexity of Automated Redistricting'', Rutgers Computer and Technology Law Journal 23 (1), 81-142 http://www.hmdc.harvard.edu/micah_altman/pubpapers.shtml

Altman, M. 1998. Modeling the Effect of Mandatory District Compactness on Partisan Gerrymanders, Political Geography 17:989-1012.

Micah Altman and Michael P. McDonald. 2004. A Computation Intensive Method for Detecting Gerrymanders Paper presented at the annual meeting of the The Midwest Political Science Association, Palmer House Hilton, Chicago, Illinois, Apr 15, 2004. http://www.allacademic.com/meta/p83108_index.html

Micah Altman, Karin Mac Donald, and Michael P. McDonald, 2005. ``From Crayons to Computers: The Evolution of Computer Use in Redistricting'' Social Science Computer Review 23(3): 334-46.

See Also

Scoring functions: calcContiguityScore Component functions: scorePlans , diff.bardPlan

Examples

  suffolk.map <- importBardShape(
    system.file("shapefiles/suffolk_tracts.shp", package="BARD"))
    
  # choose number of districts
  ndists <- 5

  # create some initial plans
  kplan1 <- createKmeansPlan(suffolk.map,ndists)
  kplan2 <- createKmeansPlan(suffolk.map,ndists)
reportPlans(plans=list("kmeans"=kplan1,"kmeans 2"=kplan2), doplot=TRUE)


[Package BARD version 1.03 Index]