week 5 blog

Author: AshishRamesh

docs/_posts/12-07-25-Week 5.md

@@ -0,0 +1,139 @@
+---
+title: Week 5 - Mid Term Evaluation & Phase Two Begins! (July 07 ~ July 14)
+date: 2025-07-14
+categories: [Coding Period, Phase Two]
+tags: [robotics-academy, ros2, follow-line, vaccum-cleaner, coding-period, phase-two]
+---
+
+Hey everyone!  
+This week marked an important milestone as I wrapped up the **mid-term evaluation** and kicked off **Phase Two** of my GSoC project with **JdeRobot**. It was a packed week of work to get back on schedule after my exam break, and I’m excited to share the progress.
+
+---
+
+### Objectives for the Week
+
+- [x] ROS Native Solution for `follow_line` exercise
+- [x] Image output in the GUI
+- [ ] Fix logging in the VNC Console
+
+---
+
+### What I Worked On
+
+We began the week with the **Mid-term evaluation**. It was a valuable chance to reflect on the progress so far, review the work with my mentors, and set clear goals for the next phase. I’m happy to share that I passed with positive feedback, which has been very motivating.
+
+![GSoc Feedback from mentors](assets/lib/week_5_gsoc.png)  
+<sub><i>GSoc Feedback from mentors</i></sub>
+
+The first ticket I worked on was implementing a solution for the follow line exercise using ROS. With the progress made in the last few weeks, apart from some minor issues, the follow line exercise now supports ROS native implementation. The solution developed is fully written in ROS, except for the GUI which partially uses the GUI module to display images (this will be fixed soon).
+
+![Follow line exercise ROS Native implementation](assets/lib/week_5_fl.gif)  
+<sub><i>Follow line exercise ROS Native implementation</i></sub>
+
+---
+
+After working on the ROS native solution, I started work on the image output in the GUI as well as the logging for the VNC Console. These two issues have been hurdles towards completion of the ROS native implementation. I was able to get them working (somewhat), but this is due to race conditions resulting in poor performance. 
+Let me break it down.
+
+#### Image output in the GUI 
+I was able to get this working, but the output isn't as expected. To understand what the issue is, let me give a short summary on how this is being implemented. 
+
+Logic flow:
+
+Topic Check: `_setup_auto_mode_if_possible()` checks if `/webgui_image` topic exists
+
+If topic exists:
+1. Creates `CameraNode("/webgui_image")` to subscribe to it
+2. Sets `auto_image_mode = True`
+3. Starts `_unified_image_loop()` thread
+
+If topic doesn't exist:
+1. No camera node created
+2. `auto_image_mode = False`
+3. Only manual mode available
+
+This way if the topic exists , GUI automatically subscribes to it and starts showing the image published to it in the GUI, if the topic does not exist user can manually use the `showImage()` function to show an image on the GUI. This has been implemented and is working.
+
+Automatic image sub from topic `/cam_f1_left/camera_info` :
+
+![Automatic image sub from topic](assets/lib/week_5.png)  
+<sub><i>Automatic image sub from topic /cam_f1_left/camera_info</i></sub>
+
+Heres the debugging output from the GUI module:
+
+```shell
+Initializing GUI...
+['/cam_f1_left/camera_info', '/cam_f1_left/image_raw', '/cam_f1_left/image_raw/compressed', '/cam_f1_left/image_raw/compressedDepth', '/cam_f1_left/image_raw/theora', '/clock', '/cmd_vel', '/odom', '/parameter_events', '/performance_metrics', '/rosout', '/tf']
+GUI Mode: {'auto_mode': True, 'topic_subscribed': '/webgui_image', 'manual_mode_available': True}
+GUI initialized!
+```
+
+Now the issue is that:
+- The GUI module needs to be initialized within the user's code
+- A race condition exists which prevents the automatic functionality from working
+
+The Problem: Timing Race Condition
+
+- 1. GUI initializes first → checks for `/webgui_image` topic → doesn't exist yet
+- 2. Sets manual mode only
+- 3. Then user's code starts → creates `/webgui_image` topic
+- 4. Too late! GUI already decided it's manual mode
+
+#### Fix logging in the VNC Console
+The VNC logging also faces a similar race condition issue. The following environment variables need to be initialized in the .env file:
+
+```bash
+export RCUTILS_LOGGING_USE_STDOUT=1
+export RCUTILS_LOGGING_BUFFERED_STREAM=0
+export RCUTILS_CONSOLE_OUTPUT_FORMAT="[{severity}] [{name}]: {message}"
+```
+
+These need to be initialized before ROS is initialized. Unfortunately, with my current development setup, I haven't been able to achieve this.
+
+For both issues, I will be taking input from my mentors to see how we can fix this.
+
+---
+
+### Additional Progress
+
+In addition to the main tasks, I also worked on a few other areas.
+I started work on the vaccum cleaner exercise. Due to how the ros native implementation is being done , i was able to get the exercise working with minimal changes. This means that most if not all exercises will be able to support ROS native implementation with minimal changes. The only hurdle will be to adapt the GUI modules for the exercises to support ROS native implementation.
+
+![Vaccum Cleaner exercise ](assets/lib/week_5_vc.gif)  
+<sub><i>Vaccum Cleaner exercise </i></sub>
+
+
+I also started work on the documentation for the vaccum cleaner exercise. The documentation is being updated to include the ROS native implementation and how to use it similar to the follow line exercise documentation. I have raised a issue and a PR for the same. Although the documentation is not complete yet, as i need some inputs from my mentors on how to implement few things for the exercise.
+
+---
+
+
+### PRs & Issues Raised
+
+Here are the contributions made this week:
+
+**Issues**
+- [ROS 2 solution example](https://github.com/JdeRobot/RoboticsAcademy-solutions/issues/98) (This is a private repo)
+- [Vaccum cleaner exercise Docs (Ros Native)](https://github.com/JdeRobot/RoboticsAcademy/issues/3156)
+- [Fix logging in VNC Console](https://github.com/JdeRobot/RoboticsApplicationManager/issues/222)
+
+**Pull Requests**
+- [Follow line ros native implementation ( using show Image)](https://github.com/JdeRobot/RoboticsAcademy-solutions/pull/100) (This is a private repo)
+- [initial vaccum cleaner commit](https://github.com/JdeRobot/RoboticsAcademy/pull/3157)
+- [Update ros-native with humble-devel changes (Week 5 sync)](https://github.com/JdeRobot/RoboticsApplicationManager/pull/230)
+
+---
+
+### Key Learnings & Outcomes
+- Successfully implemented ROS native solution for the follow line exercise
+- Implemented & gained insights into handling image output in the GUI and logging in the VNC Console
+- Vaccum cleaner exercise ROS native implementation explored
+- Documentation for ROS native implementation (vaccum cleaner exercise) started
+
+---
+
+
+Thanks for reading! I’m excited about the progress made this week and looking forward to tackling the challenges ahead. If you have any questions or feedback, feel free to reach out!
+
+Until next week —  
+_Ashish_