diff --git a/docs/_data/bringup.csv b/docs/_data/bringup.csv new file mode 100644 index 0000000..a20af17 --- /dev/null +++ b/docs/_data/bringup.csv @@ -0,0 +1,37 @@ +Argument,Description,Default,Choices +robot_model_leader,model type of the leader arms.,``aloha_wx250s``, +robot_model_follower,model type of the follower arms.,``aloha_vx300s``, +robot_name_leader_left,name of the left leader arm,``leader_left``, +robot_name_leader_right,name of the right leader arm,``leader_right``, +robot_name_follower_left,name of the left follower arm,``follower_left``, +robot_name_follower_right,name of the right follower arm,``follower_right``, +leader_modes_left,the file path to the 'mode config' YAML file for the left leader arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'leader_modes_left.yaml''), +leader_modes_right,the file path to the 'mode config' YAML file for the right leader arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'leader_modes_right.yaml''), +follower_modes_left,the file path to the 'mode config' YAML file for the left follower arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'follower_modes_left.yaml''), +follower_modes_right,the file path to the 'mode config' YAML file for the right follower arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'follower_modes_right.yaml''), +launch_leaders,"if ``true``, launches both the leader and follower arms; if ``false, just the followers are launched.",``true``,"``true``, ``false``" +use_cameras,"if ``true``, launches the camera drivers.",``true``,"``true``, ``false``" +cam_high_name,,``cam_high``, +cam_low_name,,``cam_low``, +cam_left_wrist_name,,``cam_left_wrist``, +cam_right_wrist_name,,``cam_right_wrist``, +is_mobile,,EnvVar\(``INTERBOTIX_ALOHA_IS_MOBILE``\),"``true``, ``false``" +use_base,"if ``true``, launches the driver for the SLATE base.",LaunchConfig\(``is_mobile``\),"``true``, ``false``" +use_joystick_teleop,"if ``true``, launches a joystick teleop node for the base.",LaunchConfig\(``use_base``\),"``true``, ``false``" +use_aloha_rviz,"One of: ('true', 'false')",``false``, +aloha_rvizconfig,,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'rviz' + 'aloha.rviz''), +base_link_frame,"name of the 'root' link on the arm; typically ``base_link``, but can be changed if attaching the arm to a mobile base that already has a ``base_link`` frame.",``base_link``, +use_gripper,"if ``true``, the default gripper is included in the ``robot_description``; if ``false``, it is left out; set to ``false`` if not using the default gripper.",``true``,"``true``, ``false``" +show_ar_tag,"if ``true``, the AR tag mount is included in the ``robot_description``; if ``false``, it is left out; set to ``true`` if using the AR tag mount in your project.",``false``,"``true``, ``false``" +show_gripper_bar,"if ``true``, the gripper_bar link is included in the ``robot_description``; if ``false``, the gripper_bar and finger links are not loaded. Set to ``false`` if you have a custom gripper attachment.",``true``,"``true``, ``false``" +show_gripper_fingers,"if ``true``, the gripper fingers are included in the ``robot_description``; if ``false``, the gripper finger links are not loaded. Set to ``false`` if you have custom gripper fingers.",``true``,"``true``, ``false``" +use_world_frame,"set this to ``true`` if you would like to load a 'world' frame to the ``robot_description`` which is located exactly at the 'base_link' frame of the robot; if using multiple robots or if you would like to attach the 'base_link' frame of the robot to a different frame, set this to ``false``.",``false``,"``true``, ``false``" +external_urdf_loc,the file path to the custom urdf.xacro file that you would like to include in the Interbotix robot's urdf.xacro file.,'', +hardware_type,"configures the ``robot_description`` to use the actual hardware, fake hardware, or hardware simulated in Gazebo.",``actual``,"``actual``, ``fake``, ``gz_classic``" +robot_description_leader_left,URDF of the robot; this is typically generated by the xacro command.,Command(FindExec\(``xacro``\) + ' ' + LocalVar('FindPackageShare\(pkg= ``interbotix_xsarm_descriptions``\) + 'urdf' + LaunchConfig\(``robot_model_leader``\)') + '.urdf.xacro ' + 'robot_name:=' + LaunchConfig\(``robot_name_leader_left``\) + ' ' + 'base_link_frame:=' + LaunchConfig\(``base_link_frame``\) + ' ' + 'use_gripper:=' + LaunchConfig\(``use_gripper``\) + ' ' + 'show_ar_tag:=' + LaunchConfig\(``show_ar_tag``\) + ' ' + 'show_gripper_bar:=' + LaunchConfig\(``show_gripper_bar``\) + ' ' + 'show_gripper_fingers:=' + LaunchConfig\(``show_gripper_fingers``\) + ' ' + 'use_world_frame:=' + LaunchConfig\(``use_world_frame``\) + ' ' + 'external_urdf_loc:=' + LaunchConfig\(``external_urdf_loc``\) + ' ' + 'hardware_type:=' + LaunchConfig\(``hardware_type``\) + ' '), +robot_description_leader_right,URDF of the robot; this is typically generated by the xacro command.,Command(FindExec\(``xacro``\) + ' ' + LocalVar('FindPackageShare\(pkg= ``interbotix_xsarm_descriptions``\) + 'urdf' + LaunchConfig\(``robot_model_leader``\)') + '.urdf.xacro ' + 'robot_name:=' + LaunchConfig\(``robot_name_leader_right``\) + ' ' + 'base_link_frame:=' + LaunchConfig\(``base_link_frame``\) + ' ' + 'use_gripper:=' + LaunchConfig\(``use_gripper``\) + ' ' + 'show_ar_tag:=' + LaunchConfig\(``show_ar_tag``\) + ' ' + 'show_gripper_bar:=' + LaunchConfig\(``show_gripper_bar``\) + ' ' + 'show_gripper_fingers:=' + LaunchConfig\(``show_gripper_fingers``\) + ' ' + 'use_world_frame:=' + LaunchConfig\(``use_world_frame``\) + ' ' + 'external_urdf_loc:=' + LaunchConfig\(``external_urdf_loc``\) + ' ' + 'hardware_type:=' + LaunchConfig\(``hardware_type``\) + ' '), +robot_description_follower_left,URDF of the robot; this is typically generated by the xacro command.,Command(FindExec\(``xacro``\) + ' ' + LocalVar('FindPackageShare\(pkg= ``interbotix_xsarm_descriptions``\) + 'urdf' + LaunchConfig\(``robot_model_follower``\)') + '.urdf.xacro ' + 'robot_name:=' + LaunchConfig\(``robot_name_follower_left``\) + ' ' + 'base_link_frame:=' + LaunchConfig\(``base_link_frame``\) + ' ' + 'use_gripper:=' + LaunchConfig\(``use_gripper``\) + ' ' + 'show_ar_tag:=' + LaunchConfig\(``show_ar_tag``\) + ' ' + 'show_gripper_bar:=' + LaunchConfig\(``show_gripper_bar``\) + ' ' + 'show_gripper_fingers:=' + LaunchConfig\(``show_gripper_fingers``\) + ' ' + 'use_world_frame:=' + LaunchConfig\(``use_world_frame``\) + ' ' + 'external_urdf_loc:=' + LaunchConfig\(``external_urdf_loc``\) + ' ' + 'hardware_type:=' + LaunchConfig\(``hardware_type``\) + ' '), +robot_description_follower_right,URDF of the robot; this is typically generated by the xacro command.,Command(FindExec\(``xacro``\) + ' ' + LocalVar('FindPackageShare\(pkg= ``interbotix_xsarm_descriptions``\) + 'urdf' + LaunchConfig\(``robot_model_follower``\)') + '.urdf.xacro ' + 'robot_name:=' + LaunchConfig\(``robot_name_follower_right``\) + ' ' + 'base_link_frame:=' + LaunchConfig\(``base_link_frame``\) + ' ' + 'use_gripper:=' + LaunchConfig\(``use_gripper``\) + ' ' + 'show_ar_tag:=' + LaunchConfig\(``show_ar_tag``\) + ' ' + 'show_gripper_bar:=' + LaunchConfig\(``show_gripper_bar``\) + ' ' + 'show_gripper_fingers:=' + LaunchConfig\(``show_gripper_fingers``\) + ' ' + 'use_world_frame:=' + LaunchConfig\(``use_world_frame``\) + ' ' + 'external_urdf_loc:=' + LaunchConfig\(``external_urdf_loc``\) + ' ' + 'hardware_type:=' + LaunchConfig\(``hardware_type``\) + ' '), +use_gravity_compensation,"if ``true``, launches the gravity compensation node.",``true``,"``true``, ``false``" +leader_motor_specs_left,the file path to the 'motor specs' YAML file for the left leader arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'leader_motor_specs_left.yaml''), +leader_motor_specs_right,the file path to the 'motor specs' YAML file for the right leader arm.,LocalVar('FindPackageShare\(pkg= ``aloha``\) + 'config' + 'leader_motor_specs_right.yaml''), diff --git a/docs/operation.rst b/docs/operation.rst index 67b3437..0b6c7fd 100644 --- a/docs/operation.rst +++ b/docs/operation.rst @@ -5,6 +5,7 @@ Operation .. toctree:: :maxdepth: 2 + ./operation/bringup_shutdown.rst ./operation/mobile.rst ./operation/stationary.rst ./operation/data_collection.rst diff --git a/docs/operation/bringup_shutdown.rst b/docs/operation/bringup_shutdown.rst new file mode 100644 index 0000000..d347e67 --- /dev/null +++ b/docs/operation/bringup_shutdown.rst @@ -0,0 +1,69 @@ +================== +Bringup & Shutdown +================== + +Bringup +======= + +To bring up a Mobile or Stationary ALOHA, you will need to run the following commands in a terminal: + +.. code-block:: bash + + $ export INTERBOTIX_ALOHA_IS_MOBILE=true/false # true for Mobile, false for Stationary + $ source /opt/ros/humble/setup.bash # configure ROS system install environment + $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment + $ ros2 launch aloha aloha_bringup.launch.py # launch hardware drivers and control software + +.. warning:: + + Terminating bringup while the arms are not in their sleep configurations will cause them to collapse! + Be sure to run through the :ref:`operation/bringup_shutdown:shutdown` procedure before doing so. + +.. tip:: + + The ALOHA can be brought up with additional arguments to customize the behavior. + For a full list of arguments, refer to the :ref:`operation/bringup_shutdown:Arguments for ALOHA Bringup` section below. + +Shutdown +======== + +To shutdown the ALOHA, you will need to first send the arms to their sleep configurations. +While the ALOHA bringup is running in another terminal, open a new one and run the following commands: + +.. code-block:: bash + + $ export INTERBOTIX_ALOHA_IS_MOBILE=true/false # true for Mobile, false for Stationary + $ source /opt/ros/humble/setup.bash # configure ROS system install environment + $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment + $ cd ~/interbotix_ws/src/aloha/scripts/ + $ python3 sleep.py + +The follower arms will move to their "staged" configurations and then place themselves into their sleep configurations. + +.. tip:: + + You can optionally append the ``-a|--all`` flag to the sleep script command to send all arms to their sleep configurations: + + .. code-block:: bash + + $ python3 sleep.py -a + # or + $ python3 sleep.py --all + +Now that the arms are in their sleep configurations, you can terminate the ALOHA bringup by pressing :kbd:`Ctrl` + :kbd:`C` in the terminal where the bringup was launched. + +What's Next? +============ + +Now that you know how to bringup and shutdown the ALOHA, teleoperation will be a good starting point to explore its features. + +- :doc:`/operation/mobile` +- :doc:`/operation/stationary` + +Arguments for ALOHA Bringup +=========================== + +.. csv-table:: + :file: ../_data/bringup.csv + :header-rows: 1 + :widths: 20, 60, 20, 20 diff --git a/docs/operation/data_collection.rst b/docs/operation/data_collection.rst index a8349b3..9cafeff 100644 --- a/docs/operation/data_collection.rst +++ b/docs/operation/data_collection.rst @@ -32,10 +32,7 @@ Recording Episodes To record an episode, follow the steps below: -#. Bring up the ALOHA control stack according to your platform - - * Stationary: :ref:`operation/stationary:Running ALOHA Bringup` - * Mobile: :ref:`operation/mobile:Running ALOHA Bringup` +#. :ref:`operation/bringup_shutdown:bringup` the ALOHA control stack according to your platform #. Configure the environment and run the episode recording script as follows: @@ -43,13 +40,21 @@ To record an episode, follow the steps below: $ source /opt/ros/humble/setup.bash # configure ROS system install environment $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment $ cd ~/interbotix_ws/src/aloha/scripts/ - $ python3 record_episodes.py --task_name --episode_idx + $ python3 record_episodes.py \ + --task_name \ + [--episode_idx ] \ + [-b, --enable_base_torque] \ + [-g, --gravity_compensation] + + The ``task_name`` argument should match one of the task names in the ``TASK_CONFIGS``, as configured in the :ref:`operation/data_collection:Task Creation` section. + + The ``episode_idx`` argument is optional and specifies the index of the episode to record reflected in the output filename ``/episode_.hdf5``. + If not provided, the script will automatically calculate the next episode index based on the number of episodes already saved in the dataset directory. - .. note:: + If the ``-b, --enable_base_torque`` argument is set, mobile base will be torqued on during episode recording, allowing the use of a joystick controller or some other manual method. - The ``task_name`` argument should match one of the task names in the ``TASK_CONFIGS``, as configured in the :ref:`operation/data_collection:Task Creation` section. + If the ``-g, --gravity_compensation`` argument is set, gravity compensation will be enabled for the leader robots when teleop starts. .. tip:: @@ -68,10 +73,7 @@ Episode Playback To play back a previously-recorded episode, follow the steps below: -#. Bring up the ALOHA control stack according to your platform - - * Stationary: :ref:`operation/stationary:Running ALOHA Bringup` - * Mobile: :ref:`operation/mobile:Running ALOHA Bringup` +#. :ref:`operation/bringup_shutdown:bringup` the ALOHA control stack according to your platform #. Configure the environment and run the episode playback script as follows: @@ -79,7 +81,6 @@ To play back a previously-recorded episode, follow the steps below: $ source /opt/ros/humble/setup.bash # configure ROS system install environment $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment $ cd ~/interbotix_ws/src/aloha/scripts/ $ python3 replay_episodes.py --dataset_dir --episode_idx @@ -114,17 +115,6 @@ This value is used to set the path to the ``ROS_SETUP_PATH`` variable used later ROS_DISTRO=humble -``VENV_ACTIVATE_PATH`` -^^^^^^^^^^^^^^^^^^^^^^ - -Set the path to the virtual environment's activate file. -This value is used when setting up the Python virtual environment. -``VENV_ACTIVATE_PATH`` defaults to ``"$HOME/act/bin/activate"``. - -.. code-block:: bash - - VENV_ACTIVATE_PATH="$HOME/act/bin/activate" - ``ROS_SETUP_PATH`` ^^^^^^^^^^^^^^^^^^ @@ -164,16 +154,13 @@ Usage Once configured, the auto_record script is now ready to use. To auto-record a specific amount of episodes, follow the steps below: -#. Bring up the ALOHA control stack according to your platform - - * Stationary: :ref:`operation/stationary:Running ALOHA Bringup` - * Mobile: :ref:`operation/mobile:Running ALOHA Bringup` +#. :ref:`operation/bringup_shutdown:bringup` the ALOHA control stack according to your platform #. In a new terminal, navigate to the directory storing the auto_record script and run the command below: .. code-block:: - $ auto_record.sh + $ auto_record.sh [-b, --enable_base_torque] [-g, --gravity_compensation] .. tip:: @@ -208,3 +195,8 @@ ALOHA saves its episodes in the `hdf5 format`_ with the following format: action (14,) 'float64' base_action (2,) 'float64' (on Mobile) + +What's Next? +============ + +With the data collected, we are ready to :doc:`train and evaluate ` the machine learning models. diff --git a/docs/operation/lerobot_guide.rst b/docs/operation/lerobot_guide.rst index 73f704c..27f1a84 100644 --- a/docs/operation/lerobot_guide.rst +++ b/docs/operation/lerobot_guide.rst @@ -60,7 +60,7 @@ Teleoperation To teleoperate your robot, follow these steps: #. Find the serial numbers of your robot's arms and cameras as described in the following documentation: - + - Arm Symlink Setup: `Aloha Post Install Arm Setup `_ - Camera Setup: `Aloha Post Install Camera Setup `_ @@ -136,7 +136,7 @@ The system supports episode-based data collection, where episodes are time-bound #. The :guilabel:`--num-episodes` defines the total number of episodes to be collected. Therefore it will check the existing output directories for any previously recorded episodes and will start recording from the last recorded episode. - + #. The recorded data is pushed to hugging face hub by default you can set this false by using :guilabel:`--push-to-hub 0`. .. note:: @@ -203,7 +203,7 @@ To replay the first episode of your recorded dataset: Use different :guilabel:`--fps` values to adjust the frequency of the robot actions. -Training +Training ======== To train a policy for controlling your robot, use the following command: @@ -393,9 +393,9 @@ Arrow Keys Not Working During Data Recording (Linux) 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. + Checkout the following version for a smoother operation. Changes will be integrated soon in the newer version of the repository. `Low Frequency Fix `_ diff --git a/docs/operation/mobile.rst b/docs/operation/mobile.rst index 2115f03..82ac493 100644 --- a/docs/operation/mobile.rst +++ b/docs/operation/mobile.rst @@ -2,23 +2,6 @@ Mobile Operation ================ -Running ALOHA Bringup -===================== - -In a terminal, run the following commands: - -.. code-block:: bash - - $ export INTERBOTIX_ALOHA_IS_MOBILE=true # if not already in your environment - $ source /opt/ros/humble/setup.bash # configure ROS system install environment - $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ ros2 launch aloha aloha_bringup.launch.py # launch hardware drivers and control software - -.. warning:: - - Terminating bringup while the follower arms are not in their sleep configurations will cause them to collapse! - Be sure to run the :ref:`operation/mobile:Sending Arms to Sleep Configuration` process before doing so. - Teleoperation ============= @@ -29,43 +12,30 @@ While ALOHA bringup is running in another terminal, open a new one and run the f $ export INTERBOTIX_ALOHA_IS_MOBILE=true # if not already in your environment $ source /opt/ros/humble/setup.bash # configure ROS system install environment $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment $ cd ~/interbotix_ws/src/aloha/scripts/ - $ python3 dual_side_teleop.py + $ python3 dual_side_teleop.py [-g] The arms will lift themselves up into their "staged" configurations. Close both grippers on the leader arms to begin teleop. -While doing teleop, another person can use the included PS4 controller to move the base. You should now be able to teleoperate both sets of arms. +When you finish, place the leader arms in their cradles. Press :kbd:`Ctrl` + :kbd:`C` on the teleoperation terminal to stop teleoperation. -Place the leader arms in their cradles. -Sending Arms to Sleep Configuration -=================================== +.. tip:: -While ALOHA bringup is running in another terminal, open a new one and run the following commands: + If the ``-g`` argument is set, the gravity compensation feature (introduced since 10/04/2024) will be enabled for the leader robots when teleop starts. + Otherwise, the leader arms will be torqued off. -.. code-block:: bash +.. warning:: - $ export INTERBOTIX_ALOHA_IS_MOBILE=false # if not already in your environment - $ source /opt/ros/humble/setup.bash # configure ROS system install environment - $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment - $ cd ~/interbotix_ws/src/aloha/scripts/ - $ python3 sleep.py + Even with the ``-g`` argument set, the arms **WILL** still torque off and drop for a short period of time while enabling/disabling the gravity compensation feature. -The follower arms will move to their "staged" configurations and then place themselves into their sleep configurations. + Please make sure they are readily held while closing the grippers and placed in the cradles before sending them to the sleep configuration. .. tip:: - You can optionally append the ``-a|--all`` flag to the sleep script command to send all arms to their sleep configurations: - - .. code-block:: bash - - $ python3 sleep.py -a - # or - $ python3 sleep.py --all + While doing teleop, another person can use the included PS4 controller to move the base. Joystick Base Teleoperation =========================== @@ -80,3 +50,8 @@ Then proceed with the following steps: #. Use the controller's left stick to send forwards or backwards linear velocity commands. #. Use the controller's right stick to send clockwise or counter-clockwise angular velocity commands. #. At any time, release the controllers :kbd:`L2` button to disable joystick control. + +What's Next? +============ + +Now that you know how to teleoperate, you can start :doc:`collecting data ` with your ALOHA. diff --git a/docs/operation/stationary.rst b/docs/operation/stationary.rst index abcdcda..8002fcc 100644 --- a/docs/operation/stationary.rst +++ b/docs/operation/stationary.rst @@ -2,23 +2,6 @@ Stationary Operation ==================== -Running ALOHA Bringup -===================== - -In a terminal, run the following commands: - -.. code-block:: bash - - $ export INTERBOTIX_ALOHA_IS_MOBILE=false # if not already in your environment - $ source /opt/ros/humble/setup.bash # configure ROS system install environment - $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ ros2 launch aloha aloha_bringup.launch.py # launch hardware drivers and control software - -.. warning:: - - Terminating bringup while the follower arms are not in their sleep configurations will cause them to collapse! - Be sure to run the :ref:`operation/stationary:Sending Arms to Sleep Configuration` process before doing so. - Teleoperation ============= @@ -29,47 +12,29 @@ While ALOHA bringup is running in another terminal, open a new one and run the f $ export INTERBOTIX_ALOHA_IS_MOBILE=false # if not already in your environment $ source /opt/ros/humble/setup.bash # configure ROS system install environment $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment $ cd ~/interbotix_ws/src/aloha/scripts/ - $ python3 dual_side_teleop.py + $ python3 dual_side_teleop.py [-g] The arms will lift themselves up into their "staged" configurations. Close both grippers on the leader arms to begin teleop. You should now be able to teleoperate both sets of arms. +When you finish, place the leader arms in their cradles. Press :kbd:`Ctrl` + :kbd:`C` on the teleoperation terminal to stop teleoperation. -Place the leader arms in their cradles. - -Sending Arms to Sleep Configuration -=================================== - -While ALOHA bringup is running in another terminal, open a new one and run the following commands: - -.. code-block:: bash - - $ export INTERBOTIX_ALOHA_IS_MOBILE=false # if not already in your environment - $ source /opt/ros/humble/setup.bash # configure ROS system install environment - $ source ~/interbotix_ws/install/setup.bash # configure ROS workspace environment - $ source //bin/activate # configure ALOHA Python environment - $ cd ~/interbotix_ws/src/aloha/scripts/ - $ python3 sleep.py - -The follower arms will move to their "staged" configurations and then place themselves into their sleep configurations. .. tip:: - You can optionally append the ``-a|--all`` flag to the sleep script command to send all arms to their sleep configurations: - - .. code-block:: bash + If the mechanical gravity compensation system is not preferred for your application, we also have a software solution introduced since 10/04/2024. - $ python3 sleep.py -a - # or - $ python3 sleep.py --all + You can detach the pulley system from the leader arms and set the ``-g`` argument. + This will enable the gravity compensation feature for the leader robots when teleop starts. -.. Episode Collection -.. ================== +.. warning:: + With the ``-g`` argument set, the arms **WILL** still torque off and drop for a short period of time while enabling/disabling the gravity compensation feature. + Please make sure they are readily held while closing the grippers and placed in the cradles before sending them to the sleep configurations. +What's Next? +============ -.. Automatic Episode Collection -.. ============================ +Now that you know how to teleoperate, you can start :doc:`collecting data ` with your ALOHA. diff --git a/docs/operation/training.rst b/docs/operation/training.rst index 7e00245..46d7e99 100644 --- a/docs/operation/training.rst +++ b/docs/operation/training.rst @@ -119,7 +119,7 @@ Training To start the training, follow the steps below: -#. Sanity Check: +#. Sanity Check: Ensure you have all the hdf5 episodes located in the correct folder after following the data collection steps :ref:`operation/data_collection:Task Creation`. @@ -195,10 +195,7 @@ Evaluation To evaluate a trained model, follow the steps below: -#. Bring up the ALOHA - - - Stationary: :ref:`operation/stationary:Running ALOHA Bringup` - - Mobile: :ref:`operation/mobile:Running ALOHA Bringup` +#. :ref:`operation/bringup_shutdown:bringup` the ALOHA #. Configure the environment @@ -211,7 +208,7 @@ To evaluate a trained model, follow the steps below: #. Run the evaluation script - .. code-block:: bash + .. code-block:: bash :emphasize-lines: 13-14 python3 imitate_episodes.py \ diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index 18508ae..be0c2aa 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -2,6 +2,11 @@ Troubleshooting =============== +.. important:: + + This guide assumes that the latest version of the software packages is used. + Before proceeding, please check that they are up to date. + X-Series Arms =============