@dra2020/district-analytics 5.0.1 → 5.1.0

package/dist/cli.js

@@ -89315,23 +89315,33 @@ const C = __importStar(__webpack_require__(/*! ./config */ "./src/config.ts"));
 const normalize_1 = __webpack_require__(/*! ./normalize */ "./src/normalize.ts");
 function scoreCountySplitting(rawValue, nCounties, nDistricts) {
     const _normalizer = new normalize_1.Normalizer(rawValue);
-    const best = C.countySplittingRange()[C.BEG];
-    const worst = countySplitThreshold(nCounties, nDistricts);
-    _normalizer.clip(best, worst);
-    _normalizer.unitize(best, worst);
+    const singleBest = C.countySplittingRange()[C.BEG];
+    const singleWorst = C.countySplittingRange()[C.END];
+    // The practical ideal score depends on the # of counties & districts
+    const avgBest = countySplitBest(nCounties, nDistricts);
+    const avgWorst = countySplitWorst(avgBest);
+    _normalizer.clip(avgBest, avgWorst);
+    _normalizer.unitize(avgBest, avgWorst);
     _normalizer.invert();
     _normalizer.rescale();
     return _normalizer.normalizedNum;
 }
 exports.scoreCountySplitting = scoreCountySplitting;
-function countySplitThreshold(nCounties, nDistricts) {
-    const m = C.allowableSplitsMultiplier();
-    const worst = C.countySplittingRange()[1];
-    const nAllowableSplits = Math.min(m * (nDistricts - 1), nCounties);
-    const threshold = ((nAllowableSplits * worst) + ((nCounties - nAllowableSplits) * 1.0)) / nCounties;
+function countySplitBest(nCounties, nDistricts) {
+    const practicalBest = C.countySplittingRange()[C.BEG];
+    const nAllowableSplits = Math.min(nDistricts - 1, nCounties);
+    const threshold = ((nAllowableSplits * practicalBest) + ((nCounties - nAllowableSplits) * 1.0)) / nCounties;
     return threshold;
 }
-exports.countySplitThreshold = countySplitThreshold;
+exports.countySplitBest = countySplitBest;
+function countySplitWorst(avgBest) {
+    const singleBest = C.countySplittingRange()[C.BEG];
+    const singleWorst = C.countySplittingRange()[C.END];
+    // The practical ideal score depends on the # of counties & districts
+    const avgWorst = avgBest * (singleWorst / singleBest);
+    return avgWorst;
+}
+exports.countySplitWorst = countySplitWorst;
 function scoreDistrictSplitting(rawValue) {
     const _normalizer = new normalize_1.Normalizer(rawValue);
     const best = C.districtSplittingRange()[C.BEG];
@@ -89793,7 +89803,7 @@ exports.scorePolsbyPopper = scorePolsbyPopper;
 /*! exports provided: partisan, minority, traditionalPrinciples, default */
 /***/ (function(module) {
 
-module.exports = JSON.parse("{\"partisan\":{\"bias\":{\"range\":[0,0.2],\"weight\":[50,80]},\"impact\":{\"weight\":[50,0],\"threshold\":4},\"competitiveness\":{\"overall\":{\"range\":[0,0.67],\"weight\":100},\"marginal\":{\"range\":[0,0.85],\"weight\":0},\"range\":[0.45,0.55],\"distribution\":[0.25,0.75],\"weight\":[0,20]},\"bonus\":2,\"weight\":[100,80]},\"minority\":{\"range\":[0.37,0.5],\"distribution\":[0.25,0.75],\"shift\":0.15,\"bonus\":20},\"traditionalPrinciples\":{\"compactness\":{\"reock\":{\"range\":[0.25,0.5],\"weight\":50},\"polsby\":{\"range\":[0.1,0.5],\"weight\":50},\"weight\":[0,50]},\"splitting\":{\"county\":{\"range\":[1,1.71],\"allowableSplitsMultiplier\":1.5,\"weight\":50},\"district\":{\"range\":[1,1.5],\"weight\":50},\"weight\":[0,50]},\"popdev\":{\"range\":[[0.0075,0.002],[0.1,-1]],\"weight\":[0,0]},\"weight\":[0,20]}}");
+module.exports = JSON.parse("{\"partisan\":{\"bias\":{\"range\":[0,0.2],\"weight\":[50,80]},\"impact\":{\"weight\":[50,0],\"threshold\":4},\"competitiveness\":{\"overall\":{\"range\":[0,0.67],\"weight\":100},\"marginal\":{\"range\":[0,0.85],\"weight\":0},\"range\":[0.45,0.55],\"distribution\":[0.25,0.75],\"weight\":[0,20]},\"bonus\":2,\"weight\":[100,80]},\"minority\":{\"range\":[0.37,0.5],\"distribution\":[0.25,0.75],\"shift\":0.15,\"bonus\":20},\"traditionalPrinciples\":{\"compactness\":{\"reock\":{\"range\":[0.25,0.5],\"weight\":50},\"polsby\":{\"range\":[0.1,0.5],\"weight\":50},\"weight\":[0,50]},\"splitting\":{\"county\":{\"range\":[1.26,1.68],\"weight\":50},\"district\":{\"range\":[1.26,1.68],\"weight\":50},\"weight\":[0,50]},\"popdev\":{\"range\":[[0.0075,0.002],[0.1,-1]],\"weight\":[0,0]},\"weight\":[0,20]}}");
 
 /***/ }),
 
@@ -89948,11 +89958,6 @@ function countySplittingRange(overridesJSON) {
     return range;
 }
 exports.countySplittingRange = countySplittingRange;
-function allowableSplitsMultiplier(overridesJSON) {
-    const m = config_json_1.default.traditionalPrinciples.splitting.county.allowableSplitsMultiplier;
-    return m;
-}
-exports.allowableSplitsMultiplier = allowableSplitsMultiplier;
 function districtSplittingWeight(overridesJSON) {
     const dsW = config_json_1.default.traditionalPrinciples.splitting.district.weight;
     return dsW;
@@ -90165,12 +90170,10 @@ function evalMinorityOpportunity(p, bLog = false) {
             averageDVf: averageDVf,
             bucketsByDemographic: bucketsByDemo
         },
-        // nOpportunity1: l1,
-        // nOpportunity2: l2,
         nProportional: pD,
         opportunityDistricts: oD,
         score: score,
-        details: {} // TODO - Add notes
+        details: {}
     };
     return mS;
 }
@@ -90500,7 +90503,7 @@ function scorePartisan(Vf, VfArray, options) {
         competitiveness: competitiveScoring,
         score: acrossStatesPartisanScore,
         score2: withinStatesPartisanScore,
-        details: {} // TODO - Add notes
+        details: {}
     };
     return s;
 }
