There are four basic ways to read data from CloudTurbine files:

  • manually explore the CloudTurbine source folder/files
  • use an existing sink application
  • view data in a web browser using WebScan
  • create your own CloudTurbine sink app using the Java API

Each method is discussed in turn below.

Manually explore the CT folder/files

CloudTurbine data files can be easily explored.  Data is written using the format described in the Structure document.  The name of the top-level folder in a CT source is the name of that data source; under this are several layers of time folders; drilling down through all of these folder layers you will eventually arrive at the lowest layer which contains one or more data files whose names are the source channel names.  Depending on the type of data written out, you may be able to double-click on the data files and view the data – for example, “.jpg”, “.txt” and “.wav” files are probably recognized by your system as image, text and audio files (respectively).

Consider the example shown below.  CTdata is a parent folder which contains one or more CT sources.  SimpleSource is the name of the source shown in this example.  There are 3 levels of time folders under the SimpleSource folder, which eventually leads to data for the output.txt channel.  You can see that there are 2 output.txt files, corresponding to samples are different times.

Manually exploring a CT source can be useful if you need to pick out a particular data point or are just curious about the structure of a CloudTurbine source.  The other methods described below are generally more useful for requesting data over a time range or for viewing data.

Sink Apps

CloudTurbine includes applications for fetching data from CloudTurbine sources.  These can be used as sink utilities as well as programming examples for how to develop a sink application.

  • CTsink: example of a CloudTurbine sink utility; fetches data from all sources and channels which are found beneath a specified “root” folder
  • CT2CSV: converts CloudTurbine files to CSV text files


WebScan is a powerful browser-based CloudTurbine data viewer that works in conjunction with the CTweb HTTP/HTTPS server.  Visit the following pages for further information about using these applications:

  • The Demo & Samples page includes links to several WebScan-accessible data sets
  • See the WebScan app page, which includes steps on how to setup your own CloudTurbine data service using WebScan and CTweb
  • See the CTweb app page, which includes information on running CTweb and using its URL interface to access CloudTurbine data

Read CloudTurbine data using the Java API

You can create a custom CloudTurbine “sink” application which reads CT source data using the CTreader class from the CloudTurbine Java API.  This is discussed in Writing CT sink apps.