@dra2020/district-analytics 2.0.9 → 3.0.0

package/dist/district-analytics.js

@@ -118,9 +118,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const preprocess_1 = __webpack_require__(/*! ./preprocess */ "./src/preprocess.ts");
 const analyze_1 = __webpack_require__(/*! ./analyze */ "./src/analyze.ts");
+const score_1 = __webpack_require__(/*! ./score */ "./src/score.ts");
 const results_1 = __webpack_require__(/*! ./results */ "./src/results.ts");
 const results_2 = __webpack_require__(/*! ./results */ "./src/results.ts");
-const geofeature_1 = __webpack_require__(/*! ./geofeature */ "./src/geofeature.ts");
 const D = __importStar(__webpack_require__(/*! ./_data */ "./src/_data.ts"));
 const U = __importStar(__webpack_require__(/*! ./utils */ "./src/utils.ts"));
 class AnalyticsSession {
@@ -174,6 +174,11 @@ class AnalyticsSession {
             preprocess_1.doPreprocessData(this, bLog);
             analyze_1.doAnalyzeDistricts(this, bLog);
             analyze_1.doAnalyzePlan(this, bLog);
+            // TODO - SCORE
+            this._profile = score_1.profilePlan(this, bLog);
+            // this._profile = Score.sampleProfile;
+            this._scorecard = score_1.scorePlan(this._profile, bLog);
+            // TODO - SCORE
             results_1.doAnalyzePostProcessing(this, bLog);
         }
         catch (_a) {
@@ -183,92 +188,45 @@ class AnalyticsSession {
         return true;
     }
     // NOTE - This assumes that analyzePlan() has been run!
-    getPlanAnalytics(bLog = false) {
-        return results_2.preparePlanAnalytics(this, bLog);
-    }
-    // NOTE - This assumes that analyzePlan() has been run!
     getDistrictStatistics(bLog = false) {
         return results_2.prepareDistrictStatistics(this, bLog);
     }
+    // TODO - SCORE
+    getPlanProfile(bLog = false) {
+        return this._profile;
+    }
+    // TODO - SCORE
+    getPlanScorecard(bLog = false) {
+        return this._scorecard;
+    }
+    /* TODO - SCORE
+    // NOTE - This assumes that analyzePlan() has been run!
+    getPlanAnalytics(bLog: boolean = false): PlanAnalytics
+    {
+      return preparePlanAnalytics(this, bLog);
+    }
+    */
+    // TODO - SCORE
+    // NOTE - This assumes that analyzePlan() has been run!
+    getRequirementsChecklist(bLog = false) {
+        return results_2.prepareRequirementsChecklist(this, bLog);
+    }
     // NOTE - This assumes that analyzePlan() has been run!
     getDiscontiguousDistrictFeatures(bLog = false) {
         // Get the (possibly empty) list of discontiguous district IDs
-        const contiguousTest = this.getTest(1 /* Contiguous */);
-        const discontiguousDistrictIDs = contiguousTest['details']['discontiguousDistricts'] || [];
+        let contiguousTest = this.getTest(1 /* Contiguous */);
+        let discontiguousDistrictIDs = contiguousTest['details']['discontiguousDistricts'] || [];
         // Convert them into a (possibly empty) list of features
         let discontiguousDistrictFeatures = { type: 'FeatureCollection', features: [] };
         if (!(U.isArrayEmpty(discontiguousDistrictIDs))) {
             for (let id of discontiguousDistrictIDs) {
                 let poly = this.districts.getDistrictShapeByID(id);
-                if (poly) {
-                    // If a district has a shape & it is not contiguous, by definition,
-                    // it will be a Multipolygon, i.e., it will have multiple pieces, some
-                    // possibly embedded w/in other districts. Get & add all the pieces.
-                    const districtParts = geofeature_1.polyParts(poly);
-                    discontiguousDistrictFeatures.features.push(...districtParts.features);
-                    // discontiguousDistrictFeatures.features.push(poly);
-                }
+                if (poly)
+                    discontiguousDistrictFeatures.features.push(poly);
             }
         }
         return discontiguousDistrictFeatures;
     }
-    // Comments clipped from dra-client geodistrict.ts.
-    // Discontiguous polygons are:
-    //  1. All polygons in a multi-polygon; and
-    //  2. All holes in a otherwise cohesive polygon.
-    // Note that all non-cohesive features are always simple polygons.
-    /*
-    let i: number, j: number;
-    let nPoly: number = 0;
-    for (i = 0;nPoly == 0 && i < this.cacheDistricts.features.length;i++)
-    {
-      let f = this.cacheDistricts.features[i];
-  
-      if (f.geometry.type === 'MultiPolygon')
-        nPoly += f.geometry.coordinates.length;
-      else if (f.geometry.type === 'Polygon' && f.geometry.coordinates.length)
-        nPoly += (f.geometry.coordinates.length - 1);
-    }
-    if (nPoly)
-    {
-      this.cacheNoncohesive = {type: 'FeatureCollection', features: []};
-      let af: any = this.cacheNoncohesive.features;
-      let oUnique: any = {};
-  
-      // First add discontiguous polygons
-      for (i = 0;i < this.cacheDistricts.features.length;i++)
-      {
-        let f = this.cacheDistricts.features[i];
-  
-        if (f.geometry.type === 'MultiPolygon')
-        {
-          // Push all non-contiguous polygons
-          for (j = 0;j < f.geometry.coordinates.length;j++)
-          {
-            let p: any = f.geometry.coordinates[j];
-            oUnique[Hash.qhash(p[0])] = true;
-            af.push({type: 'Feature', properties: {id: `${af.length + 1}`}, geometry: {type: 'Polygon', coordinates: p}});
-          }
-        }
-      }
-  
-      // Now add unique holes
-      for (i = 0;i < this.cacheDistricts.features.length;i++)
-      {
-        let f = this.cacheDistricts.features[i];
-  
-        if (f.geometry.type === 'Polygon')
-        {
-          // Push all holes from this polygon
-          for (j = 1;j < f.geometry.coordinates.length;j++)
-          {
-            let p: any = f.geometry.coordinates[j];
-            if (oUnique[Hash.qhash(p)] === undefined)
-              af.push({type: 'Feature', properties: {id: `${af.length + 1}`}, geometry: {type: 'Polygon', coordinates: [p]}});
-          }
-        }
-      }
-    } */
     // HELPERS USED INTERNALLY
     // Get an individual test, so you can drive UI with the results.
     getTest(testID) {
@@ -410,7 +368,7 @@ class Districts {
         nMissingDataset = 0;
         nMissingProperty = 0;
         // Compute these once per recalc cycle
-        let targetSize = this._session.state.totalPop / this._session.state.nDistricts;
+        let targetSize = Math.round(this._session.state.totalPop / this._session.state.nDistricts);
         let deviationThreshold = this._session.populationDeviationThreshold();
         let planByDistrict = this._session.plan.byDistrictID();
         let plan = this._session.plan;
@@ -462,6 +420,7 @@ class Districts {
             let outerThis = this;
             // Default the pop dev % for the dummy Unassigned district to 0%.
             // Default the pop dev % for real (1–N) but empty districts to 100%.
+            // TODO - SCORE
             let popDevPct = (i > 0) ? (targetSize / targetSize) : 0 / targetSize;
             // Get the geoIDs assigned to the district
             // Guard against empty districts
@@ -488,6 +447,7 @@ class Districts {
                             // NOTE - SPLITTING
                             // Total population by counties w/in a district,
                             // except the dummy unassigned district 0
+                            // TODO - VFEATURE
                             if (i > 0)
                                 countySplits[outerThis.getCountyIndex(geoID)] += featurePop;
                             // Democratic and Republican vote totals
@@ -661,8 +621,10 @@ class Districts {
         compact_1.extractDistrictProperties(this._session, bLog);
     }
     getCountyIndex(geoID) {
-        let countyGeoID = U.parseGeoID(geoID)['county'];
-        let countyFIPS = U.getFIPSFromCountyGeoID(countyGeoID);
+        // TODO - VFEATURE
+        let countyFIPS = U.parseGeoID(geoID)['county'];
+        // let countyGeoID = U.parseGeoID(geoID)['county'] as string;
+        // let countyFIPS = U.getFIPSFromCountyGeoID(countyGeoID);
         let countyIndex = this._session.counties.indexFromFIPS(countyFIPS);
         return countyIndex;
     }
@@ -679,8 +641,9 @@ class Features {
     nFeatures() { return this._data.features.length; }
     featureByIndex(i) { return this._data.features[i]; }
     geoIDForFeature(f) {
+        // TODO - 2020
         // GEOIDs will be one of these properties
-        let value = f.properties['GEOID10'] || f.properties['GEOID20'] || f.properties['GEOID'];
+        const value = f.properties['GEOID10'] || f.properties['GEOID20'] || f.properties['GEOID'];
         return value;
     }
     fieldForFeature(f, dt, fk) {
@@ -1461,6 +1424,7 @@ function doPolsbyPopper(s, bLog = false) {
 }
 exports.doPolsbyPopper = doPolsbyPopper;
 // HELPER TO EXTRACT PROPERTIES OF DISTRICT SHAPES
+// TODO - SCORE: Create an array, as opposed to a dict
 function extractDistrictProperties(s, bLog = false) {
     // NOTE - I am assuming that district IDs are integers 1–N
     for (let i = 1; i <= s.state.nDistricts; i++) {
@@ -1619,23 +1583,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const Poly = __importStar(__webpack_require__(/*! @dra2020/poly */ "@dra2020/poly"));
-// HELPER
-function polyParts(poly) {
-    let parts = { type: 'FeatureCollection', features: [] };
-    let af = parts.features;
-    if (poly.geometry.type === 'MultiPolygon') {
-        // Push all non-contiguous polygons
-        for (let j = 0; j < poly.geometry.coordinates.length; j++) {
-            let onePoly = poly.geometry.coordinates[j];
-            af.push({ type: 'Feature', properties: { id: `${af.length + 1}` }, geometry: { type: 'Polygon', coordinates: onePoly } });
-        }
-    }
-    else {
-        parts.features.push(poly);
-    }
-    return parts;
-}
-exports.polyParts = polyParts;
 // CARTESIAN SHIMS OVER 'POLY' FUNCTIONS
 // TODO - POLY: Confirm Cartesian calculations
 function gfArea(poly) {
@@ -1961,8 +1908,10 @@ function doPreprocessCensus(s, bLog = false) {
             // Sum total population across the state
             s.state.totalPop += value;
             // Get the county FIPS code for the feature
-            let county = U.parseGeoID(geoID)['county'];
-            let countyFIPS = U.getFIPSFromCountyGeoID(county);
+            // TODO - VFEATURE
+            let countyFIPS = U.parseGeoID(geoID)['county'];
+            // let county = U.parseGeoID(geoID)['county'] as string;
+            // let countyFIPS = U.getFIPSFromCountyGeoID(county);
             // If a subtotal for the county doesn't exist, initialize one
             if (!(U.keyExists(countyFIPS, totalByCounty))) {
                 totalByCounty[countyFIPS] = 0;
@@ -1980,7 +1929,7 @@ function doPreprocessCensus(s, bLog = false) {
     let fipsCodes = U.getObjectKeys(totalByCounty);
     // Sort the results
     fipsCodes = fipsCodes.sort();
-    // NOTE - SPLITTING
+    // TODO - SCORE: This was added for SPLITTING
     // Add a dummy county, for county-district splitting analysis
     fipsCodes.unshift('000');
     // Create the ID-ordinal map
@@ -2067,7 +2016,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const U = __importStar(__webpack_require__(/*! ./utils */ "./src/utils.ts"));
-const S = __importStar(__webpack_require__(/*! ./settings */ "./src/settings.ts"));
 const D = __importStar(__webpack_require__(/*! ./_data */ "./src/_data.ts"));
 const analyze_1 = __webpack_require__(/*! ./analyze */ "./src/analyze.ts");
 const state_reqs_json_1 = __importDefault(__webpack_require__(/*! ../static/state-reqs.json */ "./static/state-reqs.json"));
@@ -2139,7 +2087,7 @@ let samplePartisan = {
         planScore: "https://planscore.org/plan.html?20180219T202039.596761160Z"
     }
 };
-// TODO - MINORITY: This category is still being fleshed out.
+// TODO - SCORE: Add a minority report
 let sampleMinority = {
     score: null,
     metrics: {
@@ -2174,7 +2122,233 @@ exports.samplePlanAnalytics = {
     partisan: samplePartisan,
     minority: sampleMinority
 };
-function preparePlanAnalytics(s, bLog = false) {
+/* TODO - SCORE
+export function preparePlanAnalytics(s: AnalyticsSession, bLog: boolean = false): PlanAnalytics
+{
+  if (!(s.bPostProcessingDone))
+  {
+    doAnalyzePostProcessing(s);
+  }
+
+  // REQUIREMENTS CATEGORY
+  let paRequirements: RequirementsCategory;
+
+  {
+    let completeTest = s.getTest(T.Test.Complete) as T.TestEntry;
+    let contiguousTest = s.getTest(T.Test.Contiguous) as T.TestEntry;
+    let freeOfHolesTest = s.getTest(T.Test.FreeOfHoles) as T.TestEntry;
+    let equalPopulationTest = s.getTest(T.Test.EqualPopulation) as T.TestEntry;
+
+    // Combine individual checks into an overall score
+
+    // TODO - DASHBOARD: Until we add three-state support top to bottom in
+    //   requirements/validations, map booleans to tri-states here.
+    let completeMetric = U.mapBooleanToTriState(completeTest['score'] as boolean);
+    let contiguousMetric = U.mapBooleanToTriState(contiguousTest['score'] as boolean);
+    let freeOfHolesMetric = U.mapBooleanToTriState(freeOfHolesTest['score'] as boolean);
+    let equalPopulationMetric = U.mapBooleanToTriState(equalPopulationTest['score'] as boolean);
+
+    let reqScore: T.TriState = T.TriState.Green;
+    let checks = [completeMetric, contiguousMetric, freeOfHolesMetric, equalPopulationMetric];
+    if (checks.includes(T.TriState.Yellow)) reqScore = T.TriState.Yellow;
+    if (checks.includes(T.TriState.Red)) reqScore = T.TriState.Red;
+
+    // Get values to support details entries
+    let unassignedFeaturesDetail = U.deepCopy(completeTest['details']['unassignedFeatures']) || [];
+    let emptyDistrictsDetail = U.deepCopy(completeTest['details']['emptyDistricts']) || [];
+    let discontiguousDistrictsDetail = U.deepCopy(contiguousTest['details']['discontiguousDistricts']) || [];
+    let embeddedDistrictsDetail = U.deepCopy(freeOfHolesTest['details']['embeddedDistricts']) || [];
+
+    let populationDeviationDetail = U.deepCopy(equalPopulationTest['details']['deviation']);
+    let deviationThresholdDetail = U.trim(s.populationDeviationThreshold());
+
+    let xx: string = s.state.xx;
+    // TODO - JSON: Is there a better / easier way to work with the variable?
+    let stateReqsDict: T.Dict = allStateReqs;
+    let reqLinkToStateReqs: string = stateReqsDict[xx];
+
+    // Populate the category
+    paRequirements = {
+      score: reqScore,
+      metrics: {
+        complete: completeMetric,
+        contiguous: contiguousMetric,
+        freeOfHoles: freeOfHolesMetric,
+        equalPopulation: equalPopulationMetric
+      },
+      details: {
+        unassignedFeatures: unassignedFeaturesDetail,
+        emptyDistricts: emptyDistrictsDetail,
+        discontiguousDistricts: discontiguousDistrictsDetail,
+        embeddedDistricts: embeddedDistrictsDetail,
+        populationDeviation: populationDeviationDetail,
+        deviationThreshold: deviationThresholdDetail
+      },
+      datasets: {
+        census: U.deepCopy(s.config['descriptions']['CENSUS']),
+      },
+      resources: {
+        stateReqs: reqLinkToStateReqs
+      }
+    }
+  }
+
+  // COMPACTNESS CATEGORY
+  let paCompactness: CompactnessCategory;
+  {
+    let reockWeight = 0.5;
+    let polsbyWeight = 1.0 - reockWeight;
+
+    let reockTest = s.getTest(T.Test.Reock) as T.TestEntry;
+    let polsbyTest = s.getTest(T.Test.PolsbyPopper) as T.TestEntry;
+
+    let normalizedReock = reockTest['normalizedScore'] as number;
+    let normalizedPolsby = reockTest['normalizedScore'] as number;
+    let compactnessScore = U.trim((reockWeight * normalizedReock) + (polsbyWeight * normalizedPolsby), 0);
+
+    let reockMetric = U.deepCopy(reockTest['score'] as number);
+    let polsbyMetric = U.deepCopy(polsbyTest['score'] as number);
+
+    // Populate the category
+    paCompactness = {
+      score: compactnessScore,
+      metrics: {
+        reock: reockMetric,
+        polsby: polsbyMetric
+      },
+      details: {
+        // None at this time
+      },
+      datasets: {
+        // NOTE - DATASETS
+        shapes: U.deepCopy(s.config['descriptions']['SHAPES'])
+        // shapes: "2010 VTD shapes"
+      },
+      resources: {
+        // None at this time
+      }
+    }
+  }
+
+  // SPLITTING CATEGORY
+
+  let paSplitting: SplittingCategory
+
+  {
+    let unexpectedCountySplittingTest = s.getTest(T.Test.UnexpectedCountySplits) as T.TestEntry;
+    let VTDSplitsTest = s.getTest(T.Test.VTDSplits) as T.TestEntry;
+    let countySplittingTest = s.getTest(T.Test.CountySplitting) as T.TestEntry;
+    let districtSplittingTest = s.getTest(T.Test.DistrictSplitting) as T.TestEntry;
+
+    let unexpectedAffectedMetric = U.deepCopy(unexpectedCountySplittingTest['score']);
+    let countiesSplitUnexpectedlyDetail = U.deepCopy(unexpectedCountySplittingTest['details']['countiesSplitUnexpectedly']);
+
+    let nVTDSplitsMetric = U.deepCopy(VTDSplitsTest['score']);
+    let splitVTDsDetail = U.deepCopy(VTDSplitsTest['details']['splitVTDs']);
+
+    let SqEnt_DCreducedMetric = U.deepCopy(countySplittingTest['score']);
+    let SqEnt_CDreducedMetric = U.deepCopy(districtSplittingTest['score']);
+
+    let countySplittingNormalized = countySplittingTest['normalizedScore'] as number;
+    let districtSplittingNormalized = districtSplittingTest['normalizedScore'] as number;
+    let splittingScore = U.trim((S.COUNTY_SPLITTING_WEIGHT * countySplittingNormalized) +
+      + (S.DISTRICT_SPLITTING_WEIGHT * districtSplittingNormalized), 0);
+
+    paSplitting = {
+      score: splittingScore,
+      metrics: {
+        sqEnt_DCreduced: SqEnt_DCreducedMetric,
+        sqEnt_CDreduced: SqEnt_CDreducedMetric
+        // NOTE - The un-reduced raw values
+        // sqEnt_DC    : SqEnt_DCMetric,
+        // sqEnt_CD    : SqEnt_CDMetric
+      },
+      details: {
+        countiesSplitUnexpectedly: countiesSplitUnexpectedlyDetail,
+        unexpectedAffected: unexpectedAffectedMetric,
+        nSplitVTDs: nVTDSplitsMetric,
+        splitVTDs: splitVTDsDetail
+      },
+      datasets: {
+        // None at this time
+      },
+      resources: {
+        // None at this time
+      }
+    }
+  }
+
+  // PARTISAN CATEGORY
+  //
+  // TODO - PARTISAN: This category is still being fleshed out. Just an example below.
+  let paPartisan: PartisanCategory;
+
+  {
+    paPartisan = {
+      score: 100,
+      metrics: {
+        partisanBias: 0.15,
+        responsiveness: 2.0
+      },
+      details: {},
+      datasets: {
+        election: "2016 Presidential, US Senate, Governor, and AG election results"
+      },
+      resources: {
+        planScore: "https://planscore.org/plan.html?20180219T202039.596761160Z"
+      }
+    }
+  }
+
+  // MINORITY CATEGORY
+  //
+  // TODO - MINORITY: This category is still being fleshed out. Just an example below.
+  let paMinority: MinorityCategory;
+
+  {
+    paMinority = {
+      score: null,
+      metrics: {
+        nBlack37to50: 1,
+        nBlackMajority: 12,
+        nHispanic37to50: 0,
+        nHispanicMajority: 0,
+        nPacific37to50: 0,
+        nPacificMajority: 0,
+        nAsian37to50: 0,
+        nAsianMajority: 0,
+        nNative37to50: 0,
+        nNativeMajority: 0,
+        nMinority37to50: 0,
+        nMinorityMajority: 0,
+
+        averageDVoteShare: 0.90
+      },
+      details: {
+        vap: true,
+        comboCategories: true
+      },
+      datasets: {
+        vap: "2010 Voting Age Population"
+      },
+      resources: {}
+    }
+  }
+
+  // PLAN ANALYTICS
+  let pa: PlanAnalytics = {
+    requirements: paRequirements,
+    compactness: paCompactness,
+    // TODO - Not implemented yet
+    splitting: paSplitting,
+    partisan: paPartisan,
+    minority: paMinority
+  }
+
+  return pa;
+}
+*/
+function prepareRequirementsChecklist(s, bLog = false) {
     if (!(s.bPostProcessingDone)) {
         doAnalyzePostProcessing(s);
     }
@@ -2234,142 +2408,9 @@ function preparePlanAnalytics(s, bLog = false) {
             }
         };
     }
-    // COMPACTNESS CATEGORY
-    let paCompactness;
-    {
-        let reockWeight = 0.5;
-        let polsbyWeight = 1.0 - reockWeight;
-        let reockTest = s.getTest(5 /* Reock */);
-        let polsbyTest = s.getTest(6 /* PolsbyPopper */);
-        let normalizedReock = reockTest['normalizedScore'];
-        let normalizedPolsby = reockTest['normalizedScore'];
-        let compactnessScore = U.trim((reockWeight * normalizedReock) + (polsbyWeight * normalizedPolsby), 0);
-        let reockMetric = U.deepCopy(reockTest['score']);
-        let polsbyMetric = U.deepCopy(polsbyTest['score']);
-        // Populate the category
-        paCompactness = {
-            score: compactnessScore,
-            metrics: {
-                reock: reockMetric,
-                polsby: polsbyMetric
-            },
-            details: {
-            // None at this time
-            },
-            datasets: {
-                // NOTE - DATASETS
-                shapes: U.deepCopy(s.config['descriptions']['SHAPES'])
-                // shapes: "2010 VTD shapes"
-            },
-            resources: {
-            // None at this time
-            }
-        };
-    }
-    // SPLITTING CATEGORY
-    let paSplitting;
-    {
-        let unexpectedCountySplittingTest = s.getTest(7 /* UnexpectedCountySplits */);
-        let VTDSplitsTest = s.getTest(10 /* VTDSplits */);
-        let countySplittingTest = s.getTest(8 /* CountySplitting */);
-        let districtSplittingTest = s.getTest(9 /* DistrictSplitting */);
-        let unexpectedAffectedMetric = U.deepCopy(unexpectedCountySplittingTest['score']);
-        let countiesSplitUnexpectedlyDetail = U.deepCopy(unexpectedCountySplittingTest['details']['countiesSplitUnexpectedly']);
-        let nVTDSplitsMetric = U.deepCopy(VTDSplitsTest['score']);
-        let splitVTDsDetail = U.deepCopy(VTDSplitsTest['details']['splitVTDs']);
-        let SqEnt_DCreducedMetric = U.deepCopy(countySplittingTest['score']);
-        let SqEnt_CDreducedMetric = U.deepCopy(districtSplittingTest['score']);
-        let countySplittingNormalized = countySplittingTest['normalizedScore'];
-        let districtSplittingNormalized = districtSplittingTest['normalizedScore'];
-        let splittingScore = U.trim((S.COUNTY_SPLITTING_WEIGHT * countySplittingNormalized) +
-            +(S.DISTRICT_SPLITTING_WEIGHT * districtSplittingNormalized), 0);
-        paSplitting = {
-            score: splittingScore,
-            metrics: {
-                sqEnt_DCreduced: SqEnt_DCreducedMetric,
-                sqEnt_CDreduced: SqEnt_CDreducedMetric
-                // NOTE - The un-reduced raw values
-                // sqEnt_DC    : SqEnt_DCMetric,
-                // sqEnt_CD    : SqEnt_CDMetric
-            },
-            details: {
-                countiesSplitUnexpectedly: countiesSplitUnexpectedlyDetail,
-                unexpectedAffected: unexpectedAffectedMetric,
-                nSplitVTDs: nVTDSplitsMetric,
-                splitVTDs: splitVTDsDetail
-            },
-            datasets: {
-            // None at this time
-            },
-            resources: {
-            // None at this time
-            }
-        };
-    }
-    // PARTISAN CATEGORY
-    //
-    // TODO - PARTISAN: This category is still being fleshed out. Just an example below.
-    let paPartisan;
-    {
-        paPartisan = {
-            score: 100,
-            metrics: {
-                partisanBias: 0.15,
-                responsiveness: 2.0
-            },
-            details: {},
-            datasets: {
-                election: "2016 Presidential, US Senate, Governor, and AG election results"
-            },
-            resources: {
-                planScore: "https://planscore.org/plan.html?20180219T202039.596761160Z"
-            }
-        };
-    }
-    // MINORITY CATEGORY
-    //
-    // TODO - MINORITY: This category is still being fleshed out. Just an example below.
-    let paMinority;
-    {
-        paMinority = {
-            score: null,
-            metrics: {
-                nBlack37to50: 1,
-                nBlackMajority: 12,
-                nHispanic37to50: 0,
-                nHispanicMajority: 0,
-                nPacific37to50: 0,
-                nPacificMajority: 0,
-                nAsian37to50: 0,
-                nAsianMajority: 0,
-                nNative37to50: 0,
-                nNativeMajority: 0,
-                nMinority37to50: 0,
-                nMinorityMajority: 0,
-                averageDVoteShare: 0.90
-            },
-            details: {
-                vap: true,
-                comboCategories: true
-            },
-            datasets: {
-                vap: "2010 Voting Age Population"
-            },
-            resources: {}
-        };
-    }
-    // PLAN ANALYTICS
-    let pa = {
-        requirements: paRequirements,
-        compactness: paCompactness,
-        // TODO - Not implemented yet
-        splitting: paSplitting,
-        partisan: paPartisan,
-        minority: paMinority
-    };
-    return pa;
+    return paRequirements;
 }
-exports.preparePlanAnalytics = preparePlanAnalytics;
+exports.prepareRequirementsChecklist = prepareRequirementsChecklist;
 // Example
 exports.sampleDistrictStatistics = {
     table: [
@@ -2625,6 +2666,127 @@ function doAnalyzePostProcessing(s, bLog = false) {
 exports.doAnalyzePostProcessing = doAnalyzePostProcessing;
 
 
+/***/ }),
+
+/***/ "./src/score.ts":
+/*!**********************!*\
+  !*** ./src/score.ts ***!
+  \**********************/
+/*! no static exports found */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+//
+// SCORING
+// 
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Score = __importStar(__webpack_require__(/*! @dra2020/dra-score */ "@dra2020/dra-score"));
+const U = __importStar(__webpack_require__(/*! ./utils */ "./src/utils.ts"));
+const D = __importStar(__webpack_require__(/*! ./_data */ "./src/_data.ts"));
+// PROFILE A PLAN
+function profilePlan(s, bLog = false) {
+    const state = s.state.xx;
+    const planName = s.title;
+    const nDistricts = s.state.nDistricts;
+    const nCounties = s.counties.nCounties;
+    const targetSize = Math.round(s.state.totalPop / nDistricts);
+    const popByDistrict = U.deepCopy(s.districts.statistics[D.DistrictField.TotalPop].slice(1, -1));
+    const geoPropsByDistrict = makeArrayOfGeoProps(s, bLog);
+    const splits = makeNakedCxD(s);
+    const summaryRow = s.districts.numberOfRows() - 1;
+    const statewideVf = s.districts.statistics[D.DistrictField.DemPct][summaryRow];
+    const vpiArray = U.deepCopy(s.districts.statistics[D.DistrictField.DemPct].slice(1, -1));
+    const demographicsByDistrict = makeArrayOfDemographics(s);
+    const profile = {
+        state: state,
+        planName: planName,
+        nDistricts: nDistricts,
+        nCounties: nCounties,
+        legislativeDistricts: s.legislativeDistricts,
+        populationProfile: {
+            TotalPopByDistrict: popByDistrict,
+            targetSize: targetSize
+        },
+        compactnessProfile: {
+            GeometryByDistrict: geoPropsByDistrict
+        },
+        splittingProfile: {
+            CountyPopByDistrict: splits
+        },
+        partisanProfile: {
+            statewideVf: statewideVf,
+            VfArray: vpiArray
+        },
+        demographicProfile: {
+            DemographicsByDistrict: demographicsByDistrict
+        }
+    };
+    return profile;
+}
+exports.profilePlan = profilePlan;
+// NOTE - The CxD splits structure from _data.ts includes dummy districts for
+//  unassigned precincts & state summary and an extra 0 county. But dra-score takes
+//  a simple 1–D x 1–C splits array (zero-based, of course).
+function makeNakedCxD(s, bLog = false) {
+    const adornedCxD = s.districts.statistics[D.DistrictField.CountySplits];
+    let CxD = [];
+    // Remove the unassigned & total dummy "districts"
+    for (let districtID = 1; districtID <= s.state.nDistricts; districtID++) {
+        // TODO - SCORE: OH has an extra county!?!
+        const splits = U.deepCopy(adornedCxD[districtID].slice(1));
+        CxD.push(splits);
+    }
+    return CxD;
+}
+// TODO - SCORE: Convert dict of geo props to array by district index
+function makeArrayOfGeoProps(s, bLog = false) {
+    let geometryByDistrict = [];
+    for (let districtID = 1; districtID <= s.state.nDistricts; districtID++) {
+        let districtProps = s.districts.getGeoProperties(districtID);
+        // Guard against no shape and no properties
+        if (districtProps) {
+            let a = districtProps[0 /* Area */];
+            let p = districtProps[2 /* Perimeter */];
+            let d = districtProps[1 /* Diameter */];
+            // Save each triple
+            geometryByDistrict.push([a, p, d]);
+        }
+    }
+    return geometryByDistrict;
+}
+function makeArrayOfDemographics(s, bLog = false) {
+    let demographicsArray = [];
+    // Remove the unassigned & total dummy "districts"
+    for (let districtID = 1; districtID <= s.state.nDistricts; districtID++) {
+        const districtDemographics = [
+            U.deepCopy(s.districts.statistics[D.DistrictField.WhitePct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.MinorityPct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.BlackPct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.HispanicPct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.PacificPct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.AsianPct][districtID]),
+            U.deepCopy(s.districts.statistics[D.DistrictField.NativePct][districtID])
+        ];
+        demographicsArray.push(districtDemographics);
+    }
+    return demographicsArray;
+}
+// SCORE A PLAN
+function scorePlan(p, bLog = false) {
+    let scorer = new Score.Scorer();
+    return scorer.score(p);
+}
+exports.scorePlan = scorePlan;
+
+
 /***/ }),
 
 /***/ "./src/settings.ts":
@@ -2675,6 +2837,10 @@ exports.DISTRICT_SPLITTING_WEIGHT = 1.0 - exports.COUNTY_SPLITTING_WEIGHT;
 // TYPE DEFINITIONS
 //
 Object.defineProperty(exports, "__esModule", { value: true });
+// TODO - SCORE
+var dra_score_1 = __webpack_require__(/*! @dra2020/dra-score */ "@dra2020/dra-score");
+exports.sampleProfile = dra_score_1.sampleProfile;
+exports.sampleScorecard = dra_score_1.sampleScorecard;
 // END
 
 
@@ -2727,27 +2893,50 @@ function getDistrict(plan, geoID) {
 }
 exports.getDistrict = getDistrict;
 // WORKING WITH GEOIDS
+// TODO - VFEATURE
 function parseGeoID(geoID) {
-    let parts = {};
-    parts['state'] = geoID.substring(0, 2);
-    parts['county'] = geoID.substring(0, 5);
-    let l = geoID.length;
-    if (l >= 11) {
-        parts['tract'] = geoID.substring(0, 11);
-    }
-    if (l >= 12) {
-        parts['bg'] = geoID.substring(0, 12);
-    }
-    if (l == 15) {
-        parts['block'] = geoID;
-    }
+    let bVfeature = false;
+    // Rewrite vfeature GEOIDs to enable lexical parsing of higher-level parts
+    // Template: vfeature_{geoid}_{chunk}_hash
+    // Example: vfeature_39153153ASV_0_28e0bc2c8163e5982e1da2d61e2388a8325c575e
+    if (geoID.indexOf('vfeature') >= 0) {
+        bVfeature = true;
+        // Strip off leading 'vfeature_'
+        let parentGeoID = geoID.slice(9);
+        // Strip off trailing goo
+        const uPos = parentGeoID.indexOf('_');
+        parentGeoID = parentGeoID.slice(0, uPos);
+        geoID = parentGeoID;
+    }
+    const parts = {
+        vfeature: bVfeature,
+        state: geoID.substring(0, 2),
+        county: geoID.substring(2, 5),
+        rest: geoID.slice(5)
+    };
+    // let l: number = geoID.length;
+    // if (l >= 11)
+    // {
+    //   parts['tract'] = geoID.substring(0, 11);
+    // }
+    // if (l >= 12)
+    // {
+    //   parts['bg'] = geoID.substring(0, 12);
+    // }
+    // if (l == 15)
+    // {
+    //   parts['block'] = geoID;
+    // }
     return parts;
 }
 exports.parseGeoID = parseGeoID;
-function getFIPSFromCountyGeoID(geoID) {
-    return geoID.substring(2, 5);
-}
-exports.getFIPSFromCountyGeoID = getFIPSFromCountyGeoID;
+// TODO - VFEATURE
+// export function getFIPSFromCountyGeoID(geoID: string): string
+// {
+//   const fips = geoID.substring(2, 5);
+//   if (isNaN(Number(fips))) console.log("Non-numeric GEOID =", geoID);
+//   return fips;
+// }
 function isWaterOnly(geoID) {
     let waterOnlySignature = 'ZZZZZZ';
     if (geoID.indexOf(waterOnlySignature) >= 0)
@@ -3186,6 +3375,17 @@ module.exports = JSON.parse("{\"AL\":\"https://www.brennancenter.org/sites/defau
 
 /***/ }),
 
+/***/ "@dra2020/dra-score":
+/*!*************************************!*\
+  !*** external "@dra2020/dra-score" ***!
+  \*************************************/
+/*! no static exports found */
+/***/ (function(module, exports) {
+
+module.exports = require("@dra2020/dra-score");
+
+/***/ }),
+
 /***/ "@dra2020/poly":
 /*!********************************!*\
   !*** external "@dra2020/poly" ***!