⌈⌋ ⎇ branch:  Bitrhythm


Hex Artifact Content

Artifact d3b0ef05713a22ee3a0c8f4dc93223c217974d668d3a1bf78c02ac552d25aabd:


0000: 27 75 73 65 20 73 74 72 69 63 74 27 3b 0a 0a 2f  'use strict';../
0010: 2a 2a 0a 20 2a 20 4c 69 6d 69 74 20 61 20 6e 75  **. * Limit a nu
0020: 6d 62 65 72 20 74 6f 20 77 69 74 68 69 6e 20 61  mber to within a
0030: 20 6d 69 6e 69 6d 75 6d 20 61 6e 64 20 6d 61 78   minimum and max
0040: 69 6d 75 6d 0a 20 2a 20 40 70 61 72 61 6d 20 20  imum. * @param  
0050: 7b 6e 75 6d 62 65 72 7d 20 76 61 6c 75 65 20 49  {number} value I
0060: 6e 70 75 74 20 76 61 6c 75 65 0a 20 2a 20 40 70  nput value. * @p
0070: 61 72 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 6d  aram  {number} m
0080: 69 6e 20 20 20 4c 6f 77 65 72 20 6c 69 6d 69 74  in   Lower limit
0090: 0a 20 2a 20 40 70 61 72 61 6d 20 20 7b 6e 75 6d  . * @param  {num
00a0: 62 65 72 7d 20 6d 61 78 20 20 20 55 70 70 65 72  ber} max   Upper
00b0: 20 6c 69 6d 69 74 0a 20 2a 20 40 72 65 74 75 72   limit. * @retur
00c0: 6e 20 7b 6e 75 6d 62 65 72 7d 20 20 20 20 20 20  n {number}      
00d0: 20 54 68 65 20 69 6e 70 75 74 20 76 61 6c 75 65   The input value
00e0: 20 63 6f 6e 73 74 72 61 69 6e 65 64 20 77 69 74   constrained wit
00f0: 68 69 6e 20 74 68 65 20 6c 6f 77 65 72 20 61 6e  hin the lower an
0100: 64 20 75 70 70 65 72 20 6c 69 6d 69 74 73 0a 20  d upper limits. 
0110: 2a 20 40 65 78 61 6d 70 6c 65 0a 20 2a 20 4e 65  * @example. * Ne
0120: 78 75 73 2e 63 6c 69 70 28 31 31 2c 30 2c 31 30  xus.clip(11,0,10
0130: 29 20 20 20 2f 2f 20 72 65 74 75 72 6e 73 20 31  )   // returns 1
0140: 30 0a 20 2a 20 4e 65 78 75 73 2e 63 6c 69 70 28  0. * Nexus.clip(
0150: 2d 31 2c 30 2c 31 30 29 20 20 20 2f 2f 20 72 65  -1,0,10)   // re
0160: 74 75 72 6e 73 20 30 0a 20 2a 20 4e 65 78 75 73  turns 0. * Nexus
0170: 2e 63 6c 69 70 28 35 2c 30 2c 31 30 29 20 20 20  .clip(5,0,10)   
0180: 20 2f 2f 20 72 65 74 75 72 6e 73 20 35 0a 20 2a   // returns 5. *
0190: 2f 0a 0a 65 78 70 6f 72 74 73 2e 63 6c 69 70 20  /..exports.clip 
01a0: 3d 20 28 76 61 6c 75 65 2c 6d 69 6e 2c 6d 61 78  = (value,min,max
01b0: 29 20 3d 3e 20 7b 0a 20 20 72 65 74 75 72 6e 20  ) => {.  return 
01c0: 4d 61 74 68 2e 6d 69 6e 28 4d 61 74 68 2e 6d 61  Math.min(Math.ma
01d0: 78 28 76 61 6c 75 65 2c 6d 69 6e 29 2c 6d 61 78  x(value,min),max
01e0: 29 3b 0a 7d 3b 0a 0a 65 78 70 6f 72 74 73 2e 6e  );.};..exports.n
01f0: 6f 72 6d 61 6c 69 7a 65 20 3d 20 28 76 61 6c 75  ormalize = (valu
0200: 65 2c 6d 69 6e 2c 6d 61 78 29 20 3d 3e 20 7b 0a  e,min,max) => {.
0210: 20 20 72 65 74 75 72 6e 20 28 20 28 76 61 6c 75    return ( (valu
0220: 65 2d 6d 69 6e 29 20 2f 20 28 6d 61 78 2d 6d 69  e-min) / (max-mi
0230: 6e 29 20 29 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a  n) );.};../**. *
0240: 20 53 63 61 6c 65 20 61 20 76 61 6c 75 65 20 66   Scale a value f
0250: 72 6f 6d 20 6f 6e 65 20 72 61 6e 67 65 20 74 6f  rom one range to
0260: 20 61 6e 6f 74 68 65 72 20 72 61 6e 67 65 2e 0a   another range..
0270: 20 2a 20 40 70 61 72 61 6d 20 20 7b 6e 75 6d 62   * @param  {numb
0280: 65 72 7d 20 69 6e 4e 75 6d 20 20 49 6e 70 75 74  er} inNum  Input
0290: 20 76 61 6c 75 65 0a 20 2a 20 40 70 61 72 61 6d   value. * @param
02a0: 20 20 7b 6e 75 6d 62 65 72 7d 20 69 6e 4d 69 6e    {number} inMin
02b0: 20 20 49 6e 70 75 74 20 72 61 6e 67 65 20 6d 69    Input range mi
02c0: 6e 69 6d 75 6d 0a 20 2a 20 40 70 61 72 61 6d 20  nimum. * @param 
02d0: 20 7b 6e 75 6d 62 65 72 7d 20 69 6e 4d 61 78 20   {number} inMax 
02e0: 20 49 6e 70 75 74 20 72 61 6e 67 65 20 6d 61 78   Input range max
02f0: 69 6d 75 6d 0a 20 2a 20 40 70 61 72 61 6d 20 20  imum. * @param  
0300: 7b 6e 75 6d 62 65 72 7d 20 6f 75 74 4d 69 6e 20  {number} outMin 
0310: 4f 75 74 70 75 74 20 72 61 6e 67 65 20 6d 69 6e  Output range min
0320: 69 6d 75 6d 0a 20 2a 20 40 70 61 72 61 6d 20 20  imum. * @param  
0330: 7b 6e 75 6d 62 65 72 7d 20 6f 75 74 4d 61 78 20  {number} outMax 
0340: 4f 75 74 70 75 74 20 72 61 6e 67 65 20 6d 61 78  Output range max
0350: 69 6d 75 6d 0a 20 2a 20 40 72 65 74 75 72 6e 20  imum. * @return 
0360: 7b 6e 75 6d 62 65 72 7d 20 20 20 20 20 20 20 20  {number}        
0370: 54 68 65 20 69 6e 70 75 74 20 76 61 6c 75 65 20  The input value 
0380: 73 63 61 6c 65 64 20 74 6f 20 69 74 73 20 6e 65  scaled to its ne
0390: 77 20 72 61 6e 67 65 0a 20 2a 20 40 65 78 61 6d  w range. * @exam
03a0: 70 6c 65 0a 20 2a 20 4e 65 78 75 73 2e 73 63 61  ple. * Nexus.sca
03b0: 6c 65 28 30 2e 35 2c 30 2c 31 2c 30 2c 31 30 29  le(0.5,0,1,0,10)
03c0: 20 20 20 2f 2f 20 72 65 74 75 72 6e 73 20 35 0a     // returns 5.
03d0: 20 2a 20 4e 65 78 75 73 2e 73 63 61 6c 65 28 30   * Nexus.scale(0
03e0: 2e 39 2c 30 2c 31 2c 31 2c 30 29 20 20 20 20 2f  .9,0,1,1,0)    /
03f0: 2f 20 72 65 74 75 72 6e 73 20 30 2e 31 0a 20 2a  / returns 0.1. *
0400: 2f 0a 65 78 70 6f 72 74 73 2e 73 63 61 6c 65 20  /.exports.scale 
0410: 3d 20 28 69 6e 4e 75 6d 2c 20 69 6e 4d 69 6e 2c  = (inNum, inMin,
0420: 20 69 6e 4d 61 78 2c 20 6f 75 74 4d 69 6e 2c 20   inMax, outMin, 
0430: 6f 75 74 4d 61 78 29 20 3d 3e 20 7b 0a 20 20 69  outMax) => {.  i
0440: 66 20 28 69 6e 4d 69 6e 20 3d 3d 3d 20 69 6e 4d  f (inMin === inM
0450: 61 78 29 20 7b 0a 20 20 20 20 72 65 74 75 72 6e  ax) {.    return
0460: 20 6f 75 74 4d 69 6e 3b 0a 20 20 7d 0a 20 20 72   outMin;.  }.  r
0470: 65 74 75 72 6e 20 28 28 28 69 6e 4e 75 6d 20 2d  eturn (((inNum -
0480: 20 69 6e 4d 69 6e 29 20 2a 20 28 6f 75 74 4d 61   inMin) * (outMa
0490: 78 20 2d 20 6f 75 74 4d 69 6e 29 29 20 2f 20 28  x - outMin)) / (
04a0: 69 6e 4d 61 78 20 2d 20 69 6e 4d 69 6e 29 29 20  inMax - inMin)) 
04b0: 2b 20 6f 75 74 4d 69 6e 3b 0a 7d 3b 0a 0a 65 78  + outMin;.};..ex
04c0: 70 6f 72 74 73 2e 74 6f 50 6f 6c 61 72 20 3d 20  ports.toPolar = 
04d0: 28 78 2c 79 29 20 3d 3e 20 7b 0a 20 20 76 61 72  (x,y) => {.  var
04e0: 20 72 20 3d 20 4d 61 74 68 2e 73 71 72 74 28 78   r = Math.sqrt(x
04f0: 2a 78 20 2b 20 79 2a 79 29 3b 0a 0a 20 20 76 61  *x + y*y);..  va
0500: 72 20 74 68 65 74 61 20 3d 20 4d 61 74 68 2e 61  r theta = Math.a
0510: 74 61 6e 32 28 79 2c 78 29 3b 0a 20 20 69 66 20  tan2(y,x);.  if 
0520: 28 74 68 65 74 61 20 3c 20 30 29 20 7b 0a 20 20  (theta < 0) {.  
0530: 20 20 74 68 65 74 61 20 3d 20 74 68 65 74 61 20    theta = theta 
0540: 2b 20 28 32 20 2a 20 4d 61 74 68 2e 50 49 29 3b  + (2 * Math.PI);
0550: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7b 72  .  }.  return {r
0560: 61 64 69 75 73 3a 20 72 2c 20 61 6e 67 6c 65 3a  adius: r, angle:
0570: 20 74 68 65 74 61 7d 3b 0a 7d 3b 0a 0a 65 78 70   theta};.};..exp
0580: 6f 72 74 73 2e 74 6f 43 61 72 74 65 73 69 61 6e  orts.toCartesian
0590: 20 3d 20 66 75 6e 63 74 69 6f 6e 28 72 61 64 69   = function(radi
05a0: 75 73 2c 20 61 6e 67 6c 65 29 7b 0a 20 20 76 61  us, angle){.  va
05b0: 72 20 63 6f 73 20 3d 20 4d 61 74 68 2e 63 6f 73  r cos = Math.cos
05c0: 28 61 6e 67 6c 65 29 3b 0a 20 20 76 61 72 20 73  (angle);.  var s
05d0: 69 6e 20 3d 20 4d 61 74 68 2e 73 69 6e 28 61 6e  in = Math.sin(an
05e0: 67 6c 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 7b  gle);.  return {
05f0: 78 3a 20 72 61 64 69 75 73 2a 63 6f 73 2c 20 79  x: radius*cos, y
0600: 3a 20 72 61 64 69 75 73 2a 73 69 6e 2a 2d 31 7d  : radius*sin*-1}
0610: 3b 0a 7d 3b 0a 2f 2a 0a 65 78 70 6f 72 74 73 2e  ;.};./*.exports.
0620: 70 6f 6c 61 72 54 6f 43 61 72 74 65 73 69 61 6e  polarToCartesian
0630: 28 63 65 6e 74 65 72 58 2c 20 63 65 6e 74 65 72  (centerX, center
0640: 59 2c 20 72 61 64 69 75 73 2c 20 61 6e 67 6c 65  Y, radius, angle
0650: 49 6e 44 65 67 72 65 65 73 29 20 7b 0a 20 20 76  InDegrees) {.  v
0660: 61 72 20 61 6e 67 6c 65 49 6e 52 61 64 69 61 6e  ar angleInRadian
0670: 73 20 3d 20 28 61 6e 67 6c 65 49 6e 44 65 67 72  s = (angleInDegr
0680: 65 65 73 2d 39 30 29 20 2a 20 4d 61 74 68 2e 50  ees-90) * Math.P
0690: 49 20 2f 20 31 38 30 2e 30 3b 0a 0a 20 20 72 65  I / 180.0;..  re
06a0: 74 75 72 6e 20 7b 0a 20 20 20 20 78 3a 20 63 65  turn {.    x: ce
06b0: 6e 74 65 72 58 20 2b 20 28 72 61 64 69 75 73 20  nterX + (radius 
06c0: 2a 20 4d 61 74 68 2e 63 6f 73 28 61 6e 67 6c 65  * Math.cos(angle
06d0: 49 6e 52 61 64 69 61 6e 73 29 29 2c 0a 20 20 20  InRadians)),.   
06e0: 20 79 3a 20 63 65 6e 74 65 72 59 20 2b 20 28 72   y: centerY + (r
06f0: 61 64 69 75 73 20 2a 20 4d 61 74 68 2e 73 69 6e  adius * Math.sin
0700: 28 61 6e 67 6c 65 49 6e 52 61 64 69 61 6e 73 29  (angleInRadians)
0710: 29 0a 20 20 7d 3b 0a 7d 20 20 2a 2f 0a 0a 0a 0a  ).  };.}  */....
0720: 65 78 70 6f 72 74 73 2e 70 72 75 6e 65 20 3d 20  exports.prune = 
0730: 66 75 6e 63 74 69 6f 6e 28 64 61 74 61 2c 20 73  function(data, s
0740: 63 61 6c 65 29 20 7b 0a 20 20 72 65 74 75 72 6e  cale) {.  return
0750: 20 70 61 72 73 65 46 6c 6f 61 74 28 64 61 74 61   parseFloat(data
0760: 2e 74 6f 46 69 78 65 64 28 73 63 61 6c 65 29 29  .toFixed(scale))
0770: 3b 0a 7d 3b 0a 0a 65 78 70 6f 72 74 73 2e 69 6e  ;.};..exports.in
0780: 76 65 72 74 20 3d 20 66 75 6e 63 74 69 6f 6e 20  vert = function 
0790: 28 69 6e 4e 75 6d 29 20 7b 0a 20 20 72 65 74 75  (inNum) {.  retu
07a0: 72 6e 20 65 78 70 6f 72 74 73 2e 73 63 61 6c 65  rn exports.scale
07b0: 28 69 6e 4e 75 6d 2c 20 31 2c 20 30 2c 20 30 2c  (inNum, 1, 0, 0,
07c0: 20 31 29 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20   1);.};../**. * 
07d0: 43 6f 6e 76 65 72 74 20 61 20 4d 49 44 69 20 6e  Convert a MIDi n
07e0: 6f 74 65 20 6e 75 6d 62 65 72 20 74 6f 20 61 20  ote number to a 
07f0: 66 72 65 71 75 65 6e 63 79 20 76 61 6c 75 65 20  frequency value 
0800: 69 6e 20 65 71 75 61 6c 20 74 65 6d 70 65 72 61  in equal tempera
0810: 6d 65 6e 74 2e 0a 20 2a 20 40 70 61 72 61 6d 20  ment.. * @param 
0820: 20 7b 6e 75 6d 62 65 72 7d 20 6d 69 64 69 20 4d   {number} midi M
0830: 49 44 49 20 6e 6f 74 65 20 76 61 6c 75 65 0a 20  IDI note value. 
0840: 2a 20 40 72 65 74 75 72 6e 20 7b 6e 75 6d 62 65  * @return {numbe
0850: 72 7d 20 20 20 20 20 20 46 72 65 71 75 65 6e 63  r}      Frequenc
0860: 65 20 76 61 6c 75 65 0a 20 2a 20 40 65 78 61 6d  e value. * @exam
0870: 70 6c 65 0a 20 2a 20 4e 65 78 75 73 2e 6d 74 6f  ple. * Nexus.mto
0880: 66 28 36 30 29 20 20 2f 2f 20 72 65 74 75 72 6e  f(60)  // return
0890: 73 20 74 68 65 20 66 72 65 71 75 65 6e 63 79 20  s the frequency 
08a0: 6e 75 6d 62 65 72 20 6f 66 20 4d 69 64 64 6c 65  number of Middle
08b0: 20 43 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 6d   C. */.exports.m
08c0: 74 6f 66 20 3d 20 66 75 6e 63 74 69 6f 6e 28 6d  tof = function(m
08d0: 69 64 69 29 20 7b 0a 20 20 72 65 74 75 72 6e 20  idi) {.  return 
08e0: 4d 61 74 68 2e 70 6f 77 28 32 2c 20 28 28 6d 69  Math.pow(2, ((mi
08f0: 64 69 2d 36 39 29 2f 31 32 29 29 20 2a 20 34 34  di-69)/12)) * 44
0900: 30 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20 49 6e  0;.};../**. * In
0910: 74 65 72 70 6f 6c 61 74 65 20 62 65 74 77 65 65  terpolate betwee
0920: 6e 20 74 77 6f 20 6e 75 6d 62 65 72 73 0a 20 2a  n two numbers. *
0930: 20 40 70 61 72 61 6d 20 20 7b 6e 75 6d 62 65 72   @param  {number
0940: 7d 20 6c 6f 63 20 49 6e 74 65 72 70 6f 6c 61 74  } loc Interpolat
0950: 69 6f 6e 20 69 6e 64 65 78 20 28 30 2d 31 29 0a  ion index (0-1).
0960: 20 2a 20 40 70 61 72 61 6d 20 20 7b 6e 75 6d 62   * @param  {numb
0970: 65 72 7d 20 6d 69 6e 20 4c 6f 77 65 72 20 76 61  er} min Lower va
0980: 6c 75 65 0a 20 2a 20 40 70 61 72 61 6d 20 20 7b  lue. * @param  {
0990: 6e 75 6d 62 65 72 7d 20 6d 61 78 20 55 70 70 65  number} max Uppe
09a0: 72 20 76 61 6c 75 65 0a 20 2a 20 40 72 65 74 75  r value. * @retu
09b0: 72 6e 20 7b 6e 75 6d 62 65 72 7d 20 20 20 20 20  rn {number}     
09c0: 49 6e 74 65 72 70 6f 6c 61 74 65 64 20 76 61 6c  Interpolated val
09d0: 75 65 0a 20 2a 20 40 65 78 61 6d 70 6c 65 0a 20  ue. * @example. 
09e0: 2a 20 4e 65 78 75 73 2e 69 6e 74 65 72 70 28 30  * Nexus.interp(0
09f0: 2e 35 2c 32 2c 34 29 20 20 20 2f 2f 20 72 65 74  .5,2,4)   // ret
0a00: 75 72 6e 73 20 33 0a 20 2a 20 4e 65 78 75 73 2e  urns 3. * Nexus.
0a10: 69 6e 74 65 72 70 28 30 2e 31 2c 30 2c 31 30 29  interp(0.1,0,10)
0a20: 20 20 20 20 20 2f 2f 20 72 65 74 75 72 6e 73 20       // returns 
0a30: 31 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 69 6e  1. */.exports.in
0a40: 74 65 72 70 20 3d 20 66 75 6e 63 74 69 6f 6e 28  terp = function(
0a50: 6c 6f 63 2c 6d 69 6e 2c 6d 61 78 29 20 7b 0a 20  loc,min,max) {. 
0a60: 20 72 65 74 75 72 6e 20 6c 6f 63 20 2a 20 28 6d   return loc * (m
0a70: 61 78 20 2d 20 6d 69 6e 29 20 2b 20 6d 69 6e 3b  ax - min) + min;
0a80: 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20 52 65 74 75  .};../**. * Retu
0a90: 72 6e 20 61 20 72 61 6e 64 6f 6d 20 63 68 6f 69  rn a random choi
0aa0: 63 65 20 66 72 6f 6d 20 61 20 6c 69 73 74 20 6f  ce from a list o
0ab0: 66 20 61 72 67 75 6d 65 6e 74 73 0a 20 2a 20 40  f arguments. * @
0ac0: 72 65 74 75 72 6e 20 7b 76 61 72 69 6f 75 73 7d  return {various}
0ad0: 20 4f 6e 65 20 72 61 6e 64 6f 6d 20 61 72 67 75   One random argu
0ae0: 6d 65 6e 74 0a 20 2a 20 40 65 78 61 6d 70 6c 65  ment. * @example
0af0: 0a 20 2a 20 4e 65 78 75 73 2e 70 69 63 6b 28 31  . * Nexus.pick(1
0b00: 2c 32 2c 33 2c 34 29 20 20 20 2f 2f 20 72 65 74  ,2,3,4)   // ret
0b10: 75 72 6e 73 20 31 2c 20 32 2c 20 33 2c 20 6f 72  urns 1, 2, 3, or
0b20: 20 34 0a 20 2a 20 4e 65 78 75 73 2e 70 69 63 6b   4. * Nexus.pick
0b30: 28 66 75 6e 63 74 69 6f 6e 31 2c 66 75 6e 63 74  (function1,funct
0b40: 69 6f 6e 32 29 20 20 20 2f 2f 20 72 65 74 75 72  ion2)   // retur
0b50: 6e 73 20 65 69 74 68 65 72 20 66 75 6e 63 74 69  ns either functi
0b60: 6f 6e 31 20 6f 72 20 66 75 6e 63 74 69 6f 6e 32  on1 or function2
0b70: 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 70 69 63  . */.exports.pic
0b80: 6b 20 3d 20 66 75 6e 63 74 69 6f 6e 28 29 20 7b  k = function() {
0b90: 0a 20 20 72 65 74 75 72 6e 20 61 72 67 75 6d 65  .  return argume
0ba0: 6e 74 73 5b 7e 7e 28 4d 61 74 68 2e 72 61 6e 64  nts[~~(Math.rand
0bb0: 6f 6d 28 29 2a 61 72 67 75 6d 65 6e 74 73 2e 6c  om()*arguments.l
0bc0: 65 6e 67 74 68 29 5d 3b 0a 7d 3b 0a 0a 2f 2a 2a  ength)];.};../**
0bd0: 0a 20 2a 20 52 65 74 75 72 6e 73 20 61 6e 20 6f  . * Returns an o
0be0: 63 74 61 76 65 20 6d 75 6c 74 69 70 6c 69 65 72  ctave multiplier
0bf0: 20 66 6f 72 20 66 72 65 71 75 65 6e 63 79 20 76   for frequency v
0c00: 61 6c 75 65 73 0a 20 2a 20 40 70 61 72 61 6d 20  alues. * @param 
0c10: 20 7b 6e 75 6d 62 65 72 7d 20 6e 75 6d 20 52 65   {number} num Re
0c20: 6c 61 74 69 76 65 20 6f 63 74 61 76 65 20 6e 75  lative octave nu
0c30: 6d 62 65 72 20 28 65 2e 67 2e 20 2d 31 20 66 6f  mber (e.g. -1 fo
0c40: 72 20 6f 6e 65 20 6f 63 74 61 76 65 20 64 6f 77  r one octave dow
0c50: 6e 2c 20 31 20 66 6f 72 20 6f 6e 65 20 6f 63 74  n, 1 for one oct
0c60: 61 76 65 20 75 70 29 0a 20 2a 20 40 72 65 74 75  ave up). * @retu
0c70: 72 6e 20 7b 6e 75 6d 62 65 72 7d 20 20 20 20 20  rn {number}     
0c80: 4f 63 74 61 76 65 20 6d 75 6c 74 69 70 6c 69 65  Octave multiplie
0c90: 72 0a 20 2a 20 40 65 78 61 6d 70 6c 65 0a 20 2a  r. * @example. *
0ca0: 20 4e 65 78 75 73 2e 6f 63 74 61 76 65 28 2d 31   Nexus.octave(-1
0cb0: 29 20 20 2f 2f 20 72 65 74 75 72 6e 73 20 30 2e  )  // returns 0.
0cc0: 35 0a 20 2a 20 4e 65 78 75 73 2e 6f 63 74 61 76  5. * Nexus.octav
0cd0: 65 28 30 29 20 20 20 2f 2f 20 72 65 74 75 72 6e  e(0)   // return
0ce0: 73 20 31 0a 20 2a 20 4e 65 78 75 73 2e 6f 63 74  s 1. * Nexus.oct
0cf0: 61 76 65 28 31 29 20 20 20 2f 2f 20 72 65 74 75  ave(1)   // retu
0d00: 72 6e 73 20 32 0a 20 2a 20 4e 65 78 75 73 2e 6f  rns 2. * Nexus.o
0d10: 63 74 61 76 65 28 32 29 20 20 20 2f 2f 20 72 65  ctave(2)   // re
0d20: 74 75 72 6e 73 20 34 0a 20 2a 2f 0a 65 78 70 6f  turns 4. */.expo
0d30: 72 74 73 2e 6f 63 74 61 76 65 20 3d 20 66 75 6e  rts.octave = fun
0d40: 63 74 69 6f 6e 28 6e 75 6d 29 20 7b 0a 20 20 72  ction(num) {.  r
0d50: 65 74 75 72 6e 20 4d 61 74 68 2e 70 6f 77 28 32  eturn Math.pow(2
0d60: 2c 6e 75 6d 29 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20  ,num);.};../**. 
0d70: 2a 20 52 61 6e 64 6f 6d 20 69 6e 74 65 67 65 72  * Random integer
0d80: 20 67 65 6e 65 72 61 74 6f 72 2e 20 49 66 20 6e   generator. If n
0d90: 6f 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e  o second argumen
0da0: 74 20 69 73 20 67 69 76 65 6e 2c 20 77 69 6c 6c  t is given, will
0db0: 20 72 65 74 75 72 6e 20 72 61 6e 64 6f 6d 20 69   return random i
0dc0: 6e 74 65 67 65 72 20 66 72 6f 6d 20 30 20 74 6f  nteger from 0 to
0dd0: 20 62 6f 75 6e 64 31 2e 0a 20 2a 20 40 70 61 72   bound1.. * @par
0de0: 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 62 6f 75  am  {number} bou
0df0: 6e 64 31 20 4d 69 6e 69 6d 75 6d 20 72 61 6e 64  nd1 Minimum rand
0e00: 6f 6d 20 76 61 6c 75 65 0a 20 2a 20 40 70 61 72  om value. * @par
0e10: 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 62 6f 75  am  {number} bou
0e20: 6e 64 32 20 4d 61 78 69 6d 75 6d 20 72 61 6e 64  nd2 Maximum rand
0e30: 6f 6d 20 76 61 6c 75 65 0a 20 2a 20 40 72 65 74  om value. * @ret
0e40: 75 72 6e 20 7b 6e 75 6d 62 65 72 7d 20 20 20 20  urn {number}    
0e50: 20 20 20 20 52 61 6e 64 6f 6d 20 69 6e 74 65 67      Random integ
0e60: 65 72 20 62 65 74 77 65 65 6e 20 6c 6f 77 65 72  er between lower
0e70: 20 61 6e 64 20 75 70 70 65 72 20 62 6f 75 6e 64   and upper bound
0e80: 61 72 79 0a 20 2a 20 40 65 78 61 6d 70 6c 65 0a  ary. * @example.
0e90: 20 2a 20 4e 65 78 75 73 2e 72 69 28 31 30 29 20   * Nexus.ri(10) 
0ea0: 20 20 20 2f 2f 20 72 65 74 75 72 6e 73 20 72 61     // returns ra
0eb0: 6e 64 6f 6d 20 69 6e 74 20 66 72 6f 6d 20 30 20  ndom int from 0 
0ec0: 74 6f 20 31 30 0a 20 2a 20 4e 65 78 75 73 2e 72  to 10. * Nexus.r
0ed0: 69 28 32 30 2c 32 30 30 30 29 20 2f 2f 20 72 65  i(20,2000) // re
0ee0: 74 75 72 6e 73 20 72 61 6e 64 6f 6d 20 69 6e 74  turns random int
0ef0: 20 66 72 6f 6d 20 32 30 20 74 6f 20 32 30 30 30   from 20 to 2000
0f00: 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 72 69 20  . */.exports.ri 
0f10: 3d 20 66 75 6e 63 74 69 6f 6e 28 62 6f 75 6e 64  = function(bound
0f20: 31 2c 62 6f 75 6e 64 32 29 20 7b 0a 20 20 69 66  1,bound2) {.  if
0f30: 20 28 21 62 6f 75 6e 64 32 29 20 7b 0a 20 20 20   (!bound2) {.   
0f40: 20 62 6f 75 6e 64 32 20 3d 20 62 6f 75 6e 64 31   bound2 = bound1
0f50: 3b 0a 20 20 20 20 62 6f 75 6e 64 31 20 3d 20 30  ;.    bound1 = 0
0f60: 3b 0a 20 20 7d 0a 20 20 76 61 72 20 6c 6f 77 20  ;.  }.  var low 
0f70: 3d 20 4d 61 74 68 2e 6d 69 6e 28 62 6f 75 6e 64  = Math.min(bound
0f80: 31 2c 62 6f 75 6e 64 32 29 3b 0a 20 20 76 61 72  1,bound2);.  var
0f90: 20 68 69 67 68 20 3d 20 4d 61 74 68 2e 6d 61 78   high = Math.max
0fa0: 28 62 6f 75 6e 64 31 2c 62 6f 75 6e 64 32 29 3b  (bound1,bound2);
0fb0: 0a 20 20 72 65 74 75 72 6e 20 4d 61 74 68 2e 66  .  return Math.f
0fc0: 6c 6f 6f 72 28 4d 61 74 68 2e 72 61 6e 64 6f 6d  loor(Math.random
0fd0: 28 29 2a 28 68 69 67 68 2d 6c 6f 77 29 2b 6c 6f  ()*(high-low)+lo
0fe0: 77 29 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20 52  w);.};../**. * R
0ff0: 61 6e 64 6f 6d 20 66 6c 6f 61 74 20 6e 75 6d 62  andom float numb
1000: 65 72 20 67 65 6e 65 72 61 74 6f 72 2e 20 49 66  er generator. If
1010: 20 6e 6f 20 73 65 63 6f 6e 64 20 61 72 67 75 6d   no second argum
1020: 65 6e 74 20 69 73 20 67 69 76 65 6e 2c 20 77 69  ent is given, wi
1030: 6c 6c 20 72 65 74 75 72 6e 20 72 61 6e 64 6f 6d  ll return random
1040: 20 66 6c 6f 61 74 20 66 72 6f 6d 20 30 20 74 6f   float from 0 to
1050: 20 62 6f 75 6e 64 31 2e 0a 20 2a 20 40 70 61 72   bound1.. * @par
1060: 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 62 6f 75  am  {number} bou
1070: 6e 64 31 20 4d 69 6e 69 6d 75 6d 20 72 61 6e 64  nd1 Minimum rand
1080: 6f 6d 20 76 61 6c 75 65 0a 20 2a 20 40 70 61 72  om value. * @par
1090: 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 62 6f 75  am  {number} bou
10a0: 6e 64 32 20 4d 61 78 69 6d 75 6d 20 72 61 6e 64  nd2 Maximum rand
10b0: 6f 6d 20 76 61 6c 75 65 0a 20 2a 20 40 72 65 74  om value. * @ret
10c0: 75 72 6e 20 7b 6e 75 6d 62 65 72 7d 20 20 20 20  urn {number}    
10d0: 20 20 20 20 52 61 6e 64 6f 6d 20 66 6c 6f 61 74      Random float
10e0: 20 62 65 74 77 65 65 6e 20 6c 6f 77 65 72 20 61   between lower a
10f0: 6e 64 20 75 70 70 65 72 20 62 6f 75 6e 64 61 72  nd upper boundar
1100: 79 0a 20 2a 20 40 65 78 61 6d 70 6c 65 0a 20 2a  y. * @example. *
1110: 20 4e 65 78 75 73 2e 72 66 28 31 29 20 20 20 20   Nexus.rf(1)    
1120: 2f 2f 20 72 65 74 75 72 6e 73 20 72 61 6e 64 6f  // returns rando
1130: 6d 20 66 6c 6f 61 74 20 66 72 6f 6d 20 30 20 74  m float from 0 t
1140: 6f 20 31 0a 20 2a 20 4e 65 78 75 73 2e 72 66 28  o 1. * Nexus.rf(
1150: 31 2c 32 29 20 2f 2f 20 72 65 74 75 72 6e 73 20  1,2) // returns 
1160: 72 61 6e 64 6f 6d 20 66 6c 6f 61 74 20 66 72 6f  random float fro
1170: 6d 20 31 20 74 6f 20 32 0a 20 2a 2f 0a 65 78 70  m 1 to 2. */.exp
1180: 6f 72 74 73 2e 72 66 20 3d 20 66 75 6e 63 74 69  orts.rf = functi
1190: 6f 6e 28 62 6f 75 6e 64 31 2c 62 6f 75 6e 64 32  on(bound1,bound2
11a0: 29 20 7b 0a 20 20 69 66 20 28 21 62 6f 75 6e 64  ) {.  if (!bound
11b0: 32 29 20 7b 0a 20 20 20 20 62 6f 75 6e 64 32 20  2) {.    bound2 
11c0: 3d 20 62 6f 75 6e 64 31 3b 0a 20 20 20 20 62 6f  = bound1;.    bo
11d0: 75 6e 64 31 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  und1 = 0;.  }.  
11e0: 76 61 72 20 6c 6f 77 20 3d 20 4d 61 74 68 2e 6d  var low = Math.m
11f0: 69 6e 28 62 6f 75 6e 64 31 2c 62 6f 75 6e 64 32  in(bound1,bound2
1200: 29 3b 0a 20 20 76 61 72 20 68 69 67 68 20 3d 20  );.  var high = 
1210: 4d 61 74 68 2e 6d 61 78 28 62 6f 75 6e 64 31 2c  Math.max(bound1,
1220: 62 6f 75 6e 64 32 29 3b 0a 20 20 72 65 74 75 72  bound2);.  retur
1230: 6e 20 4d 61 74 68 2e 72 61 6e 64 6f 6d 28 29 2a  n Math.random()*
1240: 28 68 69 67 68 2d 6c 6f 77 29 2b 6c 6f 77 3b 0a  (high-low)+low;.
1250: 7d 3b 0a 0a 0a 65 78 70 6f 72 74 73 2e 63 79 63  };...exports.cyc
1260: 6c 65 20 3d 20 66 75 6e 63 74 69 6f 6e 28 69 6e  le = function(in
1270: 70 75 74 2c 6d 69 6e 2c 6d 61 78 29 20 7b 0a 20  put,min,max) {. 
1280: 20 69 6e 70 75 74 2b 2b 3b 0a 20 20 69 66 20 28   input++;.  if (
1290: 69 6e 70 75 74 20 3e 3d 20 6d 61 78 29 20 7b 0a  input >= max) {.
12a0: 20 20 20 20 69 6e 70 75 74 20 3d 20 6d 69 6e 3b      input = min;
12b0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 6e  .  }.  return in
12c0: 70 75 74 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20  put;.};../**. * 
12d0: 41 76 65 72 61 67 65 20 61 6e 20 61 72 72 61 79  Average an array
12e0: 20 6f 66 20 6e 75 6d 62 65 72 73 0a 20 2a 20 40   of numbers. * @
12f0: 70 61 72 61 6d 20 20 7b 41 72 72 61 79 7d 20 64  param  {Array} d
1300: 61 74 61 20 41 72 72 61 79 20 6f 66 20 6e 75 6d  ata Array of num
1310: 62 65 72 73 20 74 6f 20 61 76 65 72 61 67 65 0a  bers to average.
1320: 20 2a 20 40 72 65 74 75 72 6e 20 7b 6e 75 6d 62   * @return {numb
1330: 65 72 7d 20 20 20 20 20 20 41 76 65 72 61 67 65  er}      Average
1340: 20 6f 66 20 74 68 65 20 69 6e 70 75 74 20 64 61   of the input da
1350: 74 61 0a 20 2a 20 40 65 78 61 6d 70 6c 65 0a 20  ta. * @example. 
1360: 2a 20 4e 65 78 75 73 2e 61 76 65 72 61 67 65 28  * Nexus.average(
1370: 5b 30 2c 32 2c 34 2c 36 2c 38 2c 31 30 5d 29 20  [0,2,4,6,8,10]) 
1380: 20 20 2f 2f 20 72 65 74 75 72 6e 73 20 35 0a 20    // returns 5. 
1390: 2a 2f 0a 65 78 70 6f 72 74 73 2e 61 76 65 72 61  */.exports.avera
13a0: 67 65 20 3d 20 66 75 6e 63 74 69 6f 6e 28 64 61  ge = function(da
13b0: 74 61 29 20 7b 0a 20 20 6c 65 74 20 74 6f 74 61  ta) {.  let tota
13c0: 6c 20 3d 20 30 3b 0a 20 20 66 6f 72 20 28 76 61  l = 0;.  for (va
13d0: 72 20 69 3d 30 3b 69 3c 64 61 74 61 2e 6c 65 6e  r i=0;i<data.len
13e0: 67 74 68 3b 69 2b 2b 29 20 7b 0a 20 20 20 20 74  gth;i++) {.    t
13f0: 6f 74 61 6c 20 2b 3d 20 64 61 74 61 5b 69 5d 3b  otal += data[i];
1400: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 74 6f  .  }.  return to
1410: 74 61 6c 20 2f 20 64 61 74 61 2e 6c 65 6e 67 74  tal / data.lengt
1420: 68 3b 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20 47 65  h;.};../**. * Ge
1430: 74 20 74 68 65 20 64 69 73 74 61 6e 63 65 20 66  t the distance f
1440: 72 6f 6d 20 6f 6e 65 20 28 78 2c 79 29 20 70 6f  rom one (x,y) po
1450: 69 6e 74 20 74 6f 20 61 6e 6f 74 68 65 72 20 28  int to another (
1460: 78 2c 79 29 20 70 6f 69 6e 74 0a 20 2a 20 40 70  x,y) point. * @p
1470: 61 72 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 78  aram  {number} x
1480: 31 20 78 20 6f 66 20 66 69 72 73 74 20 70 6f 69  1 x of first poi
1490: 6e 74 0a 20 2a 20 40 70 61 72 61 6d 20 20 7b 6e  nt. * @param  {n
14a0: 75 6d 62 65 72 7d 20 79 31 20 79 20 6f 66 20 66  umber} y1 y of f
14b0: 69 72 73 74 20 70 6f 69 6e 74 0a 20 2a 20 40 70  irst point. * @p
14c0: 61 72 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20 78  aram  {number} x
14d0: 32 20 78 20 6f 66 20 73 65 63 6f 6e 64 20 70 6f  2 x of second po
14e0: 69 6e 74 0a 20 2a 20 40 70 61 72 61 6d 20 20 7b  int. * @param  {
14f0: 6e 75 6d 62 65 72 7d 20 79 32 20 79 20 6f 66 20  number} y2 y of 
1500: 73 65 63 6f 6e 64 20 70 6f 69 6e 79 0a 20 2a 20  second poiny. * 
1510: 40 72 65 74 75 72 6e 20 7b 6e 75 6d 62 65 72 7d  @return {number}
1520: 20 20 20 20 44 69 73 74 61 6e 63 65 0a 20 2a 20      Distance. * 
1530: 40 65 78 61 6d 70 6c 65 0a 20 2a 20 4e 65 78 75  @example. * Nexu
1540: 73 2e 64 69 73 74 61 6e 63 65 28 30 2c 30 2c 33  s.distance(0,0,3
1550: 2c 34 29 20 20 20 2f 2f 20 72 65 74 75 72 6e 73  ,4)   // returns
1560: 20 35 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 64   5. */.exports.d
1570: 69 73 74 61 6e 63 65 20 3d 20 66 75 6e 63 74 69  istance = functi
1580: 6f 6e 28 78 31 2c 79 31 2c 78 32 2c 79 32 29 20  on(x1,y1,x2,y2) 
1590: 7b 0a 20 20 6c 65 74 20 61 20 3d 20 78 31 20 2d  {.  let a = x1 -
15a0: 20 78 32 3b 0a 20 20 6c 65 74 20 62 20 3d 20 79   x2;.  let b = y
15b0: 31 20 2d 20 79 32 3b 0a 20 20 72 65 74 75 72 6e  1 - y2;.  return
15c0: 20 4d 61 74 68 2e 73 71 72 74 28 20 61 2a 61 20   Math.sqrt( a*a 
15d0: 2b 20 62 2a 62 20 29 3b 0a 7d 3b 0a 0a 65 78 70  + b*b );.};..exp
15e0: 6f 72 74 73 2e 67 61 69 6e 54 6f 44 42 20 3d 20  orts.gainToDB = 
15f0: 66 75 6e 63 74 69 6f 6e 28 67 61 69 6e 29 20 7b  function(gain) {
1600: 0a 20 20 72 65 74 75 72 6e 20 32 30 20 2a 20 4d  .  return 20 * M
1610: 61 74 68 2e 6c 6f 67 31 30 28 67 61 69 6e 29 3b  ath.log10(gain);
1620: 0a 7d 3b 0a 0a 2f 2a 2a 0a 20 2a 20 46 6c 69 70  .};../**. * Flip
1630: 20 61 20 63 6f 69 6e 2c 20 72 65 74 75 72 6e 69   a coin, returni
1640: 6e 67 20 65 69 74 68 65 72 20 30 20 6f 72 20 31  ng either 0 or 1
1650: 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 61 20   according to a 
1660: 70 72 6f 62 61 62 69 6c 69 74 79 0a 20 2a 20 40  probability. * @
1670: 70 61 72 61 6d 20 20 7b 6e 75 6d 62 65 72 7d 20  param  {number} 
1680: 5b 6f 64 64 73 3d 30 2e 35 5d 20 4c 69 6b 65 6c  [odds=0.5] Likel
1690: 69 68 6f 6f 64 20 6f 66 20 72 65 74 75 72 6e 69  ihood of returni
16a0: 6e 67 20 31 0a 20 2a 20 40 72 65 74 75 72 6e 20  ng 1. * @return 
16b0: 7b 6e 75 6d 62 65 72 7d 20 20 20 20 20 20 20 20  {number}        
16c0: 20 20 20 20 31 20 6f 72 20 30 0a 20 2a 20 40 65      1 or 0. * @e
16d0: 78 61 6d 70 6c 65 0a 20 2a 20 4e 65 78 75 73 2e  xample. * Nexus.
16e0: 63 6f 69 6e 28 30 2e 31 29 20 20 20 2f 2f 20 72  coin(0.1)   // r
16f0: 65 74 75 72 6e 73 20 31 20 28 31 30 25 20 6f 66  eturns 1 (10% of
1700: 20 74 68 65 20 74 69 6d 65 29 20 6f 72 20 30 20   the time) or 0 
1710: 28 39 30 25 20 6f 66 20 74 68 65 20 74 69 6d 65  (90% of the time
1720: 29 0a 20 2a 2f 0a 65 78 70 6f 72 74 73 2e 63 6f  ). */.exports.co
1730: 69 6e 20 3d 20 66 75 6e 63 74 69 6f 6e 28 6f 64  in = function(od
1740: 64 73 3d 30 2e 35 29 20 7b 0a 20 20 69 66 20 28  ds=0.5) {.  if (
1750: 65 78 70 6f 72 74 73 2e 72 66 28 30 2c 31 29 20  exports.rf(0,1) 
1760: 3c 20 6f 64 64 73 29 20 7b 0a 20 20 20 20 72 65  < odds) {.    re
1770: 74 75 72 6e 20 31 3b 0a 20 20 7d 20 65 6c 73 65  turn 1;.  } else
1780: 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b   {.    return 0;
1790: 0a 20 20 7d 0a 7d 3b 0a                          .  }.};.