reportPlans {BARD} | R Documentation |
This function evaluates scores, and differences among a set of plans.
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 )
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 |
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.
Nothing. The function is used for printing and plotting effect.
Note the following limitation: all plans being compared must have the same number of districts and basemap
Micah Altman Micah_Altman@harvard.edu http://www.hmdc.harvard.edu/micah_altman/
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.
Scoring functions: calcContiguityScore
Component functions: scorePlans
, diff.bardPlan
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)