Web server and monitoring console for the Neuro-Sand-Cube environment
The Neuro-Sand-Cube (NSC) is a cyber-physical system (CPS) based on an augmented version of the Platinum Arts Studio Sandbox, which is itself based on the Cube 2 engine. It was designed to assist neuroscientists with CPS-based research.
This console runs independent of the CPS and displays real-time event data streaming out of the NSC
No security is desired or implemented. The intention is ease-of-use above all. Therefore, the console is designed for operation inside private networks only.
Theunis Kotze
Jonathan Friedman, PhD
To run the web server, nodejs needs to be installed.
With nodejs installed, issue the following command in the directory where you cloned Neuro-Sand-Cube-Console to take care of all the remaining dependecies:
> npm install
If you are going to edit coffeescript code, you will need to install coffeescript:
> npm install -g coffee-script
A batch script is included:
> CLICK_ME_TO_START.bat
The above commands compiles the required source and starts a web server, which connects to a Neuro-Sand-Cube server on host:port (default = localhost:12345). The server will continuously attempt to connect, until a connection is made.
Once the server is up and running, clients on the network can connect to the webserver via http on port 8000. For example, to connect to the server from the same machine, the user would enter http://locahost:8000 into a web browser. If the server is hosted on a computer with the domain name network-pc, the user would enter http://network-pc:8000 into the browser.
The Neuro-Sand-Cube-Console displays state information streamed from the Neuro-Sand-Cube server. Via the interface, the user can start a trial. For the duration of the trial, the incoming data from the Neuro-Sand-Cube server is logged to file, which can be downloaded from the console. The user can send commands to the Neuro-Sand-Cube server, as described in the Neuro-Sand-Cube readme.
Note that the computer on which the web server runs acts as client to the Neuro-Sand-Cube server, the client to the web-server does not make a connection directly to the Neuro-Sand-Cube server. This should be kept in mind when setting up the Neuro-Sand-Cube configuration file.