v2.1.0

ROSS v2.1.0

Enhancements

• Harmonic Balance Method — run_harmonic_balance() for steady-state periodic responses under harmonic excitation
• Squeeze Film Damper — new SqueezeFilmDamper class with short/long bearing approximations, end seals, and grooves
• Hybrid Seal — new HybridSeal class combining labyrinth and hole-pattern seal stages in series
• Enhanced Magnetic Bearing — generalized controller support (arbitrary transfer functions) replacing fixed PID logic
• GearElement with TVMS — time-varying mesh stiffness with spur gear geometry computation and square profile approximation
• THD Bearing Post-Processing — show_results(), show_coefficients_comparison(), plot_results(), and convergence tracking for TiltingPad, ThrustPad, and PlainJournal
• TiltingPad Performance — Numba JIT compilation and sparse matrix solvers for significant speedup
• MCP Server — AI-assisted rotordynamics analysis via Model Context Protocol (pip install "ross-rotordynamics[mcp]")
• JSON Save/Load — .json format support alongside .toml for rotor serialization
• Version Traceability — ross_version saved in rotor files with mismatch warnings on load
• Skip-Computation on Load — faster Rotor.load() for models with THD bearings or seals
• Hover Info — interactive hover details for bearing and seal elements in rotor plots

Bug Fixes

• Fix add_nodes for conical (tapered) shaft elements
• Fix transfer matrix for zero-speed FRF calculations
• Fix plot_rotor when coupling element is combined with bearings
• Fix coefficient units in format_table() for bearings
• Fix TiltingPad class example for determine_eccentricity
• Fix warning message formatting in TiltingPad initialization
• Fix typos and improve clarity across documentation

Documentation

• MCP server tutorial
• Hybrid seal tutorial
• AMB sensitivity analysis tutorial with transfer function methods
• Harmonic balance tutorial with worked examples
• Updated multi-rotor and gear element tutorials

Contributors

@raphaeltimbo, @jguarato, @gsabinoo, @murilloabs, @luisotaviomc2002, @ArthurIasbeck, @Raimundovpn, @ViniciusTxc3, @tches-co

Full release notes: https://ross.readthedocs.io/en/latest/release_notes/release_notes.html

Install: pip install ross-rotordynamics==2.1.0