ross.TiltingPadResults

class ross.TiltingPadResults(frequency, pressure_fields, temperature_fields, maxP_list, maxT_list, minH_list, ecc_list, attitude_angle_list, psi_pad_list, force_x_total_list, force_y_total_list, momen_rot_list, kxx, kxy, kyx, kyy, cxx, cxy, cyx, cyy, equilibrium_type, n_pad, xtheta, xz, pivot_angle, pad_axial_length, nz, nx, optimization_history, oil_supply_temperature=None, pad_arc=None, z1=None, z2=None, T_pad=None, T_pad_surface=None, r_pad=None, ntheta_pad=None, pad_radius=None, initial_time=None, final_time=None)

Post-processing results for a TiltingPad bearing.

Parameters:

frequencyarray_like

Operating frequencies in rad/s.

pressure_fieldslist of ndarray, shape (nz, nx, n_pad)

Pressure fields, one per frequency.

temperature_fieldslist of ndarray, shape (nz, nx, n_pad)

Temperature fields, one per frequency.

maxP_listlist of float

Maximum pressure per frequency (Pa).

maxT_listlist of float

Maximum temperature per frequency (°C).

minH_listlist of float

Minimum film thickness per frequency (m).

ecc_listlist of float

Journal eccentricity ratio per frequency.

attitude_angle_listlist of float

Journal attitude angle per frequency (rad).

psi_pad_listlist of array_like

Pad rotation angles per frequency (rad).

force_x_total_listlist of float

Total hydrodynamic force in X per frequency (N).

force_y_total_listlist of float

Total hydrodynamic force in Y per frequency (N).

momen_rot_listlist of array_like or None

Pad moments per frequency (N·m). None entries indicate that the determine_eccentricity equilibrium type was used.

kxxndarray

Direct stiffness coefficient in XX (N/m), one value per frequency.

kxyndarray

Cross stiffness coefficient in XY (N/m).

kyxndarray

Cross stiffness coefficient in YX (N/m).

kyyndarray

Direct stiffness coefficient in YY (N/m).

cxxndarray

Direct damping coefficient in XX (N·s/m).

cxyndarray

Cross damping coefficient in XY (N·s/m).

cyxndarray

Cross damping coefficient in YX (N·s/m).

cyyndarray

Direct damping coefficient in YY (N·s/m).

equilibrium_typestr

"match_eccentricity" or "determine_eccentricity".

n_padint

Number of pads.

xthetandarray, shape (nx,)

Circumferential mesh coordinates (rad, relative to pad centre).

xzndarray, shape (nz,)

Axial mesh coordinates (non-dimensional, −0.5 to 0.5).

pivot_anglendarray, shape (n_pad,)

Absolute pivot angle of each pad (rad).

pad_axial_lengthfloat

Pad axial length (m).

nzint

Number of axial mesh elements.

nxint

Number of circumferential mesh elements.

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, maxP_list, maxT_list, minH_list, ecc_list, attitude_angle_list, psi_pad_list, force_x_total_list, force_y_total_list, momen_rot_list, kxx, kxy, kyx, kyy, cxx, cxy, cyx, cyy, equilibrium_type, n_pad, xtheta, xz, pivot_angle, pad_axial_length, nz, nx, optimization_history, oil_supply_temperature=None, pad_arc=None, z1=None, z2=None, T_pad=None, T_pad_surface=None, r_pad=None, ntheta_pad=None, pad_radius=None, initial_time=None, final_time=None)

plot_babbitt_surface_temperature(axial_index=None, fig=None, print_data=False, **kwargs)

Plot babbitt surface temperature vs local pad angle for each pad.

Parameters:

axial_indexint or None, optional

Axial index to extract the surface temperature. If None, use the axial mid-plane.

figgo.Figure, optional

Existing figure. If None, a new one is created.

print_databool, optional

When True, print the raw data to the console. Default is False.

Returns:

figgo.Figure

plot_film_average_temperature(freq_index=0, fig=None, print_data=False, **kwargs)

Plot film average temperature vs local pad angle for each pad.

Parameters:

freq_indexint, optional

Index into self.temperature_fields. Default is 0.

figgo.Figure, optional

Existing figure to add traces to. If None, a new one is created.

print_databool, optional

When True, print the raw data to the console. Default is False.

Returns:

figgo.Figure

plot_film_temperature_results(freq_index=0, pad_index=None, **kwargs)

Plot 2D film temperature contours for the selected pads.

Each selected pad is plotted in its own figure using local pad angle on the X axis and axial position on the Y axis.

Parameters:

freq_indexint

Index into self.temperature_fields. Default is 0.

pad_indexint or list[int] or None, optional

Pad index (0-based) or list of indices to plot. If None, plot all pads.

Returns:

go.Figure or list[go.Figure]

One figure when a single pad is selected, otherwise a list with one figure per selected pad.

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

Return a scatter plot of the midplane pressure profile per pad.

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add traces to.

Returns:

figgo.Figure

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

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

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add traces to.

Returns:

figgo.Figure

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

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

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

pad_indexint, optional

Pad index. When None the pad with the highest peak pressure at the chosen frequency is selected automatically.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

plot_results(show_plots=False, freq_index=0)

Return all tilting pad result plots, including pad scatter plots.

Extends the base plot_results with two additional entries: "pressure_scatter" and "temperature_scatter".

Parameters:

show_plotsbool, optional

When True each figure is displayed immediately. Default is False.

freq_indexint, optional

Frequency index. Default is 0.

Returns:

figuresdict

Dictionary with keys "pressure_2d", "pressure_3d", "temperature_2d", "temperature_3d", "pressure_scatter", and "temperature_scatter".

plot_solid_pad_results(pad_index=None, **kwargs)

Plot 2D solid pad temperature contours for the selected pads.

Each selected pad is plotted in its own figure using local pad angle on the X axis and pad depth on the Y axis.

Parameters:

pad_indexint or list[int] or None, optional

Pad index (0-based) or list of indices to plot. If None, plot all pads.

Returns:

go.Figure or list[go.Figure]

One figure when a single pad is selected, otherwise a list with one figure per selected pad.

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

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

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

figgo.Figure, optional

Existing figure to add traces to.

Returns:

figgo.Figure

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

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

Parameters:

freq_indexint, optional

Frequency index. Default is 0.

pad_indexint, optional

Pad index. When None the pad with the highest peak temperature at the chosen frequency is selected automatically.

figgo.Figure, optional

Existing figure to add the trace to.

Returns:

figgo.Figure

plot_thermal_pad_results(freq_index=0, pad_index=None, **kwargs)

Backward-compatible alias for plot_film_temperature_results().

show_coefficients_comparison()

Print a table comparing 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 tilting pad bearing results.

Iterates over all solved frequencies and prints a PrettyTable with operating conditions, field extrema, equilibrium data, loads, dynamic coefficients, and per-pad rotation angles.

Parameters:

None

Returns:

None