@dra2020/district-analytics 1.0.6 → 1.0.7

package/lib/api.js

@@ -0,0 +1,117 @@
+"use strict";
+//
+// THE NODE PACKAGE API
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const U = require("./utils");
+const preprocess_1 = require("./preprocess");
+const analyze_1 = require("./analyze");
+const report_1 = require("./report");
+class AnalyticsSession {
+    constructor(SessionRequest) {
+        this._config = {};
+        this._testScales = {};
+        this._tests = {};
+        this._scorecard = {};
+        // Grab the session parameters & pointers to data
+        this._title = SessionRequest['title'];
+        this._xx = SessionRequest['stateXX'];
+        this._legislativeDistricts = SessionRequest['legislativeDistricts'];
+        this._nDistricts = SessionRequest['nDistricts'];
+        this._planByGeoID = SessionRequest['plan'];
+        this._data = SessionRequest['data'];
+        this._featureIDs = {};
+        // TODO - INTEGRATION: data2.json
+        this._census = SessionRequest['census'];
+        this._election = SessionRequest['election'];
+        this._districtShapes = SessionRequest['districtShapes'];
+        this._districtProperties = {};
+        this._graph = SessionRequest['graph'];
+        this._countyNameLookup = {};
+        this._countyFeatures = SessionRequest['countyFeatures'];
+        this._stateTotal = 0;
+        this._nCounties = 0;
+        this._tooBigFIPS = [];
+        this._tooBigName = [];
+        this._expectedSplits = 0;
+        this._expectedAffected = 0;
+        // TODO - INTEGRATION: DELETE
+        // Process the config request
+        // let configRequest: T.Dict = {};
+        let defaultSuites = [0 /* Legal */, 1 /* Fair */, 2 /* Best */];
+        let defaultConfig = { 'suites': defaultSuites };
+        // TODO - INTEGRATION data2.json 
+        // NOTE - Session settings are required:
+        // - Analytics suites can be defaulted to all with [], but
+        // - Dataset must be explicitly specified
+        this._config = SessionRequest['config'];
+        // If a config was passed in w/ empty suites = [], use the default suites
+        if (U.isArrayEmpty(this._config['suites'])) {
+            this._config['suites'] = defaultSuites;
+        }
+        // TODO - INTEGRATION: DELETE
+        // // If no config was passed in or it's empty, use the default config
+        // if ((SessionRequest['config'] == undefined) || (!(U.keyExists('config', SessionRequest)))) {
+        //   this._config = defaultConfig;
+        // }
+        // else {
+        //   // If a config was passed in w/o suites, use the default suites
+        //   if (!(U.keyExists('suites', SessionRequest['config']))) {
+        //     this._config['suites'] = defaultSuites;
+        //   }
+        //   // Otherwise use the config (and suites) as passed in
+        //   else {
+        //     this._config = SessionRequest['config'];
+        //   }
+        // }
+        this._planByDistrictID = {};
+        this._countyIndex = {};
+        this._bOneTimeProcessingDone = false;
+        this._bPlanAnalyzed = false;
+        this._bPostProcessingDone = false;
+        // NOTE: I've pulled these out of the individual analytics to here. Eventually,
+        // we could want them to passed into an analytics session as data, along with
+        // everything else. For now, this keeps branching out of the main code.
+        report_1.doConfigureScales(this);
+    }
+    // Using the the data in the analytics session, calculate all the
+    // analytics & validations, saving/updating the individual test results.
+    analyzePlan(bLog = false) {
+        try {
+            preprocess_1.doPreprocessData(this);
+            analyze_1.doAnalyzePlan(this, bLog);
+        }
+        catch (_a) {
+            return false;
+        }
+        return true;
+    }
+    // TODO - Terry/Dave: Do I need a guard here?
+    // Get an individual test, so you can drive UI with the results.
+    getTest(testID) {
+        // Get the existing test entries
+        // T.Test is a numeric enum, so convert the string keys to numbers
+        let testValues = U.getNumericObjectKeys(this._tests);
+        // If there's no entry for this test, create & initialize one
+        if (!(testValues.includes(testID))) {
+            this._tests[testID] = {};
+            this._tests[testID]['score'] = undefined;
+            this._tests[testID]['details'] = {};
+            this._tests[testID]['districtWIP'] = {};
+        }
+        // Return a pointer to the the test entry for this test
+        return this._tests[testID];
+    }
+    // Prepare a scorecard for rendering
+    // NOTE - This assumes that analyzePlan() has been run!
+    prepareScorecard() {
+        return report_1.doPrepareScorecard(this);
+    }
+    // Prepare test results for rendering
+    // NOTE - This assumes that analyzePlan() has been run!
+    prepareTestLog() {
+        return report_1.doPrepareTestLog(this);
+    }
+}
+exports.AnalyticsSession = AnalyticsSession;
+//# sourceMappingURL=api.js.map

