Input Shaper in Klipper for 3D Printing: What It Is and How It Works

In Klipper firmware for 3D printing, input shaper is a feature that reduces printer vibrations by adjusting motion commands to cancel out oscillations. It works by timing movements to avoid exciting the printer's natural shaking, resulting in smoother and more accurate prints.

How It Works

Input shaper in Klipper works like a smart filter for the printer's movements. Imagine pushing a swing: if you push at the wrong time, the swing shakes more, but if you push at the right moments, you can stop it from swinging wildly. Input shaper times the printer's motor commands to avoid causing these unwanted shakes or vibrations.

It does this by measuring the printer's natural vibration frequencies and then modifying the movement commands to cancel out those vibrations. This means the printer's parts move more smoothly, which helps improve print quality by reducing blurring or ringing effects on the printed object.

Example

Here is a simple example of how to enable input shaper in a Klipper configuration file. This snippet sets up a basic input shaper using the 'mzv' method with a frequency of 40 Hz and a damping factor of 0.1.

ini

[input_shaper]
shaper_type = mzv
shaper_freq_x = 40.0
shaper_damping = 0.1
shaper_freq_y = 40.0

Output

Input shaper enabled with mzv method at 40 Hz frequency and 0.1 damping on X and Y axes.

When to Use

Use input shaper when your 3D printer shows visible ringing or ghosting on prints, which are signs of vibrations affecting print quality. It is especially helpful for printers with fast or long travel moves, such as CoreXY or belt-driven models.

Input shaper can allow you to print faster without losing quality because it reduces the need to slow down to avoid vibrations. It is also useful when upgrading your printer with lighter or stiffer parts that change vibration behavior.

Key Points

• Input shaper reduces printer vibrations by timing motor commands.
• It improves print quality by minimizing ringing and ghosting.
• Requires tuning to find the printer's vibration frequencies.
• Works best on printers with noticeable vibration issues.
• Allows faster printing without sacrificing quality.

Key Takeaways

Input shaper in Klipper reduces vibrations by adjusting motion timing to cancel oscillations.

It improves print quality by minimizing ringing and ghosting effects.

Tuning input shaper requires measuring your printer's vibration frequencies.

Using input shaper can enable faster printing without losing accuracy.

It is most useful on printers with visible vibration-related print defects.