Deploying to gh-pages from @ 0105aa3 🚀

Config_Changes.html

@@ -1337,6 +1337,13 @@ <h1 id="configuration-changes">Configuration Changes<a class="headerlink" href="
 document when upgrading the Klipper software.</p>
 <p>All dates in this document are approximate.</p>
 <h2 id="changes">Changes<a class="headerlink" href="#changes" title="Permanent link">&para;</a></h2>
+<p>20240313: The <code>max_accel_to_decel</code> parameter in the <code>[printer]</code> config
+section has been deprecated. The <code>ACCEL_TO_DECEL</code> parameter of the
+<code>SET_VELOCITY_LIMIT</code> command has been deprecated. The
+<code>printer.toolhead.max_accel_to_decel</code> status has been removed. Use the
+<a href="Config_Reference.html#printer">minimum_cruise_ratio parameter</a>
+instead. The deprecated features will be removed in the near future,
+and using them in the interim may result in subtly different behavior.</p>
 <p>20240215: Several deprecated features have been removed. Using "NTC
 100K beta 3950" as a thermistor name has been removed (deprecated on
 20211110). The <code>SYNC_STEPPER_TO_EXTRUDER</code> and

Config_Reference.html

@@ -3789,13 +3789,22 @@ <h3 id="printer">[printer]<a class="headerlink" href="#printer" title="Permanent
 #   will do so at the rate specified here. The value specified here
 #   may be changed at runtime using the SET_VELOCITY_LIMIT command.
 #   This parameter must be specified.
-#max_accel_to_decel:
-#   A pseudo acceleration (in mm/s^2) controlling how fast the
-#   toolhead may go from acceleration to deceleration. It is used to
-#   reduce the top speed of short zig-zag moves (and thus reduce
-#   printer vibration from these moves). The value specified here may
-#   be changed at runtime using the SET_VELOCITY_LIMIT command. The
-#   default is half of max_accel.
+#minimum_cruise_ratio: 0.5
+#   Most moves will accelerate to a cruising speed, travel at that
+#   cruising speed, and then decelerate. However, some moves that
+#   travel a short distance could nominally accelerate and then
+#   immediately decelerate. This option reduces the top speed of these
+#   moves to ensure there is always a minimum distance traveled at a
+#   cruising speed. That is, it enforces a minimum distance traveled
+#   at cruising speed relative to the total distance traveled. It is
+#   intended to reduce the top speed of short zigzag moves (and thus
+#   reduce printer vibration from these moves). For example, a
+#   minimum_cruise_ratio of 0.5 would ensure that a standalone 1.5mm
+#   move would have a minimum cruising distance of 0.75mm. Specify a
+#   ratio of 0.0 to disable this feature (there would be no minimum
+#   cruising distance enforced between acceleration and deceleration).
+#   The value specified here may be changed at runtime using the
+#   SET_VELOCITY_LIMIT command. The default is 0.5.
 #square_corner_velocity: 5.0
 #   The maximum velocity (in mm/s) that the toolhead may travel a 90
 #   degree corner at. A non-zero value can reduce changes in extruder
@@ -3808,6 +3817,8 @@ <h3 id="printer">[printer]<a class="headerlink" href="#printer" title="Permanent
 #   decelerate to zero at each corner. The value specified here may be
 #   changed at runtime using the SET_VELOCITY_LIMIT command. The
 #   default is 5mm/s.
+#max_accel_to_decel:
+#   This parameter is deprecated and should no longer be used.
 </code></pre></div>
 
 <h3 id="stepper">[stepper]<a class="headerlink" href="#stepper" title="Permanent link">&para;</a></h3>

G-Codes.html

@@ -5565,7 +5565,7 @@ <h3 id="toolhead">[toolhead]<a class="headerlink" href="#toolhead" title="Perman
 <p>The toolhead module is automatically loaded.</p>
 <h4 id="set_velocity_limit">SET_VELOCITY_LIMIT<a class="headerlink" href="#set_velocity_limit" title="Permanent link">&para;</a></h4>
 <p><code>SET_VELOCITY_LIMIT [VELOCITY=&lt;value&gt;] [ACCEL=&lt;value&gt;]
-[ACCEL_TO_DECEL=&lt;value&gt;] [SQUARE_CORNER_VELOCITY=&lt;value&gt;]</code>: This
+[MINIMUM_CRUISE_RATIO=&lt;value&gt;] [SQUARE_CORNER_VELOCITY=&lt;value&gt;]</code>: This
 command can alter the velocity limits that were specified in the
 printer config file. See the
 <a href="Config_Reference.html#printer">printer config section</a> for a

Kinematics.html

@@ -983,8 +983,8 @@
       <ul class="md-nav__list">
 
           <li class="md-nav__item">
-  <a href="#smoothed-look-ahead" class="md-nav__link">
-    Smoothed look-ahead
+  <a href="#minimum-cruise-ratio" class="md-nav__link">
+    Minimum cruise ratio
   </a>
 
 </li>
@@ -1414,8 +1414,8 @@
       <ul class="md-nav__list">
 
           <li class="md-nav__item">
-  <a href="#smoothed-look-ahead" class="md-nav__link">
-    Smoothed look-ahead
+  <a href="#minimum-cruise-ratio" class="md-nav__link">
+    Minimum cruise ratio
   </a>
 
 </li>
@@ -1572,25 +1572,29 @@ <h2 id="look-ahead">Look-ahead<a class="headerlink" href="#look-ahead" title="Pe
 <div class="highlight"><pre><span></span><code>end_velocity^2 = start_velocity^2 + 2*accel*move_distance
 </code></pre></div>
 
