Version Windows MacOS Linux Release date
3.004.5 Windows macOS AppImage November 6, 2026

Rat GUI version 3.004.5 is a maintenance release. Versions 3.004.3 and 3.004.4 were not distributed, so these notes cover all changes since 3.004.2. This release holds on to much less memory than 3.004.2, on the GPU and in main memory, and it fixes other reported problems. If you are upgrading from version 2, please also read the notes of 3.004.2 below.

  • Memory
    • Memory leaks fixed, on the GPU and in main memory.
    • A finished run no longer takes up GPU memory.
    • A GPU filled by other programs no longer aborts a calculation with "out of GPU memory".
  • Security
    • Fixes two security issues in the expat XML parser (CVE-2026-115506 and CVE-2026-118370), which affected editions with the network solver module when reading an external field map. See the security assessment.
  • New and changed
    • Larger iron models fit on the GPU: the GPU solver needs about a third less memory.
    • Chinese and Japanese characters in file, model and node names are drawn correctly.
    • Spheres have three element types: refined icosahedron (the default for a new sphere), geodesic and hexahedra.
    • Result windows can show the colormap without shading (View > Effects > Toggle Lighting), so a colour reads as its value on the colour bar.
    • The field of the analytic solenoid far from the coil is much faster to calculate.
    • AI assistants can also connect over HTTP (Scripting > Connect an assistant).
    • Rat GUI can run without a window on the desktop (rat-gui --hidden), for scripts and assistants.
    • Issue reports can carry much larger models.
    • Saved models are standard JSON that any JSON reader opens.
    • Opening a model saved by a newer version asks for confirmation first, and damaged files are handled better.
  • Fixes
    • Quench: calculations with more than one circuit gave NaN for the initial inductance, and the circuit voltage now steps at the protection switch.
    • Windows: Chinese and other non-English file and folder names work.
    • Optimizer: a failed evaluation now always ranks below a valid point, and a search whose start point fails looks for a valid start.
    • Connect v2 connectors: several fixes to the frame and the constraints, and the global search stops by itself.
    • A CCT path in a Frenet-Serret frame no longer builds twisted current leads; an enabled lead shows a warning instead.
    • Result windows and screenshots: several fixes to axes labels, colour bars and tables.
    • An optimizer or calculation running in a model behind the visible tab stays with that model.
  • Results that can change
    • The solver's default maximum tree depth is 20, not 10. Results change only for models where a distant part stopped the tree early, and those runs get faster. A saved model that stored its own value keeps it.
    • The GPU solver uses single precision by default, with results that agree with double precision. It switches to double by itself where a model needs it, and you can choose Double under Solver Settings.
    • A saved sphere keeps the mesh it was saved with. New spheres, and the sphere examples, use the new meshes.
    • The LHC MQY example has a symmetric yoke mesh: the skew harmonics vanish and G is 159.343 T/m (was 159.333). The TEAM 20 example now uses fmm_tol 1e-6.
    • Scripts: initial_inductance of a quench run is now one value per circuit, and a probe's element past the end is an error instead of NaN.

Linux signature file: rat-gui-3.004.5-linux.AppImage.sig

3.004.2 Windows macOS AppImage October 28, 2026

