Added machine teaching (microsoft#91)

* Added Readme files

* Added BRAINS

Author: PaulStubbs

MachineTeaching/Machine-Calibration/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Microsoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

MachineTeaching/Machine-Calibration/README.md

@@ -0,0 +1,30 @@
+# Motion Calibration Demo
+CNC machines cut metal with spinning tools. Friction reduces precision and periodically demands recalibration. An expert operator must travel to calibrate the machine, repeatedly turn the knobs and take measurements until the machine regains precision.
+
+## LOCAL (CLI) GUIDE
+
+### CLI INSTALLATION
+1. Install the Bonsai CLI by following our [detailed CLI installation guide](https://docs.bons.ai/guides/cli-install-guide.html)
+
+### CREATE YOUR BRAIN
+1. Setup your BRAIN's local project folder.
+       `bonsai create <your_brain_name>`
+2. Run this command to install additional requirements for training your BRAIN.
+       `pip3 install -r requirements.txt`
+
+
+### HOW TO TRAIN YOUR BRAIN
+1. Upload Inkling and simulation files to the Bonsai server with one command.
+       `bonsai push`
+2. Run this command to start training mode for your BRAIN.
+       `bonsai train start`
+   If you want to run this remotely on the Bonsai server use the `--remote` option.
+       `bonsai train start --remote`
+3. Connect the simulator for training.
+       `python3 cnc_simulator.py` or `python cnc_simulator.py`
+4. When training has hit a sufficient accuracy for prediction, which is dependent on your project, stop training your BRAIN.
+       `bonsai train stop`
+
+### GET PREDICTIONS
+1. Run the simulator using predictions from your BRAIN. You can now see AI in action!
+       `python cnc_simulator.py --predict`

MachineTeaching/Machine-Calibration/bonsai_brain.bproj

@@ -0,0 +1 @@
+{"training": {"command": "python3 cnc_simulator.py", "simulator": "bonsai.ai"}, "files": ["*.ink", "*.py", "*.csv", "LICENSE", "README.md", "requirements.txt"]}

MachineTeaching/Machine-Calibration/cnc.ink

@@ -0,0 +1,39 @@
+schema CNCState
+    Float32 error,
+    Float32 time
+end
+
+schema CNCAction
+    Float32{0:1} calibration_adjustment
+end
+
+schema CNCConfig
+    Float32 motor_alignment,
+    Float32 bit_alignment,
+    Float32 slider_alignment
+end
+
+concept machine_calibrator is estimator
+   predicts (CNCAction)
+   follows input(CNCState)
+   feeds output
+end
+
+simulator cnc_simulator(CNCConfig)
+    action (CNCAction)
+    state (CNCState)
+end
+
+curriculum my_curriculum
+    train machine_calibrator
+    using algorithm TRPO
+    with simulator cnc_simulator
+    objective speed_and_accuracy
+        lesson my_first_lesson
+            configure
+               constrain motor_alignment with Float32{5.0:20.0},
+               constrain bit_alignment with Float32{5.0:20.0},
+               constrain slider_alignment with Float32{5.0:20.0}
+            until
+                maximize speed_and_accuracy
+end