-<h3 id="smoothed-look-ahead">Smoothed look-ahead<a class="headerlink" href="#smoothed-look-ahead" title="Permanent link">&para;</a></h3>
+<h3 id="minimum-cruise-ratio">Minimum cruise ratio<a class="headerlink" href="#minimum-cruise-ratio" title="Permanent link">&para;</a></h3>
 <p>Klipper also implements a mechanism for smoothing out the motions of
 short "zigzag" moves. Consider the following moves:</p>
 <p><img alt="zigzag" src="img/zigzag.svg.png" /></p>
 <p>In the above, the frequent changes from acceleration to deceleration
 can cause the machine to vibrate which causes stress on the machine
-and increases the noise. To reduce this, Klipper tracks both regular
-move acceleration as well as a virtual "acceleration to deceleration"
-rate. Using this system, the top speed of these short "zigzag" moves
-are limited to smooth out the printer motion:</p>
+and increases the noise. Klipper implements a mechanism to ensure
+there is always some movement at a cruising speed between acceleration
+and deceleration. This is done by reducing the top speed of some moves
+(or sequence of moves) to ensure there is a minimum distance traveled
+at cruising speed relative to the distance traveled during
+acceleration and deceleration.</p>
+<p>Klipper implements this feature by tracking both a regular move
+acceleration as well as a virtual "acceleration to deceleration" rate:</p>
 <p><img alt="smoothed" src="img/smoothed.svg.png" /></p>
 <p>Specifically, the code calculates what the velocity of each move would
 be if it were limited to this virtual "acceleration to deceleration"
-rate (half the normal acceleration rate by default). In the above
-picture the dashed gray lines represent this virtual acceleration rate
-for the first move. If a move can not reach its full cruising speed
-using this virtual acceleration rate then its top speed is reduced to
-the maximum speed it could obtain at this virtual acceleration
-rate. For most moves the limit will be at or above the move's existing
+rate. In the above picture the dashed gray lines represent this
+virtual acceleration rate for the first move. If a move can not reach
+its full cruising speed using this virtual acceleration rate then its
+top speed is reduced to the maximum speed it could obtain at this
+virtual acceleration rate.</p>
+<p>For most moves the limit will be at or above the move's existing
 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

Resonance_Compensation.html

@@ -1622,8 +1622,8 @@ <h3 id="ringing-frequency">Ringing frequency<a class="headerlink" href="#ringing
    to 5.0. It is not advised to increase it when using input shaper
    because it can cause more smoothing in parts - it is better to use
    higher acceleration value instead.</li>
-<li>Increase <code>max_accel_to_decel</code> by issuing the following command:
-   <code>SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000</code></li>
+<li>Disable the <code>miminum_cruise_ratio</code> feature by issuing the following
+   command: <code>SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0</code></li>
 <li>Disable Pressure Advance: <code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
 <li>If you have already added <code>[input_shaper]</code> section to the printer.cfg,
    execute <code>SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0</code> command. If you
@@ -1714,7 +1714,7 @@ <h3 id="choosing-input-shaper">Choosing input shaper<a class="headerlink" href="
 <p>Print the ringing test model as follows:</p>
 <ol>
 <li>Restart the firmware: <code>RESTART</code></li>
-<li>Prepare for test: <code>SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000</code></li>
+<li>Prepare for test: <code>SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0</code></li>
 <li>Disable Pressure Advance: <code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
 <li>Execute: <code>SET_INPUT_SHAPER SHAPER_TYPE=MZV</code></li>
 <li>Execute the command:
@@ -1814,7 +1814,7 @@ <h3 id="fine-tuning-resonance-frequencies">Fine-tuning resonance frequencies<a c
 <p>Assuming that you have sliced the ringing model with suggested
 parameters, complete the following steps for each of the axes X and Y:</p>
 <ol>
-<li>Prepare for test: <code>SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000</code></li>
+<li>Prepare for test: <code>SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0</code></li>
 <li>Make sure Pressure Advance is disabled: <code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
 <li>Execute: <code>SET_INPUT_SHAPER SHAPER_TYPE=ZV</code></li>
 <li>From the existing ringing test model with your chosen input shaper select
@@ -1867,7 +1867,7 @@ <h3 id="unreliable-measurements-of-ringing-frequencies">Unreliable measurements
 follows. First time, prior to printing, run</p>
 <ol>
 <li><code>RESTART</code></li>
-<li><code>SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000</code></li>
+<li><code>SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0</code></li>
 <li><code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
 <li><code>SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60</code></li>
 <li><code>TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5</code></li>

Status_Reference.html

@@ -2478,7 +2478,7 @@ <h2 id="toolhead">toolhead<a class="headerlink" href="#toolhead" title="Permanen
   limit value (eg, <code>axis_minimum.x</code>, <code>axis_maximum.z</code>).</li>
 <li>For Delta printers the <code>cone_start_z</code> is the max z height at
   maximum radius (<code>printer.toolhead.cone_start_z</code>).</li>
-<li><code>max_velocity</code>, <code>max_accel</code>, <code>max_accel_to_decel</code>,
+<li><code>max_velocity</code>, <code>max_accel</code>, <code>minimum_cruise_ratio</code>,
   <code>square_corner_velocity</code>: The current printing limits that are in
   effect. This may differ from the config file settings if a
   <code>SET_VELOCITY_LIMIT</code> (or <code>M204</code>) command alters them at run-time.</li>