From 87cbadc3a021b8aafc2ac2678ad60bd1af601395 Mon Sep 17 00:00:00 2001
From: Jake Read <jake.read@cba.mit.edu>
Date: Tue, 19 Nov 2019 18:44:30 -0500
Subject: [PATCH] cleanup and lisc step 2/2

---
 hunks/adhoc/consumer.js                       | 30 ------------
 hunks/comm/devicepipe.js                      |  2 +-
 hunks/comm/serialport.js                      |  2 +-
 hunks/comm/websocketclient.js                 |  2 +-
 hunks/data/accumulator.js                     | 10 +++-
 hunks/data/exfilter.js                        | 10 +++-
 hunks/data/linechart.js                       | 10 +++-
 hunks/data/{log_numbers.js => logNumbers.js}  | 10 +++-
 hunks/data/{logger.js => logReferences.js}    | 15 +++++-
 hunks/data/log_objects.js                     | 48 -------------------
 hunks/data/{open_json.js => openJSON.js}      | 10 +++-
 hunks/data/save.js                            | 11 ++++-
 hunks/debug/bytearrayoutput.js                | 10 +++-
 hunks/debug/timing.js                         | 11 ++++-
 hunks/flowcontrol/consumer.js                 | 38 +++++++++++++++
 hunks/flowcontrol/gate.js                     |  8 ++++
 hunks/flowcontrol/syncawait.js                | 12 ++++-
 hunks/flowcontrol/syncpressure.js             | 10 +++-
 hunks/flowcontrol/while.js                    | 44 -----------------
 hunks/{adhoc => image}/webcam.js              | 10 +++-
 ...{threejs_ghost.js => threejsPathStream.js} |  0
 .../lsq.js => math/leastSquaresFit.js}        |  9 ++++
 hunks/{adhoc => statemachines}/saturn.js      | 10 +++-
 hunks/{adhoc => x_adhoc}/2x_linechart.js      |  8 ++++
 hunks/{adhoc => x_adhoc}/center.js            | 10 +++-
 hunks/{adhoc => x_adhoc}/correlate.js         |  8 ++++
 hunks/{adhoc => x_adhoc}/npath_to_path.js     | 10 +++-
 hunks/{adhoc => x_adhoc}/open-4411-csv.js     | 10 +++-
 hunks/{adhoc => x_adhoc}/open-dex-json.js     | 10 +++-
 hunks/{adhoc => x_adhoc}/tpath.js             | 10 +++-
 30 files changed, 244 insertions(+), 144 deletions(-)
 delete mode 100644 hunks/adhoc/consumer.js
 rename hunks/data/{log_numbers.js => logNumbers.js} (65%)
 rename hunks/data/{logger.js => logReferences.js} (71%)
 delete mode 100644 hunks/data/log_objects.js
 rename hunks/data/{open_json.js => openJSON.js} (69%)
 create mode 100644 hunks/flowcontrol/consumer.js
 delete mode 100644 hunks/flowcontrol/while.js
 rename hunks/{adhoc => image}/webcam.js (75%)
 rename hunks/interface/{threejs_ghost.js => threejsPathStream.js} (100%)
 rename hunks/{calibrations/lsq.js => math/leastSquaresFit.js} (85%)
 rename hunks/{adhoc => statemachines}/saturn.js (97%)
 rename hunks/{adhoc => x_adhoc}/2x_linechart.js (88%)
 rename hunks/{adhoc => x_adhoc}/center.js (85%)
 rename hunks/{adhoc => x_adhoc}/correlate.js (94%)
 rename hunks/{adhoc => x_adhoc}/npath_to_path.js (68%)
 rename hunks/{adhoc => x_adhoc}/open-4411-csv.js (69%)
 rename hunks/{adhoc => x_adhoc}/open-dex-json.js (68%)
 rename hunks/{adhoc => x_adhoc}/tpath.js (77%)

