@dra2020/district-analytics 1.0.4 → 1.0.7

package/lib/data.js

@@ -0,0 +1,188 @@
+"use strict";
+//
+// DATA ABSTRACTION LAYER
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require("fs");
+const path = require("path");
+const parse = require("csv-parse/lib/sync");
+function nFeatures(s) {
+    return s._data.features.length;
+}
+exports.nFeatures = nFeatures;
+function getFeature(s, i) {
+    return s._data.features[i];
+}
+exports.getFeature = getFeature;
+function getFeatureID(s, f) {
+    return f.properties['GEOID'];
+}
+exports.getFeatureID = getFeatureID;
+// Hide dataset & field key details from the main analytics code
+function getFeatureData(s, f, dt, fk) {
+    let dk = s._config['datasets'][dt];
+    return _getFeatureData(f, dk, fk);
+}
+exports.getFeatureData = getFeatureData;
+// NOTE - This accessor is cloned from fGetW() in dra-client/restrict.ts
+//  f is a direct GeoJSON feature
+//  p is a geoID
+function _getFeatureData(f, datasetKey, p) {
+    // Shim to load sample data2.json from disk for command-line scaffolding
+    if (f.properties && f.properties['datasets']) {
+        return f.properties['datasets'][datasetKey][p];
+    }
+    // NOTE - The fGetW() code from dra-client below here ...
+    // Direct property?
+    if (f.properties && f.properties[p] !== undefined)
+        return f.properties[p];
+    // Joined property?
+    let a = _fGetJoined(f);
+    if (a) {
+        for (let i = 0; i < a.length; i++) {
+            let o = a[i];
+            if (!datasetKey) {
+                if (o[p] !== undefined)
+                    return o[p];
+            }
+            else {
+                if (o['datasets'] && o['datasets'][datasetKey])
+                    if (o['datasets'][datasetKey][p])
+                        return o['datasets'][datasetKey][p];
+            }
+        }
+    }
+    return undefined;
+}
+function _fGetJoined(f) {
+    return (f.properties && f.properties.joined) ? f.properties.joined : undefined;
+}
+function getCounties(s) {
+    return s._countyFeatures.features;
+}
+exports.getCounties = getCounties;
+function getCountyProperties(f) {
+    return f.properties;
+}
+exports.getCountyProperties = getCountyProperties;
+function releaseCounties(s) {
+    s._countyFeatures = {};
+}
+exports.releaseCounties = releaseCounties;
+// HELPERS TO LOAD SAMPLE DATA FROM DISK
+// A clone of 'carefulRead' in DRA-CLI
+function readJSONcareful(file) {
+    try {
+        let s = fs.readFileSync(file, 'utf8');
+        let o = JSON.parse(s);
+        return o;
+    }
+    catch (err) {
+        console.log("Error reading JSON file ...");
+        return null;
+    }
+}
+exports.readJSONcareful = readJSONcareful;
+function readJSON(file) {
+    let fullPath;
+    if (path.isAbsolute(file)) {
+        fullPath = file;
+    }
+    else {
+        fullPath = path.join(__dirname, file);
+    }
+    return readJSONcareful(fullPath);
+}
+exports.readJSON = readJSON;
+// Following the clone above, except for CSV, using the csv-parse/sync API
+function readCSV(file) {
+    try {
+        let input = fs.readFileSync(file, 'utf8');
+        let dictRows = parse(input, {
+            columns: true,
+            skip_empty_lines: true
+        });
+        return dictRows;
+    }
+    catch (err) {
+        console.log("Error reading CSV file ...");
+        return null;
+    }
+}
+exports.readCSV = readCSV;
+// Read a plan from a .csv file
+function readPlanCSV(file) {
+    var plan = {};
+    let fullPath;
+    if (path.isAbsolute(file)) {
+        fullPath = file;
+    }
+    else {
+        fullPath = path.join(__dirname, file);
+    }
+    var csvArray = readCSV(fullPath);
+    for (let dictRow of csvArray) {
+        let geoID = dictRow['GEOID'];
+        let districtID = Number(dictRow['DISTRICT']);
+        // TODO - DISTRICT_ID
+        // let districtID: number = dictRow['DISTRICT'];
+        plan[geoID] = districtID;
+    }
+    return plan;
+}
+exports.readPlanCSV = readPlanCSV;
+// Read Census data from a .csv file
+function readCensusCSV(file) {
+    var census = {};
+    let fullPath;
+    if (path.isAbsolute(file)) {
+        fullPath = file;
+    }
+    else {
+        fullPath = path.join(__dirname, file);
+    }
+    var csvArray = readCSV(fullPath);
+    for (let dictRow of csvArray) {
+        let geoID = dictRow['GEOID'];
+        let censusSelect = {};
+        censusSelect['total'] = Number(dictRow['TOTAL']);
+        censusSelect['white'] = Number(dictRow['WHITE']);
+        censusSelect['black'] = Number(dictRow['BLACK']);
+        censusSelect['hispanic'] = Number(dictRow['HISPANIC']);
+        // TODO - INTEGRATION: data2.json - Minority breakdowns
+        censusSelect['whiteHispanic'] = 0;
+        censusSelect['total18'] = Number(dictRow['TOTAL18']);
+        censusSelect['white18'] = Number(dictRow['WHITE18']);
+        censusSelect['black18'] = Number(dictRow['BLACK18']);
+        censusSelect['hispanic18'] = Number(dictRow['HISPANIC18']);
+        // TODO - INTEGRATION: data2.json - Minority breakdowns
+        censusSelect['whiteHispanic18'] = 0;
+        census[geoID] = censusSelect;
+    }
+    return census;
+}
+exports.readCensusCSV = readCensusCSV;
+// Read election data from a .csv file
+function readElectionCSV(file) {
+    var election = {};
+    let fullPath;
+    if (path.isAbsolute(file)) {
+        fullPath = file;
+    }
+    else {
+        fullPath = path.join(__dirname, file);
+    }
+    var csvArray = readCSV(fullPath);
+    for (let dictRow of csvArray) {
+        let geoID = dictRow['GEOID'];
+        // TODO - This should be '[]', I think.
+        let electionSelect = {};
+        electionSelect[0 /* Democratic */] = Number(dictRow['DEM']);
+        electionSelect[1 /* Republican */] = Number(dictRow['REP']);
+        electionSelect[2 /* Total */] = Number(dictRow['TOT']);
+        election[geoID] = electionSelect;
+    }
+    return election;
+}
+exports.readElectionCSV = readElectionCSV;
+//# sourceMappingURL=data.js.map

