You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/PULL_REQUEST_TEMPLATE.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ Provide any relevant links here.
16
16
17
17
## Testing and Verification
18
18
19
-
Please describe the tests that you ran to verify your changes. Please also provide instructions, ROS packages, and Unity project files as appropriate so we can reproduce the test environment.
19
+
Please describe the tests that you ran to verify your changes. Please also provide instructions, ROS packages, and Unity project files as appropriate so we can reproduce the test environment.
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# Contribution Guidelines
2
2
3
-
Thank you for your interest in contributing to Unity Robotics! To facilitate your
4
-
contributions, we've outlined a brief set of guidelines to ensure that your extensions
3
+
Thank you for your interest in contributing to Unity Robotics! To facilitate your
4
+
contributions, we've outlined a brief set of guidelines to ensure that your extensions
5
5
can be easily integrated.
6
6
7
7
## Communication
@@ -40,10 +40,10 @@ We run continuous integration on all PRs; all tests must be passing before the P
40
40
41
41
All Python code should follow the [PEP 8 style guidelines](https://pep8.org/).
42
42
43
-
All C# code should follow the [Microsoft C# Coding Conventions](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions).
44
-
Additionally, the [Unity Coding package](https://docs.unity3d.com/Packages/com.unity.coding@0.1/manual/index.html)
45
-
can be used to format, encode, and lint your code according to the standard Unity
46
-
development conventions. Be aware that these Unity conventions will supersede the
43
+
All C# code should follow the [Microsoft C# Coding Conventions](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions).
44
+
Additionally, the [Unity Coding package](https://docs.unity3d.com/Packages/com.unity.coding@0.1/manual/index.html)
45
+
can be used to format, encode, and lint your code according to the standard Unity
46
+
development conventions. Be aware that these Unity conventions will supersede the
47
47
Microsoft C# Coding Conventions where applicable.
48
48
49
49
Please note that even if the code you are changing does not adhere to these guidelines,
@@ -60,5 +60,5 @@ email us at [unity-robotics@unity3d.com](mailto:unity-robotics@unity3d.com).
60
60
61
61
## Contribution review
62
62
63
-
Once you have a change ready following the above ground rules, simply make a
63
+
Once you have a change ready following the above ground rules, simply make a
Copy file name to clipboardExpand all lines: README.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Simulation plays an important role in robotics development, and we’re here to
19
19
|[Quick Installation Instructions](tutorials/quick_setup.md)| Brief steps on installing the Unity Robotics packages |
20
20
|[Pick-and-Place Demo](tutorials/pick_and_place/README.md)| A complete end-to-end demonstration, including how to set up the Unity environment, how to import a robot from URDF, and how to set up two-way communication with ROS for control |
21
21
|[ROS–Unity Integration](tutorials/ros_unity_integration/README.md)| A set of component-level tutorials showing how to set up communication between ROS and Unity |
22
-
|[URDF Importer](tutorials/urdf_importer/urdf_tutorial.md)| Steps on using the Unity package for loading [URDF](http://wiki.ros.org/urdf) files |
22
+
|[URDF Importer](tutorials/urdf_importer/urdf_tutorial.md)| Steps on using the Unity package for loading [URDF](http://wiki.ros.org/urdf) files |
23
23
| [Articulations Robot Demo](https://github.com/Unity-Technologies/articulations-robot-demo) | A robot simulation demonstrating Unity's new physics solver (no ROS dependency)
24
24
25
25
@@ -43,7 +43,7 @@ Unite Now 2020: Simulating Robots with ROS and Unity [video](https://resources.u
Use articulation bodies to easily prototype industrial designs with realistic motion and behavior [blog post](https://blogs.unity3d.com/2020/05/20/use-articulation-bodies-to-easily-prototype-industrial-designs-with-realistic-motion-and-behavior/)
46
+
Use articulation bodies to easily prototype industrial designs with realistic motion and behavior [blog post](https://blogs.unity3d.com/2020/05/20/use-articulation-bodies-to-easily-prototype-industrial-designs-with-realistic-motion-and-behavior/)
47
47
48
48
### More from Unity
49
49
@@ -67,8 +67,8 @@ Here’s a peek into what our Physics Team is hard at work on…
67
67
68
68
## Community and Feedback
69
69
70
-
The Unity Robotics projects are open-source and we encourage and welcome contributions.
71
-
If you wish to contribute, be sure to review our [contribution guidelines](CONTRIBUTING.md)
70
+
The Unity Robotics projects are open-source and we encourage and welcome contributions.
71
+
If you wish to contribute, be sure to review our [contribution guidelines](CONTRIBUTING.md)
72
72
and [code of conduct](CODE_OF_CONDUCT.md).
73
73
74
74
## Support
@@ -77,7 +77,7 @@ For questions or discussions about Unity Robotics package installations or how t
77
77
78
78
For feature requests, bugs, or other issues, please file a [GitHub issue](https://github.com/Unity-Technologies/Unity-Robotics-Hub/issues) using the provided templates and the Robotics team will investigate as soon as possible.
79
79
80
-
For any other questions or feedback, connect directly with the
80
+
For any other questions or feedback, connect directly with the
81
81
Robotics team at [unity-robotics@unity3d.com](mailto:unity-robotics@unity3d.com).
Copy file name to clipboardExpand all lines: faq.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ How does your Unity integration compare to ROS#?
21
21
---
22
22
Two of the Unity Robotics repos (URDF Importer and TCP Connector) have been forked from the [Siemens ROS# repo](https://github.com/siemens/ros-sharp).
23
23
24
-
In the URDF Importer we have added the functionality to instantiate a robot from URDF into a Unity scene with [Articulation Body](https://docs.unity3d.com/2020.2/Documentation/Manual/class-ArticulationBody.html) components on their corresponding joints.
24
+
In the URDF Importer we have added the functionality to instantiate a robot from URDF into a Unity scene with [Articulation Body](https://docs.unity3d.com/2020.2/Documentation/Manual/class-ArticulationBody.html) components on their corresponding joints.
25
25
26
26
Aside from facilitating communication with the TCP Endpoint, the TCP Connector contains the `MessageGeneration` code from ROS#. We added the extra functionality that when generating a C# class from a ROS message, functions are also generated that will serialize and deserialize the messages as ROS would internally.
> Note: The provided Dockerfile uses the [ROS Melodic base Image](https://hub.docker.com/_/ros/). Building the image will install the necessary packages, copy the [provided ROS packages and submodules](ROS/) to the container, and build the catkin workspace.
38
-
39
-
1. Start the newly built Docker container:
40
-
37
+
> Note: The provided Dockerfile uses the [ROS Melodic base Image](https://hub.docker.com/_/ros/). Building the image will install the necessary packages, copy the [provided ROS packages and submodules](ROS/) to the container, and build the catkin workspace.
38
+
39
+
1. Start the newly built Docker container:
40
+
41
41
```docker
42
42
docker run -it --rm -p 10000:10000 -p 5005:5005 unity-robotics:pick-and-place /bin/bash
43
43
```
44
44
45
-
When this is complete, it will print: `Successfully tagged unity-robotics:pick-and-place`. This console should open into a bash shell at the ROS workspace root, e.g. `root@8d88ed579657:/catkin_ws#`.
45
+
When this is complete, it will print: `Successfully tagged unity-robotics:pick-and-place`. This console should open into a bash shell at the ROS workspace root, e.g. `root@8d88ed579657:/catkin_ws#`.
46
46
47
47
The ROS workspace is now ready to accept commands!
48
48
49
49
---
50
50
51
51
## Option B: Manual Setup
52
52
53
-
1. Navigate to the `/PATH/TO/Unity-Robotics-Hub/tutorials/pick_and_place/ROS` directory of this downloaded repo.
53
+
1. Navigate to the `/PATH/TO/Unity-Robotics-Hub/tutorials/pick_and_place/ROS` directory of this downloaded repo.
54
54
- This directory will be used as the [ROS catkin workspace](http://wiki.ros.org/catkin/Tutorials/using_a_workspace).
55
-
- If you cloned the project and forgot to use `--recurse-submodules`, or if any submodule in this directory doesn't have content, you can run the command `git submodule update --init --recursive` to download packages for Git submodules.
55
+
- If you cloned the project and forgot to use `--recurse-submodules`, or if any submodule in this directory doesn't have content, you can run the command `git submodule update --init --recursive` to download packages for Git submodules.
56
56
- Copy or download this directory to your ROS operating system if you are doing ROS operations in another machine, VM, or container.
57
57
> Note: This contains the ROS packages for the pick-and-place task, including [ROS TCP Endpoint](https://github.com/Unity-Technologies/ROS-TCP-Endpoint), [Niryo One ROS stack](https://github.com/NiryoRobotics/niryo_one_ros), [MoveIt Msgs](https://github.com/ros-planning/moveit_msgs), `niryo_moveit`, and `niryo_one_urdf`.
58
-
58
+
59
59
1. The provided files require the following packages to be installed. ROS Melodic users should run the following commands if the packages are not already present:
60
60
61
61
```bash
@@ -75,7 +75,7 @@ The ROS workspace is now ready to accept commands!
75
75
1. If you have not already built and sourced the ROS workspace since importing the new ROS packages, navigate to your ROS workplace, and run `catkin_make && source devel/setup.bash`. Ensure there are no errors.
76
76
77
77
1. The ROS parameters will need to be set to your configuration in order to allow the server endpoint to fetch values for the TCP connection, stored in `src/niryo_moveit/config/params.yaml`. From your ROS workspace, assign the ROS IP in this `yaml` file:
@@ -85,7 +85,7 @@ The ROS workspace is now ready to accept commands!
85
85
```yaml
86
86
ROS_IP: <your ROS IP>
87
87
```
88
-
88
+
89
89
e.g.
90
90
91
91
```yaml
@@ -98,17 +98,17 @@ The ROS workspace is now ready to accept commands!
98
98
99
99
## Troubleshooting
100
100
- Building the Docker image may throw an `Could not find a package configuration file provided by...` exception if one or more of the directories in ROS/ appears empty. Try downloading the submodules again via `git submodule update --init --recursive`.
101
-
101
+
102
102
- `...failed because unknown error handler name 'rosmsg'` This is due to a bug in an outdated package version. Try running `sudo apt-get update && sudo apt-get upgrade` to upgrade packages.
103
-
103
+
104
104
- If the ROS TCP handshake fails (e.g. `ROS-Unity server listening...` printed on the Unity side but no `ROS-Unity Handshake received` on the ROS side), the ROS IP may not have been set correctly in the params.yaml file. Try running `echo "ROS_IP: $(hostname -I)" > src/niryo_moveit/config/params.yaml` in a terminal from your ROS workspace.
105
105
106
106
---
107
107
108
108
## Resources
109
109
- [Getting started with Docker](https://docs.docker.com/get-started/)
110
110
- Setting up a ROS workspace:
111
-
111
+
112
112
> Note: this tutorial has been tested with ROS Melodic as well as ROS Noetic.
0 commit comments