edgefirst-schemas 3.2.0

Message schemas for EdgeFirst Perception - ROS2 Common Interfaces, Foxglove, and custom types
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# Python Examples

Comprehensive examples demonstrating EdgeFirst Schemas Python API usage.

## Running Examples

```bash
# Install package in development mode (from repository root)
pip install -e .

# Run examples
python examples/python/basic_types.py
python examples/python/sensor_msgs.py
python examples/python/decode_pointcloud.py
```

## Example Files

### 1. basic_types.py

Demonstrates fundamental ROS2 message types:
- `builtin_interfaces.Time` and `Duration`
- `std_msgs.Header`, `ColorRGBA`
- `geometry_msgs.Vector3`, `Point`, `Quaternion`, `Pose`

**Key concepts:**
- Creating message instances with dataclasses
- Type hints for IDE support
- Accessing nested fields

### 2. sensor_msgs.py

Camera, LiDAR, IMU, and GPS message types with serialization examples.

### 3. decode_pointcloud.py

PointCloud2 decoding with the `decode_pcd` utility.

## Building Blocks

### Creating Messages

```python
from edgefirst.schemas.std_msgs import Header
from edgefirst.schemas.builtin_interfaces import Time

header = Header(
    stamp=Time(sec=1234567890, nanosec=123456789),
    frame_id="camera"
)
```

### Serialization

```python
# Serialize
bytes_data = header.serialize()

# Deserialize
decoded = Header.deserialize(bytes_data)
```

## Additional Resources

- **[EdgeFirst Samples](https://github.com/EdgeFirstAI/samples)** - Complete workflows
- **[Python Type Hints](https://docs.python.org/3/library/typing.html)** - PEP 484

---

**Questions?** support@au-zone.com