@dra2020/district-analytics 10.1.2 → 10.2.2

package/dist/district-analytics.js

@@ -177,8 +177,8 @@ class AnalyticsSession {
     }
     // 11-03-2020 - Added for racially polarized voting analysis
     // NOTE - This assumes that analyzePlan() has been run!
-    analyzeRacialPolarization(id, bLog = false) {
-        return minority_1.doAnalyzeRacialPolarization(this, id, bLog);
+    analyzeRacialPolarization(districtID, groups, bLog = false) {
+        return minority_1.doAnalyzeRacialPolarization(this, districtID, groups, bLog);
     }
     // NOTE - This assumes that analyzePlan() has been run!
     getDistrictStatistics(bLog = false) {
@@ -669,7 +669,7 @@ class Districts {
         return countyIndex;
     }
     // 11-03-2020 - Added for racially polarized voting analysis
-    extractVotesByDemographic(districtID, bLog = false) {
+    extractVotesByDemographic(districtID, groups, bLog = false) {
         let whitePts = [];
         let minorityPts = [];
         let blackPts = [];
@@ -696,39 +696,75 @@ class Districts {
                         // Calculate the Dem two-party vote
                         const featureDem = outerThis._session.features.fieldForFeature(f, "ELECTION" /* ELECTION */, "D" /* DemVotes */);
                         const featureRep = outerThis._session.features.fieldForFeature(f, "ELECTION" /* ELECTION */, "R" /* RepVotes */);
-                        const featureTot = outerThis._session.features.fieldForFeature(f, "ELECTION" /* ELECTION */, "Tot" /* TotalVotes */);
-                        const pctDem = featureDem / (featureDem + featureRep);
-                        // Calculate the VAP/CVAP percentages by demographic
-                        const totalVAP = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "Tot" /* TotalPop */);
-                        if (totalVAP > 0) {
-                            const whitePop = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "Wh" /* WhitePop */);
-                            const pctWhite = whitePop / totalVAP;
-                            const minorityPop = totalVAP - whitePop;
-                            const pctMinority = minorityPop / totalVAP;
-                            const pctBlack = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "BlC" /* BlackPop */) / totalVAP;
-                            const pctHispanic = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "His" /* HispanicPop */) / totalVAP;
-                            const pctPacific = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "PacC" /* PacificPop */) / totalVAP;
-                            const pctAsian = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "AsnC" /* AsianPop */) / totalVAP;
-                            const pctNative = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "NatC" /* NativePop */) / totalVAP;
-                            whitePts.push({ x: pctWhite, y: pctDem });
-                            minorityPts.push({ x: pctMinority, y: pctDem });
-                            blackPts.push({ x: pctBlack, y: pctDem });
-                            hispanicPts.push({ x: pctHispanic, y: pctDem });
-                            pacificPts.push({ x: pctPacific, y: pctDem });
-                            asianPts.push({ x: pctAsian, y: pctDem });
-                            nativePts.push({ x: pctNative, y: pctDem });
+                        // const featureTot = outerThis._session.features.fieldForFeature(f, T.Dataset.ELECTION, T.FeatureField.TotalVotes);
+                        if ((featureDem + featureRep) > 0) {
+                            const pctDem = featureDem / (featureDem + featureRep);
+                            // Calculate the VAP/CVAP percentages by demographic
+                            const totalVAP = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "Tot" /* TotalPop */);
+                            if (totalVAP > 0) {
+                                // Gather all points, for debugging purposes ...
+                                const whitePop = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "Wh" /* WhitePop */);
+                                const pctWhite = whitePop / totalVAP;
+                                const minorityPop = totalVAP - whitePop;
+                                const pctMinority = minorityPop / totalVAP;
+                                const pctBlack = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "BlC" /* BlackPop */) / totalVAP;
+                                const pctHispanic = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "His" /* HispanicPop */) / totalVAP;
+                                const pctPacific = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "PacC" /* PacificPop */) / totalVAP;
+                                const pctAsian = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "AsnC" /* AsianPop */) / totalVAP;
+                                const pctNative = outerThis._session.features.fieldForFeature(f, "VAP" /* VAP */, "NatC" /* NativePop */) / totalVAP;
+                                let bGoodPoints = true;
+                                // bGoodPoints = (Number.isNaN(pctDem)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctWhite)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctMinority)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctBlack)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctHispanic)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctPacific)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctAsian)) ? false : true;
+                                // bGoodPoints = (Number.isNaN(pctNative)) ? false : true;
+                                if (bGoodPoints) {
+                                    whitePts.push({ x: pctWhite, y: pctDem });
+                                    minorityPts.push({ x: pctMinority, y: pctDem });
+                                    blackPts.push({ x: pctBlack, y: pctDem });
+                                    hispanicPts.push({ x: pctHispanic, y: pctDem });
+                                    pacificPts.push({ x: pctPacific, y: pctDem });
+                                    asianPts.push({ x: pctAsian, y: pctDem });
+                                    nativePts.push({ x: pctNative, y: pctDem });
+                                }
+                                else {
+                                    if (bLog) {
+                                        console.log("NaN value for feature ", featureID);
+                                        console.log("pctDem: ", pctDem);
+                                        console.log("pctWhite: ", pctWhite);
+                                        console.log("pctMinority: ", pctMinority);
+                                        console.log("pctBlack: ", pctBlack);
+                                        console.log("pctHispanic: ", pctHispanic);
+                                        console.log("pctPacific: ", pctPacific);
+                                        console.log("pctAsian: ", pctAsian);
+                                        console.log("pctNative: ", pctNative);
+                                    }
+                                }
+                            }
+                            else {
+                                if (bLog)
+                                    console.log("Total VAP not > 0.");
+                            }
+                        }
+                        else {
+                            if (bLog)
+                                console.log("D + R not > 0.");
                         }
                     }
                 }
             });
