jODIE Source Code README
19-JAN-2024

Most of the source code for jODIE is protected either by the General Public License (GPL) or by the Lesser General Public License (LGPL).  Copies of both licenses are provided along with the source code and the header of each source file indicates it's legal status (GPL, LGPL, public domain, or not written by me).

The jODIE source code is mostly pure Java, but it does require a custom version (modification) to the standard odie.f source code that is distributed with OTIS.  jODIE uses a number of open source libraries all of which are included in the source distribution.

jODIE depends on a customized version of the ODIE utility to function properly.  The OTIS code, developed by NASA, is in the public domain. The source code for the customized version of ODIE can be found in the FORTRAN folder in the source distribution.  You must replace the standard ODIE that comes with OTIS with this modification and recompile the OTIS package in order to use jODIE.

jODIE itself is set up to use the Apache ant build system (http://ant.apache.org/).  To build jODIE from the DOS or Unix command line, cd into the jODIE project directory, edit the "build.xml" file for your platform's needs (possibly to remove the MacOS specific build steps if you are not interested in that), and execute the "ant" command.  This will compile the program, place a double-clickable JAR file in the "dist" directory, create a MacOS application bundle in the "dist" directory.

To execute the program, you would execute the following command under Windows (at the DOS prompt) or the Unix command line:

java -jar dist/jODIE.jar

Or double-click on the JAR file found at that location.

On a Mac, you can just double-click on the application found under "dist".

That's all I can think of right now.  If you have any other problems with the source code, don't be afraid to contact me.

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
