3diy
/
klipper
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Reword smoothed look-ahead description in Kinematics 

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2017-05-01 11:27:14 -04:00
parent 631b0e6c37
commit e177d4f70d
2 changed files with 15 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/Features.md
View File

@ -44,7 +44,7 @@ Klipper has several compelling features:
that can dramatically improve the accuracy of typical endstop that can dramatically improve the accuracy of typical endstop
switches. When properly tuned it can improve a print's first layer switches. When properly tuned it can improve a print's first layer
bed adhesion. bed adhesion.
* Support for limiting the top speed of short "zig-zag" moves to * Support for limiting the top speed of short "zigzag" moves to
reduce printer vibration and noise. See the reduce printer vibration and noise. See the
[kinematics](Kinematics.md) document for more information. [kinematics](Kinematics.md) document for more information.

25
docs/Kinematics.md
View File

@ -101,7 +101,7 @@ Smoothed look-ahead
------------------- -------------------
Klipper also implements a mechanism for smoothing out the motions of Klipper also implements a mechanism for smoothing out the motions of
short "zig-zag" moves. Consider the following moves: short "zigzag" moves. Consider the following moves:
![zigzag](img/zigzag.svg.png) ![zigzag](img/zigzag.svg.png)
@ -109,20 +109,23 @@ In the above, the frequent changes from acceleration to deceleration
can cause the machine to vibrate which causes stress on the machine can cause the machine to vibrate which causes stress on the machine
and increases the noise. To reduce this, Klipper tracks both regular and increases the noise. To reduce this, Klipper tracks both regular
move acceleration as well as a virtual "acceleration to deceleration" move acceleration as well as a virtual "acceleration to deceleration"
rate. Using this system, the top speed of these short "zig zag" moves rate. Using this system, the top speed of these short "zigzag" moves
are limited to smooth out the printer motion: are limited to smooth out the printer motion:
![smoothed](img/smoothed.svg.png) ![smoothed](img/smoothed.svg.png)
In the above, note the dashed gray lines - this is a graphical Specifically, the code calculates what the velocity of each move would
representation of the "pseudo acceleration". Where the two dashed be if it were limited to this virtual "acceleration to deceleration"
lines meet enforces a limit on the move's top speed. For most moves rate (half the normal acceleration rate by default). In the above
the limit will be at or above the move's existing limits and no change picture the dashed gray lines represent this virtual acceleration rate
in behavior is induced. However, for short "zig-zag" moves the limit for the first move. If a move can not reach its full cruising speed
comes into play and it reduces the top speed. Note that the grey lines using this virtual acceleration rate then its top speed is reduced to
represent a pseudo-acceleration to limit top speed only - the move the maximum speed it could obtain at this virtual acceleration
continues to use it's normal acceleration scheme up to its adjusted rate. For most moves the limit will be at or above the move's existing
top-speed. limits and no change in behavior is induced. For short zigzag moves,
however, this limit reduces the top speed. Note that it does not
change the actual acceleration within the move - the move continues to
use the normal acceleration scheme up to its adjusted top-speed.
Generating steps Generating steps
================ ================