Rat GUI version 3.004.2 is a major release. Every field in the model can now hold an expression, time-dependent models are written as formulas, and Rat GUI can be driven by Lua scripts and, as a free beta, by an AI assistant. It also brings new solvers, help text for every setting, a new look and many fixes.

  • AI assistant (free beta) and Lua scripting
    • An AI assistant such as Claude can work in the running Rat GUI through the new rat-mcp bridge, which is installed with Rat GUI. It builds and edits models, runs calculations, probes results, sweeps parameters and takes screenshots, while you watch the same window.
    • The AI assistant integration is a free beta: it is included with every license at no extra cost while it is in beta. It will keep changing, and your feedback through Help > Report an Issue helps shape it.
    • Scripting > Connect an assistant... shows how to set up the connection for each assistant, and the header bar shows when Rat GUI is listening. The setup instructions, scripts and example configurations are also in the open rat-gui-llm repository on GitLab.
    • An assistant's scripts read and write files only in their output folder, the folders of the open models and the folders you allow under Scripting > Assistant Folders. An assistant can only drive Rat GUI with a valid license that includes the LLM Integration, which every license does during the free beta. A new connection asks for your permission first.
    • Privacy: Rat GUI and rat-mcp send nothing anywhere themselves, but what the assistant reads (models, results, screenshots, files) is sent to its provider, for example Anthropic or OpenAI, as part of your conversation with it. Do not let an assistant work on models you may not share, and switch off Scripting > Listen for LLM when you are done.
    • The same Lua interface is available to you: the Script Console in the application, rat-gui --script on the command line and a built-in reference. Scripts can build models, run calculations and read the numbers behind every result window.
  • Issue reports
    • Help > Report an Issue now has a Send button that delivers the report to us directly and answers with a reference number. If Send cannot get through, you can still send the report by e-mail, copy it or save it.
    • You see the whole report before it goes. It holds the version, the system and what went wrong; your model goes with it only if you tick "attach model data", and your home folder and user name are left out.
    • An assistant that hits a defect can propose a report too. Nothing is sent without your click, and Scripting > Allow agents to report issues switches this off.
  • Expressions, variables, sweeps and the optimizer
    • Every field takes an expression, such as bore / 2 or n_turns * 3 [mm]. Values are checked against their unit, and a field that does not resolve turns orange. A formula bar shows the focused expression with syntax highlighting.
    • Global variables, plus scoped variables in calculations, sweeps, optimizers and functions. Renaming a global renames its uses. Data tables can be edited in their own window, imported from and exported to CSV, or linked to a CSV file. Units can be set to SI or US customary, per dimension and per field.
    • One object can sit in several places in the model tree (Create Link, Ctrl+L): edit it once and every place follows. A For Loop group repeats its models over a list of values.
    • Time is a parameter: a circuit current is written as, for example, 100 [A] + 40 [A/s]*time, and a timeline bar scrubs the viewport. Old Drive objects are converted when a model is opened.
    • Parametric sweep groups sweep any variable over a multi-axis grid, and the result windows scrub through the swept points. Probes extract numbers from results, derived probes combine them, guards reject invalid points, and the Sweep Probes window plots them. A Sweep to VTK group replaces the per-calculation VTK output.
    • A constrained optimizer solves, minimizes or searches over your variables, with bounds and constraints. Search is Local (COBYLA, Nelder-Mead, Subplex, SLSQP, Levenberg-Marquardt), Multistart or Global (MLSL, ISRES, CMA-ES). A seeded run gives the same result on every platform.
    • One function editor for every curve, table and waveform, with a library of templates and a preview.
  • Solvers and performance
    • The nonlinear (iron) solver offers Auto, CHOLMOD (simplicial), MUMPS, SuperLU, cuDSS (GPU), HYPRE AMS and Jacobi. Auto uses CHOLMOD on the CPU at every model size and NVIDIA's cuDSS when the compute device is an NVIDIA GPU (not on macOS). A GPU problem falls back to the CPU with a warning. MUMPS factorizes large models faster, at the cost of more memory.
    • You set an accuracy, not solver knobs: the solver settings are formulas of the accuracy variable fmm_tol, and a calculation can set its own.
    • The MLFMM far-field translation is about three times faster, and results no longer depend on the number of threads. The nonlinear iron solver needs fewer factorizations and a faster near field: whole mesh calculations of the shipped iron examples take roughly 35-60% less time.
    • The viewport rebuilds only what changed, also after undo, redo and paste.
  • Help, tooltips and examples
    • Every setting now has a tooltip, many with a figure. Tooltips can be pinned as their own windows.
    • The user manual is now filled: every object and setting is described, with figures and references. It comes with this release and opens from Help > Manual.
    • The tooltips and the manual were written with the help of AI. They were checked by AI tools against the code and the GUI, but our own human review is still in progress: about a third is signed off in this release, and the rest follows in point releases. If a tooltip or a passage in the manual reads wrong, please send us a report through Help > Report an Issue.
    • The video tutorials on our YouTube channel were made with older versions and are a bit out of date: menus, fields and the way values are entered look different now. New tutorials for this version will follow; until then the manual and the tooltips describe the current interface.
    • About 35 new examples, among them the LHC MQY insertion quadrupole, a CCT harmonics row from dipole to dodecapole, Compumag TEAM 23, an NMR shim, a parametric-sweep example and a CCT sweep-versus-search pair. The example menu is grouped by subject, and every example opens with a note on what it shows and what to try. Several existing examples were corrected and improved; the LHC main dipole now follows CERN's ROXIE model.
  • Calculations, coils and materials
    • The plane window shows the field homogeneity as a dB/B0 map or contours, with a good-field region and summary numbers. The mesh window computes the force from the Maxwell stress tensor, and the inductance calculation gives forces and torques per body.
    • Harmonics default to the azimuthal field component, so local harmonics agree with a point probe in 3D regions too, and problems such as a path that stops inside the field are reported in words. Spherical harmonics offer several normalizations and a noise floor.
    • Cos-theta blocks can use ROXIE's coil-end types and wedge-relative placement, and keystoned cables can carry equal current per strand. Coils separate their source and target settings, and round wires get the exact field inside the wire.
    • New: a Geometry Check calculation, an iron-overlap check before a nonlinear solve, inter-filament coupling losses, stop planes for particle tracking, MgB2 and ARMCO pure iron in the materials library.
  • Look and feel
    • A new header bar with the Rat logo and the version, Material Symbols icons and a new application icon.
    • Refreshed Classic, Darkmatter, Lightmatter and Purewhite themes. Input boxes, checkboxes and buttons have an outline in the Darkmatter and Purewhite themes, and colormaps follow the theme.
    • Shortcuts read Cmd+ on the Mac, and the micro prefix is shown as µm.
    • Result windows: a (?) explains every physical property, Post > Arrange Windows tiles them, tables scroll and plot legends stay clear of the data.
    • Result windows can be saved with their data and their view (units, colour ranges, camera, clipping) as a figure file: one window with Export > Figure File (or Ctrl+S with the window focused), all open windows with Post > Save All Figures. Home > Open Figures brings them back later without recalculating.
  • Robustness
    • Models, exports and screenshots are written to a temporary file first, so a full disk or a power loss leaves the previous file as it was.
    • Counts and sizes are checked before memory is claimed, a mesh that would not fit in memory is refused with the likely cause, and a result that holds NaN or infinity says so. Opening a damaged file can no longer crash Rat GUI, and a license lost during a session comes back by itself.
  • Upgrade notes for existing models
    • Models from v2.024 open in v3.004.2; Drive objects become expressions. A model saved in v3.004.2 does not open in older versions, so duplicate the file first if you may want to keep using the old version.
    • Some results change against v2.024, among others: the Auto source type now uses fixed settings (older files keep their field), the ARMCO B-H curves are extended to 2.15 T, the MLFMM defaults to the mixed interaction list, a permanent magnet under a reflection is now mirrored correctly, the forces of a mesh calculation on iron and magnets are corrected, the NbTi thermal data are corrected, harmonics default to the azimuthal component, the inductance of a round wire on the centerline is about 0.5 % lower (the vector potential is now softened like the field, within 0.1 % of the analytic value), SIMSON imports are fixed, and the shipped harmonics examples use longer paths. Conductor costs are now per volume.
    • Colours are now rendered to match the colour chosen in the colour picker. Custom colours in older models may therefore look darker than before; pick them again if needed.

