README for:  Supersonic Cone
Written by:  Joseph A. Huwaldt <jhuwaldt@mac.com>
Version:  1.2.5b
Date:  February 5, 2025
Web site:  http://thehuwaldtfamily.org/java/Applications/SupersonicCone/


Supersonic Cone is a Java program that allows you to easily compute some of the properties related to a cone moving through air at supersonic speeds.  The user needs to input any two (of three) inputs and all the other properties will be computed automatically.  For example, if you know the Mach number and cone half-angle, enter those, and the conical shock angle (along with a number of other properties) will be calculated automatically.  Or, you can enter the conical shock angle and the cone angle and the required free-stream Mach number will be calculated.

Technically, this program uses the technique of numerically integrating the Taylor-Maccoll Ordinary Differential Equation (ODE) for supersonic flow past a semi-infinite cone as described in:  Anderson, J., "Modern Compressible Flow with Historical Perspective", McGraw-Hill Publishing Co., 1990, pg. 301.  A 1D root solver is used to back-solve for the input parameters to the Taylor-Maccoll equation.


Installation Instructions:

MacOS:
You should have received this application as a compressed disk image file (SupersonicCone_#.#.#_MacOS.dmg). This disk image file, when mounted (by double-clicking on it), should contain the application icon (Supersonic Cone), this read me file (README.txt), and some license related legalese.

To install this program, simply drag the Supersonic Cone icon to a convenient location on your computer. In MacOS this is usually the "Applications" directory, but you are free to put it anywhere you want.

The application file should work properly on MacOS 14.5 and later right out of the box. No additional software required (you do not need to have Java installed).

On MacOS the security settings will prevent you from being able to run this program since it was downloaded from the internet and is does not have an Apple Developer ID signature (I am not an "identified developer").  After trying to run it the first time and dismissing the warnings, you will need to do the following:

1) Open System Preferences
2) Open Security & Privacy
3) Scroll down to "Security"
4) Find a message saying that Supersonic Cone was prevented from running because it is from an unknown developer and click the "Run Anyway" button.

You should be able to run Supersonic Cone from then on.


Windows:
You will first have to make sure that you have the a Java 11 or later Java Runtime Environment (JRE) installed on your computer.  If you do not, you can get it from: https://www.java.com or an open source version from http://azul.com.

You should have received this application as a ZIP archive file (SupersonicCone_#.#.#_Windows.zip). Uncompress this archive.  It contains an double-clickable JAR file named SupersonicCone.jar, this read me file and some license information.

To install this program, simply drag the SupersonicCone.jar icon to a convenient location on your computer.  It should work from anywhere just by double-clicking on it.


Linux (and many flavors of UNIX):
You will first have to make sure that you have a Java 11 or later Java Runtime Environment (JRE) installed on your computer and on your search path.  If you do not, you can get it from:  https://www.java.com or an open source version from http://azul.com.

You should have received this application as a compressed archive file (SupersonicCone_#.#.#_Linux_and_Others.tgz). After decompressing this file using "tar -xvzf SupersonicCone_#.#.#_Linux_and_Others.tgz", you will get a file named SupersonicCone.jar, this read me file and some license information.  This is a "double-clickable" jar file, or you can run it from the command line using:

java -jar SupersonicCone.jar

You may want to create a shell script to do this for you.


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

Version: 1.2.5 12-NOV-2024
* Fixed an error in the calculation of the static density ratio on the surface of the cone.

Version: 1.2.4 20-DEC-2023
* 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).
* Other minor code improvements.

Version: 1.2.3 10-OCT-2020
* Fixed a bug with an underlying library (MRJAdapter) that wasn't compatible with recent versions of Java (Java 15 in particular).
* Fixed a long-standing problem with the Windows menu getting out of synch with the open windows.

Version 1.2.2     11-JAN-2015
* Fixed a bug that could sometimes occur that would prevent the file dialog from working properly on MacOS X and Linux platforms.
* Fixed a problem with the application bundle not working on recent versions of MacOS X.
* Picked up a large number of code cleanups and updated libraries.

Version 1.2.1     30-JUN-2012
Fixed a bug that prevented the user from entering a number that started with a decimal point.

Version: 1.2.0    18-FEB-2012
Modified to allow the user to input the specific heat ratio of the gas in question (gamma).

Version: 1.1.0    26-JUL-2011
* Corrected a roundoff error.
* Updated to the latest versions of the underlying libraries.
* Replaced Ostermiller Utils with Bare Bones Browser Launch.  Much smaller footprint for the one feature I was using (launching a web browser).
* Ported the program over to the JScience package.
* Modernized the code and improved error messages.
* Developed a new application icon.
* Program no longer requires an installer on Windows or Linux.
* Program now requires Java 1.5 or later.

Version: 1.0.2    29-OCT-2008
Fixed a bug that prevented the program from running on newer versions of MacOS X.  Increased the accuracy of the shock angle solutions output (by tightening the tolerance on the equation solvers used).

Version: 1.0.1    30-APR-2005
Fixed a bug in the calculation of the static pressure ratio (Pc/Pinf).

Version: 1.0.0    07-NOV-2004
Original public release of the Supersonic Cone application.


Legal Notice:
Supersonic Cone is a program for computing the properties of supersonic air flow past a semi-infinite cone.
Copyright (C) 2004-2025,  Joseph A. Huwaldt

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

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

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

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