package/lib/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,yBAAyB;AACzB,EAAE;;AAEF,yBAAyB;AACzB,6BAA6B;AAC7B,4CAA4C;AA8B5C,SAAgB,SAAS,CAAC,CAAmB;IAC3C,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;AACjC,CAAC;AAFD,8BAEC;AAED,SAAgB,UAAU,CAAC,CAAmB,EAAE,CAAS;IACvD,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAFD,gCAEC;AAED,SAAgB,YAAY,CAAC,CAAmB,EAAE,CAAM;IACtD,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAFD,oCAEC;AAED,gEAAgE;AAChE,SAAgB,cAAc,CAAC,CAAmB,EAAE,CAAM,EAAE,EAAW,EAAE,EAAU;IACjF,IAAI,EAAE,GAAW,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAE3C,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAJD,wCAIC;AAED,wEAAwE;AACxE,iCAAiC;AACjC,gBAAgB;AAChB,SAAS,eAAe,CAAC,CAAM,EAAE,UAAkB,EAAE,CAAS;IAC5D,wEAAwE;IACxE,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC5C,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;KAChD;IAED,yDAAyD;IAEzD,mBAAmB;IACnB,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS;QAC/C,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEzB,mBAAmB;IACnB,IAAI,CAAC,GAAU,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE;QACL,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACzC,IAAI,CAAC,GAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,UAAU,EAAE;gBACf,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;oBACpB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;aACf;iBACI;gBACH,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC;oBAC5C,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wBAC9B,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;aACzC;SACF;KACF;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,CAAM;IACzB,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,SAAgB,WAAW,CAAC,CAAmB;IAC7C,OAAO,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC;AACpC,CAAC;AAFD,kCAEC;AAED,SAAgB,mBAAmB,CAAC,CAAe;IACjD,OAAO,CAAC,CAAC,UAAU,CAAC;AACtB,CAAC;AAFD,kDAEC;AAED,SAAgB,eAAe,CAAC,CAAmB;IACjD,CAAC,CAAC,eAAe,GAAG,EAA4B,CAAC;AACnD,CAAC;AAFD,0CAEC;AAGD,wCAAwC;AAExC,sCAAsC;AACtC,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI;QACF,IAAI,CAAC,GAAW,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;KACV;IACD,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAVD,0CAUC;AAED,SAAgB,QAAQ,CAAC,IAAY;IACnC,IAAI,QAAgB,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;KACjB;SACI;QACH,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;KACvC;IAED,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAVD,4BAUC;AAED,0EAA0E;AAC1E,SAAgB,OAAO,CAAC,IAAY;IAClC,IAAI;QACF,IAAI,KAAK,GAAW,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,QAAQ,GAAQ,KAAK,CAAC,KAAK,EAAE;YAC/B,OAAO,EAAE,IAAI;YACb,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;KACjB;IACD,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAbD,0BAaC;AAED,+BAA+B;AAC/B,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,GAAG,EAAmB,CAAC;IAE/B,IAAI,QAAgB,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;KACjB;SACI;QACH,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;KACvC;IAED,IAAI,QAAQ,GAAQ,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE;QAC5B,IAAI,KAAK,GAAW,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,UAAU,GAAW,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,qBAAqB;QACrB,gDAAgD;QAEhD,IAAI,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;KAC1B;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAvBD,kCAuBC;AAED,oCAAoC;AACpC,SAAgB,aAAa,CAAC,IAAY;IACxC,IAAI,MAAM,GAAG,EAAqB,CAAC;IAEnC,IAAI,QAAgB,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;KACjB;SACI;QACH,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;KACvC;IAED,IAAI,QAAQ,GAAQ,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE;QAC5B,IAAI,KAAK,GAAW,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,YAAY,GAAG,EAAoB,CAAC;QAExC,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,YAAY,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,uDAAuD;QACvD,YAAY,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAElC,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,YAAY,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAC3D,uDAAuD;QACvD,YAAY,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAEpC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC;KAC9B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAnCD,sCAmCC;AAED,sCAAsC;AACtC,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI,QAAQ,GAAG,EAAqB,CAAC;IAErC,IAAI,QAAgB,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;KACjB;SACI;QACH,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;KACvC;IAED,IAAI,QAAQ,GAAQ,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE;QAC5B,IAAI,KAAK,GAAW,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,uCAAuC;QACvC,IAAI,cAAc,GAAG,EAAkB,CAAC;QAExC,cAAc,oBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,cAAc,oBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,cAAc,eAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE1D,QAAQ,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC;KAClC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AA1BD,0CA0BC"}

