WaveTrain™ Release Notes

Latest Release: Version 2025A | Category: Software Updates & Documentation

What’s New

MZA is continuously enhancing WaveTrain™ to provide powerful optical modeling and simulation capabilities. Below are the compatibility requirements, key features, and bug fixes included in this release.

Compatibility Considerations

Platform	Supported OS / Environment	Required Software / Compiler
Windows	Windows 10 / 11	Visual Studio 2019 & 2022 MATLAB R2023b or newer (Older Visual Studio/MATLAB versions may work)
Linux	Red Hat Enterprise Linux (RHEL) 9.0 Ubuntu 22.04 LTS	MATLAB R2022b

ℹ️ Note: WaveTrain™ 2025A continues to support legacy builds, but upgrading to supported MATLAB versions is recommended for optimal stability.

New Features & Enhancements

🔹 Optics & Core Capabilities

Incoherent Imaging Components: Added a new set of components based on previous Light Tunneling techniques.
WTC (WTC) (BETA): Introduced a streamlined framework for building and running systems—in some cases eliminating the need for a C++ compiler or MATLAB.

🔹 System & Build Integration

Enhanced Third-Party Libraries: Improved integration by allowing locations to be specified via environment variables, simplifying build setups and improving portability.
Standalone Build Option: Added an option to compile and build projects without MATLAB integration.
Tempus Runset Editor (TRE): Updated the drop-down menu interface for quick build-type selection.

🔹 API & Developers

Dynamic Library Support: Added new build options for generating dynamic library versions of runsets to interface directly with RunsetAPI.
Conductor Application (BETA): Added support for interacting with RunsetAPI builds.
Updated Examples: Provided new sample projects demonstrating updated API and build workflow patterns.

Bug Fixes & Stability

Click to view full bug fix log

Random Number Generation: Fixed an issue where the Gaussian random number generator failed under specific seed initializations.
TRE Execution: Resolved library conflicts that interfered with WaveTrain™ execution from the TRE environment.
Subaperture Calculations: Fixed an issue where aogeom failed to save subaperture locations correctly when the annulus was set to zero.
Polarizer Component: Fixed a bug where an unconnected polarizer component generated false output waves.
TSE Stability: Optimized memory allocation in the TSE to prevent memory leaks and crashes during extended runtime sessions.
Simulation Failures: Resolved an issue where Tilt commands containing NaN values caused simulation crashes.
Platform Warnings: Added an AcsAtmSpec constructor to eliminate “no altitudes defined” warnings when platform and target altitudes are supplied.
MEX Builds: Fixed an issue where building a MEX function directly from the TRE failed.
Thermal Blooming: Resolved a bug where thermal blooming phase shifts were improperly applied to non-heating waves.
MEX Build Scripts: Updated MATLAB script tmxmkdll.m to align with the new build process for MEX functions.
Linker Dependencies: Fixed missing library links on specific user environment configurations.
Kerr Propagation: Corrected extraneous propagation steps during Kerr effect calculations.

Products