README for:  qPlot
Written by:  Joseph A. Huwaldt <jhuwaldt@mac.com>
Version:  1.4.1
Date:  March 24, 2026
Web site:  http://thehuwaldtfamily.org/java/Applications/qPlot/qPlot.html


qPlot is a Java program that can read tabulated data in various formats and quickly and easily create interactive plots of that data. The emphasis of this program is on the "quick and easy" part, not on making the prettiest plots or on having a lot of features. qPlot can read ASCII files with tab, comma or space delimited columns of floating point numerical data with an optional header on the 1st line defining the names of the columns and an optional 2nd line defining the units of each column. The table files optionally be gzip compressed. Multiple sets of data containing the same parameters (columns) can be overlaid to make comparisons. When plotting only a single data set, multiple parameters (columns) can be overlaid to make comparisons. Through the use of a "Plot Definitions File", pre-defined plots can be defined with custom unit conversions and labels. Plots can be exported to PNG image files or SVG vector graphics files. The plotted data can be exported to tab-delimited ASCII files or Matlab V4 array files.

Historically, this program was originally written to plot the output from the NASA trajectory analysis codes POST and OTIS. However, it can be used to plot a wide range of data stored in simple tab or comma delimited text files.

File formats that can be plotted with this program include:
* Tab, comma, and space delimited ASCII files with an optional header line followed by an optional unit line.
* POST ASCII and binary PROFIL output plot files
* OTIS output plot files
* MATLAB v4 array files
* NASA TREETOPS/CLVTOPS ASCII output files


Revision History:
Version: 1.4.1 24-MAR-2026
* Tab delimited files now ignore any blank lines and any content following a "#" comment character.

Version: 1.4.0 13-FEB-2026
* Added the ability to read Matlab Level 5 files (V5, V6, and V7).
* Improved the Matlab Level 4 (V4) reader/writer to be compatible with files that contain multiple 1D arrays (one for each parameter).

Version: 1.3.5 09-FEB-2026
* Fixed an issue with identifying NaN's in some tab delimited files.
* Added ".profila" as a type of tab delimited ASCII file.

Version: 1.3.4 26-JAN-2026
* Fixed an issue with reading CSV files that have spaces or commas in the header line.

Version: 1.3.3b 05-FEB-2025
* Fixed an issue with running on MacOS 15.1. Other OS versions are unchanged.

Version: 1.3.3 28-MAR-2024
* Modified to add support TREETOPS device outputs (this had been missed earlier somehow).

Version: 1.3.2 27-MAR-2024
* Modified to support recent versions of TREETOPS that have added mass properties outputs.

Version: 1.3.1 20-JAN-2024
* Modified to remove the seriously out of date MRJAdapter and Bare Bones Browser Launcher libraries and replaced them with the now standard java.awt.Desktop class.
* Modified MacOS application bundle to work better on modern versions of MacOS.
* The MacOS version has a Java 11 compatible JRE bundled with the application (you do not need to have Java installed to run this version).
* Created a new application icon.

Version: 1.3.0 08-MAR-2023
* Updated underlying unit package (jsr275_0.9.4_mod2) to recognize additional unit abbreviations in plot definition files.  New abbreviations include: "degF" for degrees Fahrenheit, "degC" for degrees Celsius and "degK" degrees Kelvin.

Version: 1.2.2 06-JAN-2022
* Updated underlying unit package (jsr275_0.9.4_mod2) to recognize additional unit abbreviations in plot definition files.  New abbreviations include: "nd" for non-dimensional, "hr" and "hrs" for hour, and "kft" for kilo-feet.

Version: 1.2.1 10-OCT-2020
* Fixed a bug with an underlying library (MRJAdapter) that wasn't compatible with recent versions of Java (Java 15 in particular).

Version: 1.2.0 23-NOV-2019
* Added the ability to reload the selected data from the file it was originally loaded from.  This makes it a lot easier to view changes in data files that are being updated dynamically.
* Improved the error messages received when reading a TREETOPS data file.

Version: 1.1.0 21-MAR-2017
* Added the ability to read and plot NASA TREETOPS/CLVTOPS data files.

Version: 1.0.0 11-MAR-2017
* First public release of qPlot

Version: 0.0.1 3-SEP-2011
* First development version of qPlot created for plotting POST and OTIS data files.

Version 0.0.0 MAY-2003
* Predecessor to qPlot named "DataReader" created.  DataReader contained some of the same tabular data reading and plotting capabilities.


Legal notice:
qPlot Java program for quickly plotting tabulated data.
Copyright (C) 2011-2025, Joseph A. Huwaldt <jhuwaldt@mac.com>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. Or visit the Free Software Foundation's web site:
    http://www.gnu.org/copyleft/gpl.html

Some of the code for this program is protected by the GNU Lesser General Public License. You can find a copy of this license included with the program and with the source code.

Some of the code for this program is protected by the Apache License (http://ant.apache.org/license.html). You can find a copy of this license included with the program and with the source code.

The source code for this program is available for download here:
http://thehuwaldtfamily.org/java/Applications/qPlot/qPlot.html

Feel free to contact me if you have any problems or questions about this program.

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
