ross.CampbellResults#

class ross.CampbellResults(speed_range, wd, log_dec, damping_ratio, whirl_values, modal_results)#

Class used to store results and provide plots for Campbell Diagram.

It’s possible to visualize multiples harmonics in a single plot to check other speeds which also excite a specific natural frequency.

Parameters

speed_rangearray: Array with the speed range in rad/s.
wdarray: Array with the damped natural frequencies
log_decarray: Array with the Logarithmic decrement
whirl_valuesarray: Array with the whirl values (0, 0.5 or 1)
modal_resultsdict: Dictionary with the modal results for each speed in the speed range.

Returns

figPlotly graph_objects.Figure(): The figure object with the plot.

Methods

__init__(speed_range, wd, log_dec, damping_ratio, whirl_values, modal_results)#

classmethod load(file)#

Load results from a .toml file.

This function will load the simulation results from a .toml file. The file must have all the argument’s names and values that are needed to reinstantiate the class.

Parameters

filestr, pathlib.Path: The name of the file the results will be loaded from.

Examples

>>> # Example running a stochastic unbalance response
>>> from tempfile import tempdir
>>> from pathlib import Path
>>> import ross as rs
>>> # Running an example
>>> rotor = rs.rotor_example()
>>> freq_range = np.linspace(0, 500, 31)
>>> n = 3
>>> m = 0.01
>>> p = 0.0
>>> results = rotor.run_unbalance_response(n, m, p, freq_range)
>>> # create path for a temporary file
>>> file = Path(tempdir) / 'unb_resp.toml'
>>> results.save(file)
>>> # Loading file
>>> results2 = rs.ForcedResponseResults.load(file)
>>> abs(results2.forced_resp).all() == abs(results.forced_resp).all()
True

plot(harmonics=[1], frequency_units='rad/s', damping_parameter='log_dec', frequency_range=None, damping_range=None, fig=None, **kwargs)#

Create Campbell Diagram figure using Plotly.

Parameters

harmonics: list, optional: List withe the harmonics to be plotted. The default is to plot 1x.
frequency_unitsstr, optional: Frequency units. Default is “rad/s”
damping_parameterstr, optional: Define which value to show for damping. We can use “log_dec” or “damping_ratio”. Default is “log_dec”.
frequency_rangetuple, pint.Quantity(tuple), optional: Tuple with (min, max) values for the frequencies that will be plotted. Frequencies that are not within the range are filtered out and are not plotted. It is possible to use a pint Quantity (e.g. Q_((2000, 1000), “RPM”)). Default is None (no filter).
damping_rangetuple, optional: Tuple with (min, max) values for the damping parameter that will be plotted. Damping values that are not within the range are filtered out and are not plotted. Default is None (no filter).
figPlotly graph_objects.Figure(): The figure object with the plot.
kwargsoptional: Additional key word arguments can be passed to change the plot layout only (e.g. width=1000, height=800, …). *See Plotly Python Figure Reference for more information.

Returns

figPlotly graph_objects.Figure(): The figure object with the plot.

Examples

>>> import ross as rs
>>> import numpy as np
>>> Q_ = rs.Q_
>>> rotor = rs.rotor_example()
>>> speed = np.linspace(0, 400, 101)
>>> camp = rotor.run_campbell(speed)
>>> fig = camp.plot(
...     harmonics=[1, 2],
...     damping_parameter="damping_ratio",
...     frequency_range=Q_((2000, 10000), "RPM"),
...     damping_range=(-0.1, 100),
...     frequency_units="RPM",
... )

plot_with_mode_shape(harmonics=[1], frequency_units='rad/s', damping_parameter='log_dec', frequency_range=None, damping_range=None, fig=None, **kwargs)#

classmethod read_toml_data(data)#

Read and parse data stored in a .toml file.

The data passed to this method needs to be according to the format saved in the .toml file by the .save() method.

Parameters

datadict: Dictionary obtained from toml.load().

Returns

The result object.

save(file)#

Save results in a .toml file.

This function will save the simulation results to a .toml file. The file will have all the argument’s names and values that are needed to reinstantiate the class.

Parameters

filestr, pathlib.Path: The name of the file the results will be saved in.

Examples

>>> # Example running a unbalance response
>>> from tempfile import tempdir
>>> from pathlib import Path
>>> import ross as rs

>>> # Running an example
>>> rotor = rs.rotor_example()
>>> speed = np.linspace(0, 1000, 101)
>>> response = rotor.run_unbalance_response(node=3,
...                                         unbalance_magnitude=0.001,
...                                         unbalance_phase=0.0,
...                                         frequency=speed)

>>> # create path for a temporary file
>>> file = Path(tempdir) / 'unb_resp.toml'
>>> response.save(file)

ROSS

ross.CampbellResults

ross.CampbellResults#