@raruto/leaflet-elevation 1.9.4 → 2.0.0

package/src/utils.js

@@ -1,10 +1,23 @@
+/**
+ * TODO: exget computed styles of theese values from actual "CSS vars"
+ **/
+export const Colors = {
+	'lightblue': { area: '#3366CC', alpha: 0.45, stroke: '#3366CC' },
+	'magenta'  : { area: '#FF005E' },
+	'yellow'   : { area: '#FF0' },
+	'purple'   : { area: '#732C7B' },
+	'steelblue': { area: '#4682B4' },
+	'red'      : { area: '#F00' },
+	'lime'     : { area: '#9CC222', line: '#566B13' }
+};
+
 const SEC  = 1000;
 const MIN  = SEC * 60;
 const HOUR = MIN * 60;
 const DAY  = HOUR * 24;
 
 /**
- * Convert a duration time (millis) to a human readable string (%Dd %H:%M'%S")
+ * Convert a time (millis) to a human readable duration string (%Dd %H:%M'%S")
  */
 export function formatTime(t) {
 	let d = Math.floor(t / DAY);
@@ -17,6 +30,20 @@ export function formatTime(t) {
 	return (d ? d + "d " : '') + h.toString().padStart(2, 0) + ':' + m.toString().padStart(2, 0) + "'" + s.toString().padStart(2, 0) + '"';
 }
 
+/**
+ * Convert a time (millis) to human readable date string (dd-mm-yyyy hh:mm:ss)
+ */
+ export function formatDate(format) {
+	if (!format) {
+		return (time) => (new Date(time)).toLocaleString().replaceAll('/', '-').replaceAll(',', ' ');
+	} else if (format == 'time') {
+		return (time) => (new Date(time)).toLocaleTimeString();
+	} else if (format == 'date') {
+		return (time) => (new Date(time)).toLocaleDateString();
+	}
+	return (time) => format(time);
+}
+
 /**
  * Generate download data event.
  */
@@ -28,23 +55,6 @@ export function formatTime(t) {
 	b.removeChild(a);
 }
 
-/**
- * Async JS script download.
- */
-export function lazyLoader(url, skip, loader) {
-	if (skip === false) {
-		return Promise.resolve();
-	}
-	if (loader instanceof Promise) {
-		return loader;
-	}
-	return new Promise((resolve, reject) => {
-		let tag = document.createElement("script");
-		tag.addEventListener('load', resolve, { once: true });
-		tag.src = url;
-		document.head.appendChild(tag);
-	});
-}
 
 /**
  * Convert SVG Path into Path2D and then update canvas
@@ -75,113 +85,75 @@ export function lazyLoader(url, skip, loader) {
 }
 
 /**
- * Limit a number between min / max values
- */
- export function clamp(val, range) {
-	if (range) return val < range[0] ? range[0] : val > range[1] ? range[1] : val;
-	return val;
-}
-
-/**
- * A little bit safier than L.DomUtil.addClass
+ * Loop and extract GPX Extensions handled by "@tmcw/toGeoJSON" (eg. "coordinateProperties" > "times")
  */
-export function addClass(targetNode, className) {
-	if (targetNode) className.split(" ").every(s => s && L.DomUtil.addClass(targetNode, s));
-}
-
-/**
- * A little bit safier than L.DomUtil.removeClass()
- */
-export function removeClass(targetNode, className) {
-	if (targetNode) className.split(" ").every(s => s && L.DomUtil.removeClass(targetNode, s));
-}
-
-export function toggleClass(targetNode, className, conditional) {
-	return (conditional ? addClass : removeClass).call(null, targetNode, className)
-}
-
-export function replaceClass(targetNode, removeClassName, addClassName) {
-	if (removeClassName) removeClass(targetNode, removeClassName);
-	if (addClassName) addClass(targetNode, addClassName);
-}
-
-export function style(targetNode, name, value) {
-	if (typeof value === "undefined") return L.DomUtil.getStyle(targetNode, name);
-	else return targetNode.style.setProperty(name, value);
-}
-
-export function toggleStyle(targetNode, name, value, conditional) {
-	return style(targetNode, name, conditional ? value : '');
-}
-
-export function toggleEvent(leafletElement, eventName, handler, conditional) {
-	return leafletElement[conditional ? 'on' : 'off'](eventName, handler);
-}
-
-/**
- * A little bit shorter than L.DomUtil.create()
- */
-export function create(tagName, className, attributes, parent) {
-	let elem = L.DomUtil.create(tagName, className || "");
-	if (attributes) setAttributes(elem, attributes);
-	if (parent) append(parent, elem);
-	return elem;
+export function coordPropsToMeta(coordProps, name, parser) {
+	return coordProps && (({props, point, id}) => {
+		if (props) {
+			for (const key of coordProps) {
+				if (key in props) {
+					point.meta[name] = (parser || parseInt).call(this, props[key], id);
+					break;
+				}
+			}
+		}
+	});
 }
 
 /**
- * Same as node.appendChild()
+ * Extract numeric property (id) from GeoJSON object
  */
-export function append(parent, child) {
-	return parent.appendChild(child);
-}
+export const parseInt  = (property, id) => window.parseInt((typeof property === 'object' ? property[id] : property));
 
 /**
- * Same as node.insertAdjacentElement()
+ * Extract datetime property (id) from GeoJSON object
  */
-export function insert(parent, child, position) {
-	return parent.insertAdjacentElement(position, child);
-}
+export const parseDate = (property, id) => new Date(Date.parse((typeof property === 'object' ? property[id] : property)));
 
 /**
- * Loop for node.setAttribute()
+ * A little bit shorter than L.DomUtil
  */
-export function setAttributes(elem, attrs) {
-	for (let k in attrs) { elem.setAttribute(k, attrs[k]); }
-}
+export const addClass      = (n, str)             => n && str.split(" ").every(s => s && L.DomUtil.addClass(n, s));
+export const removeClass   = (n, str)             => n && str.split(" ").every(s => s && L.DomUtil.removeClass(n, s));
+export const toggleClass   = (n, str, cond)       => (cond ? addClass : removeClass)(n, str);
+export const replaceClass  = (n, rem, add)        => (rem && removeClass(n, rem)) || (add && addClass(n, add));
+export const style         = (n, k, v)            => (typeof v === "undefined" && L.DomUtil.getStyle(n, k)) || n.style.setProperty(k, v);
+export const toggleStyle   = (n, k, v, cond)      => style(n, k, cond ? v : '');
+export const setAttributes = (n, attrs)           => { for (let k in attrs) { n.setAttribute(k, attrs[k]); } };
+export const toggleEvent   = (el, e, fn, cond)    => el[cond ? 'on' : 'off'](e, fn);
+export const create        = (tag, str, attrs, n) => { let elem = L.DomUtil.create(tag, str || ""); if (attrs) setAttributes(elem, attrs); if (n) append(n, elem); return elem; };
+export const append        = (n, c)               => n.appendChild(c);
+export const insert        = (n, c, pos)          => n.insertAdjacentElement(pos, c);
+export const select        = (str, n)             => (n || document).querySelector(str);
+export const each          = (obj, fn)            => { for (let i in obj) fn(obj[i], i); };
+export const randomId      = ()                   => Math.random().toString(36).substr(2, 9);
 
 /**
- * Same as node.querySelector().
+ * TODO: use generators instead? (ie. "yield")
  */
-export function select(selector, context) {
-	return (context || document).querySelector(selector);
-}
+export const iMax = (iVal, max) => (iVal > max ? iVal : max) || -Infinity; 
+export const iMin = (iVal, min) => (iVal < min ? iVal : min) || +Infinity;
+export const iAvg = (iVal, avg) => (iVal + (avg || 0)) / 2.0;
+export const iSum = (iVal, sum) => iVal + (sum || 0);
 
 /**
- * Alias for L.DomEvent.on.
+ * Alias for some leaflet core functions
  */
-export const on = L.DomEvent.on;
+export const { on, off }  = L.DomEvent;
+export const { throttle } = L.Util;
+export const { hasClass } = L.DomUtil;
 
 /**
- * Alias for L.DomEvent.off.
+ * Limit floating point precision
  */
-export const off = L.DomEvent.off;
+export const round        = L.Util.formatNum;
 
 /**
- * Alias for L.DomUtil.hasClass.
- */
-export const hasClass = L.DomUtil.hasClass;
-
-
-/**
- * Generate a random string
+ * Limit a number between min / max values
  */
-export function randomId() {
-	return Math.random().toString(36).substr(2, 9);
-}
+export const clamp     = (val, range)           => range ? (val < range[0] ? range[0] : val > range[1] ? range[1] : val) : val;
 
 /**
- * Execute a function foreach element in object
+ * Limit a delta difference between two values
  */
-export function each(obj, fn) {
-	for (let i in obj) fn(obj[i], i);
-}
+export const wrapDelta = (curr, prev, deltaMax) => Math.abs(curr - prev) > deltaMax ? prev + deltaMax * Math.sign(curr - prev) : curr;

package/src/acceleration.js

@@ -1,108 +0,0 @@
-import 'leaflet-i18n';
-import * as _        from './utils';
-import * as D3       from './components';
-import { Elevation } from './control';
-
-Elevation.addInitHook(function() {
-
-	if (!this.options.acceleration) return;
-
-	let opts = this.options;
-	let acceleration = {};
-
-	acceleration.label      = opts.accelerationLabel  || L._(opts.imperial ? 'ft/s²' : 'm/s²');
-	opts.accelerationFactor = opts.accelerationFactor || 1;
-
-	if (this.options.acceleration != "summary") {
-
-		this._registerAxisScale({
-			axis       : "y",
-			position   : "right",
-			scale      : {
-				min        : 0,
-				max        : +1,
-			},
-			tickPadding: 16,
-			label      : acceleration.label,
-			labelX     : 25,
-			labelY     : -8,
-			name       : 'acceleration'
-		});
-
-		this._registerAreaPath({
-			name       : 'acceleration',
-			label      : 'Acceleration',
-			yAttr      : 'acceleration',
-			scaleX     : 'distance',
-			scaleY     : 'acceleration',
-			color      : '#050402',
-			strokeColor  : '#000',
-			strokeOpacity: "0.5",
-			fillOpacity  : "0.25",
-		});
-
-	}
-
-	this.on('elepoint_added', function(e) {
-		let data   = this._data;
-		let i      = e.index;
-
-		let currT  = data[i].time;
-		let prevT  = i > 0 ? data[i - 1].time : currT;
-
-		let deltaT = (currT - prevT) / 1000;
-
-		let track  = this.track_info;
-		let sMax   = track.acceleration_max || -Infinity; // Acceleration Max
-		let sMin   = track.acceleration_min || +Infinity; // Acceleration Min
-		let sAvg   = track.acceleration_avg || 0; // Acceleration Avg
-		let acceleration = 0;
-
-		if (deltaT > 0) {
-			let curr     = data[i].speed;
-			let prev     = i > 0 ? data[i - 1].speed : curr;
-			let delta    = (curr - prev) * (1000 / opts.timeFactor);
-			acceleration = Math.abs((delta / deltaT)) * opts.accelerationFactor;
-		}
-
-		// Try to smooth "crazy" acceleration values.
-		if (this.options.accelerationDeltaMax) {
-			let deltaA     = i > 0 ? acceleration - data[i - 1].acceleration : 0;
-			let maxDeltaS  = this.options.accelerationDeltaMax;
-			if (Math.abs(deltaA) > maxDeltaS) {
-				acceleration = data[i - 1].acceleration + maxDeltaS * Math.sign(deltaA);
-			}
-		}
-
-		// Range of acceptable acceleration values.
-		acceleration = _.clamp(acceleration, this.options.accelerationRange);
-
-		track.acceleration_max = acceleration > sMax ? acceleration : sMax;
-		track.acceleration_min = acceleration < sMin ? acceleration : sMin;
-		track.acceleration_avg = (acceleration + sAvg) / 2.0;
-
-		data[i].acceleration = L.Util.formatNum(acceleration, 2);
-	});
-
-	this._registerTooltip({
-		name  : 'acceleration',
-		chart: (item) => L._("a: ") + item.acceleration + " " + acceleration.label,
-		marker: (item) => Math.round(item.acceleration) + " " + acceleration.label,
-	});
-
-	this._registerSummary({
-		"minacceleration"  : {
-			label: "Min Acceleration: ",
-			value: (track) => Math.round(track.acceleration_min || 0) + '&nbsp;' + acceleration.label
-		},
-		"maxacceleration"  : {
-			label: "Max Acceleration: ",
-			value: (track) => Math.round(track.acceleration_max || 0) + '&nbsp;' + acceleration.label
-		},
-		"avgacceleration": {
-			label: "Avg Acceleration: ",
-			value: (track) => Math.round(track.acceleration_avg || 0) + '&nbsp;' + acceleration.label
-		}
-	});
-
-});

package/src/altitude.js

@@ -1,120 +0,0 @@
-import 'leaflet-i18n';
-import * as _        from './utils';
-import * as D3       from './components';
-import { Elevation } from './control';
-
-Elevation.addInitHook(function() {
-
-	let opts     = this.options;
-	let altitude = {};
-
-	if (opts.imperial) {
-		opts.altitudeFactor = this.__footFactor;
-		altitude.label      = "ft";
-	} else {
-		opts.altitudeFactor = opts.heightFactor || opts.altitudeFactor || 1;
-		altitude.label      = opts.yLabel;
-	}
-
-	this.on("eledata_updated", function(e) {
-		let data   = this._data;
-		let i      = e.index;
-		let z      = data[i].z * opts.altitudeFactor;
-
-		let track  = this.track_info;
-		let zMax = track.elevation_max || -Infinity;
-		let zMin = track.elevation_min || +Infinity;
-
-		// check and fix missing elevation data on last added point
-		if (!this.options.skipNullZCoords && i > 0) {
-			let prevZ = data[i - 1].z;
-			if (isNaN(prevZ)) {
-				let lastZ = this._lastValidZ;
-				let currZ = z;
-				if (!isNaN(lastZ) && !isNaN(currZ)) {
-					prevZ   = (lastZ + currZ) / 2;
-				} else if (!isNaN(lastZ)) {
-					prevZ   = lastZ;
-				} else if (!isNaN(currZ)) {
-					prevZ   = currZ;
-				}
-				if (!isNaN(prevZ)) return data.splice(i - 1, 1);
-				data[i - 1].z = prevZ;
-			}
-		}
-		// skip point if it has not elevation
-		if (!isNaN(z)) {
-			this._lastValidZ = z;
-		}
-
-		track.elevation_max = z > zMax ? z : zMax;
-		track.elevation_min = z < zMin ? z : zMin;
-
-		data[i].z = z;
-	});
-
-	this.on("elechart_axis", function() {
-
-		this._chart._registerAxisGrid({
-			axis      : "y",
-			position  : "left",
-			scale     : this._chart._y,
-		});
-
-	});
-
-	if (this.options.altitude != "summary") {
-
-		this.on("elechart_axis", function() {
-
-			this._chart._registerAxisScale({
-				axis    : "y",
-				position: "left",
-				scale   : this._chart._y,
-				label   : altitude.label,
-				labelX  : -3,
-				labelY  : -8,
-				name    : "altitude",
-			});
-
-		});
-
-		this.on("elechart_init", function() {
-
-			let theme      = this.options.theme.replace('-theme', '');
-			let color      = D3.Colors[theme] || {};
-
-			this._chart._registerAreaPath({
-				name         : 'altitude',
-				label        : 'Altitude',
-				scaleX       : 'distance',
-				scaleY       : 'altitude',
-				color        : color.area || theme,
-				strokeColor  : this.options.detached ? color.stroke : '#000',
-				strokeOpacity: "1",
-				fillOpacity  : this.options.detached ? (color.alpha || '0.8') : 1,
-				preferCanvas : this.options.preferCanvas,
-			});
-
-		});
-
-	}
-
-	this._registerTooltip({
-		name: 'y',
-		chart: (item) => L._("y: ") + d3.format("." + opts.decimalsY + "f")(item[opts.yAttr]) + " " + altitude.label,
-		marker: (item) => d3.format("." + opts.decimalsY + "f")(item[opts.yAttr]) + " " + altitude.label,
-	});
-
-	this._registerSummary({
-		"maxele"  : {
-			label: "Max Elevation: ",
-			value: (track) => (track.elevation_max || 0).toFixed(2) + '&nbsp;' + altitude.label
-		},
-		"minele"  : {
-			label: "Min Elevation: ",
-			value: (track) => (track.elevation_min || 0).toFixed(2) + '&nbsp;' + altitude.label
-		},
-	});
-
-});

package/src/distance.js

@@ -1,78 +0,0 @@
-import 'leaflet-i18n';
-import * as _        from './utils';
-import * as D3       from './components';
-import { Elevation } from './control';
-
-Elevation.addInitHook(function() {
-
-	let opts     = this.options;
-	let distance = {};
-
-	if (opts.imperial) {
-		opts.distanceFactor = this.__mileFactor;
-		distance.label      = "mi";
-	} else {
-		opts.distanceFactor = opts.distanceFactor || 1;
-		distance.label      = opts.xLabel;
-	}
-
-	this.on("eledata_updated", function(e) {
-		let data = this._data;
-		let i    = e.index;
-
-		let track = this.track_info;
-		let dist  = track.distance || 0;
-
-		let curr = data[i].latlng;
-		let prev = i > 0 ? data[i - 1].latlng : curr;
-
-		let delta = curr.distanceTo(prev) * opts.distanceFactor;
-
-		dist += Math.round(delta / 1000 * 100000) / 100000; // handles floating points calc
-
-		track.distance = dist;
-
-		data[i].dist = dist;
-	});
-
-	this.on("elechart_axis", function() {
-
-		this._chart._registerAxisGrid({
-			axis      : "x",
-			position  : "bottom",
-			scale     : this._chart._x,
-		});
-
-	});
-
-	if (this.options.distance != "summary") {
-
-		this.on("elechart_axis", function() {
-
-			this._chart._registerAxisScale({
-				axis    : "x",
-				position: "bottom",
-				scale   : this._chart._x,
-				label   : distance.label,
-				labelY  : 25,
-				labelX  : () => this._width() + 6,
-				name    : "distance",
-			});
-
-		});
-
-	}
-
-	this._registerTooltip({
-		name: 'x',
-		chart: (item) => L._("x: ") + d3.format("." + opts.decimalsX + "f")(item[opts.xAttr]) + " " + distance.label,
-	});
-
-	this._registerSummary({
-		"totlen"  : {
-			label: "Total Length: ",
-			value: (track) => (track.distance || 0).toFixed(2) + ' ' + distance.label
-		}
-	});
-
-});

package/src/slope.js

@@ -1,113 +0,0 @@
-import 'leaflet-i18n';
-import * as _        from './utils';
-import * as D3       from './components';
-import { Elevation } from './control';
-
-Elevation.addInitHook(function() {
-
-	if (!this.options.slope) return;
-
-	let opts  = this.options;
-	let slope = {};
-
-	slope.label          = opts.slopeLabel || '%';
-
-	if (this.options.slope != "summary") {
-
-		this._registerAxisScale({
-			axis       : "y",
-			position   : "right",
-			scale      : {
-				min        : -1,
-				max        : +1,
-			},
-			tickPadding: 16,
-			label      : slope.label,
-			labelX     : 25,
-			labelY     : -8,
-			name       : 'slope'
-		});
-
-		this._registerAreaPath({
-			name         : 'slope',
-			label        : 'Slope',
-			yAttr        : 'slope',
-			scaleX       : 'distance',
-			scaleY       : 'slope',
-			color        : '#F00',
-			strokeColor  : '#000',
-			strokeOpacity: "0.5",
-			fillOpacity  : "0.25",
-		});
-
-	}
-
-	this.on("eledata_updated", function(e) {
-		let data  = this._data;
-		let i     = e.index;
-		let z     = data[i].z;
-		let delta = (data[i].dist - data[i > 0 ? i - 1 : i].dist) * 1000;
-
-		// Slope / Gain
-		let track = this.track_info;
-		let tAsc  = track.ascent    || 0; // Total Ascent
-		let tDes  = track.descent   || 0; // Total Descent
-		let sMax  = track.slope_max || 0; // Slope Max
-		let sMin  = track.slope_min || 0; // Slope Min
-		let slope = 0;
-
-		if (!isNaN(z)) {
-			let deltaZ  = i > 0 ? z - data[i - 1].z : 0;
-			if (deltaZ > 0)      tAsc += deltaZ;
-			else if (deltaZ < 0) tDes -= deltaZ;
-			// slope in % = ( height / length ) * 100
-			if (delta !== 0)     slope = (deltaZ / delta) * 100;
-		}
-
-		// Try to smooth "crazy" slope values.
-		if (this.options.sDeltaMax) {
-			let deltaS    = i > 0 ? slope - data[i - 1].slope : 0;
-			let maxDeltaS = this.options.sDeltaMax;
-			if (Math.abs(deltaS) > maxDeltaS) {
-				slope       = data[i - 1].slope + maxDeltaS * Math.sign(deltaS);
-			}
-		}
-
-		// Range of acceptable slope values.
-		slope = _.clamp(slope, this.options.sRange);
-
-		track.ascent    = tAsc;
-		track.descent   = tDes;
-		track.slope_max = slope > sMax ? slope : sMax;
-		track.slope_min = slope < sMin ? slope : sMin;
-
-		data[i].slope   = L.Util.formatNum(slope, 2);
-	});
-
-	this._registerTooltip({
-		name: 'slope',
-		chart: (item) => L._("m: ") + item.slope + slope.label,
-		marker: (item) => Math.round(item.slope) + slope.label
-	});
-
-	this._registerSummary({
-		"ascent"  : {
-			label: "Total Ascent: ",
-			value: (track) => Math.round(track.ascent || 0) + '&nbsp;' + (this.options.imperial ? 'ft' : 'm')
-		},
-		"descent"  : {
-			label: "Total Descent: ",
-			value: (track) => Math.round(track.descent || 0) + '&nbsp;' + (this.options.imperial ? 'ft' : 'm')
-		},
-		"minslope": {
-			label: "Min Slope: ",
-			value: (track) => Math.round(track.slope_min || 0) + '&nbsp;' + slope.label
-		},
-		"maxslope": {
-			label: "Max Slope: ",
-			value: (track) => Math.round(track.slope_max || 0) + '&nbsp;' + slope.label
-		}
-	});
-
-
-});