mapshaper 0.5.88 → 0.5.92

package/bin/mapshaper-gui

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
 var defaultPort = 5555,
-    program = require('commander')
+    commander = require('commander'),
+    program = new commander.Command()
       .name('mapshaper-gui')
       .usage('[options] [file ...]')
       .option('-p, --port <port>', 'http port of server on localhost', defaultPort)
@@ -9,10 +10,14 @@ var defaultPort = 5555,
       .option('-s, --direct-save', 'save files outside the browser\'s download folder')
       .option('-f, --force-save', 'allow overwriting input files with output files')
       .option('-a, --display-all', 'turn on visibility of all layers')
+      .option('-n, --name <name(s)>', 'rename input layer or layers')
+      .option('-c, --commands <string>', 'console commands to run initially')
       .option('-t, --target <name>', 'name of layer to select initially')
+      .addOption(new commander.Option('-b, --blurb <text>',
+        'replace the default blurb on the import screen').hideHelp())
       .helpOption('-h, --help', 'show this help message')
       .version(require('../package.json').version)
-      .parse(),
+      .parse(process.argv),
     opts = program.opts(),
     http = require("http"),
     path = require("path"),
@@ -25,11 +30,11 @@ var defaultPort = 5555,
     dataFiles = expandShapefiles(program.args),
     probeCount = 0,
     sessionId = null;