You can download the Linux signature file here:
rat-gui-3.004.2-linux.AppImage.sig

2.024.6
final v2
Windows macOS AppImage July 24, 2026

The last and final version of Rat GUI 2. Rat GUI 2 receives no further updates. This release is for those who keep using version 2 for now: the window title can be locked, the license server is only contacted from the main thread (fewer license errors), and the centre of the regular polygon (DFRegPolygon) can be edited. Models from 2.024 open in 3.004.2, so you can upgrade whenever it suits you.

You can download the Linux signature file here:
rat-gui-2.024.6-linux.AppImage.sig

2.024.4 Windows macOS AppImage July 09, 2026

This is a patch for Rat GUI version 2.024.2 with minor bug fixes and library updates.

You can download the Linux signature file here:
rat-gui-2.024.4-linux.AppImage.sig

2.024.2 Windows macOS AppImage July 03, 2026

Rat GUI version 2.024.2 includes many changes across visualization, post-processing, import and export, meshing, field calculations, and the nonlinear solver. It also includes a large internal overhaul of the field engine and solver libraries used by Rat GUI.

  • Visualization and post-processing
    • Added an experimental PostVolume post-processor with GPU volume rendering for Cartesian and polar grid fields.
    • Added a new opacity transfer-function editor for PostGrid, PostMesh, PostVolume, and PostTracks.
    • Added colorbar help and close controls, and fixed right-drag zooming on colorbars.
    • Added an independent time bar to PostTracks.
    • Post-processor windows now have icons and can be renamed from the right-click menu.
    • Improved high-DPI handling for the viewport and rendered or exported output.
  • Import and export
    • Added VTU export for inductance matrices.
    • Added CSV export for length tables.
    • Inductance matrix output now groups circuits.
    • Added mgrid export for polar grids.
    • Added a SIMSON importer for Simsopt coil JSON files, including symmetry grouping.
    • Several exports now run on background file I/O threads, so the user interface no longer blocks during file writing.
  • Modeling and physics
    • Expanded force and torque calculations across the modeling stack.
    • Added surface-force-density output for ParaView.
    • Reworked nonlinear field reconstruction. Magnetization is now stored at Gauss points and recovered to the nodes.
    • Added two reconstruction modes, FAITHFUL and SMOOTHED. The default mode is SMOOTHED.
    • Added grid sampling at element centers.
    • Improved magnetic-charge generation from elemental magnetization.
    • Added editor options for CURRENT_MESH source selection, ModelNL softness, and the reconstruction Allow GPU setting.
  • Meshing
    • The node-merge tolerance is now relative to the local element size and is shown as a percentage in the editor.
    • Added fallback sizing for grid, polar, and plane calculations on flat or line geometry.
    • Fixed missing fixed points in distmesh when combining multiple shapes.
  • Performance and GPU support
    • GPU support has been re-enabled and expanded for the MLFMM field step.
    • GPU devices are now selected by device index.
    • GPU settings now flow through the nonlinear solver and field reconstruction.
    • Force, mesh, and export work has been moved off the user interface thread where possible.
    • The field engine and nonlinear solver have received major internal performance improvements for larger models.
  • Upgrade notes for existing models
    • Nonlinear field and force results can change because the field reconstruction method has been improved. In general, the new results should be more accurate.
    • The node-merge tolerance now uses different units and different meaning. Old stored absolute values are ignored. Please re-check this setting in older models.

