ROSS — Rotordynamic Open-Source Software
ROSS is a Python library for rotordynamic analysis, which allows the construction of rotor models and their numerical simulation. Shaft elements are modeled with the Timoshenko beam theory, which considers shear and rotary inertia effects, and discretized by means of the Finite Element Method. Disks are assumed to be rigid bodies, thus their strain energy is not taken into account. Bearings and seals are included as linear stiffness and damping coefficients.
After defining the elements for the model, you can plot the rotor geometry and run simulations such as static analysis, modal analysis, undamped critical speed, frequency response, unbalance response, time response, and more.
🚀 Quick Start
You can try ROSS instantly in your browser:
Or install it locally:
pip install ross-rotordynamics
ROSS also has a graphical interface, a local web application over the library. Install it with the interface extra and start it with one command:
pip install "ross-rotordynamics[interface]"
ross-interface
Windows users without Python can download a prebuilt bundle from the releases page.
If you work with an AI coding agent (Claude Code, GitHub Copilot, Cursor, Codex), install the ROSS agent skill so your agent knows how to build rotors and run analyses:
ross-install-skill
The skill activates automatically whenever you ask your agent about rotordynamics with ROSS. In Claude Code you can also invoke it explicitly:
/ross create a rotor with 6 shaft elements, 2 disks and 2 bearings, then plot the Campbell diagram
Upgrading from ROSS 2? Version 3 renamed the bearing and seal parameters. Convert your saved rotors, scripts and notebooks with:
ross_2to3 my_rotor.toml analysis.py # preview
ross_2to3 -w my_rotor.toml analysis.py # rewrite in place (keeps .bak copies)
📚 Documentation
Access full documentation here.
Key sections:
🤖 AI Assistance
ROSS supports AI-assisted workflows in two ways:
- In your coding agent — the ROSS agent skill (Agent Skills open standard) teaches Claude Code, GitHub Copilot, Cursor, and Codex how to build rotor models and run analyses. Install it with
ross-install-skill(see Quick Start above); in Claude Code, invoke it explicitly with/ross. - In your browser — ROSS GPT is the official chat assistant for the ROSS package. Use it to create and modify rotor models, request practical examples for modal analysis, Campbell diagrams, unbalance response, and more, and get detailed technical explanations on elements such as shafts, disks, bearings, and couplings.
❓ Support & Questions
If you have questions, need guidance, or want to discuss ideas, please use the Discussions tab.
If you encounter a bug, experience unexpected behavior, or want to request a new feature, please open an Issue describing the problem and how to reproduce it.
🤝 Contributing
ROSS is a community-driven project. If you want to contribute to the project, please check CONTRIBUTING.md.
The code has been initially developed by Petrobras in cooperation with the Federal University of Rio de Janeiro (UFRJ) with contributions from the Federal University from Uberlândia (UFU). Currently, Petrobras has a cooperation agreement with UFRJ (LAVI) and UFU (LMEST) to develop and maintain the code.
3 maintainers
Release files for ross-rotordynamics 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ross_rotordynamics-3.0.0.tar.gz | 2.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ross_rotordynamics-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.3 MB
Release files / ross_rotordynamics-3.0.0.tar.gz
| Download URL | ross_rotordynamics-3.0.0.tar.gz |
|---|---|
| Size | 2.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
36d9de3dca5e98071dec030d20e6fcc2fccb393eb1e152ef48fea32f8bad1d21
|
|
BLAKE2b-256 checksum How to use checksums |
ccbfb93c292609edf317669f851e0f1a6b32747ec9b68aab940d2bfc34812149
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency logRelease files / ross_rotordynamics-3.0.0-py3-none-any.whl
| Download URL | ross_rotordynamics-3.0.0-py3-none-any.whl |
|---|---|
| Size | 2.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0aa525b1b5d6d33388b6bc7290b11d52884b39a8bf2076f0a0c195646af8ddd7
|
|
BLAKE2b-256 checksum How to use checksums |
b5876b24413ea406b0f13a575789157ff180730bc4ab0f422047feb2b95a4fec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency log
