From ee04a6340a028b84ea5cc1db278b38869ab4b9c7 Mon Sep 17 00:00:00 2001 From: Yifei Ding Date: Sat, 23 Oct 2021 11:21:46 -0700 Subject: [PATCH] docs: Align Lists Signed-off-by: Yifei Ding --- docs/Manual_Level.md | 8 +-- docs/Measuring_Resonances.md | 46 ++++++------- docs/Resonance_Compensation.md | 122 ++++++++++++++++----------------- 3 files changed, 88 insertions(+), 88 deletions(-) diff --git a/docs/Manual_Level.md b/docs/Manual_Level.md index ada31b4d..6a49d499 100644 --- a/docs/Manual_Level.md +++ b/docs/Manual_Level.md @@ -181,10 +181,10 @@ Recv: ok ``` This means that: - - front left screw is the reference point you must not change it. - - front right screw must be turned clockwise 1 full turn and a quarter turn - - rear right screw must be turned counter-clockwise 50 minutes - - read left screw must be turned clockwise 2 minutes (not need it's ok) +- front left screw is the reference point you must not change it. +- front right screw must be turned clockwise 1 full turn and a quarter turn +- rear right screw must be turned counter-clockwise 50 minutes +- read left screw must be turned clockwise 2 minutes (not need it's ok) Repeat the process several times until you get a good level bed - normally when all adjustments are below 6 minutes. diff --git a/docs/Measuring_Resonances.md b/docs/Measuring_Resonances.md index 1487cda5..e940713a 100644 --- a/docs/Measuring_Resonances.md +++ b/docs/Measuring_Resonances.md @@ -483,18 +483,18 @@ The data can be processed later by the following scripts: of them accept one or several raw csv files as the input depending on the mode. The graph_accelerometer.py script supports several modes of operation: - * plotting raw accelerometer data (use `-r` parameter), only 1 input is - supported; - * plotting a frequency response (no extra parameters required), if multiple - inputs are specified, the average frequency response is computed; - * comparison of the frequency response between several inputs (use `-c` - parameter); you can additionally specify which accelerometer axis to +* plotting raw accelerometer data (use `-r` parameter), only 1 input is + supported; +* plotting a frequency response (no extra parameters required), if multiple + inputs are specified, the average frequency response is computed; +* comparison of the frequency response between several inputs (use `-c` + parameter); you can additionally specify which accelerometer axis to consider via `-a x`, `-a y` or `-a z` parameter (if none specified, the sum of vibrations for all axes is used); - * plotting the spectrogram (use `-s` parameter), only 1 input is supported; - you can additionally specify which accelerometer axis to consider via - `-a x`, `-a y` or `-a z` parameter (if none specified, the sum of vibrations - for all axes is used). +* plotting the spectrogram (use `-s` parameter), only 1 input is supported; + you can additionally specify which accelerometer axis to consider via + `-a x`, `-a y` or `-a z` parameter (if none specified, the sum of vibrations + for all axes is used). Note that graph_accelerometer.py script supports only the raw_data\*.csv files and not resonances\*.csv or calibration_data\*.csv files. @@ -515,16 +515,16 @@ the CSV file if `-c output.csv` parameter is specified. Providing several inputs to shaper_calibrate.py script can be useful if running some advanced tuning of the input shapers, for example: - * Running `TEST_RESONANCES AXIS=X OUTPUT=raw_data` (and `Y` axis) for a single - axis twice on a bed slinger printer with the accelerometer attached to the - toolhead the first time, and the accelerometer attached to the bed the - second time in order to detect axes cross-resonances and attempt to cancel - them with input shapers. - * Running `TEST_RESONANCES AXIS=Y OUTPUT=raw_data` twice on a bed slinger with - a glass bed and a magnetic surfaces (which is lighter) to find the input - shaper parameters that work well for any print surface configuration. - * Combining the resonance data from multiple test points. - * Combining the resonance data from 2 axis (e.g. on a bed slinger printer - to configure X-axis input_shaper from both X and Y axes resonances to - cancel vibrations of the *bed* in case the nozzle 'catches' a print when - moving in X axis direction). +* Running `TEST_RESONANCES AXIS=X OUTPUT=raw_data` (and `Y` axis) for a single + axis twice on a bed slinger printer with the accelerometer attached to the + toolhead the first time, and the accelerometer attached to the bed the + second time in order to detect axes cross-resonances and attempt to cancel + them with input shapers. +* Running `TEST_RESONANCES AXIS=Y OUTPUT=raw_data` twice on a bed slinger with + a glass bed and a magnetic surfaces (which is lighter) to find the input + shaper parameters that work well for any print surface configuration. +* Combining the resonance data from multiple test points. +* Combining the resonance data from 2 axis (e.g. on a bed slinger printer + to configure X-axis input_shaper from both X and Y axes resonances to + cancel vibrations of the *bed* in case the nozzle 'catches' a print when + moving in X axis direction). diff --git a/docs/Resonance_Compensation.md b/docs/Resonance_Compensation.md index b83211ce..8176da73 100644 --- a/docs/Resonance_Compensation.md +++ b/docs/Resonance_Compensation.md @@ -30,16 +30,16 @@ adding a few parameters to `printer.cfg` file. Slice the ringing test model, which can be found in [docs/prints/ringing_tower.stl](prints/ringing_tower.stl), in the slicer: - * Suggested layer height is 0.2 or 0.25 mm. - * Infill and top layers can be set to 0. - * Use 1-2 perimeters, or even better the smooth vase mode with 1-2 mm base. - * Use sufficiently high speed, around 80-100 mm/sec, for **external** perimeters. - * Make sure that the minimum layer time is **at most** 3 seconds. - * Make sure any "dynamic acceleration control" is disabled in the slicer. - * Do not turn the model. The model has X and Y marks at the back of the model. - Note the unusual location of the marks vs. the axes of the printer - it is - not a mistake. The marks can be used later in the tuning process as a - reference, because they show which axis the measurements correspond to. +* Suggested layer height is 0.2 or 0.25 mm. +* Infill and top layers can be set to 0. +* Use 1-2 perimeters, or even better the smooth vase mode with 1-2 mm base. +* Use sufficiently high speed, around 80-100 mm/sec, for **external** perimeters. +* Make sure that the minimum layer time is **at most** 3 seconds. +* Make sure any "dynamic acceleration control" is disabled in the slicer. +* Do not turn the model. The model has X and Y marks at the back of the model. + Note the unusual location of the marks vs. the axes of the printer - it is + not a mistake. The marks can be used later in the tuning process as a + reference, because they show which axis the measurements correspond to. ### Ringing frequency @@ -116,12 +116,12 @@ Note that the ringing frequencies can change if the changes are made to the printer that affect the moving mass or change the stiffness of the system, for example: - * Some tools are installed, removed or replaced on the toolhead that change - its mass, e.g. a new (heavier or lighter) stepper motor for direct extruder - or a new hotend is installed, heavy fan with a duct is added, etc. - * Belts are tightened. - * Some addons to increase frame rigidity are installed. - * Different bed is installed on a bed-slinger printer, or glass added, etc. +* Some tools are installed, removed or replaced on the toolhead that change + its mass, e.g. a new (heavier or lighter) stepper motor for direct extruder + or a new hotend is installed, heavy fan with a duct is added, etc. +* Belts are tightened. +* Some addons to increase frame rigidity are installed. +* Different bed is installed on a bed-slinger printer, or glass added, etc. If such changes are made, it is a good idea to at least measure the ringing frequencies to see if they have changed. @@ -187,19 +187,19 @@ shaper_type: mzv A few notes on shaper selection: - * EI shaper may be more suited for bed slinger printers (if the resonance - frequency and resulting smoothing allows): as more filament is deposited - on the moving bed, the mass of the bed increases and the resonance frequency - will decrease. Since EI shaper is more robust to resonance frequency - changes, it may work better when printing large parts. - * Due to the nature of delta kinematics, resonance frequencies can differ a - lot in different parts of the build volume. Therefore, EI shaper can be a - better fit for delta printers rather than MZV or ZV, and should be - considered for the use. If the resonance frequency is sufficiently large - (more than 50-60 Hz), then one can even attempt to test 2HUMP_EI shaper - (by running the suggested test above with - `SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI`), but check the considerations in - the [section below](#selecting-max_accel) before enabling it. +* EI shaper may be more suited for bed slinger printers (if the resonance + frequency and resulting smoothing allows): as more filament is deposited + on the moving bed, the mass of the bed increases and the resonance frequency + will decrease. Since EI shaper is more robust to resonance frequency + changes, it may work better when printing large parts. +* Due to the nature of delta kinematics, resonance frequencies can differ a + lot in different parts of the build volume. Therefore, EI shaper can be a + better fit for delta printers rather than MZV or ZV, and should be + considered for the use. If the resonance frequency is sufficiently large + (more than 50-60 Hz), then one can even attempt to test 2HUMP_EI shaper + (by running the suggested test above with + `SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI`), but check the considerations in + the [section below](#selecting-max_accel) before enabling it. ### Selecting max_accel @@ -292,9 +292,9 @@ to 7000 already, complete the following steps for each of the axes X and Y: 6. Print the test model. 7. Reset the original frequency value: `SET_INPUT_SHAPER SHAPER_FREQ_X=...`. -7. Find the band which shows ringing the least and count its number from the +8. Find the band which shows ringing the least and count its number from the bottom starting at 1. -8. Calculate the new shaper_freq_x value via old +9. Calculate the new shaper_freq_x value via old shaper_freq_x * (39 + 5 * #band-number) / 66. Repeat these steps for the Y axis in the same manner, replacing references to X @@ -371,9 +371,9 @@ with 50 Hz. Now check if EI shaper would be good enough in your case. Choose EI shaper frequency based on the frequency of 2HUMP_EI shaper you chose: - * For 2HUMP_EI 60 Hz shaper, use EI shaper with shaper_freq = 50 Hz. - * For 2HUMP_EI 50 Hz shaper, use EI shaper with shaper_freq = 40 Hz. - * For 2HUMP_EI 40 Hz shaper, use EI shaper with shaper_freq = 33 Hz. +* For 2HUMP_EI 60 Hz shaper, use EI shaper with shaper_freq = 50 Hz. +* For 2HUMP_EI 50 Hz shaper, use EI shaper with shaper_freq = 40 Hz. +* For 2HUMP_EI 40 Hz shaper, use EI shaper with shaper_freq = 33 Hz. Now print the test model one more time, running @@ -481,30 +481,30 @@ so the values for 10% vibration tolerance are provided only for the reference. **How to use this table:** - * Shaper duration affects the smoothing in parts - the larger it is, the more - smooth the parts are. This dependency is not linear, but can give a sense of - which shapers 'smooth' more for the same frequency. The ordering by - smoothing is like this: ZV < MZV < ZVD ≈ EI < 2HUMP_EI < 3HUMP_EI. Also, - it is rarely practical to set shaper_freq = resonance freq for shapers - 2HUMP_EI and 3HUMP_EI (they should be used to reduce vibrations for several - frequencies). - * One can estimate a range of frequencies in which the shaper reduces - vibrations. For example, MZV with shaper_freq = 35 Hz reduces vibrations - to 5% for frequencies [33.6, 36.4] Hz. 3HUMP_EI with shaper_freq = 50 Hz - reduces vibrations to 5% in range [27.5, 75] Hz. - * One can use this table to check which shaper they should be using if they - need to reduce vibrations at several frequencies. For example, if one has - 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 - 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 - 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 - enough information. In this case one may have more luck with - [scripts/graph_shaper.py](../scripts/graph_shaper.py) - script, which is more flexible. +* Shaper duration affects the smoothing in parts - the larger it is, the more + smooth the parts are. This dependency is not linear, but can give a sense of + which shapers 'smooth' more for the same frequency. The ordering by + smoothing is like this: ZV < MZV < ZVD ≈ EI < 2HUMP_EI < 3HUMP_EI. Also, + it is rarely practical to set shaper_freq = resonance freq for shapers + 2HUMP_EI and 3HUMP_EI (they should be used to reduce vibrations for several + frequencies). +* One can estimate a range of frequencies in which the shaper reduces + vibrations. For example, MZV with shaper_freq = 35 Hz reduces vibrations + to 5% for frequencies [33.6, 36.4] Hz. 3HUMP_EI with shaper_freq = 50 Hz + reduces vibrations to 5% in range [27.5, 75] Hz. +* One can use this table to check which shaper they should be using if they + need to reduce vibrations at several frequencies. For example, if one has + 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 + 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 + 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 + enough information. In this case one may have more luck with + [scripts/graph_shaper.py](../scripts/graph_shaper.py) + script, which is more flexible.