-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
72e952f
commit 429e5a1
Showing
85 changed files
with
721 additions
and
207 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
# Sphinx build info version 1 | ||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. | ||
config: 0444b353554e900c877dbe2f07545936 | ||
config: 974f70283d843519d47035e1189f2cef | ||
tags: 645f666f9bcd5a90fca523b33c5a78b7 |
Binary file not shown.
Binary file not shown.
Binary file renamed
BIN
+12.2 KB
.doctrees/markdown/ros/installation.doctree → ...ros/ROS_installation/installation.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
ROS 1 Installation | ||
================ | ||
This section serves as an installation guide for setting up the ``ROS 1 noetic`` on both **Mac** and **Linux** operating systems. | ||
``ROS`` is a widely used framework for developing robotics software. | ||
|
||
This guide provides step-by-step instructions for installing ``ROS``, allowing developers and enthusiasts to get started | ||
with building robotic applications. | ||
|
||
Installation for: | ||
|
||
.. toctree:: | ||
:maxdepth: 1 | ||
|
||
Linux <./installation.rst> | ||
Mac <./installation_on_mac.rst> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
96 changes: 96 additions & 0 deletions
96
_sources/markdown/ros/ROS_installation/installation_on_mac.rst.txt
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,96 @@ | ||
ROS installation on mac | ||
================ | ||
|
||
- This Document assumes that the reader has installed ``anaconda3`` | ||
make sure to install it before proceeding. | ||
- There are tons of resources available on the Internet to get this | ||
done. | ||
- You can visit the `anaconda website <https://docs.anaconda.com/free/anaconda/install/mac-os.html>`__ for more details on anaconda installation. | ||
|
||
Setting up ROS environment | ||
----------------------- | ||
|
||
Make an environment on your computer named ``ROS`` | ||
you can use any name but since we are makeing it to run ros we'll name it ``ROS`` | ||
|
||
.. code:: shell | ||
conda create -n ROS python=3.9 | ||
- Now enter your ``ROS`` environment | ||
|
||
.. code:: shell | ||
conda activate ROS | ||
- Now we'll add channels to our environment that is ``conda-forge`` and ``robostack``, we are adding conda forge for the package | ||
|
||
.. code:: shell | ||
conda config --add channels conda-forge | ||
.. code:: shell | ||
conda config --add channels robostack | ||
- Set the ``conda`` channel priority to **strict** | ||
|
||
.. code:: shell | ||
conda config --add channel_priority strict | ||
With this our initial setup is done | ||
|
||
Installation | ||
------------ | ||
|
||
1. Install ros-noetic into the environment | ||
|
||
.. code:: shell | ||
conda install ros-noetic-desktop-full | ||
2. Now we'll install compilers for our ``ros`` | ||
|
||
.. code:: shell | ||
conda install compilers cmake pkg-config make ninja colcon-common-extensions catkin_tools | ||
With this we are all set. | ||
|
||
Testing the installation | ||
------------------------ | ||
|
||
After installation you are able to run rviz and other ros tools. | ||
|
||
In the ``conda`` environment activation is the ``ROS`` activation included. There is no need to add a source command in the ``~/.zshrc``. But there is a catch, that you'll have to run ``conda activate ROS`` command in every new instance of terminal. | ||
|
||
First terminal | ||
|
||
.. code:: shell | ||
conda activate ROS | ||
roscore | ||
Second terminal | ||
|
||
.. code:: shell | ||
conda activate ROS | ||
rviz | ||
How to install ``ROS`` packages on mac | ||
----------------------------------------- | ||
|
||
Though we have installed the ros-noetic-desktop-full --version which comes with common built in packages like rviz, turtlesim and many more. There might be something specific you need so you'll need to search up the packag you're looking for `here <https://robostack.github.io/noetic.html>`__ | ||
|
||
If you've found what you were looking for then run this command and replace the package name with the one you want to install. | ||
|
||
.. code:: shell | ||
conda install ros-noetic-"package name here" | ||
.. Note:: | ||
#. The ROS commands only work while you are in the ROS environment. | ||
#. The packages available are a bit limited. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.