@dra2020/dra-analytics 3.1.4 → 3.2.1

package/cli/partisan.ts

@@ -123,13 +123,13 @@ function trim(fullFraction: number, digits: number | undefined = undefined): num
 // Generate partisan details (Table 1)
 export function printPartisanDetailsHeader(): void
 {
-  console.log('XX, <V>, S(<V>), Rd, R, r, MIR, Cd, Cdf, BS_50, BV_50, Decl, GS, 𝛾, β, LO, EG, PR, MM, TO, MM\', B%, LS, LPR, LPR\'');
+  console.log('XX, <V>, S(<V>), Rd, R, r, MIR, Cd, Cdf, BS_50, BV_50, Decl, GS, 𝛾, β, LO, EG, PR, MM, TO, MM\', B%, UE, LS, LPR, LPR\', LUE');
   // console.log('XX, <V>, S(<V>), B%, BS_50, BV_50, Decl, GS, EG, Beta, PR, MM, TO, MM\', LO, Rd, R, r, MIR, Cd, Cdf, LS, LPR, LPR\'');
 }
 
 export function printPartisanDetailsRow(xx: string, name: string, N: number, Vf: number, s: T.PartisanScorecard): void
 {
-  console.log('%s, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f',
+  console.log('%s, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f, %f',
     xx,
 
     trim(Vf),
@@ -159,10 +159,12 @@ export function printPartisanDetailsRow(xx: string, name: string, N: number, Vf:
     trim(s.bias.mMd),                                                                        // Not shown in Table 1
 
     trim(s.bias.deviation),                                                                  // Simple deviation from best # of seats
+    trim(s.impact.unearnedS),
 
     // EXPERIMENTAL
     (s.experimental.lSym) ? trim(s.experimental.lSym) : s.experimental.lSym,
     (s.experimental.lProp) ? trim(s.experimental.lProp) : s.experimental.lProp,
-    (s.experimental.lPropAlt) ? trim(s.experimental.lPropAlt) : s.experimental.lPropAlt
+    (s.experimental.lPropAlt) ? trim(s.experimental.lPropAlt) : s.experimental.lPropAlt,
+    (s.experimental.lUE) ? trim(s.experimental.lUE) : s.experimental.lUE
   );
 }

package/dist/dra-analytics.js

@@ -1636,6 +1636,7 @@ function makePartisanScorecard(Vf, VfArray, bLog = false) {
     const lSym = (0, bias_1.estLocalAsymmetry)(Vf, dSVpoints, rSVpoints);
     const lProp = (0, bias_1.estLocalDisproportionality)(Vf, dSVpoints);
     const lPropAlt = (0, bias_1.estLocalDisproportionalityAlt)(Vf, N, dSVpoints);
+    const lUE = (0, bias_1.estLocalUnearnedSeats)(Vf, N, dSVpoints);
     const biasMeasurements = {
         bestS: bestS,
         bestSf: bestSf,
@@ -1677,7 +1678,8 @@ function makePartisanScorecard(Vf, VfArray, bLog = false) {
     const experimentalMetrics = {
         lSym: lSym,
         lProp: lProp,
-        lPropAlt: lPropAlt
+        lPropAlt: lPropAlt,
+        lUE: lUE
     };
     const s = {
         bias: biasMeasurements,
@@ -1735,7 +1737,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.rangeDisproportionalityAlt = exports.estLocalDisproportionalityAlt = exports.rangeDisproportionality = exports.estLocalDisproportionality = exports.rangeAsymmetry = exports.estLocalAsymmetry = exports.calcGamma = exports.calcMinimalInverseResponsiveness = exports.calcBigR = exports.calcDisproportionality = exports.calcGlobalSymmetry = exports.calcLopsidedOutcomes = exports.calcDeclination = exports.radiansToDegrees = exports.isASweep = exports.keyRVpoints = exports.calcMeanMedianDifference = exports.calcEfficiencyGap = exports.invertSVPoints = exports.inferGeometricSeatsBiasPoints = exports.estGeometricSeatsBias = exports.estVotesBias = exports.estSeatBias = exports.estPartisanBias = exports.calcTurnoutBias = exports.estUnearnedSeats = exports.calcDisproportionalityFromBest = exports.estSeatShare = exports.bestSeatShare = exports.bestSeats = void 0;
+exports.rangeUnearnedSeats = exports.estLocalUnearnedSeats = exports.rangeDisproportionalityAlt = exports.estLocalDisproportionalityAlt = exports.rangeDisproportionality = exports.estLocalDisproportionality = exports.rangeAsymmetry = exports.estLocalAsymmetry = exports.calcGamma = exports.calcMinimalInverseResponsiveness = exports.calcBigR = exports.calcDisproportionality = exports.calcGlobalSymmetry = exports.calcLopsidedOutcomes = exports.calcDeclination = exports.radiansToDegrees = exports.isASweep = exports.keyRVpoints = exports.calcMeanMedianDifference = exports.calcEfficiencyGap = exports.invertSVPoints = exports.inferGeometricSeatsBiasPoints = exports.estGeometricSeatsBias = exports.estVotesBias = exports.estSeatBias = exports.estPartisanBias = exports.calcTurnoutBias = exports.estUnearnedSeats = exports.calcDisproportionalityFromBest = exports.estSeatShare = exports.bestSeatShare = exports.bestSeats = void 0;
 const U = __importStar(__webpack_require__(/*! ../utils/all */ "./lib/utils/all.ts"));
 const C = __importStar(__webpack_require__(/*! ../rate/dra-config */ "./lib/rate/dra-config.ts"));
 const method_1 = __webpack_require__(/*! ./method */ "./lib/partisan/method.ts");
@@ -2174,27 +2176,34 @@ exports.estLocalDisproportionalityAlt = estLocalDisproportionalityAlt;
 function rangeDisproportionalityAlt(N, dSVpoints) {
     const ndPts = dSVpoints.length;
     let tot = 0.0;
-    let lastBestS;
     for (let i in dSVpoints) {
         const bestS = bestSeats(N, dSVpoints[i].v);
         const bestSf = bestSeatShare(bestS, N);
         tot += calcDisproportionalityFromBest(dSVpoints[i].s, bestSf);
-        /* DEBUG
-        {
-          if (lastBestS && (bestS != lastBestS)) console.log("Best # seats changes to ", bestS, bestSf, " at ", dSVpoints[i].v, " vote share. ");
-    
-          const j: number = +i;
-          if (j == 0)
-          {
-            console.log("Best # seats starts @ ", bestS, bestSf, " at ", dSVpoints[i].v, " vote share. ");
-          }
-          else lastBestS = bestS;
-        }
-        */
     }
     return tot / ndPts;
 }
 exports.rangeDisproportionalityAlt = rangeDisproportionalityAlt;
+// Average local unearned seats from the best # of seats (closest to proportional)
+function estLocalUnearnedSeats(Vf, N, dSVpoints) {
+    const dPts = svPointRange(Vf, dSVpoints);
+    if (!dPts)
+        return undefined;
+    const lUE = rangeUnearnedSeats(N, dPts);
+    return lUE;
+}
+exports.estLocalUnearnedSeats = estLocalUnearnedSeats;
+function rangeUnearnedSeats(N, dSVpoints) {
+    const ndPts = dSVpoints.length;
+    let tot = 0.0;
+    for (let i in dSVpoints) {
+        const estS = dSVpoints[i].s * N;
+        const bestS = bestSeats(N, dSVpoints[i].v);
+        tot += estUnearnedSeats(bestS, estS);
+    }
+    return tot / ndPts;
+}
+exports.rangeUnearnedSeats = rangeUnearnedSeats;
 // Filter the full [0.25–0.75] range of S–V points down to the 'local' range.
 // Make sure that range is w/in the full range.
 function svPointRange(Vf, svPoints) {