You can download the Linux signature file here:
rat-gui-2.024.2-linux.AppImage.sig

2.022.2 Windows macOS AppImage May 18, 2026

In short this version includes bug fixes, improved postprocessing capabilities, rendering stability fixes, better DPI handling, workflow refinements, and expanded testing and build maintenance. The changelog is given below.

  • Mesh/postprocessing
    • Fixed a crash when selecting relative reluctivity/permeability during mesh calculation.
    • Added optional element-center sampling for grid and plane postprocessing.
    • Added VTU export support for the inductance matrix.
    • Added the Compumag Team20 example; force calculation improvements are still ongoing.
  • Viewport/rendering
    • Unified framebuffer sizing.
    • Current arrows now preserve their assigned colors.
    • Camera range is now derived from geometry for improved depth resolution.
    • Fixed possible depth peeling issues on macOS.
    • Corrected DPI handling and renderer-scaled axes font sizing.
    • Fixed possible empty colorscale header cases.
    • Added support for local coordinate frame overlays.
  • UI/workflow
    • Fixed the [ / ] ordering issue that could create many duplicate copies.
    • Application shutdown is now allowed even when a dropdown menu is still open.
    • Added Ctrl-F shortcut support to focus/unfocus the current geometry.
    • Prevented duplicate recent-file entries.
    • On Linux, scheduler affinity is now preserved instead of overridden.
    • License status can now show a refreshing state during expiry refresh.
  • Infrastructure
    • Enabled parallel mesh preparation.
    • Expanded geometry test coverage and added broader CMake testing support.
    • Removed the broken Boost.URL dependency.
    • Included routine model, build, submodule, and version maintenance updates.

You can download the Linux signature file here:
Rat-GUI-2.022.2-Linux.AppImage.sig

An the public key here:
LB-PublicKey.asc

2.021.2 Windows macOS AppImage April 7, 2026

A full list of new features, bug fixes and improvements has been published on our news page.

From this version on, whenever there is an update of Rat GUI available the user will get a pop-up message inside Rat GUI. The user can then browse to this page to download the latest version of the software.

On Linux we had to create a new signature file. You can verify the signature as follows:

  • $ gpg --import LB-PublicKey.asc
    $ gpg --verify Rat-GUI-2.020.4-Linux.AppImage.sig Rat-GUI-2.020.4-Linux.AppImage
    $ # should output "Good signature"
  • You can download the signature file here: Rat-GUI-2.021.2-Linux.AppImage.sig
  • An the public key here: LB-PublicKey.asc

2.020.4 Windows macOS AppImage December 8, 2025

This update includes the following new features and bug fixes:

  • Code signing for all three platforms:
    • On Windows and Mac you will no longer get messages about "unidentified developer"
    • On Linux most users probably don't care about this, but you can verify the signature as follows:

      $ gpg --import LB-PublicKey.asc
      $ gpg --verify Rat-GUI-2.020.4-Linux.AppImage.sig Rat-GUI-2.020.4-Linux.AppImage
      $ # should output "Good signature"

      You can download the signature file here: Rat-GUI-2.020.4-Linux.AppImage.sig
      An the public key here: LB-PublicKey.asc

  • Improved transparency rendering in Mesh, Grid, Polar Grid and Track post processor windows. We're using multi-sampling for this. Its still not perfect, but at least it looks (almost) correct now.
  • Added transparency (alpha) menu to the Settings menu of the respective window.
  • Added grading optimizer which allows you to grade the thickness of the conductor along the length, based on the critical current fit and local field conditions. We'll release a tutorial on this soon.
  • Further stabilized the Frenet-Serret frame by using numerical derivatives based on spline interpolation instead of finite difference, the calculated derivatives are used in the analytical form of the Frenet-Serret equations.
  • Fixed bug when setting too short coil-end length for Cos-Theta.

2.020.3 Windows macOS AppImage November 5, 2025

This update includes the following changes. Fix of the framebuffer issue, viewport going black, when resizing the GUI. This was only noticeable on newer graphics cards for some reason. HTS tape fractions are now correctly updated when the core is edited. The license manager has undergone a major overhaul. It now executes network operations asynchronously. Splash screen no longer waits for license server connection, but there is a 10 second allowance window for the server to connect. Show "status" in license manager window to check who is using your license. When internet connection fails the user can continue to use Rat for a short duration. Heartbeat timer shown in the GUI.

FreeCAD export overhaul. Massive speedup when building large geometries by avoiding the use of the FreeCAD document objects. Ruled surfaces are improved by manualy setting "Parameters" on the splines. This means it can now accurately handle Frenet-Serret frames. I.e. use ruled surfaces for everything unless you want to experiment with other construction methods. Added combine sections option for try building a single conductor. Improved GUI output when enableed. Fixed export of single lines to FreeCAD sometimes failing on "shape is not an edge".

Calculate All option in the right click dropdown menu when multiple calculations are selected.

This update was patched on October 14th, 2025.

2.020.1 Windows macOS AppImage September 1, 2025

