explaingit

6-robot/jie_3d_nav

Analysis updated 2026-05-18

190PythonAudience · developerComplexity · 4/5Setup · hard

TLDR

A ROS 2 based 3D navigation system for robots that turns scanned or simulated maps into a 3D OctoMap and lets you plan paths through a web browser.

Mindmap

mindmap
  root((jie_3d_nav))
    What it does
      3D robot navigation
      ROS 2 Humble
      Web browser control
    Map input
      Point cloud scan
      2D grid map
      Simulation
    Features
      OctoMap conversion
      Browser path planning
      Desktop GUI editing
      Hazard zone marking
    Tested on
      Real robot dog platform
    Audience
      Robotics developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a point cloud or 2D grid map into a 3D OctoMap for robot path planning

USE CASE 2

Click a start and destination point in a web browser to compute a navigable 3D path

USE CASE 3

Manually edit map cells and mark hazardous zones using the desktop GUI

USE CASE 4

Control and monitor a real robot's navigation from a browser without extra hardware

What is it built with?

PythonROS 2

How does it compare?

6-robot/jie_3d_navnolangz/pixel2motioncvlab-kaist/gld
Stars190193196
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity4/53/55/5
Audiencedeveloperdesignerresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires ROS 2 Humble and a robot platform with a spatial positioning module for real-world use.

In plain English

jie_3d_nav is a 3D navigation system for robots built on ROS 2 Humble, controlled through a web browser interface. ROS 2 (Robot Operating System 2) is an open-source framework used to program robots. This project lets you take a map of a physical environment, whether it was scanned as a point cloud, loaded from a 2D grid map, or generated from a simulation, and convert it into a 3D occupancy map called an OctoMap. An OctoMap divides space into a 3D grid of cells, each marked as occupied, free, or unknown, allowing a robot to understand what areas it can and cannot travel through. Once the map is loaded, you can open a web page in any browser, click a starting point and a destination on the 3D map, and the system will calculate a navigable path. You can also view and manually edit the map cells using a desktop GUI, mark hazardous or blocked zones, and manage saved map files. The system has been tested on a real robot dog platform with a spatial positioning module. You would use this project if you are building or experimenting with an autonomous robot that needs to navigate three-dimensional environments, such as a robot that must move through a multi-story building or uneven terrain, and you want to control and monitor it from a web browser without specialized hardware.

Copy-paste prompts

Prompt 1
Explain how jie_3d_nav converts a point cloud into an OctoMap for robot navigation.
Prompt 2
Help me set up the web interface to click a start and end point for path planning.
Prompt 3
Show me how to mark a hazardous zone on the map using the desktop GUI in this project.
Prompt 4
Walk me through connecting jie_3d_nav to a robot running ROS 2 Humble.

Frequently asked questions

What is jie_3d_nav?

A ROS 2 based 3D navigation system for robots that turns scanned or simulated maps into a 3D OctoMap and lets you plan paths through a web browser.

What language is jie_3d_nav written in?

Mainly Python. The stack also includes Python, ROS 2.

How hard is jie_3d_nav to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is jie_3d_nav for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.