-
 validateFiles(dataFiles);
 
 process.on('uncaughtException', function(err) {
-  if (err.errno === 'EADDRINUSE') {
+  // added 'code' for Node.js v16
+  if (err.errno === 'EADDRINUSE' || err.code === 'EADDRINUSE') {
     // probe for an open port, unless user has specified a non-default port
     if (port == defaultPort && probeCount < 10) {
       probeCount++;
@@ -202,11 +207,16 @@ function validateOutputFile(file) {
 }
 
 function getManifestJS(files, opts) {
-  var o = {files: files};
-  if (opts.target) o.target = opts.target;
-  if (opts.directSave) o.allow_saving = true;
-  if (opts.displayAll) o.display_all = true;
-  if (opts.quickView) o.quick_view = true;
+  var o = {
+    files: files,
+    target: opts.target,
+    allow_saving: opts.directSave,
+    display_all: opts.displayAll,
+    quick_view: opts.quickView,
+    name: opts.name,
+    commands: opts.commands,
+    blurb: opts.blurb
+  };
   return "mapshaper.manifest = " + JSON.stringify(o) + ";\n";
 }
 

package/mapshaper.js

@@ -1,6 +1,6 @@
 (function () {
 
-  var VERSION = "0.5.87";
+  var VERSION = "0.5.91";
 
 
   var utils = /*#__PURE__*/Object.freeze({
@@ -1240,7 +1240,8 @@
   // print a message to stdout
   function print() {
     STDOUT = true; // tell logArgs() to print to stdout, not stderr
-    message.apply(null, arguments);
+    // calling message() adds the "[command name]" prefix
+    _message(utils.toArray(arguments));
     STDOUT = false;
   }
 
@@ -2157,6 +2158,7 @@
   function getPointToPathInfo(px, py, ids, arcs) {
     var iter = arcs.getShapeIter(ids);
     var pPathSq = Infinity;
+    var arcId;
     var ax, ay, bx, by, axmin, aymin, bxmin, bymin, pabSq;
     if (iter.hasNext()) {
       ax = axmin = bxmin = iter.x;
@@ -2168,6 +2170,7 @@
       pabSq = pointSegDistSq2(px, py, ax, ay, bx, by);
       if (pabSq < pPathSq) {
         pPathSq = pabSq;
+        arcId = iter._ids[iter._i]; // kludge
         axmin = ax;
         aymin = ay;
         bxmin = bx;
@@ -2179,7 +2182,8 @@
     if (pPathSq == Infinity) return {distance: Infinity};
     return {
       segment: [[axmin, aymin], [bxmin, bymin]],
-      distance: Math.sqrt(pPathSq)
+      distance: Math.sqrt(pPathSq),
+      arcId: arcId
     };
   }
 
@@ -2187,11 +2191,20 @@
   // Return unsigned distance of a point to the nearest point on a polygon or polyline path
   //
   function getPointToShapeDistance(x, y, shp, arcs) {
-    var minDist = (shp || []).reduce(function(minDist, ids) {
-      var pathDist = getPointToPathDistance(x, y, ids, arcs);
-      return Math.min(minDist, pathDist);
-    }, Infinity);
-    return minDist;
+    var info = getPointToShapeInfo(x, y, shp, arcs);
+    return info ? info.distance : Infinity;
+  }
+
+  function getPointToShapeInfo(x, y, shp, arcs) {
+    return (shp || []).reduce(function(memo, ids) {
+      var pathInfo = getPointToPathInfo(x, y, ids, arcs);
+      if (!memo || pathInfo.distance < memo.distance) return pathInfo;
+      return memo;
+    }, null) || {
+      distance: Infinity,
+      arcId: -1,
+      segment: null
+    };
   }
 
   // @ids array of arc ids
@@ -2276,6 +2289,7 @@
     getPointToPathDistance: getPointToPathDistance,
     getPointToPathInfo: getPointToPathInfo,
     getPointToShapeDistance: getPointToShapeDistance,
+    getPointToShapeInfo: getPointToShapeInfo,
     getAvgPathXY: getAvgPathXY,
     getMaxPath: getMaxPath,
     countVerticesInPath: countVerticesInPath,
@@ -5376,6 +5390,10 @@
       };
     };
 
+    this.getVertex2 = function(i) {
+      return [_xx[i], _yy[i]];
+    };
+
     // @nth: index of vertex. ~(idx) starts from the opposite endpoint
     this.indexOfVertex = function(arcId, nth) {
       var absId = arcId < 0 ? ~arcId : arcId,
@@ -9350,15 +9368,23 @@
     var getters = {
       name: lyr.name,
       data: records,
-      type: lyr.geometry_type
+      type: lyr.geometry_type,
+      size: getFeatureCount(lyr),
+      empty: getFeatureCount(lyr) === 0
     };
     addGetters(obj, getters);
     addBBoxGetter(obj, lyr, arcs);
-    obj.empty = function() {
-      return getFeatureCount(lyr) === 0;
+    obj.field_exists = function(name) {
+      return lyr.data && lyr.data.fieldExists(name) ? true : false;
     };
-    obj.size = function() {
-      return getFeatureCount(lyr);
+    obj.field_type = function(name) {
+      return lyr.data && getColumnType(name, lyr.data.getRecords()) || null;
+    };
+    obj.field_includes = function(name, val) {
+      if (!lyr.data) return false;
+      return lyr.data.getRecords().some(function(rec) {
+        return rec && (rec[name] === val);
+      });
     };
     return obj;
   }
@@ -20116,33 +20142,22 @@ ${svg}
      .option('target', targetOpt);
 
     parser.command('symbols')
-      // .describe('symbolize points as polygons, circles, stars or arrows')
+      .describe('symbolize points as arrows, circles, stars, polygons, etc.')
       .option('type', {
-        describe: 'symbol type (e.g. star, polygon, circle, arrow)'
-      })
-      .option('scale', {
-        describe: 'scale symbols by a factor',
-        type: 'number'
+        describe: 'symbol type (e.g. arrow, circle, square, star, polygon, ring)'
       })
-      .option('pixel-scale', {
-        describe: 'symbol scale in meters-per-pixel (see polygons option)',
-        type: 'number',
+      .option('stroke', {})
+      .option('stroke-width', {})
+      .option('fill', {
+        describe: 'symbol fill color'
       })
       .option('polygons', {
         describe: 'generate symbols as polygons instead of SVG objects',
         type: 'flag'
       })
-      .option('radius', {
-        describe: 'distance from center to farthest point on the symbol',
-        type: 'distance'
-      })
-      .option('sides', {
-        describe: 'number of sides of a polygon symbol',
-        type: 'number'
-      })
-      .option('orientation', {
-        // TODO: removed (replaced by flipped and rotated)
-        // describe: 'use orientation=b for a rotated or flipped orientation'
+      .option('pixel-scale', {
+        describe: 'set symbol scale in meters-per-pixel (for polygons option)',
+        type: 'number',
       })
       // .option('flipped', {
       //   type: 'flag',
@@ -20150,11 +20165,23 @@ ${svg}
       // })
       .option('rotated', {
         type: 'flag',
-        describe: 'symbol is rotated to a different orientation'
+        describe: 'symbol is rotated to an alternate orientation'
       })
       .option('rotation', {
         describe: 'rotation of symbol in degrees'
       })
+      .option('scale', {
+        describe: 'scale symbols by a multiplier',
+        type: 'number'
+      })
+      .option('radius', {
+        describe: 'distance from center to farthest point on the symbol',
+        type: 'distance'
+      })
+      .option('sides', {
+        describe: '(polygon) number of sides of a (regular) polygon symbol',
+        type: 'number'
+      })
       .option('points', {
         describe: '(star) number of points'
       })
@@ -20172,7 +20199,7 @@ ${svg}
       })
       .option('direction', {
         old_alias: 'arrow-direction',
-        describe: '(arrow) angle off vertical (-90 = left-pointing)'
+        describe: '(arrow) angle off of vertical (-90 = left-pointing)'
       })
       .option('head-angle', {
         old_alias: 'arrow-head-angle',
@@ -20207,17 +20234,12 @@ ${svg}
       })
       .option('min-stem-ratio', {
         old_alias: 'arrow-min-stem',
-        describe: '(arrow) min ratio of stem to total length',
+        describe: '(arrow) minimum ratio of stem to total length',
         type: 'number'
       })
       .option('anchor', {
         describe: '(arrow) takes one of: start, middle, end (default is start)'
       })
-      .option('stroke', {})
-      .option('stroke-width', {})
-      .option('fill', {
-        describe: 'symbol fill color'
-      })
       .option('effect', {})
       // .option('where', whereOpt)
       .option('name', nameOpt)
@@ -20606,6 +20628,10 @@ ${svg}
       .option('target', targetOpt)
       .validate(validateExpressionOpt);
 
+    parser.command('print')
+      .describe('print a message to stdout')
+      .flag('multi_arg');
+
     parser.command('projections')
       .describe('print list of supported projections');
 
@@ -27158,7 +27184,7 @@ ${svg}
   }
 
   function samePoint(a, b) {
-    return a[0] === b[0] && a[1] === b[1];
+    return a && b && a[0] === b[0] && a[1] === b[1];
   }
 
   function isClosedPath(arr) {
@@ -27772,11 +27798,15 @@ ${svg}
   }
 
   function getCategoricalColorScheme(name, n) {
+    var colors;
     initSchemes();
-    if (index.categorical.includes(name) === false) {
-      stop(name, 'is not a categorical color scheme');
+    if (!isColorSchemeName(name)) {
+      stop('Unknown color scheme name:', name);
+    } else if (isCategoricalColorScheme(name)) {
+      colors = ramps[name] || require('d3-scale-chromatic')['scheme' + name];
+    } else {
+      colors = getColorRamp(name, n);
     }
-    var colors = ramps[name] || require('d3-scale-chromatic')['scheme' + name];
     if (n > colors.length) {
       stop(name, 'does not contain', n, 'colors');
     }
@@ -27789,6 +27819,11 @@ ${svg}
       index.diverging.includes(name) || index.rainbow.includes(name);
   }
 
+  function isCategoricalColorScheme(name) {
+    initSchemes();
+    return index.categorical.includes(name);
+  }
+
   function getColorRamp(name, n, stops) {
     initSchemes();
     var lib = require('d3-scale-chromatic');
@@ -28278,7 +28313,7 @@ ${svg}
     };
   }
 
-  function getSequentialClassifier$1(classValues, nullValue, dataValues, opts) {
+  function getSequentialClassifier$1(classValues, nullValue, dataValues, method, opts) {
     var numValues = classValues.length;
     var numBuckets = opts.continuous ? numValues - 1 : numValues;
 
@@ -28286,7 +28321,6 @@ ${svg}
     // discreetly classed values
     var numBreaks = numBuckets - 1;
     var round = opts.precision ? getRoundingFunction(opts.precision) : null;
-    var method = opts.method || 'quantile';
     var breaks, classifier, dataToClass, classToValue;
 
     if (round) {
@@ -28891,34 +28925,35 @@ ${svg}
     var opts = optsArg || {};
     var records = lyr.data && lyr.data.getRecords();
     var nullValue = opts.null_value || null;
-    var looksLikeColors = !!opts.colors || !!opts.color_scheme;
+    var valuesAreColors = !!opts.colors || !!opts.color_scheme;
     var colorScheme;
-    var classValues, classifyByValue, classifyById;
-    var numBuckets, numValues;
+    var values, classifyByValue, classifyById;
+    var numClasses, numValues;
     var dataField, outputField;
+    var method;
 
     // validate explicitly set classes
     if (opts.classes) {
       if (!utils.isInteger(opts.classes) || opts.classes > 1 === false) {
         stop('Invalid number of classes:', opts.classes, '(expected a value greater than 1)');
       }
-      numBuckets = opts.classes;
+      numClasses = opts.classes;
     }
 
     // TODO: better validation of breaks values
     if (opts.breaks) {
-      numBuckets = opts.breaks.length + 1;
+      numClasses = opts.breaks.length + 1;
     }
 
     if (opts.index_field) {
       dataField = opts.index_field;
-      if (numBuckets > 0 === false) {
+      if (numClasses > 0 === false) {
         stop('The index-field= option requires the classes= option to be set');
       }
       // You can't infer the number of classes by looking at index values;
       // this can cause unwanted interpolation if one or more values are
       // not present in the index field
-      // numBuckets = validateClassIndexField(records, opts.index_field);
+      // numClasses = validateClassIndexField(records, opts.index_field);
 
     } else if (opts.field) {
       dataField = opts.field;
@@ -28929,7 +28964,19 @@ ${svg}
       opts.categories = getUniqFieldValues(records, dataField);
     }
 
-    if (opts.method == 'non-adjacent') {
+    // get classification method
+    //
+    if (opts.method) {
+      method = opts.method;
+    } else if (opts.categories) {
+      method = 'categorical';
+    } else if (opts.index_field) {
+      method = 'indexed';
+    } else {
+      method = 'quantile'; // TODO: validate data field
+    }
+
+    if (method == 'non-adjacent') {
       if (lyr.geometry_type != 'polygon') {
         stop('The non-adjacent option requires a polygon layer');
       }
@@ -28942,8 +28989,8 @@ ${svg}
       requireDataField(lyr.data, dataField);
     }
 
-    if (numBuckets) {
-      numValues = opts.continuous ? numBuckets + 1 : numBuckets;
+    if (numClasses) {
+      numValues = opts.continuous ? numClasses + 1 : numClasses;
     }
 
     // support both deprecated color-scheme= option and colors=<color-scheme> syntax
@@ -28958,39 +29005,44 @@ ${svg}
       opts.colors.forEach(parseColor); // validate colors -- error if unparsable
     }
 
+    /// get values (usually colors)
+    ///
     if (colorScheme) {
-      // using a named color scheme: generate a ramp
+      if (method == 'non-adjacent') {
+        numClasses = numValues = numClasses || 5;
+        values = getCategoricalColorScheme(colorScheme, numValues);
+
+      } else if (method == 'categorical') {
+        values = getCategoricalColorScheme(colorScheme, opts.categories.length);
+        numClasses = numValues = values.length;
 
-      if (opts.categories) {
-        classValues = getCategoricalColorScheme(colorScheme, opts.categories.length);
-        numBuckets = numValues = classValues.length;
       } else {
-        if (!numBuckets) {
+        if (!numClasses) {
           // stop('color-scheme= option requires classes= or breaks=');
-          numBuckets = 4; // use a default number of classes
-          numValues = opts.continuous ? numBuckets + 1 : numBuckets;
+          numClasses = 4; // use a default number of classes
+          numValues = opts.continuous ? numClasses + 1 : numClasses;
         }
-        classValues = getColorRamp(colorScheme, numValues, opts.stops);
+        values = getColorRamp(colorScheme, numValues, opts.stops);
       }
 
     } else if (opts.colors || opts.values) {
-      classValues = opts.values ? parseValues(opts.values) : opts.colors;
+      values = opts.values ? parseValues(opts.values) : opts.colors;
       if (!numValues) {
-        numValues = classValues.length;
+        numValues = values.length;
       }
-      if ((classValues.length != numValues || opts.stops) && numValues > 1) {
+      if ((values.length != numValues || opts.stops) && numValues > 1) {
         // TODO: handle numValues == 1
         // TODO: check for non-interpolatable value types (e.g. boolean, text)
-        classValues = interpolateValuesToClasses(classValues, numValues, opts.stops);
+        values = interpolateValuesToClasses(values, numValues, opts.stops);
       }
 
     } else if (numValues > 1) {
       // no values were given: assign indexes for each class
-      classValues = getIndexValues(numValues);
+      values = getIndexValues(numValues);
       nullValue = -1;
     }
 
-    if (looksLikeColors) {
+    if (valuesAreColors) {
       nullValue = nullValue || '#eee';
     }
 
@@ -28999,24 +29051,24 @@ ${svg}
     }
 
     if (opts.invert) {
-      classValues = classValues.concat().reverse();
+      values = values.concat().reverse();
     }
 
-    if (looksLikeColors) {
-      message('Colors:', formatValuesForLogging(classValues));
+    if (valuesAreColors) {
+      message('Colors:', formatValuesForLogging(values));
     }
 
     // get a function to convert input data to class indexes
     //
-    if (opts.method == 'non-adjacent') {
-      classifyById = getNonAdjacentClassifier(lyr, dataset, classValues);
+    if (method == 'non-adjacent') {
+      classifyById = getNonAdjacentClassifier(lyr, dataset, values);
     } else if (opts.index_field) {
       // data is pre-classified... just read the index from a field
-      classifyByValue = getIndexedClassifier(classValues, nullValue, opts);
-    } else if (opts.categories) {
-      classifyByValue = getCategoricalClassifier(classValues, nullValue, opts);
+      classifyByValue = getIndexedClassifier(values, nullValue, opts);
+    } else if (method == 'categorical') {
+      classifyByValue = getCategoricalClassifier(values, nullValue, opts);
     } else {
-      classifyByValue = getSequentialClassifier$1(classValues, nullValue, getFieldValues(records, dataField), opts);
+      classifyByValue = getSequentialClassifier$1(values, nullValue, getFieldValues(records, dataField), method, opts);
     }
 
     if (classifyByValue) {
@@ -29029,7 +29081,7 @@ ${svg}
 
     // get the name of the output field
     //
-    if (looksLikeColors) {
+    if (valuesAreColors) {
       outputField = lyr.geometry_type == 'polyline' ? 'stroke' : 'fill';
     } else {
       outputField = 'class';
@@ -36641,6 +36693,10 @@ ${svg}
     };
   }
 
+  cmd.print = function(msgArg) {
+    print(msgArg || '');
+  };
+
   cmd.renameLayers = function(layers, names, catalog) {
     if (names && names.join('').indexOf('=') > -1) {
       renameByAssignment(names, catalog);
@@ -39148,7 +39204,7 @@ ${svg}
         }
         if (!(name == 'graticule' || name == 'i' || name == 'help' ||
             name == 'point-grid' || name == 'shape' || name == 'rectangle' ||
-            name == 'include')) {
+            name == 'include' || name == 'print')) {
           throw new UserError("No data is available");
         }
       }
@@ -39333,6 +39389,9 @@ ${svg}
       } else if (name == 'polygons') {
         outputLayers = cmd.polygons(targetLayers, targetDataset, opts);
 
+      } else if (name == 'print') {
+        cmd.print(command._.join(' '));
+
       } else if (name == 'proj') {
         initProjLibrary(opts, function() {
           var err = null;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mapshaper",
-	"version": "0.5.88",
+	"version": "0.5.92",
 	"description": "A tool for editing vector datasets for mapping and GIS.",
 	"keywords": [
 		"shapefile",
@@ -40,7 +40,7 @@
 		"!.DS_Store"
 	],
 	"dependencies": {
-		"commander": "^5.1.0",
+		"commander": "7.0.0",
 		"cookies": "^0.8.0",
 		"d3-color": "2.0.0",
 		"d3-scale-chromatic": "2.0.0",

package/www/index.html

@@ -201,7 +201,7 @@ a smoother appearance.</div></div></div></div>
 
 <div id="splash-screen" class="main-area">
 	<div>
-		<h3>Mapshaper is an editor for map data</h3>
+		<h3 id="splash-screen-blurb">Mapshaper is an editor for map data</h3>
 	</div>
 	<div id="drop-areas" class="drop-area-wrapper main-area">