In this update we introduce the renewed Export FreeCAD calculation. In this version the export speed is much faster, and has a lot of user-acccesible FreeCAD settings.

2.019.1 Windows macOS AppImage July 21, 2025

This update has mainly bug fixes and performance improvements.

2.018.7 Windows macOS AppImage May 30, 2025

In this update new Source and Target types are introduced. This allows the user to control the accuracy of the computations versus the calculation speed. These new source and target types are explained in the latest tutorial on our YouTube channel. Models made with earlier version of Rat can still be used in the same way as before.

Recently we have also uploaded a tutorial on the MLFMM, we recommend watching both videos to understand how accuracy and calculation speed can be effectively managed in Rat. A cheat sheet with the different sources and targets can be downloaded here.

2.018.6 Windows macOS AppImage April 2, 2025

This update includes a fix for issues experienced by some users with NVIDIA RTX 2000 series graphics cards. Previously, affected users encountered a black screen at startup due to a bug in the latest graphics driver. To address this, we have implemented a workaround in Rat GUI that ensures proper functionality despite the driver issue.

Everyone is encouraged to download this version, as future driver updates for other graphics cards may introduce similar issues.

2.018.5 Windows macOS AppImage March 14, 2025

This update primarily includes bug fixes, and all users are encouraged to download it at their earliest convenience.

2.018.4 Windows macOS AppImage February 20, 2025

This update should have more accurate results in the force calculation, and the accuracy of the calculated peak field in coils should be improved. In addition, the automatic scaling of the solution vector was changed to improve convergence of the iron solver. The Path XYZ File can now take orientation vectors as additional input in the file. And as always small bug fixes have been applied to this version.

Moreover, the Linux AppImage has been compile with an older version of Linux that has the libc version 2.28, which should be compatible with most Linux distributions that are used nowadays. The Linux AppImage is still in the beta phase, if you have any feedback please let us know.

2.018.2 Windows macOS AppImage December 18, 2024

This update contains mainly bug fixes, which are given below.

  • Fixed a bug in the file dialog that removed slashes when in the root directory with the "Places" tab open, causing the file dialog to malfunction.
  • Fixed a bug in the file dialog that caused unavailable network drives to appear in "Places," disrupting the file dialog as these drives do not exist.
  • Improved the non-linear solver's tolerance for variable mesh sizes by removing the MLFMM grid refinement restriction and updating the examples to use this feature.
  • Introduced analytical integrals for the non-linear solver, enhancing its tolerance for high aspect ratio elements.
  • Fixed a bug in the distance mesher during the removal of high-valence nodes. When two high-valence nodes were very close, the mesh became corrupted, causing the non-linear solver to crash.
  • Fixed a bug in the distance mesher that caused failures with very small element sizes.
  • Added additional settings to the Cross Distance Mesher to control the number of iterations and termination tolerance.
  • Added a transformation distance function to the distance mesher.
  • Updated the FreeCAD Macro interface to version 1.0.0, available at https://www.freecad.org/.
    • The macro now retains as many construction parts as possible during updates.
    • Meshes are checked for duplicate names before exporting to FreeCAD.
2.018.1 Windows macOS N.A. October 9, 2024

This update introduces several important bug fixes and new features aimed at enhancing functionality. A bug affecting the mass density calculation has been resolved; this fix allows mass fractions to be combined correctly instead of volume fractions, resulting in a minor improvement in material density and thus also the heat capacity. Additionally, the circular cross-section now maintains its cross-sectional area that is independent of element size, achieved through mesh rescaling to ensure accuracy.

In the Quench Calculation, the protection measures are now triggered immediately if the detection voltage is exceeded at time zero. The particle tracker has been enhanced to automatically rescale colormaps when data is updated. We have also introduced a random noise function utilizing hash tables, enabling the offsetting of winding packs to analyze manufacturing tolerances. The functionality for importing XYZ Files/Tables has been expanded to calculate orientation vectors based on a cylinder, in addition to a flat plane.

Furthermore, a new menu option has been added to the Mesh Calculation post-processor, which is used to select the angle used for critical current and temperature margin calculations. Additionally, the optimization of the path connector has been improved to enhance stability, and a bug related to importing edge files formatted for Windows has been corrected. To facilitate the export of Rat models to FreeCAD, a preliminary FreeCAD Calculation has been included. The option to use "Home -> Export -> FreeCAD" remains available.

Finally, we have added two new classes: the Ellipse Path and the Elliptical Arc within the Path Group, broadening the available path drawing options for users.

2.017.9 Windows macOS N.A. August 8, 2024

Bug fixes for importing Windows files.

2.017.8 Windows macOS N.A. July 17, 2024

Bug fixes, and for the Critical Current Calculation and other superconducting properties the user can now select which angle is used.

2.017.7 Windows macOS N.A. May 9, 2024

