dimos-lcm 0.1.0__tar.gz

dimos_lcm-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: dimos_lcm
+Version: 0.1.0
+Summary: LCM-Foxglove bridge and message utilities for Dimensional Robotics
+Author-email: Dimensional Team <build@dimensionalOS.com>
+Project-URL: Homepage, https://github.com/dimensionalOS/dimos-lcm
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: lcm
+Requires-Dist: foxglove-websocket
+Requires-Dist: numpy
+
+# LCM Message Definitions and ROS msg to LCM Converter
+
+This repository contains LCM message definitions and a tool to convert ROS messages to LCM messages.
+
+## Converting ROS Messages to LCM
+
+- The Python msg to lcm converter is used to convert the ROS messages to LCM messages.
+
+```py
+python3 ros_to_lcm.py ros_msgs lcm_files
+```
+
+- The lcm-gen command is used to generate the language bindings for the LCM message definitions.
+
+```sh
+./lcm_batch_processor.sh -p lcm_files -o python_lcm_msgs/lcm_msgs
+```
+
+- Then to make sure tha Python messages package is installable, run
+
+```sh
+cd python_lcm_msgs
+python3 fix_imports.py
+```
+
+- The Foxglove bridge converts all LCM messages to JSON and sends them via WebSocket to Foxglove for visualization.
+
+```py
+python3 lcm_foxglove_bridge.py
+```
+
+## Using LCM-Spy with Custom Message Types
+
+To use lcm-spy with your custom message types, you need to build a JAR file containing the Java bindings for your LCM message types.
+
+### Building the JAR File
+
+1. Make sure you have the Java LCM bindings generated in the `java_lcm_msgs` directory.
+2. Run the build script to create the JAR file:
+
+```sh
+./build_lcm_jar.sh
+```
+
+This will compile all Java message definitions and create `lcm_types.jar` in the project directory.
+
+### Running LCM-Spy
+
+Use the provided script to run lcm-spy with your custom JAR file:
+
+```sh
+./run_lcm_spy.sh
+```
+
+You can also pass additional arguments to lcm-spy:
+
+```sh
+# For a specific LCM URL
+./run_lcm_spy.sh --lcm-url=udpm://239.255.76.67:7667?ttl=1
+
+# For a specific interface
+./run_lcm_spy.sh --lcm-url=udpm://<multicast-address>:<port>
+```
+
+When running lcm-spy this way, all your custom message types will be automatically decoded and displayed in the lcm-spy interface.
+
+### Manual Execution
+
+If you prefer to run lcm-spy manually, use:
+
+```sh
+CLASSPATH=/path/to/lcm.jar:lcm_types.jar lcm-spy
+```
+
+Replace `/path/to/lcm.jar` with the actual path to the LCM Java library on your system.

dimos_lcm-0.1.0/README.md

@@ -0,0 +1,75 @@
+# LCM Message Definitions and ROS msg to LCM Converter
+
+This repository contains LCM message definitions and a tool to convert ROS messages to LCM messages.
+
+## Converting ROS Messages to LCM
+
+- The Python msg to lcm converter is used to convert the ROS messages to LCM messages.
+
+```py
+python3 ros_to_lcm.py ros_msgs lcm_files
+```
+
+- The lcm-gen command is used to generate the language bindings for the LCM message definitions.
+
+```sh
+./lcm_batch_processor.sh -p lcm_files -o python_lcm_msgs/lcm_msgs
+```
+
+- Then to make sure tha Python messages package is installable, run
+
+```sh
+cd python_lcm_msgs
+python3 fix_imports.py
+```
+
+- The Foxglove bridge converts all LCM messages to JSON and sends them via WebSocket to Foxglove for visualization.
+
+```py
+python3 lcm_foxglove_bridge.py
+```
+
+## Using LCM-Spy with Custom Message Types
+
+To use lcm-spy with your custom message types, you need to build a JAR file containing the Java bindings for your LCM message types.
+
+### Building the JAR File
+
+1. Make sure you have the Java LCM bindings generated in the `java_lcm_msgs` directory.
+2. Run the build script to create the JAR file:
+
+```sh
+./build_lcm_jar.sh
+```
+
+This will compile all Java message definitions and create `lcm_types.jar` in the project directory.
+
+### Running LCM-Spy
+
+Use the provided script to run lcm-spy with your custom JAR file:
+
+```sh
+./run_lcm_spy.sh
+```
+
+You can also pass additional arguments to lcm-spy:
+
+```sh
+# For a specific LCM URL
+./run_lcm_spy.sh --lcm-url=udpm://239.255.76.67:7667?ttl=1
+
+# For a specific interface
+./run_lcm_spy.sh --lcm-url=udpm://<multicast-address>:<port>
+```
+
+When running lcm-spy this way, all your custom message types will be automatically decoded and displayed in the lcm-spy interface.
+
+### Manual Execution
+
+If you prefer to run lcm-spy manually, use:
+
+```sh
+CLASSPATH=/path/to/lcm.jar:lcm_types.jar lcm-spy
+```
+
+Replace `/path/to/lcm.jar` with the actual path to the LCM Java library on your system.