@@ -91185,7 +91188,7 @@ function calcMinimalInverseResponsiveness(Vf, r) {
         const bBalanced = isBalanced(Vf);
         const ideal = bBalanced ? 0.1 : 0.2;
         MIR = (1 / r) - ideal;
-        MIR = U.trim(MIR);
+        MIR = U.trim(Math.max(MIR, 0.0));
     }
     return MIR;
 }
@@ -91290,7 +91293,7 @@ function scorePlan(p, overridesJSON) {
         compactness: cS,
         splitting: sS,
         populationDeviation: pdS,
-        details: {} // TODO - Add notes
+        details: {}
     };
     // PARTISAN ("fair") subcategories - bias, impact, & competitiveness (plus lots of supporting measures)
     const options = {
@@ -91311,7 +91314,7 @@ function scorePlan(p, overridesJSON) {
         minority: mS,
         traditionalPrinciples: tpS,
         score: score,
-        details: {} // TODO - Add notes
+        details: {}
     };
     return scorecard;
 }
@@ -91366,12 +91369,7 @@ function printScorecardRow(xx, name, N, Vf, s) {
     s.partisan.bias.score, s.partisan.impact.unearnedS, // 9
     s.partisan.impact.score, s.partisan.competitiveness.cSimple, // 11
     s.partisan.competitiveness.cD, s.partisan.competitiveness.mD, s.partisan.competitiveness.score, s.partisan.score2, // 15
-    s.traditionalPrinciples.compactness.reock.raw, s.traditionalPrinciples.compactness.reock.normalized, s.traditionalPrinciples.compactness.polsby.raw, s.traditionalPrinciples.compactness.polsby.normalized, s.traditionalPrinciples.compactness.score, s.traditionalPrinciples.splitting.county.raw, s.traditionalPrinciples.splitting.county.normalized, s.traditionalPrinciples.splitting.district.raw, s.traditionalPrinciples.splitting.district.normalized, s.traditionalPrinciples.splitting.score, s.traditionalPrinciples.populationDeviation.raw, s.traditionalPrinciples.populationDeviation.normalized, s.traditionalPrinciples.score, 
-    // s.minority.nOpportunity1,
-    // s.minority.nOpportunity2,
-    s.minority.opportunityDistricts, 
-    // s.minority.nProportional,
-    s.minority.score, s.score);
+    s.traditionalPrinciples.compactness.reock.raw, s.traditionalPrinciples.compactness.reock.normalized, s.traditionalPrinciples.compactness.polsby.raw, s.traditionalPrinciples.compactness.polsby.normalized, s.traditionalPrinciples.compactness.score, s.traditionalPrinciples.splitting.county.raw, s.traditionalPrinciples.splitting.county.normalized, s.traditionalPrinciples.splitting.district.raw, s.traditionalPrinciples.splitting.district.normalized, s.traditionalPrinciples.splitting.score, s.traditionalPrinciples.populationDeviation.raw, s.traditionalPrinciples.populationDeviation.normalized, s.traditionalPrinciples.score, s.minority.opportunityDistricts, s.minority.score, s.score);
 }
 exports.printScorecardRow = printScorecardRow;
 