This version includes mainly bug fixes, namely a bug fix for the calculation losing track of the model after using duplicate, but instead using an old version of the model (i.e. the calculation does not update after changes to the model). Models with this issue are fixed automatically upon loading them in the GUI. The particle tracking now uses momentum instead of velocity. This is more stable when using high energy (>GeV) relativistic particles, for the previous version the default tolerances in the GUI were almost always to loose. We also added opera conductor file import, only 8 node bricks are supported. Consecutive bricks are automatically connected by Rat. A Coil from Edges now checks the order of the edges to prevent inverted elements resulting in negative inductance. A bug fixed by increased number of iterations used by linear solver when calculating inductance including iron. Added drop down menu when right clicking in Viewport on Coils. Using binary input and output streams to avoid Windows special line ending characters. This fixes saving and loading json.gz files in Windows. And finally, since we are changing domain names while we are moving: the website links in the GUI are changed to https://rat-gui.com instead of https://rat-gui.ch.

2.017.6 Windows macOS N.A. April 17, 2024

This is a patch for version 2.017.5, where the main update in the Rat GUI for this version is the addition of the 1D normal zone propagation option to the adiabatic quench model. This means that the voltage is calculated based on the nzp along a line, based on the chosen material properties, which makes the Adiabatic Quench Calculation more accurate, especially in the case of HTS materials. Next, the "bloom" post-processing effect was added. This simulates scattering of light in a camera lens giving bright areas a subtle glow when using dark themes. Fixed the gradient banding issue in the background color by using a simple dithering technique. Added a basic load-line plot that can be accessed in the Mesh Calculation "Analyse Menu" of the post-processor. This plot will be extended with more options in future releases. Added a 180 deg flip button to the View Menu so that you can look at your coils from the other side. There were some minor bug fixes and the MacOs screenshot sticky keys problem fixed itself.

2.017.3 Windows macOS N.A. March 13, 2024

Animation in the particle tracking post-processor, using Runge-Kutta-Fehlberg 45 for adiabatic quench simulation, added CSV export to adiabatic quench simulation post processor window, fixed bug in current lead 2 option in the Regular CCT path, added "Places" feature to the load/save filedialog where the user can select folders, improved transparency in the Grid Calculation, fixed bug in renderer not correctly outputting the transparency, added transparency buttons for some of the colormaps in the post-processors (consider this a beta feature, we are aware of some visual bugs), changed reverse button to be a check box that doesn't close the drop down menu, forced Custom and Regular CCT Paths to have the transverse direction outward at the first coordinate along the path. If you have experience using reversals here please use "flip".

We are pleased to announce that nT-tao sponsered the implementation of time dependent magnetic and electric fields during particle tracking. We appreciate their support in helping us improve the Rat GUI. Thank you, nT-tao, for your valuable contribution.

The time dependent particle tracking includes: fieldmap is now time dependent and calculates both flux density and electric field, due to changing coil currents. The Lorentz force calculated in the Rat GUI is updated accordingly. The electric field is generally quite a weak force. Need very fast field changes, or long time scales to notice the effect. The time changing field must be set by adding a circuit to the tracking calculation. The start time for the tracks is the time of the simulation, and in addition to tracking flux lines, tracking electric field lines is added as well.

2.017.2 Windows macOS N.A. February 17, 2024

Major update, please read the full change-log on our news page.

2.016.5 Windows macOS N.A. January 15, 2024

With this update we include the voltage calculation in the Adiabatic Quench Calculation, and there is a bug fix in the polar grid calculation. For more information, please visit our news page.

2.016.3 Windows macOS N.A. December 12, 2023

This version features the new Adiabatic Quench Calculation, and many new post-processing features. For more information, please visit our news page.

2.016.2 Windows macOS N.A. November 7, 2023

Bug fixes.

2.016.1 Windows macOS N.A. October 29, 2023

This version features an enhanced iron solver, along with various significant bug fixes and improvements. As of this release, we are also introducing a beta version for macOS, compatible with Apple computers that run on Apple Silicon and support macOS Sonoma. Additionally, we have updated the user manual to incorporate instructions for the macOS installation.

2.016.0 Windows N.A. N.A. September 19, 2023

We hope everyone has safely returned to their offices and is ready to test the Rat GUI. During the MT28 conference, we identified two minor bugs, which we have now addressed in this version. These pertained to importing an edge matrix and to the higher order harmonics of the Cosine Theta coil. Meanwhile, we are also in the process of creating video tutorials which can be downloaded here.

2.015.8 Windows N.A. N.A. September 13, 2023

Hotfix for a license key issue.

2.015.7 Windows N.A. N.A. August 20, 2023

This is the first version of the Rat GUI with the non-linear solver. In addition, minor bugs were fixed, and many tooltips were added.

2.015.4 Windows N.A. N.A. June 5, 2023

This update includes many bug fixes, for instance with grouping and up-grouping coils. The Point(s) and Line Calculation Node Editor and post-processors have been polished. The CPU and battery consumption of Rat have been reduced when Rat is not actively being used. This is achieved by reducing the frame rate when not active. Several new Paths were added. We continue to put all our efforts towards the non-linear solver and the inclusion of it in the Rat GUI. Therefore, the mesher was updated as well.

