Skip to content

Commit 6c0a910

Browse files
Docstring for SpringDamper
1 parent 3b0bf64 commit 6c0a910

File tree

1 file changed

+27
-4
lines changed

1 file changed

+27
-4
lines changed

src/Mechanical/PlanarMechanics/components.jl

Lines changed: 27 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ end
107107

108108
"""
109109
FixedTranslation(; name, r::AbstractArray, l)
110+
110111
A fixed translation between two components (rigid rod)
111112
112113
# Parameters:
@@ -116,8 +117,8 @@ A fixed translation between two components (rigid rod)
116117
117118
# Connectors:
118119
119-
- `frame_a` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
120-
- `frame_b` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
120+
- `frame_a` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
121+
- `frame_b` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
121122
"""
122123
@mtkmodel FixedTranslation begin
123124
@extend frame_a, frame_b = partial_frames = PartialTwoFrames()
@@ -152,8 +153,30 @@ A fixed translation between two components (rigid rod)
152153
end
153154

154155
"""
156+
SpringDamper(; name, c_x = 1, c_y = 1, c_phi = 1e5, d_x = 1, d_y = 1, d_phi = 1, s_relx0 = 0, s_rely0 = 0, phi_rel0 = 0, s_small = 1.e-10)
157+
158+
Linear 2D translational spring damper model
159+
160+
# Parameters:
161+
162+
- `c_x`: [N/m] Spring constant in x dir
163+
- `c_y`: [N/m] Spring constant in y dir
164+
- `c_phi`: [N.m/rad] Spring constant in phi dir
165+
- `d_x`: [N.s/m] Damping constant in x dir
166+
- `d_y`: [N.s/m] Damping constant in y dir
167+
- `d_phi`: [N.m.s/rad] Damping constant in phi dir
168+
- `s_relx0`: [m] Unstretched spring length
169+
- `s_rely0`: [m] Unstretched spring length
170+
- `phi_rel0`: [rad] Unstretched spring angle
171+
- `s_small`: [m] Prevent zero-division if distance between frame_a and frame_b is zero
172+
173+
174+
# Connectors:
175+
176+
- `frame_a` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
177+
- `frame_b` [Frame](@ref) Coordinate system fixed to the component with one cut-force and cut-torque
155178
156-
https://github.com/dzimmer/PlanarMechanics/blob/743462f58858a808202be93b708391461cbe2523/PlanarMechanics/Parts/SpringDamper.mo#L154C20-L154C20
179+
https://github.com/dzimmer/PlanarMechanics/blob/743462f58858a808202be93b708391461cbe2523/PlanarMechanics/Parts/SpringDamper.mo
157180
"""
158181
@mtkmodel SpringDamper begin
159182
@extend frame_a, frame_b = partial_frames = PartialTwoFrames()
@@ -167,7 +190,7 @@ https://github.com/dzimmer/PlanarMechanics/blob/743462f58858a808202be93b70839146
167190
d_phi = 1, [description = "Damping constant in phi dir"]
168191
s_relx0 = 0, [description = "Unstretched spring length"]
169192
s_rely0 = 0, [description = "Unstretched spring length"]
170-
phi_rel0 = 0, [description = "Unstretched spring length"]
193+
phi_rel0 = 0, [description = "Unstretched spring angle"]
171194
s_small = 1.e-10,
172195
[
173196
description = "Prevent zero-division if distance between frame_a and frame_b is zero",

0 commit comments

Comments
 (0)