@@ -27,162 +27,6 @@ terrain can be efficiently generated.
2727}
2828```
2929
30- ## Installation
31-
32- #### CUDA & cuDNN
33-
34- The tested versions are CUDA10.2, 11.6
35-
36- [ CUDA] ( https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#ubuntu-installation )
37- [ cuDNN] ( https://docs.nvidia.com/deeplearning/sdk/cudnn-install/index.html#install-linux ) .
38-
39- Check how to install [ here] ( doc/cuda-installation.md ) .
40-
41- #### Python dependencies
42-
43- You will need
44-
45- - [ cupy] ( https://cupy.chainer.org/ )
46- - [ numpy] ( https://www.numpy.org/ )
47- - [ scipy] ( https://www.scipy.org/ )
48- - [ shapely==1.7.1] ( https://github.com/Toblerity/Shapely )
49-
50- For traversability filter, either of
51-
52- - [ torch] ( https://pytorch.org/ )
53- - [ chainer] ( https://chainer.org/ )
54-
55- Optionally, OpenCV for inpainting filter.
56-
57- - [ opencv-python] ( https://opencv.org/ )
58-
59- Install ` numpy ` , ` scipy ` , ` shapely ` , ` opencv-python ` with the following command.
60-
61- ``` bash
62- pip3 install -r requirements.txt
63- ```
64-
65- #### Cupy
66-
67- cupy can be installed with specific CUDA versions. (On jetson, only "from source" i.e. ` pip install cupy ` could work)
68- > For CUDA 10.2
69- > pip install cupy-cuda102
70- >
71- > For CUDA 11.0
72- > pip install cupy-cuda110
73- >
74- > For CUDA 11.1
75- > pip install cupy-cuda111
76- >
77- > For CUDA 11.2
78- > pip install cupy-cuda112
79- >
80- > For CUDA 11.3
81- > pip install cupy-cuda113
82- >
83- > For CUDA 11.4
84- > pip install cupy-cuda114
85- >
86- > For CUDA 11.5
87- > pip install cupy-cuda115
88- >
89- > For CUDA 11.6
90- > pip install cupy-cuda116
91- >
92- > (Install CuPy from source)
93- > % pip install cupy
94-
95- #### Traversability filter
96-
97- You can choose either pytorch, or chainer to run the CNN based traversability filter.
98- Install by following the official documents.
99-
100- - [ torch] ( https://pytorch.org/ )
101- - [ chainer] ( https://chainer.org/ )
102-
103- Pytorch uses ~ 2GB more GPU memory than Chainer, but runs a bit faster.
104- Use parameter ` use_chainer ` to select which backend to use.
105-
106- #### ROS package dependencies
107-
108- - [ pybind11_catkin] ( https://github.com/ipab-slmc/pybind11_catkin )
109- - [ grid_map] ( https://github.com/ANYbotics/grid_map )
110-
111- ``` bash
112- sudo apt install ros-noetic-pybind11-catkin
113- sudo apt install ros-noetic-grid-map-core ros-noetic-grid-map-msgs
114- ```
115-
116- ### On Jetson
117-
118- #### CUDA CuDNN
119-
120- ` CUDA ` and ` cuDNN ` can be installed via apt. It comes with nvidia-jetpack. The tested version is jetpack 4.5 with L4T 32.5.0.
121-
122- #### python dependencies
123-
124- On jetson, you need the version for its CPU arch:
125-
126- ``` bash
127- wget https://nvidia.box.com/shared/static/p57jwntv436lfrd78inwl7iml6p13fzh.whl -O torch-1.8.0-cp36-cp36m-linux_aarch64.whl
128- pip3 install Cython
129- pip3 install numpy==1.19.5 torch-1.8.0-cp36-cp36m-linux_aarch64.whl
130- ```
131-
132- Also, you need to install cupy with
133-
134- ``` bash
135- pip3 install cupy
136- ```
137-
138- This builds the packages from source so it would take time.
139-
140- #### ROS dependencies
141-
142- - [ pybind11_catkin] ( https://github.com/ipab-slmc/pybind11_catkin )
143- - [ grid_map] ( https://github.com/ANYbotics/grid_map )
144-
145- ``` bash
146- sudo apt install ros-melodic-pybind11-catkin
147- sudo apt install ros-melodic-grid-map-core ros-melodic-grid-map-msgs
148- ```
149-
150- Also, on jetson you need fortran (should already be installed).
151-
152- ``` bash
153- sudo apt install gfortran
154- ```
155-
156- If the Jetson is set up with Jetpack 4.5 with ROS Melodic the following package is additionally required:
157-
158- ``` bash
159- git clone
[email protected] :ros/filters.git -b noetic-devel
160- ```
161-
162- ### Plane segmentation dependencies
163-
164- #### OpenCV
165-
166- ``` bash
167- sudo apt install libopencv-dev
168- ```
169-
170- #### Eigen
171-
172- ``` bash
173- sudo apt install libeigen3-dev
174- ```
175-
176- #### CGAL
177-
178- CGAL5 is required. It will be automatically downloaded and installed into the catkin workspace by the cgal5_catkin package. Make sure you
179- have the third-party libaries installed on you machine:
180-
181- ``` bash
182- sudo apt install libgmp-dev
183- sudo apt install libmpfr-dev
184- sudo apt install libboost-all-dev
185- ```
18630
18731## Usage
18832
0 commit comments