OrcaSlicer/doc/calibration/input-shaping-calib.md
Ian Bassi 4ec16fd714
Some checks are pending
Build all / Build All (push) Waiting to run
Build all / Flatpak (push) Waiting to run
Publish docs to Wiki / Publish docs to Wiki (push) Waiting to run
Wiki Update part 5 (#9873)
* BASE

* precise wall and z moved

* PolyHoles

* Arc-fitting

* X-Y Compensation

* Elephant foot + moved images

* Update quality_settings_precision.md

* Wall generator and more

* Full Reorder

* TPMS-D bases

* Update strength_settings_infill.md

* Image Fix + Infill desc calculator

* Descriptions + image fix

Co-Authored-By: Rodrigo <162915171+RF47@users.noreply.github.com>

* Update cornering-calib.md

* minor fixes

* Wip updated

* Missing fills

* Update infill_desc_calculator.xlsx

* Update infill_desc_calculator.xlsx

* Update infill documentation and images

Removed outdated 'iso' infill images and updated 'top' infill images with new versions. Added new images for adaptive cubic and 2D honeycomb infill patterns. Updated strength_settings_infill.md to revise infill strength values, descriptions, and remove references to deleted images. Introduced documentation for 2D honeycomb infill and made minor corrections and clarifications throughout.

* Revise infill pattern documentation and add comparison table

Updated strength_settings_infill.md to clarify infill density calculation, add a comprehensive comparison table of infill patterns, and standardize terminology for strength and print time. Expanded pattern descriptions to use qualitative strength ratings instead of numeric values. Updated infill_desc_calculator.xlsx to reflect these changes.

* Indentation in  code examples

Adjusted the indentation of code blocks in the cornering calibration documentation for clarity and consistency with the rest of the document.

* Update 3D Honeycomb infill strength ratings

Adjusted the horizontal strength rating for 3D Honeycomb infill from 'Normal' to 'Normal-High' in the strength settings documentation and table. Updated the infill_desc_calculator.xlsx file to reflect these changes.

* Formatting and fix in ERS documentation

Updated headings to use consistent Markdown syntax, improved clarity in explanations, and reworded references for better readability.

* Fix wall generator doc link and filename

Updated the Home.md to reference the correct 'quality_settings_wall_generator' section and renamed the corresponding documentation file for consistency.

---------

Co-authored-by: Rodrigo <162915171+RF47@users.noreply.github.com>
2025-06-20 10:19:48 +08:00

6.9 KiB

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.

Klipper

Resonance Compensation

The Klipper Resonance Compensation is a set of Input Shaping modes that can be used to reduce ringing and improve print quality. Ussualy the recommended values modes are MZV or EI for Delta printers.

  1. Pre-requisites:
    1. In OrcaSlicer, set:
      1. Acceleration high enough to trigger ringing (e.g., 2000 mm/s²).
      2. Speed high enough to trigger ringing (e.g., 100 mm/s).

Note

These settings depend on your printer's motion ability and the filament's max volumetric speed. If you can't reach speeds that cause ringing, try increasing the filament's max volumetric speed (avoid materials below 10 mm³/s). 3. Jerk Klipper Square Corner Velocity to 5 or a high value (e.g., 20).

  1. In printer settigs:

    1. Set the Shaper Type to MZV or EI.
      SET_INPUT_SHAPER SHAPER_TYPE=MZV
      
    2. Disable Minimun Cruise Ratio with:
      SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0
      
  2. Use an opaque, high-gloss filament to make the ringing more visible.

  3. Print the Input Shaping Frequency test with a range of frequencies.

    IS_freq_menu

    1. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.

    IS_damp_klipper_print_measure IS_freq_klipper_slicer_measure

    1. 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.

Warning

There is a chance you will need to set higher than 60Hz frequencies. Some printers with very rigid frames and excellent mechanics may exhibit frequencies exceeding 100Hz.

  1. Print the Damping test setting your X and Y frequency to the value you found in the previous step.

    IS_damp_menu

    1. Measure the X and Y heights and read the damping set at that point in Orca Slicer.

    IS_damp_klipper_print_measure IS_damp_klipper_slicer_measure

Important

Not all Resonance Compensation modes support damping.

  1. Restore your 3D Printer settings to avoid keep using high acceleration and jerk values.
  2. Save the settings
    1. You need to go to the printer settings and set the X and Y frequency and damp to the value you found in the previous step.

Marlin

ZV Input Shaping

ZV Input Shaping introduces an anti-vibration signal into the stepper motion for the X and Y axes. It works by splitting the step count into two halves: the first at half the frequency and the second as an "echo," delayed by half the ringing interval. This simple approach effectively reduces vibrations, improving print quality and allowing for higher speeds.

  1. Pre-requisites:
    1. In OrcaSlicer, set:
      1. Acceleration high enough to trigger ringing (e.g., 2000 mm/s²).
      2. Speed high enough to trigger ringing (e.g., 100 mm/s).

Note

These settings depend on your printer's motion ability and the filament's max volumetric speed. If you can't reach speeds that cause ringing, try increasing the filament's max volumetric speed (avoid materials below 10 mm³/s).

  3. Jerk
     1. If using [Classic Jerk](https://marlinfw.org/docs/configuration/configuration.html#jerk-) use a high value (e.g., 20).
     2. If using [Junction Deviation](https://marlinfw.org/docs/features/junction_deviation.html) (new Marlin default mode) this test will use 0.25 (high enough to most printers).
  1. Use an opaque, high-gloss filament to make the ringing more visible.

  2. Print the Input Shaping Frequency test with a range of frequencies.

    IS_freq_menu

    1. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.

    IS_freq_marlin_print_measure IS_freq_marlin_slicer_measure

    1. 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.

Warning

There is a chance you will need to set higher than 60Hz frequencies. Some printers with very rigid frames and excellent mechanics may exhibit frequencies exceeding 100Hz.

  1. Print the Damping test setting your X and Y frequency to the value you found in the previous step.

    IS_damp_menu

    1. Measure the X and Y heights and read the damping set at that point in Orca Slicer.

    IS_damp_marlin_print_measure IS_damp_marlin_slicer_measure

  2. Restore your 3D Printer settings to avoid keep using high acceleration and jerk values.

    1. Reboot your printer.
    2. Use the following G-code to restore your printer settings:
    M501
    
  3. Save the settings

    1. You need to go to the printer settings and set the X and Y frequency and damp to the value you found in the previous step.
    2. Use the following G-code to set the frequency:
    M593 X F#Xfrequency D#XDamping
    M593 Y F#Yfrequency D#YDamping
    M500
    

    Example

    M593 X F37.25 D0.16
    M593 Y F37.5 D0.06
    M500
    

Fixed-Time Motion

WIP... This calibration test is currently under development. See the Marlin documentation for more information.