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_film_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_film_temperature_3d(freq_index=0, fig=None, **kwargs)

Not available for SqueezeFilmDamper (analytical model).

Raises:

NotImplementedError

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

Return a 3-D mesh of the bearing pads colored by temperature.

This is the through-pad (circumferential x radial) counterpart of plot_film_temperature_3d: the pad geometry is drawn at its physical position and colored by the solid pad / babbitt temperature, showing how much heat crosses from the film into the pad.

The method is part of the common bearing plotting API, so it exists on every bearing result class. Classes whose model does not compute a solid pad temperature field raise NotImplementedError.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

Raises:

NotImplementedError

When the bearing model does not provide a solid pad temperature field.

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(*args, **kwargs)

Deprecated alias for plot_film_temperature_3d().

Deprecated since version 2.4.0: plot_temperature_3d is deprecated and will be removed in a future version. Use plot_film_temperature_3d instead, which states explicitly that the plotted field is the oil film temperature.

Returns:

figgo.Figure

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