diff --git a/README.md b/README.md index 1ec3acb..6942ea9 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,6 @@ [![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] @@ -33,17 +32,17 @@ Logo -

Best-README-Template

+

ROS-Perception-Pipeline

- 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. + This repo is focused on developing a ROS 2 based perception-pipeline. + If you’re interested in helping to improve our Project, find out how to contribute.


-
Report Bug + Report Bug · - Request Feature + Request Feature

@@ -84,18 +83,16 @@ ## 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. +Our aim is to build a one-stop solution to all the problems related to Robotics-Perception. We are creating a plug-and-play ROS 2 based perception-pipeline which can be customized +for user-specific custom tasks in the blink of an eye. We are in the process of creating different components for tasks like Object Detection, Image Pre-Processing, Image Segmentation etc. +These components can be stitched together to make a custom pipeline for any use-case, just like how we play with LEGO bricks.

(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) +* [![ROS 2](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/) @@ -104,53 +101,47 @@ The perception pipeline project aims to develop a robust and efficient system fo ## 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. +Follow these steps to setup this project on your systm ### 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 - ``` +Follow these steps to install ROS Humble and OpenCV +* ROS Humble +Refer to the official [ROS 2 installation guide](https://docs.ros.org/en/humble/Installation.html) -* Opencv - ```sh - sudo apt install libopencv-dev python3-opencv +* OpenCV + ```bash + pip install opencv-contrib-python ``` ### Installation 1. Make a new workspace -```bash -mkdir -p percep_ws/src -``` + ```bash + mkdir -p percep_ws/src + ``` 2. Clone the ROS-Perception-Pipeline repository -Now go ahead and clone this repository inside the "src" folder of the workspace you just created. - -```bash -cd percep_ws/src - -git clone git@github.com:atom-robotics-lab/ros-perception-pipeline.git -``` + Now go ahead and clone this repository inside the "src" folder of the workspace you just created. -3. Make the package + ```bash + cd percep_ws/src + git clone git@github.com:atom-robotics-lab/ros-perception-pipeline.git + ``` -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. +3. Compile the package -```bash -colcon build --symlink-install -``` + Follow this execution to compile your ROS 2 package + + ```bash + colcon build --symlink-install + ``` -Now you will need to source your workspace -```bash -source install/local_setup.bash -``` +4. Source your workspace + ```bash + source install/local_setup.bash + ``` @@ -264,11 +255,6 @@ Our Socials - [Linktree](https://linktr.ee/atomlabs) - atom@inventati.org * [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)

diff --git a/contributing.md b/contributing.md new file mode 100644 index 0000000..a4b7ebc --- /dev/null +++ b/contributing.md @@ -0,0 +1,41 @@ +## Contributing + +Hi there! We're thrilled that you'd like to contribute to Hacktoberfest. Your help is essential for keeping it great. + + +## Opening an issue + +Thank you for taking the time to open an issue, your feedback helps make Hacktoberfest better. +Before opening an issue, please be sure that your issue hasn't already been asked by using [GitHub search](https://help.github.com/articles/searching-issues/) + +Here are a few things that will help us help resolve your issues: + +- A descriptive title that gives an idea of what your issue refers to +- A thorough description of the issue, (one word descriptions are very hard to understand) +- Screenshots (if appropriate) +- Links (if appropriate) + +## Submitting a pull request + +* Clone the repository using : + ```bash + git clone git@github.com:atom-robotics-lab/ros-perception-pipeline.git + ``` +* Our wiki uses an open-source framework called ROS. Use this [link](http://wiki.ros.org/) to install and use ROS + +* Refer to the section below if your task requires you to make changes to Repository. + +* Fork the repo and Create a new branch: + ```bash + git checkout -b my-branch-name + ``` +* Make changes, commit and Push to your branch. [Submit a Pull Request](https://github.com/atom-robotics-lab/ros-perception-pipeline/pulls) + +* Wait for your pull request to be reviewed and merged! + +## Resources + +- [Contributing to Open Source on GitHub](https://guides.github.com/activities/contributing-to-open-source/) +- [Using Pull Requests](https://help.github.com/articles/using-pull-requests/) +- [GitHub Help](https://help.github.com) +- [ros](http://wiki.ros.org/) \ No newline at end of file