ross

name	ross
description	Rotordynamic analysis with ROSS (Rotordynamic Open Source Software, the ross-rotordynamics Python package). Use when building rotor models (shaft elements, disks, bearings, seals, materials) or running rotordynamic analyses: modal analysis, Campbell diagram, critical speeds, unbalance response, frequency response (FRF), static analysis, time response, undamped critical speed (UCS) map, API 617 Level 1 stability, and fault analyses (rubbing, crack, misalignment).
license	Apache-2.0

ROSS Cookbook

Concise recipes for rotordynamics analyses with ROSS. Each file is self-contained — read only the recipe you need.

Skill version: development (repo checkout)

Recipe	File	Key Methods
Building a rotor from scratch	building_rotors.md	Material, ShaftElement, DiskElement, BearingElement, Rotor
Modal analysis	modal_analysis.md	run_modal
Campbell diagram	campbell_diagram.md	run_campbell
Unbalance response	unbalance_response.md	run_unbalance_response
Static analysis	static_analysis.md	run_static
Critical speeds	critical_speed.md	run_critical_speed
Frequency response (FRF)	frequency_response.md	run_freq_response, run_forced_response
Time response	time_response.md	run_time_response
UCS and Level 1 stability	ucs_and_level1.md	run_ucs, run_level1
Fault analysis	faults.md	run_rubbing, run_crack, run_misalignment
Advanced bearings	bearings_advanced.md	BearingElement with arrays, fluid-film bearings
Common gotchas	gotchas.md	—

All values are SI internally: speed in rad/s, stiffness in N/m, damping in N·s/m, unbalance in kg·m. Convert with rs.Q_(value, "unit"), e.g. rs.Q_(4000, "RPM").to("rad/s").m.

If the recipes disagree with the installed ROSS (missing methods, changed signatures), the skill may be stale — compare the version above with python -c "import ross; print(ross.__version__)" and re-run ross-install-skill after upgrading.