WebScan is a browser-based CloudTurbine data viewer. It connects to the CTweb HTTP/HTTPS server to stream selected data sources. View real-time or playback data from one or more numeric, image or text channels. The Demos play recorded data using WebScan; browse them to get a feel for the WebScan interface.
WebScan is available from the WebScan repository on GitHub.
The image below points out some of the WebScan controls and features.
Click the small gear icon in the upper right corner of the screen to pop up the Options Menu. This menu is shown below along with a description of the menu items.
|Smooth||Make smooth plot lines. Not applicable to image or text channels.|
|Fill||Color the area under a plot. Not applicable to image or text channels.|
|View||Duration of data to display in the plot. Not applicable to image or text channels.|
|Plots||Total number of plots to include in the WebScan screen.|
|Columns||Organize plots into this number of columns. Chose from auto, 1, 2, 3, 4.|
|Refresh||Sets the baseline rate at which both real-time and playback (scrolling) data will be updated. Chose from Fast, Normal, Slow. The update rate is adjusted using heuristics and is not a fixed value, but will be relatively faster or slower depending on the Refresh setting. The “Normal” setting should be good for most cases.|
|Scaling||Display scaling for numeric data. Not applicable to image or text channels. Chose one of the following options:
|Save to URL||Create a URL which specifies the current data channels and plot options and put it in the browser’s address bar.|
|Help||Pop up WebScan help documentation in a new browser tab.|
Setup your own CloudTurbine data service
Follow these steps to setup your own CloudTurbine data viewing service using WebScan and the CTweb HTTP/HTTPS server.
We typically setup the program and data files as shown in the figure below. The top-level CloudTurbine folder contains the following:
- CTdata directory, contains CloudTurbine source data; the example below shows one source, SimpleSource, located in CTdata (this is the sample source discussed in Writing CT source apps).
- CTweb directory, contains the WebScan files, available from the WebScan repository on GitHub.
- CTweb.jar, executable for the HTTP/HTTPS server. This application is included in the CloudTurbine release distribution.
With this directory structure in place, start the CTweb server and point a browser at the server’s address. This is done as follows:
Start CTweb server: for the folder structure shown above, cd to the CloudTurbine directory and run
java -jar CTweb.jar
Bring up the WebScan interface: Running on the same computer the CTweb server is running on, bring up the WebScan interface in a browser by going to http://localhost:8000 (where “8000” is the default CTweb server port). View data remotely by using the appropriate IP address or host name in place of “localhost” in this URL.
While it is convenient to “co-locate” CTdata, CTweb and CTweb.jar as shown above, they don’t need to be. You can specify the locations of the CTweb and CTdata folders using options on the CTweb.jar command line.