package/lib/equal.d.ts

@@ -0,0 +1,4 @@
+import * as T from './types';
+import { AnalyticsSession } from './api';
+export declare function doPopulationDeviation(s: AnalyticsSession): T.TestEntry;
+export declare function doHasEqualPopulations(s: AnalyticsSession): T.TestEntry;

package/lib/equal.js

@@ -0,0 +1,59 @@
+"use strict";
+//
+// EQUAL POPULATION
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const U = require("./utils");
+const D = require("./_data");
+function doPopulationDeviation(s) {
+    let test = s.getTest(4 /* PopulationDeviation */);
+    // Compute the min, max, and average district populations,
+    // excluding the dummy 'unassigned' 0 and N+1 summary "districts."
+    let totPopByDistrict = s.districts.statistics[D.DistrictField.TotalPop];
+    totPopByDistrict = totPopByDistrict.slice(1, -1);
+    let min = U.minArray(totPopByDistrict);
+    let max = U.maxArray(totPopByDistrict);
+    let total = U.sumArray(totPopByDistrict);
+    // Calculate the raw population deviation.
+    // The target size is the average population.
+    let avg = total / s.state.nDistricts;
+    let popDev = (max - min) / avg;
+    // Round the raw value to the desired level of precision
+    popDev = U.trim(popDev);
+    // Populate the test entry
+    test['score'] = popDev;
+    test['details'] = { 'maxDeviation': max - min };
+    // Populate the N+1 summary "district" in district.statistics
+    let totalPop = s.districts.statistics[D.DistrictField.TotalPop];
+    let popDevPct = s.districts.statistics[D.DistrictField.PopDevPct];
+    let summaryRow = s.districts.numberOfRows() - 1;
+    totalPop[summaryRow] = avg; // aka "target size"
+    popDevPct[summaryRow] = popDev;
+    return test;
+}
+exports.doPopulationDeviation = doPopulationDeviation;
+// NOTE - This validity check is *derived* and depends on population deviation %
+//   being computed (above) and normalized in test log & scorecard generation.
+function doHasEqualPopulations(s) {
+    let test = s.getTest(3 /* EqualPopulation */);
+    // Get the normalized population deviation %
+    let popDevTest = s.getTest(4 /* PopulationDeviation */);
+    let popDevPct = popDevTest['score'];
+    let popDevNormalized = popDevTest['normalizedScore'];
+    // Populate the test entry
+    if (popDevNormalized > 0) {
+        test['score'] = true;
+    }
+    else {
+        test['score'] = false;
+    }
+    test['details']['deviation'] = popDevPct;
+    test['details']['thresholds'] = popDevTest['details']['scale'];
+    // Populate the N+1 summary "district" in district.statistics
+    let bEqualPop = s.districts.statistics[D.DistrictField.bEqualPop];
+    let summaryRow = s.districts.numberOfRows() - 1;
+    bEqualPop[summaryRow] = test['score'];
+    return test;
+}
+exports.doHasEqualPopulations = doHasEqualPopulations;
+//# sourceMappingURL=equal.js.map