2.015.3 Windows N.A. N.A. May 9, 2023

In this version of Rat the method for calculating the magnetic field and flux density of permanent magnets has been reworked. This is a first step towards a solver for non-linear magnetic materials that will be added to Rat in September of this year. Some examples were added, for example the Magnetized Sphere. A few bugs and inconveniences were resolved as well. For instance, arrow heads were added to the field lines in the post-processor menu of the Plane Calculation. The memory was reduced and the accuracy was fixed for the Direct Biot-Savart method. The bugs in the Trapezoidal Coil were fixed, and an option for importing point tables from a file as implemented for the Point Calculation, and finally the issue with parallel conductor not being displayed correctly was fixed.

2.015.2 Windows N.A. N.A. March 22, 2023

Minor bug fixes.

2.015.0 Windows N.A. N.A. December 6, 2022

The following features were added: custom colors, clipping a ModelGroup, allow for a CrossSection to vary along the length: can be done through the options "Coil from edges", "Local offset Path". Import of edge matrices as coil from edges, enable/disable parts of the model tree, further improvements and bug fixes for Frenet-Serret CCT's, FreeCAD export now prefers the ruled edges method if possible, FreeCAD export now matches the tree structure of the Rat model, a Path Connector for creating smooth transitions between two paths was added, which is useful for for making layer jumps and current lead connections. Improved performance in particle tracking when using the GPU, path imported from XYZ coordinates in a comma separated value file, a view option to combine sections. Fixed a bug with CustomCCT that occurs in bend coils with a varying radius along the length, the max depth is now persistent, mini-plots can be exported to CSV file by right clicking on them and the CCT table Path bug fix for not correctly interpolating harmonics along length.

2.014.0 Windows N.A. N.A. July 19, 2022

From this version on, if you have an invalid object in the Model Browser there is an error message in the tool-tip next to the object. In the Plane Calculation you can now visualize your coil cross-section in the 2D plot, and you can show the magnetic field as a vector plot.

2.013.4 Windows N.A. N.A. June 22, 2022

This is a patch to version 2.013.3, with an important bug fix for the Frenet-Serret PathGroup and Frenet-Serret Custom CCT. Please install it as soon as possible, especially when you are using Frenet-Serret paths in your models.

There was a mistake in one of the formulas defining the Frenet-Serret PathGroup that caused for having too little hard-way bend. The same thing was found for the Custom CCT Frenet-Serret with a variable radius.

To allow users to check this for their design a new PathGroup was added named Unfold. This Group unfolds the cable you have in your design along the transverse vectors to make it flat. This can be used to check the hard-way bend of the ribbon or cable in your model.

To prevent similar bugs in the future a unit test was added in Rat that checks this unfolding for a few different geometries.

2.013.3 Windows N.A. N.A. June 8, 2022

This version contains significant updates to the custom CCT path to allow for analytically calculating the space curve derivatives when needed for the Frenet-Serret equations, which describe a hard way bend free ribbon. Instead of using a Frenet-Serret object, the Frenet-Serret equations should be activated using a checkbox inside the custom CCT path. The derivatives are also included in the internal bending transformation. This version should be is compatible with old Rat GUI models, and automatically converts old Rat GUI models to the new standard. However, should you run into troubles please contact us at info@rat-gui.com.

Then a Drive was added for calculating the radius vs. theta in a custom CCT. By using non-circular cross-sections it is possible to produce CCT coil geometries out of a hard-way bend free Frenet-Serret ribbon, in which the ribbon is perpendicular to the surface of the former in the roots of the axial (z) equation. This allows for increasing the packing fraction for such coils significantly. The geometry is calculated using the surface of a cone, which is an extension to the constant perimeter cylinder commonly used in Cos-Theta magnet ends. A technical report/paper describing the methodology is under construction. Feel free to ask us for a draft. A sextupole example of such a coil can be opened using: Home -> Start from Example -> Perp FS-Sextupole.

Next we improved the FreeCAD macro exporting interface to deal properly with the Darboux vectors resulting from the Frenet-Serret frame. These vectors are not perpendicular to the tape edge and thus the previous ruled surface approach in FreeCAD did not produce entirely correct geometry. This improvement is necessary for example when exporting Frenet-Serret CCT coils and Cloverleaf coils. The Rat GUI now allows for exporting non-rectangular conductors to FreeCAD macro, this approach uses a series of cross-sections which are connected through a loft. This method is only used when the number of edges is unequal to four. Currently only a few non-rectangular cross sections are available (in the Rat GUI). More will be added in the future.

This update also includes two minor changes, which are the addition of colored text in the geometry tabs to indicate better which document is active and thus displayed in the tree/node editors, added stumpness parameter b to the CCT Harmonics to flatten the sines and cosines used for the z-equation, and a plasma ring coil for modelling the Tokamak plasma shape. Currently the current distribution is assumed homogeneous.

