An SDK to interface with Wekinator over OSC
|
|
||
|---|---|---|
| .github | ||
| __mocks__ | ||
| examples | ||
| lib | ||
| test | ||
| .gitignore | ||
| CODE_OF_CONDUCT.md | ||
| index.js | ||
| license.md | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| SUMMARY.md | ||
wekinator-node
An SDK to interface with Wekinator, a system for users to build new interactive systems by demonstrating human actions and computer responses, over OSC.
Usage
wekinator-node assumes that an instance of Wekinator is running. It communicates to the running instance of Wekinator via OSC. By default it will use the default host and port, but these can be set via the constructor parameters wekinatorHost and wekinatorPort. Additionally, localPort can be specified to instruct Wekinator to send output messages as documented.
var Wekinator = require("wekinator");
var wn = new Wekinator();
wn.connect(function () {
wn.train();
setTimeout(function () {
wn.disconnect();
}, 100);
});
Another example is available here.
API
wekinator-node supports the Wekinator control messages documented here with the following Javascript method names.
List of methods
WekinatorNodeconstructortakeswekinatorHost, wekinatorPort, localPort [optional]connecttakes acallback- Connects to Wekinator, calls the callback once it's done.
disconnect- Closes the port to Wekinator
inputstakes a list offloats, sets the inputs to them in order- Send Wekinator current input values to populate the boxes/sliders on its GUI. Attach one float per input, in order.
outputstakes a list offloats, sets the outputs to them in order- Send Wekinator current output values to populate the boxes/sliders on its GUI. Attach one float per output, in order.
startRecording- Start recording examples
NOT used for dynamic time warping recording
- Start recording examples
stopRecording- Stop recording examples
NOT used for dynamic time warping recording
- Stop recording examples
startDtwRecordingtakes anumber- Starts recording dynamic time warping examples for the gesture type given by the number
gesture types are indexed starting from 1
- Starts recording dynamic time warping examples for the gesture type given by the number
stopDtwRecording- Stops recording dynamic time warping examples
no int required
- Stops recording dynamic time warping examples
train- Train on current examples
cancelTrain- Cancel current training
if it’s in progress
- Cancel current training
startRunning- Start running
if possible
- Start running
stopRunning- Stop running
if currently running
- Stop running
deleteAllExamples- Delete all examples for all models
enableModelRunningtakes a list ofints- Enables running of all models whose indices are listed in the list of ints in the message. Model indices start with 1. This is equivalent to enabling the “play” button next to a model row.
disableModelRunningtakes a list ofints- Disables running of models with these indices. This is equivalent to disabling the “play” button next to a model row.
enableModelRecordingtakes a list ofints- Enables recording of all models whose indices are listed in the list of ints in the message. Model indices start with 1. This is equivalent to enabling the “record” button next to a model row.
disableModelRecordingtakes a list ofints- Disables recording of models with these indices. This is equivalent to disabling the “record” button next to a model row.
setInputNamestakes a list ofnames- Sets the Wekinator input names to those names, in order.
setOutputNamestakes a list ofnames- Sets the Wekinator output names to those names, in order.
selectInputsForOutputtakesoutput, inputs- Connects a list of inputs to a specific output.
trainOnDatatakes a list of objects with the properties 'inputs' and 'outputs', each of which are arrays of floats like ininputsandoutputs.