QSAS Files

QSAS Version 3.3.x
------------------

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 pre-compiled for Windows and MacOS and supplied as source for Linux.

QSAS uses the free third party package PLplot as its plot engine.

The new version is available via the WWW at the following address:

   https://qsas.sourceforge.io/ or directly from the download page at https://sourceforge.net/projects/qsas/

Complete documentation for QSAS is available at

    https://qsas.sourceforge.io/QSAShelp/QSAS_help_index.html

QSAS is distributed under the LGPL licence, https://www.gnu.org/licenses/lgpl-3.0.en.html

========================================================================

WINDOWS:

QSAS should run out-of-the-box on most Windows platforms by launching the QSAS.bat script. As of version 3.2.1 provided this script is kept in the installation \bin directory it should not require editing by the user. 

Double click on the appropriate .bat will launch QSAS. If you run into problems, open a cmd window, cd to the QSAS bin directory, and type QSAS to launch the batch script and see any run-time error messages. These are almost always related to incorrect PATH setups which can be corrected by editing QSAS.bat.

QSAS ships with a sample session under File->Restore Session... This will get you started. There is a substantial amount of context-sensitive information in the Help pages, accessible from the Help Menu at the top of the QSAS Main Window (which holds the QSAS Working List), and from the top of most QSAS windows.

The Windows version of QSAS is delivered together with standard compiled Qt libraries, thanks to exception 4-a of GPL_EXCEPTION_ADDENDUM.TXT provided by Nokia. You can get the original source on http://trolltech.com/downloads/opensource/appdev/windows-cpp

========================================================================

Mac OSX and MacOS:

On a Mac the download should be extracted (double clicked) and placed in /Applications. Launch QSAS by double-clicking the icon QSAS_3.3/QSAS. You can also drag this icon to the toolbar as usual. 

Alternatively, for users without administor permission, it is possible to install a local version of QSAS in /Users/yourHome/Applications. To do this you must download a different distribution QSAS_33x_local_MacOS.tar.gz and unpack it in your own Applications folder (you may need to create this folder). It will then run as normal by double clicking the QSAS icon in the QSAS_3_3 folder.


========================================================================

Linux:

On Linux it will be necessary to compile QSAS. Edit the file QSAS_3_3/bin/build_linux to set your local paths for QT and CDF, then in the bin directory type './build_linux qsas' at the command line prompt. 


QSAS requires the following third party packages:
QT            https://www.qt.io/developers/
NASA CDF      https://cdf.gsfc.nasa.gov

Note that QSAS uses the svg library in Qt which may not install as part of the default distribution.
If missing it may be added with the commands
sudo apt install libqt5svg5-dev
and
sudo apt install libqt5x11extras5-dev

Note also, that for Ubuntu systems there are additional export paths (provided by Stein Haaland) that will
need uncommenting.

QSAS includes the following third party package which does not need separate installation:
PLPLOT        http://plplot.sourceforge.net

========================================================================

For further information, look at the following files in this directory:

doc/README_Build_Windows.txt		Source installation and build instructions 
COPYING     	            		Copyright notice. Read this!

========================================================================


Please sign up to the qsas_users mailing list on the QSAS sourceforge site to keep informed about new releases. For questions and support, send an email to that list, or contact qsassupp@gmail.com. QSAS is provided free under LGPL public licence, see COPYING file.