+            // ... but only keep points for the demographics that are going to be analyzed
             return {
                 white: whitePts,
-                minority: minorityPts,
-                black: blackPts,
-                hispanic: hispanicPts,
-                pacific: pacificPts,
-                asian: asianPts,
-                native: nativePts
+                minority: groups.minority ? minorityPts : [],
+                black: groups.black ? blackPts : [],
+                hispanic: groups.hispanic ? hispanicPts : [],
+                pacific: groups.pacific ? pacificPts : [],
+                asian: groups.asian ? asianPts : [],
+                native: groups.native ? nativePts : []
             };
         }
         // If a district is empty
@@ -1407,7 +1443,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const U = __importStar(__webpack_require__(/*! ./utils */ "./src/utils.ts"));
-const score_1 = __webpack_require__(/*! ./score */ "./src/score.ts");
 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"));
 // TODO - 2020: Update/revise this, when the update comes out in September:
@@ -1431,33 +1466,36 @@ function getVRASection5(s) {
 exports.getVRASection5 = getVRASection5;
 // 11-03-2020 - Added for racially polarized voting analysis
 // Analyze the degree of racially polarized voting for a district
-function doAnalyzeRacialPolarization(s, districtID, bLog = false) {
-    const points = s.districts.extractVotesByDemographic(districtID, bLog);
-    if (points === undefined)
+function doAnalyzeRacialPolarization(s, districtID, groups, bLog = false) {
+    // Either take take the minorities to analyze in as selections -or- infer them
+    // from the % VAP/CVAP for the district (not the state).
+    if (groups == undefined) {
+        const RPV_THRESHOLD = 0.35; // Using ~ the Bethune–Hill threshold
+        groups = {
+            white: true,
+            minority: false,
+            black: (s.districts.table.blackPct[districtID] > RPV_THRESHOLD) ? true : false,
+            hispanic: (s.districts.table.hispanicPct[districtID] > RPV_THRESHOLD) ? true : false,
+            pacific: (s.districts.table.pacificPct[districtID] > RPV_THRESHOLD) ? true : false,
+            asian: (s.districts.table.asianPct[districtID] > RPV_THRESHOLD) ? true : false,
+            native: (s.districts.table.nativePct[districtID] > RPV_THRESHOLD) ? true : false
+        };
+    }
+    if (!(groups.black || groups.hispanic || groups.pacific || groups.asian || groups.native))
         return undefined;
-    const nDistricts = s.state.nDistricts;
-    const statewide = score_1.getStatewideDemographics(s, bLog);
-    // Which minority groups are big enough that proportional representation would give them one or more seats?
-    const bDoBlack = (calcProportionalDistricts(statewide.black, nDistricts) > 0) ? true : false;
-    const bDoHispanic = (calcProportionalDistricts(statewide.hispanic, nDistricts) > 0) ? true : false;
-    const bDoPacific = (calcProportionalDistricts(statewide.pacific, nDistricts) > 0) ? true : false;
-    const bDoAsian = (calcProportionalDistricts(statewide.asian, nDistricts) > 0) ? true : false;
-    const bDoNative = (calcProportionalDistricts(statewide.native, nDistricts) > 0) ? true : false;
-    if (!(bDoBlack || bDoHispanic || bDoPacific || bDoAsian || bDoNative))
+    const points = s.districts.extractVotesByDemographic(districtID, groups, bLog);
+    if (points === undefined)
         return undefined;
     // At this point, at least one single-race/ethnicity minority demographic needs
-    // to be analyzed, so white & all minorities combined will need to be as well.
-    //
-    // const bDoWhite: boolean = (calcProportionalDistricts(statewide.white, nDistricts) > 0) ? true : false;
-    // const bDoMinority: boolean = (calcProportionalDistricts(statewide.minority, nDistricts) > 0) ? true : false;
+    // to be analyzed along with white.
     const result = {
-        white: calcMaxVoteShare(points.white),
-        minority: calcMaxVoteShare(points.minority),
-        black: bDoBlack ? calcMaxVoteShare(points.black) : undefined,
-        hispanic: bDoHispanic ? calcMaxVoteShare(points.hispanic) : undefined,
-        pacific: bDoPacific ? calcMaxVoteShare(points.pacific) : undefined,
-        asian: bDoAsian ? calcMaxVoteShare(points.asian) : undefined,
-        native: bDoNative ? calcMaxVoteShare(points.native) : undefined
+        white: characterizeDemographicVoting(points.white),
+        minority: groups.minority ? characterizeDemographicVoting(points.minority) : undefined,
+        black: groups.black ? characterizeDemographicVoting(points.black) : undefined,
+        hispanic: groups.hispanic ? characterizeDemographicVoting(points.hispanic) : undefined,
+        pacific: groups.pacific ? characterizeDemographicVoting(points.pacific) : undefined,
+        asian: groups.asian ? characterizeDemographicVoting(points.asian) : undefined,
+        native: groups.native ? characterizeDemographicVoting(points.native) : undefined
     };
     return result;
 }
@@ -1492,11 +1530,17 @@ function linearRegression(points) {
     result['r2'] = Math.pow((n * sum_xy - sum_x * sum_y) / Math.sqrt((n * sum_xx - sum_x * sum_x) * (n * sum_yy - sum_y * sum_y)), 2);
     return result;
 }
-function calcMaxVoteShare(points) {
+function characterizeDemographicVoting(points) {
     const { m, b, r2 } = linearRegression(points);
     const maxVAPPct = 1.0; // 100%
     const maxDemPct = Math.max(0.0, Math.min(1.0, (m * maxVAPPct) + b));
-    return U.trim(maxDemPct);
+    const result = {
+        m: U.trim(m),
+        b: U.trim(b),
+        r2: U.trim(r2),
+        f1: U.trim(maxDemPct)
+    };
+    return result;
 }