# OctoPrint-BedLevelVisualizer **Repository Path**: chrysler123/OctoPrint-BedLevelVisualizer ## Basic Information - **Project Name**: OctoPrint-BedLevelVisualizer - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-01-12 - **Last Updated**: 2021-01-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # OctoPrint-BedLevelVisualizer This plugin visualises the output from various firmware that support bed mesh leveling, noteably the Prusa `G81` mesh leveling report and the Marlin `G29 T` bed topography report. The plugin utilizes [Plotly](https://plot.ly/plotly-js-scientific-d3-charting-library/) js library to render a 3D surface of the bed's reported mesh on a tab within OctoPrint. ## Supported Firmware: - Marlin - PrusaFirmware - Klipper - Smoothieware ## Example It converts this: ``` Send: G29 T Recv: echo:Home XYZ first Recv: Recv: Bed Topography Report: Recv: Recv: (0,9) (9,9) Recv: (30,270) (270,270) Recv: -0.452 -0.319 -0.237 0.287 0.140 0.139 0.136 0.317 0.247 0.247 Recv: Recv: -0.195 -0.273 -0.180 -0.178 0.014 0.018 0.111 0.214 0.210 0.210 Recv: Recv: -0.270 -0.252 -0.151 -0.119 0.009 0.016 0.072 0.249 0.224 0.224 Recv: Recv: -0.307 -0.205 -0.163 -0.124 -0.094 -0.002 0.036 0.151 0.174 0.196 Recv: Recv: -0.186 -0.130 -0.152 -0.105 -0.144 -0.007 0.044 0.093 0.181 0.270 Recv: Recv: -0.010 -0.077 -0.073 0.155 -0.006 -0.133 0.110 0.046 0.109 0.173 Recv: Recv: 0.059 -0.094 -0.072 -0.002 -0.006 0.037 0.050 0.065 0.124 0.184 Recv: Recv: -0.057 -0.028 0.039 0.028 0.024 0.005 0.102 0.165 0.176 0.187 Recv: Recv: 0.067 0.015 0.096 0.117 0.001 0.079 0.138 0.346 0.185 0.185 Recv: Recv: [ 0.071] 0.014 0.061 -0.127 0.167 0.040 0.098 0.195 0.194 0.194 Recv: (30,30) (270,30) Recv: (0,0) (9,0) Recv: ok P15 B3 ``` into this ![screenshot](screenshot.png) --- ## [Wiki](wiki/index.md) For more info, see the [wiki](wiki/index.md) --- ## Known Issues - Install will fail silently in Python 3 due to missing system dependencies. You may have to SSH to your pi and run the command `sudo apt install libatlas3-base` to get the plugin to load. - System Command Editor and Custom Control Editor plugins have a known issue [here](https://github.com/jneilliii/OctoPrint-BedLevelVisualizer/issues/228) and [here](https://github.com/jneilliii/OctoPrint-BedLevelVisualizer/issues/244) where your customizations for those plugins get wiped when used in conjunction with Bed Level Visualizer and a few other plugins. To avoid this from happening to you disable Bed Level Visualizer and after restarting OctoPrint configure your customizations in those plugins and save. Immediately disable those plugins and re-enable Bed Level Visualizer restart OctoPrint and Reload. Your customizations to controls and the system menu will still remain and the bug that exists in those plugins will be prevented from clearing your customizations. I highly recommend you take regular backups as well. - Since version 0.1.3 there is a python dependency on numpy. As a result; if you don't already have numpy the install can take in excess of 30 minutes to complete on a pi. Just be patient and let it run and eventually the plugin install will finish. - If your device have less than 512MB of ram your numpy installation will most likely fail. See [#141](https://github.com/jneilliii/OctoPrint-BedLevelVisualizer/issues/141#issuecomment-542227338) for solution. - If you have Marlin's Auto Temperature Reporting Feature enabled you will want to have M155 S30 and M155 S3 surrounding your G29 command, see settings screenshot, otherwise the collected data will be tainted. --- ## Most recent changelog **[1.0.0](https://github.com/jneilliii/OctoPrint-BedLevelVisualizer/releases/tag/1.0.0)** (11/20/2020) **Added** * release channels for OctoPrint 1.5.0+ for future rc testing, similar to OctoPrint as described [here](https://community.octoprint.org/t/how-to-use-the-release-channels-to-help-test-release-candidates/402) **Updated** * think it's time to go to major version 1.0.0 now with over 19K known installs * knockout sortable library for OctoPrint 1.5.0 compatibility **Fixed** * knockout binding issue due to knockout version update to 3.5.1 in OctoPrint 1.5.0 * issue relative to using center origins and odd numbered mesh grid * issue with misinterpretation of bed level correction matrix * typos in reverse direction hover text * turn direction label coloring when direction is reversed ## [All releases](https://github.com/jneilliii/OctoPrint-BedLevelVisualizer/releases) --- ## To-Do - [ ] improve old marlin makergear support - [ ] improve rectangular mesh for circular bed calculations - [x] ~~Pause standard OctoPrint temperature polling or squash the responses until processing is completed.~~ won't be possible, utilize M155 gcode if possible - [x] ~~Orientation testing to verify axes are in correct direction.~~ added settings to allow controlling the orientation. - [x] ~~Calculate bed dimensions and apply to probe points for display on graph, #28.~~ --- ## Get Help If you experience issues with this plugin or need assistance please use the issue tracker by clicking issues above. ## Additional Plugins Check out my other plugins [here](https://plugins.octoprint.org/by_author/#jneilliii) --- ## Sponsors - Andreas Lindermayr - [@Mearman](https://github.com/Mearman) - [@TxBillbr](https://github.com/TxBillbr) - Gerald Dachs - [@TheTuxKeeper](https://github.com/thetuxkeeper) - @tideline3d - [SimplyPrint](https://simplyprint.dk/) - [Andrew Beeman](https://github.com/Kiendeleo) - [Calanish](https://github.com/calanish) ## Support My Efforts I, jneilliii, programmed this plugin for fun and do my best effort to support those that have issues with it, please return the favor and leave me a tip or become a Patron if you find this plugin helpful and want me to continue future development. [![Patreon](patreon-with-text-new.png)](https://www.patreon.com/jneilliii) [![paypal](paypal-with-text.png)](https://paypal.me/jneilliii) No paypal.me? Send funds via PayPal to jneilliii@gmail.com You can use [this](https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=jneilliii@gmail.com) link too. But the normal PayPal fee will be deducted.