package/lib/api.js.map

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

package/lib/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/cli.js

@@ -0,0 +1,386 @@
+"use strict";
+//
+// A SIMPLE COMMAND-LINE INTERFACE FOR EXERCISING THE ANALYTICS & VALIDATIONS
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs = require("yargs");
+// TODO - DELETE
+// import * as fs from 'fs';
+// import * as path from 'path';
+// import * as parse from 'csv-parse/lib/sync';
+const PC = require("polygon-clipping");
+const Poly = require("@dra2020/poly");
+const api_1 = require("./api");
+const preprocess_1 = require("./preprocess");
+const valid_1 = require("./valid");
+const equal_1 = require("./equal");
+const compact_1 = require("./compact");
+const cohesive_1 = require("./cohesive");
+const political_1 = require("./political");
+const minority_1 = require("./minority");
+const U = require("./utils");
+const D = require("./data");
+// Simulate DRA unioning district shapes in the background
+function addToPoly(poly, polys) {
+    return PC.union(poly, ...polys);
+}
+console.log("Starting command @ ", new Date());
+// COMMAND LINE
+let argv = yargs
+    .usage('Usage: $0 command [options]')
+    .example('$0 equal -f foo.geojson', 'Calculate population deviation')
+    .demandCommand(1, 'You must specify a command to execute.')
+    .command('valid', 'Perform validations.')
+    .command('equal', 'Calculate population deviation.')
+    .command('compact', 'Calculate compactness.')
+    .command('cohesive', 'Calculate cohesiveness.')
+    .command('political', 'Assess fairness.')
+    .command('minority', 'Count majority-minority districts.')
+    .command('analyze', 'API call to analyze a plan.')
+    .command('report', 'API call to generate a scorecard.')
+    .option('state', {
+    alias: 'xx',
+    describe: 'Specify the state.',
+    type: 'string'
+})
+    .option('number', {
+    alias: 'n',
+    describe: 'Specify the number of districts.',
+    type: 'number'
+})
+    .option('legislative', {
+    alias: 'l',
+    describe: 'Specify that districts are legislative.',
+    type: 'boolean',
+    default: false
+})
+    .option('plan', {
+    alias: 'p',
+    describe: 'Specify the plan to evaluate.',
+    type: 'string'
+})
+    .option('census', {
+    alias: 'c',
+    describe: 'Specify the Census data to use.',
+    type: 'string'
+})
+    .option('shapes', {
+    alias: 's',
+    describe: 'Specify the shapes to use.',
+    type: 'string'
+})
+    .option('graph', {
+    alias: 'g',
+    describe: 'Specify the contiguity graph to use.',
+    type: 'string'
+})
+    .option('election', {
+    alias: 'e',
+    describe: 'Specify the election data to use.',
+    type: 'string'
+})
+    .option('counties', {
+    alias: 'f',
+    describe: 'Specify the FIPS-to-county-name map to use.',
+    type: 'string'
+})
+    .option('empty', {
+    describe: 'Specify whether a district should be empty.',
+    type: 'boolean',
+    default: false
+})
+    .option('suites', {
+    describe: 'Specify the test suites to run.',
+    type: 'array',
+    default: []
+})
+    .option('verbose', {
+    alias: 'v',
+    describe: 'Specify whether code should log to STDOUT.',
+    type: 'boolean',
+    default: false
+})
+    .demandOption(['number', 'plan', 'census', 'shapes', 'election', 'counties'], 'Please specify all the args.')
+    .help()
+    .argv;
+// PROCESS COMMAND LINE ARGS
+let command = argv._[0];
+let xx = argv.state;
+let bLegislativeDistricts = argv.legislative;
+let nDistricts = argv.n;
+let planByGeoID = D.readPlanCSV(argv.plan);
+// Don't load other datasets, if just calculating compactness
+let graph = {};
+let census = {};
+// TODO - INTEGRATION: data2.json
+let data = {};
+// TODO - DELETE
+let election = {};
+let counties = {};
+if (command != 'compact') {
+    graph = D.readJSON(argv.graph);
+    // TODO - INTEGRATION: data2.json
+    data = D.readJSON("../data/SAMPLE-BG-data2.json");
+    // TODO - DELETE
+    census = D.readCensusCSV(argv.census);
+    election = D.readElectionCSV(argv.election);
+    counties = D.readJSON(argv.counties);
+}
+let shapes = D.readJSON(argv.shapes);
+let bEmpty = argv.empty;
+// TODO - INTEGRATION: 
+// - Expand 'suites' to 'settings'
+// - Allow 'datasets' to be passed in from the command line too
+// - Update configs
+let suites = argv.suites;
+// TODO - INTEGRATION: Delete
+// Keys for the datasets to use for analytics & display
+// export type DSKeys = {
+//   CENSUS: string;    // A total population Census dataset
+//   VAP: string;       // A voting age (or citizen voting age) dataset
+//   ELECTION: string;  // An election dataset
+// }
+let datasets = {
+    CENSUS: "D16F",
+    VAP: "D16T",
+    ELECTION: "E16GPR"
+};
+// } as D.DSKeys;
+// Session settings are required:
+// - Analytics suites can be defaulted to all with [], but
+// - Dataset must be explicitly specified
+let sessionSettings = {
+    'suites': suites,
+    'datasets': datasets
+};
+let bLog = argv.verbose;
+// TODO - INTEGRATION: Does DRA have this to pass?
+// Invert the plan, so you can create the district shapes for the SessionRequest.
+let planByDistrictID = preprocess_1.invertPlan(planByGeoID);
+// SIMULATE THE HOST
+// 1 - Create district shapes & extract properties (area, diameter, perimeter)
+const polyOptions = {
+    noLatitudeCorrection: false
+};
+// Index the shapes by geoID
+let shapesByGeoID = {};
+let idStr = "GEOID";
+// TODO - Terry: But sometimes "GEOID10" hasn't been set to "GEOID"
+let firstFeature = shapes.features[0];
+if (!(firstFeature.properties == null)) {
+    if (U.keyExists("GEOID10", firstFeature.properties))
+        idStr = "GEOID10";
+}
+for (let f of shapes.features) {
+    if (!(f.properties == null)) {
+        // let idStr = "GEOID";
+        // TODO - Terry: Sometimes "GEOID10" hasn't been => to "GEOID!"
+        // if (U.keyExists("GEOID10", f.properties)) idStr = "GEOID10";
+        let geoID = f.properties[idStr];
+        shapesByGeoID[geoID] = f;
+    }
+}
+// Find the smallest Feature
+// COPIED from dra-client/geodistrict.ts, and lightly modified
+let geo = shapes;
+let minFeatureArea = Poly.polyArea(geo.features[0], polyOptions);
+for (let i = 1; i < geo.features.length; i++) {
+    let a = Poly.polyArea(geo.features[i], polyOptions);
+    if (a < minFeatureArea)
+        minFeatureArea = a;
+}
+// Eliminate anomalous holes
+// COPIED from dra-client/geodistrict.ts, and lightly modified
+// This is a bit of a hack in the sense that it is still an open question as to whether this is a problem
+// with either the underlying shape data or a problem in our simplification of that shape data.
+// But in any case, what this does is eliminate any holes that are smaller than the smallest feature. Such
+// a hole must be an anomaly. CA/2010_VT in particular seems to have many such issues.
+function eliminateAnomalousHoles(mp) {
+    // Normalize to multipolygon
+    if (U.depthof(mp) == 4)
+        mp = [mp];
+    for (let i = 0; i < mp.length; i++) {
+        let p = mp[i];
+        let cleanp = [p[0]];
+        for (let j = 1; j < p.length; j++) {
+            let a = Poly.polyArea(p[j], polyOptions);
+            if (a >= minFeatureArea)
+                cleanp.push(p[j]);
+        }
+        if (cleanp.length < p.length)
+            mp[i] = cleanp;
+    }
+}
+// Create district shapes
+let districtShapes = {};
+districtShapes['type'] = "FeatureCollection";
+districtShapes['features'] = [];
+for (let districtID = 1; districtID <= nDistricts; districtID++) {
+    let districtFeatures = [];
+    // Collect Features by district
+    planByDistrictID[districtID].forEach(function (geoID) {
+        districtFeatures.push(shapesByGeoID[geoID]);
+    });
+    // Union them together
+    let poly1Coordinates = Poly.polyNormalize(districtFeatures[0], polyOptions);
+    let polyNCoordinates = districtFeatures.slice(1).map((i) => Poly.polyNormalize(i, polyOptions));
+    let poly = addToPoly(poly1Coordinates, polyNCoordinates);
+    // Convert the result to a Feature
+    let bPolygon = U.depthof(poly) == 4;
+    if (!bPolygon && poly.length == 1) {
+        bPolygon = true;
+        poly = poly[0];
+    }
+    eliminateAnomalousHoles(poly);
+    let f = {
+        type: 'Feature',
+        properties: { districtID: `${districtID}` },
+        geometry: {
+            type: bPolygon ? 'Polygon' : 'MultiPolygon',
+            coordinates: poly
+        }
+    };
+    districtShapes.features.push(f);
+}
+// CONSTRUCT A SESSION REQUEST
+let SessionRequest = {};
+SessionRequest['title'] = "CLI Test";
+SessionRequest['stateXX'] = xx;
+SessionRequest['nDistricts'] = nDistricts;
+SessionRequest['legislativeDistricts'] = bLegislativeDistricts;
+SessionRequest['plan'] = planByGeoID;
+SessionRequest['data'] = data;
+// TODO - INTEGRATION: data2.json
+SessionRequest['census'] = census;
+SessionRequest['election'] = election;
+SessionRequest['districtShapes'] = districtShapes;
+SessionRequest['graph'] = graph;
+SessionRequest['countyFeatures'] = counties;
+// TODO - INTEGRATION: DELETE
+// if (!(U.isArrayEmpty(suites))) {
+//   sessionSettings['suites'] = suites;
+// }
+SessionRequest['config'] = sessionSettings;
+// CREATE AND INITIALIZE AN ANALYTICS SESSION
+let s = new api_1.AnalyticsSession(SessionRequest);
+// DISPATCH TO REQUESTED COMMAND W/ NEEDED SCAFFOLDING
+let t;
+let text;
+function echoTestResult(test, t) {
+    console.log("");
+    console.log("Test:", test);
+    console.log("Score:", t['score']);
+    let keys = U.getObjectKeys(t['details']);
+    if (keys.length > 0) {
+        console.log("Details:");
+        for (let i in keys) {
+            let key = keys[i];
+            console.log("-", key, "=", t['details'][key]);
+        }
+    }
+    console.log("___");
+}
+if (bEmpty) {
+    // Make a district empty
+    let randomDistrict = Math.floor(Math.random() * s._nDistricts) + 1;
+    // TODO - Terry, why does this constructor not need a <T> type specification?
+    s._planByDistrictID[randomDistrict] = new Set();
+}
+switch (command) {
+    case 'valid': {
+        preprocess_1.doPreprocessData(s);
+        t = valid_1.doIsComplete(s);
+        echoTestResult("Complete:", t);
+        t = valid_1.doIsContiguous(s);
+        echoTestResult("Contiguous:", t);
+        t = valid_1.doIsFreeOfHoles(s);
+        echoTestResult("Free of holes:", t);
+        t = equal_1.doPopulationDeviation(s);
+        echoTestResult("Population deviation (%):", t);
+        t = equal_1.doHasEqualPopulations(s);
+        echoTestResult("Equal populations:", t);
+        break;
+    }
+    case 'equal': {
+        preprocess_1.doPreprocessData(s);
+        t = equal_1.doPopulationDeviation(s);
+        echoTestResult("Population deviation (%):", t);
+        break;
+    }
+    case 'compact': {
+        preprocess_1.doPreprocessData(s);
+        t = compact_1.doReock(s, bLog);
+        echoTestResult("Reock:", t);
+        t = compact_1.doPolsbyPopper(s, bLog);
+        echoTestResult("Polsby-Popper:", t);
+        break;
+    }
+    case 'cohesive': {
+        preprocess_1.doPreprocessData(s);
+        t = cohesive_1.doCountySplits(s);
+        echoTestResult("County splits:", t);
+        cohesive_1.doPlanComplexity(s);
+        break;
+    }
+    case 'political': {
+        preprocess_1.doPreprocessData(s);
+        political_1.doSeatsBias(s);
+        political_1.doVotesBias(s);
+        political_1.doResponsiveness(s);
+        political_1.doResponsiveDistricts(s);
+        t = political_1.doEfficiencyGap(s);
+        echoTestResult("Efficiency gap (%):", t);
+        break;
+    }
+    case 'minority': {
+        preprocess_1.doPreprocessData(s);
+        minority_1.doMajorityMinorityDistricts(s);
+        break;
+    }
+    case 'analyze': {
+        console.log("");
+        console.log("Analyzing a plan ...");
+        console.log("");
+        s.analyzePlan(bLog);
+        break;
+    }
+    case 'scorecard': {
+        s.analyzePlan(bLog);
+        text = s.prepareScorecard();
+        console.log("");
+        for (let line of text.data) {
+            console.log(line['variant'], line['text']);
+        }
+        console.log("");
+        break;
+    }
+    case 'testlog': {
+        s.analyzePlan(bLog);
+        text = s.prepareTestLog();
+        console.log("");
+        for (let line of text.data) {
+            console.log(line['variant'], line['text']);
+        }
+        console.log("");
+        break;
+    }
+    case 'limit': {
+        s.analyzePlan(bLog);
+        text = s.prepareScorecard();
+        console.log("");
+        for (let line of text.data) {
+            console.log(line['variant'], line['text']);
+        }
+        console.log("");
+        text = s.prepareTestLog();
+        console.log("");
+        for (let line of text.data) {
+            console.log(line['variant'], line['text']);
+        }
+        console.log("");
+        break;
+    }
+}
+console.log("Ending command @ ", new Date());
+// FIN
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

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

