Scientific Application Web Server (SAWs) Users Manual

TitleScientific Application Web Server (SAWs) Users Manual
Publication TypeReport
Year of Publication2013
AuthorsOtten, M, Brown, J, Smith, BF
Other NumbersANL/MCS-TM-334

For simulations that run for an extended period of time one often wishes to know the current state of the simulation without constantly logging large amounts of information to files. The Scientific Application Web server, or SAWs, provides dynamic access to data (and the altering of data) in a simulation as it runs. Using a lightweight web server, the SAWs C library is linked with an existing C / C++ /Fortran program and provides RESTful URLs for user selected variables in the simulation. Accessing those URLs returns JSON-represented values of the variables which may then be processed in a multitude of ways. SAWs includes some Javascript code, in .hshsSAWs.js, that calls the RESTful interface and displays the results in a browser. SAWs also provides a sample bash script that access the RESTful interface, in .jbin. Tools like jshon can be used to write sophisticated shell scripts that processes the SAWs data.