package/lib/equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equal.js","sourceRoot":"","sources":["../src/equal.ts"],"names":[],"mappings":"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"}

package/lib/features.js

@@ -0,0 +1,19 @@
+"use strict";
+//
+// GEO-FEATURES UTILITIES
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+// SHIM OVER 'POLY' FUNCTIONS
+function featureArea() {
+    console.log("featureArea() - NIY ");
+}
+exports.featureArea = featureArea;
+function featurePerimeter() {
+    console.log("featurePerimeter() - NIY ");
+}
+exports.featurePerimeter = featurePerimeter;
+function featureDiameter() {
+    console.log("featureDiameter() - NIY ");
+}
+exports.featureDiameter = featureDiameter;
+//# sourceMappingURL=features.js.map

package/lib/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,yBAAyB;AACzB,EAAE;;AAOF,6BAA6B;AAE7B,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;AACrC,CAAC;AAFD,kCAEC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;AAC1C,CAAC;AAFD,4CAEC;AAED,SAAgB,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;AACzC,CAAC;AAFD,0CAEC"}

package/lib/geofeature.js

@@ -0,0 +1,112 @@
+"use strict";
+//
+// GEO-FEATURES UTILITIES
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const Poly = require("@dra2020/poly");
+// CARTESIAN SHIMS OVER 'POLY' FUNCTIONS
+// TODO - Terry: Confirm Cartesian calculations
+function gfArea(poly) {
+    let area = _polygonArea(poly);
+    // let polyOptions = { noLatitudeCorrection: false }    DELETE
+    // let area: number = Poly.polyArea(poly, polyOptions);
+    return area;
+}
+exports.gfArea = gfArea;
+// Algorithm for the area of a simple/single planar polygon:
+// https://algorithmtutor.com/Computational-Geometry/Area-of-a-polygon-given-a-set-of-points/
+// https://mathopenref.com/coordpolygonarea2.html
+//
+// function polygonArea(X, Y, numPoints) 
+// { 
+//   area = 0;         // Accumulates area in the loop
+//   j = numPoints-1;  // The last vertex is the 'previous' one to the first
+//   for (i=0; i<numPoints; i++)
+//     { area = area +  (X[j]+X[i]) * (Y[j]-Y[i]); 
+//       j = i;  //j is previous vertex to i
+//     }
+//   return area/2;
+// }
+// Reimplemented to use polygons vs. X & Y vectors
+function _polygonSimpleArea(p) {
+    let area = 0; // Accumulates area in the loop
+    let n = p.length;
+    let j = n - 1; // The last vertex is the 'previous' one to the first
+    for (let i = 0; i < n; i++) {
+        area = area + (p[j][0] + p[i][0]) * (p[j][1] - p[i][1]);
+        // area = area + (X[j] + X[i]) * (Y[j] - Y[i]);
+        j = i; // j is previous vertex to i
+    }
+    return Math.abs(area / 2);
+}
+// Generalizes the above for MultiPolygons -- cloned from polyArea() in 'poly'
+function _polygonArea(poly) {
+    let polyOptions = { noLatitudeCorrection: true }; // NO-OP?
+    poly = Poly.polyNormalize(poly, polyOptions); // TODO - Discuss w/ Terry
+    let a = 0;
+    // A MultiPolygon is a set of polygons
+    for (let i = 0; poly && i < poly.length; i++) {
+        // A single polygon is an exterior ring with interior holes. Holes are subtracted.
+        let p = poly[i];
+        for (let j = 0; j < p.length; j++) {
+            let sp = p[j];
+            a += _polygonSimpleArea(sp) * (j == 0 ? 1 : -1);
+        }
+    }
+    return a;
+}
+// TODO - Terry: Confirm Cartesian calculations
+// The perimeter calculation already just computes cartesian distance if you
+// pass in the noLatitudeCorrection flag. You would need to divide by 
+// Poly.EARTH_RADIUS to go from the returned units of meters to Lat/Lon “units”.
+function gfPerimeter(poly) {
+    let perimeter = _polygonPerimeter(poly);
+    // let polyOptions = { noLatitudeCorrection: true }  // Cartesian distance
+    // let perimeter: number = Poly.polyPerimeter(poly, polyOptions);  DELETE
+    return perimeter;
+    // return perimeter / Poly.EARTH_RADIUS;  DELETE
+}
+exports.gfPerimeter = gfPerimeter;
+// TODO - Terry: Confirm Cartesian calculations
+// Cloned from polyPerimeter() in 'poly' and revised to use Cartesian distance
+// NOTE: No conversion of degrees to radians!
+function _polygonPerimeter(poly) {
+    let polyOptions = { noLatitudeCorrection: true }; // Cartesian distance
+    poly = Poly.polyNormalize(poly, polyOptions);
+    let perimeter = 0;
+    for (let i = 0; poly && i < poly.length; i++) {
+        // Ignore holes so only look at first polyline
+        let p = poly[i][0];
+        for (let j = 0; j < p.length - 1; j++)
+            perimeter += _distance(p[j][0], p[j][1], p[j + 1][0], p[j + 1][1]);
+        // perimeter += haversine(p[j][0], p[j][1], p[j + 1][0], p[j + 1][1], options);  DELETE
+        if (p.length > 2 && (p[0][0] != p[p.length - 1][0] || p[0][1] != p[p.length - 1][1]))
+            perimeter += _distance(p[0][0], p[0][1], p[p.length - 1][0], p[p.length - 1][1]);
+        // perimeter += haversine(p[0][0], p[0][1], p[p.length - 1][0], p[p.length - 1][1], options);  DELETE
+    }
+    return perimeter;
+}
+function _distance(x1, y1, x2, y2) {
+    let dLat = y2 - y1;
+    let dLon = x2 - x1;
+    let d;
+    d = Math.sqrt((dLat * dLat) + (dLon * dLon));
+    return d;
+}
+// TODO - Terry: Confirm Cartesian calculations
+// As I mentioned, the polyCircle code was already just treating the coordinate
+// system as Cartesian. I then did polyFromCircle to convert it to a polygon that
+// then could be passed to polyArea in order to take into account the projection.
+// If instead, you compute area directly from the circle as PI R squared, then
+// you should have your cartesian circular area.
+function gfDiameter(poly) {
+    let polyOptions = { noLatitudeCorrection: true }; // NO-OP
+    let circle = Poly.polyToCircle(poly, polyOptions);
+    // let circleArea: number = Poly.polyArea(Poly.polyFromCircle(circle, undefined, polyOptions), polyOptions);
+    // let circleRadius: number = Math.sqrt(circleArea / Math.PI);
+    // let diameter: number = circleRadius * 2;  DELETE
+    let diameter = circle.r * 2;
+    return diameter;
+}
+exports.gfDiameter = gfDiameter;
+//# sourceMappingURL=geofeature.js.map