@@ -102185,7 +102183,7 @@ Compactness: None
 Proportionality: 27.67% gap
 Cohesiveness: 11 unexpected splits, affecting 27.14% of the total population
  
-These counties are split unexpectedly:
+These counties are split unexpectedly (meaning that they're smaller than a district):
  
    • Bladen
    • Buncombe
@@ -102289,6 +102287,7 @@ function doFindCountiesSplitUnexpectedly(s, bLog = false) {
     }
     countiesSplitUnexpectedly = countiesSplitUnexpectedly.sort();
     test['score'] = U.trim(unexpectedAffected);
+    test['details']['nSplits'] = nSplits;
     test['details']['unexpectedSplits'] = unexpectedSplits;
     test['details']['countiesSplitUnexpectedly'] = countiesSplitUnexpectedly;
     return test;
@@ -102571,6 +102570,49 @@ function gfDiameter(poly) {
 exports.gfDiameter = gfDiameter;
 
 
+/***/ }),
+
+/***/ "./src/minority.ts":
+/*!*************************!*\
+  !*** ./src/minority.ts ***!
+  \*************************/
+/*! no static exports found */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+//
+// PROTECTS MINORITIES
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const majority_minority_json_1 = __importDefault(__webpack_require__(/*! ../static/majority-minority.json */ "./static/majority-minority.json"));
+const vra5_preclearance_json_1 = __importDefault(__webpack_require__(/*! ../static/vra5-preclearance.json */ "./static/vra5-preclearance.json"));
+// import stateContacts from '../static/state-contacts.json';
+// import demographicDefs from '../static/demographic-defns.json';
+// TODO - 2020: Update/revise this, when the update comes out in September:
+// Sources for majority-minority info:
+// - https://en.wikipedia.org/wiki/List_of_majority-minority_United_States_congressional_districts
+// - http://www.ncsl.org/Portals/1/Documents/Redistricting/Redistricting_2010.pdf (PP. 80–84)
+// - https://www.justice.gov/crt/jurisdictions-previously-covered-section-5
+function getMajorityMinority(s) {
+    const xx = s.state.xx;
+    const mMDict = majority_minority_json_1.default;
+    const stateMM = mMDict[xx];
+    return stateMM;
+}
+exports.getMajorityMinority = getMajorityMinority;
+function getVRASection5(s) {
+    const xx = s.state.xx;
+    const vraPreDict = vra5_preclearance_json_1.default;
+    const stateVRAPre = vraPreDict[xx];
+    return stateVRAPre;
+}
+exports.getVRASection5 = getVRASection5;
+
+
 /***/ }),
 
 /***/ "./src/political.ts":
