Skip to main content

High-resolution map visualization and conversion tool, opendrive hdmap convert to appollo base map!

Project description

imap_box_up

Documentation Status

imap_box_up is a tool for visualize and convert format of the hd-map. This project was inspired by Apollo, modified by imap, the imap tool is very useful.

The name of imap_box_up , Just to modified from imap_box and just to distinguish it from imap_box

imap_box_up source code: https://github.com/porterpan/imap_box_up

Note:

  • the map road lane attribution should have one of curb、shoulder. if not have curb, task will random selection shouler , stop, walking to create apoolo map.

  • The project is Modify on project of https://github.com/daohu527/imap

I found that imap_box had the problem of inaccurate junction drawing, which could not meet the needs of my project. Therefore, I modified imap_box based on it to adapt to my appollo hdmap code for perception work.

new1(junction apollo map 显示使用 curbe or shoulder道路属性进行显示,可以实现弧形的显示,而不是原先的box显示junction hd map)

该功能使用默认参数将生成沿着curb或者shoulder绘制的路口地图

valid junction

如果你要使用原先的box形状显示路口,可以使用参数 -b 即可生成box形状的路口。

new 2 (添加新的参数-r 以转换为不带有地理坐标的地图数据)

地图绘制说明

绘制路口时,确保路口存在curb或者shoulder元素,因为默认非box的junction路口apollo hdmap 需要有这两种元素中的一种或者两种才能正常生成,否则转换后的apollo hdmap 将丢失junction 元素。检查是否有curb属性如下图

roadrunner 绘制地图注意

Quick start

Install

You can install imap by following cmd.

pip3 install imap_box_up

Example

1. Visualization

After the installation is complete, you can view the map with the following command.

imap_box_up -m data/borregas_ave.txt
// or
imap_box_up -m data/town.xodr

Currently supported formats:

  • Apollo map
  • OpenDrive map

2. Find lane by id

You can use below command to find lane by id, Found lane is shown in Red.

imap_box_up -m data/borregas_ave.txt -l lane_35

3. Format conversion

Now you can convert OpenDrive map to Apollo map by following command.

  • save as utm world coordinates(world map for old feature)
imap_box_up -f -i data/town.xodr -o data/apollo_map.txt
  • save as inertial system coordinates (relative map for new feature)
imap_box_up -f -r -i data/town.xodr -o data/apollo_map.txt

4. junction display Format

junction display with road shape

imap_box_up -f -r -i data/town.xodr -o data/apollo_map.txt

junction detail

junction display with box shape

imap_box_up -f -r -b -i data/town.xodr -o data/apollo_map.txt

junction error

The following is the display of the hd-map in data\borregas_ave.txt.You can click on the lane you want to display more detail info, which will display the current lane's id, as well as the predecessor and successor lane's id in the upper left corner.

imap_box_up convert map load to rviz display

Questions

  1. After running the command imap_box_up -m data/your_map_file, nothing display and no errors!!!

A: Check the permissions of the map file, if the current user does not have permissions, modify the permissions with the following commands.

sudo chmod 777 data/your_map_file
  1. Map data permission checking has no problem, still nothing display and no errors! A: It's better to install imap_box by running "sudo pip3 install imap_box", then run "imap -m xxx.txt".

If you have any questions, please feel free to contact me.

Supported features:

  1. Visualize the hd-map, supported formats: Apollo, OpenDrive.
  2. Find lane by id
  3. Convert format: Opendrive to Apollo format.
os support remark
ubuntu :heavy_check_mark:
mac :heavy_check_mark:
windows :heavy_check_mark:

Related work

  • odrviewer.io is an excellent interactive online OpenDRIVE viewer.
  • esmini is a basic OpenSCENARIO player.
  • apollo_map convert carla map to apollo

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imap_box_up-0.0.6.tar.gz (34.2 kB view details)

Uploaded Source

Built Distribution

imap_box_up-0.0.6-py3-none-any.whl (45.4 kB view details)

Uploaded Python 3

File details

Details for the file imap_box_up-0.0.6.tar.gz.

File metadata

  • Download URL: imap_box_up-0.0.6.tar.gz
  • Upload date:
  • Size: 34.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for imap_box_up-0.0.6.tar.gz
Algorithm Hash digest
SHA256 29785697900e908611a43da47dd8ab485f6376a921e26653de0c650ea219b74c
MD5 4020978750440b7c5705aa0eebd32aa8
BLAKE2b-256 49020087cf46d68b3386cefb38484b21893cf057b3e9d4632c7385ec6968dcc6

See more details on using hashes here.

File details

Details for the file imap_box_up-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: imap_box_up-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 45.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for imap_box_up-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 e33e8dfb576e86b7c1ee146af1910a5807e3665401bc29b131a23313edf35b8d
MD5 4cac5032d694a9387e1a2e9c8f4f3e42
BLAKE2b-256 74d68369d64020fe62f22acfbdfa61d54ff120ca9433c75f407905e98868b9fa

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page