jongrok-lee / h-mobility-robotics

robotics-course

1. Dependencies
   1. Manual Installation
   2. Installation via rosdep
2. Getting Started
   1. Clone
   2. Build
   3. (Optional) Vscode Include Path
3. 사용되는 로봇 descriptions
4. 폴더별 내용
5. References

Dependencies

Manual Installation

• Eigen (for Kinematics, Pick_n_place, etc.)

  sudo apt install libeigen3-dev

• Moveit and Visual tools (for Kinematics, Workspace, etc.)

  sudo apt install ros-melodic-moveit\
      ros-melodic-moveit-visual-tools\
      ros-melodic-rviz-visual-tools\
      ros-melodic-joint-state-publisher\
      ros-melodic-joint-state-publisher-gui\
      ros-melodic-robot-state-publisher

• yaml-cpp (for IMU tutorial)

  mkdir ~/external_libs; cd ~/external_libs
  git clone https://github.com/jbeder/yaml-cpp.git
  mkdir yaml-cpp/build; cd yaml-cpp/build
  cmake ..

• Controller interface (for OpenBase)

  sudo apt install ros-melodic-controller-interface\
      ros-melodic-effort-controllers\
      ros-melodic-joint-state-controller\
      ros-melodic-gazebo-msgs

• PCL (for Lidar tutorial)

  sudo apt install ros-melodic-pcl-conversions\
      ros-melodic-pcl-ros

• gTest (for kinematics_demo)

  sudo apt install libgtest-dev cmake
  cd /usr/src/gtest
  sudo cmake CMakeLists.txt
  sudo make
  sudo cp *.a /usr/lib

Installation via rosdep

http://wiki.ros.org/rosdep

Getting Started

Clone

Clone this repository into your catkin_ws/src. (How to "git clone" including submodules?)

git clone --recursive https://github.com/rise-lab-skku/robotics-course.git

Build

catkin_make를 사용해도 되지만 이것보다는 catkin build를 더욱 추천.

• 이미 catkin_make를 사용하던 workspace에서 catkin build로 바꾸려면 build, devel 폴더를 삭제하고 catkin build를 시도하면 된다.
• catkin build 명령어를 찾을 수 없다고 나오는 경우, sudo apt-get install python-catkin-tools를 설치하면 된다.
• 병렬적으로 빌드하려는 경우, catkin build -j32 (최대 32개의 job을 동시에 빌드)
• 특정 패키지만 빌드하려는 경우, catkin build {패키지 이름}

(Optional) Vscode Include Path

c_cpp_properties.json

"includePath": [
    "${workspaceFolder}/**",
    "/opt/ros/melodic/include/**",
    "/usr/include/**",
    "~/catkin_ws/devel/include/**",
],

사용되는 로봇 descriptions

robots 폴더 내용

• puma560_description
  • Forked from here
  • urdf에 <collision>태그가 아예 없으면 moveit이 <visual>태그로 충돌을 감지하기 때문에, 충돌을 무시하려면 <collision>태그에 더미를 넣어야 함
• puma560_moveit_config
  • Generated package using MoveIt Assistant
  • Planning group name: puma_560
• puma560_w_collision_description
  • @shinjinjae
  • puma560_description + collision model
• puma560_w_collision_moveit_config
  • Generated package using MoveIt Assistant
  • Planning group name: puma_560
• rrr_description
  • @shinjinjae
• rrr_moveit_config
  • Generated package using MoveIt Assistant
  • Planning group name: rrr
• scara_description
  • @shinjinjae
• scara_moveit_config
  • Generated package using MoveIt Assistant
  • Planning group name: scara

폴더별 내용

• calibration_demo
  • @ryul1206, @kws1611
  • IMU calibration tutorial
• g++/{ Eigen_vs_STL, DH, PoE }
  • @ryul1206
• kinematics_demo/{ so3, se3 }
  • @ohilho (https://github.com/ohilho/PoseRepresentationLibrary)
• kinematics_demo
  • singularity (singularity.cpp)
    • @ohilho, @ssw0536, @shinjinjae, @Seung Won Lee, @ryul1206
  • fk_node (fk_main.cpp): Implemented for Puma560 and RRR
    • @ryul1206
  • ik_node (ik_main.cpp): Implemented for Puma560 and RRR
    • @ryul1206
    • 
  • ik_linear (ik_linear_cartesian.cpp): Implemented for Puma560 and RRR
    • @ryul1206
    • 
• lidar_roi_example
  • @jiyou384
  • Velodyne Puck lidar + PCL library tutorial
• OpenBase (submodule URL: https://github.com/rise-lab-skku/OpenBase)
  • @HukoOo, @ryul1206, @caro33, @shinjinjae
• pick_n_place
  • @ryul1206 (Reference: MoveIt C++ Tutorial)
  • Demo: roslaunch pick_n_place demo.launch and rosrun pick_n_place my_puma
• rosbag_archive
  • @shinjinjae, @kws1611, @ssw0536, @jiyou384
  • rosbag play ***.bag (or rosbag play -l ***.bag)
  • rosbag_archive 폴더만 다운받는 링크
• simscape_demo
  • @shinjinjae, @ryul1206
  • ROS + Matlab + Simscape + Solidworks tutorial
• traj_plan
  • @ohilho
  • Implementation of cubic spline algorithm from Wikipedia
  • traj_plan 폴더만 다운받는 링크
• turtle_control
  • @ohilho, @ssw0536
  • Kalman filter experiments with TurtleBot3
  • Demo: roslaunch turtle_control demo.launch
  • turtle_control/bag 폴더만 다운받는 링크
• turtlebot_path_tracker
  • @shinjinjae
• workspace
  • @ryul1206
  • Workspace drawing tutorial

References

• MoveIt C++ Doxygen (Melodic)