Skip to content

Commit 419acf8

Browse files
committed
Fixing typos in documentation
1 parent 19b773f commit 419acf8

File tree

4 files changed

+20
-60
lines changed

4 files changed

+20
-60
lines changed

docs/source/modal_tutorials/Modal_01_What_is_Modal_Analysis/Modal_01_What_is_Modal_Analysis.ipynb

Lines changed: 5 additions & 45 deletions
Large diffs are not rendered by default.

docs/source/modal_tutorials/Modal_02_Basics_of_Vibrations/Modal_02_Basics_of_Vibrations.ipynb

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -664,13 +664,13 @@
664664
"source": [
665665
"It is worth pointing out some features of the frequency response function here. First, we have plotted the complex data in two ways. The left plots show a magnitude and phase plot. The right two plots show a real and imaginary part. While these representations highlight different parts of the frequency response function, they plot the same underlying data and are nominally identical.\n",
666666
"\n",
667-
"Starting with the magnitude and phase plots: we see that there is a peak in the amplitude at the resonant frequency of the part. We also see that the phase flips from 0 to -180 as the structure goes through resonance, with a phase of -90 degrees corresponding to the resonance location. We note that while the amplitude peak goes to infinity when the damping is zero, the amplitude peak no longer goes up to infinity when damping is included. The sharpness of the amplitude peak and damping transition from 0 to -180 degrees depends on the amount of damping, with a larger damping providing a more blunt peak and a slower phase transition. Because the magnitude often spans multiple orders of magnitude, it is often plotted on a logrithmic scale. The magnitude and phase representation is probably the most common representation of a frequency response function.\n",
667+
"Starting with the magnitude and phase plots: we see that there is a peak in the amplitude at the resonant frequency of the part. We also see that the phase flips from 0 to -180 as the structure goes through resonance, with a phase of -90 degrees corresponding to the resonance location. We note that while the amplitude peak goes to infinity when the damping is zero, the amplitude peak no longer goes up to infinity when damping is included. The sharpness of the amplitude peak and damping transition from 0 to -180 degrees depend on the amount of damping, with a larger damping providing a more blunt peak and a slower phase transition. Because the magnitude often spans multiple orders of magnitude, it is often plotted on a logrithmic scale. The magnitude and phase representation is probably the most common representation of a frequency response function.\n",
668668
"\n",
669669
"An alternative representation is to plot the real and imaginary part directly. We see that the real part goes through zero at resonance, and the imaginary part peaks at resonance. The imaginary part tends to be \"sharper\" than the magnitude, so it can be useful to look at the imaginary part of the frequency response function when identifying peaks that may be modes of the system.\n",
670670
"\n",
671671
"### Comparison between Displacement, Velocity, and Acceleration Frequency Response Functions\n",
672672
"\n",
673-
"Note that the frequency reponse functions are plotted as the displacement response over the force. This is intuitive, as we often think about how the part moves when we think about dynamics. Particularly in experimental dynamics, the practitioner may be exposed to multiple data types. Accelerometers measure accelerations of the part. Laser vibrometers measure velocities of the part. Cameras and other displacement sensors measure displacements. Therefore, it is useful to become accustomed to what, say, the frequency response function between and acceleration and a force looks like. This basically requires differentiating the response.\n",
673+
"Note that the frequency reponse functions above are plotted as the displacement response over the force. This is intuitive, as we often think about how the part moves when we think about dynamics. However, particularly in experimental dynamics, the practitioner may be exposed to multiple data types. Accelerometers measure accelerations of the part. Laser vibrometers measure velocities of the part. Cameras and other displacement sensors measure displacements. Therefore, it is useful to become accustomed to what, say, the frequency response function between and acceleration and a force looks like. This basically requires differentiating the response.\n",
674674
"\n",
675675
"$$x = {X e^{i\\omega t}}$$\n",
676676
"$$\\dot{x} = {i\\omega X e^{i\\omega t}}$$\n",
@@ -746,9 +746,9 @@
746746
"\n",
747747
"Looking first at the magnitude plots in the first row, we see that at low frequency, the displacement will tend to approach a value. This value is the static stiffness of the spring, because as we go to zero Hz, it is the same as applying a constant force to the structure. For this same reason, the acceleration and velocity will trend towards zero as the frequency trends towards a constant force: when the system is undergoing a static deflection, it is no longer moving or accelerating, but maintaining a constant displacement.\n",
748748
"\n",
749-
"At the high frequency, the displacement frequency response function will trend towards zero motion as the frequency goes to infinity. This is because the amount of time the force is applied before it switches directions becomes very small, so the part has less opportunity to move before the force switches direction and starts pushing it the other way. Similarly, as the acceleration will approach the value obtained if there were no spring on the system, which can be obtained by the formula $F = ma$, because as the displacements go to zero, the influence of the spring also goes to zero, so the acceleration frequency response function becomes dominated by inertial effects.\n",
749+
"At the high frequency, the displacement frequency response function will trend towards zero motion as the frequency goes to infinity. This is because the amount of time the force is applied before it switches directions becomes very small, so the part has less opportunity to move before the force switches direction and starts pushing it the other way. Because displacements go to zero at high frequency, the effect of the springs will also become negligable at high frequency. The acceleration will therefore approach the value obtained if there were no spring on the system, which can be obtained by the formula $F = ma$. As the displacements go to zero, the influence of the spring also goes to zero, so the acceleration frequency response function becomes dominated by inertial effects.\n",
750750
"\n",
751-
"The phase plots all look similar for each data type, noting, however that the phase becomes undefined at zero frequency because the amplitude becomes zero. Because the velocity is 90 degrees out of phase with the displacement and the acceleration is 180 degrees out of phase with the displacement, we see the phase plots shifted appropriately.\n",
751+
"The phase plots all look similar for each data type, noting, however that the phase of the velocity and acceleration frequency response functions becomes undefined at zero frequency because the amplitude becomes zero. Because the velocity is 90 degrees out of phase with the displacement and the acceleration is 180 degrees out of phase with the displacement, we see the phase plots shifted appropriately.\n",
752752
"\n",
753753
"The real and imaginary parts are also similar, with the main exception being that the real and imaginary parts look \"swapped\" for the velocity, which is due to the fact that the velocity is 90 degrees out of phase with both acceleration and displacement. A 90 degree rotation effectively switches the real and imaginary parts (though one of the components will have its sign flipped depending on whether or not the rotation is +90 or -90 degrees).\n",
754754
"\n",
@@ -839,7 +839,7 @@
839839
"id": "45fc515b",
840840
"metadata": {},
841841
"source": [
842-
"System objects have a number of functions that are useful for analyzing dynamics problems. For example, we can easily compute the frequency response function. We will use Numpy's array functions to construct a set of frequencies at which we will compute the frequency response function. We can also specify the response derivative (0 - displacement, 1 - velocity, 2 - acceleration). This provides a `TransferFunctionArray` object which contains the frequency response function. We can easily plot it by using its `plot` method."
842+
"System objects have a number of functions that are useful for analyzing structural dynamics problems. For example, we can easily compute the frequency response function. We will use Numpy's array functions to construct a set of frequencies at which we will compute the frequency response function. We can also specify the response derivative (0 - displacement, 1 - velocity, 2 - acceleration). This provides a `TransferFunctionArray` object which contains the frequency response function. We can easily plot it by using its `plot` method."
843843
]
844844
},
845845
{
@@ -1041,13 +1041,13 @@
10411041
"The system from Problem 1 is undergoing some design changes to modify the resonant frequency. Change the mass and stiffness of the system by +/-5% to identify what happens to the resonant frequency. Does the frequency increase or decrease as mass increases? Does the frequency increase or decrease as stiffness increases?\n",
10421042
"\n",
10431043
"### 4. Investigate Damping Changes\n",
1044-
"The system from Problem 1 is still responding too high, so we would like to increase the damping. First, compute the percent of critical damping that the system currently has. Now, increase the fraction of critical damping of the system by 20% and 40%. Plot the frequency response functions for the light damping, medium damping, high damping systems. How is the peak of the frequency response function changing? Is it changing in amplitude? Is it changing in frequency?"
1044+
"The response of the system from Problem 1 is still responding too high, so we would like to increase the damping. First, compute the percent of critical damping that the system currently has. Now, increase the fraction of critical damping of the system by 20% and 40%. Plot the frequency response functions for the light damping, medium damping, high damping systems. How is the peak of the frequency response function changing? Is it changing in amplitude? Is it changing in frequency?"
10451045
]
10461046
}
10471047
],
10481048
"metadata": {
10491049
"kernelspec": {
1050-
"display_name": "Python 3",
1050+
"display_name": "Python 3 (ipykernel)",
10511051
"language": "python",
10521052
"name": "python3"
10531053
},
@@ -1061,7 +1061,7 @@
10611061
"name": "python",
10621062
"nbconvert_exporter": "python",
10631063
"pygments_lexer": "ipython3",
1064-
"version": "3.8.10"
1064+
"version": "3.10.9"
10651065
}
10661066
},
10671067
"nbformat": 4,

