From d1e2e905cc9a2484b088071dec4f08f200304f7a Mon Sep 17 00:00:00 2001 From: Shantanu Date: Thu, 19 Sep 2024 12:14:15 -0500 Subject: [PATCH 1/3] Add troubleshooting for known issues --- docs/operation/lerobot_guide.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/operation/lerobot_guide.rst b/docs/operation/lerobot_guide.rst index 493caa0..ca94915 100644 --- a/docs/operation/lerobot_guide.rst +++ b/docs/operation/lerobot_guide.rst @@ -366,6 +366,19 @@ Troubleshooting Ensure that the :guilabel:`$DISPLAY` environment variable is set correctly. -#. Checkout LeRobot Documentation for further help and details. +#. **Frequency drops during evaluation** + + This happens on low-performance systems due to their inability to handle multi-threaded I/O operations. + Checkout the following version for a smoother operation. + Changes will be integrated soon in the newer version of the repository. + `Low Frequency Fix `_ - `LeRobot Github `_ +#. **Compute Dataset Statistic Failure** + + It is noticed that on low-performance systems the compute statistic fails due to high batch size and number of workers. + Checkout the following version with lower batch size and number of workers. + `Compute Statistic Fix `_ + +#. **Checkout LeRobot Documentation for further help and details.** + + `LeRobot Github `_ \ No newline at end of file From 79e57ff662fb86c82677de69c82025d9b0b125e4 Mon Sep 17 00:00:00 2001 From: Shantanu Date: Thu, 19 Sep 2024 13:18:20 -0500 Subject: [PATCH 2/3] Added missing installation steps --- docs/operation/lerobot_guide.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/operation/lerobot_guide.rst b/docs/operation/lerobot_guide.rst index ca94915..5218ac3 100644 --- a/docs/operation/lerobot_guide.rst +++ b/docs/operation/lerobot_guide.rst @@ -69,6 +69,12 @@ Build and Install LeRobot Models $ cd lerobot && pip install -e . +#. As we are working with real robots we will require to install dependencies for :guilabel:`intelrealsense` camera's and :guilabel:`dynamixel` servos. + + .. code-block:: bash + + $ cd lerobot && pip install .[intelrealsense,dynamixel] + Teleoperation ============= From e9eaf6053574965b6cb4b5fb0734d2af93e0b2a8 Mon Sep 17 00:00:00 2001 From: Shantanu Date: Thu, 19 Sep 2024 14:18:31 -0500 Subject: [PATCH 3/3] Troubleshooting steps changed to subheadings --- docs/operation/lerobot_guide.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/operation/lerobot_guide.rst b/docs/operation/lerobot_guide.rst index 5218ac3..442f786 100644 --- a/docs/operation/lerobot_guide.rst +++ b/docs/operation/lerobot_guide.rst @@ -345,7 +345,8 @@ Troubleshooting .. warning:: If you encounter issues, follow these troubleshooting steps: -#. **OpenCV Installation Issues (Linux)** +OpenCV Installation Issues (Linux) +-------------------------------------- If you encounter OpenCV installation issues, uninstall it via :guilabel:`pip` and reinstall using Conda: @@ -354,7 +355,8 @@ Troubleshooting $ pip uninstall opencv-python $ conda install -c conda-forge opencv=4.10.0 -#. **FFmpeg Encoding Error (`unknown encoder libsvtav1`)** +FFmpeg Encoding Error (:guilabel:`unknown encoder libsvtav1`) +--------------------------------------------------- Install FFmpeg with :guilabel:`libsvtav1` support via Conda-Forge or Homebrew: @@ -368,23 +370,27 @@ Troubleshooting $ brew install ffmpeg -#. **Arrow Keys Not Working During Data Recording (Linux)** +Arrow Keys Not Working During Data Recording (Linux) +---------------------------------------------------- Ensure that the :guilabel:`$DISPLAY` environment variable is set correctly. -#. **Frequency drops during evaluation** +Frequency drops during evaluation +--------------------------------- This happens on low-performance systems due to their inability to handle multi-threaded I/O operations. Checkout the following version for a smoother operation. Changes will be integrated soon in the newer version of the repository. `Low Frequency Fix `_ -#. **Compute Dataset Statistic Failure** +Compute Dataset Statistic Failure +--------------------------------- It is noticed that on low-performance systems the compute statistic fails due to high batch size and number of workers. Checkout the following version with lower batch size and number of workers. `Compute Statistic Fix `_ -#. **Checkout LeRobot Documentation for further help and details.** +Checkout LeRobot Documentation for further help and details +----------------------------------------------------------- `LeRobot Github `_ \ No newline at end of file