Finally there were some minor bug fixes: we fixed a bug where the n property of Lubell Kramer fit was incorrectly saved and thus fixed to a value of 1.7 in the calculations. In addition, we fixed the tooltip where this n was completely missing from the equation. And we fixed a bug causing the Rat GUI to freeze when closing multiple geometry windows simultaneously, while multiple unsaved models are open.

2.013.1 Windows N.A. N.A. April 19, 2022
This is a patch to version 2.013.0 where we've updated the Regular CCT Wrapper model. The CCT (skew) and CCT (ampl) have been made into one wrapper. We've also changed the definition of the CCT such that the amplitude is no longer scaled with the number of magnetic poles. This version should be is compatible with old Rat GUI models, and automatically converts old Rat GUI models to the new standard. However, should you run into troubles please contact us at info@rat-gui.com. Finally, we've also added the "Open Recent" option to the Home Menu, so that you can quickly open the models you've saved most recently. See our News page for more information.
2.013.0 Windows N.A. N.A. April 14, 2022
This update includes: color themes that can be found under "Settings -> Themes", Fleiter-Bristow fit type for REBCO coated conductor (in contrast to the regular Fleiter fit it is bound to a finite value at zero field, making it better behaved in the low field range), several HTS tape fits based on data from RRI and Tohoku university (note that the RRI data fits are based on measured data up to 8 T and the Tohoku fit (Fujikura FESC) on data up to 24 T, extrapolation outside of these ranges will not cause the fit to misbehave, but the accuracy is no longer guaranteed), added option to bend CCT with either radius or bending angle, added option to export the nodal data from a mesh calculation to a comma-separated value table, changed tooltip "question mark" icon to make it more visible, you can now plot angular deviation with respect to start or end of the track in the Track calculation, added a plasma ring coil with uniform current density, and you can now save individual nodes to a file and load them back in using: "Right click -> Edit Nodes -> Save to/Append from file".
2.012.2 Windows N.A. N.A. March 8, 2022
This update includes: the material editor, building custom CCTs from CSV files, barycentric rational interpolation for setting smooth curves for pitch, radius and harmonics in a custom CCT, new camera for orthographic view with options to set the orientation axis, export to Abaqus files for importing Rat models in for instance Geant4, and minor bug fixes.
2.012.0 Windows N.A. N.A. February 14, 2022
First released Rat GUI

Checking your download

Every installer is signed, so you can check that it comes from us and that it has not changed. A checksum is a second way to check the file itself.

Windows

Right-click the installer, choose Properties > Digital Signatures and check that the signer is Little Beast Software B.V. Or compare its SHA-256 checksum with the list below; PowerShell shows it with Get-FileHash rat-gui-3.004.5-windows.exe.

macOS

The application is signed and notarized by Apple. After installing, run spctl -a -vv /Applications/rat-gui.app in Terminal. The output should say accepted, source=Notarized Developer ID and origin=Developer ID Application: Little Beast Software B.V. (S4V7DW5J47). To check the checksum of the disk image, use shasum -a 256 rat-gui-3.004.5-macos.dmg.

Linux

The AppImage is signed with GPG. Download its .sig file, linked with each release, and our public signing key: rat-gui-release-signing-key.asc. Then run:

$ gpg --import rat-gui-release-signing-key.asc
$ gpg --verify rat-gui-3.004.5-linux.AppImage.sig rat-gui-3.004.5-linux.AppImage

The output should say Good signature from "Little Beast Software B.V. (RatGUI Linux release signing) <info@rat-gui.com>" and show the primary key fingerprint B31E 93F5 B414 5A63 D8B3 6431 683B A776 3CCB BD38. gpg also warns that the key is not certified with a trusted signature. That warning is normal for a key you have not certified yourself, so compare the fingerprint above. For the checksum, use sha256sum rat-gui-3.004.5-linux.AppImage.

SHA-256 checksums of version 3.004.5

InstallerFileSHA-256
Windowsrat-gui-3.004.5-windows.exeB694D8219A1AA2C043C1216898FA00C64309698768DED32D3548DC09D3BB7A5E
macOSrat-gui-3.004.5-macos.dmg94E0EC91F1E636890B3BC6A8FAB27722AA85F551247FEEBFFFCBF81430829B53
Linuxrat-gui-3.004.5-linux.AppImage5027F2DAE95ADA059E6057349BC86188B33E69863918DD03140D3A5D616CD3F9
Windows, Raccoonrat-gui-3.004.5-raccoon-windows.exe486CDE383BE371C70A83BE98BB3BE01CE7540836C9ABE75E367A3FEE922CDDAF
macOS, Raccoonrat-gui-3.004.5-raccoon-macos.dmg5DBD5F916C71C044C98DD999C829254DB1222716CB8860CCBFCB7D6AF0964DBE
Linux, Raccoonrat-gui-3.004.5-raccoon-linux.AppImage3D0E308C592FBCD659A0363F210E26F0BE7A5218AEFB575B6DBBA242DCD5E5CF
Windows, offlinerat-gui-3.004.5-offline-windows.exeAD5E61EBA14B788E34345FB6EE80790AF45C49A35075933064A485DCE065B836