dimos_lcm-0.1.0/__init__.py

@@ -0,0 +1,30 @@
+"""
+dimos-lcm - LCM messages for the dimensional operating system
+
+This package provides utility tools for dimensional robotics projects,
+including LCM-Foxglove bridge functionality and LCM message definitions.
+"""
+
+__version__ = "0.1.0"
+
+import os
+import sys
+
+
+# Setup lcm_msgs path for backwards compatibility with seperate python_lcm_msgs package
+def _setup_lcm_msgs_path():
+    """Setup lcm_msgs path so internal imports work correctly"""
+    try:
+        # Try to import lcm_msgs to see if it's already installed
+        import lcm_msgs
+    except ImportError:
+        # If import fails, add the local python_lcm_msgs to path
+        # ensures internal imports like "from lcm_msgs import std_msgs" work
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+        lcm_module_dir = os.path.join(current_dir, "python_lcm_msgs")
+        if os.path.exists(lcm_module_dir):
+            if lcm_module_dir not in sys.path:
+                sys.path.insert(0, lcm_module_dir)
+
+
+_setup_lcm_msgs_path()

dimos_lcm-0.1.0/build_lcm_jar.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+# Create build directory
+mkdir -p build/classes
+
+# Find LCM jar file
+LCM_JAR=$(find /usr/local/share/java -name "lcm*.jar" 2>/dev/null || find /opt/homebrew/share/java -name "lcm*.jar" 2>/dev/null || echo "")
+
+if [ -z "$LCM_JAR" ]; then
+    echo "Error: LCM jar file not found. Please make sure LCM is installed."
+    exit 1
+fi
+
+echo "Found LCM jar: $LCM_JAR"
+
+# Compile all Java files
+echo "Compiling Java files..."
+find java_lcm_msgs -name "*.java" | xargs javac -cp "$LCM_JAR" -d build/classes
+
+# Create JAR file
+echo "Creating JAR file..."
+jar cf lcm_types.jar -C build/classes .
+
+echo "Done! Created lcm_types.jar"
+echo "To use with lcm-spy, run: lcm-spy --lcm-url=YOURURL -cp $LCM_JAR:lcm_types.jar"

dimos_lcm-0.1.0/dimos_lcm.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: dimos_lcm
+Version: 0.1.0
+Summary: LCM-Foxglove bridge and message utilities for Dimensional Robotics
+Author-email: Dimensional Team <build@dimensionalOS.com>
+Project-URL: Homepage, https://github.com/dimensionalOS/dimos-lcm
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: lcm
+Requires-Dist: foxglove-websocket
+Requires-Dist: numpy
+
+# LCM Message Definitions and ROS msg to LCM Converter
+
+This repository contains LCM message definitions and a tool to convert ROS messages to LCM messages.
+
+## Converting ROS Messages to LCM
+
+- The Python msg to lcm converter is used to convert the ROS messages to LCM messages.
+
+```py
+python3 ros_to_lcm.py ros_msgs lcm_files
+```
+
+- The lcm-gen command is used to generate the language bindings for the LCM message definitions.
+
+```sh
+./lcm_batch_processor.sh -p lcm_files -o python_lcm_msgs/lcm_msgs
+```
+
+- Then to make sure tha Python messages package is installable, run
+
+```sh
+cd python_lcm_msgs
+python3 fix_imports.py
+```
+
+- The Foxglove bridge converts all LCM messages to JSON and sends them via WebSocket to Foxglove for visualization.
+
+```py
+python3 lcm_foxglove_bridge.py
+```
+
+## Using LCM-Spy with Custom Message Types
+
+To use lcm-spy with your custom message types, you need to build a JAR file containing the Java bindings for your LCM message types.
+
+### Building the JAR File
+
+1. Make sure you have the Java LCM bindings generated in the `java_lcm_msgs` directory.
+2. Run the build script to create the JAR file:
+
+```sh
+./build_lcm_jar.sh
+```
+
+This will compile all Java message definitions and create `lcm_types.jar` in the project directory.
+
+### Running LCM-Spy
+
+Use the provided script to run lcm-spy with your custom JAR file:
+
+```sh
+./run_lcm_spy.sh
+```
+
+You can also pass additional arguments to lcm-spy:
+
+```sh
+# For a specific LCM URL
+./run_lcm_spy.sh --lcm-url=udpm://239.255.76.67:7667?ttl=1
+
+# For a specific interface
+./run_lcm_spy.sh --lcm-url=udpm://<multicast-address>:<port>
+```
+
+When running lcm-spy this way, all your custom message types will be automatically decoded and displayed in the lcm-spy interface.
+
+### Manual Execution
+
+If you prefer to run lcm-spy manually, use:
+
+```sh
+CLASSPATH=/path/to/lcm.jar:lcm_types.jar lcm-spy
+```
+
+Replace `/path/to/lcm.jar` with the actual path to the LCM Java library on your system.