Turbmat -- a Matlab library for the JHU Turbulence Database Cluster
See the end of the file for license conditions.
Written by: Jason Graham The Johns Hopkins University Department of Mechanical Engineering firstname.lastname@example.org
This package contains a set of functions that provide a wrapper around Matlab-Fast-SOAP, for querying data from the Johns Hopkins University Turbulence Database Cluster. All communication with the JHU Turbulence Database Cluster is provided through the TurbulenceService Matlab class which uses Matlab-Fast-SOAP to create SOAP messages, query the Turbulence Database, and parse the results. For each database function a wrapper has been created to perform the data translation and retrieval.
More information can be found at: http://turbulence.pha.jhu.edu/help/matlab/
A sample Matlab program is provided by DEMO_turbm.m. To use simply run this program from Matlab. In this program the usage of each Turbulence Database function is illustrated. The program will sample each quantity (i.e. velocity, velocity gradient, etc.) at 10 locations. The returned values will be written to screen. The sample program also generates a contour surface of the velocity magnitude at a random z-plane location.
User specific programs may be created by simply extending the sample program as needed.
This package comes with a copy of Matlab-Fast-SOAP. Matlab-Fast-SOAP is required for performing requests on the database. Turbmat tries to automatically detect the location and version of Matlab-Fast-SOAP by looking at the content of Turbmat's root path. If Turbmat is able to find Matlab-Fast-SOAP, it will include its path, so that the modified callSoapService(), createSoapMessage() and parseSoapResponse() functions become available. If it cannot find Matlab-Fast-SOAP, it will throw an error.
While our service is open to anyone, we would like to keep track of who is using the service, and how. To this end, we would like each user or site to obtain an authorization token from us: http://turbulence.pha.jhu.edu/authtoken.aspx
If you are just experimenting, the default token included in these test files (having a maximum of 4096 points per request) should be valid.
This interface been tested on newer installations of Matlab on various flavors of Mac OS X, Linux, and Windows.
Error handling is performed by the Matlab SOAP communication calls. If a SOAP error occurs during execution of the interface functions, all SOAP error information will be display to the Matlab terminal and the execution will be terminated. We do not currently provide a method for explicit error handling/catching.
This file is part of Turbmat. Turbmat is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Turbmat is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Turbmat. If not, see http://www.gnu.org/licenses/.