package/lib/cohesive.d.ts

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

package/lib/cohesive.js

@@ -0,0 +1,132 @@
+"use strict";
+//
+// "COHESIVE" - We're naming this category which is about county splitting.
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const U = require("./utils");
+const D = require("./_data");
+function doCountySplits(s) {
+    let test = s.getTest(7 /* CountySplits */);
+    // THE THREE VALUES TO DETERMINE FOR A PLAN
+    let unexpectedSplits = 0;
+    let unexpectedAffected = 0;
+    let countiesSplitUnexpectedly = [];
+    // FIRST, ANALYZE THE COUNTY SPLITING FOR THE PLAN
+    // Pivot census totals into county-district "splits"
+    let countiesByDistrict = s.districts.statistics[D.DistrictField.CountySplits];
+    // countiesByDistrict = countiesByDistrict.slice(1, -1);
+    // Find the single-county districts, i.e., districts NOT split across counties.
+    // Ignore the dummy unassigned 0 and N+1 summary "districts."
+    let singleCountyDistricts = [];
+    for (let d = 1; d <= s.state.nDistricts; d++) {
+        // See if there's only one county partition
+        let nCountiesInDistrict = 0;
+        for (let c = 0; c < s.counties.nCounties; c++) {
+            if (countiesByDistrict[d][c] > 0) {
+                nCountiesInDistrict += 1;
+                if (nCountiesInDistrict > 1) {
+                    break;
+                }
+            }
+        }
+        // If so, save the district
+        if (nCountiesInDistrict == 1) {
+            singleCountyDistricts.push(d);
+        }
+    }
+    // Process the splits/partitions in the plan:
+    // - Count the total # of partitions,
+    // - Find the counties split across districts, and
+    // - Accumulate the number people affected (except when single-county districts)
+    let nPartitionsOverall = 0;
+    let splitCounties = new Set(); // The counties that are split across districts
+    let totalAffected = 0; // The total population affected by those splits
+    for (let c = 0; c < s.counties.nCounties; c++) {
+        let nCountyParts = 0;
+        let subtotal = 0;
+        for (let d = 1; d <= s.state.nDistricts; d++) {
+            if (countiesByDistrict[d][c] > 0) {
+                nPartitionsOverall += 1;
+                nCountyParts += 1;
+                if (!(U.arrayContains(singleCountyDistricts, d))) {
+                    subtotal += countiesByDistrict[d][c];
+                }
+            }
+        }
+        if (nCountyParts > 1) {
+            splitCounties.add(c);
+            totalAffected += subtotal;
+        }
+    }
+    // Convert county ordinals to FIPS codes
+    let splitCountiesFIPS = U.getSelectObjectKeys(s.counties.index, [...splitCounties]);
+    // THEN TAKE ACCOUNT OF THE COUNTY SPLITTING THAT IS EXPECTED (REQUIRED)
+    // Compute the total number of splits this way, in case any counties are split
+    // more than once. I.e., it's not just len(all_counties_split).
+    let nSplits = nPartitionsOverall - s.counties.nCounties;
+    // Determine the number of *unexpected* splits. NOTE: Prevent negative numbers,
+    // in case you have a plan the *doesn't* split counties that would have to be
+    // split due to their size.
+    unexpectedSplits = Math.max(0, nSplits - s.state.expectedSplits);
+    // Subtract off the total population that *has* to be affected by splits,
+    // because their counties are too big. NOTE: Again, prevent negative numbers, 
+    // in case you have a plan the *doesn't* split counties that would have to be
+    // split due to their size.
+    unexpectedAffected = U.trim(Math.max(0, totalAffected - s.state.expectedAffected) / s.state.totalPop);
+    // Find the counties that are split *unexpectedly*. From all the counties that
+    // are split, remove those that *have* to be split, because they are bigger than
+    // a district.
+    let countiesSplitUnexpectedlyFIPS = [];
+    for (let fips of splitCountiesFIPS) {
+        if (!(U.arrayContains(s.state.tooBigFIPS, fips))) {
+            countiesSplitUnexpectedlyFIPS.push(fips);
+        }
+    }
+    //  ... and convert the FIPS codes to county names.
+    for (let fips of countiesSplitUnexpectedlyFIPS) {
+        countiesSplitUnexpectedly.push(s.counties.nameFromFIPS(fips));
+    }
+    countiesSplitUnexpectedly = countiesSplitUnexpectedly.sort();
+    // Cache the results in the test
+    test['score'] = unexpectedAffected; // TODO - Use Moon's complexity metric here
+    test['details'] = {
+        'unexpectedSplits': unexpectedSplits,
+        'unexpectedAffected': unexpectedAffected,
+        'countiesSplitUnexpectedly': countiesSplitUnexpectedly
+    };
+    return test;
+}
+exports.doCountySplits = doCountySplits;
+// 2 - THE COMPLEXITY ANALYTIC NEEDS THE FOLLOWING DATA:
+//
+// If a map is already in simplified (mixed) form, the complexity analytic needs
+// two pieces of data:
+// - The counts of features by summary level--i.e., the numbers of counties, tracts,
+//   block groups, and blocks in a state; and
+// - The map -- So it can count the features by summary level in the map,
+//   as well as the number of BG’s that are split.
+//
+// TODO - Where would the state counts come from? Preprocessed and passed in, or
+//   done in a one-time initialization call (which would require a full set of
+//   block geo_id's for the state).
+//
+// However, if a map is not yet (fully) simplified, then determining the
+//   complexity of a map also requires a preprocessed summary level hierarchy, so
+//   you can get the child features (e.g., tracts) of a parent feature (e.g.,
+//   a county).
+//
+// NOTE - I have script for producing this hierarchy which we could repurpose.
+//
+// TODO - For mixed map processing--specfically to find the neighbors of a feature
+//   that are actually in the map (as opposed to just neighbors at the same
+//   summary level in the static graph)--you need a special hierarchy that
+//   distinguishes between the 'interior' and 'edge children of a feature.
+//
+// NOTE - The script noted above does this.
+function doPlanComplexity(s) {
+    let test = s.getTest(8 /* Complexity */);
+    console.log("TODO - Calculating plan complexity ...");
+    return test;
+}
+exports.doPlanComplexity = doPlanComplexity;
+//# sourceMappingURL=cohesive.js.map