Skip to content

Commit

Permalink
Merge pull request #74 from fabawi/dev
Browse files Browse the repository at this point in the history
Further updates renaming ROS2 to ROS 2
  • Loading branch information
fabawi authored Nov 6, 2023
2 parents 7fb5bb0 + 97f5d41 commit 4baa6e0
Show file tree
Hide file tree
Showing 27 changed files with 30 additions and 30 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Note that the iCub package is not needed for Wrapyfi to work and does not have t
* For installing ROS, follow the [ROS installation guide](http://wiki.ros.org/noetic/Installation/Ubuntu).
We recommend installing ROS on Conda using the [RoboStack](https://github.com/RoboStack/ros-noetic) environment.

* For installing ROS2, follow the [ROS 2 installation guide](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html).
* For installing ROS 2, follow the [ROS 2 installation guide](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html).
We recommend installing ROS 2 on Conda using the [RoboStack](https://github.com/RoboStack/ros-humble) environment.

* ZeroMQ can be installed using pip: `pip install pyzmq`.
Expand Down Expand Up @@ -279,7 +279,7 @@ For more examples of usage, refer to the [user guide](docs/usage.md). Run script
## Middleware
* [x] **YARP**
* [x] **ROS**
* [x] **ROS2**
* [x] **ROS 2**
* [x] **ZeroMQ** (beta feature: `should_wait` trigger introduced with event monitoring)


Expand Down
2 changes: 1 addition & 1 deletion docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ def setup(app):
all_imported_modules = all_imported_modules_pre
mock_imports = [mod for mod in all_imported_modules]
autodoc_mock_imports = mock_imports
# run from within an environment that has all requirements installed besides ROS2
# run from within an environment that has all requirements installed besides ROS 2
# autodoc_mock_imports = ["rclpy", "rclpy.node", "Parameter", "Node"]

# extract project info
Expand Down
2 changes: 1 addition & 1 deletion docs/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Methods with a single return should be followed by a comma e.g., return encapsul

Each of the list's returns is encapsulated with its own publisher and listener, with the named arguments transmitted as
a single dictionary within the list. Notice that `encapsulated_a` returns a list of length 3, therefore, the first decorator contains
3 list configurations as well. This is useful especially when transmitting multiple images or audio chunks over YARP, ROS, and ROS2.
3 list configurations as well. This is useful especially when transmitting multiple images or audio chunks over YARP, ROS, and ROS 2.
Note that by using a single `NativeObject` as a `<Data structure type>`, the same
can be achieved. However, the implementation of the `NativeObject` for most middleware serializes the
objects as strings before transmission. The `NativeObject` may result in a greater overhead and should only be used when multiple nesting depths are
Expand Down
2 changes: 1 addition & 1 deletion docs/usage/User Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Methods with a single return should be followed by a comma e.g., return encapsul

Each of the list's returns is encapsulated with its own publisher and listener, with the named arguments transmitted as
a single dictionary within the list. Notice that `encapsulated_a` returns a list of length 3, therefore, the first decorator contains
3 list configurations as well. This is useful especially when transmitting multiple images or audio chunks over YARP, ROS, and ROS2.
3 list configurations as well. This is useful especially when transmitting multiple images or audio chunks over YARP, ROS, and ROS 2.
Note that by using a single `NativeObject` as a `<Data structure type>`, the same
can be achieved. However, the implementation of the `NativeObject` for most middleware serializes the
objects as strings before transmission. The `NativeObject` may result in a greater overhead and should only be used when multiple nesting depths are
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/User Guide/Communication Patterns.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ All messages are transmitted using the rospy python bindings as topic messages
[geometry_msgs](http://wiki.ros.org/geometry_msgs), and [sensor_msgs](http://wiki.ros.org/sensor_msgs) can be directly
returned by the method do not need to be converted to native types

*(ROS2)*:
*(ROS 2)*:

```{warning}
ROS 2 requires a custom message to handle audio. This message must be compiled first before using Wrapyfi with ROS 2 Audio.
Expand Down Expand Up @@ -100,7 +100,7 @@ The requester formats its arguments as *(\[args\], {kwargs})*
* **AudioChunk**: Transmits and receives a `numpy` audio chunk using `wrapyfi_ros_interfaces.msg.ROSAudioMessage`
* **NativeObject**: Transmits and receives a `json` string supporting all native python objects, `numpy` arrays, and [other formats](<Plugins.md#data-structure-types>) using `std_msgs.msg.String`

*(ROS2)*:
*(ROS 2)*:

```{warning}
ROS 2 requires custom services to handle arbitrary messages. These services must be compiled first before using Wrapyfi in this mode.
Expand Down
2 changes: 1 addition & 1 deletion examples/communication_patterns/request_reply_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- OpenCV: Used for handling and creating images (installed with Wrapyfi)
- sounddevice, soundfile: Used for handling audio
Expand Down
2 changes: 1 addition & 1 deletion examples/communication_schemes/channeling_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- NumPy: Used for creating arrays (installed with Wrapyfi)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/communication_schemes/forwarding_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
Run:
# On machine 1 (or process 1): Mode Chain A: Publisher [ZeroMQ], Chain B: Disabled (chain A & B can have different middleware
Expand Down
2 changes: 1 addition & 1 deletion examples/communication_schemes/mirroring_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
Run:
# Alternative 1: PUB/SUB
Expand Down
4 changes: 2 additions & 2 deletions examples/custom_msgs/ros2_message_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- ROS2, rclpy: Used for handling and creating ROS 2 messages (refer to the Wrapyfi documentation for installation instructions)
- ROS 2, rclpy: Used for handling and creating ROS 2 messages (refer to the Wrapyfi documentation for installation instructions)
Ensure ROS 2 is installed and the required message types are available.
Expand Down Expand Up @@ -43,7 +43,7 @@ class Notifier(MiddlewareCommunicator):
should_wait=True
)
def send_message(self):
"""Exchange ROS 2 messages over ROS2."""
"""Exchange ROS 2 messages over ROS 2."""
msg = input("Type your message: ")
quat = Quaternion()
quat.x = 0.1
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/astropy_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- Astropy: Used for creating and handling astronomical tables
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/dask_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- Dask, pandas: Used for handling and creating arrays and dataframes
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/jax_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- JAX: Used for handling and creating arrays (refer to https://jax.readthedocs.io/en/latest/installation.html for installation instructions)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/mxnet_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- MXNet: Used for handling and creating tensors (refer to https://mxnet.apache.org/get_started for installation instructions)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/numpy_pandas_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- NumPy: Used for creating arrays (installed with Wrapyfi)
- pandas: Used for creating and handling series and dataframes
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/paddlepaddle_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- PaddlePaddle: Used for handling and creating tensors (refer to https://www.paddlepaddle.org.cn/en/install/quick for installation instructions)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/pillow_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- NumPy: Used for creating image arrays (installed with Wrapyfi)
- PIL (Pillow): Used for handling image objects
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/pint_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- Pint: Used for handling physical quantities with units
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/pyarrow_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- PyArrow: Used for handling Apache Arrow arrays
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/pytorch_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- PyTorch: Used for handling and creating tensors (refer to https://pytorch.org/get-started/locally/ for installation instructions)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/tensorflow_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- TensorFlow: Used for creating and handling tensors (refer to https://www.tensorflow.org/install for installation instructions)
Install using pip:
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/xarray_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- NumPy: Used for creating arrays (installed with Wrapyfi)
- xarray, pandas: Used for creating and handling DataArrays
Expand Down
2 changes: 1 addition & 1 deletion examples/encoders/zarr_example.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- NumPy: Used for creating arrays (installed with Wrapyfi)
- zarr: Used for creating and handling Zarr arrays and groups
Expand Down
2 changes: 1 addition & 1 deletion examples/hello_world.py
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
Run:
# Alternative 1: PUB/SUB mode
Expand Down
2 changes: 1 addition & 1 deletion examples/robots/icub_head.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- iCub Robot and Simulator: Ensure the robot and its simulator are installed and configured.
When running in simulation mode, the `iCub_SIM` must be running in a standalone terminal
(refer to the Wrapyfi documentation for installation instructions)
Expand Down
2 changes: 1 addition & 1 deletion examples/sensors/cam_mic.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
Requirements:
- Wrapyfi: Middleware communication wrapper (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- YARP, ROS, ROS 2, ZeroMQ (refer to the Wrapyfi documentation for installation instructions)
- OpenCV: Used for handling and creating images (installed with Wrapyfi)
- sounddevice, soundfile: Used for handling audio
Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ def check_cv2(default_python="opencv-python"):

setuptools.setup(
name = 'wrapyfi',
version = '0.4.27',
version = '0.4.28',
description = 'Wrapyfi is a wrapper for simplifying Middleware communication',
url = 'https://github.com/fabawi/wrapyfi/blob/master/',
project_urls={
Expand Down

0 comments on commit 4baa6e0

Please sign in to comment.