From 5e1f0ba99e08c312c46a13567d69daebb9bb7d1f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=8Dcaro=20Abreu?= <136408366+oicaroabreu@users.noreply.github.com> Date: Tue, 20 Jun 2023 23:47:55 -0300 Subject: [PATCH] Update README.md Updated README.md with comprehensive project information and aligned with A.T.O.M Robotics template --- README.md | 210 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 206 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index d160d7c..8420b9f 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,135 @@ -# Installation + + + -## Make a new workspace + + + +[![Contributors][contributors-shield]][contributors-url] +[![Forks][forks-shield]][forks-url] +[![Stargazers][stars-shield]][stars-url] +[![Issues][issues-shield]][issues-url] +[![MIT License][license-shield]][license-url] +[![LinkedIn][linkedin-shield]][linkedin-url] + + + + +
+
+ + Logo + + +

Best-README-Template

+ +

+ This is the repo focus on the development of a perception pipeline for the MR-Robot: ModulaR Robot Project, Mr robot is autonomous navigation robot made by A.T.O.M Robotics capable of doing multiple day to day operations such as mapping, navigation for transportation, sanitaion etc. Various other operations can also be performed thanks to its modularity. + If you’re interested in helping to improve our Project, find out how to contribute. +
+
+
+ Report Bug + · + Request Feature +

+
+ + + + +
+ Table of Contents +
    +
  1. + About The Project + +
    2. +
  2. + Getting Started + +
    3. +
  3. Usage + +
    4. + +
  4. Contributing
    5. +
  5. License
    6. +
  6. Contact
    7. +
  7. Acknowledgments
    8. +
+
+ + + + +## About The Project + +The perception pipeline project aims to develop a robust and efficient system for extracting meaningful information from sensor data in order to enable autonomous robots, such as the MR-Robot, to understand and interact with their environment. By incorporating advanced techniques like object detection using deep learning models, the perception pipeline enhances the robot's ability to detect and identify objects, enabling it to perform tasks such as mapping, navigation, and sanitation. This project focuses on creating a modular and adaptable perception pipeline that can be customized and expanded to suit different robotic applications, thereby paving the way for more intelligent and capable autonomous systems. + +

(back to top)

+ +### Built With + +* [![ROS](https://img.shields.io/badge/ros-%230A0FF9.svg?style=for-the-badge&logo=ros&logoColor=white)](https://www.sphinx-docs.org) +* [![OpenCV](https://img.shields.io/badge/opencv-%23white.svg?style=for-the-badge&logo=opencv&logoColor=white)](https://opencv.org/) +* [![Blender](https://img.shields.io/badge/blender-%23F5792A.svg?style=for-the-badge&logo=blender&logoColor=white)](https://www.blender.org/) +* [![Raspberry Pi](https://img.shields.io/badge/-RaspberryPi-C51A4A?style=for-the-badge&logo=Raspberry-Pi)](https://www.raspberrypi.org/) +* [![Espressif](https://img.shields.io/badge/espressif-E7352C?style=for-the-badge&logo=espressif&logoColor=white)](https://www.espressif.com/) +* [![Arduino](https://img.shields.io/badge/Arduino-00979D?style=for-the-badge&logo=Arduino&logoColor=white)](https://www.arduino.cc/) +* [![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge&logo=ubuntu&logoColor=white)](https://ubuntu.com/) +* [![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/) + +

(back to top)

+ + +## Getting Started + +This is an example of how you may give instructions on setting up your project locally. +To get a local copy up and running follow these simple example steps. + +### Prerequisites + +This is an example of how to list things you need to use the software and how to install them. +* Ros + - Refer to our [Ros installation guide](https://atom-robotics-lab.github.io/wiki/markdown/ros/installation.html) + - Installing Navigation specific dependencies: map-server, move_base and amcl + ```sh + sudo apt install ros-noetic-map-server ros-noetic-move-base ros-noetic-amcl + ``` + +* Opencv + ```sh + sudo apt install libopencv-dev python3-opencv + ``` + +### Installation + +1. Make a new workspace ```bash mkdir -p percep_ws/src ``` -## Clone the ROS-Perception-Pipeline repository +2. Clone the ROS-Perception-Pipeline repository Now go ahead and clone this repository inside the "src" folder of the workspace you just created. @@ -15,7 +139,7 @@ cd percep_ws/src git clone git@github.com:atom-robotics-lab/ros-perception-pipeline.git ``` -## Make the package +3. Make the package We'll need to "make" everything in our catkin workspace so that the ROS environment knows about our new package. (This will also compile any necessary code in the package). Execute the given commands in your terminal. @@ -28,6 +152,9 @@ Now you will need to source your workspace source install/local_setup.bash ``` + + + ## Usage
@@ -76,6 +203,81 @@ ros2 run rqt_image_view rqt_image_view
+

(back to top)

+ + + + + + + +## Contributing + +Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. + +1. Fork the Project +2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) +3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) +4. Push to the Branch (`git push origin feature/AmazingFeature`) +5. Open a Pull Request + +

(back to top)

+ + +## License + +Distributed under the MIT License. See `LICENSE` for more information. + +
+ + +## Contact + +Our Socials - [Linktree](https://linktr.ee/atomlabs) - atom@inventati.org + +

(back to top)

+ + +## Acknowledgments + +* [Our wiki](https://atom-robotics-lab.github.io/wiki) +* [ROS Official Documentation](http://wiki.ros.org/Documentation) +* [Opencv Official Documentation](https://docs.opencv.org/4.x/) +* [Rviz Documentation](http://wiki.ros.org/rviz) +* [Gazebo Tutorials](https://classic.gazebosim.org/tutorials) +* [Ubuntu Installation guide](https://ubuntu.com/tutorials/install-ubuntu-desktop#1-overview) +* [Raspberrypi Documentation](https://www.raspberrypi.com/documentation/) +* [Esp32 Documentation](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/) +* [Blender Documentaion](https://docs.blender.org/) +* [YOLOv3](https://arxiv.org/abs/1804.02767) +* [YOLOv4](https://arxiv.org/abs/2004.10934) + +

(back to top)

+ + +[contributors-shield]: https://img.shields.io/github/contributors/atom-robotics-lab/MR-Robot.svg?style=for-the-badge +[contributors-url]: https://github.com/atom-robotics-lab/MR-Robot/graphs/contributors +[forks-shield]: https://img.shields.io/github/forks/atom-robotics-lab/MR-Robot.svg?style=for-the-badge +[forks-url]: https://github.com/atom-robotics-lab/wiki/network/members +[stars-shield]: https://img.shields.io/github/stars/atom-robotics-lab/MR-Robot.svg?style=for-the-badge +[stars-url]: https://github.com/atom-robotics-lab/wiki/stargazers +[issues-shield]: https://img.shields.io/github/issues/atom-robotics-lab/MR-Robot.svg?style=for-the-badge +[issues-url]: https://github.com/atom-robotics-lab/MR-Robot/issues +[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555 +[linkedin-url]: https://www.linkedin.com/company/a-t-o-m-robotics-lab/ \ No newline at end of file