Imperial College London



QSAS: Science Analysis Software for Space Plasmas


QSAS current version is 3.1.2

Both Windows and Macintosh versions are complete and self contained. It is no longer necessary to install QT5 or CDF.

QSAS version 3.1.2

QSAS version 3.1.1

QSAS version 3.1.0

QSAS version 3.0.6

Updates at earlier releases are available in the version history.

This branch of QSAS continues the move to a new object handling kernel (DVOS). This is faster than the old kernel (QDOS), will be easier to maintain in the community and is simpler to code against for plugin writing. See DvObjectClass.html for documentation.

Apart from speed enhancements it handles all metadata actions and join intrinsically.

The migration also involves progressively moving to xml savesets. If you have an old saveset (.qss folder) that does not open under the latest release you will need to open it in version QSAS_2_4_13 and re-save (this will convert binary save files to xml). See QSAS 2_4 below.

QSAS is a software package which provides a flexible, extendable environment for the selection, manipulation, and display of space physics data. QSAS is written in C/C++ and is compiled using the gnu compiler set, and makes use of several elements of third-party software, including Qt (http://qt-project.org/downloads), cdf (http://cdf.gsfc.nasa.gov/) and PLplot (http://plplot.sourceforge.net/).

Currently available for Linux, Mac OSX  and Windows.
 


Finding out about QSAS

Other specifications can be found within the various items supplied with QSAS.


Obtaining QSAS

Please email CSC Support each time you download a qsas distribution, stating which version, so that we can keep users informed of changes and monitor levels of interest. QSAS is provided free under GPL public licence, see licence file.

Linux users should download the source distribution which builds itself using a build script (QSAS_3_1/bin/build). Edit the script to give the location of the QSAS distribution after download and the target directory for installing QSAS into, along with QT, and CDF installations on your platform, then type './build qsas' in the bin directory of the distribution:

QSASlinux.tar.gz




Mac OSX users should download the disk image. 

Extract and drag the folder QSAS_3_1 to /Applications.

The first time a new QSAS version is run it may be necessary to open System Preferences -> Security & Privacy
and select 'anywhere' from 'Allow apps downloaded from'. Once QSAS has been launched for the first time this may be restored to your own preferred security settings.


This also contains the full src tree and can be built from the script bin/build in the case of local difficulties.

Launch QSAS on the Mac by double clicking on the QSAS icon /Applications/QSAS_3_1/QSAS.

Contact CSC Support  for earlier versions of the operating system.


Windows
users should download the following archive:

After unzipping, a QSAS31 folder will be created. If you place the QSAS31 directory inside C:\Program Files\QSAS, i.e., so that you have C:\Program Files\QSAS\QSAS31, it is ready to use.
 

Start QSAS by double-clicking QSAS.bat. You can also make shortcuts to this launcher.

If you install QSAS somewhere else, edit the first line of the QSAS.bat script to point to your installation directory. If QSAS launches but instantly dies, try to run this script from within a CMD console to inspect any error messages which may be output. Usually the problem is in the PATH specification, related to the installation location.



On platforms where it does not run out of the box, it is possible to build from source. In which case it will also be necessary to install msys2 (part of the MinGW package) and NASA's CDF libraries, available from:


http://sourceforge.net/p/msys2/wiki/MSYS2%20installation/, 
http://cdf.gsfc.nasa.gov/html/sw_and_docs.html
See the instructions in QSAS31/docs for more details. The msys2 installation will fetch and install both mingw and Qt5 for you, which are the remaining items necessary to build QSAS.



Contact CSC Support  for earlier versions of the operating system.

Documentation


Older Versions of QSAS 2_4  are available and can be used for converting savesets.

Older Versions of QSAS 2_3  are available, but are no longer supported.



Sample Data Files

The QSAS distribution contains some example data from Cluster Summary parameters as well as a sample session.

As well as Cluster Exchange Format (.cef) and NASA Common Data Format (.cdf) files, QSAS is able to read many ascii data files in either tabular or delimited syntax. These ascii files will need headers (either as detached (.qfh) headers or pasted onto the front of the data file itself. To help with the construction of suitable headers, some samples for different data sets are included with the distribution and are also available below, and collectively as a gzipped tar file.

Description
With a few data records
Header only
NASA Omni High Resolution files with syntax omni_hr_format.txt omni_hr.qft omni_hr.qfh
Cluster vector and scalar variable examples in tabular (.qft) syntax CL_SP_FGM_20020328_V01.qft

Cluster vector and scalar variable examples in Cluster Exchange (.cef )syntax CL_SP_FGM_20020328_V01.cef

Cluster vector and scalar variable examples in delimited (.qfd) syntax CL_SP_FGM_20020328_V01.qfd

Cassini data in Cluster Exchange (.cef) syntax
Test_Cassini.cef

Time Interval as a non-record varying variable (with tabular .qft extension)
SampleTI.qft

Event List (list of time intervals) in delimited format
SampleEvents.qfd
SampleEvents.qfh
Event List as XML VOTable file
SampleEvents.xml

 

Plug-in Libraries

Plug-ins written by the QSAS team are distributed with the QSAS tar files, and install automatically at QSAS installation.
Many of the ISSI plugins are also distributed with QSAS precompiled.

Other QSAS plug-ins are also available from ISSI and MPE


Providing Feedback on QSAS

QSAS is built around the prototyping methodology, and continual improvement and enhancement is central to its development. Some enhancements will come via user-written modules which are incorporated via the QSAS plugin interface. The development team welcomes comments, reports of anomolous behaviour, and suggestions which should be sent to: csc-support-dl@imperial.ac.uk.

When submitting a report, please try to be as complete and specific as possible. If reporting a bug it can prove useful if you are able to identify a reproducable sequence of events and a specific data set. The save and restore session facility in qsas 2 can assist in providing feedback since save session directories can be tarred and emailed (save files are platform, independent). The environment variable QSAS_DEBUG can be set "ON" in the user's QSAS script. This prints progress information to the terminal. Sending us the last few hundred lines of this output can also assist in diagnosing problems.
 

·  The binary executables shipped with qsas have the debug symbols stripped from them before distribution. If you wish to run qsas with a debugger, for example when debugging a user written plug-in, then these symbols should not be stripped from a locally built source copy (use "make install" rather than "make install-strip").


Acknowledging QSAS in Publications

The preferred wording for acknowledging use of QSAS in publications is "Data analysis was done with the QSAS science analysis system provided by the United Kingdom Cluster Science Centre (Imperial College London and Queen Mary, University of London) supported by The Science and Technology Facilities Council (STFC)" or similar wording as appropriate.

Authors

This software is maintained by the CSC Team at IC. The team members have included, in alphabetical order, Tony Allen (A.Allen@ic.ac.uk), Stuart Bale, Janet Barnes, Nora Bounaira, David Burgess, Gareth Chisham, Markus Fraenz, Anthony Hare, James Meakin, Alban Rochel, Steve Schwartz (S.Schwartz@ic.ac.uk) and Abdeslam Serroukh. Current team members are shown with an email address. Please address all comments to csc-support-dl.

QSAS is developed as part of the Cluster Science Centre within the UK and funded by the Science and Technology Facilities Council (STFC). The software is provided as is under the GPL public licence, though QM and IC retain the copyright. No liability is accepted for any damage resulting from the installation or use of this software, and no guarantee of its suitability is implied for any use other than the scientific visualisation and manipulation of Cluster science data. Copyright.


Last up-dated 16 November 2016


Send comments and suggestions to csc-support-dl@imperial.ac.uk

Imperial College London is not responsible for the content of external sites.

Return to Cluster Science Centre home page.