CHARTER CLIENT LIBRARIES
Charter is a Mac OS X application available on the Mac App Store. Charter allows you make realtime charts on data sent to it via a simple UDP protocol. It is pretty easy to send UDP packets from almost every modern programming language with a decent socket library, so you would much probably be able to add a realtime charting functionality to your code.
Here you will find a selection of client libraries (at the present time: Ruby, C, and Arduino), plus the protocol description, so to allow you to implement your own client.
Would you happen to develop libraries for other language, share them! fork, edit and request a pull or - if you don't like GitHub - simply contact me: p4010 at me dot com
The communication protocol is pretty simple and quick. The Charter client listens on a UDP port that by default is 2001, but that can be configured by the user in the application Preferences: the "Graph identifier" entry (defaults to 1) defines the actual port, which is 2000 + Graph identifier.
The allowed commands are:
clearclears the data buffer
closecloses the connection (which must be open on the Charter app, by clicking on the On|Off switch in the toolbar)
- a set of series with common abscissa (x) values: an
scharacter followed by a space, the x value, and the sequence of y values, using a space or tab separator between each number
- a set of series as list of couples
mcharacter followed by a space and a list of
x,yvalues (separated by a comma, no spaces), with a space or a tab between each couple.
namesfollowed by a set of
nis the number of series, sets the labels in the chart legend (i.e. the names of the series). Note that Charter must receive at least one valid data message before it can successfully set the series names.
The Charter application resets the chart every time it gets a message corresponding to a data structure different by the last one, for example a different number of series, or a
s message after a
Currently, the following libraries are available:
- Ruby: complete
- C: almost complete but fully functional (one method missing)
- Arduino: complete (it reads analog input values from an attached Arduino and makes a stripchart)
- Python: complete
- PHP: complete