README for:  jODIE
Written by:  Joseph A. Huwaldt <jhuwaldt@me.com>
Version:  1.0.7b
Date:  February 5, 2025
Web site:  http://thehuwaldtfamily.org/java/Applications/jODIE/jODIE.html


jODIE is a Java wrapper program for the OTIS utility "ODIE".  jODIE can read n-dimensional functional tables from various file formats and convert between them and the native OTIS table format. In addition, jODIE allows you to preview how OTIS will interpret a particular table with various interpolation options by plotting the table data overlaid with how OTIS will interpolate the table.

jODIE works by calling the native FORTRAN program "odie" in the background hiding its complexities from the user.  The source code for a modified version of the ODIE executive program is supplied with jODIE but it requires the full OTIS 4 package in order to compile and run it.  You must replace the standard ODIE that comes with OTIS with this modification and recompile the OTIS package in order to use jODIE. If you do not have OTIS, this program will not be useful!

OTIS stands for "Optimal Trajectories by Implicit Simulation" and is a trajectory analysis and optimization simulation program developed by NASA and Boeing and is used primarily for aerospace applications in the United States.  OTIS and ODIE are products of the United States government and are in the public domain.  OTIS itself is restricted by US Export Regulations (ITAR in particular) and so cannot be distributed by me.  However, the ODIE utility and any tools that work with it are not export restricted.  You can find out more about OTIS here:
https://software.nasa.gov/software/LEW-20403-1


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

Version: 1.0.7 19-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.0.6 09-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.0.5	16-MAR-2017
* Fixed a bug introduced with the last update that prevented the program from reading OTIS table files with the extension "itd".

Version 1.0.4	13-MAR-2017
* Modified OTIS table reader to ignore anything after the 30th column in most of the table header lines.  Some users were putting comments out there.
* Modified CSV table reader to not write out blank lines in the header but instead to write out a single comma.  Recent versions of Excel simply skip the blank lines messing up the format completely.
* Improved an error message output from POST 2 table reader to better explain what really happened.
* Fixed a long-standing bug with the Windows menu getting out of synch with the open windows.

Version 1.0.3	6-SEP-2014
* Modified to change the default OTIS table file extension from "dat" to "itd".  Also fixed a problem when running ODIE would fail for certain numbers.

Version 1.0.2	10-MAY-2014
* Added the ability to load in tables passed to the program via arguments on the command line interface: java - jar jODIE.jar file1.itd file2.itd file3.dat.

Version 1.0.1	27-APR-2014
* Fixed a threading issue that could cause the program to randomly freeze up on some systems (especially Windows).
* Fixed a problem where a Java 7 class was being used in an otherwise Java 6 program.
* Updated to the latest version of JFreeChart (1.0.17).
* The program now requires Java 1.6 (Java 6) or later.

Version 1.0.0	27-NOV-2013
* Initial release of the ODIE program based on TableReader version 1.13.0.


Legal notice:
jODIE -- The OTIS ODIE utility wrapper program.
Copyright (C) 2013-2025, Joseph A. Huwaldt <jhuwaldt@mac.com>

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/jODIE/jODIE.html

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

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
