v0.2.1 (Enhanced Filtering & Simplified CLI)

This patch release improves data quality with enhanced noise filtering and streamlines CLI usage by removing subcommands.

Major Improvements

Enhanced Point Filtering

  • Single Point Noise (SPN) Filtering: New filtering for single-point noise artifacts
  • Combined Invalid Point Filtering: SPN filtering works alongside existing invalid point detection
  • Consistent Control: Use -k or --keep-invalid-points to disable all filtering (including SPN)

Simplified CLI Interface

Streamlined Command Structure: Removed subcommands from CLI tools - network configuration arguments are now specified directly:

Before (v0.2.0):

voyant_foxglove_bridge multicast --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100

Now (v0.2.1):

voyant_foxglove_bridge --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100

Key Changes:

  • Removed multicast subcommand requirement
  • Removed unicast support (multicast is now the default)
  • Eliminated complex argument ordering requirements
  • Simplified CLI help and usage

Enhanced Logging System

  • Structured Logging: Replaced print statements with proper logging infrastructure
  • Configurable Log Levels: Control verbosity with RUST_LOG environment variable
  • C++ Integration: New voyant_log_init_c() function for C++ applications

Breaking Changes

  • Unicast Support Removed: All tools now use multicast UDP only
  • CLI Argument Changes: Network configuration arguments moved from subcommands to main command
  • C++ Applications: Must call voyant_log_init_c() for proper logging initialization

Migration from v0.2.0

  1. Remove subcommands: Change voyant_tool multicast [args] to voyant_tool [args]
  2. Update unicast usage: Switch from unicast to multicast configuration
  3. C++ applications: Add voyant_log_init_c() call during startup
  4. Logging control: Use RUST_LOG environment variable instead of print statements

Logging Configuration

Set the RUST_LOG environment variable to control logging verbosity:

  • RUST_LOG=trace - Most verbose (fine-grained debugging)
  • RUST_LOG=debug - Detailed diagnostic information
  • RUST_LOG=info - General informational messages (default)
  • RUST_LOG=warn - Warning messages only
  • RUST_LOG=error - Error messages only
  • RUST_LOG=off - Disable all logging

Packages

This release includes the same two Debian packages:

  • voyant-api: Core binaries, command-line utilities, and runtime libraries
  • voyant-api-dev: Header files and development libraries (depends on voyant-api)

ROS2 Integration

Official ROS drivers remain available at voyant-ros with continued support for ROS2 Humble (Ubuntu 22.04) and Docker support for Humble, Iron, Rolling, and Jazzy.

Documentation

For comprehensive documentation, examples, and installation instructions, visit our documentation site.

Feedback

We value your feedback! If you encounter issues or have suggestions for improvements, please see our troubleshooting guide for the best options for getting in touch with us.

Copyright © Voyant Photonics, Inc.