ross.SqueezeFilmDamperResults

class ross.SqueezeFilmDamperResults(frequency, kxx, cxx, theta, p_max, axial_length, journal_radius, radial_clearance, eccentricity_ratio, lubricant_viscosity, geometry, cavitation, initial_time=None, final_time=None)

Post-processing results for a SqueezeFilmDamper bearing.

The SFD uses closed-form analytical expressions; no numerical pressure or temperature fields are solved. The four abstract field-plot methods (plot_pressure_3d, plot_pressure_2d, plot_temperature_3d, plot_temperature_2d) therefore raise NotImplementedError. Use plot_coefficients() to visualise the computed results.

Parameters:

frequencyarray_like

Operating frequencies in rad/s.

kxxarray_like

Stiffness coefficient (N/m), one value per frequency.

cxxarray_like

Damping coefficient (N·s/m), one value per frequency.

thetaarray_like

Pressure angle (rad), one value per frequency.

p_maxarray_like

Maximum pressure (Pa), one value per frequency.

axial_lengthfloat

Bearing axial length (m).

journal_radiusfloat

Journal radius (m).

radial_clearancefloat

Radial clearance (m).

eccentricity_ratiofloat

Ratio of journal eccentricity to radial clearance.

lubricant_viscosityfloat

Dynamic viscosity of the lubricant (Pa·s).

geometrystr

Geometry type: "groove", "end_seals", or "groove-end_seals".

cavitationbool

Whether cavitation is modelled.

initial_timefloat, optional

Solver start epoch timestamp.

final_timefloat, optional

Solver end epoch timestamp.

Methods

__init__(frequency, kxx, cxx, theta, p_max, axial_length, journal_radius, radial_clearance, eccentricity_ratio, lubricant_viscosity, geometry, cavitation, initial_time=None, final_time=None)

plot_pressure_2d(freq_index=0, fig=None, **kwargs)

Not available for SqueezeFilmDamper (analytical model).

Raises:

NotImplementedError

plot_pressure_3d(freq_index=0, fig=None, **kwargs)

Not available for SqueezeFilmDamper (analytical model).

Raises:

NotImplementedError

plot_results(show_plots=False, freq_index=0)

Not available for SqueezeFilmDamper (analytical model).

The SFD does not solve numerical pressure or temperature fields, so no standard field plots are produced. Use show_results() or show_coefficients_comparison() to inspect the computed coefficients.

Parameters:

show_plotsbool, optional

Not used — included for API consistency with the base class.

freq_indexint, optional

Not used — included for API consistency with the base class.

Returns:

figuresdict

Empty dictionary.

plot_temperature_2d(freq_index=0, fig=None, **kwargs)

Not available for SqueezeFilmDamper (analytical model).

Raises:

NotImplementedError

plot_temperature_3d(freq_index=0, fig=None, **kwargs)

Not available for SqueezeFilmDamper (analytical model).

Raises:

NotImplementedError

show_coefficients_comparison()

Print a table comparing SFD coefficients across all frequencies.

Parameters:

None

Returns:

None

show_execution_time()

Display the total solver execution time.

Parameters:

None

Returns:

None

Prints the elapsed time in seconds to the console.

show_results()

Print a formatted summary of SFD results for all frequencies.

Parameters:

None

Returns:

None