maliput_integration

Description

This package contains integration examples and tools that unify maliput core and its possible backends.

Note: For full information about Maliput please visit Maliput Documentation.

API Documentation

Refer to Maliput Integration’s Online API Documentation.

Applications

The integration examples are framed into applications, they can be found at maliput_integration/applications.

Tutorials are provided to better understand how to get started with the examples. Seemaliput_integration’s tutorials.

Installation

Supported platforms

Ubuntu Focal Fossa 20.04 LTS.

Binary Installation on Ubuntu

See Installation Docs.

Source Installation on Ubuntu

Prerequisites

sudo apt install python3-rosdep python3-colcon-common-extensions

Build

1. Create colcon workspace if you don’t have one yet.

    mkdir colcon_ws/src -p
    

1. Clone this repository in the src folder

    cd colcon_ws/src
    git clone https://github.com/maliput/maliput_integration.git
    

1. Install package dependencies via rosdep

    export ROS_DISTRO=foxy
    

    rosdep update
    rosdep install -i -y --rosdistro $ROS_DISTRO --from-paths src
    

1. Build the package

    colcon build --packages-up-to maliput_integration
    

**Note**: To build documentation a `-BUILD_DOCS` cmake flag is required:

    colcon build --packages-select maliput_integration --cmake-args " -DBUILD_DOCS=On"
    

