25:["$","title",null,{"children":"Numeric utilities | mheard03 | Observable"}] 4b:T8cb,// getFormatter returns a d3.format // getFormatter(-2, '$+')(12345) => "+12,000" // numeric parameter will be interpreted as precision; precision greater than 0 for decimal precision, less than zero for significant digits // text parameters will be scanned for '$%' (symbol) and '+-(' (sign) // text parameter 'html' will wrap the result in a colored span getFormatter = { let nanSymbol = "–"; function applyColor(value, formatter) { let span = html`${formatter(value)}`; if (value == nanSymbol) { span.innerText = nanSymbol; span.style.color = 'rgb(170, 170, 170)'; } else if (value == 0) { span.style.color = 'rgb(170, 170, 170)'; } else if (value < 0) { span.style.color = 'rgb(153, 0, 0)'; } return span; } function getFormatter(params) { params = [...arguments]; let formatString = getFormatString(...params); let options = d3.formatSpecifier(formatString); // baseFormatter: raw d3 formatter let baseFormatter = d3.format(options); // currencyFixer: wrapper function to avoid edge case (e.g. $1.4 when rounding to significant figures) let currencyFixer; if (options.type == 's' && options.precision > 0 && options.symbol == "$") { let smallValueSize = Math.pow(10, options.precision - 1); let nonPrecisionParams = params.filter(p => getType(p) != 'number'); let smallValueFormatString = getFormatString(nonPrecisionParams); let smallValueFormatter = d3.format(smallValueFormatString); currencyFixer = function(value) { if (Math.abs(value) < smallValueSize) return smallValueFormatter(value); return baseFormatter(value); }; } // fnFormat: the (number => string) format function we want to call let fnFormat = currencyFixer || baseFormatter; // nanFixer: replace trash values like NaN, Infinity with –, regardless of formatter let nanFixer = (value) => (isFinite(value)) ? fnFormat(value) : '–'; // colorizer: return formatted value wrapped in a let colorizer; if (params.find(p => p == 'html')) { colorizer = (value) => applyColor(value, nanFixer); } return colorizer || nanFixer; } return getFormatter; }4c:T846,// getFormatString returns a d3.format-ready format string // getFormatString(-2, '$+') => " >+$,.2r" // d3.format(" >+$,.2r") => "+$12,000" // numeric parameter will be interpreted as precision; precision greater than 0 for decimal precision, less than zero for significant digits // text parameters will be scanned for '$%' (symbol) and '+-(' (sign) // text parameter 'html' will wrap the result in a colored span getFormatString = { let nanSymbol = "–"; let percentTypeMappings = { 'f': '%', 'r': 'p' }; function findAny(text, characters) { if (!text || !characters) return; if (typeof(characters) == 'string') characters = characters.split(""); return characters.find(c => text.indexOf(c) >= 0); } function getFormatString(params) { params = [...arguments]; // console.log('params', params); let formatOptions = new d3.FormatSpecifier({ "sign": "(", "comma": true, "precision": 0, "trim": true, "type": "f" }); // precision let precision = params.find(p => getType(p) == 'number'); // console.log('precision', precision); if (precision) { if (precision > 0) { formatOptions.precision = precision; formatOptions.trim = false; } else if (precision < 0) { formatOptions.precision = Math.abs(precision); formatOptions.type = "r"; } } let symbolsParam = params.find(p => getType(p) == 'string' && findAny(p, "$%+-(")); let symbol = "", sign = ""; // console.log('symbolsParam', symbolsParam); if (symbolsParam) { // symbol symbol = findAny(symbolsParam, "$%"); // console.log('symbol', symbol); if (symbol == "$") { formatOptions.symbol = "$"; formatOptions.trim = false; } else if (symbol == '%') { formatOptions.type = percentTypeMappings[formatOptions.type]; } // sign sign = findAny(symbolsParam, "+-("); // console.log('sign', sign); if (sign) formatOptions.sign = sign; } return formatOptions.toString(); } return getFormatString; }4d:T41b,formatDemo = { let posValue = 12345.6789; let negValue = -12345.6789; let paramSets = [ [posValue, "$"], [posValue, "$", 2], [posValue, "$", -3], [posValue, "$", "html"], [negValue, "$(", "html"], [negValue, "(", "html"], [negValue, "-", "html"], [negValue, "%"], [negValue, "%-", -2, "html"], [negValue, "html", -2, "%-"] ]; let table = html``; let tbody = table.querySelector("tbody"); for (var params of paramSets) { let input = `format(${params.map(p => JSON.stringify(p)).join(", ")})`; let output = format(...params); let cellValues = [ html`

