gitwtfhub

wtf is jie_3d_nav?

6-robot/jie_3d_nav — explained in plain English

Analysis updated 2026-05-18

190PythonAudience · developerComplexity · 4/5Setup · hard

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

PythonROS 2

How it stacks up

6-robot/jie_3d_navnolangz/pixel2motionsoul-ailab/soulx-transcriber
Stars190193193
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdesignerresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

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

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.