|
|
|
QPEACE: Cluster PEACE Data Handling Suite |
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.
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..
| 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. |
| 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) |
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.
Imperial College London is not responsible for the content of external sites.