${input}` ];
    if (params.indexOf("html") < 0) {
      cellValues.push(html`${JSON.stringify(output)}`);
    }
    else {
      cellValues.push(output);
    }
    
    let tr = html`

`;
    cellValues.forEach(c => tr.append(html`

Sample inputs and outputs
${c}`)); tbody.append(tr); } return table; }4e:T60c,class A { /* Convenience / static unique(array) { return [...new Set(array)]; } static last(array) { return array[array.length - 1]; } / Math / static add(arrays) { arrays = (arguments.length == 1) ? arrays : [...arguments]; arrays = arrays.filter(a => a); if (arrays.length == 0) return; let lengths = A.unique(arrays.map(a => a.length)); if (lengths.length != 1) { throw "Can't add/subtract arrays of differing length." } let result = new Array(lengths[0]); for (let i = 0; i < result.length; i++) { result[i] = arrays.reduce((sum, a) => sum + a[i], 0) } return result; } static multiply(array, scalar) { return array.map(i => i scalar); } static subtract(arrays) { arrays = (arguments.length == 1) ? arrays : [...arguments]; arrays = arrays.filter(a => a); if (arrays.length == 0) return; let first = arrays[0]; let rest = arrays.slice(1); rest = rest.map(a => A.multiply(a, -1)); return A.add(first, ...rest); } static divide(array, scalar) { return A.multiply(array, 1/scalar); } /* Length extension / static extend(array, newLength, fillValue = NaN) { let fnGetFillValue = (type.of(fillValue) == "function") ? fillValue : (() => fillValue); let result = array.slice(); while (result.length < newLength) { result.push(fnGetFillValue()); } return result; } static extendLast(array, newLength) { return A.extend(array, newLength, A.last(array)); } }4f:T48b,function extendArrayPrototype() { Array.prototype.add = function(other) { if (this.length != other.length) { throw "Can't add/subtract arrays of differing length." } let result = new Array(this.length); for (let i = 0; i < this.length; i++) { result[i] = this[i] + other[i]; } return result; }; Array.prototype.multiply = function(scalar) { return this.map(i => i scalar); }; Array.prototype.subtract = function(other) { return this.add(other.multiply(-1)); }; Array.prototype.divide = function(scalar) { return this.multiply(1/scalar); }; Array.prototype.extend = function(newLength, fillValue) { if (arguments.length < 2) fillValue = NaN; let result = this.slice(); while (result.length < newLength) { result.push(fillValue); } return result; }; Array.prototype.extendLast = function(newLength) { return this.extend(newLength, this[this.length - 1]); }; Array.prototype.last = function() { return this[this.length - 1]; }; return md`${'`Array.prototype.last`, `add`, `.subtract`, `.multiply`, `.divide`, `.extend`, and `.extendLast` defined.'}`; }50:T698,class Nice { static round(value) { let { sig, pow } = _getScientific(value); if (!isFinite(sig)) return NaN; if (sig == 0) return 0; let niceOptions = [-10, -5, -2, -1, 0, 1, 2, 5, 10]; let deltas = niceOptions.map(b => Math.abs(b - sig)); let minDelta = Math.min(...deltas); let roundSig = niceOptions[deltas.indexOf(minDelta)]; return roundSig * Math.pow(10, pow); } static roundToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) \|\| increment == 0) return valueOrValues; let halfIncrement = increment / 2; let values = _arrayIfSingleton(valueOrValues); let result = []; for (let value of values) { let sign = Math.sign(value); value = Math.abs(value); let delta = value % increment; value -= delta; if (delta >= halfIncrement) value += increment; result.push(sign * value); } return (result.length <= 1) ? result[0] : result; } static floorToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) \|\| increment == 0) return valueOrValues; let values = _arrayIfSingleton(valueOrValues); let result = values.map(v => increment * Math.floor(v / increment)); return (result.length <= 1) ? result[0] : result; } static ceilToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) \|\| increment == 0) return valueOrValues; let values = _arrayIfSingleton(valueOrValues); let result = values.map(v => increment * Math.ceil(v / increment)); return (result.length <= 1) ? result[0] : result; } }51:[] 47:{"id":"ff3ada1f8063b684","slug":"numeric-utilities","title":"Numeric utilities","thumbnail":"8e1dda0290ecfc173a3a475206535d75ea15dfbc37d7daed7e4b82fb8e4c444c","access_level":"public","create_time":"$D2021-09-18T13:20:27.408Z","update_time":"$D2021-12-05T15:50:15.061Z","view_time":null,"first_public_time":"$D2021-09-18T13:22:23.793Z","has_unpublished_edits":null,"fork":false,"stars":1,"starred":false,"owner":{"type":"team","id":"02d4ccf8951f2f02","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":"starter_2024","bio":"","following":false},"version":1371,"publish_version":1371,"role":null,"authored":false,"authors":[{"type":"individual","id":"6afb6cac5f188ec0","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":null,"bio":"","following":false}],"members":[{"type":"individual","id":"6afb6cac5f188ec0","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Numeric utilities","cells":[{"id":0,"value":"# Numeric utilities","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":577,"value":"To use,\n\n```js\nimport { hasValue, coalesce, clamp, isZero, coerceZero, coerceZeroes, type, format, A, Nice } from \"@mheard03/numeric-utilities\"\n```\n\n~~Optionally, enable array arithmetic by calling `extendArrayPrototype()`~~","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":8,"value":"## Value coercion","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1046,"value":"epsilon = Math.pow(10, -6)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1044,"value":"isZero = function(value) {\n if (!hasValue(value)) return false;\n if (type.of(value) != \"number\") return false;\n return Math.abs(value) < epsilon;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1055,"value":"coerceZero = function(value) {\n if (type.of(value) == \"number\" && isZero(value)) return 0;\n return value;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1099,"value":"function coerceZeroes(array) {\n if (!array \|\| type.of(array) != \"array\") return;\n for (let i = 0; i < array.length; i++) {\n array[i] = coerceZero(array[i]);\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":4,"value":"hasValue = function(variable) {\n if (variable === null) return false;\n // if (Number.isNaN(variable)) return false;\n if (typeof(variable) == 'undefined') return false;\n if (typeof(variable) == 'number') return Number.isFinite(variable);\n if (typeof(variable) == 'string' && variable == '') return false;\n return true;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":10,"value":"coalesce = function() {\n var args = [...arguments].filter(a => hasValue(a));\n return args[0];\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"function clamp(value, min, max) {\n if (type.of(min) == \"array\") {\n let domain = min;\n min = Math.min(...domain);\n max = Math.max(...domain);\n }\n let result = value;\n result = Math.max(result, coalesce(min, Number.MIN_VALUE));\n result = Math.min(result, coalesce(max, Number.MAX_VALUE));\n return result;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"## Type detection","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":41,"value":"Supports the default JavaScript types — `undefined, object, boolean, number, bigint, string, function` — and adds two more:\n * both `type.of()` and `type.getSingle()` return `\"array\"` for arrays rather than the built-in `object` type\n * `type.getSingle()` returns `\"conflicted\"` when it's unable to achieve consensus\n\n`type.defaultValue()` returns the zero-ish value associated with each type (`[]` for arrays and `{}` for objects). Useful when combined with `coalesce()`.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":593,"value":"// For convenient import\ntype = {\n return {\n of: getType,\n getSingle: getSingleType,\n defaultValue: getDefaultValue\n };\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":30,"value":"// Returns the built-in type of value, or 'array' for arrays\ngetType = function(value) {\n return Array.isArray(value) ? 'array' : typeof(value);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":31,"value":"// Returns a built-in type if all values are of the same type, or 'conflicted' otherwise.\n// Returns undefined if [values] is empty\n// Ignores empty and default values if necessary to achieve consensus.\nfunction getSingleType(values) {\n\n function _getSingleType() {\n let types = values.map(v => getType(v));\n let uniqueTypes = [...new Set(types)];\n let type = (uniqueTypes.length <= 1) ? uniqueTypes[0] : 'conflicted';\n return type;\n }\n\n // Round 1: all values\n let singleType = _getSingleType();\n\n // Round 2: all non-empty values\n if (singleType == \"conflicted\") {\n values = values.filter(v => hasValue(v));\n singleType = _getSingleType();\n }\n\n // Round 3: all non-default values\n if (singleType == \"conflicted\") {\n values = values.filter(v => hasValue(v) && v != getDefaultValue(getType(v)));\n let round3Type = _getSingleType(values);\n if (round3Type != 'undefined') singleType = round3Type;\n }\n\n return singleType;\n}\n","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":34,"value":"// Returns the zero-ish value associated with each type (or [] for arrays and {} for objects)\nfunction getDefaultValue(type) {\n if (!type \|\| type == \"undefined\" \|\| type == \"conflicted\") return;\n if (type == \"array\") return [];\n if (type == \"bigint\") return BigInt(0);\n // For all other built-in types, static function returns default value (e.g. Number(), Object())\n let typeClass = type.replace(type[0], type[0].toUpperCase());\n return eval(`${typeClass}()`);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1066,"value":"function isValueType(type) {\n if (!type \|\| type == \"undefined\" \|\| type == \"conflicted\") return false;\n if (type == \"array\" \|\| type == \"object\" \|\| type == \"symbol\" \|\| type == \"function\") return false;\n return true;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":55,"value":"## Value formatting","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":380,"value":"`getFormatter()` returns a d3.format-based formatter using a simpler syntax.\n\n`format()` is a convenience wrapper around `getFormatter()`; it's not _slow_, exactly, but maybe avoid using it in a loop?","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":81,"value":"$4b","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":341,"value":"$4c","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":386,"value":"$4d","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":224,"value":"// convenience method that calls getFormatter and runs it on value\nformat = {\n \n function format(value, params) {\n params = [...arguments].slice(1);\n let formatter = getFormatter(...params);\n return formatter(value);\n }\n\n format.getFormatter = getFormatter;\n format.getFormatString = getFormatString;\n\n format.currencyString = getFormatString(\"$\");\n format.percentString = getFormatString('%');\n format.percent = getFormatter('%', 'red');\n format.currency = getFormatter(\"$\", 'red');\n \n return format;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":457,"value":"Pre-baked formats","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":334,"value":"currencyFormat = format.getFormatString(\"$\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":336,"value":"formatCurrency = getFormatter(\"$\", 'red')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":368,"value":"percentFormat = getFormatString('%')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":338,"value":"formatPercent = getFormatter('%', 'red')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":506,"value":"## Array math","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1018,"value":"The `A` class contains static convenience methods for combining and manipulating arrays.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":976,"value":"$4e","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":544,"value":"~~`extendArrayPrototype()` defines `Array.prototype.add`, `.subtract`, `.multiply`, and `.divide`, as well as `.extend` and `.extendLast`. Other notebooks must call this function after importing!~~","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":511,"value":"$4f","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":830,"value":"### Examples","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":665,"value":"extendArrayPrototype();","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":850,"value":"#### Array.prototype.add(other), subtract(other)\n`other` is a second array, which must be of the same length. Returns a new array such that `result[i] = this[i] + other[i]` (or `this[i] - other[i]` in the case of `.subtract`).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":867,"value":"[1,2,3].add([1,1,1])","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":873,"value":"#### Array.prototype.multiply(scalar), divide(scalar)\n`scalar` is a number. Returns a new array such that `result[i] = this[i] * scalar` (or `this[i] / scalar`).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":880,"value":"[1,2,3].multiply(2)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":887,"value":"#### Array.prototype.extend(newLength, fillValue)\nreturns a copy of the original array, lengthened to `newLength` if necessary. Any new slots created will be populated with `fillValue`, or `NaN` if no `fillValue` is specified.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":907,"value":"[1,2,3].extend(10, 7)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":905,"value":"[1,2,3].extend(10)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":912,"value":"#### Array.prototype.extendLast(newLength)\nis a convenience method that calls `.extend()` using the value of `this[this.length-1]` as `fillValue`.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":916,"value":"[1,2,\"potato\"].extendLast(10)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1101,"value":"## Nice rounding","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1105,"value":"$50","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1263,"value":"{\n // let start = -1999, stop = 1999, count = 5;\n let start = -2001, stop = 2001, count = 5;\n return {\n ticks: d3.ticks(start, stop, count),\n tickIncrement: d3.tickIncrement(start, stop, count)\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1107,"value":"function _getScientific(valueOrValues, exponent) {\n let values = _arrayIfSingleton(valueOrValues);\n let result = values.map(v => {\n let pow = exponent \|\| _getExponent(v);\n let sig = _getSignificand(v, pow);\n if (!isFinite(pow) \|\| !isFinite(sig)) pow = sig = NaN;\n return { sig, pow };\n });\n\n return (result.length <= 1) ? result[0] : result;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1148,"value":"function _getExponent(valueOrValues) {\n let values = _arrayIfSingleton(valueOrValues);\n if (!values \|\| values.length == 0) return undefined;\n \n let largestValue = Math.max(...values.map(v => Math.abs(v)).filter(v => Number.isFinite(v)));\n if (largestValue.length == 0) return NaN;\n return (largestValue == 0) ? 0 : Math.floor(Math.log10(largestValue));\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1161,"value":"function _getSignificand(valueOrValues, exponent) {\n let values = _arrayIfSingleton(valueOrValues);\n exponent = hasValue(exponent) ? exponent : _getExponent(values);\n\n let result = values.map(n => isFinite(n) ? n / Math.pow(10, exponent) : NaN);\n return (result.length <= 1) ? result[0] : result;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1156,"value":"function _arrayIfSingleton(valueOrValues) {\n return (type.of(valueOrValues) == \"array\") ? valueOrValues : [valueOrValues];\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1172,"value":"_arrayIfSingleton(5)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W51","stdlib":"1"}} 24:null

Sample inputs and outputs

${c}`)); tbody.append(tr); } return table; }4e:T60c,class A { /* Convenience */ static unique(array) { return [...new Set(array)]; } static last(array) { return array[array.length - 1]; } /* Math */ static add(arrays) { arrays = (arguments.length == 1) ? arrays : [...arguments]; arrays = arrays.filter(a => a); if (arrays.length == 0) return; let lengths = A.unique(arrays.map(a => a.length)); if (lengths.length != 1) { throw "Can't add/subtract arrays of differing length." } let result = new Array(lengths[0]); for (let i = 0; i < result.length; i++) { result[i] = arrays.reduce((sum, a) => sum + a[i], 0) } return result; } static multiply(array, scalar) { return array.map(i => i * scalar); } static subtract(arrays) { arrays = (arguments.length == 1) ? arrays : [...arguments]; arrays = arrays.filter(a => a); if (arrays.length == 0) return; let first = arrays[0]; let rest = arrays.slice(1); rest = rest.map(a => A.multiply(a, -1)); return A.add(first, ...rest); } static divide(array, scalar) { return A.multiply(array, 1/scalar); } /* Length extension */ static extend(array, newLength, fillValue = NaN) { let fnGetFillValue = (type.of(fillValue) == "function") ? fillValue : (() => fillValue); let result = array.slice(); while (result.length < newLength) { result.push(fnGetFillValue()); } return result; } static extendLast(array, newLength) { return A.extend(array, newLength, A.last(array)); } }4f:T48b,function extendArrayPrototype() { Array.prototype.add = function(other) { if (this.length != other.length) { throw "Can't add/subtract arrays of differing length." } let result = new Array(this.length); for (let i = 0; i < this.length; i++) { result[i] = this[i] + other[i]; } return result; }; Array.prototype.multiply = function(scalar) { return this.map(i => i * scalar); }; Array.prototype.subtract = function(other) { return this.add(other.multiply(-1)); }; Array.prototype.divide = function(scalar) { return this.multiply(1/scalar); }; Array.prototype.extend = function(newLength, fillValue) { if (arguments.length < 2) fillValue = NaN; let result = this.slice(); while (result.length < newLength) { result.push(fillValue); } return result; }; Array.prototype.extendLast = function(newLength) { return this.extend(newLength, this[this.length - 1]); }; Array.prototype.last = function() { return this[this.length - 1]; }; return md`${'`Array.prototype.last`, `add`, `.subtract`, `.multiply`, `.divide`, `.extend`, and `.extendLast` defined.'}`; }50:T698,class Nice { static round(value) { let { sig, pow } = _getScientific(value); if (!isFinite(sig)) return NaN; if (sig == 0) return 0; let niceOptions = [-10, -5, -2, -1, 0, 1, 2, 5, 10]; let deltas = niceOptions.map(b => Math.abs(b - sig)); let minDelta = Math.min(...deltas); let roundSig = niceOptions[deltas.indexOf(minDelta)]; return roundSig * Math.pow(10, pow); } static roundToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) || increment == 0) return valueOrValues; let halfIncrement = increment / 2; let values = _arrayIfSingleton(valueOrValues); let result = []; for (let value of values) { let sign = Math.sign(value); value = Math.abs(value); let delta = value % increment; value -= delta; if (delta >= halfIncrement) value += increment; result.push(sign * value); } return (result.length <= 1) ? result[0] : result; } static floorToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) || increment == 0) return valueOrValues; let values = _arrayIfSingleton(valueOrValues); let result = values.map(v => increment * Math.floor(v / increment)); return (result.length <= 1) ? result[0] : result; } static ceilToIncrement(valueOrValues, increment) { increment = Math.abs(increment); if (!isFinite(increment) || increment == 0) return valueOrValues; let values = _arrayIfSingleton(valueOrValues); let result = values.map(v => increment * Math.ceil(v / increment)); return (result.length <= 1) ? result[0] : result; } }51:[] 47:{"id":"ff3ada1f8063b684","slug":"numeric-utilities","title":"Numeric utilities","thumbnail":"8e1dda0290ecfc173a3a475206535d75ea15dfbc37d7daed7e4b82fb8e4c444c","access_level":"public","create_time":"$D2021-09-18T13:20:27.408Z","update_time":"$D2021-12-05T15:50:15.061Z","view_time":null,"first_public_time":"$D2021-09-18T13:22:23.793Z","has_unpublished_edits":null,"fork":false,"stars":1,"starred":false,"owner":{"type":"team","id":"02d4ccf8951f2f02","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":"starter_2024","bio":"","following":false},"version":1371,"publish_version":1371,"role":null,"authored":false,"authors":[{"type":"individual","id":"6afb6cac5f188ec0","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":null,"bio":"","following":false}],"members":[{"type":"individual","id":"6afb6cac5f188ec0","login":"mheard03","name":"","avatar_url":"https://avatars-next.observableusercontent.com/ae42ada5dc924d7cd620a4ae3bb6279a3e82fb649668ee6c0729bdada1ebf016","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Numeric utilities","cells":[{"id":0,"value":"# Numeric utilities","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":577,"value":"To use,\n\n```js\nimport { hasValue, coalesce, clamp, isZero, coerceZero, coerceZeroes, type, format, A, Nice } from \"@mheard03/numeric-utilities\"\n```\n\n~~Optionally, enable array arithmetic by calling `extendArrayPrototype()`~~","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":8,"value":"## Value coercion","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1046,"value":"epsilon = Math.pow(10, -6)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1044,"value":"isZero = function(value) {\n if (!hasValue(value)) return false;\n if (type.of(value) != \"number\") return false;\n return Math.abs(value) < epsilon;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1055,"value":"coerceZero = function(value) {\n if (type.of(value) == \"number\" && isZero(value)) return 0;\n return value;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1099,"value":"function coerceZeroes(array) {\n if (!array || type.of(array) != \"array\") return;\n for (let i = 0; i < array.length; i++) {\n array[i] = coerceZero(array[i]);\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":4,"value":"hasValue = function(variable) {\n if (variable === null) return false;\n // if (Number.isNaN(variable)) return false;\n if (typeof(variable) == 'undefined') return false;\n if (typeof(variable) == 'number') return Number.isFinite(variable);\n if (typeof(variable) == 'string' && variable == '') return false;\n return true;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":10,"value":"coalesce = function() {\n var args = [...arguments].filter(a => hasValue(a));\n return args[0];\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"function clamp(value, min, max) {\n if (type.of(min) == \"array\") {\n let domain = min;\n min = Math.min(...domain);\n max = Math.max(...domain);\n }\n let result = value;\n result = Math.max(result, coalesce(min, Number.MIN_VALUE));\n result = Math.min(result, coalesce(max, Number.MAX_VALUE));\n return result;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"## Type detection","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":41,"value":"Supports the default JavaScript types — `undefined, object, boolean, number, bigint, string, function` — and **adds two more**:\n * both `type.of()` and `type.getSingle()` return `\"array\"` for arrays rather than the built-in `object` type\n * `type.getSingle()` returns `\"conflicted\"` when it's unable to achieve consensus\n\n`type.defaultValue()` returns the zero-ish value associated with each type (`[]` for arrays and `{}` for objects). Useful when combined with `coalesce()`.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":593,"value":"// For convenient import\ntype = {\n return {\n of: getType,\n getSingle: getSingleType,\n defaultValue: getDefaultValue\n };\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":30,"value":"// Returns the built-in type of value, or 'array' for arrays\ngetType = function(value) {\n return Array.isArray(value) ? 'array' : typeof(value);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":31,"value":"// Returns a built-in type if all values are of the same type, or 'conflicted' otherwise.\n// Returns undefined if [values] is empty\n// Ignores empty and default values if necessary to achieve consensus.\nfunction getSingleType(values) {\n\n function _getSingleType() {\n let types = values.map(v => getType(v));\n let uniqueTypes = [...new Set(types)];\n let type = (uniqueTypes.length <= 1) ? uniqueTypes[0] : 'conflicted';\n return type;\n }\n\n // Round 1: all values\n let singleType = _getSingleType();\n\n // Round 2: all non-empty values\n if (singleType == \"conflicted\") {\n values = values.filter(v => hasValue(v));\n singleType = _getSingleType();\n }\n\n // Round 3: all non-default values\n if (singleType == \"conflicted\") {\n values = values.filter(v => hasValue(v) && v != getDefaultValue(getType(v)));\n let round3Type = _getSingleType(values);\n if (round3Type != 'undefined') singleType = round3Type;\n }\n\n return singleType;\n}\n","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":34,"value":"// Returns the zero-ish value associated with each type (or [] for arrays and {} for objects)\nfunction getDefaultValue(type) {\n if (!type || type == \"undefined\" || type == \"conflicted\") return;\n if (type == \"array\") return [];\n if (type == \"bigint\") return BigInt(0);\n // For all other built-in types, static function returns default value (e.g. Number(), Object())\n let typeClass = type.replace(type[0], type[0].toUpperCase());\n return eval(`${typeClass}()`);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1066,"value":"function isValueType(type) {\n if (!type || type == \"undefined\" || type == \"conflicted\") return false;\n if (type == \"array\" || type == \"object\" || type == \"symbol\" || type == \"function\") return false;\n return true;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":55,"value":"## Value formatting","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":380,"value":"`getFormatter()` returns a d3.format-based formatter using a simpler syntax.\n\n`format()` is a convenience wrapper around `getFormatter()`; it's not _slow_, exactly, but maybe avoid using it in a loop?","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":81,"value":"$4b","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":341,"value":"$4c","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":386,"value":"$4d","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":224,"value":"// convenience method that calls getFormatter and runs it on value\nformat = {\n \n function format(value, params) {\n params = [...arguments].slice(1);\n let formatter = getFormatter(...params);\n return formatter(value);\n }\n\n format.getFormatter = getFormatter;\n format.getFormatString = getFormatString;\n\n format.currencyString = getFormatString(\"$\");\n format.percentString = getFormatString('%');\n format.percent = getFormatter('%', 'red');\n format.currency = getFormatter(\"$\", 'red');\n \n return format;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":457,"value":"**Pre-baked formats**","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":334,"value":"currencyFormat = format.getFormatString(\"$\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":336,"value":"formatCurrency = getFormatter(\"$\", 'red')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":368,"value":"percentFormat = getFormatString('%')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":338,"value":"formatPercent = getFormatter('%', 'red')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":506,"value":"## Array math","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1018,"value":"The `A` class contains static convenience methods for combining and manipulating arrays.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":976,"value":"$4e","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":544,"value":"~~`extendArrayPrototype()` defines `Array.prototype.add`, `.subtract`, `.multiply`, and `.divide`, as well as `.extend` and `.extendLast`. **Other notebooks must call this function after importing!**~~","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":511,"value":"$4f","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":830,"value":"### Examples","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":665,"value":"extendArrayPrototype();","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":850,"value":"#### Array.prototype.add(other), subtract(other)\n`other` is a second array, which must be of the same length. Returns a new array such that `result[i] = this[i] + other[i]` (or `this[i] - other[i]` in the case of `.subtract`).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":867,"value":"[1,2,3].add([1,1,1])","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":873,"value":"#### Array.prototype.multiply(scalar), divide(scalar)\n`scalar` is a number. Returns a new array such that `result[i] = this[i] * scalar` (or `this[i] / scalar`).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":880,"value":"[1,2,3].multiply(2)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":887,"value":"#### Array.prototype.extend(newLength, fillValue)\nreturns a copy of the original array, lengthened to `newLength` if necessary. Any new slots created will be populated with `fillValue`, or `NaN` if no `fillValue` is specified.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":907,"value":"[1,2,3].extend(10, 7)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":905,"value":"[1,2,3].extend(10)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":912,"value":"#### Array.prototype.extendLast(newLength)\nis a convenience method that calls `.extend()` using the value of `this[this.length-1]` as `fillValue`.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":916,"value":"[1,2,\"potato\"].extendLast(10)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1101,"value":"## Nice rounding","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1105,"value":"$50","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1263,"value":"{\n // let start = -1999, stop = 1999, count = 5;\n let start = -2001, stop = 2001, count = 5;\n return {\n ticks: d3.ticks(start, stop, count),\n tickIncrement: d3.tickIncrement(start, stop, count)\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1107,"value":"function _getScientific(valueOrValues, exponent) {\n let values = _arrayIfSingleton(valueOrValues);\n let result = values.map(v => {\n let pow = exponent || _getExponent(v);\n let sig = _getSignificand(v, pow);\n if (!isFinite(pow) || !isFinite(sig)) pow = sig = NaN;\n return { sig, pow };\n });\n\n return (result.length <= 1) ? result[0] : result;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1148,"value":"function _getExponent(valueOrValues) {\n let values = _arrayIfSingleton(valueOrValues);\n if (!values || values.length == 0) return undefined;\n \n let largestValue = Math.max(...values.map(v => Math.abs(v)).filter(v => Number.isFinite(v)));\n if (largestValue.length == 0) return NaN;\n return (largestValue == 0) ? 0 : Math.floor(Math.log10(largestValue));\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1161,"value":"function _getSignificand(valueOrValues, exponent) {\n let values = _arrayIfSingleton(valueOrValues);\n exponent = hasValue(exponent) ? exponent : _getExponent(values);\n\n let result = values.map(n => isFinite(n) ? n / Math.pow(10, exponent) : NaN);\n return (result.length <= 1) ? result[0] : result;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1156,"value":"function _arrayIfSingleton(valueOrValues) {\n return (type.of(valueOrValues) == \"array\") ? valueOrValues : [valueOrValues];\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1172,"value":"_arrayIfSingleton(5)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W51","stdlib":"1"}} 24:null