mirror of
https://github.com/OrcaSlicer/OrcaSlicer.git
synced 2026-06-15 08:23:00 +00:00
d786aec255
* IS Freq duplicated as Base * IS jerk to 5 * JD jerk to 0 * Base 1 layer + MINIMUM_CRUISE_RATIO=0 * Tab * Remove IS BASE * Update Plater.cpp * Klipper Jerk 5, Others 10 * JD in Marlin2 * Types * Horizontal * Different lists * RepRap IS writer * Smart Flavors and axis * RepRap values lowercase * Hide Y axix for RepRap * Max Jerk or JD * Reorder * Removed dual list + Default * RepRap show UpperCase use LowerCase * RepRap P"type" Type of input shaping to use, not case sensitive. * RepRap DAA * Reorder Klipper * Custom Firmware Note * Better Display Co-Authored-By: yw4z <28517890+yw4z@users.noreply.github.com> * Better notes * Update + Clean Wiki Co-Authored-By: gregmatic <60957555+gregmatic@users.noreply.github.com> * Wiki Update Update Images Improve guide Co-Authored-By: Cameron D <30559428+cdunn95@users.noreply.github.com> * Fix G-code generation issue and refine input shaping calibration documentation --------- Co-authored-by: yw4z <28517890+yw4z@users.noreply.github.com> Co-authored-by: gregmatic <60957555+gregmatic@users.noreply.github.com> Co-authored-by: Cameron D <30559428+cdunn95@users.noreply.github.com> Co-authored-by: SoftFever <softfeverever@gmail.com>
132 lines
6.9 KiB
Markdown
132 lines
6.9 KiB
Markdown
# Input Shaping
|
||
|
||
During high-speed movements, vibrations can cause a phenomenon called "ringing," where periodic ripples appear on the print surface. Input Shaping provides an effective solution by counteracting these vibrations, improving print quality and reducing wear on components without needing to significantly lower print speeds.
|
||
|
||
> [!IMPORTANT]
|
||
> RepRap can only set one frequency for both X and Y axes so you will need to select a frequency that works well for both axes.
|
||
|
||
- [Types](#types)
|
||
- [Default](#default)
|
||
- [Version Table](#version-table)
|
||
- [Calibration Steps](#calibration-steps)
|
||
- [Fixed-Time Motion](#fixed-time-motion)
|
||
- [Credits](#credits)
|
||
|
||
## Types
|
||
|
||
It is usually recommended to use MZV, EI (specially for Delta printers) or ZV as a simple and effective solution.
|
||
Not all Input Shaping types are available in all firmware and their performance may vary depending on the firmware implementation and the printer's mechanics.
|
||
|
||
### Default
|
||
|
||
When "Default" is selected, the firmware's default input shaper will be used.
|
||
Every firmware and even its version may have a different default type but usually are:
|
||
|
||
- Klipper: MZV
|
||
- Marlin: ZV
|
||
- RepRap:
|
||
- Version >= 3.4: MZV
|
||
- Version < 3.4: DAA
|
||
- Version < 3.2: DAA (without damping option)
|
||
|
||
### Version Table
|
||
|
||
| Type | Name | [Klipper](https://www.klipper3d.org/Resonance_Compensation.html#technical-details) | [RepRap](https://docs.duet3d.com/User_manual/Reference/Gcodes#m593-configure-input-shaping) | [Marlin 2](https://marlinfw.org/docs/features/ft_motion.html#more-complexity-zv-input-shaper) | Marlin Legacy |
|
||
|---|---|---|---|---|---|
|
||
| MZV | Modified Zero Vibration | >=0.9.0 | >=3.4 | - | - |
|
||
| ZV | Zero Vibration | >=0.9.0 | = 3.5 | >2.1.2 | - |
|
||
| ZVD | Zero Vibration Derivative | >=0.9.0 | >=3.4 | - | - |
|
||
| ZVDD | Zero Vibration Double Derivative | - | >=3.4 | - | - |
|
||
| ZVDDD | Zero Vibration Triple Derivative | - | >=3.4 | - | - |
|
||
| EI | Extra Insensitive | >=0.9.0 | - | - | - |
|
||
| 2HUMP_EI / EI2 | Two-Hump Extra Insensitive | >=0.9.0 | >=3.4 | - | - |
|
||
| 3HUMP_EI / EI3 | Three-Hump Extra Insensitive | >=0.9.0 | >=3.4 | - | - |
|
||
| [FT_MOTION](https://marlinfw.org/docs/features/ft_motion.html#fixed-time-motion-by-ulendo) | Fixed-Time Motion | - | - | >2.1.3 | - |
|
||
| DAA | Damped Anti-Resonance | - | < 3.4 | - | - |
|
||
|
||
## Calibration Steps
|
||
|
||
0. Pre-requisites:
|
||
1. Use an opaque, high-gloss filament to make the ringing more visible.
|
||
2. In OrcaSlicer, set:
|
||
1. Acceleration high enough to trigger ringing (e.g., 20000 mm/s²).
|
||
2. Speed high enough to trigger ringing (e.g., 200 mm/s).
|
||
|
||
> [!IMPORTANT]
|
||
> It's recommended to use the fastest [acceleration](speed_settings_acceleration), [speed](speed_settings_other_layers_speed) and [Jerk/Junction Deviation](speed_settings_jerk_xy) your printer can handle without losing steps.
|
||
> This test **will set the values to high values** limited by your printer's motion ability and the filament's max volumetric speed (avoid materials below 10 mm³/s).
|
||
|
||
1. Select the Test Model ´Ringing Tower´ (Recommended) or ´Fast Tower´ (Reduced version useful for printers with high ringing).
|
||
2. Select the [Input Shaper Type](#types) you want to test. Each firmware has different types available and each type has different performance.
|
||
3. Select a range of frequencies to test. The Default 15hz to 110hz range is usually a good start.
|
||
4. Select your damping. Usually, a value between 0.1 and 0.2 is a good start but you can change it to 0 and your printer will use the firmware default value (if available).
|
||
|
||
1. Measure the X and Y heights and read the frequency set at that point in OrcaSlicer.
|
||
|
||
- Marlin:
|
||
|
||
- Klipper:
|
||
|
||
2. If not a clear result, you can measure a X and Y min and max acceptable heights and repeat the test with that min and max value.
|
||
5. Print the Damping test setting your X and Y frequency to the value you found in the previous step.
|
||
|
||
1. Measure the X and Y heights and read the damping set at that point in OrcaSlicer.
|
||
|
||
- Marlin:
|
||
|
||
- Klipper:
|
||
|
||
|
||
6. **Restore your 3D Printer settings to avoid keep using high acceleration and jerk values.**
|
||
7. Save the settings
|
||
- Into your printer firmware settings save the values you found (Type, frequency/cies and damp)
|
||
- Save it into Orca's printer profile settings in Printer settings/ Machine G-code/ Machine start G-code using the following G-code:
|
||
- Klipper:
|
||
- Skeleton
|
||
```gcode
|
||
SET_INPUT_SHAPER SHAPER_TYPE=TYPE SHAPER_FREQ_X=#Xfrequency DAMPING_RATIO_X=#XDamping SHAPER_FREQ_Y=#Yfrequency DAMPING_RATIO_Y=#YDamping
|
||
```
|
||
Example
|
||
```gcode
|
||
SET_INPUT_SHAPER SHAPER_TYPE=MZV SHAPER_FREQ_X=37.25 DAMPING_RATIO_X=0.16 SHAPER_FREQ_Y=37.5 DAMPING_RATIO_Y=0.06
|
||
```
|
||
- Marlin:
|
||
- Skeleton
|
||
```gcode
|
||
M593 X F#Xfrequency D#XDamping
|
||
M593 Y F#Yfrequency D#YDamping
|
||
M500
|
||
```
|
||
Example
|
||
```gcode
|
||
M593 X F37.25 D0.16
|
||
M593 Y F37.5 D0.06
|
||
M500
|
||
```
|
||
- RepRap:
|
||
- Skeleton for RepRap 3.3 and later
|
||
```gcode
|
||
M593 P#Type F#frequency S#Damping
|
||
```
|
||
Example RepRap 3.4 and later
|
||
```gcode
|
||
M593 P"ZVD" F37.25 S0.16
|
||
```
|
||
- Skeleton for RepRap 3.2 and earlier
|
||
```gcode
|
||
M593 F#frequency
|
||
```
|
||
Example Legacy (RepRap 3.2 and earlier)
|
||
```gcode
|
||
M593 F37.25
|
||
```
|
||
|
||
### Fixed-Time Motion
|
||
|
||
TODO: This calibration test is currently under development. See the [Marlin documentation](https://marlinfw.org/docs/gcode/M493.html) for more information.
|
||
|
||
## Credits
|
||
|
||
- **Input Shaping Calibration:** [@IanAlexis](https://github.com/IanAlexis) and [@RF47](https://github.com/RF47)
|
||
- **Klipper testing:** [@ShaneDelmore](https://github.com/ShaneDelmore)
|