docs/source/modal_tutorials/Modal_03_Multi_DoF_Vibrations/Modal_03_Multi_DoF_Vibrations.ipynb

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@
3838
"\n",
3939
"$$\\mathbf{M}\\ddot{\\mathbf{x}}+\\mathbf{K}\\mathbf{x} = \\mathbf{f}$$\n",
4040
"\n",
41-
"where the mass matrix $\\mathbf{M} = \\begin{bmatrix} m_1 & 0 \\\\ 0 & m_2\\end{bmatrix}$, the stiffness matrix $\\mathbf{K} = \\begin{bmatrix} k_1 & -k_1 \\\\ -k_1 & k_1+k_2\\end{bmatrix}$, the displacement vector $\\mathbf{x} = \\begin{bmatrix}{x}_1\\\\{x}_2\\end{bmatrix}$, and the force vector $\\mathbf{f} = \\begin{bmatrix}{f}_1\\\\{f}_2\\end{bmatrix}$. There are a few things to note here. Firstly, the mass matrix is diagonal, with zeros on the off-diagonal. This is sometimes referred to as a lumped mass matrix, because all of the mass is lumped onto each degree of freedom, the degrees of freedom do not share mass. Another node is that both the mass and stiffness matrices are diagonal. This will always be true for real systems. If degree of freedom 0 shares mass with degree of freedom 1, then that is equvalent to saying that degree of freedom 1 also shares mass degree of freedom 0. Additionally Newton's law of equal and opposite forces requires that if there is a force from degree of freedom 0 onto degree of freedom 1, then there will need to be an equal and opposite force on degree of freedom 1 on degree of freedom 0.\n",
41+
"where the mass matrix $\\mathbf{M} = \\begin{bmatrix} m_1 & 0 \\\\ 0 & m_2\\end{bmatrix}$, the stiffness matrix $\\mathbf{K} = \\begin{bmatrix} k_1 & -k_1 \\\\ -k_1 & k_1+k_2\\end{bmatrix}$, the displacement vector $\\mathbf{x} = \\begin{bmatrix}{x}_1\\\\{x}_2\\end{bmatrix}$, and the force vector $\\mathbf{f} = \\begin{bmatrix}{f}_1\\\\{f}_2\\end{bmatrix}$. There are a few things to note here. Firstly, the mass matrix is diagonal, with zeros on the off-diagonal. This is sometimes referred to as a lumped mass matrix, because all of the mass is lumped onto each degree of freedom, the degrees of freedom do not share mass. Another note is that both the mass and stiffness matrices are diagonal. This will always be true for real systems. If degree of freedom 1 shares mass with degree of freedom 2, then that is equvalent to saying that degree of freedom 2 also shares mass degree of freedom 1. Additionally Newton's law of equal and opposite forces requires that if there is a force from degree of freedom 1 onto degree of freedom 2, then there will need to be an equal and opposite force on degree of freedom 2 on degree of freedom 1.\n",
4242
"\n",
4343
"## Free Response of Multiple Degree of Freedom Systems\n",
4444
"\n",
@@ -522,7 +522,7 @@
522522
],
523523
"metadata": {
524524
"kernelspec": {
525-
"display_name": "Python 3",
525+
"display_name": "Python 3 (ipykernel)",
526526
"language": "python",
527527
"name": "python3"
528528
},
@@ -536,7 +536,7 @@
536536
"name": "python",
537537
"nbconvert_exporter": "python",
538538
"pygments_lexer": "ipython3",
539-
"version": "3.8.10"
539+
"version": "3.10.9"
540540
}
541541
},
542542
"nbformat": 4,