diff --git a/hunks/adhoc/consumer.js b/hunks/adhoc/consumer.js
deleted file mode 100644
index c9030ec..0000000
--- a/hunks/adhoc/consumer.js
+++ /dev/null
@@ -1,30 +0,0 @@
-/*
-
-mimic / prototype steppers downstream, consuming on known timestep
-
-*/
-
-import {
-  Hunkify,
-  Input,
-  Output,
-  State
-} from '../hunks.js'
-
-export default function Consumer(){
-  Hunkify(this)
-
-  let takeup = this.input('number', 'takes')
-  let taken = false
-  let period = this.state('number', 'period', 50)
-
-  this.loop = () => {
-    if(takeup.io() && !taken){
-      takeup.get()
-      taken = true
-      setTimeout(() => {
-        taken = false
-      }, period.value)
-    }
-  }
-}
diff --git a/hunks/comm/devicepipe.js b/hunks/comm/devicepipe.js
index 85af29b..065fd56 100644
--- a/hunks/comm/devicepipe.js
+++ b/hunks/comm/devicepipe.js
@@ -1,5 +1,5 @@
 /*
-comm/devicepipe.js
+hunks/comm/devicepipe.js
 
 pipe transport for an fs.write, appropriate for linux-2-machines, clientside
 
diff --git a/hunks/comm/serialport.js b/hunks/comm/serialport.js
index 1c92a56..624751e 100644
--- a/hunks/comm/serialport.js
+++ b/hunks/comm/serialport.js
@@ -1,5 +1,5 @@
 /*
-comm/devicepipe.js
+hunks/comm/devicepipe.js
 
 transport to ah serialport on the server side
 
diff --git a/hunks/comm/websocketclient.js b/hunks/comm/websocketclient.js
index a39f1c9..70ee70a 100644
--- a/hunks/comm/websocketclient.js
+++ b/hunks/comm/websocketclient.js
@@ -1,5 +1,5 @@
 /*
-comm/websocketclient.js
+hunks/comm/websocketclient.js
 
 pipe to remote websocket server
 
diff --git a/hunks/data/accumulator.js b/hunks/data/accumulator.js
index ed1ce3f..a64096d 100644
--- a/hunks/data/accumulator.js
+++ b/hunks/data/accumulator.js
@@ -1,7 +1,15 @@
 /*
+hunks/data/accumulator.js
 
-gather
+stashes data stream to an array
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/data/exfilter.js b/hunks/data/exfilter.js
index 9795e1a..a2a7631 100644
--- a/hunks/data/exfilter.js
+++ b/hunks/data/exfilter.js
@@ -1,7 +1,15 @@
 /*
+hunks/data/exFilter.js
 
-rolling filter,
+removes old lovers from data streams
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import { Hunkify, Input, Output, State } from '../hunks.js'
diff --git a/hunks/data/linechart.js b/hunks/data/linechart.js
index 1b103f6..d68c099 100644
--- a/hunks/data/linechart.js
+++ b/hunks/data/linechart.js
@@ -1,7 +1,15 @@
 /*
+hunks/data/lineChart.js
 
-simple line chart, talking to array reference
+draws data to line chart
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 // using https://bl.ocks.org/d3noob/402dd382a51a4f6eea487f9a35566de0
diff --git a/hunks/data/log_numbers.js b/hunks/data/logNumbers.js
similarity index 65%
rename from hunks/data/log_numbers.js
rename to hunks/data/logNumbers.js
index 13b2c0c..a74ed33 100644
--- a/hunks/data/log_numbers.js
+++ b/hunks/data/logNumbers.js
@@ -1,7 +1,15 @@
 /*
+hunks/data/logNumbers.js
 
-debugger ! log anything !
+numbers are not references to numbers and so this is a necessary non-violation
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import { Hunkify, Input, Output, State } from '../hunks.js'
diff --git a/hunks/data/logger.js b/hunks/data/logReferences.js
similarity index 71%
rename from hunks/data/logger.js
rename to hunks/data/logReferences.js
index 8218431..70af92c 100644
--- a/hunks/data/logger.js
+++ b/hunks/data/logReferences.js
@@ -1,4 +1,17 @@
 /*
+hunks/data/logReferences.js
+
+logs (almost) anything 
+
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
+*/
+/*
 
 debugger ! log anything !
 
@@ -41,7 +54,7 @@ export default function ReferenceLogger() {
       } else if (typeof raw === "boolean") {
         stringRep = raw.toString()
       } else {
-        // let js do w/e witchcraft it chooses 
+        // let js do w/e witchcraft it chooses
         stringRep = raw
       }
       $(this.dom).children('.txt').html(stringRep)
diff --git a/hunks/data/log_objects.js b/hunks/data/log_objects.js
deleted file mode 100644
index 4c29367..0000000
--- a/hunks/data/log_objects.js
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
-
-debugger ! log anything !
-
-*/
-
-import { Hunkify, Input, Output, State } from '../hunks.js'
-
-export default function ObjectLogger() {
-  Hunkify(this)
-
-  // hmm...
-  let tolog = this.input('reference', 'tolog')
-
-  let prefix = this.state('string', 'prefix', 'LOG:')
-  let logToConsole = this.state('boolean', 'console', true)
-
-  this.dom = {}
-
-  this.init = () => {
-    this.dom = $('<div>').get(0)
-  }
-
-  this.onload = () => {
-    //error here
-    let text = $('<div>').addClass('txt').append('- >').get(0)
-    $(this.dom).append(text)
-  }
-
-  this.loop = () => {
-    // this will be called once every round turn
-    // typically we check flow control first
-    if (tolog.io()) {
-      // an input is occupied, and the exit path is empty
-      let raw = tolog.get()
-      let stringRep
-      if (Array.isArray(raw)) {
-        stringRep = raw.join(', ')
-      } else if (typeof raw === "boolean") {
-        stringRep = raw.toString()
-      }
-      $(this.dom).children('.txt').html(stringRep)
-      if (logToConsole.value === true) {
-        console.log(this.ind, prefix.value, raw)
-      }
-    }
-  }
-}
diff --git a/hunks/data/open_json.js b/hunks/data/openJSON.js
similarity index 69%
rename from hunks/data/open_json.js
rename to hunks/data/openJSON.js
index 0c5ca06..6295bf4 100644
--- a/hunks/data/open_json.js
+++ b/hunks/data/openJSON.js
@@ -1,7 +1,15 @@
 /*
+hunks/data/openJSON.js
 
-open csv, setup outputs for fields (?)
+opens JSON files from user upload
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/data/save.js b/hunks/data/save.js
index 78e666d..af2b3f7 100644
--- a/hunks/data/save.js
+++ b/hunks/data/save.js
@@ -1,9 +1,18 @@
 /*
+hunks/data/save.js
 
-save object from reference, as JSON
+write what-ever to JSON, ship 2 download 
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
+
 import {
   Hunkify,
   Input,
diff --git a/hunks/debug/bytearrayoutput.js b/hunks/debug/bytearrayoutput.js
index 7f127fb..026263c 100644
--- a/hunks/debug/bytearrayoutput.js
+++ b/hunks/debug/bytearrayoutput.js
@@ -1,7 +1,15 @@
 /*
+hunks/debug/byteArrayOutput.js
 
-small byte output utility for phy debugging
+mostly, to unit test routers
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import { Hunkify, Input, Output, State } from '../hunks.js'
diff --git a/hunks/debug/timing.js b/hunks/debug/timing.js
index f38d1da..3cd9a9a 100644
--- a/hunks/debug/timing.js
+++ b/hunks/debug/timing.js
@@ -1,9 +1,18 @@
 /*
+hunks/debug/timing.js
 
-the graph, it's shaped like a V
+gate events, count events while passing thru 
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
+
 import {
   Hunkify,
   Input,
diff --git a/hunks/flowcontrol/consumer.js b/hunks/flowcontrol/consumer.js
new file mode 100644
index 0000000..cf912bb
--- /dev/null
+++ b/hunks/flowcontrol/consumer.js
@@ -0,0 +1,38 @@
+/*
+hunks/flowcontrol/consumer.js
+
+timed consumption of some outupt
+
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
+*/
+
+import {
+  Hunkify,
+  Input,
+  Output,
+  State
+} from '../hunks.js'
+
+export default function Consumer(){
+  Hunkify(this)
+
+  let takeup = this.input('number', 'takes')
+  let taken = false
+  let period = this.state('number', 'period', 50)
+
+  this.loop = () => {
+    if(takeup.io() && !taken){
+      takeup.get()
+      taken = true
+      setTimeout(() => {
+        taken = false
+      }, period.value)
+    }
+  }
+}
diff --git a/hunks/flowcontrol/gate.js b/hunks/flowcontrol/gate.js
index bf30204..a859f4a 100644
--- a/hunks/flowcontrol/gate.js
+++ b/hunks/flowcontrol/gate.js
@@ -1,7 +1,15 @@
 /*
+hunks/flowcontrol/gate.js
 
 thou shall ? pass : not
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/flowcontrol/syncawait.js b/hunks/flowcontrol/syncawait.js
index cfa70a4..5ff50e6 100644
--- a/hunks/flowcontrol/syncawait.js
+++ b/hunks/flowcontrol/syncawait.js
@@ -1,7 +1,15 @@
 /*
+hunks/flowcontrol/syncAwait.js
 
-always on
+release outputs on sync at inputs
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
@@ -31,7 +39,7 @@ export default function Pressure() {
       startup = false
     } else {
       runState.set(true)
-      startup = true 
+      startup = true
     }
   }
   this.states.push(runState)
diff --git a/hunks/flowcontrol/syncpressure.js b/hunks/flowcontrol/syncpressure.js
index 101a540..e9ff013 100644
--- a/hunks/flowcontrol/syncpressure.js
+++ b/hunks/flowcontrol/syncpressure.js
@@ -1,7 +1,15 @@
 /*
+hunks/flowcontrol/syncPressure.js
 
-always on
+synchronous pressure to outputs
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/flowcontrol/while.js b/hunks/flowcontrol/while.js
deleted file mode 100644
index 6315918..0000000
--- a/hunks/flowcontrol/while.js
+++ /dev/null
@@ -1,44 +0,0 @@
-/*
-
-thou shall ? pass : not
-
-*/
-
-import {
-    Hunkify,
-    Input,
-    Output,
-    State
-  } from '../hunks.js'
-  
-  function While(){
-    Hunkify(this)
-  
-    // also wants to be polymorphic
-    let condition = new Input('boolean', 'thru', this)
-    this.inputs.push(condition)
-  
-    let evtOut = new Output('boolean', 'thru', this)
-    this.outputs.push(evtOut)
-  
-    let runState = new State('boolean', 'run', false)
-    this.states.push(runState)
-  
-    this.init = () => {
-      console.log('hello gate')
-    }
-  
-    this.loop = () => {
-      if(runStateIn.io()){
-        runState.set(runStateIn.get())
-      }
-      if(evtIn.io()){
-        if(runState.value && !evtOut.io()){
-          evtOut.put(evtIn.get())
-        }
-      }
-    }
-  }
-  
-  export default While
-  
\ No newline at end of file
diff --git a/hunks/adhoc/webcam.js b/hunks/image/webcam.js
similarity index 75%
rename from hunks/adhoc/webcam.js
rename to hunks/image/webcam.js
index 4cd943f..747f3a2 100644
--- a/hunks/adhoc/webcam.js
+++ b/hunks/image/webcam.js
@@ -1,7 +1,15 @@
 /*
+hunks/image/webcam.js
 
-rct webcam -> rolling imageData
+pull image from webcam 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/interface/threejs_ghost.js b/hunks/interface/threejsPathStream.js
similarity index 100%
rename from hunks/interface/threejs_ghost.js
rename to hunks/interface/threejsPathStream.js
diff --git a/hunks/calibrations/lsq.js b/hunks/math/leastSquaresFit.js
similarity index 85%
rename from hunks/calibrations/lsq.js
rename to hunks/math/leastSquaresFit.js
index d7206e3..fd7ef13 100644
--- a/hunks/calibrations/lsq.js
+++ b/hunks/math/leastSquaresFit.js
@@ -1,11 +1,20 @@
 /*
+hunks/math/LeastSquaresFit.js
 
 input previous system measurements as state (lists)
 make predictions for y based on input at x, with lsq. from old data
 to expand: accept arrays as inputs, from automatic measurements ?
 
+Jake Read at the Center for Bits and Atoms
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
+
 import {
   Hunkify,
   Input,
diff --git a/hunks/adhoc/saturn.js b/hunks/statemachines/saturn.js
similarity index 97%
rename from hunks/adhoc/saturn.js
rename to hunks/statemachines/saturn.js
index 0e19b5b..3ceea15 100644
--- a/hunks/adhoc/saturn.js
+++ b/hunks/statemachines/saturn.js
@@ -1,7 +1,15 @@
 /*
+hunks/statemachines/saturn.js
 
-accel planning for networked controllers
+packet-time aware motion planner for networked controllers 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/2x_linechart.js b/hunks/x_adhoc/2x_linechart.js
similarity index 88%
rename from hunks/adhoc/2x_linechart.js
rename to hunks/x_adhoc/2x_linechart.js
index d1b1faa..4f377bf 100644
--- a/hunks/adhoc/2x_linechart.js
+++ b/hunks/x_adhoc/2x_linechart.js
@@ -1,4 +1,5 @@
 /*
+hunks/x_adhoc/2x_linechart.js
 
 simple line chart, talking to array reference
 
@@ -7,6 +8,13 @@ this should expand to generalize against any # of inputs (state, polymorphic)
 and should have labels, and wrap with some generalized system understanding of data sets ? md ?
 paired / matched sets of array data ?
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 // using https://bl.ocks.org/d3noob/402dd382a51a4f6eea487f9a35566de0
diff --git a/hunks/adhoc/center.js b/hunks/x_adhoc/center.js
similarity index 85%
rename from hunks/adhoc/center.js
rename to hunks/x_adhoc/center.js
index 8fbc5c5..90a9f02 100644
--- a/hunks/adhoc/center.js
+++ b/hunks/x_adhoc/center.js
@@ -1,7 +1,15 @@
 /*
+hunks/x_adhoc/center.js
 
-find pixel space hotspot
+find subpixel hotspot in grayscale image
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/correlate.js b/hunks/x_adhoc/correlate.js
similarity index 94%
rename from hunks/adhoc/correlate.js
rename to hunks/x_adhoc/correlate.js
index 648f6f6..7b0a93d 100644
--- a/hunks/adhoc/correlate.js
+++ b/hunks/x_adhoc/correlate.js
@@ -1,7 +1,15 @@
 /*
+hunks/x_adhoc/correlate.js
 
 attempt for barebones template matching w/ cross correlation dot product
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/npath_to_path.js b/hunks/x_adhoc/npath_to_path.js
similarity index 68%
rename from hunks/adhoc/npath_to_path.js
rename to hunks/x_adhoc/npath_to_path.js
index e88a82d..148a219 100644
--- a/hunks/adhoc/npath_to_path.js
+++ b/hunks/x_adhoc/npath_to_path.js
@@ -1,7 +1,15 @@
 /*
+hunks/x_adhoc/npath_to_path.js
 
-add z-moves for implicit z-moves from neil's path rep
+write z-moves for 3D array from MD array of 2D segs 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/open-4411-csv.js b/hunks/x_adhoc/open-4411-csv.js
similarity index 69%
rename from hunks/adhoc/open-4411-csv.js
rename to hunks/x_adhoc/open-4411-csv.js
index e656b5e..5e50f98 100644
--- a/hunks/adhoc/open-4411-csv.js
+++ b/hunks/x_adhoc/open-4411-csv.js
@@ -1,7 +1,15 @@
 /*
+hunks/x_adhoc/open-4411-csv.js
 
-open csv, setup outputs for fields (?)
+open csv of 4411 data 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/open-dex-json.js b/hunks/x_adhoc/open-dex-json.js
similarity index 68%
rename from hunks/adhoc/open-dex-json.js
rename to hunks/x_adhoc/open-dex-json.js
index c71751e..c5a1d3b 100644
--- a/hunks/adhoc/open-dex-json.js
+++ b/hunks/x_adhoc/open-dex-json.js
@@ -1,7 +1,15 @@
 /*
+hunks/x_adhoc/vectorize.js
 
-open csv, setup outputs for fields (?)
+bridge to the future 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
diff --git a/hunks/adhoc/tpath.js b/hunks/x_adhoc/tpath.js
similarity index 77%
rename from hunks/adhoc/tpath.js
rename to hunks/x_adhoc/tpath.js
index 1ba4b97..ab7ce88 100644
--- a/hunks/adhoc/tpath.js
+++ b/hunks/x_adhoc/tpath.js
@@ -1,7 +1,15 @@
 /*
+hunks/adhoc/tpath.js
 
-testing path output -> saturn
+canned paths, for testing motion control systems 
 
+Jake Read at the Center for Bits and Atoms with Neil Gershenfeld and Leo McElroy
+(c) Massachusetts Institute of Technology 2019
+
+This work may be reproduced, modified, distributed, performed, and
+displayed for any purpose, but must acknowledge the squidworks and cuttlefish projects.
+Copyright is retained and must be preserved. The work is provided as is;
+no warranty is provided, and users accept all liability.
 */
 
 import {
-- 
GitLab