Qtran version 3.6.3 is derived from QSAS 2.4.13 pre-release.
By default files are produced in the locally installed cdf version.

This version is available for Solaris (source), Linux (source), Windows(binary and source) and Mac OSX (binary and source)

Qtran converts files between the following formats...

• NASA CDF ( .cdf, specifically ISTP, CSDS, CAA and Themis designs)
• Cluster Exchange Format (.cef for the Cluster Active Archive)
• Tabular flat ASCII files (.qft)
• Delimited flat ASCII files (.qfd)

Qtran is maintained by the Space and Atmospheric group in the Physics Department at Imperial College London as part of our role in the Cluster Science Centre within the UK. These formats and software, while designed with Cluster in mind, are quite general in applicability.

File Formats and User Documentation

• CEF files comply with the Cluster Active Archive standard file format, DS-QMW-TN-0010.
• CDF files will comply with the CSDS standards, DS-QMW-TN-0003 for syntax and metadata.
• Flat files will satisfy the conditions laid down in the QSAS flat file description, CU-QMW-TN-0011.

Obtaining Qtran

Qtran is available as a compressed tar file containing source and documentation.
The Windows version also contains a Windows batch (.bat) script to allow running without
a command line (edit the Qtran.bat file and double click, diagnostics are written to file qtranlog).

• Qtran source
• Qtran Mac OSX (recommended)
  
• Qtran Windows (Note: under windows CEF files have Windows Native end of line.)

Compiling Qtran

On Solaris and Linux platforms, cd to src in the Qtran directory and edit the makefile to locate the local CDF installation.

Qtran is designed to work with CDF version 3.1 or later, but the backward compatibility flag is set to ensure it writes files that can be read by cdf 2.7 onwards.  The restriction of using 3.1 onwards is to allow reading of Themis data files that use epoch16 which is not available in earlier versions.

To compile Qtran type 'make' at the prompt.

This will compile the Qtran executable and place it in the top level Qtran directory.

On Apple Mac machines, download the Qtran.dmg installer and double click the Qtran package icon.

Running Qtran

Once installed, typing Qtran without any arguments will produce a description of options.

Without any options (and just a filename as argument) Qtran will attempt to create a CDF file, unless the input file is a cdf file, in which case it will create a Cluster Exchange (.cef) file.

Options, if set, specify the input and output format, control whether an existing file will be overwritten, toggles record numbering, and specify verbose messages. See also the Mac specific readme file after Mac OSX installation.

NOTE: if the package will not install on a Mac or will only install 0 bytes, it may be necessary to delete the receipt from an earlier Qtran installation - delete the file /Library/Receipts/Qtran.pkg.

Qtran is 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.

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