Skip to content

Commit d2b31f1

Browse files
authored
Update to latest master README (#184)
1 parent 739fdb7 commit d2b31f1

File tree

1 file changed

+81
-17
lines changed

1 file changed

+81
-17
lines changed

README.md

Lines changed: 81 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,29 @@
1-
## UnitySensors
1+
<div align="center">
22

3-
[![Acquire activation file](https://github.com/Field-Robotics-Japan/UnitySensorsROSAssets/workflows/Acquire%20activation%20file/badge.svg)](https://github.com/Field-Robotics-Japan/UnitySensorsROSAssets/actions?query=workflow%3A%22Acquire+activation+file%22)
4-
[![CI](https://github.com/Field-Robotics-Japan/UnitySensorsROSAssets/workflows/CI/badge.svg)](https://github.com/Field-Robotics-Japan/UnitySensorsROSAssets/actions?query=workflow%3ACI)
3+
# UnitySensors
4+
5+
[![][github-release-shield]][github-release-link]
6+
[![][external-unity-shield]][external-unity-link]
7+
[![][external-ros-shield]][external-ros-link]
8+
[![][github-workflow-shield]][github-workflow-link] <br>
9+
[![][github-contributors-shield]][github-contributors-link]
10+
[![][github-forks-shield]][github-forks-link]
11+
[![][github-stars-shield]][github-stars-link]
12+
[![][github-issues-shield]][github-issues-link]
13+
[![][github-license-shield]][github-license-link]
514

615
![unity_sensors_ros_assets](.image/unity_sensors_ros_assets.gif)
716

8-
## Overview
9-
Robot sensor packages available on Unity.
10-
You can communicate sensor info via ROS and ROS2 using ROSTCPConnector and ROSTCPEndpoint.
17+
</div>
18+
19+
## 🔍 Overview
20+
21+
UnitySensos is a projet that regroup two Unity3D packages that allow you to **easly** use Unity3D as robotic simulation !
22+
There are several Prefab and Scene files available for testing each sensor.
23+
24+
**1. UnitySensor**
1125

12-
The following sensors are added.
26+
The following sensors are available inside :
1327

1428
- Velodyne 3D LiDAR (Velodyne VLP-16, VLP-16-HiRes, VLP-32, HDL-32E, VLS-128)
1529
- Livox 3D LiDAR(Avia, Horizon, Mid40, Mid70, Tele, HAP, Mid360)
@@ -20,28 +34,78 @@ The following sensors are added.
2034
- (GroundTruth)
2135
- (TF)
2236

23-
There are several Prefab and Scene files available for testing each sensor.
37+
**2. UnitySensorROS**
38+
39+
This package is responsible to make the link between sensor and ROS by serializing sensor raw data and sending to them to ROS using [ROS-TCP-Connector][external-RosTCPConnector-link] package.
40+
To receive the data in ROS take a look at [ROS-TCP-Endpoint][external-RosTCPEndpoint-link].
41+
42+
## 🚀 Quick start
2443

25-
## Dependencies
26-
- [RosTCPConnector](https://github.com/Unity-Technologies/ROS-TCP-Connector) (Appache 2.0 LICENSE)
44+
### Inside Unity3D
2745

28-
## Package Installation (For using UnitySensors in your project)
29-
1. Using Unity 2021.3 or later, open the Package Manager from `Window` -> `Package Manager`.
46+
> \[!NOTE]
47+
>
48+
> Unitysensor is made for Unity 2020.3 or later
49+
50+
1. Open the Package Manager from `Window` -> `Package Manager`.
3051
2. In the Package Manager window, find and click the + button in the upper lefthand corner of the window. Select `Add package from git URL....`
3152

32-
3. Enter the git URL for the desired package.
33-
1. For the UnitySensors, enter `https://github.com/Field-Robotics-Japan/UnitySensors.git?path=/Assets/UnitySensors#v2.0.4`.
34-
2. For the UnitySensorsROS, enter `https://github.com/Field-Robotics-Japan/UnitySensors.git?path=/Assets/UnitySensorsROS#v2.0.4`.
53+
3. Enter the git URL for the desired package.
54+
1. For the UnitySensors, enter `https://github.com/Field-Robotics-Japan/UnitySensors.git?path=/Assets/UnitySensors#v2.0.5`.
55+
2. For the UnitySensorsROS, enter `https://github.com/Field-Robotics-Japan/UnitySensors.git?path=/Assets/UnitySensorsROS#v2.0.5`.
3556
__Note: UnitySensorsROS does not contain UnitySensors.__
3657
4. Click `Add`.
3758

38-
## Documentation
59+
### Inside ROS workspace
60+
61+
1. Download lastest release of [ROS-TCP-Endpoint][external-RosTCPEndpoint-release-link].
62+
2. Build your workspace.
63+
3. Launch ROS endpoint node.
3964

40-
## LICENSE
65+
## 🤝 Contributing
66+
67+
<div align="center">
68+
69+
A huge thank you to everyone who is helping to improve UnitySensors !
70+
71+
[![contributors badge][github-contributors-img]][github-contributors-link]
72+
73+
</div>
74+
75+
## 🔗 Dependencies
76+
- [ROS-TCP-Connector][external-RosTCPConnector-link] (Appache 2.0 LICENSE)
77+
78+
## 📄 LICENSE
4179
Copyright [2020-2024] Ryodo Tanaka ([email protected]) and Akiro Harada
4280

4381
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
4482

4583
http://www.apache.org/licenses/LICENSE-2.0
4684

4785
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
86+
87+
<!-- LINK GROUP -->
88+
89+
[external-unity-shield]: https://img.shields.io/badge/Unity3D-%3E%202020.3-blue?style=flat-square&logo=unity
90+
[external-unity-link]: https://unity.com/
91+
[external-ros-shield]: https://img.shields.io/badge/ROS-1%7C2-blue?style=flat-square&logo=ros
92+
[external-ros-link]: https://www.ros.org/
93+
[external-RosTCPConnector-link]: https://github.com/Unity-Technologies/ROS-TCP-Connector
94+
[external-RosTCPEndpoint-link]: https://github.com/Unity-Technologies/ROS-TCP-Endpoint
95+
[external-RosTCPEndpoint-release-link]: https://github.com/Unity-Technologies/ROS-TCP-Endpoint/releases
96+
[github-workflow-shield]: https://img.shields.io/github/actions/workflow/status/Field-Robotics-Japan/UnitySensors/main.yml?style=flat-square&logo=github&label=CI%20check
97+
[github-workflow-link]: https://github.com/Field-Robotics-Japan/UnitySensors/actions/workflows/main.yml
98+
[github-contributors-img]: https://readme-contribs.as93.net/contributors/Field-Robotics-Japan/UnitySensors?avatarSize=40&shape=circle
99+
[github-contributors-link]: https://github.com/Field-Robotics-Japan/UnitySensors/graphs/contributors
100+
[github-contributors-shield]: https://img.shields.io/github/contributors/Field-Robotics-Japan/UnitySensors?color=B2FFA3&style=flat-square
101+
[github-forks-link]: https://github.com/Field-Robotics-Japan/UnitySensors/network/members
102+
[github-forks-shield]: https://img.shields.io/github/forks/Field-Robotics-Japan/UnitySensors?color=8ae8ff&style=flat-square
103+
[github-issues-link]: https://github.com/Field-Robotics-Japan/UnitySensors/issues
104+
[github-issues-shield]: https://img.shields.io/github/issues/Field-Robotics-Japan/UnitySensors?color=FFDBFA&style=flat-square
105+
[github-license-link]: https://github.com/Field-Robotics-Japan/UnitySensors/blob/main/LICENSE
106+
[github-license-shield]: https://img.shields.io/github/license/Field-Robotics-Japan/UnitySensors?color=FFADAD&style=flat-square
107+
[github-stars-link]: https://github.com/Field-Robotics-Japan/UnitySensors/network/stargazers
108+
[github-stars-shield]: https://img.shields.io/github/stars/Field-Robotics-Japan/UnitySensors?color=F9DC5F&style=flat-square
109+
[github-release-link]: https://github.com/Field-Robotics-Japan/UnitySensors/releases
110+
[github-release-shield]: https://img.shields.io/github/v/release/Field-Robotics-Japan/UnitySensors?color=9BF6FF&logo=github&style=flat-square
111+

0 commit comments

Comments
 (0)