Jsbsim

Release files
- Windows 64 bits
- `JSBSim-1.2.1-setup.exe` (Windows installer compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.35026.282))
- Ubuntu Focal 20.04 and Jammy 22.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog

Release files
- Windows 64 bits
- `JSBSim-1.2.0-setup.exe` (Windows installer compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.34114.132))
- Ubuntu Focal 20.04 and Jammy 22.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog

Release files
- Windows 64 bits
- `JSBSim-1.1.14-setup.exe` (Windows installer compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.34114.132))
- Ubuntu Focal 20.04 and Jammy 22.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog
User
* A planet XML definition file can now be loaded using `FGFDMExec::LoadPlanet() ` or the argument `--planet=<filename>` of the JSBSim executable (PR 913)
* The MSIS model of the Earth atmosphere can now be selected instead of the International Standard Atmosphere model (PR 941 and PR 916)
* Added the ability to specify external forces in the inertial frame (PR 962)
* Fixed a bug where the speed of sound could be used uninitialized in `FGPropeller`.
* Fixed a bug where number parsing silently failed due to the decimal separator being set to the comma `,` by the locale while the XML files are using the period `.` (PR 799).
* Fixed a bug where the ambient pressure could reach 0.0 and make JSBSim crash (PR 836 and 839)
* Fixed a bug where the version of an initial conditions XML file could be reported as being infinite. As JSBSim behavior is to default the version to 1.0 when it is unspecified, the version is now set accordingly (PR 845)
* Fixed a bug where the initial value of the wind velocity in the down direction was not converted from knots to ft/sec (PR 855)
* Fixed a bug where the equivalent airspeed velocity (VEAS) was using the local air density instead of the standard sea level density (PR 900 and PR 909).
* Clarified the warning message issued for already defined properties (PR 864)
* The support of Ubuntu Bionic 18.04 has been dropped: JSBSim packages for this version of Ubuntu are no longer released.
* The Windows installer now installs JSBSim in the folder `%LOCALAPPDATA%` by default. In most cases `%LOCALAPPDATA%` resolves to `C:\Users\<user name>\AppData\Local` (see https://github.com/JSBSim-Team/jsbsim/issues/798#issuecomment-1367524670 for details).

Distributed flight dynamics models
* New aircraft 787-8 and global5000 have been added to the models distributed with the Python module.
* The roll autopilot of `c172x` has been fixed

Python module
**This is the last release of JSBSim that supports Python 3.7.**
Python 3.7 has reached its end of life and is no longer supported by the Python Foundation (see [PEP537](https://www.python.org/dev/peps/pep-0537/)). Please upgrade to Python 3.8 or higher.
* Python wheels for Python 3.12 are now available.

Aeromatic++
* Better handling of input errors or inconsistencies to avoid erroneous outputs such as negative point masses (PR 860 and PR 954)

Developer
* The year in copyright notices in files `*.in` that are distributed by the Python module are now automatically updated.
* The Python docs can now be generated even if the JSBSim module has been installed by `pip` rather than having been built locally.
* Fixed a debug message in `FGActuator` that reporting a pointer address rather than the name of the `<lag>` element.
* Removed the `BASE` flag from `string_utilities.h` (PR 837)
* Fixed `include` of `expat.h` (PR 838) to avoid build failure for some compilers.
* Unit tests have been added for the following class: `FGAtmosphere` (PR 857)
* Improved the build process of the Python module by avoiding mutual dependencies of the CMake process and the `setup.py` script (PR 866)
* Moved the Mach/VCAS conversion methods to `FGAuxiliary` (PR 898).
* Simplified the class `FGLGear` by removing its inheritance from `FGSurface` (PR 884) and removed dead code from `FGSurface` (PR 907) in the process.
* Python wheels are now uploaded to PyPI using a [Trusted Publisher](https://docs.pypi.org/trusted-publishers) (i.e. our GitHub project) rather than the less reliable pair of password/username.
* `FGAtmosphere` properties can now be unbound to allow switching the atmospheric model (PR 902 and PR 908)
* Some maintenance and minor changes (PR 952)
* Fixed some bugs in the CMake files
* C++ Source files were duplicated in the folder `python/`
* Use `choco install` in replacement of `cinst` which is no longer recognized on recent Windows runners.

Release files
- Windows 64 bits
- `JSBSim-1.1.13-setup.exe` (Windows installer compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.33027.164))
- Ubuntu Bionic 18.04 and Focal 20.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog
User
* The license of *libexpat* is now included in the Windows installer and in the Python wheels.
* Input sockets that were broken on Windows have been fixed.
Python module
* The Python script `JSBSim` has been renamed `JSBSim.py` and now has the same features than the binary executable `JSBSim.exe`.
* Fixed the data folders that are installed along with the Python module: some aircraft sub-directories `System` and `Engines` were missing in the previous release (issue 687)
* Python wheels for MacOSX are now provided as *universal* binaries for Python `>=3.8` which allows using these binary wheels with Apple Silicon chips.
* Python wheels for Python 3.11 are now available.
* JSBSim Python module is now installed under a single folder including the licenses and the aircraft data. In the previous release, the files were scattered among several folders. This allows a cleaner installation and removal (PR 755).
* Type hints are now provided along with JSBSim Python module (as per PEP 561 and PR 756).
* Usage of uninitialized instances of JSBSim classes now throws an exception to avoid a crash of the Python interpreter.
* `eTemperature` and `ePressure` are now derived from the Python module `enum`.
* Some internal methods are no longer accessible. Their names were prepended by the double underscore `__` which according to Python programming guidelines are meant to be private methods. So you were warned !
MATLAB S-Function
* By default, the S-Function is now compiled using the flag `JSBSIM_STATIC_LINK` since JSBSim is supplied as a static library in the Windows installer (PR 735).
Developer
* Removed the `Messages` feature as it was unused and was using a `static` member that could lead to a segmentation fault when using several instances of `FGFDMExec` (issue 666)
* Restored the automatic rebuild of the Python module that should occur when the headers included in `jsbsim.pyx` are modified.
* Replaced `CMAKE_SOURCE_DIR` by `PROJECT_SOURCE_DIR` to allow JSBSim being built using CMAKE FetchContent (issue 684)
* The dependency to the `win32api` module has been removed to build JSBSim Python module on Windows.
* Random number generation is now made using C++11 standard library. This allowed removing another `static` member (issue 666)
* Fixed a bug that prevented building JSBSim as a DLL using the MinGW compiler (issue 719)
* Unit tests have been added for the following classes: `FGRealValue`, `FGParameter`, `FGParameterValue`, `FGCondition`.

Release files
- Windows 64 bits
- `JSBSim-1.1.12-setup.exe` (Windows installer compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.32602.291))
- Ubuntu Bionic 18.04 and Focal 20.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog
User
* Improvements to the `<table>` element:
* Better error handling and improved messages when an error is found.
* `<table>` now accepts 1x1, 1xN and Nx1 shapes (issue 185).
* The XML schemas for scripts and systems have been updated to match the most recent JSBSim features.
* Accelerations with respect to the ECI frame (and expressed in the body frame) are now exported by the properties:
* `accelerations/uidot-ft_sec2`
* `accelerations/vidot-ft_sec2`
* `accelerations/widot-ft_sec2`
* Rotational accelerations with respect to the ECI frame (and expressed in the body frame) are now exported by the properties:
* `accelerations/pidot-rad_sec2`
* `accelerations/qidot-rad_sec2`
* `accelerations/ridot-rad_sec2`
* Clarified the legal notice as well as the license used by JSBSim and its dependencies.
* Temporary fix for issue 654: the balloon content can no longer reach 0.0 moles.
* The example script `scripts/weather-balloon.xml` now display the burst event.

Python module
* The minimum Python version is now 3.7
* The dependency of the Python module to `setuptools` has been removed.
* Fixed issue 611 - extra arguments can now be added to the constructor `__init__` of a class inheriting from `FGFDMExec`.
* Fixed issue 641 - the method `FGFDMExec.get_property_catalog()` no longer has arguments to match the signature of its C++ counterpart.

MATLAB S-function
* The documentation `matlab/README.md` for the MATLAB S-Function has been improved.
* Added MacOS build instructions
* Documented the version of MSVC used to compile the JSBSim library
* Added MacOS compile line for MATLAB S-Function in the script `JSBSimSimulinkCompile.m`
* Allow two engines
* Overrode script control through SFunction input
* Control input on scripts only when allowed
* Added XML script to config the I/O ports of s-function
* Added error handling and dynamic update of I/O ports
* Created optional second input for wind/turbulence
* Added read/write checks for nodes
* Weather input now loaded to JSBSim
* Updated simulink model `ex737cruise.slx` and `ex737cruise_io.xml`.

Aeromatic++
* Overhaul of the propeller code, the produced tables now matches published data quite close.
* Created a configuration file in metric units when the parameters are entered in metric units.
* Added the option to save the aerodynamics section and the external-force section into separate files.

Developer
* The Python module shall now be compiled with `setuptools>=60.0.0`
* Migrating the front-end of the Python module build process from `setuptools` to `build` (work in progress)
* The Python source package now includes the Cython source code `jsbsim.pyx` instead of the Cython output `jsbsim.cxx`. This allows having consistent input data if the local version of Cython is different than the one used by JSBSim while building the source package.
* Added an `.editorconfig` file to set coding conventions for editors.
* Progress has been made on the migration from `distutils` to `setuptools` (still work in progress).
* The JSBSim library can now be built as a DLL on Windows.
* JSBSim now builds and uses [libexpat](https://github.com/libexpat/libexpat) 2.4.8 (unless explicitely requested to use the system `libexpat` library).

Release files
- Windows 64 bits
- `JSBSim-1.1.11-setup.exe` (Windows installer)
- Ubuntu Bionic 18.04 and Focal 20.04 - amd64
- `*.deb` (Debian packages)
- Python wheel packages can be installed from [PyPI](https://pypi.org/project/JSBSim/) with the command `pip install jsbsim` or `pip install --upgrade jsbsim` when JSBSim is already installed on your system.
- Conda packages are available from [conda-forge](https://anaconda.org/conda-forge/jsbsim). To install this package with conda run: `conda install -c conda-forge jsbsim`

Changelog
User
**This is the last release of JSBSim that supports Python 3.6.**
Python 3.6 has reached its end of life and is no longer supported by the Python Foundation (see [PEP494](https://www.python.org/dev/peps/pep-0494/)). Please upgrade to Python 3.7 or higher.
- Output files are now written in the current directory instead of being written in the aircraft folder (issue 337)
- The uninstall of Python wheels now completely removes the directory structure that was created during the installation of the aircraft data.
- A new exception `TrimFailureException` is now thrown when trim fails. This eases the detection of the trim failure (previously the exception message needed to be checked).
- An exception is thrown when a latitude higher than 90 degrees is supplied to a `<waypoint>` control element (PR 536)
- Fix the sign of the initial NED climb rate (property `ic/gamma-deg`) (PR 545)
- JSBSim now checks malformed data in `<table>` elements. Anything different than numbers and spaces/tabs will be rejected.
- Usage of `<location>` and `<orientation>` in engines is now officially dropped (PR 559, 561 and 563). These elements were deprecated long ago in favor of the corresponding elements `<location>` and `<orientation>` in thrusters. Therefore the code removed is no-op.
- The computation of the initial rotation rates has been fixed (Issue 553). Previously, the rotation rates could be initialized with extremely high values when the vehicle was spawned over the Poles. And for a given set of initial conditions, the initial rotation rates could have different values depending on the initial latitude at which the vehicle was initialized. This now fixed.
- [Windows] The script `JSBSimSimulinkCompile.m` that builds the MATLAB S-function is now set to be executed immediately after the installer `JSBSim-setup.exe` has been run and no longer need manual updates before being run.
- The precision with which values are transmitted thru a socket can now be set via the attribute `precision` such as `<output precision="8">` (PR 579)

Developer
- Added 2 new methods to `FGFDMExec`: `SetOutputPath` and `GetOutputPath` to specify the path to which the output files will be written.
- Python method `FGFDMExec.set_root_dir()` no longer alters the aircraft, engine and system paths. This is now the same behavior than its C++ counterpart `FGFDMExec::SetRootDir`.
- All JSBSim exceptions now inherit from `JSBSim::BaseException`. There still exist `std::string` exceptions thrown by JSBSim. Cleanup is still in progress.
- JSBSim no longer calls `exit()` or `abort()`. Exceptions are thrown instead. This gives the calling application an opportunity to gracefully recover.
- The MATLAB S-Function is now tested on Windows and MacOSX in addition to Linux.
- As `distutils` will be deprecated for Python 3.11, the migration to `setuptools` has been started. There are still a number of `distutils` features which have no equivalent to `setuptools` so this is work in progress.
- Improved the ability of `setup.py` to be executed on multiple platforms (removed some hardcoded statements)
- `SGPropertyNode:getName()` is no longer used as it has been dropped from the official SimGear library. This allows remaining compatible with FlightGear.
- When `<input>` and `<output>` elements are read from a file, JSBSim now checks that the file can be read before reading it, otherwise an exception is thrown. This avoids SEGFAULTs.