package/lib/geofeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geofeature.js","sourceRoot":"","sources":["../src/geofeature.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+import { AnalyticsSession } from './api';
+declare const _default: {
+    AnalyticsSession: typeof AnalyticsSession;
+};
+export default _default;

package/lib/index.js

@@ -0,0 +1,11 @@
+"use strict";
+//
+// THE DISTRICT-ANALYTICS NODE PACKAGE API
+//
+function __export(m) {
+    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
+}
+Object.defineProperty(exports, "__esModule", { value: true });
+__export(require("./_api"));
+__export(require("./types"));
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0CAA0C;AAC1C,EAAE;;;;;AAEF,4BAAuB;AACvB,6BAAwB"}

package/lib/minority.d.ts

@@ -0,0 +1,3 @@
+import * as T from './types';
+import { AnalyticsSession } from './api';
+export declare function doMajorityMinorityDistricts(s: AnalyticsSession): T.TestEntry;

package/lib/minority.js

@@ -0,0 +1,61 @@
+"use strict";
+//
+// PROTECTS MINORITIES
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+// TODO - This definition is wrong. Need to fix it.
+//
+// MINORITY-PROTECTION ANALYTICS NEED THE FOLLOWING DATA:
+//
+// The TOTAL, WHITE, BLACK, and HISPANIC counts from the Census, aggregated by
+// district. We *might* also ultimately need TOTAL18, WHITE18, BLACK18, and
+// HISPANIC18 counts by feature for these analytics.
+//
+// The minority population of a feature will probably be calculated as everyone
+// exceot non-Hispanic Whites:
+//
+// MINORITY = TOTAL - (WHITE - HISPANIC)
+//
+// That could be calculated as part of preprocessing the Census data, or it
+// could be computed on the fly. Since it's derived data and the formula might
+// change, it's probably best to compute it on the fly.
+//
+// In addition to the Census extract, these analytics need:
+// - The # of districts in the map, for determining minority proportionality
+// - Minorities as a % of the total population; possibly the voting age share
+//
+// TODO - Is the # of districts passed as a parameter or inferred from the # in
+//   the map?
+// TODO - Is minority share preprocessed once and passed as a parameter or
+//   computed in a initialization routine?
+function doMajorityMinorityDistricts(s) {
+    let test = s.getTest(14 /* MajorityMinorityDistricts */);
+    console.log("TODO - Calculating # of majority-minority districts ...");
+    return test;
+}
+exports.doMajorityMinorityDistricts = doMajorityMinorityDistricts;
+// SAVE THESE NOTES, IN CASE WE NEED TO REWORK HOW WE DO PERFORM THESE CALCS.
+// THEY REFLECT HOW I/ALEC DID THESE IN PYTHON.
+//
+// MINORITY-PROTECTION ANALYTICS WILL NEED THE FOLLOWING DATA,
+// IN ADDITION TO THE MAP (IDEALLY, GEO_IDS INDEXED BY DISTRICT_ID)
+//
+// Census data by geo_id - { total population | white | black | hispanic }
+//
+// The minority population of a feature will probably be calculated as the # of
+// non-White Hispanics:
+//
+// MINORITY = TOTAL - (WHITE - HISPANIC)
+//
+// That could be calculated as part of preprocessing the Census data, or it
+// could be computed on the fly.
+//
+// And probably:
+// 'districts' - The # of districts for determining minority proportionality.
+// 'minority_share' - Minorities as a % of the total population
+//
+// TODO - Is the # of districts passed as a parameter or inferred from the # in
+//   the map?
+// TODO - Is minority share preprocessed once and passed as a parameter or
+//   computed in a initialization routine?
+//# sourceMappingURL=minority.js.map

