Skip to content

Commit 0f64d46

Browse files
[update] Update 'README.md'
1 parent d4c434a commit 0f64d46

File tree

1 file changed

+21
-13
lines changed

1 file changed

+21
-13
lines changed

README.md

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,31 @@
1-
# pytorch_ros
1+
# pytorch_scene_recognition_ros
22

33
## 1. Overview
44

5-
A ROS package to use [LibTorch](https://pytorch.org/cppdocs/), a PyTorch C++ API, for inference on a trained model.
5+
A ROS package to use [LibTorch](https://pytorch.org/cppdocs/), a PyTorch C++ API, for inference with our scene recognition models.
66

77
A Docker environment for running this package is [here](https://github.com/ActiveIntelligentSystemsLab/pytorch-enet-docker).
88
This package is **only tested in the virtual environment**.
99

10-
## 2. Nodes
10+
## 2. Requirements
1111

12-
### 2.1 `pytorch_seg_trav_path_node`
12+
- PyTorch with LibTorch built
13+
- Tested with 1.5.0
14+
- [semantic_segmentation_srvs/GetLabelAndProbability](https://github.com/ActiveIntelligentSystemsLab/aisl_utils/blob/master/aisl_srvs/semantic_segmentation_srv/srv/GetLabelAndProbability.srv)
1315

14-
#### **2.1.1 Subscribed topics**
16+
## 3. Nodes
17+
18+
### 3.1 `pytorch_seg_trav_path_node`
19+
20+
A node to use a multi-task model for semantic segmentation, traversability estimation, and path estimation.
21+
22+
#### **3.1.1 Subscribed topics**
1523

1624
- `image` ([sensor_msgs/Image](http://docs.ros.org/melodic/api/sensor_msgs/html/msg/Image.html))
1725

1826
An input image
1927

20-
#### **2.1.2 Published topics**
28+
#### **3.1.2 Published topics**
2129

2230
- `label` ([sensor_msgs/Image](http://docs.ros.org/melodic/api/sensor_msgs/html/msg/Image.html))
2331

@@ -39,15 +47,15 @@ This package is **only tested in the virtual environment**.
3947

4048
End point of the estimated path line
4149

42-
#### **2.1.3 Service**
50+
#### **3.1.3 Service**
4351

4452
- `get_label_image` ([semantic_segmentation_srvs/GetLabelAndProbability](https://github.com/ActiveIntelligentSystemsLab/aisl_utils/blob/master/aisl_srvs/semantic_segmentation_srv/srv/GetLabelAndProbability.srv))
4553

4654
Return inference results (segmentation and traversability) for a given image.
4755

48-
### **2.2 visualizer.py**
56+
### **3.2 visualizer.py**
4957

50-
#### **2.2.1 Subscribed topics**
58+
#### **3.2.1 Subscribed topics**
5159

5260
- `image` ([sensor_msgs/Image](http://docs.ros.org/melodic/api/sensor_msgs/html/msg/Image.html))
5361

@@ -61,19 +69,19 @@ This package is **only tested in the virtual environment**.
6169

6270
End point of the estimated path line from the inference node
6371

64-
#### **2.2.2 Published topics**
72+
#### **3.2.2 Published topics**
6573

6674
- `image_with_path` ([sensor_msgs/Image](http://docs.ros.org/melodic/api/sensor_msgs/html/msg/Image.html))
6775

6876
An image with the path overlaid
6977

70-
## 3. How to run the node
78+
## 4. How to run the node
7179

7280
```
7381
roslaunch pytorch_enet_ros.launch image:=<image topic name> model_name:=<model name>
7482
```
7583

76-
## 4. Weight files
84+
## 5. Weight files
7785

7886
The ROS nodes in this package use models saved as a serialized Torch Script file.
7987

@@ -86,7 +94,7 @@ If the version of PyTorch that runs this ROS package and that you generate your
8694

8795
For example, if you use [our Docker environment](https://github.com/ActiveIntelligentSystemsLab/pytorch-enet-docker), the weights should be generated using PyTorch 1.5.0.
8896

89-
## 5. Color map
97+
## 6. Color map
9098

9199
For visualization of semantic segmentation, we use a color map image.
92100

0 commit comments

Comments
 (0)