Input Shaping Calibration Pattern
Based on the excellent work of @tombrazier
Caution! Only for Cartesian printers. CoreXY kinematics are not yet tested.
Use this form to generate G-code that you can use to calibrate your Input Shaping Damping Frequency and Zeta/Damping factor. Default values apply to standard PLA filament and a 0.4mm nozzle.
The generated G-code files print Frequency Sweeps (zigzag patterns with increasing speeds) to find Resonant Frequencies (frequencies to dampen) and Zeta/Damping Factors for the X axis (left-to-right) and Y axis (front-to-back).
Three separate G-code files are generated for download:
- Damping Frequency to find Resonant Frequency for X and Y (displayed in the box below)
- X Zeta/Damping Factor (not shown)
- Y Zeta/Damping Factor (not shown)
Fill out the form and press Generate G-code to create the test patterns. Use the Download * as file buttons to save the results.
Settings | G-code | ||||
Printer Info | |||||
Diameter (mm) of the filament used for the tests | |||||
Nozzle Temperature (°C) | |||||
Bed Temperature (°C) | |||||
Retraction distance after pattern (mm) | |||||
Line width (mm) | |||||
Layer Height (mm). If pattern is not clear, try to increase Layer Height | |||||
Fan Speed (%) | |||||
Speed | |||||
Printing speed when not in pattern (mm/s) | |||||
Travel Speed (mm/s) | |||||
Retract Speed of the extruder (mm/s) | |||||
Printing and transition acceleration/deceleration (mm/s^2) | |||||
Jerk for X and Y when not in pattern. -1 to use pattern default | |||||
Junction Deviation when not in pattern. -1.0 to use pattern default | |||||
Print Bed | |||||
Size (mm) of the bed in X | |||||
Size (mm) of the bed in Y | |||||
Pattern | |||||
Maximum frequency (Hz) for X pattern | |||||
Maximum frequency (Hz) for Y pattern | |||||
Offset the Z (mm) for manual layer adjustment | |||||
Level the bed or load a saved mesh (UBL only!) before printing. Bed leveling must be activated in Configuration.h! | |||||
Usually 1.0 | |||||
Align the Z gantry by running the G34 command | |||||
Notes:
- Max X Frequency and Max Y Frequency should be high enough to reach Resonant Frequency. The moving bed of a "bedslinger" printer usually has a lower Resonant Frequency corresponding to its greater mass. Adjust values after your first test print and as-needed to match the printer.
- Use Bed Leveling requires a probe.
- Printer and other parts (e.g., filament spool) may resonate and emit sounds during Frequency Sweeps.
- The printer's stepper motors may skip steps leading to lost position —aka "layer shift"— at or above the Resonant Frequency. This is normal behaviour.
- Be aware that high speeds may exceed what your extruder can handle. A 60Hz frequency corresponds to 120mm/s (7200 mm/min) movement speed. For the default 0.5mm line width and 0.2mm layer height the machine needs to extrude 12 cubic mm of filament per second. Know your extruder's limits.
- If the test patterns show asymmetry or vibration in the Z direction, linear motion might have slack or flex (e.g., from loose roller wheels). See the image below.
- Input Shaping can affect Linear Advance. If Linear Advance is enabled, calibrate K-factor after calibrating Input Shaping.
Examples
The following images demonstrate some test patterns.
Damping Frequency Pattern theory
- Frequency sweep patterns are printed for both axes.
- As the Frequency approaches the Resonant Frequency the vibration Amplitude increases.
- At Resonant Frequency amplitude reaches it's peak.
- Beyond Resonant Frequency amplitude may remain high or decrease.
- Measuring the distance (mm) from the beginning of the pattern to the point of amplitude peak reveals Resonant Frequency, where frequency is this distance divided by 2.
- To reduce ringing, Input Shaping tries to dampen Resonant Frequency, aka. Damping Frequency.
![DampingFrequencyDrawing](/assets/images/features/freq-calibr/frequency-drawing.png)
Zeta/Damping Factor theory
- Damping Factor sweep patterns are printed for both axes.
- The Damping Factor controls damping. (See the image below.)
- Damping Too Low: Vibration is not cancelled at Damping Frequency.
- Damping Correct (critical): Vibration is cancelled at Damping Frequency.
- Damping Too High: Vibration is reduced too aggressively also below Damping Frequency.
- To find the best value look for the zigzag pattern with the most uniform amplitude at and below the Damping Frequency and the same or decreased amplitude above the Damping Frequency.
![DampingFactorDrawing](/assets/images/features/freq-calibr/damping-drawing.png)
Damping Frequency Pattern - Example 1
![DampingFrequencyPattern](/assets/images/features/freq-calibr/freq-pattern-1.jpg)
Zeta/Damping Factor Pattern - Example 1
![ZetaDampingFactorPattern](/assets/images/features/freq-calibr/zeta-pattern-y-1.jpg)
Damping Frequency Pattern - Example 2
This print consists of:
- Frame (back and left lines)
- Y Frequency Sweep (horizontal at front)
- Slowdown
- X Frequency Sweep (vertical on left)
- Slowdown
The Resonant Frequency for Y is around 39Hz (78mm). The Resonant Frequency for X is not so clear, 55-60Hz (110-120mm).
![DampingFrequencyPattern](/assets/images/features/freq-calibr/freq-pattern2.png)
Zeta/Damping Factor Pattern - Example 2
This print consists of:
- Frame (back and left lines)
- Y Frequency Sweeps at increasing Damping Factor values
Damping Factor values start from 0.05 and increase by 0.05.
0.40 (8th pattern) looks the best.
Note! Zeta/Damping pattern for X is vertical. (The leftmost line is part of the anchor and is not relevant to Damping Factor values.)
![ZetaDampingFactorPattern](/assets/images/features/freq-calibr/zeta-pattern2.png)
Example of loose roller wheels
During this pattern the bed may have been moving and/or rotating in directions other than just Y.
The roller wheels of the bed were too loose and tightening them improved the pattern.
![LooseWheelsExample](/assets/images/features/freq-calibr/loose-wheels.png)