ross.ThrustPadResults

class ross.ThrustPadResults(frequency, pressure_fields, temperature_fields, max_thicknesses, min_thicknesses, pivot_film_thicknesses, equilibrium_position_mode, axial_load, kzz, czz, n_radial, n_theta, pad_outer_radius, pad_inner_radius, d_radius, d_theta, pad_arc_length, optimization_history, initial_time=None, final_time=None)

Post-processing results for a ThrustPad bearing.

Parameters:

frequencyarray_like

Operating frequencies in rad/s.

pressure_fieldslist of ndarray, shape (n_radial + 2, n_theta + 2)

Pressure fields, one per frequency (Pa).

temperature_fieldslist of ndarray, shape (n_radial + 2, n_theta + 2)

Temperature fields, one per frequency (°C).

max_thicknesseslist of float

Maximum film thickness per frequency (m).

min_thicknesseslist of float

Minimum film thickness per frequency (m).

pivot_film_thicknesseslist of float

Film thickness at the pivot per frequency (m).

equilibrium_position_modestr

"imposed" or "calculate".

axial_loadfloat or ndarray

Applied axial load (N). Scalar when equilibrium_position_mode is "calculate"; array when "imposed".

kzzndarray

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

czzndarray

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

n_radialint

Number of radial mesh elements.

n_thetaint

Number of circumferential mesh elements.

pad_outer_radiusfloat

Pad outer radius (m).

pad_inner_radiusfloat

Pad inner radius (m).

d_radiusfloat

Radial mesh step size (non-dimensional).

d_thetafloat

Angular mesh step size (non-dimensional).

pad_arc_lengthfloat

Pad arc length (rad).

optimization_historydict

Mapping {freq_index: [residuals]}.

initial_timefloat, optional

Solver start epoch timestamp.

final_timefloat, optional

Solver end epoch timestamp.

Methods

__init__(frequency, pressure_fields, temperature_fields, max_thicknesses, min_thicknesses, pivot_film_thicknesses, equilibrium_position_mode, axial_load, kzz, czz, n_radial, n_theta, pad_outer_radius, pad_inner_radius, d_radius, d_theta, pad_arc_length, optimization_history, initial_time=None, final_time=None)

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

Return a 2-D contour plot of the pressure field.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

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

Return a 3-D surface plot of the pressure field.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

plot_results(show_plots=False, freq_index=0)

Generate and return all standard bearing result plots.

Calls the four abstract plot_* methods and collects their figures into a standardized dictionary. Subclasses may override this method to add bearing-specific figures while calling super().plot_results().

Parameters:

show_plotsbool, optional

When True each figure is displayed immediately via fig.show(). Default is False.

freq_indexint, optional

Index into the frequency array selecting which solved point to visualize. Default is 0 (first frequency).

Returns:

figuresdict

Dictionary with keys "pressure_2d", "pressure_3d", "temperature_2d", and "temperature_3d". Each value is a plotly.graph_objects.Figure.

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

Return a 2-D contour plot of the temperature field.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

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

Return a 3-D surface plot of the temperature field.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

show_coefficients_comparison()

Print a table comparing axial dynamic 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_optimization_convergence(by: str = 'index', show_plots: bool = False) → None

Display the optimization residuals per iteration for each frequency.

Parameters:

bystr, optional

"index" — label frequencies by their array index (default). "value" — label frequencies by their value in rad/s.

show_plotsbool, optional

When True a convergence plot is shown for each frequency. Default is False.

Returns:

None

show_results()

Print a formatted summary of thrust pad bearing results.

Iterates over all solved frequencies and prints a PrettyTable with operating conditions, field extrema, film thicknesses, axial load, and dynamic coefficients.

Parameters:

None

Returns:

None