@@ -103000,6 +103042,7 @@ function doAnalyzePostProcessing(s, bLog = false) {
     scorecard.traditionalPrinciples.details['census'] = datasets.census;
     const simpleSplits = s.getTest(5 /* UnexpectedCountySplits */);
     scorecard.traditionalPrinciples.details['unexpectedAffected'] = simpleSplits['score'];
+    scorecard.traditionalPrinciples.details['nSplits'] = simpleSplits['details']['nSplits'];
     scorecard.traditionalPrinciples.details['countiesSplitUnexpectedly'] = U.deepCopy(simpleSplits['details']['countiesSplitUnexpectedly']);
     // NOTE - Add split precincts in dra-client directly
     // Derive secondary tests
@@ -103035,6 +103078,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const Score = __importStar(__webpack_require__(/*! @dra2020/dra-score */ "./node_modules/@dra2020/dra-score/dist/dra-score.bundle.js"));
 const U = __importStar(__webpack_require__(/*! ./utils */ "./src/utils.ts"));
 const D = __importStar(__webpack_require__(/*! ./_data */ "./src/_data.ts"));
+const M = __importStar(__webpack_require__(/*! ./minority */ "./src/minority.ts"));
 // PROFILE A PLAN
 function profilePlan(s, bLog = false) {
     const state = s.state.xx;
@@ -103154,7 +103198,9 @@ function scorePlan(s, p, bLog = false, overridesJSON) {
     let summaryRow = s.districts.numberOfRows() - 1;
     totalPop[summaryRow] = p.populationProfile.targetSize;
     popDevPct[summaryRow] = popDev;
-    //
+    // Add minority notes
+    scorecard.minority.details['majorityMinority'] = M.getMajorityMinority(s);
+    scorecard.minority.details['vraPreclearance'] = M.getVRASection5(s);
     return scorecard;
 }
 exports.scorePlan = scorePlan;
@@ -103688,6 +103734,17 @@ function isEmbedded(districtID, geoIDs, plan, graph) {
 exports.isEmbedded = isEmbedded;
 
 
+/***/ }),
+
+/***/ "./static/majority-minority.json":
+/*!***************************************!*\
+  !*** ./static/majority-minority.json ***!
+  \***************************************/
+/*! exports provided: AL, AK, AZ, AR, CA, CO, CT, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, default */
+/***/ (function(module) {
+
+module.exports = JSON.parse("{\"AL\":{\"Black\":[7],\"Hispanic\":[],\"Pacific\":[]},\"AK\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"AZ\":{\"Black\":[],\"Hispanic\":[2,4,7],\"Pacific\":[]},\"AR\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"CA\":{\"Black\":[13,37,43],\"Hispanic\":[17,18,20,21,28,31,32,34,35,38,39,43,45,47,51],\"Pacific\":[12,13,14,15,17,18,19,27,34,39,45,47,52]},\"CO\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"CT\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"DE\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"FL\":{\"Black\":[5,20,24],\"Hispanic\":[18,21,25],\"Pacific\":[]},\"GA\":{\"Black\":[2,4,5,13],\"Hispanic\":[],\"Pacific\":[]},\"HI\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[2]},\"ID\":{\"Black\":[],\"Hispanic\":[1],\"Pacific\":[]},\"IL\":{\"Black\":[1,2,7],\"Hispanic\":[4],\"Pacific\":[]},\"IN\":{\"Black\":[7],\"Hispanic\":[],\"Pacific\":[]},\"IA\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"KS\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"KY\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"LA\":{\"Black\":[2],\"Hispanic\":[],\"Pacific\":[]},\"ME\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"MD\":{\"Black\":[4,7],\"Hispanic\":[],\"Pacific\":[]},\"MA\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"MI\":{\"Black\":[13,14],\"Hispanic\":[],\"Pacific\":[]},\"MN\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"MS\":{\"Black\":[2],\"Hispanic\":[],\"Pacific\":[]},\"MO\":{\"Black\":[1,5],\"Hispanic\":[],\"Pacific\":[]},\"MT\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"NE\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"NV\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"NH\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"NJ\":{\"Black\":[10,12],\"Hispanic\":[13],\"Pacific\":[6]},\"NM\":{\"Black\":[],\"Hispanic\":[2,13],\"Pacific\":[]},\"NY\":{\"Black\":[5,8,9,13],\"Hispanic\":[12,16],\"Pacific\":[6,7,10]},\"NC\":{\"Black\":[1,12],\"Hispanic\":[],\"Pacific\":[]},\"ND\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"OH\":{\"Black\":[3,11],\"Hispanic\":[],\"Pacific\":[]},\"OK\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"OR\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"PA\":{\"Black\":[2],\"Hispanic\":[],\"Pacific\":[]},\"RI\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"SC\":{\"Black\":[6],\"Hispanic\":[],\"Pacific\":[]},\"SD\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"TN\":{\"Black\":[9],\"Hispanic\":[],\"Pacific\":[]},\"TX\":{\"Black\":[9,18,33],\"Hispanic\":[15,16,19,20,23,27,28,29,32],\"Pacific\":[]},\"UT\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"VT\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"VA\":{\"Black\":[3],\"Hispanic\":[],\"Pacific\":[]},\"WA\":{\"Black\":[],\"Hispanic\":[3],\"Pacific\":[9]},\"WV\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]},\"WI\":{\"Black\":[4],\"Hispanic\":[],\"Pacific\":[]},\"WY\":{\"Black\":[],\"Hispanic\":[],\"Pacific\":[]}}");
+
 /***/ }),
 
 /***/ "./static/state-reqs.json":
@@ -103701,6 +103758,17 @@ module.exports = JSON.parse("{\"AL\":\"https://www.brennancenter.org/sites/defau
 
 /***/ }),
 
+/***/ "./static/vra5-preclearance.json":
+/*!***************************************!*\
+  !*** ./static/vra5-preclearance.json ***!
+  \***************************************/
+/*! exports provided: AL, AK, AZ, CA, FL, GA, LA, MI, MS, NY, NC, SC, SD, TX, VA, default */
+/***/ (function(module) {
+
+module.exports = JSON.parse("{\"AL\":\"all\",\"AK\":\"all\",\"AZ\":\"all\",\"CA\":\"parts\",\"FL\":\"parts\",\"GA\":\"all\",\"LA\":\"all\",\"MI\":\"parts\",\"MS\":\"all\",\"NY\":\"parts\",\"NC\":\"parts\",\"SC\":\"all\",\"SD\":\"parts\",\"TX\":\"all\",\"VA\":\"all\"}");
+
+/***/ }),
+
 /***/ "./test/_cli.ts":
 /*!**********************!*\
   !*** ./test/_cli.ts ***!