docs/source/usage.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -130,12 +130,12 @@ Experimental Modal Analysis
130130
~~~~~~~~~~~~~~~~~~~~~~~~~~~
131131

132132
SDynPy has the ability to fit modes to structures using the Synthesize Modes and
133-
Correlate :py:class:`sdpy.SMAC<sdynpy.modal.sdynpy_smac.SMAC>` or PolyMax
134-
:py:class:`sdpy.PolyMax<sdynpy.modal.sdynpy_polymax.PolyMax>` routines.
133+
Correlate :py:class:`sdpy.SMAC<sdynpy.modal.sdynpy_smac.SMAC>` or PolyPy
134+
:py:class:`sdpy.PolyPy<sdynpy.modal.sdynpy_polypy.PolyPy>` routines.
135135

136-
Both SMAC and PolyMax have graphical user interfaces available to make the curve
136+
Both SMAC and PolyPy have graphical user interfaces available to make the curve
137137
fitting process easier (:py:class:`sdpy.SMAC_GUI<sdynpy.modal.sdynpy_smac.SMAC_GUI>`,
138-
:py:class:`sdpy.PolyMax_GUI<sdynpy.modal.sdynpy_polymax.PolyMax_GUI>`). These can be
138+
:py:class:`sdpy.PolyPy_GUI<sdynpy.modal.sdynpy_polypy.PolyPy_GUI>`). These can be
139139
run from an IPython console.
140140

141141
Included in SDynPy is interactive plotting capabilities where mode shapes can

0 commit comments

Comments
 (0)