package/lib/minority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minority.js","sourceRoot":"","sources":["../src/minority.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,sBAAsB;AACtB,EAAE;;AASF,mDAAmD;AACnD,EAAE;AACF,yDAAyD;AACzD,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,oDAAoD;AACpD,EAAE;AACF,+EAA+E;AAC/E,8BAA8B;AAC9B,EAAE;AACF,wCAAwC;AACxC,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,uDAAuD;AACvD,EAAE;AACF,2DAA2D;AAC3D,4EAA4E;AAC5E,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,aAAa;AACb,0EAA0E;AAC1E,0CAA0C;AAG1C,SAAgB,2BAA2B,CAAC,CAAmB;IAC7D,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,oCAAiD,CAAC;IAEtE,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IAEvE,OAAO,IAAI,CAAC;AACd,CAAC;AAND,kEAMC;AAED,6EAA6E;AAC7E,+CAA+C;AAC/C,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,EAAE;AACF,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,uBAAuB;AACvB,EAAE;AACF,wCAAwC;AACxC,EAAE;AACF,2EAA2E;AAC3E,gCAAgC;AAChC,EAAE;AACF,gBAAgB;AAChB,6EAA6E;AAC7E,+DAA+D;AAC/D,EAAE;AACF,+EAA+E;AAC/E,aAAa;AACb,0EAA0E;AAC1E,0CAA0C"}

