From c98527ff0089a7c850d1f994ae83c765f4644b6b Mon Sep 17 00:00:00 2001 From: Dmitry Butyugin Date: Wed, 1 Oct 2025 00:30:36 +0200 Subject: [PATCH] docs: Updated the docs to the latest shaper changes and fixed typos Signed-off-by: Dmitry Butyugin --- docs/Config_Reference.md | 18 ++++++++---------- docs/Resonance_Compensation.md | 10 +++++----- scripts/calibrate_shaper.py | 2 +- 3 files changed, 14 insertions(+), 16 deletions(-) diff --git a/docs/Config_Reference.md b/docs/Config_Reference.md index ca21bcf21..6f76c5567 100644 --- a/docs/Config_Reference.md +++ b/docs/Config_Reference.md @@ -1955,11 +1955,10 @@ section of the measuring resonances guide for more information on # are reachable by the toolhead. #accel_chip: # A name of the accelerometer chip to use for measurements. If -# adxl345 chip was defined without an explicit name, this parameter -# can simply reference it as "accel_chip: adxl345", otherwise an -# explicit name must be supplied as well, e.g. "accel_chip: adxl345 -# my_chip_name". Either this, or the next two parameters must be -# set. +# an accelerometer was defined without an explicit name, this parameter +# can simply reference it by type, e.g. "accel_chip: adxl345", otherwise +# a full name must be supplied, e.g. "accel_chip: adxl345 my_chip_name". +# Either this, or the next two parameters must be set. #accel_chip_x: #accel_chip_y: # Names of the accelerometer chips to use for measurements for each @@ -1978,16 +1977,15 @@ section of the measuring resonances guide for more information on # during the calibration. The default is 50. #min_freq: 5 # Minimum frequency to test for resonances. The default is 5 Hz. -#max_freq: 133.33 -# Maximum frequency to test for resonances. The default is 133.33 Hz. +#max_freq: 135 +# Maximum frequency to test for resonances. The default is 135 Hz. #accel_per_hz: 60 # This parameter is used to determine which acceleration to use to # test a specific frequency: accel = accel_per_hz * freq. Higher the # value, the higher is the energy of the oscillations. Can be set to # a lower than the default value if the resonances get too strong on -# the printer. However, lower values make measurements of -# high-frequency resonances less precise. The default value is 75 -# (mm/sec). +# the printer. However, lower values make measurements of high-frequency +# resonances less precise. The default value is 60 (mm/sec). #hz_per_sec: 1 # Determines the speed of the test. When testing all frequencies in # range [min_freq, max_freq], each second the frequency increases by diff --git a/docs/Resonance_Compensation.md b/docs/Resonance_Compensation.md index 8f2d2b643..436c762b4 100644 --- a/docs/Resonance_Compensation.md +++ b/docs/Resonance_Compensation.md @@ -469,8 +469,8 @@ parameters of each shaper. | MZV | 0.75 / shaper_freq | ± 4% shaper_freq | -10%...+15% shaper_freq | | ZVD | 1 / shaper_freq | ± 15% shaper_freq | ± 22% shaper_freq | | EI | 1 / shaper_freq | ± 20% shaper_freq | ± 25% shaper_freq | -| 2HUMP_EI | 1.5 / shaper_freq | ± 35% shaper_freq | ± 40 shaper_freq | -| 3HUMP_EI | 2 / shaper_freq | -45...+50% shaper_freq | -50%...+55% shaper_freq | +| 2HUMP_EI | 1.5 / shaper_freq | -40...+45% shaper_freq | -45..+50% shaper_freq | +| 3HUMP_EI | 2 / shaper_freq | -50...+60% shaper_freq | -55%...+65% shaper_freq | A note on vibration reduction: the values in the table above are approximate. If the damping ratio of the printer is known for each axis, the shaper can be @@ -502,11 +502,11 @@ so the values for 10% vibration tolerance are provided only for the reference. resonances at 35 Hz and 60 Hz on the same axis: a) EI shaper needs to have shaper_freq = 35 / (1 - 0.2) = 43.75 Hz, and it will reduce resonances until 43.75 * (1 + 0.2) = 52.5 Hz, so it is not sufficient; b) 2HUMP_EI - shaper needs to have shaper_freq = 35 / (1 - 0.35) = 53.85 Hz and will - reduce vibrations until 53.85 * (1 + 0.35) = 72.7 Hz - so this is an + shaper needs to have shaper_freq = 35 / (1 - 0.4) = 58.3 Hz and will + reduce vibrations until 58.3 * (1 + 0.45) = 84.5 Hz - so this is an acceptable configuration. Always try to use as high shaper_freq as possible for a given shaper (perhaps with some safety margin, so in this example - shaper_freq ≈ 50-52 Hz would work best), and try to use a shaper with as + shaper_freq ≈ 55 Hz would work best), and try to use a shaper with as small shaper duration as possible. * If one needs to reduce vibrations at several very different frequencies (say, 30 Hz and 100 Hz), they may see that the table above does not provide diff --git a/scripts/calibrate_shaper.py b/scripts/calibrate_shaper.py index b56ce5daa..cda0276f3 100755 --- a/scripts/calibrate_shaper.py +++ b/scripts/calibrate_shaper.py @@ -166,7 +166,7 @@ def main(): default=None, help="shaper damping_ratio parameter") opts.add_option("--test_damping_ratios", type="string", dest="test_damping_ratios", default=None, - help="a comma-separated liat of damping ratios to test " + + help="a comma-separated list of damping ratios to test " + "input shaper for") options, args = opts.parse_args() if len(args) < 1: