README for:  AeroLS Lifting Surface Aerodynamics Analysis
Written by:  Joseph A. Huwaldt <jhuwaldt@mac.com>
Version:  1.2.2b
Date:  February 5, 2025
Platforms:  MacOS, Windows, UNIX
Web site:  http://thehuwaldtfamily.org/java/Applications/AeroLS/AeroLS.html


AeroLS is an aerodynamic lifting surface analysis program. This means that it computes the effects of air flowing around thin (planform and camber only, no thickness) wings which are operating at a small angle of attack and sideslip in flow that is subsonic, steady, inviscid, and irrotational. AeroLS can be used to analyze any number of different lifting surfaces at a time, but cannot analyze the effects of bodies such as fuselages in combination with wings.

A user's guide explaining how to use the program and theory manual explaining how it works in some detail are provided with the software.

Installation Instructions:

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

To install this program, simply drag the AeroLS icon to a convenient location on your hard drive. 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 AeroLS was prevented from running because it is from an unknown developer and click the "Run Anyway" button.

You should be able to run AeroLS from then on.


Windows:
You will first have to make sure that you have a Java 11 JRE or later installed on your computer.  If you do not, you can get it from:  https://www.java.com

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

To install this program, simply drag the AeroLS.jar file to a convenient location on your hard drive.  It should work from anywhere.  Just double-click on this JAR file to run the program.


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

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

java -jar AeroLS.jar

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

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

Version: 1.2.2 21-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).
* Fixed some user interface bugs.

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     27-JUN-2015
This update resuscitates this venerable program and modernizes much of the code base just enough that it can run on modern operating systems.  This update changes the package used for units, and fixes a number of user interface bugs.  This is also the first release that does not require an installer on Windows and Linux/UNIX.  However, the core code is unchanged and there are no new features.

Version 1.1.0     27-MAY-2004
* Started using a new library that improves MacOS X integration.  As a side-effect, the application on any platform can now have multiple main application windows open at a time and there is a "Windows" menu that can be used to navigate between all open windows.
* Switched to a new installer that works with Windows XP.

Version 1.0.0     21-DEC-2002
First public release of the AeroLS program.


Legal notice:
AeroLS is a lifting surface aerodynamic analysis program.
Copyright (C) 2002-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://homepage.mac.com/jhuwaldt/java/Applications/AeroLS/AeroLS.html

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

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