package/lib/political.d.ts

@@ -0,0 +1,7 @@
+import * as T from './types';
+import { AnalyticsSession } from './api';
+export declare function doSeatsBias(s: AnalyticsSession): T.TestEntry;
+export declare function doVotesBias(s: AnalyticsSession): T.TestEntry;
+export declare function doResponsiveness(s: AnalyticsSession): T.TestEntry;
+export declare function doResponsiveDistricts(s: AnalyticsSession): T.TestEntry;
+export declare function doEfficiencyGap(s: AnalyticsSession): T.TestEntry;

package/lib/political.js

@@ -0,0 +1,88 @@
+"use strict";
+//
+// FAIR/PROPORTIONAL
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert_1 = require("assert");
+const U = require("./utils");
+const D = require("./_data");
+// Partisan analytics need the following data:
+//
+// An "election model" by geo_id, where each item has 4 pieces of data:
+//
+//   { geo_id, Democratic votes, Republican votes, Total votes }
+//
+// NOTE: D + R <= Total, because there could be third-party or write-in votes.
+//
+// An election model can simply represent one election, e.g., President 2012,
+// or combine multiple elections in some fashion. An election model is used to
+// computer a single index of the likely partisan weight / lean / preference
+// for the districts in a plan. An election model and the associated index go
+// hand in hand. So much so that the index frequently stands in as the name for
+// both, e.g., Cook's PVI is one example, Nagle's 7s, Hofeller's Formula, NDRC's
+// DPI.
+//
+// I'm labelling this general concept a "Voter Preference Index (VPI)," a
+// conscious +1 letter play on Cook's "PVI" acronymn.
+// MEASURING BIAS & RESPONSIVENESS (NAGLE'S METHOD)
+function doSeatsBias(s) {
+    let test = s.getTest(9 /* SeatsBias */);
+    console.log("TODO - Calculating seats bias ...");
+    return test;
+}
+exports.doSeatsBias = doSeatsBias;
+function doVotesBias(s) {
+    let test = s.getTest(10 /* VotesBias */);
+    console.log("TODO - Calculating votes bias ...");
+    return test;
+}
+exports.doVotesBias = doVotesBias;
+function doResponsiveness(s) {
+    let test = s.getTest(11 /* Responsiveness */);
+    console.log("TODO - Calculating responsiveness ...");
+    return test;
+}
+exports.doResponsiveness = doResponsiveness;
+function doResponsiveDistricts(s) {
+    let test = s.getTest(12 /* ResponsiveDistricts */);
+    console.log("TODO - Calculating # of responsive districts ...");
+    return test;
+}
+exports.doResponsiveDistricts = doResponsiveDistricts;
+// OTHER MEASURES OF PARTISAN BIAS
+// TODO - This formula might need to be inverted for D vs. R +/-
+// TODO - Normalize the results.
+function doEfficiencyGap(s) {
+    console.log("TODO - Calculating the efficiency gap ...");
+    let test = s.getTest(13 /* EfficiencyGap */);
+    // Get partisan statistics by districts.
+    // Use Democratic votes, seats, and shares by convention.
+    let DVotes = s.districts.statistics[D.DistrictField.DemVotes];
+    let DSeats = s.districts.statistics[D.DistrictField.DemSeat];
+    let TPVotes = s.districts.statistics[D.DistrictField.TwoPartyVote];
+    // Exclude the dummy unassigned '0' and N+1 summary "districts"
+    DVotes = DVotes.slice(1, -1);
+    DSeats = DSeats.slice(1, -1);
+    TPVotes = TPVotes.slice(1, -1);
+    // Calculate D vote share & D seat share
+    let DVoteShare = U.sumArray(DVotes) / U.sumArray(TPVotes);
+    let DSeatShare = U.sumArray(DSeats) / s.state.nDistricts;
+    // Finally, calculate the Efficiency Gap
+    let efficiencyGap = (DSeatShare - 0.5) - (2.0 * (DVoteShare - 0.5));
+    // Round the raw value to the desired level of precision
+    efficiencyGap = U.trim(efficiencyGap);
+    // Populate the test entry
+    test['score'] = efficiencyGap;
+    // test['normalizedScore'] = 0;     /* TODO - Normalize the raw score */
+    test['details'] = {}; /* TODO - Add details, if any     */
+    return test;
+}
+exports.doEfficiencyGap = doEfficiencyGap;
+// HELPERS
+function fptpWin(demPct) {
+    // Vote shares should be fractions in the range [0.0 – 1.0]
+    assert_1.strict((demPct <= 1.0) && (demPct >= 0.));
+    return ((demPct > 0.5) ? 1 : 0);
+}
+exports.fptpWin = fptpWin;
+//# sourceMappingURL=political.js.map

package/lib/political.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"political.js","sourceRoot":"","sources":["../src/political.ts"],"names":[],"mappings":"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"}

package/lib/preprocess.d.ts

@@ -0,0 +1,4 @@
+import * as T from './types';
+import { AnalyticsSession } from './api';
+export declare function doPreprocessData(s: AnalyticsSession): void;
+export declare function invertPlan(plan: T.PlanByGeoID): T.PlanByDistrictID;