Skip to content

Commit

Permalink
Fix source comment typos
Browse files Browse the repository at this point in the history
  • Loading branch information
luzpaz committed Sep 9, 2024
1 parent 91f7038 commit 4956140
Show file tree
Hide file tree
Showing 2 changed files with 2 additions and 2 deletions.
2 changes: 1 addition & 1 deletion testapp/camfollower.asmt
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
freeCAD: 3D CAD with Motion Simulation by askoh.com
Assembly
Notes
(Text string: 'CAD: Copyright (C) 2000-2004, Aik-Siong Koh, All Rights Reserved.<n><n>An elliptical cam rotates with a follower beam resting on it. The beam is pivoted at one end. When the cam angular velocity is low the beam remains in contact at all times. When the cam angular velocity is high, the beam liftoffs and falls back onto the cam resulting in a hard impact and rebound. The rebound is based on the coefficient of restitution which the user can set.<n><n>If the instructions below are too brief, refer to the Notes in projectile.asm and circular.asm.<n><n>To load the example for a quick look:<n>Click File/Open/Assembly/ to get a dialog. Enter *.asm for a list of assemblies. Select camfollower.asm. <n><n>To create the assembly from scratch:<n>To create an elliptical cam:<n>Create an empty assembly. <n>Create an elliptical cam center at the part origin,<n>major axis of 1.0d in x-direction,<n>minor axis of 0.5d in y-direction,<n>extrusion (0.0d, 1.0d),<n>uniform density of 10.0d.<n><n>To connect the cam to the assembly with a revolute (pin) joint:<n>To mark the joint attachment point on the assembly:<n>If necessary, drag the elliptical cam to the upper right to clear up the area near the origin.<n>Create a marker at the origin of the assembly.<n><n>To mark the joint attachment point on the cam:<n>Click on the z face of the elliptical cam to hightlight it.<n>Create a marker at the origin of the face.<n><n>To create the joint:<n>Create a revolute joint from the assembly marker to the cam marker.<n><n>To apply a motion to the cam:<n>Create a RotationZ motion on the revolute joint.<n>Enter prescribed function 0.5d*pi*time. (Follower will remain in contact throughout cam circle. 2.0d*pi*time will cause lift off.)<n><n>To create the follower:<n>Click Assembly1 in the Tree View.<n>Click Select/Plane/x=X y=Y/ to select the XY plane of the assembly.<n>Click Insert/Part/New/ to insert a Part2 on the selected plane.<n>Click Insert/Sketch/ to insert a Sketch1 on the new part.<n>Click Draw/Polyline/ to select the polyline tool. In the drawing area, click, move, click move to create a three sided polyline going counter clockwise. Double click to close the polygon. Click inside the polygon if the vertex handles are not visible. RightClick/Position/Angle/ to get a dialog to enter coordinates of the polygon vertices. Enter the xy coordinates: (0.0d , 0.0d) (4.0d, 0.0d) (4.0d, 0.2d) (0.0d 0.2d) (0.0d, 0.0d). Insert or delete rows as necessary to achieve the rectangle. Click OK. (Alternatively, import camfollower.txt).<n>To make the curve-curve contact joint work properly, we must add more vertices to the rectangle. The contact joint uses the vertices for collision detection and to help the solver converge to the exact solution. The denser the vertices, the more reliable collision detection will be; but the computation takes longer.<n>Select the rectangle to highlight the vertices. RightClick/Insert After/ over a handle to insert a vertex at mid span. Do that many times until the length of the beam has sixteen equal spans. Repeat for the other length.<n>Click Insert/Feature/Extrusion/ to extrude the drawing perpendicular to the sketch plane. A dialog allows you to specify the z coordinates for extrusion (0.0d, 1.0d).<n>RightClick/Position/Direction/ over the part mass marker to get a dialog to specify its mass and inertias precisely. Click ''Apply Uniform Density''. Enter the density (10.0d).<n><n>To connect the follower to the assembly with a revolute (pin) joint:<n>To mark the joint attachment point on the assembly:<n>Create another assembly marker and position it at<n>(2.5d, 0.0d, 0.0d). <n><n>To mark the joint attachment point on the follower:<n>Click on the z face of the follower beam to highlight it.<n>Click Insert/Marker/. A dialog allows you to specify a unique name (Marker1). A RedGreenBlue (RGB) marker representing the xyz axes appears at the face origin. The marker is referenced to the face which becomes the marker''s guide frame. Click on the marker if its black handle is not showing. RightClick/Position/ to position it at (3.5d, 0.1d, 0.0d). <n><n>To create the joint:<n>Create a revolute joint from the assembly marker /Assembly1/Marker2/ to the follower marker /Part2/Marker1/.<n><n>To create curve-curve contact between cam and follower:<n>Click Kinematic/Joint/Curve On Curve/ to select the contact joint tool. Click on the z face of the elliptical cam, drag to the z face of the beam, and release the button. Dialogs allow you to specify names for the joint (Joint3), the ''i'' curve marker (Marker2), the ''j'' curve marker (Marker2) and to specify the <n>coefficient of restitution (0.5d). A rubber band connects the ''i'' and ''j'' markers with an label ''cvcv'' to denote the contact joint.<n>The contact joint can start separated or in contact. If the cam and follower are positioned to overlap, then the two curves will start in contact. Otherwise they will start separated.<n><n>To simulate:<n>Click Simulation/Transient/ to start a simulation. Click ''current state'' for the desired input state. In the subsequent dialog, set the desired <n>end time (4.0d), <n>output time step (0.04d) and <n>maximum time step (0.04d) of the simulation. For contact problems, it is important to limit the maximum time step taken by the integrator so that separation and collision events are not missed.<n>Click OK to start the simulation. The simulation progress is shown in the Transcript window and animated in the drawing. You can use any of the View menu items during the simulation. Let the simulation run to completion or Click Simulation/Stop/ to terminate the simulation anytime.<n><n>To animate:<n>Click ''Animation'' for a animation control window to play the animation, step frame by frame, jump to the specified current frame. You can also use any of the View menu items during the animation. Click Stop to stop the animation. Close the window when done.<n><n>To plot curve-curve data:<n>Click curve-curve in the Tree or Graphic Views. RightClick/Plot to get a plot window. Click Plot/Select/ to choose the x and y variables to plot.<n><n>Known problems:<n>Curve-curve contact is not reliable when it cannot detect separation or overlap clearly at the start. Therefore, make the curves distinctly separated or distinctly overlapping before starting the simulation.<n><n>If curve-curve is not reliable during simulation, it is probably due to insufficient vertices in curves. Stop the simulation, delete the cvcv joint, select the sketch of the solid to get the polygon, insert more vertices, extrude to get the solid, then reapply cvcv joint. It is also important to limit the maximum time step taken by the integrator so that separation and collision events are not missed.<n>' runs: (Core.RunArray runs: #(445 63 14 5 12 1 2 37 108 36 1 28 201 63 1 51 144 46 105 20 70 29 182 23 41 21 47 16 48 14 44 14 232 26 633 24 155 25 312 68 1 51 73 51 65 14 273 20 41 20 111 55 7 31 593 12 7 21 31 13 545 16 39 11 8 9 142 4 40 4 53 25 49 15 29 12 43 15 615) values: #(nil #underline #(#underline #bold) #underline #(#underline #bold) #underline nil #(#bold #large) nil #(#bold #large) nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil)))
(Text string: 'CAD: Copyright (C) 2000-2004, Aik-Siong Koh, All Rights Reserved.<n><n>An elliptical cam rotates with a follower beam resting on it. The beam is pivoted at one end. When the cam angular velocity is low the beam remains in contact at all times. When the cam angular velocity is high, the beam liftoffs and falls back onto the cam resulting in a hard impact and rebound. The rebound is based on the coefficient of restitution which the user can set.<n><n>If the instructions below are too brief, refer to the Notes in projectile.asm and circular.asm.<n><n>To load the example for a quick look:<n>Click File/Open/Assembly/ to get a dialog. Enter *.asm for a list of assemblies. Select camfollower.asm. <n><n>To create the assembly from scratch:<n>To create an elliptical cam:<n>Create an empty assembly. <n>Create an elliptical cam center at the part origin,<n>major axis of 1.0d in x-direction,<n>minor axis of 0.5d in y-direction,<n>extrusion (0.0d, 1.0d),<n>uniform density of 10.0d.<n><n>To connect the cam to the assembly with a revolute (pin) joint:<n>To mark the joint attachment point on the assembly:<n>If necessary, drag the elliptical cam to the upper right to clear up the area near the origin.<n>Create a marker at the origin of the assembly.<n><n>To mark the joint attachment point on the cam:<n>Click on the z face of the elliptical cam to highlight it.<n>Create a marker at the origin of the face.<n><n>To create the joint:<n>Create a revolute joint from the assembly marker to the cam marker.<n><n>To apply a motion to the cam:<n>Create a RotationZ motion on the revolute joint.<n>Enter prescribed function 0.5d*pi*time. (Follower will remain in contact throughout cam circle. 2.0d*pi*time will cause lift off.)<n><n>To create the follower:<n>Click Assembly1 in the Tree View.<n>Click Select/Plane/x=X y=Y/ to select the XY plane of the assembly.<n>Click Insert/Part/New/ to insert a Part2 on the selected plane.<n>Click Insert/Sketch/ to insert a Sketch1 on the new part.<n>Click Draw/Polyline/ to select the polyline tool. In the drawing area, click, move, click move to create a three sided polyline going counter clockwise. Double click to close the polygon. Click inside the polygon if the vertex handles are not visible. RightClick/Position/Angle/ to get a dialog to enter coordinates of the polygon vertices. Enter the xy coordinates: (0.0d , 0.0d) (4.0d, 0.0d) (4.0d, 0.2d) (0.0d 0.2d) (0.0d, 0.0d). Insert or delete rows as necessary to achieve the rectangle. Click OK. (Alternatively, import camfollower.txt).<n>To make the curve-curve contact joint work properly, we must add more vertices to the rectangle. The contact joint uses the vertices for collision detection and to help the solver converge to the exact solution. The denser the vertices, the more reliable collision detection will be; but the computation takes longer.<n>Select the rectangle to highlight the vertices. RightClick/Insert After/ over a handle to insert a vertex at mid span. Do that many times until the length of the beam has sixteen equal spans. Repeat for the other length.<n>Click Insert/Feature/Extrusion/ to extrude the drawing perpendicular to the sketch plane. A dialog allows you to specify the z coordinates for extrusion (0.0d, 1.0d).<n>RightClick/Position/Direction/ over the part mass marker to get a dialog to specify its mass and inertias precisely. Click ''Apply Uniform Density''. Enter the density (10.0d).<n><n>To connect the follower to the assembly with a revolute (pin) joint:<n>To mark the joint attachment point on the assembly:<n>Create another assembly marker and position it at<n>(2.5d, 0.0d, 0.0d). <n><n>To mark the joint attachment point on the follower:<n>Click on the z face of the follower beam to highlight it.<n>Click Insert/Marker/. A dialog allows you to specify a unique name (Marker1). A RedGreenBlue (RGB) marker representing the xyz axes appears at the face origin. The marker is referenced to the face which becomes the marker''s guide frame. Click on the marker if its black handle is not showing. RightClick/Position/ to position it at (3.5d, 0.1d, 0.0d). <n><n>To create the joint:<n>Create a revolute joint from the assembly marker /Assembly1/Marker2/ to the follower marker /Part2/Marker1/.<n><n>To create curve-curve contact between cam and follower:<n>Click Kinematic/Joint/Curve On Curve/ to select the contact joint tool. Click on the z face of the elliptical cam, drag to the z face of the beam, and release the button. Dialogs allow you to specify names for the joint (Joint3), the ''i'' curve marker (Marker2), the ''j'' curve marker (Marker2) and to specify the <n>coefficient of restitution (0.5d). A rubber band connects the ''i'' and ''j'' markers with an label ''cvcv'' to denote the contact joint.<n>The contact joint can start separated or in contact. If the cam and follower are positioned to overlap, then the two curves will start in contact. Otherwise they will start separated.<n><n>To simulate:<n>Click Simulation/Transient/ to start a simulation. Click ''current state'' for the desired input state. In the subsequent dialog, set the desired <n>end time (4.0d), <n>output time step (0.04d) and <n>maximum time step (0.04d) of the simulation. For contact problems, it is important to limit the maximum time step taken by the integrator so that separation and collision events are not missed.<n>Click OK to start the simulation. The simulation progress is shown in the Transcript window and animated in the drawing. You can use any of the View menu items during the simulation. Let the simulation run to completion or Click Simulation/Stop/ to terminate the simulation anytime.<n><n>To animate:<n>Click ''Animation'' for a animation control window to play the animation, step frame by frame, jump to the specified current frame. You can also use any of the View menu items during the animation. Click Stop to stop the animation. Close the window when done.<n><n>To plot curve-curve data:<n>Click curve-curve in the Tree or Graphic Views. RightClick/Plot to get a plot window. Click Plot/Select/ to choose the x and y variables to plot.<n><n>Known problems:<n>Curve-curve contact is not reliable when it cannot detect separation or overlap clearly at the start. Therefore, make the curves distinctly separated or distinctly overlapping before starting the simulation.<n><n>If curve-curve is not reliable during simulation, it is probably due to insufficient vertices in curves. Stop the simulation, delete the cvcv joint, select the sketch of the solid to get the polygon, insert more vertices, extrude to get the solid, then reapply cvcv joint. It is also important to limit the maximum time step taken by the integrator so that separation and collision events are not missed.<n>' runs: (Core.RunArray runs: #(445 63 14 5 12 1 2 37 108 36 1 28 201 63 1 51 144 46 105 20 70 29 182 23 41 21 47 16 48 14 44 14 232 26 633 24 155 25 312 68 1 51 73 51 65 14 273 20 41 20 111 55 7 31 593 12 7 21 31 13 545 16 39 11 8 9 142 4 40 4 53 25 49 15 29 12 43 15 615) values: #(nil #underline #(#underline #bold) #underline #(#underline #bold) #underline nil #(#bold #large) nil #(#bold #large) nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil #bold nil)))
Name
Assembly1
Position3D
Expand Down
Loading

0 comments on commit 4956140

Please sign in to comment.