More info at [Building Documentation](https://maliput.readthedocs.io/en/latest/developer_guidelines.html#building-the-documentation).

For further info refer to Source Installation on Ubuntu

For development

It is recommended to follow the guidelines for setting up a development workspace as described here.

Contributing

Please see CONTRIBUTING page.

License

Changelog for package maliput_integration

0.1.6 (2023-04-13)

• Adds more options to the obj creator app. (#132)
• Relies on maliput_multilane's RN builder. (#131)
• Contributors: Franco Cipollone

0.1.5 (2023-02-15)

• Adds GetConfluentBranches and GetOngoingBranches query support. (#130)
• Adds queries to get parameter list from backends. (#129)
• Contributors: Franco Cipollone

0.1.4 (2022-12-13)

• Adds missing dependency to maliput_sparse (#127)
• Adds maliput_osm backend to the applications. (#124)
• Updates triage workflow. (#125)
• Contributors: Franco Cipollone

0.1.3 (2022-09-15)

• Adds Lane::ToSegmentPosition query. (#123)
• Contributors: Franco Cipollone

0.1.2 (2022-08-16)

• Matches with BoundingRegion moving to maliput. (#122)
• Contributors: Franco Cipollone

0.1.1 (2022-07-29)

• Matches change in create_road_network binding. (#120)
• Adds triage workflow. (#121)
• Improves README. (#119)
• Contributors: Franco Cipollone

0.1.0 (2022-06-21)

• Updates package.xml file.
• Several changes for ros build farm compatibility (#118)
• Uses compile definitions for the tests. (#117)
• Updates license. (#116)
• Removes dashing support. (#115)
• Apps: Allows relative path to resource env var. (#114)
• Extends maliput_query app with maliput_object related queries (#112)
• Adds the RoadGeometry pointer when constructing IntersectionBooks. (#111)
• Modified library dependancies from utilities to utility (#110)
• Merge pull request #109 from ToyotaResearchInstitute/voldivh/value_range_method_to_state Changed values() and ranges() method from Rules to states()
• [FEAT]: Changed values() and ranges() method from Rules to states()
• Adds example using dynamic rules (#107)
• Adds BUILD_DOCS flag as opt-in flag (#108)
• Matches with change in maliput's phase ring book loader. (#106)
• Adds gflag for loading a RuleRegistry yaml file. (#104)
• Adds workflow_dispatch to other workflows. (#103)
• Adds CI badges (#102)
• Replaces push by workflow_dispatch event in gcc build. (#100)
• Includes malidrive's new parameter: max_linear_tolerance (#99)
• Use maliput_drake instead of drake_vendor (#98)
• maliput_measure_load_time: Adds tutorial. (#97)
• Adds info about other maliput_to_string implemenatation apps. (#95)
• maliput_derive_lane_s_route: Improve app + tutorial (#94)
• Pairs with multilane::RoadGeometry going private. (#96)
• Extends maliput_to_obj app to also generate urdf file. (#93)
• Pairs with maliput_malidrive's load deprecation method. (#91)
• Adds maliput_to_obj tutorial. (#90)
• maliput_query: GetNumberOfLanes command. (#89)
• maliput_query: Adds elapsed time information. (#88)
• Updates maliput_query use using double dashes. (#87)
• Adds maliput query tutorial (#85)
• Adds maliput_to_string tutorial. (#84)
• Enable doxygen check. (#83)
• Removes references to InertialTolaneMappingConfig. (#82)
• maliput_to_string app: Adds check_invariants flag. (#81)
• Fixes maliput_to_string_with_plugin app. (#80)
• Adds GetLaneLength command to maliput_query app. (#79)
• maliput_query: Use the xodr file from gflag. (#77)
• Set up linker properly when using clang in CI. (#76)
• Enable foxy CI (#74)
• Prepare for foxy (#73)
• Info log road network loading status in apps. (#75)
• Fix include style part 1: use <> maliput_* includes (#72)
• Use newer revision of pybind11 (#71)
• rosdep update --include-eol-distros (#70)
• Require OpenDRIVE file in RoadGeometryConfiguration (#69)
• Pairs app with new flag in the malidrive::RoadGeometryConfiguration. (#68)
• CI: Removes prereqs install for drake. (#67)
• Upgrade ros-tooling to v0.2.1 (#66)
• Uses maliput_documentation instead of maliput-documentation. (#65)
• Use maliput_multilane instead of maliput-multilane. (#64)
• Use maliput_dragway instead of maliput-dragway. (#63)
• Updates standard_strictness_policy gflag. (#62)
• Apps: Improve configuration options when loading a malidrive backend. (#61)
• Switch ament_cmake_doxygen to main branch. (#60)
• Optimizes scan-build run in CI. (#59)
• Add changelog template (#56)
• Replaces occurrences of dsim-repos-index by maliput_infrastructure. (#58)
• Imports maliput_py to github actions. (#57)
• Points to maliput_infrastructure instead of dsim-repos-index (#55)
• Trigger PR clang builds on do-clang-test label (#54)
• Restores scan-build workflow on label (#53)
• Pairs with the change in RoadGeometry API (#52)
• Moves disabled workflows to a different folder. (#51)
• Adds app for measuring load time process (#50)
• Allows the apps to select build policy for malidrive backend. (#49)
• Refer to a specific clang version and use lld linker. (#48)
• Update ros-tooling version in CI. (#47)
• Fixes ubsan behavior in CI. (#46)
• Removes Jenkins configuration. (#45)
• Uses ament_cmake_flake8 package instead of pycodestyle. (#44)
• Adds applications in cpp and python that uses the maliput plugin architecture (#39)
• Improve application namespace consistency (#42)
• Replaces GeoPosition by InertialPosition (#38)
• Fixes clang Github CI workflow configuration. (#40)
• Adds maliput_malidrive dependency to CI and try to check out same branches (#36)
• Removes reference to maliput_malidrive/base/road_geometry.h because it is not installed anymore. (#34)
• Adds maliput_derive_lane_s_route_app. (#33)
• Unifies cmake install paths. (#32)
• Adds maliput_query app. (#30)
• Adds malidrive repository to scan_build workflow. (#31)
• Adds maliput_malidrive backend implementation to the apps. (#27)
• Adds scan_build job to Github Actions. (#26)
• Disables tsan because not all backends support that build configuration. (#29)
• Sets ACTIONS_ALLOW_UNSECURE_COMMANDS to true (#28)
• Adds clang8, asan, ubsan and tsan to Github Actions. (#25)
• Adds a template changelog. (#23)
• Updates package.xml (#22)
• Adds version number.
• Adds a template changelog.
• Fixes sanitizers variable. (#20)
• Use GitHub Actions CI to build and test with gcc (#19)
• Adds scan-build to jenkins configuration. (#18)
• Parallelizes CI.
• Adds Undefined Behavior Sanitizer.
• Adds Address Sanitizer.
• Adds application to serialize dragway and multilane. (#5)
• Generates URDF files for multilane and dragway implementation (#4) (#13)
• Pairs clang flags. (#12)
• Generates OBJ file either from multilane or dragway implementation. (#3)
• Changes namespace from utility to integration in yaml_to_obj.cc file. (#2)
• Modifies DefaultCFlags. (#9)
• Adapts files to multilane package's reorganization.
• Adapts files to dragway's reorganization. (#7)
• Merge pull request #1 from ToyotaResearchInstitute/francocipollone/move_maliput_integration_to_a_repo Brings maliput-integration package from maliput repository.
• Changes package from maliput-integration to maliput_integration
• Adds license to the package.xml file.
• Adds missing files to the repository. Minor fixes.
• Move maliput-utilities to maliput core (#274)
• Move dragway_to_urdf to maliput-integration (#305)
• Move yaml_to_obj to maliput-integration, remove multilane dependency (#304)
• Adds maliput-integration package. (#299)
• Initial commit
• Contributors: Agustin Alba Chicar, Chien-Liang Fok, Daniel Stonier, Franco, Franco Cipollone, Geoffrey Biggs, Steve Peters, Steven Peters, Voldivh