Imperial College London


QPEACE: Cluster PEACE Data Handling Suite


QPEACE current version is 3.6.1a [7 October 2008].
QTMC current version is 1.2.0 [20 July 2007].

QPEACE version 3.6.1a differs from version 3.6.1 only because the binaries have been recompiled against newer versions of the IDFS libraries. Those versions correct a bug that led to erratic behaviour in the fetching of data and calibrations, with the result that identical inputs to qpeace did not result in identical outputs. Note that if you need to build QPEACE modules from source, you will first need to contact sddas.org and request an up-to-date IDFS bundle. QTMC has not (yet) been recompiled against these new IDFS library routines.

QPEACE is a suite of software designed for use with the data from the PEACE (electron) instrument on the Cluster mission. Dr. Andrew Fazakerley, MSSL, is the Principal Investigator of the PEACE instrument. It is highly likely that the software would also work for other sweep-structured IDFS virtual instrument once the appropriate instrument names were added to the user interface.


Requirements

If you wish to download and run the binary applications, there are no licensing restrictions to worry about, although you will need access to an IDFS database which holds the data of interest. You will also need a local, working copy of SDDAS (www.sddas.org) to interface with, and retrieve data from, this database. If you wish/need to build the software from the source files, you will need to install local versions of IDFS, PGPLOT, and Qt paying appropriate attention to licensing matters.

QPEACE is written mainly in C, with Qt widgets in C++. It is compiled using gcc/g++ and built routinely on Linux and platforms. SDDAS should be installed from www.sddas.org.

There are no plans to port QPEACE to Windows or MacOS platforms. Anyone wishing to attempt this is welcome to try. A MacOs version is available from sddas.org. SDDAS, CDF and Qt support Windows and MacOs. Pgplot is available in (FORTRAN + C wrappers) source but will need to be able to serve X-windows unless plot files (gif or postscript) are adequate. SDDAS bundles of qpeace applications are available from SwRI.

Currently, qpeace software has not been successfully built in 64-bit mode; this appears to be an issue with the interfaces to the underlying idfs code..


Components

At present there are four components to QPEACE:
 
Component Documentation and Screenshots Description
QPEACE Modules QPEACE Doc A collection of routines, including a small number of higher level routines, to access, manipulate, and display data from PEACE energy sweeps, pitch angle distributions, and 3D spins. These routines would be suitable for further specialised software modules
QJAS QJAS Doc An application to generate time series spectograms of (typically) pitch angle distributions based on an original plot design by J-A Sauvaud (CESR, Toulouse). A stack of spectrograms is produced, one for each energy level. Within each spectrogram, the pitch angle information (0->180 degrees) is displayed. QJAS will also accept 3D data, in which case the angle information is based on the polar look directions of the sensors. Sequences of angle-energy (pitch angle) wheels and 1D cuts can also be generated and turned into animated images. QJAS will output these data products into ascii or CDF files which conform to Cluster/ISTP standards.
PLOTAZ PLOTAZ Doc An application to select a pair of azimuthal slices from a 3D distribution (or the equivalent single slice from a pitch angle distribution) and plot them in a 2D "wheel" plot. PLOTAZ also provides further analysis capability to perform arithmetic on the two selected slices (add, subtract, multiply, divide) or to take 1D cuts of any of the original or derived distributions. Finally, the distributions can be "mapped" using Liouville's Theorem with specified potential and magnetic field conditions.
QTMC
QTMC Manual
A programme suite (command line or gui-driven) to "correct" PEACE onboard moments for the effects of spacecraft potential and finite energy limits.

Download

Qpeace_linux tar'ed bundle of Linux binaries, source code, and full documentation for Qpeace modules, qjas, and plotaz components
Qpeace_solaris V 2.67 tar'ed bundle of Sun/Solaris binaries, source code, and full documentation for Qpeace modules, qjas, and plotaz components. Solaris builds are no longer kept up-to-date. Users should fetch and build the linux sources, modifying the build script as necessary.
qtmc
separate bundle of qtmc source and linux binary. An Intel Mac version has been built by Andrew Lahiff. You can get that from here: Intel Mac QTMC
qtmc cal files
most recently available calibration files (gain factors)


Authors

QPEACE is written by Prof. Steve Schwartz who is a PEACE Co-Investigator.

QPEACE was developed as part of the Cluster Science Centre within the UK and funded by the Particle Physics and Astronomy Research Council. 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.

QPEACE accesses PEACE data using the IDFS data system. IDFS is written by South West Research Institute (Dr. David Winningham, PI) and has its own licensing policy (see http://www.idfs.org). QPEACE also uses the PGPLOT graphics package (http://www.astro.caltech.edu/~tjp/pgplot/) which, while freely available, is subject to its own license conditions. Finally, the Graphical User Interface is built using the Qt toolkit (http://www.trolltech.com). Qt forms the basis for the KDE Linux desktop environment; QPEACE is built using the Free Edition which is subject to Q Public License and GPL.


Last up-dated 7 October 2008

Send comments and suggestions to s.schwartz@imperial.ac.uk

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