From 3ace65dc06ad01cccbf2f747d1ce25ba9989752b Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:16:58 +0900 Subject: [PATCH 01/13] import from autoware_common Signed-off-by: Yutaka Kondo --- lanelet2_extension/CMakeLists.txt | 102 + .../docs/crosswalk_regulatory_element.svg | 161 ++ .../docs/crosswalk_traffic_light.svg | 121 ++ lanelet2_extension/docs/detection_area.png | Bin 0 -> 37318 bytes .../docs/extra_lanelet_subtypes.md | 45 + .../docs/extra_regulatory_elements.md | 149 ++ .../docs/lanelet2_format_extension.md | 481 +++++ lanelet2_extension/docs/light_bulbs.png | Bin 0 -> 92100 bytes .../docs/localization_landmark.drawio.svg | 156 ++ lanelet2_extension/docs/pedestrian_lane.svg | 90 + .../docs/right_of_way.drawio.svg | 384 ++++ lanelet2_extension/docs/road_mark.png | Bin 0 -> 22300 bytes lanelet2_extension/docs/road_shoulder.svg | 81 + lanelet2_extension/docs/speed_bump.png | Bin 0 -> 26135 bytes lanelet2_extension/docs/traffic_light.png | Bin 0 -> 111053 bytes .../docs/traffic_light_regulatory_element.png | Bin 0 -> 116862 bytes lanelet2_extension/docs/turn_direction.png | Bin 0 -> 67105 bytes .../io/autoware_osm_parser.hpp | 63 + .../localization/landmark.hpp | 38 + .../projection/mgrs_projector.hpp | 116 ++ .../transverse_mercator_projector.hpp | 61 + .../regulatory_elements/Forward.hpp | 54 + .../autoware_traffic_light.hpp | 91 + .../regulatory_elements/crosswalk.hpp | 92 + .../regulatory_elements/detection_area.hpp | 96 + .../regulatory_elements/no_parking_area.hpp | 72 + .../regulatory_elements/no_stopping_area.hpp | 94 + .../regulatory_elements/road_marking.hpp | 72 + .../regulatory_elements/speed_bump.hpp | 74 + .../virtual_traffic_light.hpp | 79 + .../utility/message_conversion.hpp | 98 + .../lanelet2_extension/utility/query.hpp | 301 +++ .../utility/route_checker.hpp | 33 + .../lanelet2_extension/utility/utilities.hpp | 99 + .../visualization/visualization.hpp | 371 ++++ .../lib/autoware_osm_parser.cpp | 80 + .../lib/autoware_traffic_light.cpp | 149 ++ lanelet2_extension/lib/crosswalk.cpp | 132 ++ lanelet2_extension/lib/detection_area.cpp | 162 ++ lanelet2_extension/lib/landmark.cpp | 50 + lanelet2_extension/lib/message_conversion.cpp | 194 ++ lanelet2_extension/lib/mgrs_projector.cpp | 135 ++ lanelet2_extension/lib/no_parking_area.cpp | 134 ++ lanelet2_extension/lib/no_stopping_area.cpp | 162 ++ lanelet2_extension/lib/query.cpp | 1125 +++++++++++ lanelet2_extension/lib/road_marking.cpp | 82 + lanelet2_extension/lib/route_checker.cpp | 49 + lanelet2_extension/lib/speed_bump.cpp | 122 ++ .../lib/transverse_mercator_projector.cpp | 64 + lanelet2_extension/lib/utilities.cpp | 795 ++++++++ .../lib/virtual_traffic_light.cpp | 67 + lanelet2_extension/lib/visualization.cpp | 1647 +++++++++++++++++ lanelet2_extension/package.xml | 42 + lanelet2_extension/src/check_right_of_way.cpp | 97 + lanelet2_extension/src/sample_code.cpp | 125 ++ lanelet2_extension/src/validation.cpp | 179 ++ .../test/src/test_message_conversion.cpp | 175 ++ .../test/src/test_projector.cpp | 159 ++ lanelet2_extension/test/src/test_query.cpp | 149 ++ .../test/src/test_regulatory_elements.cpp | 145 ++ .../test/src/test_route_checker.cpp | 100 + .../test/src/test_utilities.cpp | 167 ++ lanelet2_extension_python/CMakeLists.txt | 31 + lanelet2_extension_python/example/example.py | 195 ++ .../lanelet2_extension_python/__init__.py | 0 .../impl/__init__.py | 0 .../projection/__init__.py | 3 + .../regulatory_elements/__init__.py | 10 + .../utility/__init__.py | 1 + .../utility/query.py | 95 + .../utility/utilities.py | 75 + lanelet2_extension_python/package.xml | 31 + lanelet2_extension_python/src/projection.cpp | 42 + .../src/regulatory_elements.cpp | 307 +++ lanelet2_extension_python/src/utility.cpp | 564 ++++++ 75 files changed, 11515 insertions(+) create mode 100644 lanelet2_extension/CMakeLists.txt create mode 100644 lanelet2_extension/docs/crosswalk_regulatory_element.svg create mode 100644 lanelet2_extension/docs/crosswalk_traffic_light.svg create mode 100644 lanelet2_extension/docs/detection_area.png create mode 100644 lanelet2_extension/docs/extra_lanelet_subtypes.md create mode 100644 lanelet2_extension/docs/extra_regulatory_elements.md create mode 100644 lanelet2_extension/docs/lanelet2_format_extension.md create mode 100644 lanelet2_extension/docs/light_bulbs.png create mode 100644 lanelet2_extension/docs/localization_landmark.drawio.svg create mode 100644 lanelet2_extension/docs/pedestrian_lane.svg create mode 100644 lanelet2_extension/docs/right_of_way.drawio.svg create mode 100644 lanelet2_extension/docs/road_mark.png create mode 100644 lanelet2_extension/docs/road_shoulder.svg create mode 100644 lanelet2_extension/docs/speed_bump.png create mode 100644 lanelet2_extension/docs/traffic_light.png create mode 100644 lanelet2_extension/docs/traffic_light_regulatory_element.png create mode 100644 lanelet2_extension/docs/turn_direction.png create mode 100644 lanelet2_extension/include/lanelet2_extension/io/autoware_osm_parser.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/localization/landmark.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/projection/mgrs_projector.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/projection/transverse_mercator_projector.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/Forward.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/crosswalk.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/detection_area.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_parking_area.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_stopping_area.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/road_marking.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/speed_bump.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/regulatory_elements/virtual_traffic_light.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/utility/message_conversion.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/utility/query.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/utility/route_checker.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/utility/utilities.hpp create mode 100644 lanelet2_extension/include/lanelet2_extension/visualization/visualization.hpp create mode 100644 lanelet2_extension/lib/autoware_osm_parser.cpp create mode 100644 lanelet2_extension/lib/autoware_traffic_light.cpp create mode 100644 lanelet2_extension/lib/crosswalk.cpp create mode 100644 lanelet2_extension/lib/detection_area.cpp create mode 100644 lanelet2_extension/lib/landmark.cpp create mode 100644 lanelet2_extension/lib/message_conversion.cpp create mode 100644 lanelet2_extension/lib/mgrs_projector.cpp create mode 100644 lanelet2_extension/lib/no_parking_area.cpp create mode 100644 lanelet2_extension/lib/no_stopping_area.cpp create mode 100644 lanelet2_extension/lib/query.cpp create mode 100644 lanelet2_extension/lib/road_marking.cpp create mode 100644 lanelet2_extension/lib/route_checker.cpp create mode 100644 lanelet2_extension/lib/speed_bump.cpp create mode 100644 lanelet2_extension/lib/transverse_mercator_projector.cpp create mode 100644 lanelet2_extension/lib/utilities.cpp create mode 100644 lanelet2_extension/lib/virtual_traffic_light.cpp create mode 100644 lanelet2_extension/lib/visualization.cpp create mode 100644 lanelet2_extension/package.xml create mode 100644 lanelet2_extension/src/check_right_of_way.cpp create mode 100644 lanelet2_extension/src/sample_code.cpp create mode 100644 lanelet2_extension/src/validation.cpp create mode 100644 lanelet2_extension/test/src/test_message_conversion.cpp create mode 100644 lanelet2_extension/test/src/test_projector.cpp create mode 100644 lanelet2_extension/test/src/test_query.cpp create mode 100644 lanelet2_extension/test/src/test_regulatory_elements.cpp create mode 100644 lanelet2_extension/test/src/test_route_checker.cpp create mode 100644 lanelet2_extension/test/src/test_utilities.cpp create mode 100644 lanelet2_extension_python/CMakeLists.txt create mode 100644 lanelet2_extension_python/example/example.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/__init__.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/impl/__init__.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/projection/__init__.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/regulatory_elements/__init__.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/utility/__init__.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/utility/query.py create mode 100644 lanelet2_extension_python/lanelet2_extension_python/utility/utilities.py create mode 100644 lanelet2_extension_python/package.xml create mode 100644 lanelet2_extension_python/src/projection.cpp create mode 100644 lanelet2_extension_python/src/regulatory_elements.cpp create mode 100644 lanelet2_extension_python/src/utility.cpp diff --git a/lanelet2_extension/CMakeLists.txt b/lanelet2_extension/CMakeLists.txt new file mode 100644 index 0000000..f67e2bf --- /dev/null +++ b/lanelet2_extension/CMakeLists.txt @@ -0,0 +1,102 @@ +cmake_minimum_required(VERSION 3.14) +project(lanelet2_extension) + +find_package(autoware_cmake REQUIRED) +autoware_package() + +find_package(PkgConfig) +find_path(GeographicLib_INCLUDE_DIR GeographicLib/Config.h + PATH_SUFFIXES GeographicLib +) +set(GeographicLib_INCLUDE_DIRS ${GeographicLib_INCLUDE_DIR}) + +find_library(GeographicLib_LIBRARIES + NAMES Geographic +) + +find_library(PUGIXML_LIBRARIES + NAMES pugixml +) + +find_path(PUGIXML_INCLUDE_DIRS + NAMES pugixml.hpp + PATH_SUFFIXES pugixml +) + +include_directories( + ${GeographicLib_INCLUDE_DIRS} + ${PUGIXML_INCLUDE_DIRS} +) + +add_definitions(${GeographicLib_DEFINITIONS}) + +ament_auto_add_library(lanelet2_extension_lib SHARED + lib/autoware_osm_parser.cpp + lib/autoware_traffic_light.cpp + lib/crosswalk.cpp + lib/detection_area.cpp + lib/landmark.cpp + lib/no_parking_area.cpp + lib/no_stopping_area.cpp + lib/message_conversion.cpp + lib/mgrs_projector.cpp + lib/query.cpp + lib/road_marking.cpp + lib/speed_bump.cpp + lib/transverse_mercator_projector.cpp + lib/utilities.cpp + lib/virtual_traffic_light.cpp + lib/visualization.cpp + lib/route_checker.cpp +) +target_link_libraries(lanelet2_extension_lib + ${GeographicLib_LIBRARIES} +) +get_target_property(lanelet2_core_INCLUDE_DIRECTORIES lanelet2_core::lanelet2_core INTERFACE_INCLUDE_DIRECTORIES) +target_include_directories(lanelet2_extension_lib + SYSTEM PRIVATE + ${lanelet2_core_INCLUDE_DIRECTORIES} +) + +ament_auto_add_executable(lanelet2_extension_sample src/sample_code.cpp) +add_dependencies(lanelet2_extension_sample lanelet2_extension_lib) +target_link_libraries(lanelet2_extension_sample + lanelet2_extension_lib +) + +ament_auto_add_executable(autoware_lanelet2_validation src/validation.cpp) +add_dependencies(autoware_lanelet2_validation lanelet2_extension_lib) +target_link_libraries(autoware_lanelet2_validation + ${catkin_LIBRARIES} + ${PUGIXML_LIBRARIES} + lanelet2_extension_lib +) + +ament_auto_add_executable(check_right_of_way src/check_right_of_way.cpp) +add_dependencies(check_right_of_way lanelet2_extension_lib) +target_link_libraries(check_right_of_way + ${catkin_LIBRARIES} + ${PUGIXML_LIBRARIES} + lanelet2_extension_lib +) + +if(BUILD_TESTING) + ament_add_ros_isolated_gtest(message_conversion-test test/src/test_message_conversion.cpp) + target_link_libraries(message_conversion-test lanelet2_extension_lib) + ament_add_ros_isolated_gtest(projector-test test/src/test_projector.cpp) + target_link_libraries(projector-test lanelet2_extension_lib) + ament_add_ros_isolated_gtest(query-test test/src/test_query.cpp) + target_link_libraries(query-test lanelet2_extension_lib) + ament_add_ros_isolated_gtest(regulatory_elements-test test/src/test_regulatory_elements.cpp) + target_link_libraries(regulatory_elements-test lanelet2_extension_lib) + ament_add_ros_isolated_gtest(utilities-test test/src/test_utilities.cpp) + target_link_libraries(utilities-test lanelet2_extension_lib) + target_include_directories(utilities-test + SYSTEM PRIVATE + ${lanelet2_core_INCLUDE_DIRECTORIES} + ) + ament_add_ros_isolated_gtest(route-test test/src/test_route_checker.cpp) + target_link_libraries(route-test lanelet2_extension_lib) +endif() + +ament_auto_package() diff --git a/lanelet2_extension/docs/crosswalk_regulatory_element.svg b/lanelet2_extension/docs/crosswalk_regulatory_element.svg new file mode 100644 index 0000000..794bff2 --- /dev/null +++ b/lanelet2_extension/docs/crosswalk_regulatory_element.svg @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + + + + + + + + +
+
+
+ Type:lanelet +
+ SubType:road +
+
+
+ + Type:lanelet... + + + + + + +
+
+
+ Type:regulatory_element +
+ SubType: + crosswalk + +
+ +
+
+
+ + Type:regulatory_element... + + + + + + + + + + + + +
+
+
+ Polygon +
+ crosswalk_polygon +
+
+
+ + Polygon... + + + + + + +
+
+
+ Linestring3d +
+ ref_line +
+
+
+ + Linestring3d... + + + + + + + + + + +
+
+
+ Lanelet +
+ refers +
+
+
+ + Lanelet... + + + + + + +
+
+
+ Linestring3d +
+ ref_line +
+
+
+ + Linestring3d... + + + + + + + Text is not SVG - cannot display + + + diff --git a/lanelet2_extension/docs/crosswalk_traffic_light.svg b/lanelet2_extension/docs/crosswalk_traffic_light.svg new file mode 100644 index 0000000..1c3dfd2 --- /dev/null +++ b/lanelet2_extension/docs/crosswalk_traffic_light.svg @@ -0,0 +1,121 @@ + + + + + + + + + + + + + + + + + + + + +
+
+
+ Type:lanelet +
+ SubType:crosswalk +
+
+
+ + Type:lanelet... + + + + + + +
+
+
+ Type:regulatory_element +
+ SubType:traffic_light + +
+ +
+
+
+ + Type:regulatory_element... + + + + + + + + + + + + + + +
+
+
+ Linestring +
+ Type:traffic_light +
+
+
+ + Linestring... + + + + + + +
+
+
+ Linestring +
+ Type:traffic_light +
+
+
+ + Linestring... + + + + + + + + + + + Text is not SVG - cannot display + + + diff --git a/lanelet2_extension/docs/detection_area.png b/lanelet2_extension/docs/detection_area.png new file mode 100644 index 0000000000000000000000000000000000000000..0ae10872cb01f95427814425bf1c734ad6ca591d GIT binary patch literal 37318 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 Pi-4t>tts___q~4s?gfBE literal 0 HcmV?d00001 diff --git a/lanelet2_extension/docs/extra_lanelet_subtypes.md b/lanelet2_extension/docs/extra_lanelet_subtypes.md new file mode 100644 index 0000000..b7b84eb --- /dev/null +++ b/lanelet2_extension/docs/extra_lanelet_subtypes.md @@ -0,0 +1,45 @@ +# Extra Lanelet Subtypes + +## Roadside Lane + +The subtypes for this lanelet classify the outer lanes adjacent to the driving lane.Since the list of lanelet subtypes defined in this [link](https://github.com/fzi-forschungszentrum-informatik/Lanelet2/blob/master/lanelet2_core/doc/LaneletAndAreaTagging.md) cannot represent the shoulder lane and pedestrian lane described below, two new subtypes are defined.When parking on the street, it is necessary to distinguish between a shoulder lane which can be used by vehicles, and a pedestrian lane which can be used by pedestrians and bicycles.If you park in a shoulder lane, you can use the entire lane for temporary parking, but if you park in a pedestrian lane, you must leave a space of at least 75cm. + +### Road shoulder subtype + +- refers: lanelet with subtype attribute. Subtype explains what the type of roadside it represents. If there is an area outside of this roadside lane that is open to traffic, such as a sidewalk or bike lane, select the road_shoulder subtype. + +![Road shoulder](road_shoulder.svg) + +Sample road shoulder in .osm format is shown below: + +```xml + + + + + + + + + +``` + +### Pedestrian lane subtype + +- refers: lanelet with subtype attribute. Subtype explains what the type of roadside it represents. If there are no passable areas outside of this roadside lane, select the pedestrian_lane subtype. + +![Pedestrian lane](pedestrian_lane.svg) + +Sample pedestrian lane in .osm format is shown below: + +```xml + + + + + + + + + +``` diff --git a/lanelet2_extension/docs/extra_regulatory_elements.md b/lanelet2_extension/docs/extra_regulatory_elements.md new file mode 100644 index 0000000..1debdf9 --- /dev/null +++ b/lanelet2_extension/docs/extra_regulatory_elements.md @@ -0,0 +1,149 @@ +# Extra Regulatory Elements + +## Detection Area + +This regulatory element specifies region of interest which vehicle must pay attention whenever it is driving along the associated lanelet. When there are any obstacle in the detection area, vehicle must stop at specified stopline. + +- refers: refers to detection area polygon. There could be multiple detection areas registered to a single regulatory element. +- ref_line: refers to stop line of the detection area + +![Detection area](detection_area.png) + +Sample detection area in .osm format is shown below: + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +## Road Marking + +This regulatory element specifies related road markings to a lanelet as shown below. + +\* Note that the stopline in the image is for stoplines that are for reference, and normal stoplines should be expressed using TrafficSign regulatory element. + +refers: linestring with type attribute. Type explains what road marking it represents (e.g. stopline). + +![Road marking](road_mark.png) + +## Speed Bump + +This regulatory element specifies a speed bump on the road. + +- refers: to a speed bump polygon. There must be only one speed bump polygon registered to a single + regulatory element. + +![Speed bump](speed_bump.png) + +An example annotation of speed_bump: + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +- As an option `slow_down_speed` tag can be added to the speed bump way annotation to override the + speed calculated in planning module wrt the speed bump `height`. The value specified in + `slow_down_speed` tag must be in **kph**. So if this option is used then the way annotation should + look like as below: + +```xml + + + + + + + + + + +``` diff --git a/lanelet2_extension/docs/lanelet2_format_extension.md b/lanelet2_extension/docs/lanelet2_format_extension.md new file mode 100644 index 0000000..744fd12 --- /dev/null +++ b/lanelet2_extension/docs/lanelet2_format_extension.md @@ -0,0 +1,481 @@ +# Modifying Lanelet2 format for Autoware + +## Overview + +About the basics of the default format, please refer to main [Lanelet2 repository](https://github.com/fzi-forschungszentrum-informatik/Lanelet2). (see [here](https://github.com/fzi-forschungszentrum-informatik/Lanelet2/blob/master/lanelet2_core/doc/LaneletPrimitives.md) about primitives) + +In addition to default Lanelet2 Format, users should add following mandatory/optional tags to their osm lanelet files as explained in reset of this document. +Users may use `autoware_lanelet2_validation` [node](../README.md#nodes) to check if their maps are valid. + +The following is the extra format added for Autoware: + +- [extra regulatory elements](extra_regulatory_elements.md) + - Detection Area + - Road Marking +- [extra lanelet subtype](extra_lanelet_subtypes.md) + - Roadside Lane + +## Mandatory Tags + +### Elevation Tags + +Elevation("ele") information for points(`node`) is optional in default Lanelet2 format. +However, some of Autoware packages(e.g. trafficlight_recognizer) need elevation to be included in HD map. Therefore, users must make sure that all points in their osm maps contain elevation tags. + +Here is an example osm syntax for node object. + +```xml + + + +``` + +### TrafficLights + +Default Lanelet2 format uses LineString(`way`) or Polygon class to represent the shape of a traffic light. For Autoware, traffic light objects must be represented only by LineString to avoid confusion, where start point is at bottom left edge and end point is at bottom right edge. Also, "height" tag must be added in order to represent the size in vertical direction (not the position). + +The Following image illustrates how LineString is used to represent shape of Traffic Light in Autoware. +![How LineString is used to represent shape of Traffic Light in Autoware](traffic_light.png) + +Here is an example osm syntax for traffic light object. + +```xml + + + + + + + +``` + +### Turn Directions + +Users must add "turn_direction" tags to lanelets within intersections to indicate vehicle's turning direction. You do not need this tags for lanelets that are not in intersections. If you do not have this tag, Autoware will not be able to light up turning indicators. +This tags only take following values: + +- left +- right +- straight + +Following image illustrates how lanelets should be tagged. + +![Turn Directions: How lanelets should be tagged](turn_direction.png) + +Here is an example of osm syntax for lanelets in intersections. + +```xml + + + + + + + + + + +``` + +### Right Of Way + +Users must add `right_of_way` tag to intersection lanes, namely lanes with `turn_direction` attribute. Below image illustrates how to set yield lanes(orange) for the ego lane(blue). + +![RightOfWay tagging](right_of_way.drawio.svg) + +Basically intersection lanes which are: + +- left/right turn +- straight and on the side of priority sign + +need this tag to know which lanes in their `conflicting lanes` can be ignored for object detection. + +left/right turning lane is often conflicting with lanes whose traffic lights are red when its traffic light is green, so **at least** those lanes should be registered as yield lanes. + +If ego car is going straight the intersection when the traffic light is green, then it does not need to care other lanes because it has the highest priority. But if the traffic lights do not exist and ego lane is on the side of priority road, then yield lanes should be set to explicitly ignore part of conflicting lanes. + +## Optional Taggings + +Following tags are optional tags that you may want to add depending on how you want to use your map in Autoware. + +### Meta Info + +Users may add the `MetaInfo` element to their OSM file to indicate format version and map version of their OSM file. This information is not meant to influence Autoware vehicle's behavior, but is published as ROS message so that developers could know which map was used from ROSBAG log files. MetaInfo elements exists in the same hierarchy with `node`, `way`, and `relation` elements, otherwise JOSM wouldn't be able to load the file correctly. + +Here is an example of MetaInfo in osm file: + +```xml + + + + ... + ... + ... + +``` + +### Local Coordinate Expression + +Sometimes users might want to create Lanelet2 maps that are not georeferenced. +In such a case, users may use "local_x", "local_y" taggings to express local positions instead of latitude and longitude. +You will need to `lanelet2_map_projector_type` to `local`, then [autoware map loader](https://github.com/autowarefoundation/autoware.universe/tree/main/map/map_loader#lanelet2_map_loader) will overwrite x,y positions with these tags when they are present. +For z values, use "ele" tags as default Lanelet2 Format. +You would still need to fill in lat and lon attributes so that parser does not crush, but their values could be anything. + +Here is example `node` element in osm with "local_x", "local_y" taggings: + +```xml + + + + + + +``` + +### Light Bulbs in Traffic Lights + +Default Lanelet format can only express shape (base + height) of traffic lights. +However, region_tlr node in Autoware uses positions of each light bulbs to recognize color of traffic light. If users may wish to use this node, "light_bulbs"(`way`) element must be registered to traffic_light regulatory_element object define position and color of each light bulb in traffic lights. If you are using other trafficlight_recognizer nodes(e.g. tlr_mxnet), which only uses bounding box of traffic light, then you do not need to add this object. + +"light_bulbs" object is defined using LineString(`way`), and each node of line string is placed at the center of each light bulb. Also, each node should have "color" and optionally "arrow" tags to describe its type. Also, "traffic_light_id" tag is used to indicate which ID of relevant traffic_light element. + +"color" tag is used to express the color of the light bulb. Currently only three values are used: + +- red +- yellow +- green + +"arrow" tag is used to express the direction of the arrow of light bulb: + +- up +- right +- left +- up_right +- up_left + +Following image illustrates how "light_bulbs" LineString should be created. + +![How "light_bulbs" LineString should be created](light_bulbs.png) + +Here is an example of osm syntax for light_bulb object: + +```xml + + + + + + + + + + + + + + + + + + + + + + + + +``` + +After creating "light_bulbs" elements, you have to register them to traffic_light regulatory element as role "light_bulbs". +The following illustrates how light_bulbs are registered to traffic_light regulatory elements. + +![How light_bulbs are registered to traffic_light regulatory elements](traffic_light_regulatory_element.png) + +```xml + + + + + + + +``` + +### Crosswalk + +Original Lanelet2 format only requires `subtype=crosswalk` tag to be specified in the corresponding lanelet. However, Autoware requires a regulatory element to be defined on top of that in order to: + +- explicitly define the relevant driving lanes even in 3D environment +- optionally define stop lines associated with the crosswalk +- enable accurate definition of complex polygons for crosswalk + +For the details, refer to this [GitHub discussion](https://github.com/orgs/autowarefoundation/discussions/3036). +Crosswalk regulatory element can be tied to `ref_line`, `crosswalk_polygon` and `refers`. + +![crosswalk_regulatory elements](crosswalk_regulatory_element.svg) + +- `ref_line`: Stop line for the crosswalk. +- `crosswalk_polygon`: Accurate area of the crosswalk. +- `refers`: Lanelet that indicates the moving direction of crosswalk users. + +_An example:_ + +```xml + + + + + + + +``` + +### Traffic Lights for Crosswalks + +It can define not only traffic lights for vehicles but also for crosswalk users by using regulatory element. In this case, the crosswalk lanelet needs to refer the traffic light regulatory element. + +![crosswalk_traffic_light](crosswalk_traffic_light.svg) + +_An example:_ + +```xml + + + + + + + + +... + + + + + + + + +... + + + + + + + + + + + + +``` + +### Safety Slow Down for Crosswalks + +If you wish ego vehicle to slow down to a certain speed from a certain distance while passing over a +certain crosswalk _even though there are no target objects around it_, you can add following tags to +the crosswalk definition on lanelet2 map: + +- `safety_slow_down_speed` **[m/s]**: The speed you want ego vehicle to drive at while passing over + the crosswalk +- `safety_slow_down_distance` **[m]**: The distance between front bumper of ego vehicle and + closest point to the crosswalk when ego vehicle slows down and drives at specified speed + +_An example:_ + +```xml + + + + + + + + +``` + +### No Obstacle Segmentation Area + +If there is a polygon area that has `no_obstacle_segmentation_area` tag, the obstacle points in this area are removed. +If you want to ignore points for a certain module, you have to define another tag and specify it in the parameter of vector_map_inside_area_filter. +Currently, following tags are defined other than `no_obstacle_segmentation_area`. + +- `no_obstacle_segmentation_area_for_run_out` + - remove points for run out module + +_An example:_ + +```xml + + + + + + + + +``` + +### Hatched Road Markings Area + +The area with `hatched_road_markings` tag can be used for avoiding obstacles when there is not enough space to avoid. +Note that in some countries, it is forbidden for vehicles to go inside the area. + +_An example:_ + +```xml + + + + + + + + + + + + +``` + +### No Stopping Area + +The area with `no_stopping_area` tag can be used to prohibit even a few seconds of stopping, even for traffic jams or at traffic lights. +The ref_line can be set arbitrarily, and the ego-vehicle should stop at this line if it cannot pass through the area. + +_An example:_ + +```xml + + + + + + + + + + + + + + + +``` + +### No Parking Area + +The area with `no_parking_area` tag can be used to prohibit parking. Stopping for a few seconds is allowed in this area. + +_An example:_ + +```xml + + + + + + + + + + + + + + +``` + +### No Drivable Lane + +A no drivable lane is a lanelet or more that are out of operation design domain (ODD), i.e., the vehicle **must not** drive autonomously in this/these lanelet/s. +A lanelet becomes no drivable by adding an optional tag under the relevant lanelet in the map file ``. + +_An example:_ + +```xml + + + + + + + + + + + +``` + +For more details about the `no_drivable_lane` concept and design, please refer to the [**_no-drivable-lane-design_**](https://github.com/autowarefoundation/autoware.universe/blob/main/planning/behavior_velocity_no_drivable_lane_module/README.md) document. + +### Localization Landmarks + +Landmarks, such as AR-Tags, can be defined into the lanelet map to aid localization module. + +Landmark Specifications: + + + +- **Shape**: Landmarks must be flat and defined as a polygon with exactly four vertices. +- **Vertex Definition**: Vertices must be defined in a counter-clockwise order. +- **Coordinate System** and Vertex Order: + - The x-axis must be parallel to the vector extending from the first vertex to the second vertex. + - The y-axis must be parallel to the vector extending from the second vertex to the third vertex. +- **Required Attributes**: + - Specify pose_marker for type `` + - Specify the type of the landmark for subtype `` + - Specify the ID of the landmark for marker_id `` + - ID can be assigned arbitrarily as a string, but the same ID must be assigned for the same marker type + - For example, apiltag_16h5 has 30 different IDs from 0 to 29. If multiple tags of the same type are to be placed in one environment, they should be assigned the same ID. + +![localization_landmark](./localization_landmark.drawio.svg) + +_An example:_ + +```xml +... + + + + + + + + + + + + + + + + + + + + + + + + + + +... + + + + + + + + + + + + +... + +``` diff --git a/lanelet2_extension/docs/light_bulbs.png b/lanelet2_extension/docs/light_bulbs.png new file mode 100644 index 0000000000000000000000000000000000000000..dc1e6e14d7b389490cfa33e3422fb5d5e480d89c GIT binary patch literal 92100 zcmb@tWmH_v5;h7UxVu{j?(PsIxVr{-cZURb65QS0-3Pb9J-FN8E_dGdob%^?Yu!Kh zn?JL6uiaKvUES67JP}F?lE?@I2oMku$kI~cDi9D*dJqtw8sT8TCAc91IpDv~E~3(E zaNwUWoM|}t9pCl4maD3RxvPhfvl)biy@Q<@ql<~NnVG$drGqO7sz(R{f($}hTtv+? z^XzYctEyS|(Z|F3sJ1;y*7tV9?!qxk0GSvaod{1l-KJPjWft4oPq^XVQ# zPrz5ZS<+)>oz+>O4P#29{JsDE)CNEB@af8{`)-nZ(>DlB6plO?O*Gu-!9bz|;y*8N zPHpi&W&bUQBbNyOtoPqyR?)9p82|kq{R?Euf9po0!MB2&_~(1$V5wfp|2|WQe`5Nl zX>d6nIff(rf1U^6{`_BPdVnR9(1#kWu<85*>5wV}%~;&;RCjY{h?hMrhtsAp>dQY< z8lSF()+7Bm#>x@f=S^pWB6FxyRdB}%`C(3*7A1ymB=?ejr5LXNsH|X&Wfl4#Vg7QT4tgnZK%dZnd;*bWI_CH#+>W%ywv6s~{zBXA{K*IGpIMxlT;ZGc| zlyhnqTvy8-eA))#=`?u9`wpSrD8(};?_;-pM!` zLQex)Z!r6CBA3FGJ$*I zyi?;UK6oFCbmh&kN?|Pf>fy5A|FL~M^JMIeYLO+xx?FlUGljmo?#NednUqZem$6bk zBZV#s!RW)hi@xLlV_02&#E~Cr-)1ns?=hw;_Mx~nMsWybxh7cX_K!7DR=#fg)@wev zy~Ubf?(;B9dWT2yH;no<2FFV#vj~?&8@^cL%7kx7|FiZ03K7uy%x=i-XNsRyG!NKr zu0jdQe2Ow>-HH+&_`enOVA<$IE_r;`m2OeqQ?DHoO!P;Nq9R|6&4GqG|>CyRn-iH?x0{^Nv( z%%cgFlK{27l(Ke3p~g?i3Wumd#_6`@_(xz>KRl@|q@3t6PA;7lg2YoXA%|If;3roN z17wNWB%uu!1^L9?P6m0E)Wp{Y5hImy7&>x^m0-{|-%Uft^6SG#$l=F3$ZL%r3O-bH zDi5t}AgFpOo2lv}yZT*xA-hi_CgWYh+4rZFPhVRgs9E}!JCtH}M$(Jz&^E3`;wjg5HL48H7x z_~lJ}uriY${pPS~|07tycoAkhn`^rJOX>1^MaRFrEMBL^+^8_$Eo> zOfk%=FWPJDoot* zZIuyvqVr-W)+aw(j2uRx?^?^&GtaLoPD+iUk+z%X`dd(Ssm!F9ERDBV401rcAwB0{ zxYrb3Ij^Lyr4@dhi!7F$OXzYcZ?znFR3hj}BQ%_y1QuE_OOBKSGBpT2p!p3fq7^_*of_)_KXZpsWBGdP&kevVRfsg497*c zPcdv`NEyXpnm;w8?Wz`1{;8CJn*jvp0659N6FyxZdD_}x8+WSK3TVh~eTOZ6%&guj z79cu(Nu9%1FY_w2sonP${C4LI-#iqvh@v$p(`Mm&g?&Fis68L0E>=90O5&7cpA>Kjpq4$%`7 zJ6vB=C#o(xlpBXmT+7*(6mBxXi*YHHd@Nraw*W!&z7$E!8=79DR{DO}<1TGjpJ-5p z977LIOq_j~pzq8o*H)GdD%y(dNpX<4Do1^+JYM!s8PW^n_a(c}D*_B4D1*+57OTYw z@8J5fNIE-C;D}HPBsg4y&{c~=p1Am@VD+#VIN9gZGQ3sMHVK>NiEYWSVjYALWYQy| zCm1Rb?Rb)Le|sE~9atXG^}QJx&)v_}F*F$|DEH0}SEFy74>rsx0=6akCkfI~B3YrL z7G&HNNUGJJv|h%|OKil`)nY-Yl%cv!q$NfzImvrrzUlZrv6TB>(Y{JSCB@0TeQ3jq z<>IR%((J|@X`}U8wG-n*?}{iyEy!;TN758}n?DIaY2&qgwNp}8vj=4FN`$$FQ*|cN zGLyu-I{;nPs1L*6yVSbjji+@$k40bGs52~qlYZ9noAaSQr{;>!?u%P%gt^-ZyQT8z z9K=%W##4=k+Nm)nZBc<{L9L4U1bKf+I{Du|i(c7DU}F{hK}x_Mzq_epni%pgf$|~U zUu=S7l&AXzu(s$e;)cFDU+mC}isU7HS+`%4Zr7ZvX)!r{y;y?lQI>wvApHfP`%@a| zWzXeqL0%Nc-@XpadSK~&sCSx>RbEVd`P9W5?hux;`i30bPsdnA&~7}yL2;kyBCyrZ z8GM-O-ye7A#{B+9PQZV$W`&dm=cmWLCJ`UPI zXyxb+7t)uY4x6j;HEi?!c<~aj8tUl=7G&7swh@P{to7_%1QsIhba8g>I2L?2dRF`x z0fg{{kv_A+J`C1V-2XN=dvE5m@8MSuk=m^=z^ZG>4{e|wMy17bU_Q9l%r-KQ40~S! zsn=S#LFeS06$p+Rnm)f}w3keL?sT*Osr7L+oD znA{oidP=mb&gZd!=sOsttFK`uFNKQCI=O^IP))3AFZu_L8Y1(cxJ?n zZ5+&ehr-f!c6zvrR^Y1190C++b+j~EiL6)XCw8KfD1m;ljmMsj%8Y4hGYdt0H&MJ%V8$?BV}zhB8f1Xk8U`owco{F_aj>we7hY_CUK< zOCc*Z{t-;8obz+J`rZ9M9}y63D@6WbQZHG7#z**vsG z(H61yZ4?PdCTN(};P<2Yp&(K!3IDfo+4~F7NgeZPLkx$I*)Pk_A1+Lh*$*Bt>t$2F z_BUiY*AP^h#d9hJMMWO zTa1r@t_1T7F6c^33kWx7eo?8#`|4^u7NRdT$Ty@Sz&q@kuxBuOEMo#?`$aAx{+~4IVCknpZ;z?Hrcn z63-^q&aDGfW`t$tRdxRTskDGz0?_nZ+sr63Do|2bdDwz(zS%X`NF?84 z(ol&7V#bnihS`s(G8|eLrXZrxDj^)DalwoSXf!a~yyh zElvh@Rg}gk80Y0tFjn=qP&(zeiZ{M}H~pBFZ!IWx{2K1y0o4TC#p7f5O}VzZY>;#k zaAo@CkHr0j>%57zO0D{mMeSf6owJJ!oU7Vc>}U8hWF_r@pF3?(489zqQ8033OjvF$y9>)*-C9~M=X6~Ci?6W;D?>I_fElwK&~ zU|;;MaR40o#(LEFT}`wPrvJ)Pj$cP?R2Ul0mgqf_ciQVrrxhuzA<)o*ShSC4Ja8~` zsu0nxbXc^MIKT#3B?8TKLWMPg&5gUWWf-`ml<|rO>+<&Jm_Wt7B{i?cE#G}9{HRz`>c2BL&GAE~H zx1z<0i|yvqAtckqHfY%B&1|ubnhs%r!I)%8{ z$@p|+5yi0up6V#M_#TqX``NgoqCveOJw(*5`6j7_3Z53|D6{Zyd^tiD*XJU1{zti$ z-MgkVsSYkXuBIkjfg9zsM-SUCxu>iI^5$5p(`#;x?!=UHLUo6iHgUY08YZgMqs=K<5bw=A53tiahG9d3$5@G7oAgkgo4D)Ro?xTC$4`lw2+ z5DDoIJk<97;hm)#sxBV!81Oq1|TN=4WWJZj>9@dn= z6u^;{`B{Ywt-k(GKaC|uOG#@Q1A|bXfX>xj61$z6k!Ncfj> zHkqaNc9M>249~pqB*M2+zPhmqK5l5(sN?Hnf-^M|AqBJ7;gLnXiMVHzLu&>2rmj14 zH%#yD-`BB*^mEd83aBB7-te3S1l!L#ow|QpJwisb4tm)lft^xcgAbK81>lrfnCXje zrE#J4L-|jFJ(5%#+XKIS4!8cymAu{7g0r-2lX|fbPEtaW-=C&t1p*1JXe*2+sDDoX zwFqHGKQU834T9svrVwWGuvSRUub(XU3n`SwuRC2vOP~)*4hy-yfp=$|CvHa9xWG zX!<)#K;Bwb$-c}sHCbZn2VcFf5x*;bUK&=fPT9IE`0J0pS>n0d^+{G)wh%#g6STe% z_fk}oTFudY=c-a{dq;GjWI5bW&RS$s>dzW9*9CzMRwzI3)VSgwm86}z?bgEAqNLqlrh6rTw zsS8?p;7|26f;&y5gw`wBwA)KRwAL0_Hmn$TXSyb8etBx;+7LCVHGU)24`PJCVozr5 z>31)X==chao}$wTeaGB|T4QBpb$mF9u*jK&A4>_0z@%?_f{Wul5gAhQ44RW4L-K-5c_}Q1avKykaZuD&CPv0J=bheuUw;Wx;J0 zjCIaQ5eB>=i?LsAJXDws?HLcVa!l_WbRsGK#qkr}ufwq`PDpklwZ$;rOJgITiRQ#| zPI=LVmF`Zf@a2vm-^5@9%vJZy48U@rjTP)S>+*zU^%FnZ(eH9o#(Ym%aLrj<=M8XG z>olPT<=*LIhyqH8G~?RL5R&)z=g%1w)L3-i=Fil8?49KZMtA4o1+>3;Srq-1sjJC( z+507Pa<91?4y*9Yikigl<3&YO(dSZIP_iH~DoY#42vLCl5>(_FL>I$puNNiJ-15x< zdDp8?j0fQW_D9inZpthy@v?p0u4irPm`ChftCyv!r1#k=Ch8zF%#3oakcRB85pxl$ zD{?bL^o^bx=x%E)`r}KvO2^+6wt`Ck(#(2d;yWz%r<%{6O+K~I1D|eXUVE4>i1P7P zbVd6b@&;~h@}Xq2rd^=H(lqRUw}nFH9Ha$n&@2>tI9Z-RQQD|BhET!#Irt$~aQoYrySMXW5W2UW%l2#MXb2CV{TP z@61Gjd_i$_cYhl0>|*6HFD#DQd#hw}IDG|V9x-X)Y)rh(tp4Umne@V$2wmja(uM(f zBE^G4h6j0r!2F()Nt-PnZjfwnsAvv5{q>$1bgE_{@CU)DEq&SBg&m+bwx$3YmI2}y;a%z!0q5P!7b zfQ-Q-@be+2>G1k{{7;*oNW!&F>IM(7Gb7l)wYB13`Dy#+01jSm&29Qlf#t(=;Z!9I3`1 z)-QtdNIs`U=r40MDtrzQsQd*<;Dv^LgyWX#W1c?>yqgy+F-fxW!p>HQdh(Sw-HgY( zE%^9e)YH9HXZjeYI{c9zrX)!{-ziE*O8Dq!+&#B}k7u<#G&L4rd?UT|r`&rsmfTXTc28{PrOx{15SYd=pGRoiN^@s5$ z_E_6U92v3TA^h@cE{v;FvB(ReeYQxtr_nQlP)gNT8RP8HA3oNw4Df(*_^UKHKZw%( z5yz|7wLG=Jot|)DfE+j40Q0-ppN#2%h^u8Fpo+yz0#x;sHOnCP_UjXAY>iAL-bZ3v z2oc<5iMbCWazI2;>QumVb~`j@`Oax_3`>A6@dhj#oVJToC8{gctRvp*BX_YB9xGt9 zqE8}|zw>iH!B~?!f(FlV6QBxp$Y-2}a8KN1p9>fIW<8O31~O~fU-*w(h(0}Gdd_O$ znAE-4Q&6^rskUA;3ddT=|BgdlUR0X20`xYM^?TTd_R^D=Yq&y@!Y5Fx*^=9{PR;ok7+wY3a zHh+CN_CFhKj4{pj0U8tLY)AtHLaR_}g6Gr^l*2#cj0$O^5NM~`ux642{p?s{e{Cpk za>hdr2;pZnyB}SV*&}0Kq)OVbn6&x-v~Y`!Im1V@{*+G;BdOkcW1M4S^a}dQmO+rx zHbQ7gu`0!yI>JJW23#+1X_>kCdT-1in8G~k=~)?r9NNuxc6)Bah;C@*;9&T$7UX%; z26sq4Q{bY{>H!Mus^Gd@fhTs2X?U^b>8J@6h6uI7seZPgZU6zPPf=v^hb>325*v-4 zlY3HKmb2lqk*tpWIx)zCMmLGCtAks4s0g1FS4Kb}w=2VnT*+GO7w5X_3V@=@^j#(t ztlwvS3B*{={X!{!K{Ay(Vh#2ZZuM`Ra2@qKtuAOjY;rOyc#=jprXgb+u87}x5`mFc$yYkTV zx+3)Ooc;AFV(GCZy3lsP4ml|{4D{T(ZM_{=J+65|7Y*TBC95kZ-q5TUkqCujruDU7 zpu(PbI5|)>EmDq$ zC{3qPkE>ta-7GDbV$`Z-HB@+0m0!+>WSEAOPhh9>1&y^B8NlnnM>4($YdF$7>ynkf zT_6c}ajnu(fwTF(Rg0=htP9+aqF9)f-HI$Ew6xwPAz>m8HDZCmoV$rk%hsIODIID< zh0649$({o(4yksFy@c7j^RI3_^z^f>{vE{~&HZ{8d$%TES%69d6^m9tM$p%?y1}{Z zz5lHR97hQpMIIOj@cmpwcYVtu{RpkYbj6p)$3q^#eXuH*q_S6h&YaPne#RIr=!H;khXkGBLa} zi*cJj-bt99&TOUu#WBV8cXZv?)}siz*RFjG78)8Wgvk8g*~zi_-*i=5AD$dA2lk)U zIg1M?M|!`d(l~+xk5C^oh@d~TEqrwwCj-xOjJ|J@sCOUrp>e{qd2OLE9^}b~q10I? zmTmp1QnafZtBRO1YWwSyQdD0Ca@{`b>VngVepJ7eYK5>t$0u;@Tzn${#d9tAb}Cv| zu83PUHSv$QLQAvF|9kOJ+v#8;laiy=*Tswc2*I*z|GG_^A67Y?|f-ol0CN<{`CwKNZsLABf&ZE zjcRuHqw_&y=dZ?cTEE_Hzu{oEN&bmxrJ{;o!KViu{y{%;bi^I9vj$z#Ze87L1oj z4y{X!WvjTby=fUY+3-(<$~WRewX8VyD7)vNvxB&io9k)-Jm8lGh&DDC8mR^qv``0V zKY(L0=|0z}gq_2#d19f#ke=-P?JP~&00GkB!0IFda2OeA#^h^4Pgswa%XCx3yd#8< z7KDCUFFIyWRrV2gOzp>4{aa9~Cdy}amY_1I+dm~Ekt)3j){y!pTv8{}Mx z5+GUft53Y|*%;rN?_0|E-XhYKp}rhDyyXCFk}17wX&(el90y~6Uj~PlY`1wn?#q>u z(UzZ6Pr}b|d=6%yj5?VR=QZofC`^NV%~wlK?FQqTx9h{U&ZpK4W(7-qC}zR_v{eNE zhA$-Z_!ATUBQunOoyIbaTsdAhl>Ippk2-Ta9-{IL^#Y4{l@rX)107|Y3J$GNt2qmo z3(_&A)i-Xcza0k!Uv;}PT)45>0_w!|j2WcRZL3;S_lAi@QmSO9llYNDQo1*TI(kSR zNgS+udxTj-87YQ0T#`>R3%@hZz@1&Ac7K{SQ&xgLrId9OKq*|InNV!3oD=BALBnyn zadt9wf6c{Q*5I;zE;sJKW8){vZM&{<4Deimh`$Y&<#h*;%sHRZ$-mYb8KT$a-B>YT0Ox zQhL@PIDLF}jhty8b6Mnr{BiID%1UB3`WVel%wYio0E;Y9{S49_Z7Z;8+KUY6Ot6U- z5?cC+N#d?6SSOsSx9(z1&pv#l&ib^i*|yt7d3F^VaYC1)`I-u(Z|@#*%!=Y~N$F3x zn4v91%lh)Dxkl^BOJa*Z!Se#&e2Xbm&gBEoVTE_d<0z=SY^J3ch`t6R{Qlv%<;fI| zvj8V>{uNi)O;I~6TT&ENrL7s^5bW7CaN@taw_mv<`LSt@c-+V54jUGbZAQKvqw(dQ zR}c9yuYhw(m5^P~td(!#gK`)eO!wAtd@VhJR==A3z`zKKBY z2kAxoKH`nCxHBvv70Sn-T0`6x*z3i4!=3 &O(G!9FXR_@I;9^)utd1!Ypl_JPVZ!Ts;udiExhm}szzGEcgf5?E%# zOY`<2=LNm~c?qxvwLM-T;kGz9v39*=mC%?7eBx&Hd3kwVN{M=Uk11v{Q#W53p?kwd zU2+(V=hfNA%oqFoVGZjw+P6sWHh+(8OI+4#KVD#45!d?;(alJ?$3)jVmv}-9_9kzS zIVVTQkptfCTp>*5C9-P<5*r1aP#I*TSIV!AH7@VTtR-kmj9oqR?d6{>hSdr@4RHw! zMea=0vFsFXx6+bvw@=t#mL738j>(t#!k5A@%XYCVk}B)oSa4~zNM*YfMb)ZkDR@Sd zdH*~^ba_yfKDJODAm1^|Jpvj_fE3-r>hg5^$4LRtb##HFF~P*dF7_q9AKM5fKXi!2LxOb=Qj~CB6$& zVAYuD!BIZoKsDRfJh;VWj=l9A1mWSVPmB7IGy85}(P->-!N>qS&J;%9u~j8(M+t3o zrLxdT75WLyfSiVc(|u;Rjgxgl4al^y7g=)4r=i*8WWVD>On5o&%W(eCAer(DZOAFl zjO)i%os`QmJIUPS+&9=fj0hm^b#f^K=KZ19&lqvB`=r0?TMIfAW^b19`0HlCY% z8_pAgCyoAUL%i2Tbb?{)rFpwRQLydP9Z#almF}n3h0%X!TRu8pms`PgLgt`~#z;V3 zyMcasti%17&9rOhJ|X!j*d6Ql-}Ug9qU-sDybNEgzo+@dwC^tIG4Y4`g-EpWPl>|1 zvRlfee`qZ4DEId1=k4hSR)zN-8gVh^lpor_3t)68-cqRZ1e9)7 z(GG6_!^*QRw>PvD_L;K!pLY{I99}K&Rhyc_cWZD}-bHzrL35$Ggp6)aPl_22pOa`xpfH?WuQ=ynAQOhz4E z`6pvqA@6uKN7pkVPXy579%dFIg1iY=tVmwZ>+HO99+W(z=vg0X6BG(J;Iq6Z3A^5?OJ^W((J{&Z`sg+o@%21@)p{IPHu|Nc@u5Nr_ zRf=(+#%59+j?Vk+%hK=Fb%TmR^p^&I>!raSasI$+@>^HhWYICws3cAmgYVf36TTMc z*t&k7h2YTnaK5y*gqBlZkJKM*3t_~eAyZ{$2qsRQzR*n43wSP3cAqWie>c@lQM#?q zQF3v%a{Ds;+L|*$X`_tZ9s9yNDZ0&tTCE)dYIQ6XFb2RVw7vsGZq@1AL&r$1+ST9V*{Tz{zXEhkDeZ{^Eh;Xi~&_@vz>siFt$2e4x3z9{9opNVK$`IqCA`ztEPaY%PfH44@-t zf%NW9Y%HW?nT8iikso@fA93GPzO+QARMb>zYJ%CkfaohY8DaV?P=W?(?ia_P&>wsd z=fcqyIdgHCHMV&^Cis&;{)xYwW)x^%%$t$K{5f2_gG&69p#%xEw4lYGzx1Q;C11+j zVc>|7(fRgD%w_SRqv~1KWOw?KllqtZ)R;4t0lmYz*t&9B1O{H^JpMEjZOq#zxEsdX zZe2ZW-j=u}J1#Ov+^elBY)9d;U%uBimG>AT_C~K%_QL)Z`wCrQMrNRLl^f-m{urA( zzEyH@C35SEAI+0p1DHz(h@8TpLsl&RL-TaOQ>j+Kb zp34pGSc9_lgIG6gBo(H;IM0nATc$Xu-Y&bEc6u1GB1kWRP>~%CdH3B2hUB|+I%=LF zP?R`bhqgvCP9(KtTXLV*?nBYY33F}5YY{|S{r3$HliVM3RKybUCaFcW^ zoF-Mblx%6^BHFVvZXF|>`r)YkIK2IQ-?QVk+RHZ@^v3TTJ=>9lN4xhXeW=T-%F-MO~W2(w+9K=c|?ecZti{9qoM(X8p{ z3%}b?u}0-a$%SQ33%p}xj>#d)bxtC7nPs|lkC6gn5Q`>i<9qsK#Y*jcVRRuRVD~fh z^=J2~6@|F}0h|dn;-iec4J)H|%Nz&k1JTdH7E5QXnqP01xtsf#1k?X+Y&+ZLmd0YN zuPSR&8hee+H8HxR&>>OSWK(OFX+r%`rpbG0krZk-xa@J=$HOkjd@x&zg4Z~07u69iAx;0p{Po4- z{=jsNxSqjl`_@j0yOjP)-soxlIotL3L!iw40YsC{GgH{djH`3Y zP$+HMe-J=>80fqhWR5)1tFsarC^FuB2io8}D>D;TWWZ#RBpfWEB~LNNlMSI=du)DT z!n+`Q@~NFEGfQ0mYuKMWZrCf31KE0IP`)9Dc4`j`;aaA@kf}a}Z{e?LYT_KR9U^Vq z)zNH=^xrpTREh3M(|u$y)N1oR&3Tg8iML1-4HFXvsWF@`aDSSMF_2(*H`?Ttx)Ves zz(~rdvt{qe->X2XxaTrKJgWTTx{YNy#Fb_vZ;fa#zHMSkEP-vRd4$5WI^m-)0cFSy z=(me-jFWWb?KH~BcT!M&N;_%U+1as9Ixyx@NoUYF z?Z8oM(zTnBSZZjMg9FvB zxgdJ=S@NT^zvU|$@^`U@UwrmBU~58897kVo#>dQN?P;hG0GYlQaD25FSJx{Jr%xxr zGA}DyLSF|H`w|K5e1*AlY;ZI7cW?@N!|$5wrt7&i#=w*W%-#q(4Iy+zHnvHTeI|#G zQ9mSvgSBhgE=JO&`lMyh&A>r#6U=32-i{8pXqTR`npBorv@i_C9Ei#E`EN*pJ_fiE zQ8`P#_d|Mq_7EM7L}i{4x$@%ueJtj?dgmIHqhNrMRM$u-Uf5Tw(0>UmXkzGgy*)h? z$UW$%`D&+B_k+P+G&h$6t>ph>!HA(RSe|BTR2MX%Py!8uFGpizXtWq+JKWm-$9D4USWk)^xDWz@g4*hR!}uFDK-in#AOQkh(u{ohK#cwcTz7Sxv3wA<*p zQe^pe@U_U0;}PIK6GVKegP@jw2AX;CW@|>)jXvk4P~xl5{AZwpN)vlM%inm^ zWS{6@aa04wr=aF0mPr}*7r^OhA^2t{i&+4t-iAIvR)PCmS<1%~wZgzX+CAbwwJA+A zPYZ9csf&)pV?!*FNJ}X5(XHYpk5p!(@#M|xtFz+Vs%g0`gH zSs3UJ`+PK@6SGXvA6(#O>N(Lypn zKw19526H|j5Q^Klh+OQz#28i>sa{UK?u60X3|l!!B=%WJcLU`l)eVUAP=;;;LzC-~ z3p>y6fkghsl(3r!9x%nB(v0HU7%+P1{il(SfR3vW1Z4B#7XA7xMAl|JaN1;s>7Q9S zJ%Ll3t?PO+8-25~4K;Di${$+L7V;slOD}eEB)B>GQ*ABWwV(((1@1U|=_#M6(wdmt z4=|D9AH_4pf1Sh&n<9mGwik%eofq}(Jkj_u9tRDM5EXE`lt$)f;IJ}mmOm2X?rCV| zzFw98Yo2)87>+Ugd={}Bu{B=c9F-@i3C&y0$hr>)fncM*d6@&@Zv`ExuyVfzI@#P{ z|EC*D=3oC-Ow}41G;AbU6$}3B-$=tU-q-(9g*VOH0t5`ZiM&4?qTeDKK2}E@bMvOY zISOf}!_@01FKad&uXWxK26Rsw8308~*PeVzvDu{Id>=-NuHek@^!1 zW(T0kY>aH!jcT1n)}f zgUGrYJFzdSca}$)chx4Fs`lMyZq{)*z#kPmTQK0xZs=M%Dg_nw=9o}4J&nZ{^cL+Q zQxr}!u!(#%!y0{yarpA=ksX8&4x$(R#2|%ysv-d%wqI(BQ;)L}Rsg>DH^@YaI)5_n z$w)N^aOc^zv|Tm7Y&}1BA>3D1Z`~w#N1C`}uKy3$Om8I|!ItCI5E$g+`fWSiiiv?6 z`K$H$V5Ma1>BGuICTAr6bh<$2OQLXc^GCK!GEV9Yy+jSqKa@N)V`ID=$P~5+hhbTg zH(kseK{r&`O%>LOI`)?wJ2_7Lyt~f^3k%mz@QgxXM@)&w0j5_w*-7sWJ)L3Pq;cv) ztl-NCNl0zk1EWl?h>vNt_qTwj$H#LtZ=3MAr9Ec_;oi59>kYdDruorZ28_n5BlnWfG&52m3x4kOuBk}A^St|GiRuyTvRj3cmmRn2 zQ+S)udbpxCli_^p(i%PURKk2SK^_*C@&7f2+v6KCcV*oXQ=lLaRP_~qb5gvU6#ikC5BmFSEUnGv)+&$lnmb+tTS z%$CJ*kzG9Pd@aq2qXsiFQyiVl$f-g{U^!b29C!I=mjDvr<(1kx6wq6wmG%_pcc()m zXD~f8Uf^;suF|`JwIe4PkEF__`IejG_t#SPYs#a*K-yv+*78VFi_Xhy$1E#u6jwej zOq*9w$g#_ApXz@RFIL7=8hkHNoS!$NkSRNjZi=U}703rJ!_OGVe3T)-D`Nd=u@r*l zpMT%{3f@ZOSW-lK&CF%YH<{CH$BtfG{Hgkvh=n;g-I&O1Td5Lg-zF{DQ`4N)UpJML zT*Rd9?4_vBJNzb#HQT2u30;}f`_JN4sv}@=&q4NERfN?8HvrO`A4y@V0csJk72i8| zRyn(4#d$VQ0|*RSJbd0tu+J*OQ7L^r5qUlILj^rWqv?`XQ~XMaftdP5<}S#2SC78v zV8j(X(!B?L}fy`^acth5&GEMY|3ea}Pzb4v`OM~;HLsuVF|L}#8 zDy}vGW=hX-1gc$R=^XP4X&gVZXz{>!wd2{ge>3+2g8&EH9ny;yc1|lE{YK6SD+lP8 z08irV?>2Bbt(l=jCz)k*Umo*NB0~Z^ukfprrx?j4ente|?emxq==@HUgEh<0E7Unx z`o};@hXQm9s~<=oj&Lz*lrbRFjq2l%o+5jSLD^`6v=SM?Mr5q3mTal1;C%OOr!kHs z=ae7b)_liZrhiMaDyc;Hr*qQwm2=CW%@2g}X#W-->)GT=^FQ(4D&5X5o#`I4lRoMq z`9HVYZL1$g0NZii0l+6z{^q5jl})ulgOcCw8HnTZ_2KboZ_4(x#TP)P`C_hF_DQ_` z=6}@WjrReWve@rMEG7FEUjwA1I|-%5_wCpXLt;-r&Xpuz#mEzs0nT5K<}+pr6UMb7 zQBf)OjMN**z)+~#yBT*aMBJ6=K0e2hoP3xelLi!uxgaB7h%x|IBsvml<$vgf+g(BY z@TBT*i~SlCaO-#(2j!`#w%h1KTmq@oYMlTzE- zVMy*G|Iw8MYYWt+MD2qCk$}y9HR!2ksGP9J2lvzs%`S3`16xTAF%ulsVaGV7fa=!K zL1O+dnQvjpzGZ+mR05u`7}~cUH(S+cxwfhP7Fd?`8)0C%g+73d&KD1-*U$O#>R(l*qb9uds)e&nSXj`9f!;lIeQ{skI#m^8Mxuo=4y>p=chJi>)6{xB7a+z7QF zF&vB2NZ=fo+?CE^4#*zQ(4md;SLsc1iH<h9%t2wfw{M7-COy1{_cRRo7=jq!h!5o8jmwSPf~<6odr17 z-##Mp!yj@ATC6SXWwlPmF(8!-V)kE7bzSUy|Gsj}<-3mW3ls+lGUjuGOh$2DQ&7D501rSe*-S_y zBdZfObJ-keZ>0vk+ToiWEZf1Zlo05g?iaVf{29vh^p$oVI2V=n|8Vw}QE@fF+9)9b zf+mEZg9Hff?hxGFb#QlgLV~-yySux)yAJN|4&RXXoOA!*f3s%o-QBzDDebCmtI@u; z5#J+TK%Q0^%!|P9j&zhzASOJH3e6^AsQY^UMfn9D0;c|2;&Y=0W$FMj4+!`K`w8$l zUB+b6-u`=x38so6IGr)zz10Spas^#E|Npf~9^6Y=DPLF>cDx+1V@U~2prXY2I$~1{ zk-Bw6xh|q}@mc4?oRz($w?2gj7fAu$-m3CAKbP{$tcSd>-H!jjmxlm3gwSnfF6TTJiJ>L<>lbKh&hB1Q-gX4I@2+N9w;5V7R8R z+3iZW9UFJEa3tPcE<<3XrSq$-Asv%uqE!{0r5=}l@EhG3ql7ua8_Jf0lB@{>(G96y z*+CExQ~k`PjZVn(^k)lRq}`HgTU=St;6ErQY^m=$fa9RffAidBXw|0n7=KBvJw?`P zCJe`7Aw4K|xpb&rW6@kVJss{ZR+!kQvs@XyN83#~@hCtqzEqs(iMpReCYEGB8nn|N zBL#UptS}XRf23NGT*9+&U@@w;?c+pZeQCqVB;o_Wo{}r%7u#Iug~oY~w~VKH(Wk~+ zpGcg#DRnuFpV6$-gf&OZdYtJ?Um-##XA)(elUTO5p7$C<{pFt=ZF$+ zRM1?KlgMPx1DT^5OCkiPm*{ltIY?j4&{S!5^h{oQuL34?JYC6Lt|V$O0+;#bBt`Y( z|JW|e9Sa`xWa)a*1pB8C<=)E-_fLmOkleNQ<{+`{xv!*2X3@bH-}UR^sr|J`eCUe$ zsf=&(_#Li=#^d;fqVk2RQS%#hZO!kJ{HlSM9;u`9l0Tk8#KBraUD)WqqAsN1Ja9<` zX7>j)+S3KMepm4sj*5^txuJL&Kjv5O0>$ZAD$V*y7ISzSe`n2+v(~uEr4JL{g$vcF zSBuaZ>e+n^N_@U#%7H%5Dr{~kA6$aaLJ{ud)O`0x;+ z%&weW8l#}hc@F=M-_seS*tSj#avcbBEwDi`NJ#W~O9`f1U9ctTM#`UXI+g45^1_Rg zJ~4_#Fl{jlH0c{5%I*1m;~T&5paUB#g=(rXGjsn!H)R}{6w!B{pVmbyI*%yz37;?U zZ&tr#PK%{kOT*M5?MeY5JwnmYoi>F7BW26!l48g4AX;7P1JuJE%pAV_YMS_xW;NM$ zvx8#tIa*I@<2GIVECy z-1i#(>wSkvpVWe`w&9@FJFa}+6a|K%rEh2}Q(Ci7jzRG|Iv3+N1iF*`NBee?KjFwt z71`Vz7hB5l(qv=y@^smoqN0=`#qDRZk&0Hxcgm%DpY7?8+LJY#05|((uz$%pmK_&u zT-Lu1PIQ`@ zmJOXxqsG!M6^9!?dYQ#=lUskQUyh>)E=dGOHv8HK=JHN;l5RiI3G+HcY?T{;YOqtl zlrbqZy8!5w*(9ij@m{#VZzHO`wMhG<=+M6xGS-fj(Ef=%dAB^$_$dJ^VvC)sLrH zf@AWGB{FAw^2kae%CwasgUL2dxxCS=0XKP(K!)gtO#;L5iF9DnewFO~p}8T?8CzHr zlfQpDbLGkC4^8*RV$!#=h!Ek{!MJb12a%M!+=*d>UIN0k^3U_CoX_o``TRbyu@sFd zW<%)b<{Ck)k9im1*x&o2%zg?_jKrYj^m$&|LHk9UPIY`&Mj;Q9yl&oz?y1g#vX$z$ z@`P%bhX-19`VFxZE_NQ6nVSiyGfgMQS~Ja8-~9fZK10zEr*ekcGWll(;piV37f=H0!Q}H z>7L4n#SAr>;eeyMx52(?Q{rGz*w&Ac4pOD1jxfsJv}LboOX3|#W2tl0^7b zaLu&|v0fAewo4D?p?WUtWUqs9O45hZ!2_-%A)q%Z2abxi`2Ih8=&}vNzBlDx7@o)( zEH<2JLe-7XoX2#2IBGz{qk&D}@PkQ=nv%q6b@hOnCBIHvD-AtqDb5BsC@PTWk5OBpV3c_)Hzo5qBy=^Q*-&n z;Fv0VggC5OYcO6Dq$h)S(T4wMm>KD{apc?N7>Pie)lv4Xtkg!D61nMqQ%!CW$Lh(C zZg(UbETxp+P)QS-`UthK`pYL!aE^xBSbv)mT~4lGQWv|ty9pGuv^J7;cR6V8s1+D= zLPPv5z1BJEW2kqddR?XVwqW1M^3yFr5Gu;!&+qH|z@&Stw$xw$bZKS*)qUbvFbIV6pyXGugoue_KuGI045 z4&nmST}O50__H~`C_Y@D3%rQ48M8~6%E&l+rEOT|P0zIKuOR$V8+)3$k*sj#C>J|; zp28(kXHMVidh@S<;7xmHp)55DvX%H@g)PdUmT@Y_KDi+HsmXeboZwB8=!C~2C;R8V zM)PXwj)|VLh`#Zdw2}Cc?_9Besk#PMx(LuDVz$KsWTvQ^zQf@Q3|NEt@%=h{TmD&Y zco6Nk<0Zi*P|R}05{L^Qm%<@j9qBP>j^-RqMS!5+R^2eG5C7v9gpDR~rR6glBU4is z>mrZSd(u?}3Myi%T;GbN`Uy_wJoXz#9|K@*mn&43XeqObqn>Qyh?@O!;9X_R=Pz zT|bv(5i%z7Kwqluo?h}uTorK;4Os|{(u!*ll2dd)`5<(>kuiL+oZ0J@MXs{7HozTb zA9sk5Cqf?{byyt!S&Ymfhi2G{Z4pxDI;XACuccX676+tXtVj))ralp2j-1Z>S~V9% z1woa!haQQx_fl085ZkQwfLx#YjDA&tEPhGh8)XiQ{O9Ke_>8Dq=AWs(G*DVq`ORJ* zssX#ig(|Oc;kkvu?Df7Y^H}1Y_IES{#kIk`(3J`KL@qR9inl6vpYH8&c!Libb4PG6 ze;uoR6lGy*W8QIe^B0=?wkm+)=O=T#fK=PyLfHFjHwx;*XtKNz2@`I&MZXrPM~Hta z@kwS&gJ)Si7%MtpE@n6SF3^fqG5BH7{u*5!Urt`&lw;11<|dr-$5vm57pG$%M<#YK6JYLDi^+(sT=eMkQ<>wTyyF&4>~q?p_-!*h)Wz&npS|xS zCyhltsVnaAet$+8+-e0hTP&EDwqlTn@l)4CSF6~2aX1m6^3}kLf=}wo(j-ery9RiF z_7Rd^l4x%v&J`>%IV`*FbBDWQdX+dFsT*CLG_6HkZq^864hgEMZeZNyMpLo-y3dc- z-Y8Y%n#IotCsGn7vZhxbjN%<){b9+ZIuXZMx1?t(f1^udM?g~kEb7m}L1U;v{uluo zRV8!fYNGMNJg1LL9brH{uP`jZ3qLav&K3NdI;CD61C(&*~ zPr?j~AcnXY;VCsM5gVn1LVd1p3kZD6ZWI9E-op1OqZ)%5QGEKQ4TE4f-q5&-hExx*hK7%QSAfB*~(3L7YyvtIQ?p*tD0&!@Nh2QGRl?r1|TS z0zpfc>MI8QRu{p{{R>((D5F22+?{tyWH>liZJR6Nmns&IV>pIw8WoD9QXp6|mY%iV ze%01;Xkdu_D3^R=tim14G|ohnscfqY=pwlkwLJJ$Mu5f=a!!hYH)@{s7r4C09LLC< zv7hc!h?uR;J><+lY=H|U)uAahNDPoLCu)=p$;rWj;v2P-PQMs^YFEE=?qRAL7<27Hi3^W-x&to86ux4(p#lJY`lp{aJ{z7qu; zXrZJi!Nu=YU;ZTsqO9|~Jw6efwC|}_q~(qkyi_;&&i+9dKR9kdByHL~N*8!K568`% zxcH^E-#H-21Gwc-2hSR(Y;J#a&@^XkT2<-ym4MNHG(2C|Fsjy~RMqz@ zL5_*;q-OqaC(Y8!tD%4)vb(o@d}6s!bQPpLSV9}2P2U%Dr%gwh7TUk6<1E#zwL-js zG7~}q-||RFgT!14xjOP-Q-3hWmh_{^GOh&$1?|*o1mUWOG!_bUSrDC#_C0t#J{du2 z1kKZ<@4Oyy3*I$$>_9(G^}Dz$JIA*{jrL=mh~;rX`|*^VSgxyKw?jP;e$F>Po1;B6wZ@2tP8IBh|L zJu5xWtPU2`P;D;W$i(!xENS(lP-gL;6nKkC*WFm83Qjb*T_I<^w&^pPM&Y-)H&}S& z@bQ`apZjwXeZR)jna&=oUbP=I65NYgXFn)*al!F9i;VP@(6p=w z-n=hs^Kv|(>pNsZ;|z49(Vj}tl8vNZO!aV(bVCvQp$K09HQzVzIeMR=EMa!S`ouf9 zD?P>*e+8GduQ|uR@L{ojhPd5{tnF#8poDuQQIdN$WcQj8(i2m;F%`n~O%p@V zzf9-XFoP4NF%GZqSA5?8)-cB9dBje(f3p|oOSUge!W`BV6DuP(r`qX26DA#0@mTho zP(q*E$aF9GNh*(t;Z77t;fO9+PT98CLlUHqEFPV~YG-5et~2LR_|>=7n5o`}sY7sO zVpW*2%)24pxUjN*ZU$Apk|HG}Tr$h}^P%Lb>b^E_7tChf*CPtR`~X&z#1Pd9fB=Fe zpV6~y#ql!!`&67d;o+S5R5}Hc@u~iCNKGGggeAa*2Ce2mg)iV#@STCiR$&B&lH%Y< zOJKIW~YFBvL-LN&7&MKjrIk9=s|*qDAq0s{6`EI*~;?K4V~1ql(lBj44)Fv1C!>qDJ0%+d}DwO-3-+Ww^zKCdaGBfRV8*!w*6Gmys*`| za^9fjK3K>6x$ZC0^eMK=D5#+vcR0?YGt7T(ZTz_J&TeP9n+U$D<2}TQ(nKTYkYCqhIU2qK$&#h z?ChxH!Q|UBX`=5PR!}g5 zUFNF|QT&Wdt9pO`ZTI#yy}1y$Ygv2XWu;t15>WQo-yMh>p1mliMDd zdo-WnwyuNbt}D!?pLt%62KTn~JWggaNa;+I9`frnjRKmUhdggQ+C;y_pmzs){uZ(d zm-Gj`OiiUR6E*f2@oBCwK*ZDbL!sm-ay5+Re?M_a1t6#6iqnV=1Mk|nfEdACvu7W55yW^A&B5D8lLcH~X;DKApu!^$rc zUKDYwWo5EzjhV=)^N&gdTR!Oa8$>;gW%X_6d?c$M$t^hlL{_-?o#VXaZMZtImb1Ar z{g>A~!R6XWM}{I-vFK9L(8wBcdKO5(>4U+Nq8a1i{Bn`=!TJj4+ z`n2I6qGdBa`V^+K)zdcOduT||tpNT_YtOVUVVu< zx1oU+h4`&weevv!W}?Iq<++MI;IazaxI_laL38l}ri=SUJwnK+;-X2-zSXey#h%;3 z?HB1PD9O@rG}juG{HX1_*Tb`PL0hAnR%P(Ob%@K4x%yI9JT!_5`5*nec^2g+!X$|8 zRAK9GQlrfuj7g~1gQD-7o#uz%yln>-OW6}Lq=5Q|LD&v^4?4-Y;xOECcxYsczYw6%Pm}GA*Xz>lAQPg=U%jW+1h8alB4LdDB z*yQNUF~hGUM!8&ZS}m`bn`Qc)pnNhD5cRv$SO8D^=t^8F6lZuzSIlvdjAz#a=!YSK zmG0B_KyeYVt3r>unk|?{m+%=Sxc%u*NW%}Pts0$5l|?1f{FWlP+0qORRMB)+uE6YQ z+B$oNEEGLTE#RNp8L3%1)Uu!)X)mtFNn#0>IwyDXvZ-%DRLti7Lxt>lS)`Eyx09K{ zED`!M^$`$YLtRwHA@lNAQK-%bFE*%j*?Kxw+H}%`tS5{yl5=XtMtI+_SjDwE_ zHM5(Q5N9hy8)iz&e4C2GlGJ&6l_&nX;fEheX+NuExQ*IZJ!8ol+-c26smEhd<1NXb z{lg^SV~<7SsmMx}O*7?ob3WtM#}abnV1kd`p2{m5C9*1JSq-9%x`+`KoAUWeFwnH1 z{aZ}X6X|IxZpPuyh;0CxxY@vC%S#9tn zabK8JMlHY~7xDKwEG7cpQR0fLwIHq=i%KD@&_T$I+255v1Pm0ptg zFzuJe{9MpU1KihbodX?(gBm=%^P2$qdbV(jqZSMEt!TPD##Y_&-h$PL;jwZq*bqlo z;zu1xp30_G!DE*<6r{5{dG(J;1>72L!wBD|Mg&Yg)Q7gR`KE2Ng7cz`{6{3I-G5F_ zAUzk%vmf_iKf@EcXLx(c%VTn{{*r#P7!F#9vg$2Wd+1zt7`342in6%FCh7Xsg*S5D zmVi$9%b_`V;p*-SYelz|#Vl+Cc@(IdnErl@@men_k#y53j4WG@PQpY-_o4`g-gp>-4f|>9d*o%gaqetjq&y~ z3jN`9co}cfSqVNKz|m<^@7R@)T+oA#Aaz`d0&!dQ_wIn*Dr$6Lt+ZZ}MJNSkCX6c+ zd=6lmzoQ&+G$>^}<8{>MX_lVStInCa<)sqozXOHRXK+T(-G*Uy%ZXHwk@!tqw;DG7k5IN;t0_`3?zlykMomJi z)n0|c5T6_zePH1EtKA}rO0`{UX?Uw6y7uCU2X;JfI|4&1$EC!41M6j1YRTi(LwWCp zgW&Pt=x*{F&CZzbpierAzZx2S81}QS@SuRBX6w zeZMmQV0L!IsY6|lK4SC><;wGrS-<-6!rXIVUL(FtgYv4TXQeuVtUQmUO_?tMY3EV< zLohQ_m?eoe^7a4L0*rbtg{<6yD-hO?bYbK9W=c&E&Yb=n(!jIIKpTVKPvZ-5`b>BT z?VF%3e-N*?Qvp{NJG{WNHjsfPl(v%0t^I~St~Z+FCVIY#JmZr&31P{4LfL2g#_4zp zak8KQ9XdU&4sV(m`$EB$`fW8As-zXZ>+OM>e;hDjZDS28ZF&1+%NB3r_}qn&f~#o5)lSj^B$Z>T_uDVX5Hp zLj}h0D%p8aVWnBqx4CC(Cb-kmD-|Y^csRlFb$bR6|DG(H<^qt$K$^5gfn~viJ#KoN z_Gae;^!Ru$7Up9{keX~4Xch!T+pUA6seI2Hh(I;q;82d3DRer--HuCK=#Zi}Y z#gEwYbxwJFYMd}W`ZP;(sB$lTUTtv%aCyqUHE;W^8Gz~|eLO7$I>#C5_OC>^eGEpY zK{ide=>`)yW`E`8j!Hi+GYteWlT+^Wp~zT45b`%F{xeaN7Scy->5oaSN z`BS#$Z7X*}{B)2F9*4LhDTTJ46!c#-tnsD3R!iLUUFYah6$TU@=lIF&v9Q4iw)j@B zme^UV1?#h6z15V!Yq$KsU_}c&*M7I5&rFqKd+mV+F6ILlMC$C{w1E9FFfYL9Mhx%{ z@?n{a`GXY)7O*eZdpLPHe|gNwtFCMG>Or$}#ZE|RSI>FN@$yZ@=TNCor84BNmuu_? ztRLL5u;uw(^LDKJl0%GyM)U@v!j5Fu;mdtv@l>>y+;^xWx#eCf<0D4b!%kJ3?ZE{$ z#n_%MxNf)_qvwV~)Exdp-Ye!S$b%AEPp53zm3DO8oZ)vy`gRLYhfU^`#nTD4&2<|_ zcQj)cKh?3Q{-S%1S}`PHXga7?tZ>DK0yJhylKSJyfEE8bkgXDXK3%oc3}`%jE|WZIthksINbOCVa(3v3DP;cDu11 zPr1FSK?i5iZFVdN98Op3e0Fx@CEW^Tr0W&+Kjjj+(*wVxy(L{^GsG{yB?WETr_^^C zM6V#3iWqLLjY-yVW=*9NbjBC3*2&5`Zd}w;)Wf4PY^`yE6W+h@55JV_V(+yc+o0+_ z(cYW+G@8}?q%?23uH9RBka%o$x}G@Ew(@>6>X+(uJOkkA?B-n?imBELg?OcoPrw@b zf%J%G)Xtx_c~j*TaO3_R^wvw7o;LFC4Jz zSjncjb+2;ScS#PHiSqA3db#1FdO5vol*R+>q}B{Q#oUP!r5XHS@*AxvOX9#Kk$RHK z2+dBlah5yy#t(uR`(+>a-X6(2=jOZFmvjfapdXr%?m8kB zwsf>edt{qWhm?Wp)>q|KLwM9Smyvo50JUNA^i$l=@qKJ^RF0C)_Fs2Yr-z0?G{ytJ_N&`!M+e!q(N21*7mIbAb8h=XNeC z*r4$YA>m7L!4mh9m*zQeWm*HPra6-Ga!<}^&f2gYYe^CItJ?=uuLLj0DtY-4&^V_P zG*h-=6m8LihlyWL{nUY!xN`{F`EmKJ4BPqvfwH`zl`(c^VU4c(q*!3=^epZC;0p~0 zljS}p`I$oKUo4;z2T|O)Qj)6x;&irl?(DFwBwmb}T9QphibtK_5SDoo_ciXyQ1Dk2 zVIOE|vu8M%+SG3D=hn%Lbc( zBrU_eG72VbXU}hBcIj+Pd;$M}R?%=Nd7sfUr;Kk##8KEgl>X0 zXcs4vS5em~qH;kp)TcYIFpAhs;wHs{OzL-ViRT2=UWb?)M1OAY zBQ`~~WZ`|@CL^6J{Zt|=L-73fBF_sVos&MiHJ7}Anw*C!<8m6Z?E~Ya z>*EV?V&+{=6m4#7ZHv!W3#V+%t5LxW(*rvX$iBhCoHa8(l3|+9;QhD5sQ3o&;2l4h z=*5aMh*=Ax@n*pgfSF~2boE;|fizp@+{k%M+!=x?W2w_eP6{1s7Ge#{c71-7Qo<~% zotswv1~i_C>ipa>pH*)m-f2@}T*o;xYxaR`J1j}F*5MemwdFKD`ouP>(4a3@m8Fk9 zcx|M4Qyhl}j!Uc&>7(Ay=9GH$2@U%AkIo0N!~)HMw3P!@{(_xh;0_3ZjwY9`9h0=k ziT2+X1~S!ozh9UP{e&RO2yQ)hFh!xA*s396*s86{W*k{dcrmPPTfB7oSpiOsa_3=irT;E zah2vX|MbkINs@}L9DShZp#Gm_!JA#(+j4Ns=s>a9zUU1oSWFr2-zC4_Yu^961P25g z+OGu8O;*zgc)bFD%3b`j=?06QM%1MWCg~VQS6p`wN=yw-LxT=WOgYW%)BXC9U!E9` z+vik4b@%+C%vCnrs*i5*eDNWg>=5hxa8wNqA{ME5Mr7cpYODHGj zYDEQOO1od1G-ni_h&TJEs%u@9LgPSs(R9xTig{L?e0~P7-5ykXUr=SD%o-OmeBWy% zn@Ud8tv`57%N^uHG%U0iC9q?=w`UDZ59o-{!=k9+*;>b2<~Q|@ec1_3g=O;C=c=&z zg#Rq`xBloy!E&hraAEp0A{I_7j4NKTV+xGg(n4=1A`$-dS{8qUrh@0%<&v7E8|Ews zofie&$?*!cU5&qf$<{3LP)@zMB`&tvf-0Q7=~m|8gg!KjuqZTJo=Z5FVJEc_G>)xc zMSiff*Ydu|9>Ip6->5gI8wZmW3W47%y!ypnYdh_10CwXeaq9X{tig-T;Fc*}VLBM6 zr={GZ##^EGv(SVAh_ml>clEx#Kg6V1Q7bYq%J@*(!Y~a0~gy+U4rWW_e**%B-rfoqY2byjAd1@eSfI zhOr-Jzy;D^BMviC*;w}@A2p1+oBGyuXz97)O^Hhgc-i1~jHt3?Yo?!~)Q3fCOJ9G) z0j8q3(Cfx@>t5#Rk!B!*0yj)PjOE)dFJ9?tb&K>aDv*PmOE(CV7%ZXxzU=u3CSaUW zm?==Hq>tXze71`Exa`H#mH$POz-oeau9So4z&0MO+Q}eu&np>6@;IB2454M!hs9&Z z8gvDc3g45lFn2Mp|WTm#FjX>Lgy1iXCD}(;g0U6zfR!H6N^H=2F|OyIM^K8Pb!2-S`lzhw5qIh@Rpl zVM!{Be<%&h)m7W-v9X4m)Z_t{kn=xaQ8R(}>ZZPJs3(F|#+g|oHrsaA*g=LZa2mah zD?g9EhUa&1H_(k5Emri7o{_qOkem>K6tH{#%Fl*<4LqJbSsxg_yU+={gH*`YyN@<8 z3f2A1w>IMYv(K%qNR`V!cJK-uU-Kx%E?L1>{tVwiIfH7VKea)SjNzCoOYA>%JJX+S zb*gf;*^58EdA1<#_IKG@itj%(3DD{nC85+|!4qykZRrSuSu;xLRVgF8u3v1m#jXN#Nd4ZtKO zEqI&io}ej^`$o23Q*~9zp?W5c`$WR<$gA01@Ai6Y^Ucrs*5Tf_u;gBk8b(~x$Ulp{ zKqYb1|BH(ixv@QhM+fD}#yhEP1`n(5QlDP>1bUXCW*RaLXHme{oxnmcPOlMd;T7%y z*98+W)3S_=!s;o-vkhd_hS&mSuNYa3=uPC1ifwn#?@+H~Htl`<`B!xSOo-^EYL5og zI?p-8yFP-+i52d!Oio;#AP@2~>1x#*6Xqlp9AxBm$2j>d(-zXX5OB?N)rj9@ctjQk z=H1(_9343FPRa00?qA}#R5@x7C64p>FYk?7oNo zmEGT9!?LBWGV{pSAnk$&PJ*H3SG~PH-S582x?ibKF1n*iq3{ z$J29KksrOebMWY!1qK}POBWSzZD&+Y=A~_vQ|j)s5!RxBlB9P+T(GU#SyP@qd5wEO z64VG76LxC)9@;a-eKD=Mb~A)U$@e**g8nDmI3>Yh*1Y2f!3mczTQ0d`Noiu$N8C3a z6IMPyn0E0_R_IN1e$8qJPMzK^O!`?l(x2_rf1u^$ z@vms3JE>e&YD{G&Z>Px*6X}9E3^-il`&R3M>w;2UXwR>(JD>B`yKp%+&(&$>v@N#< zz0*0%+1PXZ;wNTN7&}x&zG4Zr)AXqf2YI<~qpQ!OpeWyk&p9P60bkROvE#&EW>0A! zvy_XYbMgFBIr#D)L=N(=v4^Wlrp3PpRI)55CaW3dR~?oL7j~%hLIQH`LjC%BauhxH zd;l?K_B|mJPUg==e}{0~3b+p;L*vfz1HIG#TE;GUFc*D^%`PIh{0@E$?17?y%+H=C z6oX2^ z-@CR#efoht)Jq03`vi>Un{T_AoO z3wP!v3`gzXblu0U-6VpA#iz{rLVx181iBB7KHvYno|XJ=d+$y;m3X4IOyqHNdd|I) zjEnFg(PagDmtBq>K8Ud$dBraDxZ}kRt&mhW&vOt`Q)NKq{j&l-`%+CNT|4XR%VySv z)J64Pe=G#)%CI1)UeZ)Y_H{bL%7cR?yA!|>>=k7}QD~|Yi5wkQXl8qma53UmOm|=8 zINU<@7-)g~?Lh+i6XBZe^1>6}2h@`(4j?|U1vS5aO@G_JCgh&n3^!tpQ?BDtPag{d z&$qnEZ_yXj)9G~f((&z$Gk z%#TM04W*k)dUFl#G2S0gi>+Cxgc!c{BKLqd1m+23dqRc0a0Dj|Nx zIzE0qBgVF}Sc8zzoRnzNd#ri^3&Wyb`0B)FiZdZE-g5(cjl=QR$8AJFu)e7pDM#;@ zE3}wfh_y-0b#occE#bd;s4-U=Hm3IJzPpbK-bn#C(rdV`mI<>g!Ky;{o`Kj8h9hFv z7y$uzZ(5Q4Pkg?{7f?5!SN`{#&xieg)(ZyLUy-i=`tg0f;t0HNBL914|3}pS-exHP z6ZyVD`|p4DfS><+QRXD?d)3&#{{xT+-Z$_6{kH%5|9j{>LPt{%M;+l~r2r&!?hKml zv{$aAfOBpCZ&TR7n2NX5E^YsR%Rs(dvhX=N1RF`23bcfC z{CrZRtRn5|OV)|>ujzSJra9Cav0dk@-PBo+>W!V-iClnGZJj>AA6qI+t!~n3sQeF( zlt?j`^CyVEp0tEFfB#~S_8v@T!w_!5Kye_v&uK4zq9*6;Ke&+AjFKhq>rX~G_7<@8 z(O=ffK1&0Da~#1pb*Dp^Jvca+?1VxAS{#L*Qu_S}f`Qy!kfa~@ChmLSS{U^4h z35RDHm+r03`5Rc>pZ}*KZBQOp`A(jx|27tiCE=^$5zYqI#GP8%guO_%{J)7U`N1PTOSBk#N*bnt z>1Z6p+BW8kF3+((|J}wLCh$HO!L=xu^XXb*(tX6l5Y{tQp$s=SykVp@GxM{udnJ(C z=MI&;VegHe|2^8nModHmxn9P_dvn^#8%A6+gKKV{KqrFr-|e6^V&ECa=%{Tlbi|}P z7>0)l=+{jKD}4WB+;5Kd?oNg{_uO6U=_~8bQtMF z)%rhx3uJ(inFY(`daZq_B7GH7bk^3d>Bc#L47D~`WGXeE`bqya?j5fGJ%}0Ix(YX* z!Y#SO!U3M@eD-y@UB|D+2mPHjpMAi9XC(BTaJUW*gj_G6{Nt|V-v!uwgrWO)!bU*Z zJE7IilWkZ&o?mHkka*cbu_div5^2n9tTty_yx+kIuFFUSk5aQf4|34}ci;?$+dimu ziFf}4RzL@s3j*+uy#m>I_Baq@;x5SBkFHYKg%CM9|IXzQPzMXB00ps2veC?Ia|((- z1$dFxDWp7Ntxt?U{*yZab>lxczrSW$+D3WzKH!137%{`ZTZkR0yW0LU2c|Drh9aVw zU->lDJd3#fst=7kZC@k=bAz)LXBCuQMkb3)52e!J9G$a*KOeaeEfseicqp0>MSU6kyAq>_{S%kB= z%9Y0zvQ-vek{uUVmD~sx@B=NW#oSQ+eDHq~Bj|wNK5(;8sNgqM27?0m_n;oi`)Ce4 zigw39$Fe3Z^y3Kj*m9k|4o^Cb%t#=B@AKp;cA53%Y<+X3`C4~<^IdI&g|mt@fh(ED ztoX*|u)br^XNgr&mj1Bx^#z;Q==>EUkMb#p5Cz2zP zZJ*_`?IFW7W|vNEcEZb_^Y%Vu*{teL)>d?!kV=``}Lo;rgC^Oa5r?; zMS|h~iF7dHSHe^@iYboNaGf~u#^vZ5g>z?jr@b`Gc^YY#D@`ojtPII9;X@;%X_k*M z4A$t*itDfl1bO>Q*rR;B5QWCtb7@7IvST9994v`gsb%GRZ*4Ch;I)8bWOpWDt?X@c zf5Z9K)0zWfR*IrRp3=>(2Pv8Sz+0O0==2*MP$Q=ybE&Yc4eAi z#F2F4!@;s9Z&;q)y-)-6mt(-T2w3OWDBe`6y;iI{D0#l3LLj$(PxG|K`Z7+7Jj+2a zFbRv?uwYE}7HhcMR=Cx02`AZYJkJn(DbqU2%oqDUwl^Ir^z4O z=BCX0DDMzKXqNUqDlZsB_oEH65DjflxK1Y*KZIv0rIZx6ZmFHg{vrNoq2Y!D*W=W{ z^IFR%42Le}?O~jw@e!TAh^VP8p#b!Ja7TvW5B$>c1!mYqAM|Fh=1s^OR$>Ci^`uaA z6sLi&(czJeB?x!hn0;;$ks*f&oQSc9YJOGhYl(k*N8>O}d&takAHCgUkG4ONK(m{( zU!cj`Mk95x{mTg6TRTfZfjtyk(bc;;1gvHpNw+7ELZl>@fa$CEfMp1=@^zjkAo5)$ z_iVtC*lB4D9Xz_0O=ygzz~tE+(O4lks_@x^57QF9TCaJ7=(w>%9H#`I>N_}LYEBH+ zlIYq)_mdFME%Rf8>3nBWVs00uoen3nt+4X0(EscXRUuay{ZlW|3^os#TIUOz(co(e z6i5P2&v?GwB=loKNV{yjwLBsjjitcaDujYf%qFCS6g?y7>DVZPJD~=>*ZZc-GI&w1 zTfX9J|iD$dF=7mEqg*}$7uDRfLy4+x&e&X&NF%9$-5*G2++$u z{G1gCdAoq~-*O~xna5c@bN+0-QCk@tmF@X#k=~q6|2NhUcpPIDBZ{&!CeA2#vk1a( z1g!6JjW<1_fr<;=0R-K1D9-l(!G1@fMuoZ+=HO1e3pbxIi$i-A-$eXj4j)%OOwHN6Eo zX*YN&tJb*6rS(M523)SR6>GKsoC^VY?uR|JAtbkfe!iK5gT+sperk1YoBh>l{B!)s z8n_8!qQ-sHRfA_9;=Fn7ClnYMeBv}aVwU1qupPTNx#r8&G{%)+d)yn9oFWf7Rt6U%M^Fcq z^KYzs+s4a+DL$&ac53Qu{yB5Z2L?w<%<;HaP0erG;UahxS6TY<=JxEt_2~`*W0NZ| ze#4K|m5htV^=)&C?$Xcuc)<{ojOO{~!4w_;ZnGS*OY3+zv|F zk{8|w{Z2hFO$7n1u*x;J^^~Q=B8_Gu@NCRBUDGw7ZuE`PmRQ&xQ>f=NHkg zBk4?z19r3KrQxz3PXjB6V`XDD&qdVd0$3wE@Lk@(-9jv|1EE7j_3;OH8O^jOQ;;(m z&-V|sJxBM;hhDb3A$xwlVEEhfzI(JoUMnM)vjFRprQqgU)}(W-PNbthDfTZR&9|R^ zAc7A`Bbb@NRek_p>;~~i%kb_d?Cim~yM8a!5V4qJh$b9QXC#nN-gBOOI1O04p6J`k5ezF^txI@tjY%r$THye|tO+Pj`Klf9?nwtk=q~DP z)zsHIRG_g_Q*m_l13kq}79;(<07_0VfweFgcF&(TZuY|MHACq7zp#WvEtbzzadU=k zo_k}r9|!qGb+1V^B#P=;#>nwcmPE23Z2R-09&Z{2O>Fs5jsEaj?WtN?!3tlP9!~cmCs9EEY&4~Mt+xT5<^Hv^ z!2Xe&bTjswg?Hl{mKW0AxN#8<^aAvVP_NjWVf~LKlAaw;^P$L!pEBux z2BV(R{b|cD4+F*Q%Xwd7Q@ux2IGTXmoxUTk9YnAL_e0q3!{HH|=YqT(>3b03gS+ONb=Fmx zUAp{?Gt9jLZa*7+G@+1Iu!MEZawr2c^-9iV%Xpqwm}}g_i~azWR}}7t{Z)A^pjt*5xmSJ=YIa%qh=VnDQ_CQzs;eoz z=;7h%1srKx*Mj2CKR)$Z`wA(Ag0l)Ta&~+c&MQ|#6ztm=W-K1_v{g65D8dQA3xk2t zdAOLuypXq-3-OL<`<=3T4J;FlP4}Z3oMJ9e;s2xQE1)v>wVr8FKI8gPJEq4ur#;z3gM+#UNCB59JRW~TC|1-IAIJfiE6yHFs`X&UY>DA*4N{Ik)paK%Px$|cj2q=X=+L##lKD63&YMV7*$`Q$^Bn5M0} zVD*{a+Klw*#KUHM@rZoFliy=PIHRBbW`b^hM^ov?@bP%si#nWwD6~%s+C0I5`RJ0` zSqO;XbF;or0xp;#`9sbYFqJn4Tg-4-7a~UOBqLd)H_a8Jnp7+st#pjk$rshxww#|LK<>Q=Q2TlSrk(7(sy z@APsCut$lfsPe6!y=~JS;;A(*tPY#WsF8KM62RslK@4KY%wm-NNMpx?TM-6NB;J_d zw9#kcw2bcSeo8DB>O2IRjD$)nxV0XHp**n!>CyS2o zbx4u;9&PnOE8>bV4?KdI$6pOOB=580<5%oV@#8@hEE5L3$6rgbcIn2X8*y><;nz&h zcQ}F%wmTq`J8U#U0To3>t}pHj`Hp#|8`&5rmj?LxmG67e5+quy^4E_S6y?#MYy-6JUlG) zyYA<%0N=0MZ|^p6dX}g_^Cx$49mL!Woznc*5eX= zlH5S`UasmT3lb7s(pk|926Dnr(`syWS`iaO`y7_upCrw2dgKzU5ycyWBDT5e^qOsA zcdc*Qm+29sB~7HPuzP6oA}l4b;l&$2|DH!It`mYh$~IiWiaqjqb28M^(NKS3&x!rj zdd`eLG~8Y=+l;4PjeOz4bvnX4YIbF&fK7pm9Qc<1(QeX|=N93$@Jvc}D)j+B#Ms*f zC$tngY3NOn`mc%gm5tB zfS+RbXv>ThZqo>I$37yXw{>7uN{>VsuA)IaKh8;%>8N%5ne{OBS4QM3GlYqHiQ(_! znIpLu_Etoftvn(25eI%HVU-4%zgmDDZ3AH_H)~%pEW(l-dEu1!EAoFAFH#ou93AC2 z!&{pt;fhrN%+do9b-TG}#~g%#aGfnRMBy7V3zBzG?$Sopf$EGL4qF%Rf7isJN-^H{ zi-G(6qn51EYoeRm)OZ2~VWW?ln!c<1CpDOS{kI?N;2>1h4R|N?uQz zLpnIEVUtDGTSgiT(d3!w^kGogf*oluPDVp>*=avcS~80Wzd&s3#myN@px?-L)! zjd$VLo$h)F%wX2rzVqIn2Brxn%(fq?A+{KQst@${-e8ThZj&h4eH1N{#)il_;)Lqq z+~1jY{=0#J?)BBe-mL(*vNHc9B9nP0 z8C;A>_|helT4hFz8zn`bSv>h$Fy{4w^xaI6>r)&*#N)a|bySob=weW;=Lyb1 z0!K2uFWvVR{r@d1liy#;K<6Wv>KI{Gqv;#PjyfvFmt8_gf7z-ZSC#w2gLWp-+NAJt zsKyYnW!0CfdgCSd3~;^nJhq~q;_`3>0#f-=X8RLLl_fT zWo-Uksq1j>U83O2v59vykv@pk16VTeus~`q>ND}t7fe>(MI5K^%iF%kN_d#J&oIHT zVO7EQ6%UR+MXfbhVq~h6uRlqSC!cvezi)g4%QWRT7(xR+J0fEw7e9P%~KZTo^T_mEg3KhYg0KOZXIqoDfM(fCj$S z*m1;JTAU=-ArbFlsp4YsI#8ITTBcCHDZEWt<%yuQSySGD6+CG2Zj~<2&9=6&|=F!W|jWvZ`djQyD$^)Fru-Z$(`b9-l-^j z^AmPJB3mJd1{oF^4HLpKIlY8q{x76Z^T)Mv<->!9hbs)^v$v3)sO<6U+t)o4GFYA5 zVAp{9$r1SL=!r;F%romDM`|-7Vn?xmeNplDZn?#w_hEuzZ9=k$gToPTpPRrQM}In; zq#6f&ZZrv-JPsTVz#nSIl4kg=rmhzK6a@2l(BnlW@-Awn(w_`#B+c6WQE4q3VS%d)(b5C;wD7M>BUuN2siiXKx-MNTErHM zdNp?X;8~;Rcbp&G1aiKLUeaDvnP2nxdL0V4m$oCi zsIWgZUYThaq-?DCx1)=0^!s>cz;nKeYTyb1Nshe2Nq&D!V%j0_V=MgD)C@HHx5MbF zY!tBn?i`@O`=P7&=2?^M{=lc05(^?hM^q**Uh~g|`Ir7^+X!#{tS`j^U3x4mE_^O1 zz52fiytoa$9!@~0nzp_PY|>%6JY++{_;Q0%XpdyAhF$Qs26&;n&2L>S3Q4`*o{9_LYwWP>aF|{GCQO8?5 z=suh;9nolh^ahv>og3MKLG%?F`#)c%9B*^BzStKL`}Z=B=Qq!>`=t%9GjZXaJk|@k z1jpPA$u=gnxmm|(+s0y&K4{XC`5g>a=6%Z}IWK(uuO-|A?Jzg#M_ZDM@(}MV#nQ)9 zwD56R*uXns`v36Usj`C+C0{@lQo#MM-28@0O6nl>#~l~3&Tox!Dk{S^XIE$9Ba=}O z$gl^I(}bzj8mj&ERi~#U1|;%jH@azZ6(a*VyQmt(DEI8IRZG=%?639cN)<0}U3kuY zIi*NM4&pJVWPM3)%bc^VF>dA2Xe`mXA9w*89#h*FKgyM??|XGp~#GMK%~pFZZlR`aK#z=71(Q#fe9AyQ3hd(*S^ z+?M*ADfRvR!`VoL(fS13iZ}Gv|1hQ%@D4gju=o{MRg-jArtaoyvXZE7S+tGMJCmVm z@s>gVn?o&g_GxP$x))8dJY|?`u zdqG?ul7p-6BIdtV)&ht2Ak~UiOEu8JwP{Z|ja|DS`0Llk=j;6k-cS3^E><=Q@(Un= zyQkP?KE5bY{*(G+TJW$iL|Y##TVwo_=3dTlYO}0``HOD$0bdu51l(DRCB>G$veENF zQG#Bb5UB7Ya#9lCs;t9kb{>?<_ZuOBC0q0DHyoETNfT!Ce~OUeT}&O)k6(R*6XDCX zA>S&vXYJC2jy&($8*lmcS1v3BmX7A}VM2kLuKELiQ+mv5^V|y7ut)vL-#NG!YoBPr z(&N*jq4dnBV2M)^BNYtBtUTTMS+z8ah_D6|6PSOehcPCl;=dJ4J zI7h-YymzMMZrDd7vO%Wn(uT5dL)h|i-0fBa;aUg%HLlO=YUOtpGj|yNodWbq5Xg|+ z+f5&D_)ZXqj;LTX0V}QK*+PW^ZklTnbbSKvLwzcf`0W4>{aHxSW*}tPe?0Nx@4{fr z+bg{u?bXh7k~A?|0?5VJo9*i*iX0qqPqDR5m^8DyvJ%|iS$w0AKuvO@Chv-*4^y+X zew7N+GuLgsx3?Xf5XGfw<{#=U>L@{ZrWdkkE}q$x;@XnnEp_{~ z4BufJQQGTlFVCLg%vRZ^%h=(?18rRW9^$n<*==e;HdM&z)t+;5^1>WmB-ODv1^YmV zcF&~vF-pe%r6-`~txg;8Gr6VJ(oq2`k1!uA1pgA>u@%q1u3lS;Z{q3dSypb%6E;a@ zrtX-uuXaC;cHth(PHqpe zQ#m#>+888qcS?peYHIX7OpWn5 z<_N%^Zy86oB-J|w`Vg1mtD@~%-a~($TQ03z{3V)21QfO|d);JGGNChai1B`7(z`^VSi^EUCANeB~v0PzTc!9Pz*=Xc2Tg zB)dmKVGX!`p3Ry_u#-}XP@ zseY^#c=jU)Q2*k;34E&*)48E=UUlHeMCuz-%?qCTtNFb(h7}jR{N(spHNWNYdSJRz zJ*kRm(arCY^f9=aHyKCUq!UK_;TAX5AezcPto|Rk8;``f?-{t1VZ|IfLX&tNGOq|} zxYKcT_J5{y3}-6G_VWo-@Y|E2u$d}C6IZDJkpFs9bR9(whIkC-x#b7vwx*FNv#Lx6 zJdC^!K1tRfL@4;62Z|`Xyp|z-oHo}`Wj=tL&MfH zP~|u5-O`*_-o8JnZ5zrgLnsmVxhKs6V6e#^ZOEIqb1$(*!>MGj;)yn$3gufu3fHsf zrn|YMSzx4wtHCwxM)XXa+u=Kp&5> zS$Yw!>W1Ni4@1U$7IO^)kRzkyBJ1MW*UHu#!narTo~4TVYI(apP&l$hn+X7})=JnE z$UUf?l^G>C@y_!Xrg#iIh%>fX*Dgp&ntSA8U}Zd(#kZF*5S|Y!8y2}{cSrmW_r@R1 z?!9_Hn;<%2B><)5CSx2GrOUl51g^^c<-3({M7Kh$&9(&k^f?GbwDsFA|LWIix=*FV zDJo~Eko5p7o*f#_I1cc9o zn-$O#3`LLIn74F|i@lRk)yT4Le^6f=~fCkd5>jwMEB zp|`D_=s|#KezG{J;j8lU`t$)RJnUkwC<^4Se;(pL`kzZ?#2Lh$FE20FM1|W>+zk#k zSyi>wDN%Mf(}otCf7A)7sPrExR^dN4c(}XZ7zR_>LeXr1{>8fyxs5CVM5uT-F8lF< z__%CMh?v7Ga#mNfF<~4Tr84l|5r?m!+S}NSmdy+W$f{^=&Om=$Joz!bFXOAKq!a@K ziInz_j7OCP+f$uoWg~iV$lTYZ9hLv#Ax|&>2Is=%NNB~lIy64|QgO*3yA=U2YSr2j z6CTcC9s;|M#EP{1(~3$l;$UI`g64Qho$(Q=+!$VyIm6znF%}Xsh%UXbbd<7D(ABuK z+*r)fBOONlk{WT%kg+eDTJ;rd$2UovTA|R0#bx6Zs>l{v9F((j_EeMiPE5*1t-**! z^ac(ec0Pcbu~RNy!>s|7ZK$9~4NBRm{+a}UMqZv4@SQ+3ts>#;;Z7U- zv#fy`+AEtaOj*dsavH;wI%h~A;DgCM#Nb2c=Txt)CFmqzzwhpjOS%<~!*qUdVsw3H zu3kRnbfC-NQ2kbW3B}z{MX%jrhL4wXI|twR6CZB{Pd(@@h;Fu7t`LU=4|&Jj7ISR- zWquxbC=6maO^rsF5BvXK0CanF>skY_AG^ds(boFsiPJ+v9hYOK%X)~J@hJo*iM8ub zQ~k?8vqBPiN+$Pk#csi~)qk&81Ryr=MO{bz_^_8Tz*e*1A&*%-PmScX$G>qB@~g)D zPE@gYW}-Rm@J1?^0+KK}F?h86@*1<<{uCp;^K*^r%g;_bT6&8K=!Fy-)4v5_`a}nw ztiR+k@((8b#Y+M6zSjTtEE#(rMl|=Av0#X4hyI`oTLR z(I@+Z*AY8O$7X0J&!Bx9+c}uw6c6mKl=f`jRNlflN^Zm%>#p{}_Is zq>=8@QUvnk=%`Q*LLN8Lbrnpsv82}8Ac3OYp1YZ8vA9X|MD)BDPgBf2yWCthrB)Mf z#tJ(Vf2InUvF}GmXKE3-sY3c%^asp}G^K=2uh`cn7fqH5V#$YA-yI zb16177&}VK=NYa>EQwnS5ObtIEfD32#zMul^yX9(4%91)rzHKEi?4zxbKpO z7WNw)U#uYe&h;}=`75JI{`oJyvv=MYAqTf{!O zbj@v@h0;iHgIM5~TVb-Z6hjceaqe&v-8QP>rD#_FKr! zE6@|_1i60=WH&JhaN*aV;v@^EKvSs`6dvp`%ML{|ZfDlq5(rg|nqzF}xa_BodC+E= zB#ka)L*mv`d^xS@2G0x&2u#COZb}8^{-rhbFfEw5Bs8_={}4AxbrbBhsAoEIL(*Np zA~l6u*bgE8GS)!(Ah4Z_+~j}_q70v$y*u&e$^vUEAWt}y1ens9r2E|UXwddhsMV7? z%Q0Q;=Z#@c&vr~5>ptp4X3MBAS2ViQf1;|jQrIz5;Ef%eIGQnFi|d-HZ5|2`=2{IF zmKNVyg@I}KG8Oh!15Rq~aY{*ULn)yz6Wgd*D%V7qhX7``EJ@-WPNZl-AYNU8lIL3~ ziQ5>WuayCT(SPy4oPhAWy@*y>ADB~M6jDPhC_$2^M8QN<>;nOmfO$zXGaG#RR0`3R zC39#*P6hJ<7N6`wWp)2&+1s~~eLpDKNnNgrdS*kQ)k4>RAM)lE1^H_^uyAAoYNB** zs?!b~zeoOfe$_kvB1m^-l{i_@%eABl%}?Y!1XB{}-CZ`*euE%WjxEiiLzT;(0oYG& zjOZBW5r0Q#_Eu1g^TS#`DMTQb?^(-~=`N3aM{Ulq(qY$Pb?E=Gb#%LLPIXO)lxIl2 zIb9EyggJFHmedKdsADBPGDg#`+FLr%j3@fpUutBE#<_yfPo*|*OO80>7v>9^)@?_$k9iBAis{HDlYrkE>i#Bcaaj_aaRz+=vr-@@3#8+Q zHg19jd#z5+g0{MoKh1@-HKl45V*Z_uhMCt%V`(MI=LIxOF0p36U~Xd^3h95MwPbfP zQb6>sR`eiXe$DPA9EhPdgGw%Qro_4Lx;_`0{wk6m~pJ_8!?ZrX$am``3!!Bj;I7td?V8 z8IN4z3%8rs&lF`${?CvUpq~_q-|G?O7q3Qm*(Q3G%3qdF)Ee>Jt7LD z&k=$XZ7uF`<@`qnCpV{x$fk!hI4Fr?%y@vdm~f;Ec7OXMBsk=~K*8$4`-z2( z3tguqW`Kqp-INEQHR5-~iWZMS=jj?_hGSNp>-`nR3i|+jUWFIe@TAN!SO&1ajX{%{c{nmVGoz|VfcW)ISpEXl zYENgtqiOn#zbd7O2TCqcsa=o*}OS5%6yU0O@hwGSgO1PIdMLZ9>;XDDl z1oZX9)6m|6>*E$H2NUmZ`!w?NTNDrB>2DeZD?^V@BidcL?Wz&v()~@~dH+S-r8f2g z!a1cnYF~R>ZAF$J=*WtGe_x!hIIn4EK};e6`DINV*{=sK?N*AJX6K`b@Xs}zup8sw zF2j+-Gpi57Z$Whkt}juFeZKAGs*I<>gXWC|MtqPMyNyYg9ZfA{xccHPpIkL9 zU!4f?fsUo4a93Tyt^h;*<4d^Pe;>cUk7oS>_TjQ`3BfO;a`=wMW4on)yfc!06QH}? zdbI|lY#Y_(?X+@_SV^Ea4boEMb2)QDALsQ2X!A|~dLY5K`-n9fLxt=h$yjSg+h@By zY92+^iUGuhV#^s5t*;#GAMJcdrmfpAPRkByXa2_UCo?3>{_!083F|B{_VWCq*Dq-U zfYA#g#|ySPw=$EyMyHKKLVYlCl@1RK49NLi52wrF7M1eUwPD{cTA+WwRY-F)MJQ)b zt1UUZuMcppa};OtHgEICP*->^8w-s8M#*jXD||pO<_%Ap_vw8-dw5+H1GL@gLjt|8 zaHo4S8p6*(hL0W#Y7K(e=Su4Fgbs@WLFqDuPcgiH#LBM2zs)m5u0hlE;(Y3L+@MUO zsW~{!{omP-uCV288Ct5e%c+2-F#&cOZ9^>bhR;*}oHUerY+%B<}4JJ>o+j8T3U z!8FQi_WMWYG%8q-f|`1ukkcS{WkS2gK#-8(1a;8lISRDa+otQkNXqS>J-L>(P?PU= z0$GP;oFCR$YR1STz;D4xhbanMhh=%n^3}0G&hmK3AH#?)gNRW_(}OiHA=|mXwk{K< z4j-I@@A$?(9GUN7YQH1WvQ^TViiuLGjdlETgD3btnk1kVk&^R*VouF9Ya9(F7y@m* zL%@76h8;O#aU_<%*Z5wLZ}>+Gtks58>eb0_F8@}@+&czX2+x)#@$ONZT}-B*A4gpY z1XArzY;njaH1a)ccz8PglQ*j#N&@C;8^&-X>Iq!Ow}NJ7gt%DJ8n^IwTD<@LII%C2 z!z~*YB9Mf8V6g%EoA6GR&~)R*VILX+!(n=Wv4tXaxd-IWC!L}@dpV`|V`nwgVxz-y zh>*+7q21!L_9I`(3yj59FTB7boC@HV5PpkHmtquM2w!6;yxZD6oS-VDam|EPzVDA98i=3 zRGaF$`Zn|?#2b;uSAO4$34edRO#G@#2M5_jXjhF(r720p@dK^Xf&0q=j?x5sbwNKR z&@%@M(@jZ3*g%=Ckc< zWRMJJbzI4w>$WXhjdlR4$Wr~%m+o0Qx6d6TYncu29Y&n(hI{O@go+dVE6 z)#wlo<|G__D0{m*_K{-C>dm&SLat~WIK`=~1}X`IIe**a@0J&N%It5P-crf`{+=~J zig|50-QRlSB(S};dv@B&rW|?JJAP*Xpnla>k|W@Yj6#OtU15T)u?`&R)z9!rsJ}1g zoJV4-z>t1VbpF*qe51$Qw&64_Hlcz3>8OfC2)<|+$1Lhi(`T^X3-qXi+uw#3?66S> zXwi4cVn4x)$B0bolJ`B_&buBmAgNGsbWnl<1!MpSgei)%B8x)25doT)I*hr@X4cdp zfn_UD%~#)BM9YdCJq^9hco!*5icU%bowlk=GMEbZn})CGw}lHxK53>sTOn*gigB@1UZJCgg0Ux+GSobU?D0EO!@IRB=SWuNMGLiYhooPUxeKYvUs1MJaS{U7ROTZ;tVeeo zRy5^lV#e}6PO?frQ+7+jCT8cvWR(m8iwXZa zF>taKH!X*r?|T=&ZZ=kbSpU6ZmdE(1W3mo4l~_i$%JmD*l1v3Z2vSx4e@1(|5Yhw=^;sfJRozmQSti3Kklv zH|uPTH2+-v|1=*A7igm$~YXkmmdVTpF=ogfMD9>KJYg?1OcQuX~2jA!^ORyXEq zU%jQk04nN^8}>~9B?B;m?VsJX-@7!VhfMxFAruq zPJi5P(5325_7nYZ+|WS2kAXd85sDjT7v1}O0Gxd!0QAlJH6}l>RMQJC$9M^PKRO~N zEd0g#=kWYeRs)|l|CLS8?lhXJ`f>bcXQtGbYC6n2HC(7f+s01zh$!q`2S5k&6nThG zbs8%N{yGC^jQ<(VcJ^z#Bw?$!t6^KQ7r|sIB>F*R?LK ztt3eo5v>j%B{DKuevAa*H%GS~8(9CcNZ%8Zx-Nj%9m9KGWm~nLCX>b!2(S|xddkPX z`{MOF^T{H+kVH`SKox!ugptz*&xQY{4LOWsCJgAcIm2H6j?>=Flwz~)I;7o`_07Yb z@sJh=@iCyY?FVYxu1xuq3CLN;hW%XpdhumEwA&vJa9GW}rP^=$1Ty=0(h(;r<|duo z-<5xhDS=^Qx{=My@bYB^8J5=aSN{f7^kD6sGm4_pN1W@zGgJbszKGor1_I!ZkUpFn zzdeE8*%+6t@0oQ`?-$;(Q{8{Fxb_V8HddIRyHV%EQtuzD6aW{fbHnMzc{x;U0; zIHa3cc`K*Azrp;lpC-r`PoSNy7iufpRv!#R$Qhf=IBi6$xE$OrgP^Mw8Q-fe_|WEQ zi$c3Nd&w_rGQk6&I%ZVbZ!zWd9xdQ=d@)_N>P8M@?B!3vSEkchZg!E#p?~MYQaNKB zHcg}&x*4KI+|`MHUlc3I3{Vqu4wx)I z+YFBm5}zlu0Q)Lv_0-zL08hc5g$z}Sp}F(C3pdicq2!|9h#1_*pOv*g;?zt`#I%0f zYHJd~1@ij}v(HB^aQiSiRtXaun6eUz@ZeuTw^n_vn|}ubshMKp&JWMsE2y1IG)K98 z0F!T;%$SYfaewgvI@V@_p$B%mb$DCtpQb(D{IYK&qdJTX?+6;=$~YsKjl+sMCtVie z1jMlmLI5) z!3eSQ|8Wh42jclj>Q*#Byx+UzDPuy?tZkhJtW4?Z!90MVsK`6vl>E&Qi9EiiHB-F&UeZyfpV}i4e$Gi{2W#%RblY43vsHF;x=?Rd)wfdNg{> z2JLa`)mD+7cA~g|m1YrDHsJCVpoyApoBW7#&qFbt1b|V{9iM!Mi?*jD zvE1VL%Vrl|WiO~X(qwkow8wfYHd4r||1#ead7E$(?At!HAuKh&4<~EJ6{FMd{t$ZGlDmv2ak9TAhp4KL z24b}z^1_f3GfyTX*&ybYD}lKX6p#TuI6nKRxF9Jdi`aL z!y@4GjqU6GlD5)cx>z={{NAG7+sW5=i@lb{LJ4-H1YHHgmFv;Y;U+Jk!^O!>$4VJJ zo5ovHAc28=n2u)v6d_X(ZVe+rRAtaY`f@s-Ds|_+JOm~rzeo4b6II6wn<%@Q;Wxop zk*ui$Lty8Cyt^)L4^1Hu=rAD`st*vC0$3vk0&K!yka zf{10@8OV;U&D-I66-SElYvqc{#x%}@XG1%SduVO~&R=K@LM?$`5Zv#V3g05U9HM@R zaoHd82G$d)s~oYl-a4D=v#;ZOf;wVWxj%3Q5-x-0f4A$~^IIZ8?4aFbbj+0t zC)}JNIy+hc7Q(^nI3k5ItWC%oy^6_@44yL!u-^kZ=Gl%;^BpTm< zWf;ccg?VmaNh9Y%dh)9tHoj~={9g2--+X66XD4gwsa$);sXAZ>UfdH2=rLGtY4z2N zjclS{o0P6PBgCZl8UH6A;2SV3#zDOq*xj8njo;uNj|1PMAoa#bVl_@JoNjUlNOaAZ-LH8ZsXCHeXv)kQt{l;Tqy0I|71?`rst(;PC0VqxoDLI6;BSm$I&gQ##I z0L_Ea=O|rMK+S3;-3#3KveoTm*!At8SN0E?JOdBEeprby^V8M7N`kKw-13f-y*1tj z6z@WeBMc))Uetek3Uye)~6B> zJH=i0Y$Wy7_zo`eVV$zLT^kF3-jb#h)%pkn;pyS%Pu%b@Dnj6=&$QRs8*kFzq+Nb^ zP=O89dO0-cqLy&8{&f}>l8cQ0cqtA~=ofcC@4c$_Fi!AuA}Od1$WPYszNlN^9gUrLf^TSB-6jUvLyB>HvX=3tvLk%T>oFXQTz?E9Z=kszoFgY9QCI{ z7JC{x1-SL}OeGPyuHkx#pU4-ca0y#u{o>DsNziJr{fANXqj*B2@acO55}$~h@n47< z2tAJ8L+}ETqy9bT3V$d$=EMyM9;WDe`sh>;5r+7s_gkA{6Gt2eTlbC_&{MYG~Q?kmQ# zIML)5$LKCyMtEt(#y^Q>*~<7Q52&wl(OJA_e`;M6WK27pUaw&0F`Hs)5%#?1f!BLK zYxy-EHJG@ROwb3Vj__vQGPU8g=E`eQPq!)@WY;Dnf%WtRzLE{2P9yDmtUeGc*QC;pcN(CO`T_nY63m@l6)A;Gf=QxuNY`Vxp9Frho;+84CmfQarami1~PQd=K3nY(JK_KD$S~_J?Q;PRJd-b z@m4A1Pzt<+AK&f6pgl~qqz8!vkBOT=B z){~Xy9YpSp@AgrDm@@IlX4hRGZf`NpeB+#v?}_z*QYxx&uS>)d%Z?gIJe4ViB3&%N zhESE|3FCAfRJHF7`rXBS<=ABk>tGT}5raU00CUFu_34#+C2P;m6Mc!rO0ljThi7;v zWm}{v{pX-uuUI~H|EOPn)s)Xd&WJ0i$DQ-vN^f`h!)~uEQ6s|5D0{SndWdX$Sb$$) z#t9|3iu}JLXC#(W5j%U~JiZ>upfnoJ5=U#kSO=||S(^Ir&wNg>Hz!*2EupjT$YQ|v zPrLfGHKqk-mN)EMo4x<0eSALSN;Qa}f`AyfA&!8EZ2o^Q0PsTn2;*YZ&2rEh;*ZsG z8Mo1-$coAwOEo+AQFM0Qi;Qp2)|LC-^F5EnByL7fO69MZ@q*EU-Jj3m|2`2V*zS<$ z`l;Ms*rKTLn!v9CbP5p@{`IG%T354u_U^;39mdWCz49A(Z?2jm`jsgX?WyIc^FLRN zl@&XDLx7tXFA_(4&3OZ$9cxAMi-diw#t;Yv+=!%Z&Y-td6UCqp+Cl3%Julv+qxW?d z>lwv+$gWiWH6>+C+&#)~SL|cE^|s%D ztrlRpAOMSI58Yp(VMuf?+Ja+x;mcNCpnd?O91QpX4ubwOgL{r*ZP@5LDvM7;mQsAD-Nv0SVQ8q8s$;$gX{%6S6)96Unyb5 zV$X*L&laiBlz=r^TbKfVgUj&3?z{`whl>2$p8>{ykc`%+8;kEACKw$MLfigiM%Sis z!5PCp7Z+9F8=UN!PRjdy$k15vb^E+>zXJ3O$NAG`d!q0zH=mR-Wp$2+6_?emCGP!$&xcs?4C(amRhDT`d)j#%l@$ z`pML2M-r%9M+X|7z@}78C^V++LF^pM3Oqv?5LMr1Sio7#`{yh){LU;}{SLqEjtts) zKG0pL3)qREl40uuHIyLr00!cs$f`}`kcqvB`z3_W8n%Z6C;=m%Py8 z;H*DY_b6+R3agUhO@nx#a|FVSCQmvHk6*|Qe*pI(bys@jTw4yo)R2&94G+FU`({Tg zOO~Dp&eePWv?`ek$1j$C7{aMltV&@q2^ojFP-YJdVs=u4;Cst#9h_`pf20$Ny$ zah>Mj`LWi6fD|s|aRLP!3r7#i8FeP^vM$XBrpr2vL|+Ai6TlJ5h*Ut*BS5HMGLtoJ zPFXEWY4{9|g1`dBg}K@v+vXHaMjcCxe>zfB#DY}M(U2_U-PV+LyJtPQHI}&c-577# z<_CI7CZ@{pW%celIrfG-;U>xpDsoEehY%ZIb7C-AYyx{vJnVY$k}qKxtIG=f#v~wK zFVx1X#!3Vie-GBYVpA7jUpV7w1ZI#_8ayHb`w2l{Xu*ztH0HVb`cwJi&sEgSu`sB3 z+qAs-W^yXnl?#>MH?-@DzS!SN!ZH_IJP#)!Oz6w_JD2h(g_hW??$H&B=z6W+ZS`(; zD8Z}ozjXy~?$_>`UsHM_wF{9%vgUFGv_K^^?Vnw1m*RR*<))7)w-4B-zglUU0O9pC z72UWb$$}Cxks8fA+NjDg4y>cbyc?MEx4)xXEE(mnnZ*#Q z(?XKY%t+-#=^}-SNw^eb9VC_-(YFNpSgwDdN1h?=AkCyA{r+*#R6GPs)0v~CHM&F( z@H56Iw3gmkps@>tsYxbsQ3IH^M56;opOU8Oo+$?r;Yu_Z^?o1O>M=2J#IMA?j5YJq zcsX|Gw{{;9@@U4^2=4F2jru2NZstenF!as69{;`+e!go_R;uzdfG$t741J1kGhCgX zo+!#r{&VSj{6-dl67CJ=CbDmU80gdA|uz8tH#DC@PgEbrOAz(q|jE?lajQ?GeW^_f#b3@uX_= zV|2(+p~>5Hms~T*Pr|1!h$l+GwyF;S+smffpXxP3)Rx$@s(Y}J+l0ii(19!^N(39r8Ni5zD_k|pY-|%1a%|3?vCDjY+M>=B0(P{;II7? z9pc`Ccl^kO4@r`5^gXjR-1+dIprOe6n4HU!W*!Z(YtAEClMAk*1Q9c1dW66EiE#!r z;^h#%^Y}BWtsf{Fikt~@U-b`i6<#xeqXxhLl{qQ`2E}r5M1auoH)83tGt$ujE6~_8 z7D#+|HfS26XTYf{eOG3Xb^5;uymv8g)7y_^H0~`cJslVS*r^2s!J0-Ni$YS zHR)=KDu3_)S#@B-DvuJ(4&~{?S=R3$5OCT|^7Z%8ZdP*5W+`1) z?}vI|KK*XjtqDNjC?PXV%$3XsJ;JEyp2zMQn?1%PyrEh1>eQJR!?W!-RSVPA)zX7e z@IcaDUif>c;i>?74XP-#sN0H}>j{hlnK@l;_JXD@YvI6paZ~OP81EUl0PmQ(`_Wcy zJv%-+%_|Zq;as2lq)v}t8KL`|1s@9VW}OT1iDTD~nd9IMo?U;(qp0B_`w|(dFO(~} zTbb{9fcWUWh09`Ciye|l>KHJ9`ezT~r8IXI741Pv;IL@JWq-v39{SBF*k1zR7wq`Re&k`Cz* zL>lQ%N$HYqknTnVB&EB%8&SGTM7ojs_VIV`^W5(*;(_z-nwd3g*6jDyxVu{cj>adm zEN4?+yTac1zmP(YD2-zA;PQ7Y&drOnDJiQwVkeKRLE9dzi7Sw zm>|+b^xZNA0hzx5Mg^-l)`T%Thu^P9w^ina#qzpOjxjQgi%OQHcRVhHLkN-FR`H69Tp4e!?d9_Kmdi|Rm zGJam#n);&`^(zSLjd?R@RgLo|wK-THQn822t4I-iLQmaZH$w(OeKxn`U*!NNAx&7Z z)sb&;G9mLiYd)io zIx}GI>2&Li9Vg{8Igi=8ncFRhE9vN2I?f4gcRvMP zM4Un6vs>#W0v*_AoW9zw!UliWj-7dQKecCLd}8g$(}g6G^hh@Y%-pu!)p=4!(rGv@ z)i8e{Au?ADI$L-_XU-f$M6~Vc^!@i&E#?oOo#8F=^dMMwaft8cFlJpota%ZUHlC)M zXgQaokTxE6chD3-(ztu>3{uWlog+h{?F2Gl<*rX3TN(<56c^xwddq&n$7frbC>FEVLvI#Bd28c_*if$Ru zAWNh-iZ`%xb~f??7qCQx`@%H@??M$F!!_1PpmS(=*>)_G1HWeKdFvocWrfUX3F^cx zy3sRE1C{J*=IA(ciy>~vSP(O%l{OIdIc_i05h)0JID64PK6c_M7VWTRuY~}j23l%f zL4*M{&n+`;o?SpAF=j_lkJZOMmBtZScEoX z`gdYo#n=hw@FqLQ*3D|;MDUJdZGpQb2%usJqo1*a8?j4|C_v1rD|tNV*GTUArYcIR zB9|Ck%mG!E0}dV_k^@222oNLUL3h)^h1pkyEdP`BE@M#-kTi?0OowFrQGjNKs`U{1 z5QpTeJpJ+L@&#;8a`X=Q5#5bIvS1{^97IMS!|zKF0*a;>jbzLQZ>C;QX66?@+J@(H zv$gG+@X6J)6J~BRqY4;ORFZb{1RXfV*2lp*O9-wqge1C2pnadBCgw2#Mo8mJKNEx3 z2W`_8q4U!~A%g*Evw+51YNkKiO^&aKjJ00@}l9)g8xGSG;rpy|4p&$yAw91SKIO(qX|I0u~uxpI}@>IR$mh+9H#{a;T}gnT}5 zW8UbbpQC>HcnAI~O67;%Yo`OTznH!$Gf*1QtdvPqba!yGdJVCc#2LQ|_&*}=<3pA5 z4GKFtxb`8Q2Cd!sO*L*sP|KQ~x`Saa3I68WHndTF6kN{^@-`f=@7rykpekmldJ@o4 zNl9`ls%-rs#!iRFv^W$%8QNy+E45w@#Jyo(an8sC;z62M;Xu`J^hg3VvKktKcXLc+ zByxDGLBM!`tQSGyHRRQwuTY86$959(@-ys7CGA%T?|hlWl}iJzLkD_+&O@v*(2;9P zcL>Nti9qkMWlOGj=E&U4yMX=c z_PI^wu+e>T>QANX(OY#^3eW4|9Hjuy7A~pPq5YguzhW@{@VT9;j&Ka z&))Z8cKD?>r~Z5T0$NfS)L{<_ zc5Q!&`J?!DkHbT#>KQG!2gI1lef^i$+{Q#utW$nKtfp^2cY}jQ96}n` z3BNlb-%}%+_n;=5kk?dSdsaoVM9vHE6k-IA(hNp|8?sfJN#q*4gFfuTKr*=q1ukRWU$s0tcg;s1?1 zbWR@Zz79d++K$-`Ow)fm1i$cXPB9#7Gp=eKCJAH zAPlHpwd@=;Tkw(Gcx?HP{hkz91)XIGlVlAwwVYYLSe2Fju`841#>W{Nlu`b>f%7Gk zzfn^ZIKAOl=i5J^v(nM_MGu8NdX-ggjFnEs2|~KMtMNSXI-BuZeb-`sP*U_1RSHlv zu>9KDiwM_`mV> zIaF5N_NAUFi>Fg;{UXD`inSEU$9BxqrR);qDlb~QUFS|-Fa{TIgbfnb7qqw18!J15PSXmsstGw{&w_p4Ce4Q08+`O)&v zy73yOj=;(c&#E2w$!R2f#~0*|D(P9otAdf$Qi7&HC2Z4kwXN+ez5Bf(SaFm+ZR z8JRk*4A%omqA#VpJm8v-+dnN&`@XJ%JsWR8WGghrB2-8j#@KSi{|8@5lufgeYZ=U8p6u;+LHb1=mz6%U{(8t)bJ`X`?GqL9ArdKVU-$pMA8Ou zG;e;#6ukf^Vu0nEKAZ9t=`_hMy-YGFTC;9#2?w|{WvZ;*g!|cfN3oE$;%m%uL}xb@ z+oexNe0|XEBW84nm!%Sx{j{mi26pNBu!7DS=;KI%_SaY{%mXI1)7uI@D(Nv`W8EW-H$z$@j+*PC1;HkqYEd_P-5|4{E`*b|w7|X= z{-l_`qpwXJ^X7M2c(iORb0e-_1wIx&;(Ed;)3hurCmi?$*Gy9Q;5ZpBqzF>P${o$%r9=TG~W~wpz4{a8edVA z_mAAlTXJ}KY=m2;=pt0w1Y)%@>GGPO%c`-Wqf94`pL)to168HX9kJAp5GH^2@@WF& z!ZQz?=^M}MF>E>H+FH(m_EYeRI*t_ltn=5t8lp!9XOW)Z5=q$rumPrQb_j)eH6jE^D||H*xX}X zd5OTsb&)drYI)b!$AOnKokOqGGIB(erGG2xr$+p^>^pblI~qfjas2( zC?Qqjv-+b{+i-o)^3>v{>Jz}r?LNWw$e)~#{fN{Lim;iDhx#S)CZ&USDl+j^)dNT18Sf=1#rw?3nDPW_M7XA%j~;1 zmLn~H>`hIa_qQf+lVOkdH2%%tSo#rQf7!tQ0mF6GB`Fe0#?=+mtd~A-FnP%K- z@{nbhE)>khf%<6#u3IkQJG!hBq11>$QAlNgfzsaF``k)A3C&GWYReb-Jylkh)QuGc zI1&RXc~R2cKdm!KEFfKSx^=d=d5xGm>&b_tSomzN-&rVsOnr|5zkwLN!tJQ*Ki!`l z+6gwsh?N<#gc`aMKKY}VdSUjj$j;kIvumaCV;k|nYPhw1n*f)t$NF_dO#39Xz*A8X z?4|)saluLVzDWkpshVx(bsATF~|lWc0xma_m=p{d3z+C6(a56wXx&dSjk@= z^==-yb>ETb@I@HQPsD8ohf-gDnx_Pgm%hIqo!~B(q|K%OaSESHolZ0ao4Nqzq0xqd zCrSO8HH-@#%vADCZ8SRzbhf-SA9~c#P^e-HqcCK^Y%eZ6*Uz0{G&GyvOQ)ZVxS<<- z6nqvcf{Q^m+RMB&C%LzEFI*HVLIZv_O~vV`(eE8rXczS!$l{>KzMC1R-Q)(_oD~20 zs}$HTgaUQOk}?@tb>X|(QIUYs9a8y7*p+j&U0)Jn%Bh9uVvq&>IBPk{+4}vg}6;Af>!g&0Y)A! zny}IG^oXI`($Z>>6e-5|?yr22Mhl6~qT{+21^5C3d1*KOYMBwvC;6l zX_C6^mEux+aWH8nQk^Lavy@Klqw1Q*>CoFnru_6jg7_8X0v<5_EeesPe>IZ8Czs~_ z+~?4lL^M%;*z?O7=R-_TpLQuqjgw`w(PqNf-OjHMvUrz_2H`C`l2U-9ESk8(45`S! z>7HdNI`|DWS#XZ4lFJ8ET}*rT6%_{>%Ium=!;CmTDz8(&)2Xq3m7qRT4Wg{2V5^F% zHs%L_>Xy=6H*|b3N&BR?Xih>+ifwW#{V_il!;kEpyfDN@Cb*-Sr=HiCZTwQ&fzUEx zXBk#eq?2zNG@s9y-}4+3UAk(Xa%8XS1tmOiF3Q1(rauFvE=Uw^M7`|t3QGG5IRIeu z4tqtNVUJAvEssI}G8ya4Ax5nkvYt#%(g%(v*b4TG^s3`7l`?~@K>JF)pld zn4FFw-{XE(or#_lb5~}t01T!$XY6=Q$iz581LSP3nFQ^UFvg`wOu8il$hpavz0q=k z{g3bRtoso_h@uLZWqq-n){LdgYwvOvg-nI}iAJ5xzr-a3VXd1K$!zcUrPxu3N!Cjy zncYn_vqFX?{I)T1=3@zL-JfT`N;Mm7__d`i-)paAM9F>sp^e5LK&ywJcHBkt_1fsRCe-F~~3s7MDC-mMPjxQ}EWp zY#Fi+=NC6Z+(nJ;zNorJMiHXwfsaI{dZz}=x#(qbu1bC{FupgcmkVumQ!D}s;T zhXIhrl08}S|7rmOBB9SQLtT1UCOPo^rL@O&wMB@OMk7R~-P1@r-i265itgQZmS}x{ zJNA=<^7_oZ^)!f_!%g&9YxThtd5P8iutp6eCW42}$kp6`yLtbO+wAQL{zn{XZ{&J>!M-H5P>VEBaO>7kJ~&ZkjBY7+l5jEHx^i2qWYsm1Qz z&yBr$f>apEYByDP&_tqU&b-M@!fXU=?Y|X|1K#fMGCxHA%}0>w^m92aM=$ulm6 z5B%zoL8`a~MuMZvf1ex-fz-^ghUwA6K(b!_60OJ`wX7?rd(eWy{qG&f4YC90+Qcq> zXpSiVv+}|9cg;LB5}H>O&5~X%@ZL(_d?zhQ>h1)Nu5X+Dv5lDpnS(OSuu}hbFj^h3 zkKt3UAe+^S3)C+`I2Lz& zovj{wds18JkXMJ^ZQ=(XnXafmvgbhiBH!{8I@LBz2dv1I?~@?^&0M9jLp=$IO+%|R zgO%6Zf*AMQ(#Gwr4aA+rRnJ`zMTes`1o)`C3Dl;)q-oUMo&-`X2cm8<2rB_pmaAugPf%x%?)m zFIm>wH&|5d#KtL2{>}tP>LWoeAPktrnP!h7&K6nzD{1;a?WT4Ila7 z$j(3s9)5Gl(9NI1Fz~ccA@1azBlm0e!$}v22tCt!9CyOa@__)X<^mx10l3LvEWUTz zYk`Rtk;>X@XI+zaJS)K+?bt1ane114G)@jAq=E;b=S`?YYDFz6$X43wUcwHa`gk}-&eDxO^YhC>(b;X+ zfmAv9QrB>*f@Gxe-=SR&2H}9_V+c*)>^eCvcl}&?+)u6E-{-_$7hnLnC9Fu0a5Jay zukmsHwEi!j`GcKDddi69N*$@mslMoo?#@{EiG7Py9 z7=sz+C3tPf>6;p?Z=^g`$rKHldOy{^hNNAc7ERpJu$V#QRK2QbfBJvT-3gs_d%;a2 zV~@55yw>-(lv$nBeYeyb;W@+RIJP3lnr;vZ5` zsK$u>WZ!;ecrk6m%^{=xqw$LeqxXUwTjF!={$Li*aw=R*Q=48TF>>&OWp&+6YjTG9rli5xL!^V6outzpdf&Lk~hO_Q?z2BYhbb=19@ z7+?TlhaL{*y)XI9Y9P!H$uD(moRR(U%3FQWE6C^mD*Env=SiA z0iiE_4`hQ>!Ti%;=D?JZAW-Xgr+YNz0V|448_$J>M~oKFjiWHvDJ|o(lNM|95?Llv zE%3{>ozQK!Eu@PtEQ35FQhV~yP0esb@;;#+9QCd8SjEk8{Ym9f53sKA|BTWq%^DN8 zVa&pIL2jKP(BumCjVX?_x2V&skkmxR;G;G+0j#UdU=SQpKxPgspD20=OFJ&J?*_Vm z>r{bFS$DMD$F%0>iRk*Giw&U?;FQI^h=m?DesRS|{Dx1!<)QoxX?Bb5JtufhZ@vI0 zE{9DJcth;;bvz=3S_oc(vKub;u&F>s(guminp8#20PgUR4dP!Y_6%gCpR`TndlB@6 z`^Gz%6+Q?A2dD-!C+6DCY#1quxY>?V;bK( z?yL&|8gY;ZF@9k*`c<-yG=95mWub@RC?U3;f18aT$!fz{hN^>!i$mKJgZ{1B(-Bof z;1-|BI&&(YKy14e_JwYn@;xAeOm#~;lEOY}Pxj74#?pKwJe?t5+c49U80y!}d|@T{2mM@{pA)(tKZ0C^MIm$iCmuFFTmNTr(s-|2XTI$ok0VQgI=aW7{6x_6J5LF4!jL%* z0O;BLqn~7e*K(C)ZjI{qfCqh}F-^)x z^)5i*8D5e`wL;Lvp@N2}ZyiLO${(eYVS*sHw8Q+z{!b7IJ?*&A6Q4B-&L`soPxb5q z^W{%GWVkLuM2JyJxtHg8_x}e8`j5mlg5Op-iBo_7^<9BW=3iisQJZb7q9o8MeQR_u zy>#KxDfZ$$n^A`R4eHH&qs=!-Ipp&A6s*WNa?+~fhx|RBjP;jV{@dkeldS+)#Y??6RWfetSA}S|A~j`rHOO%>3M>*1P*WxED8D( z6~I{54bL5^JCSX;REzp}!0QEoFY3W|cC|T)8Qvv00p0{hvjT}-Z^6lJo--0Pb#up} z7MezZ=StwTkvTV#kR2Hmm#~I$)5B0((N5^GNdoNOZL)-6O&{D;31SLZ-;Ilc8YEx( zBvLB5<6tdw|B4QTf}B|4tAwFYXneiVC`!5yl|`kzEy`eBIn&LI#m(R_dc0m?a9 zDT|U_NGqBHa@MvUq`=wo!c6%tYx|np!qt4De{f}?mijfP0BwAAoYVxwkO%_2FTzWt zf180(yi|9Py|O!El1XYlrWZH7sO13m-vDsBEL{x7Ou3#ABwda15 z#pbF_g`-&}Q&~+3D0$? z`Li_nO@4oQVNEIu5YD;3WIDN8FUoors8_Jy%`zH zC1lOXL5V1?EJNhT*+~kJoEX2*DPQE-+XuFkO;sp1PUMxaS{P2!sJ%G3*v$V@hZ_As z2g*o$e(;00vlGCQ7{V(&Jb2&gSdUrm*9bTOo6Ai+WFPpf$w>kb2v}snO}s7|sK&}@ zC)-H192PdgE2jHPVWRA60#iL{Seqok=l&P#Jw)8GQ&*xs+N-zH+NPg+BjpZR54Jt< zJ(oSA$gmMz6+G)NR-j-0xzQHMpO!coTHdnh4e-johVkgwGS=@uS!>->!!EDY0JPn5 ze}s3kW_WG%3RV{(m-E>v=XB_L1%jsAss8VwLdCjwX zP=PcVwt(aYvY4=Qwib`~vF|Zzb_;0$41~fRZcPH`M?L2T>2*I%R@c4V^a6lC--?L# zvE?2E&|q==WG;cQaw-MgdNQ+$#k6Poyp^?lnvI*L+ga+3uO1taM1AkLwzs`woCH%I z(0t&-V~uwUDsgJo+!x5<7m8z^D(Ih&zeHN_zKS35 z7Z9y5m7D_rPBNKhhA5WIZ}+*4$lJcDg@A;2IsE0N$xS@4d5n}{nk>teE$r@n>4^Z# zI!5rm0!}7-pEv#OpN6w-|%)HbYfVj>UbT{ov@l9@9pQZDCZ=< znq8%qEVwv3G;j~|osvF+rxu+Q!0OOf@v?(H|Ph?p48fpoa8Z3^}uhV?gJC)xA6 z$-I3hlURM$sit+GNPHj~Q6PRW*{r2Ff0`p#8-FjGlq_{;-EYv#xy~&F zh3W_Vnc|tUm+EiEwJrDq5L~$>(Z5V}Ai%cb32yCA*#!c`tuskdN3`Fs zn^a6JQq;m`>K{H3ByG}DThddpCvF|dgCkDM+Z-o=v)Ajr_`#sf%jV!#J`{zGOXcl1|J;gPyIs&*jw)Ayep+LHmI3{dIhsW9zN6nWfS)fJjUe*$%B$ z=DSfxApm4S(u7^!HGe|oc#aia)>d+^fu(Wc+4rS?|Lcj8z1{(UDDp z%H*xHht3kgYM(-CPgwj{7b>Pm?Zq;?87hX(p^`}?cH`M)+Wh94`Q2KQLDIS0Zy=0b zg>Hkbc;^-ZH~ACyd2n3Gh>~$|$6I8Otju=`F$rJLV@tp;I-bUM_J_YylGkVN4nLde zl-YVM(7?JF_4<2QG*?SZZdd;~`Ih8VU2f42%&z&57GsVeK{tKGpfd9&n`j@>*k8F- zHmzW+S)A7Xjpmb#1z>_PV5Z?CDQ&I$5JuT;I9jWT#}5oQ;iCL!bDXcp)X~dN(4JM_R_{JH-K)Kh$$_1uVCk#Pzwf(f z%uYLhX=t*tMCak$d`Lt3*H-t;Si4${c56|)P=}yKLa$-`rW7JScrfL66>Y(4;6j(5Oe(e9#7ii?`jBbGg`v-5mJRf zYOdTnT?{LESgG%CvYPcmFK7#9Bq~~gQUIBX?Bt^6VVT)^js?=BY7oS&h#|Twt@085 zuAcUGdX!G#FUyG5bNmSGDXD|xJ$fy4$WxF#@}oSK>!7^;N$rBihhs8X22uZ z)QkhgwwQPnBr&g;Lm;7;4cG68ush!JZDu$Vw*Wfjjb1ecIP68CdhY+yMKYt08u*jC zMlKaD}cHYO^*)-0y~^7(-7J~XNv;vQvF-vW|4^HZl=AGP~h(L9o9gT z%zv>rm)%-Mqb^uPB(2^E1`piRcPzLzX~ZqQ@;xRr1;fox$)W%&J6WRG`D^&7-EP|% zA|#>=!xFU*lJ#!qRlHwFx!q6v9p_gKbn)^rX-UtJk9EzVln9eh-@eUiKEW4IMppjy z1|STJAVN(bRkM-;?8lp;NeSoz=*1zwwycsgRiyog9$?O!rm&((+o z(De6fB*27VA;6VNR(tNlv+b+CL8jVT9~hoqa~L1Jd}Zgpv7BtPB~TDH(yrWh#GFVQ z>#KpzN<(Y5+0xlUhkVrN#S*0BpU}=>JAVdtfxzit|um63})nz&|hM8TIs|M=n_@m`s*rVT0o>wl2G`b37;ANVno?!zS zmc>0#NTRHz)&$=J*`qx3@-r}mU08-7OJQ~#gogPbeg5owb0ANZQaJARUB29Ok887* zOP+xhU}4%9n21bXJt>CkCt+;nE=^mwbiwoEXF{|xrMf^>rbbEji1i5Aj3K=&*xcBy z?!6NA$hc;HguzKX>SGBGAWwmgtIyVY>p*$;?wg(-D>F+;8B$kPYyagctF}C>i7MB; zPcPs^s>~G-8RopL7Hz-M_d)+RCg+7&PXy#~O)t(`;nvO=&K@1nZgQeZq(P7a6);wuU(<{#IAYKJ2hyjuW4IYa;Bm z)19P-r!IfmWbhMD$`d5|r=xK$RMmq`cC*zQzvc0>{z-kmzQEGZqXqtL+>o7*ki6XG zcPNt{L|I+bb;9iHKU}E#nggE{IJs7eN{}dEhK?~aN=ruCU<}xT((P&P{;VZy9=WzO z<0mtcKu~CSw;MxGbyPfOX@a?lu1M@Ne4=%c+=Fdw16T>g@`;xUnbAJ24Kc_NJ=T|X zWt*B#SdbqdbQ-h~Q%6xAU<<-!$06)4sJ$Bs;$^J9-48m^V)c)WYGycm+pmZyR!k&yD6|#Q2 z?DOSy9gT71FIKTBWg-O)X+a@PiSUQ9(G~ydSZ|_eAW^%#PMZ^Op06>_NomjPDVVP{ zg(Ge0SfE7DPsy}yZXW6H@5l@MZhd7lY8^uZN+7fqdXpLrR|oS(Ga{^BufZul3xBK0 zPwGOBqQ7gN0xA)8*;gTtpF;mpdP8JQ{u^&&$^pf>OoXaW-q?CF5MZh&Kh6XM0IMP{ zf%u!R+UTFgfMR^Q~oAMkxfqEg^NW950P{9QlO)ZQ2==!*7;-JG|6UE!ENM5Z&YL1u*2{|08q_s zl_aCVuv^GDR_Dkim^8X%X8e#Tu_ zx5aQw)`R(Z+-Zb-JT%1(446@O0Yn{%cpf493Z2eONlR2#2HL&?U{&egUd@sKUga+^*`4eb>?a-=!9^bnlV!5Ns zL~B=Hq5Eg9b<5}n=iD+Gx4!Y^rdn33Du$~K643lmc_+uT?_RmQ{!*4h@u-n z#KBk?T5QZo1GN0yvzN{Swgr*e1|E1H2_wi!W)gBIp<16XCQJGG2(1Fr>EyU?RdkWE zMyWko1~ef1vmq<(fcU@pX)|N0t0*^LU?w|K;5=}5?%lWUa zLk5HflEnQ7N~oIjlIsjkmTmhzdTvUoxs$_#xx-KVn z)J{6;b>cHNOdbtdPRa;SMttQLiA7kuoMUDqc(Xer4)MQ98*;RoXHO}xs?9|~Q0+A-yLKPdIbXJAF%5DBQ3&r1SA zJSguEPcewYF-yHvZ@+RI4eatNlA39$(z3xD4%J~#=%kFewNMAkv;2KarMse&u>S^O zEqtI-qz6f+v#*{6y+!CYPEn~huk6=J&whH}fR z3o_$!yK;l9p8h1FP-^d!#bd{Dys+pygC6SK515mBSrHM7^iWn%lkB9+K+GnUki^bi zj5b;-U;27zEtBORl_dkD6aS-1MvjOIc|#v&Ftaz61{kZ3iCe6iGAwzmGNgrPgY?J<_{uTEEb%n%w0_1A}cF!qbw&lyWd6Sgam0tvc4%)|Pp{dnef zJPSU8pEwa~lgL?yUzb#V?^_z@8*llq4|m}sYlD8iTJS7B_Ci+Pi9jjk;1IEu#eg=yPI&RXpvn(W2O*`jH3#wcV}ANx5z$uvVQ2Eb z7zcJbUo`NV8x^Wv|AIv<5$J1qt|vX?dgR*X`3Cc288Q#%n#t802}&4Mi~hVlPjsLX zqe;ov^*jq&P|j%$nF#Gr@e}c|uy$eK{?G8B@XOklS}}_?kewYKY_z2{`I5UiFUa_v z%{eldBeApV;Nxp|VIVjr`RhCVZCP{N+%&uq+LDw6WZ@HbaHw+34#yN&@Oncp_-TXRTc)DVrj+md4FLa>rzT$wF4w=hSQ zec}A0WiI7}z1=o;8Oz#A+Jm2^O!E@yhDEbhsk*j8dG zDeL`;i%+od^ec^1g%YZvnLAdDx%t=Jb!#4%>=h8t{WsjgdPn70K7Eb1o!3dji+vFN zyDI6|s6Y3q$k3A<;?O$w6wuZ0I=}f5jon$C{?4M*4trB%?9RN8*M*V$cm+0X7ySxV z>ypX0)A}NZSb-iw4L?79C&52_9qQ>Jzh#6c+_Cs{%>VsTY5r-k5&JCj0VBGwiodY0 z_>!U?W^~Q4>1t}90OE$wrzWnC3f^yy!fU~~ax2t+1B!3BLiToxx1K28Uv%ziA%*8_ zevii%6t{P(pVEYT|6K8OVvBCQvV{>_4jg>`%oP|%!v(7jzNs*s}Q^mrq zW(tjuBXu`kUXY)2oc}6@K=gS!h`2dk-c6wBrXxp~@wyjHMoR+Gn}sQ^1bu8wXM5djfmj*&p9*@fkkQfUF4sTK2Y0_M*xz?V%;mWG^4HVb!Wh|) zAw=E}+>8%{B71d45z;y3L%SE-XCQIuD+TZJ$stAZ|LFWlR(p5K0~GqhCGjEt7PT7B zWqC}aWY~8n&0*)-Te}W9MT>&Vk=0SX)@$|X9Wx7pcjuUuFg;so`n)xaVi)U?_IiFG zw0Gd@>(i&nOYaHVtxLDB);nh;T@3jgy5764JGMRUH->q#znYk{;NR9^6R794Rd{`Y zAyr0yWzmA?dM)Cuz(!^E70B%4%c2k=p!SMoQQbLAAmPZKmzV;9yzggJ9(h>V%%72# zIt(9Lc8X#HQ_w&oW4d#LRw+y(4_t}kMrk2wQ|2N$BRUkHg^E+ky16lxZvLK}F3K&f z8%y>NEJcPTOr8s%>*9Q50jUNA0))zDm7@-sRpxtKCJrZT5HacozgkhM#1P@9 z4`)HgRfeQd%Z+Ck%D$vt1`F`bCCD-{c=Pu+VdNnk+81lhTvson2h{xC*KVF2=GIbG zK0Twnzk0~^^Nr4O!e#$5km~0_NqPTB>2QI%_-=udZ~O$`L-6JR7tZwstp*y&;(YP( zM&Th7)w_`YdQ7^H+#iF1pDrvi6Jx{>|8S~(buuWE9)G2Da*7ELxz9Pwe4aSJI%4yv zhtH;84nHY}oXbxXs#rd5x~vr6garzs2RZKcx~6l+xf6NE#2o^7v>7C%wJ0C)fZ!1- z>1@`StvV1Zva^!O&_|*qRq=HZjnTt5y{$;Cy6>IXwV>Fdy9bagvPE;0;L!= z&`^yY^Vu_wjEo%O5+?+La(zU~2g|P1KLkA?TETX{&78eVF z&4gzZlO=nl{oQT_Je8gb(1Kn&%Y*Kc(lFpmK!)CZ>CEtja_5Ue$5f8+3=<12vZ%+^ zlACCw5I6ky=h%z(zp;r#$QAH42Yja(K@5TF6Aszw0BmTVc<3Q;FkH_=C8VNB!2@Fb znmhXeYT4g`gH znr@0|);(n*H9eJ;(v}r4Wlruksq_vD8I)$c?SbyTZt=(w4B~WpZ2}IGQRx@0%j)VD zjawlfDkXyZS?DFv-zcoVO-<9E5WoVEyYd})w$Ub7-F%Hgbo@w>54w=oZGBD?_SWnJAw6LV$y$w3xS4obOm8M`a z?wr*`rIM|#Frkw@3I*y5$s81XK2mH^NxQp5xty*{8IjQY=!cuVDT;%?MtgTc*e0pR zU4oSd(kao=Ks1m zGT-|_P46lI`SM>&k{~xj1;~4P*?(}G){%yoV&8n~BINY4PE?-}$j%f5*rJSph@Gqo zq}XHONzD$t!Sc4+#8%3|Z%Z0b$_!PQa#&#B)8#_^$w_mh^jv~_Ck6Z} zPzRL=Av1;IWTpNUzYEo4afi2+Y1x9`kPQ3U13_1#sKvM3WNqFT7uf!T`E*mk#d*C8 zm6z%r8c1yMBVE2e6~)UPT?mjf{Q28V{CTUX{OWpg`V*>TW-Oy$!kKwah2MM5n{6)F z%(+2AV*Aazpr5Bk6X>p>Z`d~AU5$bIW zf!40iaCNDajE<@b$76a27{~-WBYi|7uTBDtr%fL_x|D)JP66o7&*-|q_x|h7!PLDz zTIu~siVlIO%Wo5PDh&NF7Acg_H1YYR`1$xbX#9ZqgPdruX=goMTLOE#nhTrM#&6yl zP$ajxm`^dmtdJ>u%r)g*YIv|l^OdhT?+pFM0(ReiL}#*V=^!;7WEDPRV`t_7$_qCH z+20o%=Ojhn-@ZWA>$5fxq9Azop{=smW*{5pPVPDwD-<*mEt;2{5L?GG<8j^POFc^5 zyZn0EJZScY_a0LjfItGNDSRz!1S|{6eSG_NcazU?tNrGB z$iiX+@(v&ihIUbj(G%Md*Sr5B2!D9s_o=vbPJ%$}4MlGd;j7oK(UPbok^}paNhy$Z zK>x+bZiPh^kjgi%RJwNB+db3V7_Za~j*G`98y%U@g71EyDb=eeYf@XbHPcO$F?Wr! z)VIgfM{y=s4K4N4dy_NTHXHFZ9&7kOH_+-}y4K5!*_za`VEM6-E~ci85l|d5K;o4- z$j%o4>knFi1VD{m3=E!D*qlHp3`4K}UQ80%ak-#|#L{I+RvEIX*Ww@PGp8UmSIq?!iNzFQtQs_ojj3y3i?VAJ=29h>uKoMaE5BK_I)** z7gm&0N73E+yROAXqGOBsDu(ld_;es3{~+h5d4uMX6sN%5V~vyVX0Vr%BOV9?xT1!X zV=A2b=5I^)^#uX8iQm1_h>G^BOvmTOA#$j5FGMZG4bWDR=R@A> zKaAXd!sWGu5p%D^-sjzw1g+ShH*n}7^xE;Z*0`4>aNW1h)(!ze^jF^FZVH9yukG5P z=}XBRY^0c-YW*{yMQCWLf9SPD4HZmtTIlQ6>>4b+mB*JMB7)V9@~M0cWQTg9?yy}` zJWu=<%aymF{iAyBexRUD<}>*%yQAb!R?x-)w73G5hGJ(62hJ~839d;&7r0awNj+PvjI@66TQh~76Jr2nOzFU)SqEQ zHj6BjWKe<9z%^Cn>N;;YW?^kF#0Irt7$Xew_pnnpdgr2#tU2wwpwc(>BPI5<7-^Wr z?!cT?E|XnurWw@y=MPTl&eyqql%Kq`U~BaN4%jx@}9L70~a~-WdyP zB_N#ZT>k{Uj=alEID|bfrv_%SSpnI%O4t(fs^Ft6D2zNFj$2!r1VfG8w84V= zFAS;7%$xALwv}3}zZP~vfcCAMb{C+iZpT^Wo?;Sk01E_X5#0yRNwD4aQZAWtd|$4 zB7$R+N3~!XuJ;kahXcx93O1im8htjBFNngb?rCYeh@2+ii$z0)#*pF7*HS3rOD%!A z@#Ezr{y|C_-o2Ain#9#syr{E-wN9}|W+9;2(x@jZecfxZ5hLq+>EZSQ#a|vyhv=nX05%E}n82pBiK8O;@MsxgA zCmkWGp{Y&z%Tjp$1yN&dZ*2Ce)onZ3AcyX!wpOzgpb-VAasz69#0Ut!_2V6VxrsAz z{~8PTA6PS}iu*H++i-ngg6jk8?)OPsinTILd;^z`gW=Uia912by;PR zJ#|`)Lw*>X1r#4J&crP=Fh{M4XkFJ^0jGKk^+g0ANzhQem8a43R%H(MN1Q=`0Gl__ zXIM?7bn@uXtC)M!^BnHeNr+YE+I(+C=QF4=bi(3__6A-@CZP=rFdj2M-oUkP!tvnJ zFcxI%uhiCCi&79R)dOwz=thRf0MWY8!TZ)wdr$*^S4>ZRm}!mptv;ar#GSTz|H{YS zdB;3I_QGO>h9oVc^}gF)0A|162gPhF-aO(z3F^tC2>xFJ*KiX&EQ$i2b z1$^T}OcqA5{PK(ytiTPF%EH>4If33)AlZ8}qa1c4i-IRLe(xj%n2c{3smIrb

f{|OrO$1~;4}%oCFR(o0=5@IBfgU1QJtHjke4&vR!-oUv zCV#SwOWFaS!59yq@sW=aSv@>uo=Je6%(M9w*x5018kv#~q&$HgUN`ml)Vc#S-3f5* zngaX{pXp+~)%@e8x-E37DV@7JH&+@seAk>oOizegYqkhj9 zO9H*kfU+a+NQEs`Uiu<^)LBMZFfR6M|8j($IEM-c2qj=o09o{m6lkMzk?OAH0+`Cf zAS~O0=xkz6J$0`U{nWr`5MP8;Of0|es#0*I3+=JKz9qmn1{XJG2{8g`vH-U4T5`=# zC9=rjS7Eu|ykeue+C!(sXJelwnPj$W!gaongjO7vN7JuRZTaI|y3;r@0^#%O)9v2I z9%J`P+wIxuhVBgl^+!|9m*k_nUBnqYHk$!4Cb^uQ>HG2AGSe~}Get}0V_UE_(fM9p z9h}K_-rYf$z0-L#a(Xjxyo4#{L4^>>Tfd_3Gv|ORzbi!p{)Brf@YX}3?(6D+47D10 z^nY;~R%$>k=AUL3>UN-M64t{Xs5@A{g)d7P|8)00tQ9}j{KpzH;I;u4J-CJlRw5~5 z)(y}ByIi*P*!UFwBicN+6#%OT)Ms04DIo$S0kjmRJ)VAG9zZM60fk?EnV~0mgfx3= z2RFy?=+R>A>Ai*>OHQaTwhL)y*yE?03j%H)r6r#3kPkwQVXufdZp>uPM;&*2L!v27uBk1cU^jUO2da zfl6f<(;)w&73)(w;-L$0SQdKG-R?WyifgacSL52PDJN3<0M`)LSRp#c$4!wg1JF#9 zg+N4uN}M)vIC0W+c3RT1&*{{*ko-Mj|9?Q!Ofx4NGHVX4f2U36QgG0{OS(`ha3_s| z&mE5)t^f7N-tp(`TROI&vCE%2diS+T#VxYA<=_D@aEKlA=bi6Sjb&QH- zq3N0qXi*aR%^^&~9dx;8#pi(v@;wGA`-%09c=`vbP*rNi{TSAS8*f-?+Y(@@AZdlA z8C7+_mEE;o_)k z?Qr~GHY|XeZv?oP>vV3J&uIsnT38%jurgd{;Y(py!G|dXjo|N=ht!AEzx*m{p ztu8(nz?%BEZdo<95>zVm07#v`VsQreA|6J zP~>n{CgL9}tSTZ{{JF2o_QAr|o1<@bhQf4uq1_v+?JwX=dx0ZRXm$600S7ebEC8mb z&Ckafc18xoJ9Gs+fRAXn`%Phd?14;zqb15>=ruD?8azJcopVx&%=Wkem?)324@ZiE zfYomU&nA9Ij4BC3N}0+59EhDJ54vjo3O@XBMEkRVv% zIIhXyzH^C*nk$pXj_5FB(Xp-uuc_7h%+otzZ1Jzi`1(rQ-G0AT76aWthfhFUK%5_| zNEmI(gv<3`WI~MxdxY3r7C5-^OuQgRtM4;8i~vCmm|&nVb?cNAvwjyz^g~OZdy9(( z5XU#SvLZHB-NPHEw4V6eGxvT&&=ahy@jCY$mdOk;tP%N3MEVf@yzX`RF-kT7$Z(DP zev_DIa~#Om4>Y*|jWa*ri$ru+TY7qOpid@$F`9o~)}|V46-Ha!^tR))CR$n_*fO%2 zyK`$OYCP+=dI4vE#G(b!s$L#U2tGgGZSCRz{yiONXOp5hf9a20Gq>V%d$uH!8<;oM zPnNsRdgXRqFLhnP&*1w-8HQ1h%{0%=xZ8Ui{Q55TVy zRv>FSj|mi`0|b7bV;jQ5jnsaI{U_J|&IY7#?@n43b%6rJ2^#b{7WuyRV1lN$L`7tc7ynLzS@a6Hv`kFdUxX|< zfBGhJ`|88GJRoEMLRg`2yj~;h7J1ntx?s_l^k8+7_H)UsUwFhBgPG1KxLv$+<)z<-P(BO zAsdKIWrl5XS8ZlE?q)cRZYXU<`x^LS~UCJdy~1tWjy zL7w;D`nT=WPSTL`f_A+-FDzVCNoE)Br}51>L6b4I3pH(==NVZ}{E3__dpNw~o7)j4 zBoBTZ_n*c>qGmWN*K3b$(ldlQTY;G)DFjg9 zlkIuzx}sVAjCf9$NvQQXDvw3(ko>Q@st_FgCcolB@9|Yh{&XLw7P{FPG@Dt}9_F^TSWrpx>S-kI;$0g=ucx#~YD{<7TVR!XwSioaYY% zl}&d8mAw3CkNx?7@fF+C#%fDE+}{d%Z4%g3KxpmBc?BHE1-uC^_l;OOD2U;fB=I@< zTXs|JHV6D@G{2`k@*IVdTv)9BkT_zZ-$=l6I!GE3ygdnWb01>qBD4c-au2 zYk$Il4b{TM;xhe6B>j+0ax%l~m~Ral*Z-iLIL)#v0J_{^kEil|nc=N=fWogvH9Brv z3aHYQ#O&X1(JEbB4*J zq%%>a?rx<~Qlkl$Lhx%XPf1?3=N6v$s)O7_9_Y#YW6$*KLoDW?ys3H_imMF^zK4re z>%;1(P(V4l{3|)Va;Z){&G%8B?Iafv%@LCHOnH8K32+^bI9P zW9it7qoy?zr5Sj!jkSyTg=^;f1`UfZPkW%=irfj}8$OA_NczOqPGtT?f7|}4wJ&xp zUc2Z|cOZi;e1~?)rvg;3Tj|uxM}ztFL*emc-l0&tpGLq>??3Q`z~u30;9Aj0Q5~*V>dDUJ z+}&-t4T}DOorYfc{^RHc;{fSd~FAYq{;J&V9n--^vcP+-SQDM7D zr}$!tS(TkbiEY*|P2MGrW7coGeA28@w?C|hzJE1q94SUfV6uFUY?ZX$; zZ5euyxaNRWKrHQNuSUDPd96&&mge|@K5t+y1UHwuz;HP$AE}xqN4HRO zp;u{y?(`f)y6#q=$onxo{2fWqKZQ2AjWfSJwV}B)=lo89NU+4)GNfC^$v!Lm<`zAo zMRLn2HYGY*TpGtf?Po9bUIPja&36wy3@`A`85q>^F5p%~uz#a5j?bCv+@-l9yH8pq ze}&}!{D{KueuwyR{&CU=ZW&Y(cjQtj=Okf4vnEt9rf=GMp01YY^L(V zPAyb29xdc5rgAXg>0M)rjHXRpU=8#D4Q&*ZRykhJ`Pu&g)_m3Wg|x?SqP{=Ym1SE% zZKg77lxmA&xkb@_cx2jgk!CRJ~E)E8~z&;z5mkc}%`R1m4hn^_ofR zF61ww>wB0lIGNRIztj&l8B#h+{`O~OQh(dmb%FW-uE1Dk1K_stwd z5J?_IH0Aez$kP7d{M@byn2gl=7_e%kZH7-~qp~&!Eb!7K3>myUOyEjWQgjq4$(a-%5y824 zT-!$$U=b3-EbP*)PGAmtzEmVO3s(Hh*_XDFrkwkav`YTtk~nrr(1{g=`k1PN>RhNR z3tUZ~T|40%?>KF$(}V(8Zb<$E(6*!9XMWE5J)QFf1b2`37sSt4u?OR zWo0$jp4*|1-Cw>OcXeBR*&+Vr91+da^(Jt_N;7&{d04o#km3t~8fmWt#O~qJ|zyH!G;ZOP8Wxg0?bk@m}E9ARz_9 zo-jn4TWN^1D<5C3X^oJULv_~s$dQh3!`{M+1-j+7`GnvB4oI(ftUiEj61xW4D_ z;cmF0mC~wkSh7ETxaV8+cY{Krsux%kWJzEmLOff{Y4W`90%3GVA85FMbDy06UrLDo zx&C}X38*hEi|LXD6mL4!=l$9s^+6)s-7U0qZ!1nj(Mf`$K>B$2%S+n}I-D@~bK>~( zlZDFrDA>~Z`@RzxZ_BB?MNB`F0Fu0vscq95~88p7DQ1&D*{w#29L!5t@W`nUD$8|vNUns54%OD(*o5U%-FV>W%PoT;hr z)A>;O{cY|$E7@_Q_LJQy=O$<)uJo)V?6K1z2T%<2bqt)RdF$OJ>uLt@R7idVk8q+7 zIvjdW2W+f}&gYUiTGvgtPP56X@OM?YyehZWYy)2+(7NzJS6xr$P|*+PP>6$&CSZBI zReGr@UOk;+lAm44bHgb#C=t4W%2i8E$iU>ng8gk>kA5(@2F{lhs-EvZ>wYrhfaBHy z4WKr_Z_;v?$Peaj(QcM&-x_3-qEt<_M0SBJtpMAa45%hQWI!orTL*f@T2C%88H|E+ zcOx#J&f%p3Y(;MG#xM|PNPPIPvZ(;aeNPkl=`lyE$?ek98a_xOvlV}o4+g*1{LV!d z+MrEv+j_UMFIEExg@pJee6^~8I>cYDia?iWR;?AEdRU%jTE@pacm}XySok&cM(|Sg z-dd8S4r|7r44c~BgVPS=o`g`Lr+zOl_eB1WVVJ5U>B9>?M=Qvn+aTzA$37C=^2LH6 z@PeR1B{_K~Q$JNeDtis!oA!aO*=IBvG|A@MSP@w#iGoDh7L0{TKZxU#gdku-hLsg^ zOwT%oUWlMinecaK%EUW1yf7RLJcPo6#{Yr}dLwcT#C9UP%1hF4PYdLGm)qdeQ`<8x zBE7p42hihEDTbH?6`ry5qNnH1Ex-HIYb$(%eoiw?_er1cIf^-gBXgu}eD~)=%bt1| z3$bIWqzU0@J#TPm*3%DqK=FiG%n z`%w#^pRm^+dzz5DBpf}556`bZ7EGN-Fcx3Ti*)wK7o4<{y`5=h9skT(xg&3o7DG9c zbNEj3;R=A`ZqSD8=dNe*JwL!uhITRDGqNaQc#xkYIYtb79jx&@vsRsWp$6RF*GWxm zh8KLzaAMEx?2%==!svQx*ma7CmgLj}t8^SXXx--O+)q_plZasLX>@soW&7N6?hPLJ z9-!8>2yP{)h0(w2c39;fp3+|%JIZs6dnA7-V|Cj522ITWIXV7%thQVY=_3V4!m9NP z^R38>kYdhLTKO33mca|;;>*IUWqqkPbvNdV9S$7#ly4Mc@gcEOe9hrACT7j4w20Z3 z(viNzky3T5@ZoEn{#HotL zO@a*y*v*%wuzoDFFZm>bQJ3*YVISK0T7u3 zJN7r0wl?Oa(J@;W^n;ZA(MQ<7{EzY`r`}Nn$+q259IMi}0DQqbtE|$KhukL(AiTC{ zq@3MAXQbAhwtAqg+FYnb0wxz8Z45-m3~S8KazH$^x4ZI;4nPT$JW+Cr4n6k+T$VQ1 zw?A0TBq#gdlw$lR0lQ4wVa6ABaVP*gBOG?2;lNxI?CO&M3_k1{X8ZDg=QbG+yIEX? z^zPsY9GSM7XhXqSc-TvaHO=MS;GA>V5twe1zkrOZ(Pw1jIjb!MoLV}VbhrBwO`;`& zQJmPe3}crGC1K+x0memy5OlfyEQ$Zz`x-aU&`$aAy1 zp6R&nf!G*(QB%@S9WFLkMj%ewyexVoy|ugg?7{%IX;ViHRM zp3&>AJDwh)KNlO{cbTLa%iVsdS>aVcf()QlANKf^+B(&3()^E*w&Jl_WJ#Bp%Gw^L4z>?Q%~{IM_DB_^%-Lku&_&;nOzVutzfzB%97a#Kd@ zA-3*F6;ghcnsN(mgHbkWP4;#0-z0I^Bz09oO zm;^WeRc_<|&qOsz#ztU%dU)7*vvnlOp@tlCg$M)_?f9eBCoxY zTG5lsy~hLh0>7#Wef2ziV&{~ZNHqJ~2;ahZwz@a)=cK9ddRA_f4D;KB>_`^&g-J5* zT21t!U&#$;`I7R;uM$+Pj+V&HgKR97uF9-h=9R`cX%yeCXgD~;)p6su7IF9Ri7*BI z2Jj~Gwg?)2S*wYDv#Nd=jgnL!WxjUiGF?9e-0W zn*a>~fo-cI4ar8!9onHr?z-Mm09Umn8#+OS{Z_f@<9|QV$BV5~Rzy%8esFn_A%LGK zBI}k=9Li{Zqs<>T# z5Pv;mvEf9lX0PZfXuE7D2GT=C`o4316J3ys<|B2H5@7`}1i<{Ag#k-YYJ#Zcq5*Fc z+T6mvB7HCaHR*<|*CG^!Tw%45KRupvKAwcH?&LpQwg?{JLoT%~;1FZWUw-M3*0@Gp z_FIwZ!#3sM8$hdD3Eg$;I_^%HinqzgC$EGXBN}MJa1!<@=D|E2g+(RQ4(auc*+$n^ z-zy_v(x;GXrgB4L#Y49_zx_fdS637`(S2I&qHPt!Y$vls9QsQMb`!@Fz-hfDoUhB~ zkJQ@hiD3a^l9sFjj@_<^dS^I;p)^O@IybHRv;so{V;*Bj#|RfAXuGac+_cgR2?i4AI}3hbpSAVR*^x* z(6h&b3TbS3cr>N`#?v@1 zFc5$G=Ov6XZ>UMb)P#bgJjrn+9MwTn_Wb#__BaG_Tn&lx-!GzpUm$a$oZ718|3eXb zusu|}DS8-GqbB|F-z^lj0M?kqnQ$xD#_zXvD6FJ+N+n#BxcBHSgfDEPf6BnLfIJ(2 zJmmR{ZD~p6$|iP%)tw?W$c1kom-w;Vp1p^;x+SjI*LL)_&I`RJCYw3@R7USiE4zeh) zlf#@CgAQC~=7k|8;{~FpJq3sH|3YzfSMrz5P(=fPAi|1wlE7mjB-FaUgRnAAdKteJ1KL4TT zRW(@EO`5!@(vo=~>a?hp|6GZ3DF_-HGVZ+i5u2*ICbZS0+l&yPw6&K;96hki%|90rPrE5Fe<`Dmxl;C^c6V9Dy^0ai{}0*k^t zjH%!sk7JI9ab3}^c)YY4x_BN03lKylGfIn>sCp>aGtH4;Uzpa~A|N!S|FelXyky-Y zf9yu_HkJrp$m|ur9+UkvnbPD^JHo_C#YX>VCF#;Vy%toRNHaCGtWo ziOcNBuB@jBo9iSw;N7mQYz%i^k(*V~a586-f_2GP1!=Xk2WW-puH6O zE^8w2F;->SBS{4-4r>+b$0;rRD;?{fOIQQ1^9AOVxw`O(e$kDS^|Jr-H_IwBXoPy3 z=xTPzG`so>x=HQ7LA7saYBZr+=qH4F=-d<#Ob!-yG8z)$2`K^|fk~aGB*B`Dj8NqG zY#aKV^yq6t?wu*FtkrXvL`;`~@T@@ImNhSEWGVgLa}SM;X{wy|_is=_Qu5ZZE-T|S zu5q`kwNk);mj@w>nSSoh!Vbe&PU=4bsBp~kG*k{|^2(Q&=&*NMdQ*^0H^;|bB&%bM~hq1x8G zuP2)y^I<+OniNn8Q~ug&548XyhEh*z38wdyi?|evi1Qcc6CSR%{|yA03E>mkqkMT> zp)j9dEf6kA8kM%7#^FmGoN$w9%N^S_U+C-HzBhhNrZe0-RAyxvX_P@zvy1qvOEutj zk~`QURhgp+5uv_%cKV!zdfIYyS#O@KqkC8 zobiZC*IXCyt#{`yhH^Fz%;=m0#B6jq2|20&k$n9dEw@KB4i1iCXS`}}@&Hn(iP;?o zPG)~&h3SSHp($V0Murt(q1nWb^%`q2cabu1@|MARU$&sGt2kEWkvaQOV=@<2*aiP- zX`yojV|-G&(P5{m#ETnYVNp^1#(2s8xppuAfLbM^i8^Qtf2KpNoN*`;64SAuP%l(ZuITu@UyF4|;A9@^Znh*re zpw&6umqmBxpS;IW>XdGk?1dOb@E>OSi7%1p1c@oGHoiRZUkrfR2^smB|3Tpx8a zh7|Og@*tsflIG36-g2hpywK&Fe*B~#z2Bq07=uJx_}rR9>D zXr`mUCaCuMh<@T^kH9I>QZ@W65V@i_A|lZ5$Gn8;-%O8NUOs<{$!XS!trr2mQVeMz zUch4ZWhyn|bez0eCo$!u9EzbG5(?g0aN0)8D>j{Xx@sVB@@36yO0283)iOn|H>{cH zjz1cV7YGItF))i=94sGwV)W;K*8&XI5TLWFDK`j7+@ZXxUq8mx4eob?U>e~t0?-SC^l&jhR!Lr z!hpA|k@z$4YQ#4d29N5oj~Bxwuc0V=jfNslN}84X)zsHbw8OUE@B%C($cfh(Ud$Gj z(=W|8cL@kpPLqj3A(*eLb(|cx*vJ=qa>;)7;KluC9}wi4x1S8_w)Azs`8dh`qJ;f0 z{xbZ%@O#+bun1{ji7MC?8UZl)uq)muAIPe~F4HtRAPWP#{{L^|H~BKRoH7V7O=)b@ zxnDn*#sZ5bAt42j7ZetZt0xxA;a_g|#V$G|%NJ%&Rwu@^JdXt5zOaXtW9vMTk?)ErhuSIW2cSb;t@;g--= zA^o{Z50gTUPN#}w$Lhe)pa5nmf1S-$O+J~vG9$Pw-T@W-96)SY@4q%nY~yZdSR)UT z;tDDU7i>-Lemd0WbYfyCrV~j16Vb^4m<&PzfR&SBrRgz5o*5qUv1$6GPA6lsY&fS| z^-HI3geNG!1gz3I4^LoPNPFszr(S&{E22m|kKXYL7^g`HAix7^DVr#i;Dsv*!r8Wj zTPeykr*K=Al4I(L4I*I-K@Z%G#!SO8fW~hI3oj|1A2Tho52vLhFTMl(l<6=Ro8%x@ zT}$91I``{uMihULD`=;O({?F9ow>c#`dLAEuQu7m05`Wn@}q`cuCRgB)(Wu0PAl63 zP4jUc5BxuA>O+8o%!=)ODD#4_wBz8c2u*jI({|1`yZXY$R@V~IzC6b@1aEb_k{8J@ z6ELHz2{&Xcf_v*1vv5UJC7tY@AA{iM%56TpN19&2^`8j4tp8>=#1+{1VHWzX*ERJE z-%K~xXMnUa!uvQgaN+ZiF=U3lsv>#K7;!`xMLb`px6MkI?^#3KhHhDDGTSQAYu;6q zme3MgxsrLP*&uwLX5x=B;BwsW{#Er{0T11wsdwj1QkQPz9`KE3L&K)@QC8?0AO&@n zta8(&q#9A1hNOE)g_qOCeIJ-V9_p7;|2}Du8yoIT&jg|ja;UBa6tDC2e2O{m?!AB^ z_M)!r>>ylEF>=MpcXzMN=N$v>VBV6rg7oXZc2Pa9ymhSuE7jEh;nGU-eo|b4DX0{! z{G<=4?&5KdIV4VVth0`0HV1M}N%9P;^a1su8UH1^?joU4?*#P6+48^C_n0 zJW0x49)k_Y$3Qwz< zKeMKdgvYdFhfM5PQr>UU1jnxoWnv zZuw%qjdV!ga`wtw_{0IMS>!_coWom_yTssIdHy%eM;N~B|{O znS?^wm_HG``Yd6xnZdLV&G>%WC}*wY7bm5ErQ=?`yk>pedihLL_B&8=^=;XCy@4uW z^zB%jb`!3!@$+SugPa>3uu&(0S{D=Lq}H$wTwjqSg1MA~-lpNO$5yoIMapBphS)_r zqwyek_0$T)0#BX}uExB5e;rDT+?R+V-;3_(>5<+{drwJbSbj$gh*%&p zoiN#n0Mo6+&cwr?*XQin{VKG4>G;b-`(ib9`K5k7>amq+dK}q@`0%Gb`3DkImFMbI zOQ!B(hnuhIQCObiW4#cXFgd`Td)#SxCZbx<)B~QhU03p?l3;_Gkv@&M$of(HsRQ*h zPFt*PV`yo6SMW}z3E$rP%`P)UEkeW!Bq9{s@}j(j;KmO&WK18|RK<<4A%T|T$C zImz%XUc-1cOU2Hz=|*@@NnNgbn7N_Rot3l!tix#TuI6~0vUjBOC}{DxWWx+nl*Sve zzX#2?VYADGFsd1OB_`9OrG9<7coEK3Dr}s0c2hf??oc0C>fqt48DW@I5ME0c9?LY* zoE*TLo0G}CW*d8}uDL3hx-;sgRoSwm{*0_9u5G|_+`5X9`xWb$RA-ahX|bAQA$HO_ z{x)47T&UwV$-idNf*!W>JXh?`5dBy&dwG&QLt^Y2$vaKkVC?8u*!DfH7puNYYIm{74ghg=X3h|#Lm=~w3TljJ_CpLtpR&;+wCh> z$JDh!L~=Y3;Q`4Rd}`f<>EN5>1?F<_}bCPi7wa<+lMp~%{}X;2uA(>Hlz1Q640ST{8aZy)>WS611b_%s_1 zHDbEj9X)CLO@%4h)Fi?3Ajzsq+78LPZt|<{x8ChO zPXsBCI?rf04NNvrPCaoh(%S=Z|6i~Qi};OvmJp6cu342!?OGB2oZNi==LS~C>a#o! zxvs`t1B7$TyV?Ysx%jN1*RgdO3R&L z@VoPdU_L$&vRPqk8YEg$eIs29qDH`|b77({{=jd_+S(HO&}fgzGpjQDJzAtGZ6^we zAm7T9u4OFIlX>D@rasDbmtAXW0@9E?c4=Qw*_AZ3&9TmfaB)QN^{ z^A7o@+q;P(zva!Q_T^|ktJ>YbMo<5_BPGdsRa+wO&+0v-o>&ioiP6bV z&u=^@*fxL&l!unn8F8s6kaGz`0zT2w<#p)vCrT1Ub%X9*`Rj9-eUN) z2){m>amC|zR;S)dMGdb@^+jYVN~!1WJ2}@da3T^dJ=Szmf7uIE|BP> zH(mF#WX_qHr<_|nH=6Gj-a(riiiDB-uR;UagE#D~4y;CWXe#W)iSNwZMW%2C2!l=x zIc4OPXkOQ23rtVBOCjF4R5Q)Dm^LO|KRZIi{qC*_~~} zb?>jXKJ~wgBZZ_W5{Tcg+Znn-?T)Js*@-|VZ6X>=>l*bQw0HjKY1OX8-z+#Cw@ulv zt_Jtx>w&{r3DXs86-&lCpLLtI@nK=6IhVgL&Vfe$+t-H185Y0IyV+V3nCeJ5Cx3Lk zDPB1Lv)U~~tlel>NIPlbo@Mb{Na2%`_~LKp`ak(Th-Mfs3MLhMhMfuVf4HNk&g#rP z@Lo8_yEv!Y++Bs*BL*F=wW?qsoS)J<rp0=p5Zq6#KiroIm%v0-^KQQ&h`> zcTW|fMFNVKZpQ|5_4bg`+o^RSSk%J-2irD$7rJ^C^&VjaKj?W$Y=5}>F}vx!;^K01 zqj7CZAg|i;LBW`FVqSC5_){yDR9tbAu4~8wr~o1Y^KXaIwT~4HlS){745sfTfaw?b*iV?SaH` zuW>zYgvuy9Z3DS4M)0T(nbPN%q^0RNkS9~xe$S-O#0UtO4oe!+D>>UIwhmCcQJ*@W z^OXz*6Wr9%9{Zo4iNJ&0^RQlTOUlr6pO2KAdSoGo^Sd^L7Ew1v47~ z;_CrEYVNfE?pChwjhM02k9&F6wxCaeb=CA~*M?gSB4Dj*mO8(B{@P;fmL!y|@MNnPd3t_ZHxGF?@a?bN&mwnm z=7y@PF2%q6CSyZgAMP`NT(j`(l+Cp6=L3_5{?Ol=CUjZyk>}Llr$~Fc0$+LP)ZgWr z$b`1jqV+kO;fsm`tpT}Pm3AtAhcR2j>jE3(Yn`GfmFNAAWgoDhxk6@7EwfxJEZ8#y zNS$c*Ghyvm5&mtK)=mOQcG=G*9C<3HbAmi(n`RGDtmKiyR1+t{u{~D-iT}w;&Bp)l ztke|G4iJlSdw9{WepevAmt+4|O1>8(P(0E5;X<(%{A z`z$lD+N#K%kTrrK%y0I)7i8f78ImKGScDg5_z&f4Tc! zb!E5UO89o+CRM=^SM?>0H$E%lqx#Ch&MJiWcflDhD$d+GAZ9~ zs;ZA%xru~6eX`Pm@V?OpK9;(`Uvgg7gWs`rb^bE@KX*NsN$%(@U zzNrbPDeX|YlPnMx4(Q-inGE^#?sngrqL<-cpNpA4{G6{&8QwJe%ab0=TUBUyDTfx8 zSng`+5b-X?twViq9Gd~887U7Eg<0!&z=>UHrd?)lbch>OoZ^tAhc*XRz^cy8^uES8 zF*>8?H_3DhS$DY(h37kXcNPNJ%*#5x!8gIkw245TZ4i3RaOg3ooaGUk9Ie2Lw?wpX zW%@BEtDoH%DREDhM(0M5oEkV}y)6ls>T6dKWxP6vw0SICTKz>igxgkA%GkIPFA zkNlTo`_;|46q@Om(`^Z7I&ei=B082dJk+&-iAf-G{C}jG*k*yxr{k2f1nc)gG6O^h z>j|4LNrdpR$*$gg{FcX7!H$C_pfyR@>`c06zOMt;3g-^7M3WA0pk6E$sB+mFB@64D z-lVBXApj20p{(1xMD@3LUq^=d3b7NP(zbPv#5}!*tw+d+qJmuk?Ko8+J$~;{ZZvG1 zs+Dzk)sc}MC;AGlHj8C>X2?;B2_fVEmFhwdkFS|>T+i5Aw@oSICSehb-OxXq>lR*# z@pw3xctf0Mi|8(G5JdU8H_vqJZ6>M34Zot{vEp(QAO9nx?fUTb`mhiZJCF<*_WCUT zR&u*svZ>toK1dRGnJ3N%e7#V>mRA&;5o`bL;C?$7sig$wBG=S_63aSsUU9V!<Q3E)~NOaMX+iytWq7g~*R`9hK6fNV4< z_E$(pN{?KJ$SXvxT}{?$Qf3HU;vuwX>j|G{nX zUl{N1n5JnI4SV~!-p&n#9x&0&dK9x8ZN8={ocM9vVDu>lHl9@2@U@~U4F=nF_M9NC zj^J#hvKDaWRC|>g_9+M)IPiI#@0|#e=*^e{321%_f$OWv_5>|-&iBHP(JCAvxU>_b zzuBp?S939I6bnmfNhLAQ!iNtN;5!&zC)yzQM=sP4FL-&JwKy|0HL2Vw!%xDylZUfU z#8||V!dVnMVSFQnKWB40dL?1YsoDHDsNm7W&PZ&D7ZDB)R@Tv%1^jm-MMiKV8==A)aG4U}?f3#Ne2Ht}_{3wv&kerX#C^k(mnW+mz z{ZSf4C)Lw2Yu8|*ej`E-7^I5CKaG>{2t(fL767lfS?Gi-3LF)7dlx`nu9QxR_;=^6Y-Gx;w4kiySp2He1Ed-PLWif3xC51Oo?(` z@bOe@5I=FhtU+ydcBYwDqP`*fhOf}fbYna_#6t9={m zZL0n^bw*kBeR|+|A|MjmvoRsm^imj1%6PVSQ)eZQkj(lzeDMFN?mEAkYPx+y0To4k zXaXYm(4>nr=>i5JNbdncl@dBqML^U@6*NE)q)CyIP-7B00@8a)=pZ015UPL>h4=8T z`{jPPf56>e=A7AQ&Fr<$S#xH7d(UqotyM)feKP&T|BJB&P41QU@(MUBL0Wat7dchT zrspq64Q>33&r3JebqnS`T&&7$3!u-4(-G=jrxN2S#d+i<1@hsW7<}Z1G{n?mp= z9O{Ld!#fkzO61#^mwk~djSlr`-?DTsq&KUKjZmObmpm9E8!jIH8hLT;Tc8BL<2{P9GqKhU9M2NW@<^Ds@t-7dPM13>=!2-90Xlu#Ng{S$11Jo zJT?yfaAs67MGHHNtippJkzPYG5yOdo3`U2|(+PAC_aMgy%9JjD4YI#H^eom9aG_8#vT>SoG7&T2fH? zul^74D{w1^yP%Pu+t`D?zmQO&#dsC){4dh zL5{c364|KewmY>o@e6_t(kc^@-hJ99!w$o}_agVtwFtc5Yzca-VhNI^_fov>&gb;| z?$MXj;Ug|@t)w5fw`U17TX~JmBHm}?5k6mGF=qO1~-7S z4g<{a@e>7RVYZ52y>Jj00W|Bl*lAoLs^&m-N&9w3MLk13>cd(k#CCSd1u^fB$4#!6 zvdr{Tj*dwx*~b5aU(tR)!>?EtPYMRk16$X*$-ma5VX^imdXG zYiXx$mLOrYWDC~zzaT4RZcc&1XJYgiAB4FTEVN_)85AM0sk(Ht^y(67Eb{4tTPS5q zTB*$~qkQi{nArvWQ40i@f7eizE)$Bp(Qm1@lmt7zJoFLvWGM*|gP-5I88BcPD4XijZ}Tx@ zk2%jibbB;&QH^FQ@1@!a(!qJ+95(Br2Df>+{KFi1-x0~NF|7NKUL*YGY|rcFwe)5vy4~PCsr^y{V8+t)&Yz?y@Twft8*Sk8=10*w81<$NffiTZFtqc$@>!Kp)<9+NSl z4BL(R7;~lCQ%NiAo@HQV&2})Iw!pB<{Mtur=eMrYneoHR?Q(LJ-W^J1o4Hf#Oxnr3 z-1=p&U+CwmGta{2MC7H4w~8))3AKC>WKv*N7%&qWy~Y1Ka2Lvs?c7pUD_8u)Id?iY z`xk)^n6RfYfp)fc)U3y%*_e{ZCFY7J=6tH zQT~Y*WHPyLcf|n-ttD zWiOuG!R9_^C$k8++0h9N2t;LzWRP)64&Kq=KS>OoOlsv&3RPRvr-;EDOFlhbjf5w4 zvN~qAh2qrPJ57dsCB_Xl(^ufWYcRfhTqxvK$8?Kba&>Kk$dX>@o$k96o1Qn6(oO!A z#C@gI_fZ22{Xj@zt)E`DB-ea8hPqgFOX@kZ^+P@m~y4g8{YtdJa`+S zIh)Ml`^9@Jjs>JCVH|>>Fv*;#IXZqFDXH16<#(S$McGVYBT(dU?~?&#{9#22k<(FF z)6~n*y((G3Sz2=Kd4Tn$Hoi48O?E3}jL5_$xae&@rg~_6pE%!p!e{*augcfgbF5Q4 zmrVK`FMO?okAXnn8r6QNhgEh+ZzI|8G7DibHRM#K9(4 z4cPO@YPohvMuC?J6HjYsX(O4|HC?h-eL0DpB^C)qRzbTRTOs(4{PmhxpXIxIUH)#g z6>Z4#M~w+!0i@nx>5$_8;K+7+wdTD8@6N>g4#HeuVZLI zZ*2U{zp=?dT`VHxc-f!u*~T$dNx!>QUmuP0`)e23wh{PC77V>$@(Xf~fEL-6hs=9Gjy6o(*6lTn%&1whRz^Hu@Q>@qYovl)xKX3#C^sLd}5DHA;71Ns2#NKyT&BS8yWlD49Hx%ouD7~c{w^y;_BYz>! zXD(56G&mY-41ZS11a8_a)oUOZ^$&ZFq2l+eYDL*o`WHDGmJvm)Jyu60KZ(BD!cKz8 z{V22Za-Q^CKcywZ!RGDdtKA)@Uv=kX;xU4vDKHdzgSujlPcK_omiaTBb03V=5P6~5 z++CU=iarOb*t$_|V4iD(>Q+41*iqY$c#pnlRCYN#0sdpB`niO-@II;Hxcjq{cpjRQ zF55G(+LldE5MsNXTE(%kNj!2#n9dJo_PG8mL>+fDFumj692;EQzczg}AUNuL9eaVq zGN1N*piX4~ylMf)mFkrM_aAoWYMLPR42*C*7(&k$J||L#i@vP8nhK06=bZ4)ezFfV z3G2{@|AfNui`_O=DNVAu#x^LrGCA`1p0I-Tg}UgLr8tV7>rXj$7S>zx1P0;peBeZh z16~?7a?b}g|9Q4ql(JlT<;ojlNiEI^uM=QEO7!KN5v9#~z7BT(g8Z2fY== zT(~mnOA?!BwxAocYLZ#4(m>6nt6$QI!4;OJiC;^Onl)uK6$8k*1RCOS-n9;iySO3Y z(K|ZDd78osRRCpMzEkMbv54%FLfNhbQxcAIs@a=9X>gGKbyYg#)L(^@SZsp+_njIo zcXW|V0E9OJg?Z-oPN_yi@I9@=v9GyXiXr%M8a5NIGG5e9Z$%7p3*V#CfLW=`*@=j&3&??y*IAQ>;zlC9OS?vc-?e> zI+A|Ux=ua{UpoT$2zLp)!qb5eHIZB91Lec%wZ2EQkiJ@nDg|NnBsZ(#_2cvu1@VFT z(OEcs)7y|=0XBUw(xB8Ou!w}VhQ-dJ#OjRd@~=XvOQns_a4&IbNCp>iaA$Qai{DkY zSpEVC6iSL*0tBj0gWKx_wvU0ZR;wMWceF~S@R5utMHe*ki4;!JMVk#=ELX!q$M zJ;?5KTt{%vu1WGv+ie^(+S%3EWJqAn9({r@YC!0<` zQFspuEcwP<^{q!{!pM|pA&$%B1m(O9oMb_HsMyhY!~G_iihfHM5D0W~$LCy;vF45x zQ?2#JNSBOTN22$T)956Cw`e<1+fi1=eH!PsEF?gsjnKqY$_BK;rI!F_Ea Tn6~Om&Memk>pdz{w|n&;gj*92 literal 0 HcmV?d00001 diff --git a/lanelet2_extension/docs/localization_landmark.drawio.svg b/lanelet2_extension/docs/localization_landmark.drawio.svg new file mode 100644 index 0000000..5895d8e --- /dev/null +++ b/lanelet2_extension/docs/localization_landmark.drawio.svg @@ -0,0 +1,156 @@ + + + + + + + + +
+
+
+ 1 +
+
+
+ + 1 + + + + + + +
+
+
+ 2 +
+
+
+ + 2 + + + + + + +
+
+
+ 3 +
+
+
+ + 3 + + + + + + +
+
+
+ 4 +
+
+
+ + 4 + + + + + + + + +
+
+
+ x +
+
+
+ + x + + + + + + +
+
+
+ y +
+
+
+ + y + + + + + + + + + + +
+
+
+ z +
+
+
+ + z + + + + + + +
+
+
+ Landmark(Front) +
+
+
+ + Landmark(Front) + + + + + + + Text is not SVG - cannot display + + + diff --git a/lanelet2_extension/docs/pedestrian_lane.svg b/lanelet2_extension/docs/pedestrian_lane.svg new file mode 100644 index 0000000..05ec92f --- /dev/null +++ b/lanelet2_extension/docs/pedestrian_lane.svg @@ -0,0 +1,90 @@ + + + + + + + + + + + + + +
+
+
+
+ type: lanelet +
+ +
+ subtype: pedestrian_lane +
+ +
+
+
+ + type: lanelet subtype: p... + + + + + + + + + +
+
+
+
+ Unaccessible area +
+
+ (e.g. fences, plants, trees, etc.) +
+
+
+
+
+ + Unaccessible area... + + + + + + + Viewer does not support full SVG 1.1 + + + diff --git a/lanelet2_extension/docs/right_of_way.drawio.svg b/lanelet2_extension/docs/right_of_way.drawio.svg new file mode 100644 index 0000000..6a1a172 --- /dev/null +++ b/lanelet2_extension/docs/right_of_way.drawio.svg @@ -0,0 +1,384 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ yield lane +
+
+
+ + yield lane + + + + + + +
+
+
+ yield lane +
+
+
+ + yield lane + + + + + +
+
+
+ ego lane +
+
+
+ + ego lane + + + + + + + +
+
+
+ priority lane +
+
+
+ + priority lane + + + + + + + Text is not SVG - cannot display + + + diff --git a/lanelet2_extension/docs/road_mark.png b/lanelet2_extension/docs/road_mark.png new file mode 100644 index 0000000000000000000000000000000000000000..98b41025d5d2b4513c57e7878f68e76962de3372 GIT binary patch literal 22300 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 literal 0 HcmV?d00001 diff --git a/lanelet2_extension/docs/road_shoulder.svg b/lanelet2_extension/docs/road_shoulder.svg new file mode 100644 index 0000000..489b83c --- /dev/null +++ b/lanelet2_extension/docs/road_shoulder.svg @@ -0,0 +1,81 @@ + + + + + + + + + + + + + +
+
+
+
+ type: lanelet +
+ +
+ subtype: road_shoulder +
+ +
+
+
+ + type: lanelet subtype: r... + + + + + + + +
+
+
+
+ Accessible area +
+
+ (e.g. sidewalks, bike lanes, etc.) +
+
+
+
+
+ + Accessible area... + + + + + + + + Viewer does not support full SVG 1.1 + + + diff --git a/lanelet2_extension/docs/speed_bump.png b/lanelet2_extension/docs/speed_bump.png new file mode 100644 index 0000000000000000000000000000000000000000..3684e9f9ea8b2006abd19a65153e79d889f8ffe4 GIT binary patch literal 26135 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

LoMhJLfb9$ABG5n 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 PdLd9nXeyN|JbC?pRPCVe literal 0 HcmV?d00001 diff --git a/lanelet2_extension/docs/traffic_light.png b/lanelet2_extension/docs/traffic_light.png new file mode 100644 index 0000000000000000000000000000000000000000..aa97c7bc61c7bd0145ec6af1170b29ee9bdfe1da GIT binary patch literal 111053 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 z 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 z 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

(io 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

ZBPH0O>ti*)n}eq)Tv)3NSp|#L_TM4u!#t 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 R{A&U`s)|}qu=3CU{x44$_#glP literal 0 HcmV?d00001 diff --git a/lanelet2_extension/docs/turn_direction.png b/lanelet2_extension/docs/turn_direction.png new file mode 100644 index 0000000000000000000000000000000000000000..3fd63585e10fee58ee225575f1a7eebf0be4de97 GIT binary patch literal 67105 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 UC)oyP_jpU{gS=R&h{2ct1rWacjQ{`u literal 0 HcmV?d00001 diff --git a/lanelet2_extension/include/lanelet2_extension/io/autoware_osm_parser.hpp b/lanelet2_extension/include/lanelet2_extension/io/autoware_osm_parser.hpp new file mode 100644 index 0000000..8645ddb --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/io/autoware_osm_parser.hpp @@ -0,0 +1,63 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__IO__AUTOWARE_OSM_PARSER_HPP_ +#define LANELET2_EXTENSION__IO__AUTOWARE_OSM_PARSER_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include +#include + +namespace lanelet::io_handlers +{ +class AutowareOsmParser : public OsmParser +{ +public: + using OsmParser::OsmParser; + + /** + * [parse parse osm file to laneletMap. It is generally same as default + * OsmParser, but it will overwrite x and y value with local_x and local_y + * tags if present] + * @param filename [path to osm file] + * @param errors [any errors caught during parsing] + * @return [returns LaneletMap] + */ + std::unique_ptr parse( + const std::string & filename, ErrorMessages & errors) const override; + + /** + * [parseVersions parses MetaInfo tags from osm file] + * @param filename [path to osm file] + * @param format_version [parsed information about map format version] + * @param map_version [parsed information about map version] + */ + static void parseVersions( + const std::string & filename, std::string * format_version, std::string * map_version); + + static constexpr const char * extension() { return ".osm"; } + + static constexpr const char * name() { return "autoware_osm_handler"; } +}; + +} // namespace lanelet::io_handlers + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__IO__AUTOWARE_OSM_PARSER_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/localization/landmark.hpp b/lanelet2_extension/include/lanelet2_extension/localization/landmark.hpp new file mode 100644 index 0000000..7c96cef --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/localization/landmark.hpp @@ -0,0 +1,38 @@ +// Copyright 2023 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__LOCALIZATION__LANDMARK_HPP_ +#define LANELET2_EXTENSION__LOCALIZATION__LANDMARK_HPP_ + +#include "autoware_auto_mapping_msgs/msg/had_map_bin.hpp" + +#include + +#include +#include + +// NOLINTBEGIN(readability-identifier-naming) + +namespace lanelet::localization +{ + +std::vector parseLandmarkPolygons( + const autoware_auto_mapping_msgs::msg::HADMapBin::ConstSharedPtr & msg, + const std::string & target_subtype); + +} // namespace lanelet::localization + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__LOCALIZATION__LANDMARK_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/projection/mgrs_projector.hpp b/lanelet2_extension/include/lanelet2_extension/projection/mgrs_projector.hpp new file mode 100644 index 0000000..37b6bc0 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/projection/mgrs_projector.hpp @@ -0,0 +1,116 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__PROJECTION__MGRS_PROJECTOR_HPP_ +#define LANELET2_EXTENSION__PROJECTION__MGRS_PROJECTOR_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include + +#include +#include + +#include +#include + +namespace lanelet::projection +{ +class MGRSProjector : public Projector +{ +public: + explicit MGRSProjector(Origin origin = Origin({0.0, 0.0})); + + /** + * [MGRSProjector::forward projects gps lat/lon to MGRS 100km grid] + * @param gps [point with latitude longitude information] + * @return [projected point in MGRS coordinate] + */ + BasicPoint3d forward(const GPSPoint & gps) const override; + + /** + * [MGRSProjector::forward projects gps lat/lon to MGRS xyz coordinate] + * @param gps [point with latitude longitude information] + * @param precision [resolution of MGRS Grid 0=100km, 1=10km, 2=1km, 3=100m, + * 4=10m, 5=1m] + * @return [projected point in MGRS coordinate] + */ + BasicPoint3d forward(const GPSPoint & gps, const int precision) const; + + /** + * [MGRSProjector::reverse projects point within MGRS 100km grid into gps + * lat/lon (WGS84)] + * @param mgrs_point [3d point in MGRS 100km grid] + * @return [projected point in WGS84] + */ + GPSPoint reverse(const BasicPoint3d & mgrs) const override; + + /** + * [MGRSProjector::reverse projects point within MGRS grid into gps lat/lon + * (WGS84)] + * @param mgrs_point [3d point in MGRS grid] + * @param mgrs_code [MGRS grid code] + * @return [projected point in WGS84] + */ + static GPSPoint reverse(const BasicPoint3d & mgrs_point, const std::string & mgrs_code); + + /** + * [MGRSProjector::setMGRSCode sets MGRS code used for reverse projection] + * @param mgrs_code [MGRS code. Minimum requirement is GZD and 100 km Grid + * Square ID. e.g. "4QFJ"] + */ + void setMGRSCode(const std::string & mgrs_code); + + /** + * [MGRSProjector::setMGRSCode sets MGRS code used for reverse projection from + * gps lat/lon values] + * @param gps [gps point used to find GMRS Grid] + * @param precision [resolution of MGRS Grid 0=100km, 1=10km, 2=1km, 3=100m, + * 4=10m, 5=1m] + */ + void setMGRSCode(const GPSPoint & gps, const int precision = 0); + + /** + * [getProjectedMGRSGrid returns mgrs] + * @return [description] + */ + std::string getProjectedMGRSGrid() const { return projected_grid_; } + + /** + * [isMGRSCodeSet checks if mgrs code is set for reverse projection] + * @return [true if mgrs_code member is set] + */ + bool isMGRSCodeSet() const { return !mgrs_code_.empty(); } + +private: + /** + * mgrs grid code used for reverse function + */ + std::string mgrs_code_; + + /** + * mgrs grid code that was last projected in previous forward function. + * reverse function will use this if isMGRSCodeSet() returns false. + */ + mutable std::string projected_grid_; +}; + +} // namespace lanelet::projection + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__PROJECTION__MGRS_PROJECTOR_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/projection/transverse_mercator_projector.hpp b/lanelet2_extension/include/lanelet2_extension/projection/transverse_mercator_projector.hpp new file mode 100644 index 0000000..f8693b9 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/projection/transverse_mercator_projector.hpp @@ -0,0 +1,61 @@ +// Copyright 2023 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__PROJECTION__TRANSVERSE_MERCATOR_PROJECTOR_HPP_ +#define LANELET2_EXTENSION__PROJECTION__TRANSVERSE_MERCATOR_PROJECTOR_HPP_ + +// NOLINTBEGIN(readability-identifier-naming, modernize-use-nodiscard) + +#include + +#include +#include + +#include +#include + +namespace lanelet::projection +{ +class TransverseMercatorProjector : public Projector +{ +public: + explicit TransverseMercatorProjector(Origin origin = Origin({0.0, 0.0})); + + /** + * [TransverseMercatorProjector::forward projects gps lat/lon to Transverse Mercator coordinate] + * @param gps [point with latitude longitude information] + * @return [projected point in Transverse Mercator coordinate] + */ + BasicPoint3d forward(const GPSPoint & gps) const override; + + /** + * @param local_point [3d point in Transverse Mercator coordinate] + * @return [projected point in WGS84] + */ + GPSPoint reverse(const BasicPoint3d & local_point) const override; + +private: + /** + * origin geoid coordinate for reverse function + */ + double origin_x_; + double origin_y_; + double central_meridian_; +}; + +} // namespace lanelet::projection + +// NOLINTEND(readability-identifier-naming, modernize-use-nodiscard) + +#endif // LANELET2_EXTENSION__PROJECTION__TRANSVERSE_MERCATOR_PROJECTOR_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/Forward.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/Forward.hpp new file mode 100644 index 0000000..16b814d --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/Forward.hpp @@ -0,0 +1,54 @@ +// Copyright 2023 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__FORWARD_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__FORWARD_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include + +#include + +namespace lanelet::autoware +{ + +class AutowareTrafficLight; +class Crosswalk; +class DetectionArea; +class NoParkingArea; +class NoStoppingArea; +class RoadMarking; +class SpeedBump; +class VirtualTrafficLight; + +} // namespace lanelet::autoware + +namespace lanelet +{ +using TrafficSignConstPtr = std::shared_ptr; +using TrafficLightConstPtr = std::shared_ptr; +using AutowareTrafficLightConstPtr = std::shared_ptr; +using DetectionAreaConstPtr = std::shared_ptr; +using NoParkingAreaConstPtr = std::shared_ptr; +using NoStoppingAreaConstPtr = std::shared_ptr; +using NoParkingAreaConstPtr = std::shared_ptr; +using SpeedBumpConstPtr = std::shared_ptr; +using CrosswalkConstPtr = std::shared_ptr; +} // namespace lanelet + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__FORWARD_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp new file mode 100644 index 0000000..f175d23 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp @@ -0,0 +1,91 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__AUTOWARE_TRAFFIC_LIGHT_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__AUTOWARE_TRAFFIC_LIGHT_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include +#include + +#include + +namespace lanelet::autoware +{ +class AutowareTrafficLight : public lanelet::TrafficLight +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "traffic_light"; + + struct AutowareRoleNameString + { + static constexpr const char LightBulbs[] = "light_bulbs"; + }; + + //! Directly construct a stop line from its required rule parameters. + //! Might modify the input data in oder to get correct tags. + static Ptr make( + Id id, const AttributeMap & attributes, const LineStringsOrPolygons3d & trafficLights, + const Optional & stopLine = {}, const LineStrings3d & lightBulbs = {}) + { + return Ptr{new AutowareTrafficLight(id, attributes, trafficLights, stopLine, lightBulbs)}; + } + + /** + * @brief get the relevant traffic light bulbs + * @return the traffic light bulbs + * + * There might be multiple traffic light bulbs but they are required to show + * the same signal. + */ + [[nodiscard]] ConstLineStrings3d lightBulbs() const; + + /** + * @brief add a new traffic light bulb + * @param primitive the traffic light bulb to add + * + * Traffic light bulbs are represented as linestrings with each point + * expressing position of each light bulb (lamp). + */ + void addLightBulbs(const LineStringOrPolygon3d & primitive); + + /** + * @brief remove a traffic light bulb + * @param primitive the primitive + * @return true if the traffic light bulb existed and was removed + */ + bool removeLightBulbs(const LineStringOrPolygon3d & primitive); + +private: + AutowareTrafficLight( + Id id, const AttributeMap & attributes, const LineStringsOrPolygons3d & trafficLights, + const Optional & stopLine, const LineStrings3d & lightBulbs); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit AutowareTrafficLight(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__AUTOWARE_TRAFFIC_LIGHT_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/crosswalk.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/crosswalk.hpp new file mode 100644 index 0000000..f6cec39 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/crosswalk.hpp @@ -0,0 +1,92 @@ +// Copyright 2023 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__CROSSWALK_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__CROSSWALK_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class Crosswalk : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "crosswalk"; + + struct AutowareRoleNameString + { + static constexpr const char CrosswalkPolygon[] = "crosswalk_polygon"; + }; + + static Ptr make( + Id id, const AttributeMap & attributes, const Lanelet & crosswalk_lanelet, + const Polygon3d & crosswalk_area, const LineStrings3d & stop_line) + { + return Ptr{new Crosswalk(id, attributes, crosswalk_lanelet, crosswalk_area, stop_line)}; + } + + /** + * @brief get the relevant crosswalk area + * @return crosswalk area + */ + [[nodiscard]] ConstPolygons3d crosswalkAreas() const; + + /** + * @brief get the relevant crosswalk line + * @return stop line + */ + [[nodiscard]] ConstLineStrings3d stopLines() const; + + /** + * @brief get the relevant crosswalk lanelet + * @return lanelet + */ + [[nodiscard]] ConstLanelet crosswalkLanelet() const; + + /** + * @brief add a new crosswalk area + * @param primitive crosswalk area to add + */ + void addCrosswalkArea(const Polygon3d & primitive); + + /** + * @brief remove a crosswalk area + * @param primitive the primitive + * @return true if the crosswalk area existed and was removed + */ + bool removeCrosswalkArea(const Polygon3d & primitive); + +private: + Crosswalk( + Id id, const AttributeMap & attributes, const Lanelet & crosswalk_lanelet, + const Polygon3d & crosswalk_area, const LineStrings3d & stop_line); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit Crosswalk(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__CROSSWALK_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/detection_area.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/detection_area.hpp new file mode 100644 index 0000000..698ab38 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/detection_area.hpp @@ -0,0 +1,96 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__DETECTION_AREA_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__DETECTION_AREA_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class DetectionArea : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "detection_area"; + + //! Directly construct a stop line from its required rule parameters. + //! Might modify the input data in oder to get correct tags. + static Ptr make( + Id id, const AttributeMap & attributes, const Polygons3d & detectionAreas, + const LineString3d & stopLine) + { + return Ptr{new DetectionArea(id, attributes, detectionAreas, stopLine)}; + } + + /** + * @brief get the relevant detection_areas + * @return detection_areas + */ + [[nodiscard]] ConstPolygons3d detectionAreas() const; + [[nodiscard]] Polygons3d detectionAreas(); + + /** + * @brief add a new detection area + * @param primitive detection area to add + */ + void addDetectionArea(const Polygon3d & primitive); + + /** + * @brief remove a detection area + * @param primitive the primitive + * @return true if the detection area existed and was removed + */ + bool removeDetectionArea(const Polygon3d & primitive); + + /** + * @brief get the stop line for the detection area + * @return the stop line as LineString + */ + [[nodiscard]] ConstLineString3d stopLine() const; + [[nodiscard]] LineString3d stopLine(); + + /** + * @brief set a new stop line, overwrite the old one + * @param stopLine new stop line + */ + void setStopLine(const LineString3d & stopLine); + + //! Deletes the stop line + void removeStopLine(); + +private: + DetectionArea( + Id id, const AttributeMap & attributes, const Polygons3d & detectionAreas, + const LineString3d & stopLine); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit DetectionArea(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__DETECTION_AREA_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_parking_area.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_parking_area.hpp new file mode 100644 index 0000000..8ef43fa --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_parking_area.hpp @@ -0,0 +1,72 @@ +// Copyright 2023 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_PARKING_AREA_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_PARKING_AREA_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class NoParkingArea : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "no_parking_area"; + + static Ptr make(Id id, const AttributeMap & attributes, const Polygons3d & no_parking_areas) + { + return Ptr{new NoParkingArea(id, attributes, no_parking_areas)}; + } + + /** + * @brief get the relevant no parking area + * @return no parking area + */ + [[nodiscard]] ConstPolygons3d noParkingAreas() const; + [[nodiscard]] Polygons3d noParkingAreas(); + + /** + * @brief add a new no parking area + * @param primitive no parking area to add + */ + void addNoParkingArea(const Polygon3d & primitive); + + /** + * @brief remove a no parking area + * @param primitive the primitive + * @return true if the no parking area existed and was removed + */ + bool removeNoParkingArea(const Polygon3d & primitive); + +private: + NoParkingArea(Id id, const AttributeMap & attributes, const Polygons3d & no_parking_area); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit NoParkingArea(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_PARKING_AREA_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_stopping_area.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_stopping_area.hpp new file mode 100644 index 0000000..eaf263b --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/no_stopping_area.hpp @@ -0,0 +1,94 @@ +// Copyright 2021 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_STOPPING_AREA_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_STOPPING_AREA_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class NoStoppingArea : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "no_stopping_area"; + + //! Directly construct a stop line from its required rule parameters. + //! Might modify the input data in oder to get correct tags. + static Ptr make( + Id id, const AttributeMap & attributes, const Polygons3d & no_stopping_areas, + const Optional & stopLine = {}) + { + return Ptr{new NoStoppingArea(id, attributes, no_stopping_areas, stopLine)}; + } + + /** + * @brief get the relevant no stopping area + * @return no stopping area + */ + [[nodiscard]] ConstPolygons3d noStoppingAreas() const; + [[nodiscard]] Polygons3d noStoppingAreas(); + + /** + * @brief add a new no stopping area + * @param primitive no stopping area to add + */ + void addNoStoppingArea(const Polygon3d & primitive); + + /** + * @brief remove a no stopping area + * @param primitive the primitive + * @return true if the no stopping area existed and was removed + */ + bool removeNoStoppingArea(const Polygon3d & primitive); + + /** + * @brief get the stop line for the no stopping area + * @return the stop line as LineString + */ + [[nodiscard]] Optional stopLine() const; + [[nodiscard]] Optional stopLine(); + + /** + * @brief set a new stop line, overwrite the old one + * @param stopLine new stop line + */ + void setStopLine(const LineString3d & stopLine); + + //! Deletes the stop line + void removeStopLine(); + +private: + NoStoppingArea( + Id id, const AttributeMap & attributes, const Polygons3d & no_stopping_area, + const Optional & stopLine); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit NoStoppingArea(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__NO_STOPPING_AREA_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/road_marking.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/road_marking.hpp new file mode 100644 index 0000000..0fc4142 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/road_marking.hpp @@ -0,0 +1,72 @@ +// Copyright 2020 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__ROAD_MARKING_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__ROAD_MARKING_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class RoadMarking : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "road_marking"; + + //! Directly construct a stop line from its required rule parameters. + //! Might modify the input data in oder to get correct tags. + static Ptr make(Id id, const AttributeMap & attributes, const LineString3d & road_marking) + { + return Ptr{new RoadMarking(id, attributes, road_marking)}; + } + + /** + * @brief get the relevant road marking + * @return road marking + */ + [[nodiscard]] ConstLineString3d roadMarking() const; + [[nodiscard]] LineString3d roadMarking(); + + /** + * @brief add a new road marking + * @param primitive road marking to add + */ + void setRoadMarking(const LineString3d & road_marking); + + /** + * @brief remove a road marking + */ + void removeRoadMarking(); + +private: + RoadMarking(Id id, const AttributeMap & attributes, const LineString3d & road_marking); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit RoadMarking(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__ROAD_MARKING_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/speed_bump.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/speed_bump.hpp new file mode 100644 index 0000000..59c8d55 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/speed_bump.hpp @@ -0,0 +1,74 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome, Mehmet Dogru + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__SPEED_BUMP_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__SPEED_BUMP_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class SpeedBump : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + static constexpr char RuleName[] = "speed_bump"; + + static Ptr make(Id id, const AttributeMap & attributes, const Polygon3d & speed_bump) + { + return Ptr{new SpeedBump(id, attributes, speed_bump)}; + } + + /** + * @brief get the relevant speed bumps + * @return speed bumps + */ + [[nodiscard]] ConstPolygon3d speedBump() const; + [[nodiscard]] Polygon3d speedBump(); + + /** + * @brief add a new speed bump + * @param primitive speed bump to add + */ + void addSpeedBump(const Polygon3d & primitive); + + /** + * @brief remove a speed bump + * @param primitive speed bump to remove + * @return true if the speed bump existed and was removed + */ + bool removeSpeedBump(const Polygon3d & primitive); + +private: + SpeedBump(Id id, const AttributeMap & attributes, const Polygon3d & speed_bump); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit SpeedBump(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__SPEED_BUMP_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/regulatory_elements/virtual_traffic_light.hpp b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/virtual_traffic_light.hpp new file mode 100644 index 0000000..fdbb633 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/regulatory_elements/virtual_traffic_light.hpp @@ -0,0 +1,79 @@ +// Copyright 2021 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__REGULATORY_ELEMENTS__VIRTUAL_TRAFFIC_LIGHT_HPP_ +#define LANELET2_EXTENSION__REGULATORY_ELEMENTS__VIRTUAL_TRAFFIC_LIGHT_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +#include + +namespace lanelet::autoware +{ +class VirtualTrafficLight : public lanelet::RegulatoryElement +{ +public: + using Ptr = std::shared_ptr; + using ConstPtr = std::shared_ptr; + static constexpr char RuleName[] = "virtual_traffic_light"; + + static Ptr make( + const Id id, const AttributeMap & attributes, const LineString3d & virtual_traffic_light) + { + return Ptr{new VirtualTrafficLight(id, attributes, virtual_traffic_light)}; + } + + [[nodiscard]] ConstLineString3d getVirtualTrafficLight() const + { + return getParameters(RoleName::Refers).front(); + } + + [[nodiscard]] Optional getStopLine() const + { + const auto vec = getParameters(RoleName::RefLine); + if (vec.empty()) { + return {}; + } + return vec.front(); + } + + [[nodiscard]] ConstLineString3d getStartLine() const + { + return getParameters("start_line").front(); + } + + [[nodiscard]] ConstLineStrings3d getEndLines() const + { + return getParameters("end_line"); + } + +private: + VirtualTrafficLight( + const Id id, const AttributeMap & attributes, const LineString3d & virtual_traffic_light); + + // the following lines are required so that lanelet2 can create this object + // when loading a map with this regulatory element + friend class RegisterRegulatoryElement; + explicit VirtualTrafficLight(const lanelet::RegulatoryElementDataPtr & data); +}; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__REGULATORY_ELEMENTS__VIRTUAL_TRAFFIC_LIGHT_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/utility/message_conversion.hpp b/lanelet2_extension/include/lanelet2_extension/utility/message_conversion.hpp new file mode 100644 index 0000000..f88e5ce --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/utility/message_conversion.hpp @@ -0,0 +1,98 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__UTILITY__MESSAGE_CONVERSION_HPP_ +#define LANELET2_EXTENSION__UTILITY__MESSAGE_CONVERSION_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include +#include +#include + +#include +#include +#include + +namespace lanelet::utils::conversion +{ +/** + * [toBinMsg converts lanelet2 map to ROS message. Similar implementation to + * lanelet::io_handlers::BinHandler::write()] + * @param map [lanelet map data] + * @param msg [converted ROS message. Only "data" field is filled] + */ +void toBinMsg(const lanelet::LaneletMapPtr & map, autoware_auto_mapping_msgs::msg::HADMapBin * msg); + +/** + * [fromBinMsg converts ROS message into lanelet2 data. Similar implementation + * to lanelet::io_handlers::BinHandler::parse()] + * @param msg [ROS message for lanelet map] + * @param map [Converted lanelet2 data] + */ +void fromBinMsg(const autoware_auto_mapping_msgs::msg::HADMapBin & msg, lanelet::LaneletMapPtr map); +void fromBinMsg( + const autoware_auto_mapping_msgs::msg::HADMapBin & msg, lanelet::LaneletMapPtr map, + lanelet::traffic_rules::TrafficRulesPtr * traffic_rules, + lanelet::routing::RoutingGraphPtr * routing_graph); + +/** + * [toGeomMsgPt converts various point types to geometry_msgs point] + * @param src [input point(geometry_msgs::msg::Point3, + * Eigen::VEctor3d=lanelet::BasicPoint3d, lanelet::Point3d, lanelet::Point2d) ] + * @param dst [converted geometry_msgs point] + */ +void toGeomMsgPt(const geometry_msgs::msg::Point32 & src, geometry_msgs::msg::Point * dst); +void toGeomMsgPt(const Eigen::Vector3d & src, geometry_msgs::msg::Point * dst); +void toGeomMsgPt(const lanelet::ConstPoint3d & src, geometry_msgs::msg::Point * dst); +void toGeomMsgPt(const lanelet::ConstPoint2d & src, geometry_msgs::msg::Point * dst); + +/** + * [toGeomMsgPt converts various point types to geometry_msgs point] + * @param src [input point(geometry_msgs::msg::Point3, + * Eigen::VEctor3d=lanelet::BasicPoint3d, lanelet::Point3d, lanelet::Point2d) ] + * @return [converted geometry_msgs point] + */ +geometry_msgs::msg::Point toGeomMsgPt(const geometry_msgs::msg::Point32 & src); +geometry_msgs::msg::Point toGeomMsgPt(const Eigen::Vector3d & src); +geometry_msgs::msg::Point toGeomMsgPt(const lanelet::ConstPoint3d & src); +geometry_msgs::msg::Point toGeomMsgPt(const lanelet::ConstPoint2d & src); + +lanelet::ConstPoint3d toLaneletPoint(const geometry_msgs::msg::Point & src); +void toLaneletPoint(const geometry_msgs::msg::Point & src, lanelet::ConstPoint3d * dst); + +/** + * [toGeomMsgPoly converts lanelet polygon to geometry_msgs polygon] + * @param ll_poly [input polygon] + * @param geom_poly [converted geometry_msgs point] + */ +void toGeomMsgPoly( + const lanelet::ConstPolygon3d & ll_poly, geometry_msgs::msg::Polygon * geom_poly); + +/** + * [toGeomMsgPt32 converts Eigen::Vector3d(lanelet:BasicPoint3d to + * geometry_msgs::msg::Point32)] + * @param src [input point] + * @param dst [converted point] + */ +void toGeomMsgPt32(const Eigen::Vector3d & src, geometry_msgs::msg::Point32 * dst); + +} // namespace lanelet::utils::conversion + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__UTILITY__MESSAGE_CONVERSION_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/utility/query.hpp b/lanelet2_extension/include/lanelet2_extension/utility/query.hpp new file mode 100644 index 0000000..b094a2b --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/utility/query.hpp @@ -0,0 +1,301 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__UTILITY__QUERY_HPP_ +#define LANELET2_EXTENSION__UTILITY__QUERY_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" +#include "lanelet2_extension/regulatory_elements/crosswalk.hpp" +#include "lanelet2_extension/regulatory_elements/detection_area.hpp" +#include "lanelet2_extension/regulatory_elements/no_parking_area.hpp" +#include "lanelet2_extension/regulatory_elements/no_stopping_area.hpp" +#include "lanelet2_extension/regulatory_elements/speed_bump.hpp" + +#include +#include + +#include +#include +#include + +#include +#include +#include + +namespace lanelet::utils::query +{ +/** + * [laneletLayer converts laneletLayer into lanelet vector] + * @param ll_Map [input lanelet map] + * @return [all lanelets in the map] + */ +lanelet::ConstLanelets laneletLayer(const lanelet::LaneletMapConstPtr & ll_Map); + +/** + * [subtypeLanelets extracts Lanelet that has given subtype attribute] + * @param lls [input lanelets with various subtypes] + * @param subtype [subtype of lanelets to be retrieved (e.g. + * lanelet::AttributeValueString::Road)] + * @return [lanelets with given subtype] + */ +lanelet::ConstLanelets subtypeLanelets(const lanelet::ConstLanelets & lls, const char subtype[]); + +/** + * [crosswalkLanelets extracts crosswalk lanelets] + * @param lls [input lanelets with various subtypes] + * @return [crosswalk lanelets] + */ +lanelet::ConstLanelets crosswalkLanelets(const lanelet::ConstLanelets & lls); +lanelet::ConstLanelets walkwayLanelets(const lanelet::ConstLanelets & lls); + +/** + * [roadLanelets extracts road lanelets] + * @param lls [input lanelets with subtype road] + * @return [road lanelets] + */ +lanelet::ConstLanelets roadLanelets(const lanelet::ConstLanelets & lls); + +/** + * [shoulderLanelets extracts shoulder lanelets] + * @param lls [input lanelets with subtype shoulder] + * @return [shoulder lanelets] + */ +lanelet::ConstLanelets shoulderLanelets(const lanelet::ConstLanelets & lls); +/** + * [trafficLights extracts Traffic Light regulatory element from lanelets] + * @param lanelets [input lanelets] + * @return [traffic light that are associated with input lanelets] + */ +std::vector trafficLights(const lanelet::ConstLanelets & lanelets); + +/** + * [autowareTrafficLights extracts Autoware Traffic Light regulatory element + * from lanelets] + * @param lanelets [input lanelets] + * @return [autoware traffic light that are associated with input + * lanelets] + */ +std::vector autowareTrafficLights( + const lanelet::ConstLanelets & lanelets); + +/** + * [detectionAreas extracts Detection Area regulatory elements from lanelets] + * @param lanelets [input lanelets] + * @return [detection areas that are associated with input lanelets] + */ +std::vector detectionAreas(const lanelet::ConstLanelets & lanelets); + +/** + * [noStoppingArea extracts NoStopping Area regulatory elements from lanelets] + * @param lanelets [input lanelets] + * @return [no stopping areas that are associated with input lanelets] + */ +std::vector noStoppingAreas( + const lanelet::ConstLanelets & lanelets); + +/** + * [noParkingArea extracts NoParking Area regulatory elements from lanelets] + * @param lanelets [input lanelets] + * @return [no parking areas that are associated with input lanelets] + */ +std::vector noParkingAreas(const lanelet::ConstLanelets & lanelets); + +/** + * [speedBumps extracts Speed Bump regulatory elements from lanelets] + * @param lanelets [input lanelets] + * @return [speed bumps that are associated with input lanelets] + */ +std::vector speedBumps(const lanelet::ConstLanelets & lanelets); + +/** + * [crosswalks extracts Crosswalk regulatory elements from lanelets] + * @param lanelets [input lanelets] + * @return [crosswalks that are associated with input lanelets] + */ +std::vector crosswalks(const lanelet::ConstLanelets & lanelets); + +// query all curbstones in lanelet2 map +lanelet::ConstLineStrings3d curbstones(const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all polygons that has given type in lanelet2 map +lanelet::ConstPolygons3d getAllPolygonsByType( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr, const std::string & polygon_type); + +// query all obstacle polygons in lanelet2 map +lanelet::ConstPolygons3d getAllObstaclePolygons( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all parking lots in lanelet2 map +lanelet::ConstPolygons3d getAllParkingLots(const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all partitions in lanelet2 map +lanelet::ConstLineStrings3d getAllPartitions(const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all fences in lanelet2 map +lanelet::ConstLineStrings3d getAllFences(const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all pedestrian polygon markings in lanelet2 map +lanelet::ConstLineStrings3d getAllPedestrianPolygonMarkings( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all pedestrian line markings in lanelet2 map +lanelet::ConstLineStrings3d getAllPedestrianLineMarkings( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query all parking spaces in lanelet2 map +lanelet::ConstLineStrings3d getAllParkingSpaces( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// query linked parking spaces from lanelet +lanelet::ConstLineStrings3d getLinkedParkingSpaces( + const lanelet::ConstLanelet & lanelet, const lanelet::LaneletMapConstPtr & lanelet_map_ptr); +lanelet::ConstLineStrings3d getLinkedParkingSpaces( + const lanelet::ConstLanelet & lanelet, const lanelet::ConstLineStrings3d & all_parking_spaces, + const lanelet::ConstPolygons3d & all_parking_lots); +// query linked lanelets from parking space +bool getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstLanelets & all_road_lanelets, + const lanelet::ConstPolygons3d & all_parking_lots, lanelet::ConstLanelet * linked_lanelet); +bool getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::LaneletMapConstPtr & lanelet_map_ptr, lanelet::ConstLanelet * linked_lanelet); +lanelet::ConstLanelets getLinkedLanelets( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstLanelets & all_road_lanelets, + const lanelet::ConstPolygons3d & all_parking_lots); +lanelet::ConstLanelets getLinkedLanelets( + const lanelet::ConstLineString3d & parking_space, + const lanelet::LaneletMapConstPtr & lanelet_map_ptr); + +// get linked parking lot from lanelet +bool getLinkedParkingLot( + const lanelet::ConstLanelet & lanelet, const lanelet::ConstPolygons3d & all_parking_lots, + lanelet::ConstPolygon3d * linked_parking_lot); +// get linked parking lot from current pose of ego car +bool getLinkedParkingLot( + const lanelet::BasicPoint2d & current_position, const lanelet::ConstPolygons3d & all_parking_lots, + lanelet::ConstPolygon3d * linked_parking_lot); +// get linked parking lot from parking space +bool getLinkedParkingLot( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstPolygons3d & all_parking_lots, lanelet::ConstPolygon3d * linked_parking_lot); + +// query linked parking space from parking lot +lanelet::ConstLineStrings3d getLinkedParkingSpaces( + const lanelet::ConstPolygon3d & parking_lot, + const lanelet::ConstLineStrings3d & all_parking_spaces); +// query linked lanelets from parking lot +lanelet::ConstLanelets getLinkedLanelets( + const lanelet::ConstPolygon3d & parking_lot, const lanelet::ConstLanelets & all_road_lanelets); + +/** + * [stopLinesLanelets extracts stoplines that are associated to lanelets] + * @param lanelets [input lanelets] + * @return [stop lines that are associated with input lanelets] + */ +std::vector stopLinesLanelets(const lanelet::ConstLanelets & lanelets); + +/** + * [stopLinesLanelet extracts stop lines that are associated with a given + * lanelet] + * @param ll [input lanelet] + * @return [stop lines that are associated with input lanelet] + */ +std::vector stopLinesLanelet(const lanelet::ConstLanelet & ll); + +/** + * [stopSignStopLines extracts stoplines that are associated with stop signs] + * @param lanelets [input lanelets] + * @param stop_sign_id [sign id of stop sign] + * @return [array of stoplines] + */ +std::vector stopSignStopLines( + const lanelet::ConstLanelets & lanelets, const std::string & stop_sign_id = "stop_sign"); + +ConstLanelets getLaneletsWithinRange( + const lanelet::ConstLanelets & lanelets, const lanelet::BasicPoint2d & search_point, + const double range); +ConstLanelets getLaneletsWithinRange( + const lanelet::ConstLanelets & lanelets, const geometry_msgs::msg::Point & search_point, + const double range); + +ConstLanelets getLaneChangeableNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet); +ConstLanelets getLaneChangeableNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelets & road_lanelets, + const geometry_msgs::msg::Point & search_point); + +ConstLanelets getAllNeighbors(const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet); +ConstLanelets getAllNeighborsLeft( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet); +ConstLanelets getAllNeighborsRight( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet); +ConstLanelets getAllNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelets & road_lanelets, + const geometry_msgs::msg::Point & search_point); + +bool getClosestLanelet( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelet * closest_lanelet_ptr); + +bool getClosestLaneletWithConstrains( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelet * closest_lanelet_ptr, + const double dist_threshold = std::numeric_limits::max(), + const double yaw_threshold = std::numeric_limits::max()); + +bool getCurrentLanelets( + const ConstLanelets & lanelets, const geometry_msgs::msg::Point & search_point, + ConstLanelets * current_lanelets_ptr); + +bool getCurrentLanelets( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelets * current_lanelets_ptr); + +/** + * [getSucceedingLaneletSequences retrieves a sequence of lanelets after the given lanelet. + * The total length of retrieved lanelet sequence at least given length. Returned lanelet sequence + * does not include input lanelet.] + * @param graph [input lanelet routing graph] + * @param lanelet [input lanelet] + * @param length [minimum length of retrieved lanelet sequence] + * @return [lanelet sequence that follows given lanelet] + */ +std::vector getSucceedingLaneletSequences( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length); + +/** + * [getPrecedingLaneletSequences retrieves a sequence of lanelets before the given lanelet. + * The total length of retrieved lanelet sequence at least given length. Returned lanelet sequence + * does not include input lanelet.] + * @param graph [input lanelet routing graph] + * @param lanelet [input lanelet] + * @param length [minimum length of retrieved lanelet sequence] + * @return [lanelet sequence that leads to given lanelet] + */ +std::vector getPrecedingLaneletSequences( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length, const lanelet::ConstLanelets & exclude_lanelets = {}); + +} // namespace lanelet::utils::query + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__UTILITY__QUERY_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/utility/route_checker.hpp b/lanelet2_extension/include/lanelet2_extension/utility/route_checker.hpp new file mode 100644 index 0000000..5d4e7b7 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/utility/route_checker.hpp @@ -0,0 +1,33 @@ +// Copyright 2022 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef LANELET2_EXTENSION__UTILITY__ROUTE_CHECKER_HPP_ +#define LANELET2_EXTENSION__UTILITY__ROUTE_CHECKER_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include + +#include + +namespace lanelet::utils::route +{ +using autoware_planning_msgs::msg::LaneletRoute; + +bool isRouteValid(const LaneletRoute & route, const lanelet::LaneletMapPtr lanelet_map_ptr_); +} // namespace lanelet::utils::route + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__UTILITY__ROUTE_CHECKER_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/utility/utilities.hpp b/lanelet2_extension/include/lanelet2_extension/utility/utilities.hpp new file mode 100644 index 0000000..7df3f6a --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/utility/utilities.hpp @@ -0,0 +1,99 @@ +// Copyright 2015-2023 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Kenji Miyake, Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__UTILITY__UTILITIES_HPP_ +#define LANELET2_EXTENSION__UTILITY__UTILITIES_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include + +#include +#include +#include + +#include + +namespace lanelet::utils +{ + +// @brief combine multiple lanelets into one, solely focusing on the shape and discarding any +// associated information such as ID and attributes. InvalId is set for the ID. +// @param lanelets to be combined. +lanelet::ConstLanelet combineLaneletsShape(const lanelet::ConstLanelets & lanelets); + +lanelet::LineString3d generateFineCenterline( + const lanelet::ConstLanelet & lanelet_obj, const double resolution = 5.0); +lanelet::ConstLineString3d getCenterlineWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution = 5.0); +lanelet::ConstLineString3d getRightBoundWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution = 5.0); +lanelet::ConstLineString3d getLeftBoundWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution = 5.0); + +lanelet::ConstLanelet getExpandedLanelet( + const lanelet::ConstLanelet & lanelet_obj, const double left_offset, const double right_offset); + +lanelet::ConstLanelets getExpandedLanelets( + const lanelet::ConstLanelets & lanelet_obj, const double left_offset, const double right_offset); + +/** + * @brief Apply a patch for centerline because the original implementation + * doesn't have enough quality + */ +void overwriteLaneletsCenterline( + lanelet::LaneletMapPtr lanelet_map, const double resolution = 5.0, + const bool force_overwrite = false); + +lanelet::ConstLanelets getConflictingLanelets( + const lanelet::routing::RoutingGraphConstPtr & graph, const lanelet::ConstLanelet & lanelet); + +bool lineStringWithWidthToPolygon( + const lanelet::ConstLineString3d & linestring, lanelet::ConstPolygon3d * polygon); + +bool lineStringToPolygon( + const lanelet::ConstLineString3d & linestring, lanelet::ConstPolygon3d * polygon); + +double getLaneletLength2d(const lanelet::ConstLanelet & lanelet); +double getLaneletLength3d(const lanelet::ConstLanelet & lanelet); +double getLaneletLength2d(const lanelet::ConstLanelets & lanelet_sequence); +double getLaneletLength3d(const lanelet::ConstLanelets & lanelet_sequence); + +lanelet::ArcCoordinates getArcCoordinates( + const lanelet::ConstLanelets & lanelet_sequence, const geometry_msgs::msg::Pose & pose); + +lanelet::ConstLineString3d getClosestSegment( + const lanelet::BasicPoint2d & search_pt, const lanelet::ConstLineString3d & linestring); + +lanelet::CompoundPolygon3d getPolygonFromArcLength( + const lanelet::ConstLanelets & lanelets, const double s1, const double s2); +double getLaneletAngle( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Point & search_point); +bool isInLanelet( + const geometry_msgs::msg::Pose & current_pose, const lanelet::ConstLanelet & lanelet, + const double radius = 0.0); +geometry_msgs::msg::Pose getClosestCenterPose( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Point & search_point); +double getLateralDistanceToCenterline( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Pose & pose); +double getLateralDistanceToClosestLanelet( + const lanelet::ConstLanelets & lanelet_sequence, const geometry_msgs::msg::Pose & pose); +} // namespace lanelet::utils + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__UTILITY__UTILITIES_HPP_ diff --git a/lanelet2_extension/include/lanelet2_extension/visualization/visualization.hpp b/lanelet2_extension/include/lanelet2_extension/visualization/visualization.hpp new file mode 100644 index 0000000..c904c43 --- /dev/null +++ b/lanelet2_extension/include/lanelet2_extension/visualization/visualization.hpp @@ -0,0 +1,371 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +#ifndef LANELET2_EXTENSION__VISUALIZATION__VISUALIZATION_HPP_ +#define LANELET2_EXTENSION__VISUALIZATION__VISUALIZATION_HPP_ + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" +#include "lanelet2_extension/regulatory_elements/no_parking_area.hpp" +#include "lanelet2_extension/regulatory_elements/no_stopping_area.hpp" +#include "lanelet2_extension/utility/query.hpp" + +#include + +#include +#include + +#include +#include + +#include +#include + +namespace lanelet::visualization +{ +/** + * [lanelet2Triangle converts lanelet into vector of triangles. Used for + * triangulation] + * @param ll [input lanelet] + * @param triangles [array of polygon message, each containing 3 vertices] + */ +void lanelet2Triangle( + const lanelet::ConstLanelet & ll, std::vector * triangles); + +/** + * [polygon2Triangle converts polygon into vector of triangles] + * @param polygon [input polygon] + * @param triangles [array of polygon message, each containing 3 vertices] + */ +void polygon2Triangle( + const geometry_msgs::msg::Polygon & polygon, + std::vector * triangles); + +/** + * [lanelet2Polygon converts lanelet into a polygon] + * @param ll [input lanelet] + * @param polygon [polygon message containing shape of the input lanelet.] + */ +void lanelet2Polygon(const lanelet::ConstLanelet & ll, geometry_msgs::msg::Polygon * polygon); + +/** + * [initLineStringMarker initializes marker to visualize shape of linestring] + * @param marker [output marker message] + * @param frame_id [frame id of the marker] + * @param ns [namespace of the marker] + * @param c [color of the marker] + */ +void initLineStringMarker( + visualization_msgs::msg::Marker * marker, const std::string & frame_id, const std::string & ns, + const std_msgs::msg::ColorRGBA & c); + +/** + * [pushLineStringMarker pushes marker vertices to visualize shape of linestring] + * @param marker [output marker message] + * @param ls [input linestring] + * @param c [color of the marker] + * @param lss [thickness of the marker] + */ +void pushLineStringMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & c, const float lss = 0.1); + +/** + * [initArrowsMarker initializes marker to visualize arrows with TRIANGLE_LIST] + * @param marker [output marker message] + * @param frame_id [frame id of the marker] + * @param ns [namespace of the marker] + * @param c [color of the marker] + */ +void initArrowsMarker( + visualization_msgs::msg::Marker * marker, const std::string & frame_id, const std::string & ns, + const std_msgs::msg::ColorRGBA & c); + +/** + * [pushArrowsMarker pushes marker to visualize arrows with TRIANGLE_LIST] + * @param marker [output marker message] + * @param ls [input linestring] + * @param c [color of the marker] + */ +void pushArrowsMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & c); + +/** + * [initTrafficLightTriangleMarker initializes marker to visualize shape of traffic + * lights] + * @param marker [created marker] + * @param ns [namespace of the marker] + * @param duration [lifetime of the marker] + */ +void initTrafficLightTriangleMarker( + visualization_msgs::msg::Marker * marker, const std::string & ns, + const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [pushTrafficLightTriangleMarker pushes marker vertices to visualize shape of traffic + * lights] + * @param marker [created marker] + * @param ls [linestring that represents traffic light shape] + * @param cl [color of the marker] + * @param scale [scale of the marker] + */ +void pushTrafficLightTriangleMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & cl, const double scale = 1.0); + +/** + * [laneletsBoundaryAsMarkerArray create marker array to visualize shape of + * boundaries of lanelets] + * @param lanelets [input lanelets] + * @param c [color of the boundary] + * @param viz_centerline [flag to visualize centerline or not] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray laneletsBoundaryAsMarkerArray( + const lanelet::ConstLanelets & lanelets, const std_msgs::msg::ColorRGBA & c, + const bool viz_centerline, const std::string & additional_namespace = ""); +/** + * [laneletsAsTriangleMarkerArray create marker array to visualize shape of the + * lanelet] + * @param ns [namespace of the marker] + * @param lanelets [input lanelets] + * @param c [color of the marker] + * @return [created marker] + */ +visualization_msgs::msg::MarkerArray laneletsAsTriangleMarkerArray( + const std::string & ns, const lanelet::ConstLanelets & lanelets, + const std_msgs::msg::ColorRGBA & c); + +/** + * [laneletDirectionAsMarkerArray create marker array to visualize direction of + * the lanelet] + * @param lanelets [input lanelets] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray laneletDirectionAsMarkerArray( + const lanelet::ConstLanelets & lanelets, const std::string & additional_namespace = ""); + +/** + * [lineStringsAsMarkerArray creates marker array to visualize shape of + * linestrings] + * @param line_strings [input linestrings] + * @param name_space [namespace of the marker] + * @param c [color of the marker] + * @param lss [thickness of the marker] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray lineStringsAsMarkerArray( + const std::vector & line_strings, const std::string & name_space, + const std_msgs::msg::ColorRGBA & c, const float lss); + +/** + * [autowareTrafficLightsAsMarkerArray creates marker array to visualize traffic + * lights] + * @param tl_reg_elems [traffic light regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray autowareTrafficLightsAsMarkerArray( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0), + const double scale = 1.0); + +/** + * [generateTrafficLightRegulatoryElementIdMaker creates marker array to visualize traffic + * light regulatory element ids] + * @param lanelets [lanelets] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray generateTrafficLightRegulatoryElementIdMaker( + const lanelet::ConstLanelets & lanelets, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration = rclcpp::Duration(0, 0), const double scale = 0.5); + +/** + * [generateTrafficLightIdMarkerArray creates marker array to visualize traffic + * light ids] + * @param tl_reg_elems [traffic light regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray generateTrafficLightIdMaker( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0), + const double scale = 0.5); + +/** + * [trafficLightsAsTriangleMarkerArray creates marker array to visualize shape + * of traffic lights] + * @param tl_reg_elems [traffic light regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + * @return [created marker array] + */ +visualization_msgs::msg::MarkerArray trafficLightsAsTriangleMarkerArray( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0), + const double scale = 1.0); + +/** + * [detectionAreasAsMarkerArray creates marker array to visualize detection areas] + * @param da_reg_elems [detection area regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + */ +visualization_msgs::msg::MarkerArray detectionAreasAsMarkerArray( + const std::vector & da_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [noParkingAreasAsMarkerArray creates marker array to visualize detection areas] + * @param no_reg_elems [no parking area regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + */ +visualization_msgs::msg::MarkerArray noParkingAreasAsMarkerArray( + const std::vector & no_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [noStoppingAreasAsMarkerArray creates marker array to visualize detection areas] + * @param no_reg_elems [mp stopping area regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + */ +visualization_msgs::msg::MarkerArray noStoppingAreasAsMarkerArray( + const std::vector & no_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [speedBumpsAsMarkerArray creates marker array to visualize speed bumps] + * @param sb_reg_elems [speed bump regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + */ +visualization_msgs::msg::MarkerArray speedBumpsAsMarkerArray( + const std::vector & sb_reg_elems, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [crosswalkAreasAsMarkerArray creates marker array to visualize crosswalk regulatory element] + * @param sb_reg_elems [crosswalk regulatory elements] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + */ +visualization_msgs::msg::MarkerArray crosswalkAreasAsMarkerArray( + const std::vector & cw_reg_elems, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration = rclcpp::Duration(0, 0)); + +/** + * [pedestrianPolygonMarkingsAsMarkerArray creates marker array to visualize pedestrian polygon + * markings] + * @param pedestrian_polygon_markings [pedestrian marking polygon] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray pedestrianPolygonMarkingsAsMarkerArray( + const lanelet::ConstLineStrings3d & pedestrian_polygon_markings, + const std_msgs::msg::ColorRGBA & c); + +/** + * [pedestrianLineMarkingsAsMarkerArray creates marker array to visualize pedestrian line markings] + * @param pedestrian_line_markings [pedestrian marking line] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray pedestrianLineMarkingsAsMarkerArray( + const lanelet::ConstLineStrings3d & pedestrian_line_markings, const std_msgs::msg::ColorRGBA & c); + +/** + * [parkingLotsAsMarkerArray creates marker array to visualize parking lots] + * @param parking_lots [parking lot polygon] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray parkingLotsAsMarkerArray( + const lanelet::ConstPolygons3d & parking_lots, const std_msgs::msg::ColorRGBA & c); + +/** + * [parkingSpacesAsMarkerArray creates marker array to visualize parking spaces] + * @param parking_spaces [parking space line string] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray parkingSpacesAsMarkerArray( + const lanelet::ConstLineStrings3d & parking_spaces, const std_msgs::msg::ColorRGBA & c); + +/** + * [detectionAreasAsMarkerArray creates marker array to visualize lanelet_id] + * @param road_lanelets [road lanelets] + * @param c [color of the marker] + * @param duration [lifetime of the marker] + * @param ns [namespace of the marker] + * @param scale [scale of the marker] + * @return visualization_msgs::msg::MarkerArray + */ +visualization_msgs::msg::MarkerArray generateLaneletIdMarker( + const lanelet::ConstLanelets & road_lanelets, const std_msgs::msg::ColorRGBA & c, + const std::string & ns = "lanelet_id", const double scale = 0.5); + +visualization_msgs::msg::MarkerArray obstaclePolygonsAsMarkerArray( + const lanelet::ConstPolygons3d & obstacle_polygons, const std_msgs::msg::ColorRGBA & c); + +/** + * [intersectionAreaAsMarkerArray creates marker array to visualize intersection area] + * @param intersection_areas [intersection area polygon] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray intersectionAreaAsMarkerArray( + const lanelet::ConstPolygons3d & intersection_areas, const std_msgs::msg::ColorRGBA & c); + +/** + * [noObstacleSegmentationAreaAsMarkerArray creates marker array to visualize no obstacle + * segmentation area] + * @param no_obstacle_segmentation_area [no obstacle segmentation area polygon] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray noObstacleSegmentationAreaAsMarkerArray( + const lanelet::ConstPolygons3d & no_obstacle_segmentation_area, + const std_msgs::msg::ColorRGBA & c); + +/** + * [noObstacleSegmentationAreaForRunOutAsMarkerArray creates marker array to visualize no obstacle + * segmentation area for run out] + * @param no_obstacle_segmentation_area_for_run_out [no obstacle segmentation area for run out + * polygon] + * @param c [color of the marker] + */ +visualization_msgs::msg::MarkerArray noObstacleSegmentationAreaForRunOutAsMarkerArray( + const lanelet::ConstPolygons3d & no_obstacle_segmentation_area_for_run_out, + const std_msgs::msg::ColorRGBA & c); + +/** + * [hatchedRoadMarkingsAreaAsMarkerArray creates marker array to visualize hatched road markings + * area] + * @param hatched_road_markings_area [hatched road markings area polygon] + * @param area_color [color of the area marker] + * @param line_color [color of the line marker] + */ +visualization_msgs::msg::MarkerArray hatchedRoadMarkingsAreaAsMarkerArray( + const lanelet::ConstPolygons3d & hatched_road_markings_area, + const std_msgs::msg::ColorRGBA & area_color, const std_msgs::msg::ColorRGBA & line_color); + +} // namespace lanelet::visualization + +// NOLINTEND(readability-identifier-naming) + +#endif // LANELET2_EXTENSION__VISUALIZATION__VISUALIZATION_HPP_ diff --git a/lanelet2_extension/lib/autoware_osm_parser.cpp b/lanelet2_extension/lib/autoware_osm_parser.cpp new file mode 100644 index 0000000..5c27200 --- /dev/null +++ b/lanelet2_extension/lib/autoware_osm_parser.cpp @@ -0,0 +1,80 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/io/autoware_osm_parser.hpp" + +#include +#include +#include +#include + +#include +#include + +namespace lanelet::io_handlers +{ +std::unique_ptr AutowareOsmParser::parse( + const std::string & filename, ErrorMessages & errors) const +{ + auto map = OsmParser::parse(filename, errors); + + // rerun align function in just in case + for (Lanelet & lanelet : map->laneletLayer) { + LineString3d new_left; + LineString3d new_right; + std::tie(new_left, new_right) = geometry::align(lanelet.leftBound(), lanelet.rightBound()); + lanelet.setLeftBound(new_left); + lanelet.setRightBound(new_right); + } + + return map; +} + +namespace +{ +RegisterParser regParser; +} // namespace + +void AutowareOsmParser::parseVersions( + const std::string & filename, std::string * format_version, std::string * map_version) +{ + if (format_version == nullptr || map_version == nullptr) { + std::cerr << __FUNCTION__ << ": either format_version or map_version is null pointer!"; + return; + } + + pugi::xml_document doc; + auto result = doc.load_file(filename.c_str()); + if (!result) { + throw lanelet::ParseError( + std::string("Errors occurred while parsing osm file: ") + result.description()); + } + + auto osmNode = doc.child("osm"); + auto metainfo = osmNode.child("MetaInfo"); + if (metainfo.attribute("format_version")) { + *format_version = metainfo.attribute("format_version").value(); + } + if (metainfo.attribute("map_version")) { + *map_version = metainfo.attribute("map_version").value(); + } +} + +} // namespace lanelet::io_handlers + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/autoware_traffic_light.cpp b/lanelet2_extension/lib/autoware_traffic_light.cpp new file mode 100644 index 0000000..b0ab77a --- /dev/null +++ b/lanelet2_extension/lib/autoware_traffic_light.cpp @@ -0,0 +1,149 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +template +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return static_cast(elem); }; + return utils::transform(primitives, cast_func); +} + +template <> +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return elem.asRuleParameter(); }; + return utils::transform(primitives, cast_func); +} + +LineStringsOrPolygons3d getLsOrPoly(const RuleParameterMap & paramsMap, RoleName role) +{ + auto params = paramsMap.find(role); + if (params == paramsMap.end()) { + return {}; + } + LineStringsOrPolygons3d result; + for (auto & param : params->second) { + auto l = boost::get(¶m); + if (l != nullptr) { + result.push_back(*l); + } + auto p = boost::get(¶m); + if (p != nullptr) { + result.push_back(*p); + } + } + return result; +} + +[[maybe_unused]] ConstLineStringsOrPolygons3d getConstLsOrPoly( + const RuleParameterMap & params, RoleName role) +{ + auto cast_func = [](auto & lsOrPoly) { + return static_cast(lsOrPoly); + }; + return utils::transform(getLsOrPoly(params, role), cast_func); +} + +[[maybe_unused]] RegulatoryElementDataPtr constructAutowareTrafficLightData( + Id id, const AttributeMap & attributes, const LineStringsOrPolygons3d & trafficLights, + const Optional & stopLine, const LineStrings3d & lightBulbs) +{ + RuleParameterMap rpm = {{RoleNameString::Refers, toRuleParameters(trafficLights)}}; + + if (!!stopLine) { + RuleParameters rule_parameters = {*stopLine}; + rpm.insert(std::make_pair(RoleNameString::RefLine, rule_parameters)); + } + if (!lightBulbs.empty()) { + rpm.insert(std::make_pair( + AutowareTrafficLight::AutowareRoleNameString::LightBulbs, toRuleParameters(lightBulbs))); + } + + auto data = std::make_shared(id, rpm, attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = AttributeValueString::TrafficLight; + return data; +} +} // namespace + +AutowareTrafficLight::AutowareTrafficLight(const RegulatoryElementDataPtr & data) +: TrafficLight(data) +{ +} + +AutowareTrafficLight::AutowareTrafficLight( + Id id, const AttributeMap & attributes, const LineStringsOrPolygons3d & trafficLights, + const Optional & stopLine, const LineStrings3d & lightBulbs) +: TrafficLight(id, attributes, trafficLights, stopLine) +{ + for (const auto & lightBulb : lightBulbs) { + addLightBulbs(lightBulb); + } +} + +ConstLineStrings3d AutowareTrafficLight::lightBulbs() const +{ + return getParameters(AutowareRoleNameString::LightBulbs); +} + +void AutowareTrafficLight::addLightBulbs(const LineStringOrPolygon3d & primitive) +{ + parameters()[AutowareRoleNameString::LightBulbs].emplace_back(primitive.asRuleParameter()); +} + +bool AutowareTrafficLight::removeLightBulbs(const LineStringOrPolygon3d & primitive) +{ + return findAndErase( + primitive.asRuleParameter(), ¶meters().find(AutowareRoleNameString::LightBulbs)->second); +} + +RegisterRegulatoryElement regAutowareTrafficLight; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/crosswalk.cpp b/lanelet2_extension/lib/crosswalk.cpp new file mode 100644 index 0000000..19cb5ff --- /dev/null +++ b/lanelet2_extension/lib/crosswalk.cpp @@ -0,0 +1,132 @@ +// Copyright 2023 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/crosswalk.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +template +Optional tryGetFront(const std::vector & vec) +{ + if (vec.empty()) { + return {}; + } + return vec.front(); +} + +template +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return static_cast(elem); }; + return utils::transform(primitives, cast_func); +} + +RegulatoryElementDataPtr constructCrosswalk( + Id id, const AttributeMap & attributes, const Lanelet & crosswalkLanelet, + const Polygon3d & crosswalkArea, const LineStrings3d & stopLine) +{ + RuleParameterMap rpm; + + { + RuleParameters rule_parameters = {crosswalkArea}; + rpm.insert( + std::make_pair(Crosswalk::AutowareRoleNameString::CrosswalkPolygon, rule_parameters)); + } + + { + RuleParameters rule_parameters = {crosswalkLanelet}; + rpm.insert(std::make_pair(RoleNameString::Refers, rule_parameters)); + } + + for (const auto & line : stopLine) { + RuleParameters rule_parameters = {line}; + rpm.insert(std::make_pair(RoleNameString::RefLine, rule_parameters)); + } + + auto data = std::make_shared(id, std::move(rpm), attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "crosswalk"; + return data; +} +} // namespace + +Crosswalk::Crosswalk(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ +} + +Crosswalk::Crosswalk( + Id id, const AttributeMap & attributes, const Lanelet & crosswalk_lanelet, + const Polygon3d & crosswalk_area, const LineStrings3d & stop_line) +: Crosswalk(constructCrosswalk(id, attributes, crosswalk_lanelet, crosswalk_area, stop_line)) +{ +} + +ConstPolygons3d Crosswalk::crosswalkAreas() const +{ + return getParameters(AutowareRoleNameString::CrosswalkPolygon); +} + +ConstLineStrings3d Crosswalk::stopLines() const +{ + return getParameters(RoleName::RefLine); +} + +ConstLanelet Crosswalk::crosswalkLanelet() const +{ + return getParameters(RoleName::Refers).front(); +} + +void Crosswalk::addCrosswalkArea(const Polygon3d & primitive) +{ + parameters()["crosswalk"].emplace_back(primitive); +} + +bool Crosswalk::removeCrosswalkArea(const Polygon3d & primitive) +{ + return findAndErase(primitive, ¶meters().find("crosswalk")->second); +} + +RegisterRegulatoryElement regCrosswalk; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/detection_area.cpp b/lanelet2_extension/lib/detection_area.cpp new file mode 100644 index 0000000..ce7fb2d --- /dev/null +++ b/lanelet2_extension/lib/detection_area.cpp @@ -0,0 +1,162 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/detection_area.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +template +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return static_cast(elem); }; + return utils::transform(primitives, cast_func); +} + +// template <> +// RuleParameters toRuleParameters(const std::vector& primitives) +// { +// auto cast_func = [](const auto& elem) { return elem.asRuleParameter(); }; +// return utils::transform(primitives, cast_func); +// } + +Polygons3d getPoly(const RuleParameterMap & paramsMap, RoleName role) +{ + auto params = paramsMap.find(role); + if (params == paramsMap.end()) { + return {}; + } + + Polygons3d result; + for (auto & param : params->second) { + auto p = boost::get(¶m); + if (p != nullptr) { + result.push_back(*p); + } + } + return result; +} + +ConstPolygons3d getConstPoly(const RuleParameterMap & params, RoleName role) +{ + auto cast_func = [](auto & poly) { return static_cast(poly); }; + return utils::transform(getPoly(params, role), cast_func); +} + +RegulatoryElementDataPtr constructDetectionAreaData( + Id id, const AttributeMap & attributes, const Polygons3d & detectionAreas, + const LineString3d & stopLine) +{ + RuleParameterMap rpm = {{RoleNameString::Refers, toRuleParameters(detectionAreas)}}; + + RuleParameters rule_parameters = {stopLine}; + rpm.insert(std::make_pair(RoleNameString::RefLine, rule_parameters)); + + auto data = std::make_shared(id, rpm, attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "detection_area"; + return data; +} +} // namespace + +DetectionArea::DetectionArea(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ + if (getConstPoly(data->parameters, RoleName::Refers).empty()) { + throw InvalidInputError("No detection area defined!"); + } + if (getParameters(RoleName::RefLine).size() != 1) { + throw InvalidInputError("There must be exactly one stopline defined!"); + } +} + +DetectionArea::DetectionArea( + Id id, const AttributeMap & attributes, const Polygons3d & detectionAreas, + const LineString3d & stopLine) +: DetectionArea(constructDetectionAreaData(id, attributes, detectionAreas, stopLine)) +{ +} + +ConstPolygons3d DetectionArea::detectionAreas() const +{ + return getConstPoly(parameters(), RoleName::Refers); +} +Polygons3d DetectionArea::detectionAreas() +{ + return getPoly(parameters(), RoleName::Refers); +} + +void DetectionArea::addDetectionArea(const Polygon3d & primitive) +{ + parameters()["detection_area"].emplace_back(primitive); +} + +bool DetectionArea::removeDetectionArea(const Polygon3d & primitive) +{ + return findAndErase(primitive, ¶meters().find("detection_area")->second); +} + +ConstLineString3d DetectionArea::stopLine() const +{ + return getParameters(RoleName::RefLine).front(); +} + +LineString3d DetectionArea::stopLine() +{ + return getParameters(RoleName::RefLine).front(); +} + +void DetectionArea::setStopLine(const LineString3d & stopLine) +{ + parameters()[RoleName::RefLine] = {stopLine}; +} + +void DetectionArea::removeStopLine() +{ + parameters()[RoleName::RefLine] = {}; +} + +RegisterRegulatoryElement regDetectionArea; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/landmark.cpp b/lanelet2_extension/lib/landmark.cpp new file mode 100644 index 0000000..021103a --- /dev/null +++ b/lanelet2_extension/lib/landmark.cpp @@ -0,0 +1,50 @@ +// Copyright 2023 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "lanelet2_extension/localization/landmark.hpp" + +#include "lanelet2_extension/utility/message_conversion.hpp" + +#include + +#include + +namespace lanelet::localization +{ + +std::vector parseLandmarkPolygons( + const autoware_auto_mapping_msgs::msg::HADMapBin::ConstSharedPtr & msg, + const std::string & target_subtype) +{ + lanelet::LaneletMapPtr lanelet_map_ptr{std::make_shared()}; + lanelet::utils::conversion::fromBinMsg(*msg, lanelet_map_ptr); + + std::vector landmarks; + + for (const auto & poly : lanelet_map_ptr->polygonLayer) { + const std::string type{poly.attributeOr(lanelet::AttributeName::Type, "none")}; + if (type != "pose_marker") { + continue; + } + const std::string subtype{poly.attributeOr(lanelet::AttributeName::Subtype, "none")}; + if (subtype != target_subtype) { + continue; + } + landmarks.push_back(poly); + } + + return landmarks; +} + +} // namespace lanelet::localization diff --git a/lanelet2_extension/lib/message_conversion.cpp b/lanelet2_extension/lib/message_conversion.cpp new file mode 100644 index 0000000..53878e7 --- /dev/null +++ b/lanelet2_extension/lib/message_conversion.cpp @@ -0,0 +1,194 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/message_conversion.hpp" + +#include "lanelet2_extension/projection/mgrs_projector.hpp" + +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include + +namespace lanelet::utils::conversion +{ +void toBinMsg(const lanelet::LaneletMapPtr & map, autoware_auto_mapping_msgs::msg::HADMapBin * msg) +{ + if (msg == nullptr) { + std::cerr << __FUNCTION__ << "msg is null pointer!"; + return; + } + + std::stringstream ss; + boost::archive::binary_oarchive oa(ss); + oa << *map; + auto id_counter = lanelet::utils::getId(); + oa << id_counter; + + std::string data_str(ss.str()); + + msg->data.clear(); + msg->data.assign(data_str.begin(), data_str.end()); +} + +void fromBinMsg(const autoware_auto_mapping_msgs::msg::HADMapBin & msg, lanelet::LaneletMapPtr map) +{ + if (!map) { + std::cerr << __FUNCTION__ << ": map is null pointer!"; + return; + } + + std::string data_str; + data_str.assign(msg.data.begin(), msg.data.end()); + + std::stringstream ss; + ss << data_str; + boost::archive::binary_iarchive oa(ss); + oa >> *map; + lanelet::Id id_counter = 0; + oa >> id_counter; + lanelet::utils::registerId(id_counter); + // *map = std::move(laneletMap); +} + +void fromBinMsg( + const autoware_auto_mapping_msgs::msg::HADMapBin & msg, lanelet::LaneletMapPtr map, + lanelet::traffic_rules::TrafficRulesPtr * traffic_rules, + lanelet::routing::RoutingGraphPtr * routing_graph) +{ + fromBinMsg(msg, map); + *traffic_rules = lanelet::traffic_rules::TrafficRulesFactory::create( + lanelet::Locations::Germany, lanelet::Participants::Vehicle); + *routing_graph = lanelet::routing::RoutingGraph::build(*map, **traffic_rules); +} + +void toGeomMsgPt(const geometry_msgs::msg::Point32 & src, geometry_msgs::msg::Point * dst) +{ + if (dst == nullptr) { + std::cerr << __FUNCTION__ << "pointer is null!"; + return; + } + dst->x = src.x; + dst->y = src.y; + dst->z = src.z; +} +void toGeomMsgPt(const Eigen::Vector3d & src, geometry_msgs::msg::Point * dst) +{ + if (dst == nullptr) { + std::cerr << __FUNCTION__ << "pointer is null!"; + return; + } + dst->x = src.x(); + dst->y = src.y(); + dst->z = src.z(); +} +void toGeomMsgPt(const lanelet::ConstPoint3d & src, geometry_msgs::msg::Point * dst) +{ + if (dst == nullptr) { + std::cerr << __FUNCTION__ << "pointer is null!"; + return; + } + dst->x = src.x(); + dst->y = src.y(); + dst->z = src.z(); +} +void toGeomMsgPt(const lanelet::ConstPoint2d & src, geometry_msgs::msg::Point * dst) +{ + if (dst == nullptr) { + std::cerr << __FUNCTION__ << "pointer is null!" << std::endl; + return; + } + dst->x = src.x(); + dst->y = src.y(); + dst->z = 0; +} + +void toGeomMsgPt32(const Eigen::Vector3d & src, geometry_msgs::msg::Point32 * dst) +{ + if (dst == nullptr) { + std::cerr << __FUNCTION__ << "pointer is null!" << std::endl; + return; + } + dst->x = static_cast(src.x()); + dst->y = static_cast(src.y()); + dst->z = static_cast(src.z()); +} + +geometry_msgs::msg::Point toGeomMsgPt(const geometry_msgs::msg::Point32 & src) +{ + geometry_msgs::msg::Point dst; + toGeomMsgPt(src, &dst); + return dst; +} +geometry_msgs::msg::Point toGeomMsgPt(const Eigen::Vector3d & src) +{ + geometry_msgs::msg::Point dst; + toGeomMsgPt(src, &dst); + return dst; +} +geometry_msgs::msg::Point toGeomMsgPt(const lanelet::ConstPoint3d & src) +{ + geometry_msgs::msg::Point dst; + toGeomMsgPt(src, &dst); + return dst; +} +geometry_msgs::msg::Point toGeomMsgPt(const lanelet::ConstPoint2d & src) +{ + geometry_msgs::msg::Point dst; + toGeomMsgPt(src, &dst); + return dst; +} + +lanelet::ConstPoint3d toLaneletPoint(const geometry_msgs::msg::Point & src) +{ + lanelet::ConstPoint3d dst; + toLaneletPoint(src, &dst); + return dst; +} + +void toLaneletPoint(const geometry_msgs::msg::Point & src, lanelet::ConstPoint3d * dst) +{ + *dst = lanelet::Point3d(lanelet::InvalId, src.x, src.y, src.z); +} + +void toGeomMsgPoly(const lanelet::ConstPolygon3d & ll_poly, geometry_msgs::msg::Polygon * geom_poly) +{ + geom_poly->points.clear(); + geom_poly->points.reserve(ll_poly.size()); + for (const auto & ll_pt : ll_poly) { + geometry_msgs::msg::Point32 geom_pt32; + utils::conversion::toGeomMsgPt32(ll_pt.basicPoint(), &geom_pt32); + geom_poly->points.push_back(geom_pt32); + } +} + +} // namespace lanelet::utils::conversion + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/mgrs_projector.cpp b/lanelet2_extension/lib/mgrs_projector.cpp new file mode 100644 index 0000000..891df1b --- /dev/null +++ b/lanelet2_extension/lib/mgrs_projector.cpp @@ -0,0 +1,135 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/projection/mgrs_projector.hpp" + +#include +#include +#include +#include +#include + +namespace lanelet::projection +{ +MGRSProjector::MGRSProjector(Origin origin) : Projector(origin) +{ +} + +BasicPoint3d MGRSProjector::forward(const GPSPoint & gps) const +{ + BasicPoint3d mgrs_point(forward(gps, 0)); + return mgrs_point; +} + +BasicPoint3d MGRSProjector::forward(const GPSPoint & gps, const int precision) const +{ + std::string prev_projected_grid = projected_grid_; + + BasicPoint3d mgrs_point{0., 0., gps.ele}; + BasicPoint3d utm_point{0., 0., gps.ele}; + int zone{}; + bool is_north{}; + std::string mgrs_code; + + try { + GeographicLib::UTMUPS::Forward(gps.lat, gps.lon, zone, is_north, utm_point.x(), utm_point.y()); + GeographicLib::MGRS::Forward( + zone, is_north, utm_point.x(), utm_point.y(), gps.lat, precision, mgrs_code); + } catch (const GeographicLib::GeographicErr & err) { + std::cerr << err.what() << std::endl; + return mgrs_point; + } + + // get mgrs values from utm values + mgrs_point.x() = fmod(utm_point.x(), 1e5); + mgrs_point.y() = fmod(utm_point.y(), 1e5); + projected_grid_ = mgrs_code; + + if (!prev_projected_grid.empty() && prev_projected_grid != projected_grid_) { + std::cerr << "Projected MGRS Grid changed from last projection. Projected point" + "might be far away from previously projected point." + << std::endl + << "You may want to use different projector."; + } + + return mgrs_point; +} + +GPSPoint MGRSProjector::reverse(const BasicPoint3d & mgrs_point) const +{ + GPSPoint gps{0., 0., 0.}; + // reverse function cannot be used if mgrs_code_ is not set + if (isMGRSCodeSet()) { + gps = reverse(mgrs_point, mgrs_code_); + } else if (!projected_grid_.empty()) { + gps = reverse(mgrs_point, projected_grid_); + } else { + std::cerr << "cannot run reverse operation if mgrs code is not set in projector." << std::endl + << "use setMGRSCode function or explicitly give mgrs code as an argument."; + } + return gps; +} + +GPSPoint MGRSProjector::reverse(const BasicPoint3d & mgrs_point, const std::string & mgrs_code) +{ + GPSPoint gps{0., 0., mgrs_point.z()}; + BasicPoint3d utm_point{0., 0., gps.ele}; + + int zone{}; + int prec{}; + bool is_north{}; + try { + GeographicLib::MGRS::Reverse( + mgrs_code, zone, is_north, utm_point.x(), utm_point.y(), prec, false); + utm_point.x() += fmod(mgrs_point.x(), pow(10, 5 - prec)); + utm_point.y() += fmod(mgrs_point.y(), pow(10, 5 - prec)); + GeographicLib::UTMUPS::Reverse(zone, is_north, utm_point.x(), utm_point.y(), gps.lat, gps.lon); + } catch (const GeographicLib::GeographicErr & err) { + std::cerr << "Failed to convert from MGRS to WGS"; + return gps; + } + + return gps; +} + +void MGRSProjector::setMGRSCode(const std::string & mgrs_code) +{ + mgrs_code_ = mgrs_code; +} + +void MGRSProjector::setMGRSCode(const GPSPoint & gps, const int precision) +{ + BasicPoint3d utm_point{0., 0., gps.ele}; + int zone{}; + bool is_north{}; + std::string mgrs_code; + + try { + GeographicLib::UTMUPS::Forward(gps.lat, gps.lon, zone, is_north, utm_point.x(), utm_point.y()); + GeographicLib::MGRS::Forward( + zone, is_north, utm_point.x(), utm_point.y(), gps.lat, precision, mgrs_code); + } catch (const GeographicLib::GeographicErr & err) { + std::cerr << err.what() << std::endl; + } + + setMGRSCode(mgrs_code); +} + +} // namespace lanelet::projection + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/no_parking_area.cpp b/lanelet2_extension/lib/no_parking_area.cpp new file mode 100644 index 0000000..ee282ba --- /dev/null +++ b/lanelet2_extension/lib/no_parking_area.cpp @@ -0,0 +1,134 @@ +// Copyright 2023 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/no_parking_area.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +template +Optional tryGetFront(const std::vector & vec) +{ + if (vec.empty()) { + return {}; + } + return vec.front(); +} + +template +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return static_cast(elem); }; + return utils::transform(primitives, cast_func); +} + +Polygons3d getPoly(const RuleParameterMap & paramsMap, RoleName role) +{ + auto params = paramsMap.find(role); + if (params == paramsMap.end()) { + return {}; + } + + Polygons3d result; + for (auto & param : params->second) { + auto p = boost::get(¶m); + if (p != nullptr) { + result.push_back(*p); + } + } + return result; +} + +ConstPolygons3d getConstPoly(const RuleParameterMap & params, RoleName role) +{ + auto cast_func = [](auto & poly) { return static_cast(poly); }; + return utils::transform(getPoly(params, role), cast_func); +} + +RegulatoryElementDataPtr constructNoParkingAreaData( + Id id, const AttributeMap & attributes, const Polygons3d & NoParkingAreas) +{ + RuleParameterMap rpm = {{RoleNameString::Refers, toRuleParameters(NoParkingAreas)}}; + + auto data = std::make_shared(id, std::move(rpm), attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "no_parking_area"; + return data; +} +} // namespace + +NoParkingArea::NoParkingArea(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ + if (getConstPoly(data->parameters, RoleName::Refers).empty()) { + throw InvalidInputError("no parking area defined!"); + } +} + +NoParkingArea::NoParkingArea( + Id id, const AttributeMap & attributes, const Polygons3d & no_parking_areas) +: NoParkingArea(constructNoParkingAreaData(id, attributes, no_parking_areas)) +{ +} + +ConstPolygons3d NoParkingArea::noParkingAreas() const +{ + return getConstPoly(parameters(), RoleName::Refers); +} +Polygons3d NoParkingArea::noParkingAreas() +{ + return getPoly(parameters(), RoleName::Refers); +} + +void NoParkingArea::addNoParkingArea(const Polygon3d & primitive) +{ + parameters()["no_parking_area"].emplace_back(primitive); +} + +bool NoParkingArea::removeNoParkingArea(const Polygon3d & primitive) +{ + return findAndErase(primitive, ¶meters().find("no_parking_area")->second); +} + +RegisterRegulatoryElement regNoParkingArea; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/no_stopping_area.cpp b/lanelet2_extension/lib/no_stopping_area.cpp new file mode 100644 index 0000000..afade90 --- /dev/null +++ b/lanelet2_extension/lib/no_stopping_area.cpp @@ -0,0 +1,162 @@ +// Copyright 2021 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/no_stopping_area.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +template +Optional tryGetFront(const std::vector & vec) +{ + if (vec.empty()) { + return {}; + } + return vec.front(); +} + +template +RuleParameters toRuleParameters(const std::vector & primitives) +{ + auto cast_func = [](const auto & elem) { return static_cast(elem); }; + return utils::transform(primitives, cast_func); +} + +Polygons3d getPoly(const RuleParameterMap & paramsMap, RoleName role) +{ + auto params = paramsMap.find(role); + if (params == paramsMap.end()) { + return {}; + } + + Polygons3d result; + for (auto & param : params->second) { + auto p = boost::get(¶m); + if (p != nullptr) { + result.push_back(*p); + } + } + return result; +} + +ConstPolygons3d getConstPoly(const RuleParameterMap & params, RoleName role) +{ + auto cast_func = [](auto & poly) { return static_cast(poly); }; + return utils::transform(getPoly(params, role), cast_func); +} + +RegulatoryElementDataPtr constructNoStoppingAreaData( + Id id, const AttributeMap & attributes, const Polygons3d & noStoppingAreas, + const Optional & stopLine = {}) +{ + RuleParameterMap rpm = {{RoleNameString::Refers, toRuleParameters(noStoppingAreas)}}; + if (!!stopLine) { + rpm.insert({RoleNameString::RefLine, {*stopLine}}); + } + + auto data = std::make_shared(id, std::move(rpm), attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "no_stopping_area"; + return data; +} +} // namespace + +NoStoppingArea::NoStoppingArea(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ + if (getConstPoly(data->parameters, RoleName::Refers).empty()) { + throw InvalidInputError("no stopping area defined!"); + } + if (getParameters(RoleName::RefLine).size() > 1) { + throw InvalidInputError("There can not exist more than one stop line!"); + } +} + +NoStoppingArea::NoStoppingArea( + Id id, const AttributeMap & attributes, const Polygons3d & no_stopping_areas, + const Optional & stopLine) +: NoStoppingArea(constructNoStoppingAreaData(id, attributes, no_stopping_areas, stopLine)) +{ +} + +ConstPolygons3d NoStoppingArea::noStoppingAreas() const +{ + return getConstPoly(parameters(), RoleName::Refers); +} +Polygons3d NoStoppingArea::noStoppingAreas() +{ + return getPoly(parameters(), RoleName::Refers); +} + +void NoStoppingArea::addNoStoppingArea(const Polygon3d & primitive) +{ + parameters()["no_stopping_area"].emplace_back(primitive); +} + +bool NoStoppingArea::removeNoStoppingArea(const Polygon3d & primitive) +{ + return findAndErase(primitive, ¶meters().find("no_stopping_area")->second); +} + +Optional NoStoppingArea::stopLine() const +{ + return tryGetFront(getParameters(RoleName::RefLine)); +} + +Optional NoStoppingArea::stopLine() +{ + return tryGetFront(getParameters(RoleName::RefLine)); +} + +void NoStoppingArea::setStopLine(const LineString3d & stopLine) +{ + parameters()[RoleName::RefLine] = {stopLine}; +} + +void NoStoppingArea::removeStopLine() +{ + parameters()[RoleName::RefLine] = {}; +} + +RegisterRegulatoryElement regNoStoppingArea; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/query.cpp b/lanelet2_extension/lib/query.cpp new file mode 100644 index 0000000..a505c12 --- /dev/null +++ b/lanelet2_extension/lib/query.cpp @@ -0,0 +1,1125 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/query.hpp" + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" +#include "lanelet2_extension/regulatory_elements/crosswalk.hpp" +#include "lanelet2_extension/regulatory_elements/detection_area.hpp" +#include "lanelet2_extension/regulatory_elements/no_parking_area.hpp" +#include "lanelet2_extension/regulatory_elements/no_stopping_area.hpp" +#include "lanelet2_extension/regulatory_elements/speed_bump.hpp" +#include "lanelet2_extension/utility/message_conversion.hpp" +#include "lanelet2_extension/utility/utilities.hpp" + +#include +#include + +#include +#include +#include +#include +#include +#ifdef ROS_DISTRO_GALACTIC +#include "tf2_geometry_msgs/tf2_geometry_msgs.h" +#else +#include "tf2_geometry_msgs/tf2_geometry_msgs.hpp" +#endif + +#include +#include +#include +#include +#include +#include + +using lanelet::utils::to2D; + +namespace lanelet::utils +{ +// returns all lanelets in laneletLayer - don't know how to convert +// PrimitiveLayer -> std::vector +lanelet::ConstLanelets query::laneletLayer(const lanelet::LaneletMapConstPtr & ll_map) +{ + lanelet::ConstLanelets lanelets; + if (!ll_map) { + std::cerr << "No map received!"; + return lanelets; + } + + for (const auto & li : ll_map->laneletLayer) { + lanelets.push_back(li); + } + + return lanelets; +} + +lanelet::ConstLanelets query::subtypeLanelets( + const lanelet::ConstLanelets & lls, const char subtype[]) +{ + lanelet::ConstLanelets subtype_lanelets; + + for (const auto & ll : lls) { + if (ll.hasAttribute(lanelet::AttributeName::Subtype)) { + const lanelet::Attribute & attr = ll.attribute(lanelet::AttributeName::Subtype); + if (attr.value() == subtype) { + subtype_lanelets.push_back(ll); + } + } + } + + return subtype_lanelets; +} + +lanelet::ConstLanelets query::crosswalkLanelets(const lanelet::ConstLanelets & lls) +{ + return query::subtypeLanelets(lls, lanelet::AttributeValueString::Crosswalk); +} + +lanelet::ConstLanelets query::walkwayLanelets(const lanelet::ConstLanelets & lls) +{ + return query::subtypeLanelets(lls, lanelet::AttributeValueString::Walkway); +} + +lanelet::ConstLanelets query::roadLanelets(const lanelet::ConstLanelets & lls) +{ + return query::subtypeLanelets(lls, lanelet::AttributeValueString::Road); +} + +lanelet::ConstLanelets query::shoulderLanelets(const lanelet::ConstLanelets & lls) +{ + return query::subtypeLanelets(lls, "road_shoulder"); +} + +std::vector query::trafficLights( + const lanelet::ConstLanelets & lanelets) +{ + std::vector tl_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_tl_re = + ll.regulatoryElementsAs(); + + // insert unique tl into array + for (const auto & tl_ptr : ll_tl_re) { + lanelet::Id id = tl_ptr->id(); + bool unique_id = true; + for (const auto & tl_reg_elem : tl_reg_elems) { + if (id == tl_reg_elem->id()) { + unique_id = false; + break; + } + } + if (unique_id) { + tl_reg_elems.push_back(tl_ptr); + } + } + } + return tl_reg_elems; +} + +std::vector query::autowareTrafficLights( + const lanelet::ConstLanelets & lanelets) +{ + std::vector tl_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_tl_re = + ll.regulatoryElementsAs(); + + // insert unique tl into array + for (const auto & tl_ptr : ll_tl_re) { + lanelet::Id id = tl_ptr->id(); + bool unique_id = true; + + for (const auto & tl_reg_elem : tl_reg_elems) { + if (id == tl_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + tl_reg_elems.push_back(tl_ptr); + } + } + } + return tl_reg_elems; +} + +std::vector query::detectionAreas( + const lanelet::ConstLanelets & lanelets) +{ + std::vector da_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_da_re = + ll.regulatoryElementsAs(); + + // insert unique tl into array + for (const auto & da_ptr : ll_da_re) { + lanelet::Id id = da_ptr->id(); + bool unique_id = true; + + for (const auto & da_reg_elem : da_reg_elems) { + if (id == da_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + da_reg_elems.push_back(da_ptr); + } + } + } + return da_reg_elems; +} + +std::vector query::noStoppingAreas( + const lanelet::ConstLanelets & lanelets) +{ + std::vector no_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_no_re = + ll.regulatoryElementsAs(); + + // insert unique tl into array + for (const auto & no_ptr : ll_no_re) { + lanelet::Id id = no_ptr->id(); + bool unique_id = true; + + for (const auto & no_reg_elem : no_reg_elems) { + if (id == no_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + no_reg_elems.push_back(no_ptr); + } + } + } + return no_reg_elems; +} + +std::vector query::noParkingAreas( + const lanelet::ConstLanelets & lanelets) +{ + std::vector no_pa_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_no_pa_re = + ll.regulatoryElementsAs(); + + // insert unique NoParkingArea into array + for (const auto & no_pa_ptr : ll_no_pa_re) { + lanelet::Id id = no_pa_ptr->id(); + bool unique_id = true; + + for (const auto & no_reg_elem : no_pa_reg_elems) { + if (id == no_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + no_pa_reg_elems.push_back(no_pa_ptr); + } + } + } + return no_pa_reg_elems; +} + +std::vector query::speedBumps(const lanelet::ConstLanelets & lanelets) +{ + std::vector sb_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_sb_re = + ll.regulatoryElementsAs(); + + // insert unique id into array + for (const auto & sb_ptr : ll_sb_re) { + lanelet::Id id = sb_ptr->id(); + bool unique_id = true; + + for (const auto & sb_reg_elem : sb_reg_elems) { + if (id == sb_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + sb_reg_elems.push_back(sb_ptr); + } + } + } + return sb_reg_elems; +} + +std::vector query::crosswalks(const lanelet::ConstLanelets & lanelets) +{ + std::vector cw_reg_elems; + + for (const auto & ll : lanelets) { + std::vector ll_cw_re = + ll.regulatoryElementsAs(); + + // insert unique id into array + for (const auto & cw_ptr : ll_cw_re) { + lanelet::Id id = cw_ptr->id(); + bool unique_id = true; + + for (const auto & cw_reg_elem : cw_reg_elems) { + if (id == cw_reg_elem->id()) { + unique_id = false; + break; + } + } + + if (unique_id) { + cw_reg_elems.push_back(cw_ptr); + } + } + } + return cw_reg_elems; +} + +lanelet::ConstLineStrings3d query::curbstones(const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d curbstones; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "curbstone") { + curbstones.push_back(ls); + } + } + return curbstones; +} + +lanelet::ConstPolygons3d query::getAllPolygonsByType( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr, const std::string & polygon_type) +{ + lanelet::ConstPolygons3d polygons; + for (const auto & poly : lanelet_map_ptr->polygonLayer) { + const std::string type = poly.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == polygon_type) { + polygons.push_back(poly); + } + } + return polygons; +} + +lanelet::ConstPolygons3d query::getAllObstaclePolygons( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstPolygons3d obstacle_polygons; + for (const auto & poly : lanelet_map_ptr->polygonLayer) { + const std::string type = poly.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "obstacle") { + obstacle_polygons.push_back(poly); + } + } + return obstacle_polygons; +} + +lanelet::ConstPolygons3d query::getAllParkingLots( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstPolygons3d parking_lots; + for (const auto & poly : lanelet_map_ptr->polygonLayer) { + const std::string type = poly.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "parking_lot") { + parking_lots.push_back(poly); + } + } + return parking_lots; +} + +lanelet::ConstLineStrings3d query::getAllPartitions( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d partitions; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "guard_rail" || type == "fence" || type == "wall") { + partitions.push_back(ls); + } + } + return partitions; +} + +lanelet::ConstLineStrings3d query::getAllFences(const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d fences; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "fence") { + fences.push_back(ls); + } + } + return fences; +} + +lanelet::ConstLineStrings3d query::getAllPedestrianPolygonMarkings( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d pedestrian_polygon_markings; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if ((type == "pedestrian_marking") && (ls.size() >= 3)) { + pedestrian_polygon_markings.push_back(ls); + } + } + return pedestrian_polygon_markings; +} + +lanelet::ConstLineStrings3d query::getAllPedestrianLineMarkings( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d pedestrian_line_markings; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if ((type == "pedestrian_marking") && (ls.size() < 3)) { + pedestrian_line_markings.push_back(ls); + } + } + return pedestrian_line_markings; +} + +lanelet::ConstLineStrings3d query::getAllParkingSpaces( + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLineStrings3d parking_spaces; + for (const auto & ls : lanelet_map_ptr->lineStringLayer) { + const std::string type = ls.attributeOr(lanelet::AttributeName::Type, "none"); + if (type == "parking_space") { + parking_spaces.push_back(ls); + } + } + return parking_spaces; +} + +bool query::getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::LaneletMapConstPtr & lanelet_map_ptr, lanelet::ConstLanelet * linked_lanelet) +{ + const auto & all_lanelets = query::laneletLayer(lanelet_map_ptr); + const auto & all_road_lanelets = query::roadLanelets(all_lanelets); + const auto & all_parking_lots = query::getAllParkingLots(lanelet_map_ptr); + return query::getLinkedLanelet( + parking_space, all_road_lanelets, all_parking_lots, linked_lanelet); +} + +bool query::getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstLanelets & all_road_lanelets, + const lanelet::ConstPolygons3d & all_parking_lots, lanelet::ConstLanelet * linked_lanelet) +{ + const auto & linked_lanelets = + getLinkedLanelets(parking_space, all_road_lanelets, all_parking_lots); + if (linked_lanelets.empty()) { + return false; + } + + double min_distance = std::numeric_limits::max(); + for (const auto & lanelet : linked_lanelets) { + const double distance = boost::geometry::distance( + to2D(parking_space).basicLineString(), lanelet.polygon2d().basicPolygon()); + if (distance < min_distance) { + *linked_lanelet = lanelet; + min_distance = distance; + } + } + return true; +} + +lanelet::ConstLanelets query::getLinkedLanelets( + const lanelet::ConstLineString3d & parking_space, + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + const auto & all_lanelets = query::laneletLayer(lanelet_map_ptr); + const auto & all_road_lanelets = query::roadLanelets(all_lanelets); + const auto & all_parking_lots = query::getAllParkingLots(lanelet_map_ptr); + + return query::getLinkedLanelets(parking_space, all_road_lanelets, all_parking_lots); +} + +lanelet::ConstLanelets query::getLinkedLanelets( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstLanelets & all_road_lanelets, + const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstLanelets linked_lanelets; + + // get lanelets within same parking lot + lanelet::ConstPolygon3d linked_parking_lot; + if (!getLinkedParkingLot(parking_space, all_parking_lots, &linked_parking_lot)) { + return linked_lanelets; + } + const auto & candidate_lanelets = getLinkedLanelets(linked_parking_lot, all_road_lanelets); + + // get lanelets that are close to parking space and facing to parking space + for (const auto & lanelet : candidate_lanelets) { + // check if parking space is close to lanelet + const double distance = boost::geometry::distance( + to2D(parking_space).basicLineString(), lanelet.polygon2d().basicPolygon()); + constexpr double distance_thresh = 5.0; + if (distance > distance_thresh) { + continue; + } + + // check if parking space is facing lanelet + const Eigen::Vector3d direction = + parking_space.back().basicPoint() - parking_space.front().basicPoint(); + const Eigen::Vector3d new_pt = parking_space.front().basicPoint() - direction * distance_thresh; + + const lanelet::Point3d check_line_p1(lanelet::InvalId, new_pt.x(), new_pt.y(), new_pt.z()); + const lanelet::Point3d check_line_p2(lanelet::InvalId, parking_space.back().basicPoint()); + const lanelet::LineString3d check_line(lanelet::InvalId, {check_line_p1, check_line_p2}); + + const double new_distance = boost::geometry::distance( + to2D(check_line).basicLineString(), lanelet.polygon2d().basicPolygon()); + if (new_distance < std::numeric_limits::epsilon()) { + linked_lanelets.push_back(lanelet); + } + } + + return linked_lanelets; +} + +// get overlapping lanelets +lanelet::ConstLanelets query::getLinkedLanelets( + const lanelet::ConstPolygon3d & parking_lot, const lanelet::ConstLanelets & all_road_lanelets) +{ + lanelet::ConstLanelets linked_lanelets; + for (const auto & lanelet : all_road_lanelets) { + const double distance = boost::geometry::distance( + lanelet.polygon2d().basicPolygon(), to2D(parking_lot).basicPolygon()); + if (distance < std::numeric_limits::epsilon()) { + linked_lanelets.push_back(lanelet); + } + } + return linked_lanelets; +} + +lanelet::ConstLineStrings3d query::getLinkedParkingSpaces( + const lanelet::ConstLanelet & lanelet, const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + const auto & all_parking_spaces = query::getAllParkingSpaces(lanelet_map_ptr); + const auto & all_parking_lots = query::getAllParkingLots(lanelet_map_ptr); + return getLinkedParkingSpaces(lanelet, all_parking_spaces, all_parking_lots); +} + +lanelet::ConstLineStrings3d query::getLinkedParkingSpaces( + const lanelet::ConstLanelet & lanelet, const lanelet::ConstLineStrings3d & all_parking_spaces, + const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstLineStrings3d linked_parking_spaces; + + // get parking spaces that are in same parking lot. + lanelet::ConstPolygon3d linked_parking_lot; + if (!getLinkedParkingLot(lanelet, all_parking_lots, &linked_parking_lot)) { + return linked_parking_spaces; + } + const auto & possible_parking_spaces = + getLinkedParkingSpaces(linked_parking_lot, all_parking_spaces); + + // check for parking spaces that are within 5m and facing towards lanelet + for (const auto & parking_space : possible_parking_spaces) { + // check if parking space is close to lanelet + const double distance = boost::geometry::distance( + to2D(parking_space).basicLineString(), lanelet.polygon2d().basicPolygon()); + constexpr double distance_thresh = 5.0; + if (distance > distance_thresh) { + continue; + } + + // check if parking space is facing lanelet + const Eigen::Vector3d direction = + parking_space.back().basicPoint() - parking_space.front().basicPoint(); + const Eigen::Vector3d new_pt = parking_space.front().basicPoint() - direction * distance_thresh; + + const lanelet::Point3d check_line_p1(lanelet::InvalId, new_pt.x(), new_pt.y(), new_pt.z()); + const lanelet::Point3d check_line_p2(lanelet::InvalId, parking_space.back().basicPoint()); + const lanelet::LineString3d check_line(lanelet::InvalId, {check_line_p1, check_line_p2}); + + const double new_distance = boost::geometry::distance( + to2D(check_line).basicLineString(), lanelet.polygon2d().basicPolygon()); + if (new_distance < std::numeric_limits::epsilon()) { + linked_parking_spaces.push_back(parking_space); + } + } + return linked_parking_spaces; +} + +// get overlapping parking lot +bool query::getLinkedParkingLot( + const lanelet::ConstLanelet & lanelet, const lanelet::ConstPolygons3d & all_parking_lots, + lanelet::ConstPolygon3d * linked_parking_lot) +{ + for (const auto & parking_lot : all_parking_lots) { + const double distance = boost::geometry::distance( + lanelet.polygon2d().basicPolygon(), to2D(parking_lot).basicPolygon()); + if (distance < std::numeric_limits::epsilon()) { + *linked_parking_lot = parking_lot; + return true; + } + } + return false; +} + +// get overlapping parking lot +bool query::getLinkedParkingLot( + const lanelet::BasicPoint2d & current_position, const lanelet::ConstPolygons3d & all_parking_lots, + lanelet::ConstPolygon3d * linked_parking_lot) +{ + for (const auto & parking_lot : all_parking_lots) { + const double distance = + boost::geometry::distance(current_position, to2D(parking_lot).basicPolygon()); + if (distance < std::numeric_limits::epsilon()) { + *linked_parking_lot = parking_lot; + return true; + } + } + return false; +} + +// get overlapping parking lot +bool query::getLinkedParkingLot( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstPolygons3d & all_parking_lots, lanelet::ConstPolygon3d * linked_parking_lot) +{ + for (const auto & parking_lot : all_parking_lots) { + const double distance = boost::geometry::distance( + to2D(parking_space).basicLineString(), to2D(parking_lot).basicPolygon()); + if (distance < std::numeric_limits::epsilon()) { + *linked_parking_lot = parking_lot; + return true; + } + } + return false; +} + +lanelet::ConstLineStrings3d query::getLinkedParkingSpaces( + const lanelet::ConstPolygon3d & parking_lot, + const lanelet::ConstLineStrings3d & all_parking_spaces) +{ + lanelet::ConstLineStrings3d linked_parking_spaces; + for (const auto & parking_space : all_parking_spaces) { + const double distance = boost::geometry::distance( + to2D(parking_space).basicLineString(), to2D(parking_lot).basicPolygon()); + if (distance < std::numeric_limits::epsilon()) { + linked_parking_spaces.push_back(parking_space); + } + } + return linked_parking_spaces; +} + +// return all stop lines and ref lines from a given set of lanelets +std::vector query::stopLinesLanelets( + const lanelet::ConstLanelets & lanelets) +{ + std::vector stoplines; + + for (const auto & ll : lanelets) { + std::vector ll_stoplines; + ll_stoplines = query::stopLinesLanelet(ll); + stoplines.insert(stoplines.end(), ll_stoplines.begin(), ll_stoplines.end()); + } + + return stoplines; +} + +// return all stop and ref lines from a given lanelet +std::vector query::stopLinesLanelet(const lanelet::ConstLanelet & ll) +{ + std::vector stoplines; + + // find stop lines referenced by right of way reg. elems. + std::vector> right_of_way_reg_elems = + ll.regulatoryElementsAs(); + + if (!right_of_way_reg_elems.empty()) { + // lanelet has a right of way elem element + for (auto j = right_of_way_reg_elems.begin(); j < right_of_way_reg_elems.end(); j++) { + if ((*j)->getManeuver(ll) == lanelet::ManeuverType::Yield) { + // lanelet has a yield reg. elem. + lanelet::Optional row_stopline_opt = (*j)->stopLine(); + if (!!row_stopline_opt) { + stoplines.push_back(row_stopline_opt.get()); + } + } + } + } + + // find stop lines referenced by traffic lights + std::vector> traffic_light_reg_elems = + ll.regulatoryElementsAs(); + + if (!traffic_light_reg_elems.empty()) { + // lanelet has a traffic light elem element + for (auto j = traffic_light_reg_elems.begin(); j < traffic_light_reg_elems.end(); j++) { + lanelet::Optional traffic_light_stopline_opt = (*j)->stopLine(); + if (!!traffic_light_stopline_opt) { + stoplines.push_back(traffic_light_stopline_opt.get()); + } + } + } + // find stop lines referenced by traffic signs + std::vector> traffic_sign_reg_elems = + ll.regulatoryElementsAs(); + + if (!traffic_sign_reg_elems.empty()) { + // lanelet has a traffic sign reg elem - can have multiple ref lines (but + // stop sign shod have 1 + for (auto j = traffic_sign_reg_elems.begin(); j < traffic_sign_reg_elems.end(); j++) { + lanelet::ConstLineStrings3d traffic_sign_stoplines = (*j)->refLines(); + if (!traffic_sign_stoplines.empty()) { + stoplines.push_back(traffic_sign_stoplines.front()); + } + } + } + return stoplines; +} + +std::vector query::stopSignStopLines( + const lanelet::ConstLanelets & lanelets, const std::string & stop_sign_id) +{ + std::vector stoplines; + + std::set checklist; + + for (const auto & ll : lanelets) { + // find stop lines referenced by traffic signs + std::vector> traffic_sign_reg_elems = + ll.regulatoryElementsAs(); + + if (!traffic_sign_reg_elems.empty()) { + // lanelet has a traffic sign reg elem - can have multiple ref lines (but + // stop sign shod have 1 + for (const auto & ts : traffic_sign_reg_elems) { + // skip if traffic sign is not stop sign + if (ts->type() != stop_sign_id) { + continue; + } + + lanelet::ConstLineStrings3d traffic_sign_stoplines = ts->refLines(); + + // only add new items + if (!traffic_sign_stoplines.empty()) { + auto id = traffic_sign_stoplines.front().id(); + if (checklist.find(id) == checklist.end()) { + checklist.insert(id); + stoplines.push_back(traffic_sign_stoplines.front()); + } + } + } + } + } + return stoplines; +} + +ConstLanelets query::getLaneletsWithinRange( + const lanelet::ConstLanelets & lanelets, const lanelet::BasicPoint2d & search_point, + const double range) +{ + ConstLanelets near_lanelets; + for (const auto & ll : lanelets) { + lanelet::BasicPolygon2d poly = ll.polygon2d().basicPolygon(); + double distance = lanelet::geometry::distance(poly, search_point); + if (distance <= range) { + near_lanelets.push_back(ll); + } + } + return near_lanelets; +} + +ConstLanelets query::getLaneletsWithinRange( + const lanelet::ConstLanelets & lanelets, const geometry_msgs::msg::Point & search_point, + const double range) +{ + return getLaneletsWithinRange( + lanelets, lanelet::BasicPoint2d(search_point.x, search_point.y), range); +} + +ConstLanelets query::getLaneChangeableNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet) +{ + return graph->besides(lanelet); +} + +ConstLanelets query::getLaneChangeableNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelets & road_lanelets, + const geometry_msgs::msg::Point & search_point) +{ + const auto lanelets = + getLaneletsWithinRange(road_lanelets, search_point, std::numeric_limits::epsilon()); + ConstLanelets road_slices; + for (const auto & llt : lanelets) { + const auto tmp_road_slice = getLaneChangeableNeighbors(graph, llt); + road_slices.insert(road_slices.end(), tmp_road_slice.begin(), tmp_road_slice.end()); + } + return road_slices; +} + +ConstLanelets query::getAllNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet) +{ + ConstLanelets lanelets; + + ConstLanelets left_lanelets = getAllNeighborsLeft(graph, lanelet); + ConstLanelets right_lanelets = getAllNeighborsRight(graph, lanelet); + + std::reverse(left_lanelets.begin(), left_lanelets.end()); + lanelets.insert(lanelets.end(), left_lanelets.begin(), left_lanelets.end()); + lanelets.push_back(lanelet); + lanelets.insert(lanelets.end(), right_lanelets.begin(), right_lanelets.end()); + + return lanelets; +} + +ConstLanelets query::getAllNeighborsRight( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet) +{ + ConstLanelets lanelets; + auto right_lane = + (!!graph->right(lanelet)) ? graph->right(lanelet) : graph->adjacentRight(lanelet); + while (!!right_lane) { + lanelets.push_back(right_lane.get()); + right_lane = (!!graph->right(right_lane.get())) ? graph->right(right_lane.get()) + : graph->adjacentRight(right_lane.get()); + } + return lanelets; +} + +ConstLanelets query::getAllNeighborsLeft( + const routing::RoutingGraphPtr & graph, const ConstLanelet & lanelet) +{ + ConstLanelets lanelets; + auto left_lane = (!!graph->left(lanelet)) ? graph->left(lanelet) : graph->adjacentLeft(lanelet); + while (!!left_lane) { + lanelets.push_back(left_lane.get()); + left_lane = (!!graph->left(left_lane.get())) ? graph->left(left_lane.get()) + : graph->adjacentLeft(left_lane.get()); + } + return lanelets; +} + +ConstLanelets query::getAllNeighbors( + const routing::RoutingGraphPtr & graph, const ConstLanelets & road_lanelets, + const geometry_msgs::msg::Point & search_point) +{ + const auto lanelets = + getLaneletsWithinRange(road_lanelets, search_point, std::numeric_limits::epsilon()); + ConstLanelets road_slices; + for (const auto & llt : lanelets) { + const auto tmp_road_slice = getAllNeighbors(graph, llt); + road_slices.insert(road_slices.end(), tmp_road_slice.begin(), tmp_road_slice.end()); + } + return road_slices; +} + +bool query::getClosestLanelet( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelet * closest_lanelet_ptr) +{ + if (closest_lanelet_ptr == nullptr) { + std::cerr << "argument closest_lanelet_ptr is null! Failed to find closest lanelet" + << std::endl; + return false; + } + + if (lanelets.empty()) { + return false; + } + + bool found = false; + + lanelet::BasicPoint2d search_point(search_pose.position.x, search_pose.position.y); + + // find by distance + lanelet::ConstLanelets candidate_lanelets; + { + double min_distance = std::numeric_limits::max(); + for (const auto & llt : lanelets) { + double distance = + boost::geometry::comparable_distance(llt.polygon2d().basicPolygon(), search_point); + + if (std::abs(distance - min_distance) <= std::numeric_limits::epsilon()) { + candidate_lanelets.push_back(llt); + } else if (distance < min_distance) { + found = true; + candidate_lanelets.clear(); + candidate_lanelets.push_back(llt); + min_distance = distance; + } + } + } + + if (candidate_lanelets.size() == 1) { + *closest_lanelet_ptr = candidate_lanelets.at(0); + return found; + } + + // find by angle + { + double min_angle = std::numeric_limits::max(); + double pose_yaw = tf2::getYaw(search_pose.orientation); + for (const auto & llt : candidate_lanelets) { + lanelet::ConstLineString3d segment = getClosestSegment(search_point, llt.centerline()); + double angle_diff = M_PI; + if (!segment.empty()) { + double segment_angle = std::atan2( + segment.back().y() - segment.front().y(), segment.back().x() - segment.front().x()); + angle_diff = std::abs(autoware_utils::normalize_radian(segment_angle - pose_yaw)); + } + if (angle_diff < min_angle) { + min_angle = angle_diff; + *closest_lanelet_ptr = llt; + } + } + } + + return found; +} + +bool query::getClosestLaneletWithConstrains( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelet * closest_lanelet_ptr, const double dist_threshold, const double yaw_threshold) +{ + bool found = false; + + if (closest_lanelet_ptr == nullptr) { + std::cerr << "argument closest_lanelet_ptr is null! Failed to find closest lanelet" + << std::endl; + return found; + } + + if (lanelets.empty()) { + return found; + } + + lanelet::BasicPoint2d search_point(search_pose.position.x, search_pose.position.y); + + // find by distance + std::vector> candidate_lanelets; + { + for (const auto & llt : lanelets) { + double distance = boost::geometry::distance(llt.polygon2d().basicPolygon(), search_point); + + if (distance <= dist_threshold) { + candidate_lanelets.emplace_back(llt, distance); + } + } + + if (!candidate_lanelets.empty()) { + // sort by distance + std::sort( + candidate_lanelets.begin(), candidate_lanelets.end(), + []( + const std::pair & x, + std::pair & y) { return x.second < y.second; }); + } else { + return found; + } + } + + // find closest lanelet within yaw_threshold + { + double min_angle = std::numeric_limits::max(); + double min_distance = std::numeric_limits::max(); + double pose_yaw = tf2::getYaw(search_pose.orientation); + for (const auto & llt_pair : candidate_lanelets) { + const auto & distance = llt_pair.second; + + double lanelet_angle = getLaneletAngle(llt_pair.first, search_pose.position); + double angle_diff = std::abs(autoware_utils::normalize_radian(lanelet_angle - pose_yaw)); + + if (angle_diff > std::abs(yaw_threshold)) continue; + if (min_distance < distance) break; + + if (angle_diff < min_angle) { + min_angle = angle_diff; + min_distance = distance; + *closest_lanelet_ptr = llt_pair.first; + found = true; + } + } + } + + return found; +} + +bool query::getCurrentLanelets( + const ConstLanelets & lanelets, const geometry_msgs::msg::Point & search_point, + ConstLanelets * current_lanelets_ptr) +{ + if (current_lanelets_ptr == nullptr) { + std::cerr << "argument closest_lanelet_ptr is null! Failed to find closest lanelet" + << std::endl; + return false; + } + + if (lanelets.empty()) { + return false; + } + + lanelet::BasicPoint2d search_point_2d(search_point.x, search_point.y); + for (const auto & llt : lanelets) { + if (lanelet::geometry::inside(llt, search_point_2d)) { + current_lanelets_ptr->push_back(llt); + } + } + + return !current_lanelets_ptr->empty(); // return found +} + +bool query::getCurrentLanelets( + const ConstLanelets & lanelets, const geometry_msgs::msg::Pose & search_pose, + ConstLanelets * current_lanelets_ptr) +{ + if (current_lanelets_ptr == nullptr) { + std::cerr << "argument closest_lanelet_ptr is null! Failed to find closest lanelet" + << std::endl; + return false; + } + + if (lanelets.empty()) { + return false; + } + + lanelet::BasicPoint2d search_point(search_pose.position.x, search_pose.position.y); + for (const auto & llt : lanelets) { + if (lanelet::geometry::inside(llt, search_point)) { + current_lanelets_ptr->push_back(llt); + } + } + + return !current_lanelets_ptr->empty(); // return found +} + +std::vector> getSucceedingLaneletSequencesRecursive( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length) +{ + std::vector> succeeding_lanelet_sequences; + + const auto next_lanelets = graph->following(lanelet); + const double lanelet_length = utils::getLaneletLength3d(lanelet); + + // end condition of the recursive function + if (next_lanelets.empty() || lanelet_length >= length) { + succeeding_lanelet_sequences.push_back({lanelet}); + return succeeding_lanelet_sequences; + } + + for (const auto & next_lanelet : next_lanelets) { + // get lanelet sequence after next_lanelet + auto tmp_lanelet_sequences = + getSucceedingLaneletSequencesRecursive(graph, next_lanelet, length - lanelet_length); + for (auto & tmp_lanelet_sequence : tmp_lanelet_sequences) { + tmp_lanelet_sequence.push_front(lanelet); + succeeding_lanelet_sequences.push_back(tmp_lanelet_sequence); + } + } + return succeeding_lanelet_sequences; +} + +std::vector> getPrecedingLaneletSequencesRecursive( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length, const lanelet::ConstLanelets & exclude_lanelets) +{ + std::vector> preceding_lanelet_sequences; + + const auto prev_lanelets = graph->previous(lanelet); + const double lanelet_length = utils::getLaneletLength3d(lanelet); + + // end condition of the recursive function + if (prev_lanelets.empty() || lanelet_length >= length) { + preceding_lanelet_sequences.push_back({lanelet}); + return preceding_lanelet_sequences; + } + + for (const auto & prev_lanelet : prev_lanelets) { + if (lanelet::utils::contains(exclude_lanelets, prev_lanelet)) { + // if prev_lanelet is included in exclude_lanelets, + // remove prev_lanelet from preceding_lanelet_sequences + continue; + } + + // get lanelet sequence after prev_lanelet + auto tmp_lanelet_sequences = getPrecedingLaneletSequencesRecursive( + graph, prev_lanelet, length - lanelet_length, exclude_lanelets); + for (auto & tmp_lanelet_sequence : tmp_lanelet_sequences) { + tmp_lanelet_sequence.push_back(lanelet); + preceding_lanelet_sequences.push_back(tmp_lanelet_sequence); + } + } + + if (preceding_lanelet_sequences.empty()) { + preceding_lanelet_sequences.push_back({lanelet}); + } + return preceding_lanelet_sequences; +} + +std::vector query::getSucceedingLaneletSequences( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length) +{ + std::vector lanelet_sequences_vec; + const auto next_lanelets = graph->following(lanelet); + for (const auto & next_lanelet : next_lanelets) { + const auto lanelet_sequences_deq = + getSucceedingLaneletSequencesRecursive(graph, next_lanelet, length); + for (const auto & lanelet_sequence : lanelet_sequences_deq) { + lanelet_sequences_vec.emplace_back(lanelet_sequence.begin(), lanelet_sequence.end()); + } + } + return lanelet_sequences_vec; +} + +std::vector query::getPrecedingLaneletSequences( + const routing::RoutingGraphPtr & graph, const lanelet::ConstLanelet & lanelet, + const double length, const lanelet::ConstLanelets & exclude_lanelets) +{ + std::vector lanelet_sequences_vec; + const auto prev_lanelets = graph->previous(lanelet); + for (const auto & prev_lanelet : prev_lanelets) { + if (lanelet::utils::contains(exclude_lanelets, prev_lanelet)) { + // if prev_lanelet is included in exclude_lanelets, + // remove prev_lanelet from preceding_lanelet_sequences + continue; + } + // convert deque into vector + const auto lanelet_sequences_deq = + getPrecedingLaneletSequencesRecursive(graph, prev_lanelet, length, exclude_lanelets); + for (const auto & lanelet_sequence : lanelet_sequences_deq) { + lanelet_sequences_vec.emplace_back(lanelet_sequence.begin(), lanelet_sequence.end()); + } + } + return lanelet_sequences_vec; +} +} // namespace lanelet::utils + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/road_marking.cpp b/lanelet2_extension/lib/road_marking.cpp new file mode 100644 index 0000000..d514f7a --- /dev/null +++ b/lanelet2_extension/lib/road_marking.cpp @@ -0,0 +1,82 @@ +// Copyright 2020 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/road_marking.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +RegulatoryElementDataPtr constructRoadMarkingData( + Id id, const AttributeMap & attributes, const LineString3d & road_marking) +{ + RuleParameterMap rpm; + RuleParameters rule_parameters = {road_marking}; + rpm.insert(std::make_pair(RoleNameString::Refers, rule_parameters)); + + auto data = std::make_shared(id, rpm, attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "road_marking"; + return data; +} +} // namespace + +RoadMarking::RoadMarking(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ + if (getParameters(RoleName::Refers).size() != 1) { + throw InvalidInputError("There must be exactly one road marking defined!"); + } +} + +RoadMarking::RoadMarking(Id id, const AttributeMap & attributes, const LineString3d & road_marking) +: RoadMarking(constructRoadMarkingData(id, attributes, road_marking)) +{ +} + +ConstLineString3d RoadMarking::roadMarking() const +{ + return getParameters(RoleName::Refers).front(); +} + +LineString3d RoadMarking::roadMarking() +{ + return getParameters(RoleName::Refers).front(); +} + +void RoadMarking::setRoadMarking(const LineString3d & road_marking) +{ + parameters()[RoleName::Refers] = {road_marking}; +} + +void RoadMarking::removeRoadMarking() +{ + parameters()[RoleName::Refers] = {}; +} + +RegisterRegulatoryElement regRoadMarking; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/route_checker.cpp b/lanelet2_extension/lib/route_checker.cpp new file mode 100644 index 0000000..796cfaf --- /dev/null +++ b/lanelet2_extension/lib/route_checker.cpp @@ -0,0 +1,49 @@ +// Copyright 2022 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/route_checker.hpp" + +#include +#include + +#include + +namespace lanelet::utils +{ +bool route::isRouteValid( + const LaneletRoute & route_msg, const lanelet::LaneletMapPtr lanelet_map_ptr_) +{ + for (const auto & route_section : route_msg.segments) { + for (const auto & primitive : route_section.primitives) { + const auto id = primitive.id; + try { + lanelet_map_ptr_->laneletLayer.get(id); + } catch (const std::exception & e) { + std::cerr + << e.what() + << ". Maybe the loaded route was created on a different Map from the current one. " + "Try to load the other Route again." + << std::endl; + return false; + } + } + } + return true; +} + +} // namespace lanelet::utils + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/speed_bump.cpp b/lanelet2_extension/lib/speed_bump.cpp new file mode 100644 index 0000000..22e7c2b --- /dev/null +++ b/lanelet2_extension/lib/speed_bump.cpp @@ -0,0 +1,122 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Ryohsuke Mitsudome, Mehmet Dogru + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/speed_bump.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +template +bool findAndErase(const T & primitive, RuleParameters * member) +{ + if (member == nullptr) { + std::cerr << __FUNCTION__ << ": member is null pointer"; + return false; + } + auto it = std::find(member->begin(), member->end(), RuleParameter(primitive)); + if (it == member->end()) { + return false; + } + member->erase(it); + return true; +} + +Polygons3d getPoly(const RuleParameterMap & paramsMap, RoleName role) +{ + auto params = paramsMap.find(role); + if (params == paramsMap.end()) { + return {}; + } + + Polygons3d result; + for (auto & param : params->second) { + auto p = boost::get(¶m); + if (p != nullptr) { + result.push_back(*p); + } + } + return result; +} + +ConstPolygons3d getConstPoly(const RuleParameterMap & params, RoleName role) +{ + auto cast_func = [](auto & poly) { return static_cast(poly); }; + return utils::transform(getPoly(params, role), cast_func); +} + +RegulatoryElementDataPtr constructSpeedBumpData( + Id id, const AttributeMap & attributes, const Polygon3d & speed_bump) +{ + RuleParameterMap rpm; + RuleParameters rule_parameters = {speed_bump}; + rpm.insert(std::make_pair(RoleNameString::Refers, rule_parameters)); + + auto data = std::make_shared(id, rpm, attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "speed_bump"; + return data; +} +} // namespace + +SpeedBump::SpeedBump(const RegulatoryElementDataPtr & data) : RegulatoryElement(data) +{ + if (getConstPoly(data->parameters, RoleName::Refers).size() != 1) { + throw InvalidInputError("There must be exactly one speed bump defined!"); + } +} + +SpeedBump::SpeedBump(Id id, const AttributeMap & attributes, const Polygon3d & speed_bump) +: SpeedBump(constructSpeedBumpData(id, attributes, speed_bump)) +{ +} + +ConstPolygon3d SpeedBump::speedBump() const +{ + return getConstPoly(parameters(), RoleName::Refers).front(); +} + +Polygon3d SpeedBump::speedBump() +{ + return getPoly(parameters(), RoleName::Refers).front(); +} + +void SpeedBump::addSpeedBump(const Polygon3d & primitive) +{ + parameters()["speed_bump"].emplace_back(primitive); +} + +bool SpeedBump::removeSpeedBump(const Polygon3d & primitive) +{ + return findAndErase(primitive, ¶meters().find("speed_bump")->second); +} + +RegisterRegulatoryElement regSpeedBump; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/transverse_mercator_projector.cpp b/lanelet2_extension/lib/transverse_mercator_projector.cpp new file mode 100644 index 0000000..1bc5f8b --- /dev/null +++ b/lanelet2_extension/lib/transverse_mercator_projector.cpp @@ -0,0 +1,64 @@ +// Copyright 2023 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming, cppcoreguidelines-pro-type-member-init) + +#include "lanelet2_extension/projection/transverse_mercator_projector.hpp" + +#include +#include +#include +#include +#include + +namespace lanelet::projection +{ +TransverseMercatorProjector::TransverseMercatorProjector(Origin origin) : Projector(origin) +{ + central_meridian_ = origin.position.lon; + + // Calculate origin in Transverse Mercator coordinate + const GeographicLib::TransverseMercatorExact & proj = + GeographicLib::TransverseMercatorExact::UTM(); + proj.Forward(central_meridian_, origin.position.lat, origin.position.lon, origin_x_, origin_y_); +} + +BasicPoint3d TransverseMercatorProjector::forward(const GPSPoint & gps) const +{ + BasicPoint3d tm_point{0., 0., gps.ele}; + const GeographicLib::TransverseMercatorExact & proj = + GeographicLib::TransverseMercatorExact::UTM(); + proj.Forward(central_meridian_, gps.lat, gps.lon, tm_point.x(), tm_point.y()); + + // x is already aligned with origin as it is projected in transverse mercator + tm_point.y() = tm_point.y() - origin_y_; + + return tm_point; +} + +GPSPoint TransverseMercatorProjector::reverse(const BasicPoint3d & local_point) const +{ + GPSPoint gps{0.0, 0.0, local_point.z()}; + const GeographicLib::TransverseMercatorExact & proj = + GeographicLib::TransverseMercatorExact::UTM(); + + BasicPoint3d local_point_copy = local_point; + local_point_copy.y() = local_point.y() + origin_y_; + proj.Reverse(central_meridian_, local_point_copy.x(), local_point_copy.y(), gps.lat, gps.lon); + return gps; +} + +} // namespace lanelet::projection + +// NOLINTEND(readability-identifier-naming, cppcoreguidelines-pro-type-member-init) diff --git a/lanelet2_extension/lib/utilities.cpp b/lanelet2_extension/lib/utilities.cpp new file mode 100644 index 0000000..8dbf514 --- /dev/null +++ b/lanelet2_extension/lib/utilities.cpp @@ -0,0 +1,795 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Kenji Miyake, Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/utilities.hpp" + +#include "lanelet2_extension/utility/message_conversion.hpp" +#include "lanelet2_extension/utility/query.hpp" + +#include +#include +#include +#include +#include +#include +#include +#include + +#ifdef ROS_DISTRO_GALACTIC +#include +#else +#include +#endif + +#include + +#include +#include +#include +#include +#include + +namespace lanelet::utils +{ +namespace +{ + +/// @brief copy the z values between 2 containers based on the 2D arc lengths +/// @tparam T1 a container of 3D points +/// @tparam T2 a container of 3D points +/// @param from points from which the z values will be copied +/// @param to points to which the z values will be copied +template +void copyZ(const T1 & from, T2 & to) +{ + if (from.empty() || to.empty()) return; + to.front().z() = from.front().z(); + if (from.size() < 2 || to.size() < 2) return; + to.back().z() = from.back().z(); + auto i_from = 1lu; + auto s_from = lanelet::geometry::distance2d(from[0], from[1]); + auto s_to = 0.0; + auto s_from_prev = 0.0; + for (auto i_to = 1lu; i_to + 1 < to.size(); ++i_to) { + s_to += lanelet::geometry::distance2d(to[i_to - 1], to[i_to]); + for (; s_from < s_to && i_from + 1 < from.size(); ++i_from) { + s_from_prev = s_from; + s_from += lanelet::geometry::distance2d(from[i_from], from[i_from + 1]); + } + const auto ratio = (s_to - s_from_prev) / (s_from - s_from_prev); + to[i_to].z() = from[i_from - 1].z() + ratio * (from[i_from].z() - from[i_from - 1].z()); + } +} + +[[maybe_unused]] bool exists(const std::vector & array, const int element) +{ + return std::find(array.begin(), array.end(), element) != array.end(); +} + +/** + * [getContactingLanelets retrieves id of lanelets which has distance 0m to + * search_point] + * @param lanelet_map [pointer to lanelet] + * @param trafficRules [traffic rules to ignore lanelets that are not + * traversable] + * @param search_point [2D point used for searching] + * @param contacting_lanelet_ids [array of lanelet ids that is contacting with + * search_point] + */ +[[maybe_unused]] void getContactingLanelets( + const lanelet::LaneletMapPtr lanelet_map, + const lanelet::traffic_rules::TrafficRulesPtr traffic_rules, + const lanelet::BasicPoint2d & search_point, std::vector * contacting_lanelet_ids) +{ + if (!lanelet_map) { + std::cerr << "No lanelet map is set!" << std::endl; + return; + } + + if (contacting_lanelet_ids == nullptr) { + std::cerr << __FUNCTION__ << " contacting_lanelet_ids is null pointer!" << std::endl; + return; + } + + for (const auto & ll : lanelet_map->laneletLayer) { + if (!traffic_rules->canPass(ll)) { + continue; + } + lanelet::BasicPolygon2d poly = ll.polygon2d().basicPolygon(); + double distance = lanelet::geometry::distance(poly, search_point); + if (distance < std::numeric_limits::epsilon()) { + contacting_lanelet_ids->push_back(static_cast(ll.id())); + } + } +} + +std::vector calculateSegmentDistances(const lanelet::ConstLineString3d & line_string) +{ + std::vector segment_distances; + segment_distances.reserve(line_string.size() - 1); + + for (size_t i = 1; i < line_string.size(); ++i) { + const auto distance = lanelet::geometry::distance(line_string[i], line_string[i - 1]); + segment_distances.push_back(distance); + } + + return segment_distances; +} + +std::vector calculateAccumulatedLengths(const lanelet::ConstLineString3d & line_string) +{ + const auto segment_distances = calculateSegmentDistances(line_string); + + std::vector accumulated_lengths{0}; + accumulated_lengths.reserve(segment_distances.size() + 1); + std::partial_sum( + std::begin(segment_distances), std::end(segment_distances), + std::back_inserter(accumulated_lengths)); + + return accumulated_lengths; +} + +std::pair findNearestIndexPair( + const std::vector & accumulated_lengths, const double target_length) +{ + // List size + const auto N = accumulated_lengths.size(); + + // Front + if (target_length < accumulated_lengths.at(1)) { + return std::make_pair(0, 1); + } + + // Back + if (target_length > accumulated_lengths.at(N - 2)) { + return std::make_pair(N - 2, N - 1); + } + + // Middle + for (std::size_t i = 1; i < N; ++i) { + if ( + accumulated_lengths.at(i - 1) <= target_length && + target_length <= accumulated_lengths.at(i)) { + return std::make_pair(i - 1, i); + } + } + + // Throw an exception because this never happens + throw std::runtime_error("No nearest point found."); +} + +std::vector resamplePoints( + const lanelet::ConstLineString3d & line_string, const int num_segments) +{ + // Calculate length + const auto line_length = static_cast(lanelet::geometry::length(line_string)); + + // Calculate accumulated lengths + const auto accumulated_lengths = calculateAccumulatedLengths(line_string); + if (accumulated_lengths.size() < 2) return {}; + + // Create each segment + std::vector resampled_points; + for (auto i = 0; i <= num_segments; ++i) { + // Find two nearest points + const auto target_length = (static_cast(i) / num_segments) * line_length; + const auto index_pair = findNearestIndexPair(accumulated_lengths, target_length); + + // Apply linear interpolation + const lanelet::BasicPoint3d back_point = line_string[index_pair.first]; + const lanelet::BasicPoint3d front_point = line_string[index_pair.second]; + const auto direction_vector = (front_point - back_point); + + const auto back_length = accumulated_lengths.at(index_pair.first); + const auto front_length = accumulated_lengths.at(index_pair.second); + const auto segment_length = front_length - back_length; + const auto target_point = + back_point + (direction_vector * (target_length - back_length) / segment_length); + + // Add to list + resampled_points.emplace_back(target_point); + } + + return resampled_points; +} +lanelet::LineString3d getLineStringFromArcLength( + const lanelet::ConstLineString3d & linestring, const double s1, const double s2) +{ + lanelet::Points3d points; + double accumulated_length = 0; + size_t start_index = linestring.size(); + if (start_index == 0) { + return lanelet::LineString3d{lanelet::InvalId, points}; + } + for (size_t i = 0; i < linestring.size() - 1; i++) { + const auto & p1 = linestring[i]; + const auto & p2 = linestring[i + 1]; + const double length = boost::geometry::distance(p1.basicPoint(), p2.basicPoint()); + if (accumulated_length + length > s1) { + start_index = i; + break; + } + accumulated_length += length; + } + if (start_index < linestring.size() - 1) { + const auto & p1 = linestring[start_index]; + const auto & p2 = linestring[start_index + 1]; + const double residue = s1 - accumulated_length; + const auto direction_vector = (p2.basicPoint() - p1.basicPoint()).normalized(); + const auto start_basic_point = p1.basicPoint() + residue * direction_vector; + const auto start_point = lanelet::Point3d(lanelet::InvalId, start_basic_point); + points.push_back(start_point); + } + + accumulated_length = 0; + size_t end_index = linestring.size(); + for (size_t i = 0; i < linestring.size() - 1; i++) { + const auto & p1 = linestring[i]; + const auto & p2 = linestring[i + 1]; + const double length = boost::geometry::distance(p1.basicPoint(), p2.basicPoint()); + if (accumulated_length + length > s2) { + end_index = i; + break; + } + accumulated_length += length; + } + + for (size_t i = start_index + 1; i < end_index; i++) { + const auto p = lanelet::Point3d(linestring[i]); + points.push_back(p); + } + if (end_index < linestring.size() - 1) { + const auto & p1 = linestring[end_index]; + const auto & p2 = linestring[end_index + 1]; + const double residue = s2 - accumulated_length; + const auto direction_vector = (p2.basicPoint() - p1.basicPoint()).normalized(); + const auto end_basic_point = p1.basicPoint() + residue * direction_vector; + const auto end_point = lanelet::Point3d(lanelet::InvalId, end_basic_point); + points.push_back(end_point); + } + return lanelet::LineString3d{lanelet::InvalId, points}; +} +} // namespace + +lanelet::ConstLanelet combineLaneletsShape(const lanelet::ConstLanelets & lanelets) +{ + lanelet::Points3d lefts; + lanelet::Points3d rights; + lanelet::Points3d centers; + for (const auto & llt : lanelets) { + for (const auto & pt : llt.leftBound()) { + lefts.push_back(lanelet::Point3d(pt)); + } + for (const auto & pt : llt.rightBound()) { + rights.push_back(lanelet::Point3d(pt)); + } + for (const auto & pt : llt.centerline()) { + centers.push_back(lanelet::Point3d(pt)); + } + } + const auto left_bound = lanelet::LineString3d(lanelet::InvalId, lefts); + const auto right_bound = lanelet::LineString3d(lanelet::InvalId, rights); + const auto center_line = lanelet::LineString3d(lanelet::InvalId, centers); + auto combined_lanelet = lanelet::Lanelet(lanelet::InvalId, left_bound, right_bound); + combined_lanelet.setCenterline(center_line); + return std::move(combined_lanelet); +} + +lanelet::LineString3d generateFineCenterline( + const lanelet::ConstLanelet & lanelet_obj, const double resolution) +{ + // Get length of longer border + const double left_length = + static_cast(lanelet::geometry::length(lanelet_obj.leftBound())); + const double right_length = + static_cast(lanelet::geometry::length(lanelet_obj.rightBound())); + const double longer_distance = (left_length > right_length) ? left_length : right_length; + const int num_segments = std::max(static_cast(ceil(longer_distance / resolution)), 1); + + // Resample points + const auto left_points = resamplePoints(lanelet_obj.leftBound(), num_segments); + const auto right_points = resamplePoints(lanelet_obj.rightBound(), num_segments); + + // Create centerline + lanelet::LineString3d centerline(lanelet::utils::getId()); + for (int i = 0; i < num_segments + 1; i++) { + // Add ID for the average point of left and right + const auto center_basic_point = (right_points.at(i) + left_points.at(i)) / 2; + const lanelet::Point3d center_point( + lanelet::utils::getId(), center_basic_point.x(), center_basic_point.y(), + center_basic_point.z()); + centerline.push_back(center_point); + } + return centerline; +} + +lanelet::ConstLineString3d getCenterlineWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution) +{ + // Get length of longer border + const double left_length = + static_cast(lanelet::geometry::length(lanelet_obj.leftBound())); + const double right_length = + static_cast(lanelet::geometry::length(lanelet_obj.rightBound())); + const double longer_distance = (left_length > right_length) ? left_length : right_length; + const int num_segments = std::max(static_cast(ceil(longer_distance / resolution)), 1); + + // Resample points + const auto left_points = resamplePoints(lanelet_obj.leftBound(), num_segments); + const auto right_points = resamplePoints(lanelet_obj.rightBound(), num_segments); + + // Create centerline + lanelet::LineString3d centerline(lanelet::utils::getId()); + for (int i = 0; i < num_segments + 1; i++) { + // Add ID for the average point of left and right + const auto center_basic_point = (right_points.at(i) + left_points.at(i)) / 2; + + const auto vec_right_2_left = (left_points.at(i) - right_points.at(i)).normalized(); + + const auto offset_center_basic_point = center_basic_point + vec_right_2_left * offset; + + const lanelet::Point3d center_point( + lanelet::utils::getId(), offset_center_basic_point.x(), offset_center_basic_point.y(), + offset_center_basic_point.z()); + centerline.push_back(center_point); + } + return static_cast(centerline); +} + +lanelet::ConstLineString3d getRightBoundWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution) +{ + // Get length of longer border + const double left_length = + static_cast(lanelet::geometry::length(lanelet_obj.leftBound())); + const double right_length = + static_cast(lanelet::geometry::length(lanelet_obj.rightBound())); + const double longer_distance = (left_length > right_length) ? left_length : right_length; + const int num_segments = std::max(static_cast(ceil(longer_distance / resolution)), 1); + + // Resample points + const auto left_points = resamplePoints(lanelet_obj.leftBound(), num_segments); + const auto right_points = resamplePoints(lanelet_obj.rightBound(), num_segments); + + // Create centerline + lanelet::LineString3d rightBound(lanelet::utils::getId()); + for (int i = 0; i < num_segments + 1; i++) { + // Add ID for the average point of left and right + const auto vec_left_2_right = (right_points.at(i) - left_points.at(i)).normalized(); + + const auto offset_right_basic_point = right_points.at(i) + vec_left_2_right * offset; + + const lanelet::Point3d rightBound_point( + lanelet::utils::getId(), offset_right_basic_point.x(), offset_right_basic_point.y(), + offset_right_basic_point.z()); + rightBound.push_back(rightBound_point); + } + return static_cast(rightBound); +} + +lanelet::ConstLineString3d getLeftBoundWithOffset( + const lanelet::ConstLanelet & lanelet_obj, const double offset, const double resolution) +{ + // Get length of longer border + const double left_length = + static_cast(lanelet::geometry::length(lanelet_obj.leftBound())); + const double right_length = + static_cast(lanelet::geometry::length(lanelet_obj.rightBound())); + const double longer_distance = (left_length > right_length) ? left_length : right_length; + const int num_segments = std::max(static_cast(ceil(longer_distance / resolution)), 1); + + // Resample points + const auto left_points = resamplePoints(lanelet_obj.leftBound(), num_segments); + const auto right_points = resamplePoints(lanelet_obj.rightBound(), num_segments); + + // Create centerline + lanelet::LineString3d leftBound(lanelet::utils::getId()); + for (int i = 0; i < num_segments + 1; i++) { + // Add ID for the average point of left and right + + const auto vec_right_2_left = (left_points.at(i) - right_points.at(i)).normalized(); + + const auto offset_left_basic_point = left_points.at(i) + vec_right_2_left * offset; + + const lanelet::Point3d leftBound_point( + lanelet::utils::getId(), offset_left_basic_point.x(), offset_left_basic_point.y(), + offset_left_basic_point.z()); + leftBound.push_back(leftBound_point); + } + return static_cast(leftBound); +} + +lanelet::ConstLanelet getExpandedLanelet( + const lanelet::ConstLanelet & lanelet_obj, const double left_offset, const double right_offset) +{ + using lanelet::geometry::offsetNoThrow; + using lanelet::geometry::internal::checkForInversion; + + const auto & orig_left_bound_2d = lanelet_obj.leftBound2d().basicLineString(); + const auto & orig_right_bound_2d = lanelet_obj.rightBound2d().basicLineString(); + + // Note: The lanelet::geometry::offset throws exception when the undesired inversion is found. + // Use offsetNoThrow until the logic is updated to handle the inversion. + // TODO(Horibe) update + auto expanded_left_bound_2d = offsetNoThrow(orig_left_bound_2d, left_offset); + auto expanded_right_bound_2d = offsetNoThrow(orig_right_bound_2d, right_offset); + + rclcpp::Clock clock{RCL_ROS_TIME}; + try { + checkForInversion(orig_left_bound_2d, expanded_left_bound_2d, left_offset); + checkForInversion(orig_right_bound_2d, expanded_right_bound_2d, right_offset); + } catch (const lanelet::GeometryError & e) { + RCLCPP_ERROR_THROTTLE( + rclcpp::get_logger("lanelet2_extension"), clock, 1000, + "Fail to expand lanelet. output may be undesired. Lanelet points interval in map data could " + "be too narrow."); + } + + // Note: modify front and back points so that the successive lanelets will not have any + // longitudinal space between them. + { // front + const double diff_x = orig_right_bound_2d.front().x() - orig_left_bound_2d.front().x(); + const double diff_y = orig_right_bound_2d.front().y() - orig_left_bound_2d.front().y(); + const double theta = std::atan2(diff_y, diff_x); + expanded_right_bound_2d.front().x() = + orig_right_bound_2d.front().x() - right_offset * std::cos(theta); + expanded_right_bound_2d.front().y() = + orig_right_bound_2d.front().y() - right_offset * std::sin(theta); + expanded_left_bound_2d.front().x() = + orig_left_bound_2d.front().x() - left_offset * std::cos(theta); + expanded_left_bound_2d.front().y() = + orig_left_bound_2d.front().y() - left_offset * std::sin(theta); + } + { // back + const double diff_x = orig_right_bound_2d.back().x() - orig_left_bound_2d.back().x(); + const double diff_y = orig_right_bound_2d.back().y() - orig_left_bound_2d.back().y(); + const double theta = std::atan2(diff_y, diff_x); + expanded_right_bound_2d.back().x() = + orig_right_bound_2d.back().x() - right_offset * std::cos(theta); + expanded_right_bound_2d.back().y() = + orig_right_bound_2d.back().y() - right_offset * std::sin(theta); + expanded_left_bound_2d.back().x() = + orig_left_bound_2d.back().x() - left_offset * std::cos(theta); + expanded_left_bound_2d.back().y() = + orig_left_bound_2d.back().y() - left_offset * std::sin(theta); + } + + const auto toPoints3d = [](const lanelet::BasicLineString2d & ls2d) { + lanelet::Points3d output; + for (const auto & pt : ls2d) { + output.push_back(lanelet::Point3d(lanelet::InvalId, pt.x(), pt.y(), 0.0)); + } + return output; + }; + + lanelet::Points3d ex_lefts = toPoints3d(expanded_left_bound_2d); + lanelet::Points3d ex_rights = toPoints3d(expanded_right_bound_2d); + copyZ(lanelet_obj.leftBound3d(), ex_lefts); + copyZ(lanelet_obj.rightBound3d(), ex_rights); + + const auto & extended_left_bound_3d = lanelet::LineString3d(lanelet::InvalId, ex_lefts); + const auto & expanded_right_bound_3d = lanelet::LineString3d(lanelet::InvalId, ex_rights); + const auto & lanelet = lanelet::Lanelet( + lanelet_obj.id(), extended_left_bound_3d, expanded_right_bound_3d, lanelet_obj.attributes()); + + return lanelet; +} + +lanelet::ConstLanelets getExpandedLanelets( + const lanelet::ConstLanelets & lanelet_obj, const double left_offset, const double right_offset) +{ + lanelet::ConstLanelets lanelets; + for (const auto & llt : lanelet_obj) { + lanelets.push_back(getExpandedLanelet(llt, left_offset, right_offset)); + } + return lanelets; +} + +void overwriteLaneletsCenterline( + lanelet::LaneletMapPtr lanelet_map, const double resolution, const bool force_overwrite) +{ + for (auto & lanelet_obj : lanelet_map->laneletLayer) { + if (force_overwrite || !lanelet_obj.hasCustomCenterline()) { + const auto fine_center_line = generateFineCenterline(lanelet_obj, resolution); + lanelet_obj.setCenterline(fine_center_line); + } + } +} + +lanelet::ConstLanelets getConflictingLanelets( + const lanelet::routing::RoutingGraphConstPtr & graph, const lanelet::ConstLanelet & lanelet) +{ + const auto & llt_or_areas = graph->conflicting(lanelet); + lanelet::ConstLanelets lanelets; + lanelets.reserve(llt_or_areas.size()); + for (const auto & l_or_a : llt_or_areas) { + auto llt_opt = l_or_a.lanelet(); + if (!!llt_opt) { + lanelets.push_back(llt_opt.get()); + } + } + return lanelets; +} + +bool lineStringWithWidthToPolygon( + const lanelet::ConstLineString3d & linestring, lanelet::ConstPolygon3d * polygon) +{ + if (polygon == nullptr) { + std::cerr << __func__ << ": polygon is null pointer! Failed to convert to polygon." + << std::endl; + return false; + } + if (linestring.size() != 2) { + std::cerr << __func__ << ": linestring" << linestring.id() << " must have 2 points! (" + << linestring.size() << " != 2)" << std::endl + << "Failed to convert to polygon."; + return false; + } + if (!linestring.hasAttribute("width")) { + std::cerr << __func__ << ": linestring" << linestring.id() + << " does not have width tag. Failed to convert to polygon."; + return false; + } + + const Eigen::Vector3d direction = + linestring.back().basicPoint() - linestring.front().basicPoint(); + const double width = linestring.attributeOr("width", 0.0); + const Eigen::Vector3d direction_left = + (Eigen::AngleAxisd(M_PI_2, Eigen::Vector3d::UnitZ()) * direction).normalized(); + + const Eigen::Vector3d eigen_p1 = linestring.front().basicPoint() + direction_left * width / 2; + const Eigen::Vector3d eigen_p2 = linestring.back().basicPoint() + direction_left * width / 2; + const Eigen::Vector3d eigen_p3 = linestring.back().basicPoint() - direction_left * width / 2; + const Eigen::Vector3d eigen_p4 = linestring.front().basicPoint() - direction_left * width / 2; + + const lanelet::Point3d p1(lanelet::InvalId, eigen_p1.x(), eigen_p1.y(), eigen_p1.z()); + const lanelet::Point3d p2(lanelet::InvalId, eigen_p2.x(), eigen_p2.y(), eigen_p2.z()); + const lanelet::Point3d p3(lanelet::InvalId, eigen_p3.x(), eigen_p3.y(), eigen_p3.z()); + const lanelet::Point3d p4(lanelet::InvalId, eigen_p4.x(), eigen_p4.y(), eigen_p4.z()); + + *polygon = lanelet::Polygon3d(lanelet::InvalId, {p1, p2, p3, p4}); + + return true; +} + +bool lineStringToPolygon( + const lanelet::ConstLineString3d & linestring, lanelet::ConstPolygon3d * polygon) +{ + if (polygon == nullptr) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __func__ << ": polygon is null pointer! Failed to convert to polygon."); + return false; + } + if (linestring.size() < 4) { + if (linestring.size() < 3 || linestring.front().id() == linestring.back().id()) { + RCLCPP_WARN_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __func__ << ": linestring" << linestring.id() + << " must have more than different 3 points! (size is " << linestring.size() + << "). Failed to convert to polygon."); + return false; + } + } + + lanelet::Polygon3d llt_poly; + + for (const auto & lp : linestring) { + llt_poly.push_back(lanelet::Point3d( + lanelet::InvalId, lp.basicPoint().x(), lp.basicPoint().y(), lp.basicPoint().z())); + } + + if (linestring.front().id() == linestring.back().id()) { + llt_poly.pop_back(); + } + + *polygon = llt_poly; + + return true; +} + +double getLaneletLength2d(const lanelet::ConstLanelet & lanelet) +{ + return static_cast( + boost::geometry::length(lanelet::utils::to2D(lanelet.centerline()).basicLineString())); +} + +double getLaneletLength3d(const lanelet::ConstLanelet & lanelet) +{ + return static_cast(boost::geometry::length(lanelet.centerline().basicLineString())); +} + +double getLaneletLength2d(const lanelet::ConstLanelets & lanelet_sequence) +{ + double length = 0; + for (const auto & llt : lanelet_sequence) { + length += getLaneletLength2d(llt); + } + return length; +} + +double getLaneletLength3d(const lanelet::ConstLanelets & lanelet_sequence) +{ + double length = 0; + for (const auto & llt : lanelet_sequence) { + length += getLaneletLength3d(llt); + } + return length; +} + +lanelet::ArcCoordinates getArcCoordinates( + const lanelet::ConstLanelets & lanelet_sequence, const geometry_msgs::msg::Pose & pose) +{ + lanelet::ConstLanelet closest_lanelet; + lanelet::utils::query::getClosestLanelet(lanelet_sequence, pose, &closest_lanelet); + + double length = 0; + lanelet::ArcCoordinates arc_coordinates; + for (const auto & llt : lanelet_sequence) { + const auto & centerline_2d = lanelet::utils::to2D(llt.centerline()); + if (llt == closest_lanelet) { + const auto lanelet_point = lanelet::utils::conversion::toLaneletPoint(pose.position); + arc_coordinates = lanelet::geometry::toArcCoordinates( + centerline_2d, lanelet::utils::to2D(lanelet_point).basicPoint()); + arc_coordinates.length += length; + break; + } + length += static_cast(boost::geometry::length(centerline_2d)); + } + return arc_coordinates; +} + +lanelet::ConstLineString3d getClosestSegment( + const lanelet::BasicPoint2d & search_pt, const lanelet::ConstLineString3d & linestring) +{ + if (linestring.size() < 2) { + return lanelet::LineString3d(); + } + + lanelet::ConstLineString3d closest_segment; + double min_distance = std::numeric_limits::max(); + + for (size_t i = 1; i < linestring.size(); i++) { + lanelet::BasicPoint3d prev_basic_pt = linestring[i - 1].basicPoint(); + lanelet::BasicPoint3d current_basic_pt = linestring[i].basicPoint(); + + lanelet::Point3d prev_pt( + lanelet::InvalId, prev_basic_pt.x(), prev_basic_pt.y(), prev_basic_pt.z()); + lanelet::Point3d current_pt( + lanelet::InvalId, current_basic_pt.x(), current_basic_pt.y(), current_basic_pt.z()); + + lanelet::LineString3d current_segment(lanelet::InvalId, {prev_pt, current_pt}); + double distance = lanelet::geometry::distance2d( + lanelet::utils::to2D(current_segment).basicLineString(), search_pt); + if (distance < min_distance) { + closest_segment = current_segment; + min_distance = distance; + } + } + return closest_segment; +} + +lanelet::CompoundPolygon3d getPolygonFromArcLength( + const lanelet::ConstLanelets & lanelets, const double s1, const double s2) +{ + const auto combined_lanelet = combineLaneletsShape(lanelets); + const auto total_length = getLaneletLength2d(combined_lanelet); + + // make sure that s1, and s2 are between [0, lane_length] + const auto s1_saturated = std::max(0.0, std::min(s1, total_length)); + const auto s2_saturated = std::max(0.0, std::min(s2, total_length)); + + const auto ratio_s1 = s1_saturated / total_length; + const auto ratio_s2 = s2_saturated / total_length; + + const auto s1_left = static_cast( + ratio_s1 * boost::geometry::length(combined_lanelet.leftBound().basicLineString())); + const auto s2_left = static_cast( + ratio_s2 * boost::geometry::length(combined_lanelet.leftBound().basicLineString())); + const auto s1_right = static_cast( + ratio_s1 * boost::geometry::length(combined_lanelet.rightBound().basicLineString())); + const auto s2_right = static_cast( + ratio_s2 * boost::geometry::length(combined_lanelet.rightBound().basicLineString())); + + const auto left_bound = + getLineStringFromArcLength(combined_lanelet.leftBound(), s1_left, s2_left); + const auto right_bound = + getLineStringFromArcLength(combined_lanelet.rightBound(), s1_right, s2_right); + + const auto & lanelet = lanelet::Lanelet(lanelet::InvalId, left_bound, right_bound); + return lanelet.polygon3d(); +} + +double getLaneletAngle( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Point & search_point) +{ + lanelet::BasicPoint2d llt_search_point(search_point.x, search_point.y); + lanelet::ConstLineString3d segment = getClosestSegment(llt_search_point, lanelet.centerline()); + return std::atan2( + segment.back().y() - segment.front().y(), segment.back().x() - segment.front().x()); +} + +bool isInLanelet( + const geometry_msgs::msg::Pose & current_pose, const lanelet::ConstLanelet & lanelet, + const double radius) +{ + constexpr double eps = 1.0e-9; + const lanelet::BasicPoint2d p(current_pose.position.x, current_pose.position.y); + return boost::geometry::distance(p, lanelet.polygon2d().basicPolygon()) < radius + eps; +} + +geometry_msgs::msg::Pose getClosestCenterPose( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Point & search_point) +{ + lanelet::BasicPoint2d llt_search_point(search_point.x, search_point.y); + + if (lanelet.centerline().size() == 1) { + geometry_msgs::msg::Pose closest_pose; + closest_pose.position.x = lanelet.centerline().front().x(); + closest_pose.position.y = lanelet.centerline().front().y(); + closest_pose.position.z = search_point.z; + closest_pose.orientation.x = 0.0; + closest_pose.orientation.y = 0.0; + closest_pose.orientation.z = 0.0; + closest_pose.orientation.w = 1.0; + return closest_pose; + } + + lanelet::ConstLineString3d segment = getClosestSegment(llt_search_point, lanelet.centerline()); + if (segment.empty()) { + return geometry_msgs::msg::Pose{}; + } + + const Eigen::Vector2d direction( + (segment.back().basicPoint2d() - segment.front().basicPoint2d()).normalized()); + const Eigen::Vector2d xf(segment.front().basicPoint2d()); + const Eigen::Vector2d x(search_point.x, search_point.y); + const Eigen::Vector2d p = xf + (x - xf).dot(direction) * direction; + + geometry_msgs::msg::Pose closest_pose; + closest_pose.position.x = p.x(); + closest_pose.position.y = p.y(); + closest_pose.position.z = search_point.z; + + const double lane_yaw = getLaneletAngle(lanelet, search_point); + tf2::Quaternion q; + q.setRPY(0, 0, lane_yaw); + closest_pose.orientation = tf2::toMsg(q); + + return closest_pose; +} + +double getLateralDistanceToCenterline( + const lanelet::ConstLanelet & lanelet, const geometry_msgs::msg::Pose & pose) +{ + const auto & centerline_2d = lanelet::utils::to2D(lanelet.centerline()); + const auto lanelet_point = lanelet::utils::conversion::toLaneletPoint(pose.position); + return lanelet::geometry::signedDistance( + centerline_2d, lanelet::utils::to2D(lanelet_point).basicPoint()); +} + +double getLateralDistanceToClosestLanelet( + const lanelet::ConstLanelets & lanelet_sequence, const geometry_msgs::msg::Pose & pose) +{ + lanelet::ConstLanelet closest_lanelet; + lanelet::utils::query::getClosestLanelet(lanelet_sequence, pose, &closest_lanelet); + return getLateralDistanceToCenterline(closest_lanelet, pose); +} +} // namespace lanelet::utils + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/virtual_traffic_light.cpp b/lanelet2_extension/lib/virtual_traffic_light.cpp new file mode 100644 index 0000000..7bf2f21 --- /dev/null +++ b/lanelet2_extension/lib/virtual_traffic_light.cpp @@ -0,0 +1,67 @@ +// Copyright 2021 Tier IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/virtual_traffic_light.hpp" + +#include + +#include + +#include +#include +#include +#include + +namespace lanelet::autoware +{ +namespace +{ +RegulatoryElementDataPtr constructVirtualTrafficLightData( + const Id id, const AttributeMap & attributes, const LineString3d & virtual_traffic_light) +{ + RuleParameterMap rpm; + RuleParameters rule_parameters = {virtual_traffic_light}; + rpm.insert(std::make_pair(RoleNameString::Refers, rule_parameters)); + + auto data = std::make_shared(id, rpm, attributes); + data->attributes[AttributeName::Type] = AttributeValueString::RegulatoryElement; + data->attributes[AttributeName::Subtype] = "virtual_traffic_light"; + return data; +} +} // namespace + +VirtualTrafficLight::VirtualTrafficLight(const RegulatoryElementDataPtr & data) +: RegulatoryElement(data) +{ + if (getParameters("start_line").size() != 1) { + throw InvalidInputError("There must be exactly one start_line defined!"); + } + if (getParameters("end_line").empty()) { + throw InvalidInputError("No end_line defined!"); + } +} + +VirtualTrafficLight::VirtualTrafficLight( + const Id id, const AttributeMap & attributes, const LineString3d & virtual_traffic_light) +: VirtualTrafficLight(constructVirtualTrafficLightData(id, attributes, virtual_traffic_light)) +{ +} + +RegisterRegulatoryElement regVirtualTrafficLight; + +} // namespace lanelet::autoware + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/lib/visualization.cpp b/lanelet2_extension/lib/visualization.cpp new file mode 100644 index 0000000..0c48008 --- /dev/null +++ b/lanelet2_extension/lib/visualization.cpp @@ -0,0 +1,1647 @@ +// Copyright 2015-2019 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Simon Thompson, Ryohsuke Mitsudome + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/visualization/visualization.hpp" + +#include "lanelet2_extension/regulatory_elements/crosswalk.hpp" +#include "lanelet2_extension/regulatory_elements/detection_area.hpp" +#include "lanelet2_extension/regulatory_elements/speed_bump.hpp" +#include "lanelet2_extension/utility/message_conversion.hpp" +#include "lanelet2_extension/utility/query.hpp" +#include "lanelet2_extension/utility/utilities.hpp" + +#include + +#include +#include + +#include +#include +#include +#include + +namespace +{ +template +bool exists(const std::unordered_set & set, const T & element) +{ + return std::find(set.begin(), set.end(), element) != set.end(); +} + +void adjacentPoints( + const int i, const int N, const geometry_msgs::msg::Polygon & poly, + geometry_msgs::msg::Point32 * p0, geometry_msgs::msg::Point32 * p1, + geometry_msgs::msg::Point32 * p2) +{ + if (p0 == nullptr || p1 == nullptr || p2 == nullptr) { + std::cerr << __FUNCTION__ << ": either p0, p1, or p2 is null pointer!" << std::endl; + return; + } + + *p1 = poly.points[i]; + if (i == 0) { + *p0 = poly.points[N - 1]; + } else { + *p0 = poly.points[i - 1]; + } + + if (i < N - 1) { + *p2 = poly.points[i + 1]; + } else { + *p2 = poly.points[0]; + } +} + +[[maybe_unused]] double hypot( + const geometry_msgs::msg::Point32 & p0, const geometry_msgs::msg::Point32 & p1) +{ + return sqrt(pow((p1.x - p0.x), 2.0) + pow((p1.y - p0.y), 2.0)); +} + +bool isAttributeValue( + const lanelet::ConstPoint3d & p, const std::string & attr_str, const std::string & value_str) +{ + const lanelet::Attribute & attr = p.attribute(attr_str); + return attr.value() == value_str; +} + +bool isLaneletAttributeValue( + const lanelet::ConstLanelet & ll, const std::string & attr_str, const std::string & value_str) +{ + const lanelet::Attribute & attr = ll.attribute(attr_str); + return attr.value() == value_str; +} + +void initLightMarker(visualization_msgs::msg::Marker * marker, const std::string & ns) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + float s = 0.3; + + marker->header.frame_id = "map"; + marker->header.stamp = rclcpp::Time(); + marker->frame_locked = false; + marker->ns = ns; + marker->id = 0; + marker->lifetime = rclcpp::Duration(0, 0); + marker->type = visualization_msgs::msg::Marker::SPHERE; + marker->scale.x = s; + marker->scale.y = s; + marker->scale.z = s; +} + +bool inputLightMarker(visualization_msgs::msg::Marker * marker, const lanelet::ConstPoint3d & p) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return false; + } + + marker->id = static_cast(p.id()); + + geometry_msgs::msg::Point point; + marker->pose.position.x = p.x(); + marker->pose.position.y = p.y(); + marker->pose.position.z = p.z(); + + std_msgs::msg::ColorRGBA color; + marker->color.r = 0.0f; + marker->color.g = 0.0f; + marker->color.b = 0.0f; + marker->color.a = 0.3f; + + if (isAttributeValue(p, "color", "red")) { + marker->color.r = 0.3f; + marker->color.g = 0.0f; + marker->color.b = 0.0f; + } else if (isAttributeValue(p, "color", "green")) { + marker->color.r = 0.0f; + marker->color.g = 0.3f; + marker->color.b = 0.0f; + } else if (isAttributeValue(p, "color", "yellow")) { + marker->color.r = 0.3f; + marker->color.g = 0.3f; + marker->color.b = 0.0f; + } else { + marker->color.r = 0.3f; + marker->color.g = 0.3f; + marker->color.b = 0.3f; + } + return true; +} + +void initLaneletDirectionMarker(visualization_msgs::msg::Marker * marker, const std::string & ns) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + float s = 1.0; + + marker->header.frame_id = "map"; + marker->header.stamp = rclcpp::Time(); + marker->frame_locked = false; + marker->ns = ns; + marker->id = 0; + marker->type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker->lifetime = rclcpp::Duration(0, 0); + + marker->pose.position.x = 0.0; // p.x(); + marker->pose.position.y = 0.0; // p.y(); + marker->pose.position.z = 0.0; // p.z(); + marker->pose.orientation.x = 0.0; + marker->pose.orientation.y = 0.0; + marker->pose.orientation.z = 0.0; + marker->pose.orientation.w = 1.0; + marker->scale.x = s; + marker->scale.y = s; + marker->scale.z = s; + marker->color.r = 1.0f; + marker->color.g = 1.0f; + marker->color.b = 1.0f; + marker->color.a = 0.999; +} + +void pushLaneletDirectionMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLanelet & ll) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + lanelet::BasicPoint3d pt[3]; + pt[0].x() = 0.0; + pt[0].y() = -0.3; + pt[0].z() = 0.0; + pt[1].x() = 0.0; + pt[1].y() = 0.3; + pt[1].z() = 0; + pt[2].x() = 1.0; + pt[2].y() = 0.0; + pt[2].z() = 0; + + lanelet::BasicPoint3d pc; + lanelet::BasicPoint3d pc2; + lanelet::ConstLineString3d center_ls = ll.centerline(); + lanelet::Attribute attr = ll.attribute("turn_direction"); + + std_msgs::msg::ColorRGBA c; + c.r = 0.5; + c.g = 0.5; + c.b = 0.5; + c.a = 0.5; + + if (isLaneletAttributeValue(ll, "turn_direction", "right")) { + c.r = 0.5; + c.g = 0.5; + c.b = 0.6; + } else if (isLaneletAttributeValue(ll, "turn_direction", "left")) { + c.r = 0.5; + c.g = 0.6; + c.b = 0.6; + } + + for (std::size_t ci = 0; ci < center_ls.size() - 1;) { + pc = center_ls[ci]; + if (center_ls.size() > 1) { + pc2 = center_ls[ci + 1]; + } else { + return; + } + + double heading = atan2(pc2.y() - pc.y(), pc2.x() - pc.x()); + + lanelet::BasicPoint3d pt_tf[3]; + + Eigen::Vector3d axis(0, 0, 1); + Eigen::Transform t(Eigen::AngleAxis(heading, axis)); + + for (int i = 0; i < 3; i++) { + pt_tf[i] = t * pt[i] + pc; + } + + geometry_msgs::msg::Point gp[3]; + + for (int i = 0; i < 3; i++) { + std_msgs::msg::ColorRGBA cn = c; + + gp[i].x = pt_tf[i].x(); + gp[i].y = pt_tf[i].y(); + gp[i].z = pt_tf[i].z(); + marker->points.push_back(gp[i]); + marker->colors.push_back(cn); + } + ci = ci + 1; + } +} + +bool isClockWise(const geometry_msgs::msg::Polygon & polygon) +{ + const int N = static_cast(polygon.points.size()); + const double x_offset = polygon.points[0].x; + const double y_offset = polygon.points[0].y; + double sum = 0.0; + for (std::size_t i = 0; i < polygon.points.size(); ++i) { + sum += (polygon.points[i].x - x_offset) * (polygon.points[(i + 1) % N].y - y_offset) - + (polygon.points[i].y - y_offset) * (polygon.points[(i + 1) % N].x - x_offset); + } + + return sum < 0.0; +} + +// Is angle AOB less than 180? +// https://qiita.com/fujii-kotaro/items/a411f2a45627ed2f156e +bool isAcuteAngle( + const geometry_msgs::msg::Point32 & a, const geometry_msgs::msg::Point32 & o, + const geometry_msgs::msg::Point32 & b) +{ + return (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x) >= 0; +} + +// https://qiita.com/fujii-kotaro/items/a411f2a45627ed2f156e +bool isWithinTriangle( + const geometry_msgs::msg::Point32 & a, const geometry_msgs::msg::Point32 & b, + const geometry_msgs::msg::Point32 & c, const geometry_msgs::msg::Point32 & p) +{ + double c1 = (b.x - a.x) * (p.y - b.y) - (b.y - a.y) * (p.x - b.x); + double c2 = (c.x - b.x) * (p.y - c.y) - (c.y - b.y) * (p.x - c.x); + double c3 = (a.x - c.x) * (p.y - a.y) - (a.y - c.y) * (p.x - a.x); + + return (c1 > 0.0 && c2 > 0.0 && c3 > 0.0) || (c1 < 0.0 && c2 < 0.0 && c3 < 0.0); +} + +visualization_msgs::msg::Marker createPolygonMarker( + const std::string & name_space, const std_msgs::msg::ColorRGBA & color) +{ + visualization_msgs::msg::Marker marker; + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.id = 0; + marker.ns = name_space; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = rclcpp::Duration(0, 0); + marker.pose.position.x = 0.0; + marker.pose.position.y = 0.0; + marker.pose.position.z = 0.0; + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color = color; + return marker; +} + +void pushPolygonMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstPolygon3d & polygon, + const std_msgs::msg::ColorRGBA & color) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + if (polygon.size() < 3) { + return; + } + + geometry_msgs::msg::Polygon geom_poly; + lanelet::utils::conversion::toGeomMsgPoly(polygon, &geom_poly); + + std::vector triangles; + lanelet::visualization::polygon2Triangle(geom_poly, &triangles); + + for (const auto & tri : triangles) { + geometry_msgs::msg::Point geom_pts[3]; + for (int i = 0; i < 3; i++) { + lanelet::utils::conversion::toGeomMsgPt(tri.points[i], &geom_pts[i]); + marker->points.push_back(geom_pts[i]); + marker->colors.push_back(color); + } + } +} + +} // anonymous namespace + +namespace lanelet +{ +void visualization::lanelet2Triangle( + const lanelet::ConstLanelet & ll, std::vector * triangles) +{ + if (triangles == nullptr) { + std::cerr << __FUNCTION__ << ": triangles is null pointer!" << std::endl; + return; + } + + triangles->clear(); + geometry_msgs::msg::Polygon ll_poly; + lanelet2Polygon(ll, &ll_poly); + polygon2Triangle(ll_poly, triangles); +} + +// NOLINTBEGIN(readability-function-cognitive-complexity) +void visualization::polygon2Triangle( + const geometry_msgs::msg::Polygon & polygon, std::vector * triangles) +{ + geometry_msgs::msg::Polygon poly = polygon; + if (!isClockWise(poly)) { + std::reverse(poly.points.begin(), poly.points.end()); + } + + // ear clipping: find smallest internal angle in polygon + int N = static_cast(poly.points.size()); + + // array of angles for each vertex + std::vector is_acute_angle; + is_acute_angle.assign(N, false); + for (int i = 0; i < N; i++) { + geometry_msgs::msg::Point32 p0; + geometry_msgs::msg::Point32 p1; + geometry_msgs::msg::Point32 p2; + + adjacentPoints(i, N, poly, &p0, &p1, &p2); + is_acute_angle.at(i) = isAcuteAngle(p0, p1, p2); + } + + // start ear clipping + while (N >= 3) { + int clipped_vertex = -1; + + for (int i = 0; i < N; i++) { + const bool theta = is_acute_angle.at(i); + if (theta) { + geometry_msgs::msg::Point32 p0; + geometry_msgs::msg::Point32 p1; + geometry_msgs::msg::Point32 p2; + adjacentPoints(i, N, poly, &p0, &p1, &p2); + + int j_begin = (i + 2) % N; + int j_end = (i - 1 + N) % N; + bool is_ear = true; + for (int j = j_begin; j != j_end; j = (j + 1) % N) { + if (isWithinTriangle(p0, p1, p2, poly.points.at(j))) { + is_ear = false; + break; + } + } + + if (is_ear) { + clipped_vertex = i; + break; + } + } + } + if (clipped_vertex < 0 || clipped_vertex >= N) { + // print in yellow to indicate warning + std::cerr << "\033[1;33mCould not find valid vertex for ear clipping triangulation. " + "Triangulation result might be invalid\033[0m" + << std::endl; + clipped_vertex = 0; + } + + // create triangle + geometry_msgs::msg::Point32 p0; + geometry_msgs::msg::Point32 p1; + geometry_msgs::msg::Point32 p2; + adjacentPoints(clipped_vertex, N, poly, &p0, &p1, &p2); + geometry_msgs::msg::Polygon triangle; + triangle.points.push_back(p0); + triangle.points.push_back(p1); + triangle.points.push_back(p2); + triangles->push_back(triangle); + + // remove vertex of center of angle + auto it = poly.points.begin(); + std::advance(it, clipped_vertex); + poly.points.erase(it); + + // remove from angle list + auto it_angle = is_acute_angle.begin(); + std::advance(it_angle, clipped_vertex); + is_acute_angle.erase(it_angle); + + // update angle list + N = static_cast(poly.points.size()); + if (clipped_vertex == N) { + clipped_vertex = 0; + } + adjacentPoints(clipped_vertex, N, poly, &p0, &p1, &p2); + is_acute_angle.at(clipped_vertex) = isAcuteAngle(p0, p1, p2); + + int i_prev = (clipped_vertex == 0) ? N - 1 : clipped_vertex - 1; + adjacentPoints(i_prev, N, poly, &p0, &p1, &p2); + is_acute_angle.at(i_prev) = isAcuteAngle(p0, p1, p2); + } +} +// NOLINTEND(readability-function-cognitive-complexity) + +void visualization::lanelet2Polygon( + const lanelet::ConstLanelet & ll, geometry_msgs::msg::Polygon * polygon) +{ + if (polygon == nullptr) { + std::cerr << __FUNCTION__ << ": polygon is null pointer!" << std::endl; + return; + } + + lanelet::CompoundPolygon3d ll_poly = ll.polygon3d(); + + polygon->points.clear(); + polygon->points.reserve(ll_poly.size()); + + for (const auto & pt : ll_poly) { + geometry_msgs::msg::Point32 pt32; + utils::conversion::toGeomMsgPt32(pt.basicPoint(), &pt32); + polygon->points.push_back(pt32); + } +} + +visualization_msgs::msg::MarkerArray visualization::laneletDirectionAsMarkerArray( + const lanelet::ConstLanelets & lanelets, const std::string & additional_namespace) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + initLaneletDirectionMarker(&marker, additional_namespace + "lanelet direction"); + + for (const auto & ll : lanelets) { + if (ll.hasAttribute(std::string("turn_direction"))) { + pushLaneletDirectionMarker(&marker, ll); + } + } + if (marker.points.empty()) { + return marker_array; + } + marker_array.markers.push_back(marker); + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::autowareTrafficLightsAsMarkerArray( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration, const double scale) +{ + visualization_msgs::msg::MarkerArray tl_marker_array; + if (tl_reg_elems.empty()) { + return tl_marker_array; + } + visualization_msgs::msg::Marker marker_tri; + visualization_msgs::msg::Marker marker_sph; + initLightMarker(&marker_sph, "traffic_light"); + visualization::initTrafficLightTriangleMarker(&marker_tri, "traffic_light_triangle", duration); + + for (const auto & tl : tl_reg_elems) { + const auto lights = tl->trafficLights(); + for (const auto & lsp : lights) { + if (lsp.isLineString()) { // traffic lights can either polygons or linestrings + lanelet::ConstLineString3d ls = static_cast(lsp); + visualization::pushTrafficLightTriangleMarker(&marker_tri, ls, c, scale); + } + } + marker_tri.id++; + tl_marker_array.markers.push_back(marker_tri); + + lanelet::ConstLineStrings3d light_bulbs = tl->lightBulbs(); + for (const auto & ls : light_bulbs) { + lanelet::ConstLineString3d l = static_cast(ls); + for (const auto & pt : l) { + if (pt.hasAttribute("color")) { + if (inputLightMarker(&marker_sph, pt)) { + marker_sph.id++; + tl_marker_array.markers.push_back(marker_sph); + } + } + } + } + } + + return tl_marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::generateTrafficLightRegulatoryElementIdMaker( + const lanelet::ConstLanelets & lanelets, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration, const double scale) +{ + visualization_msgs::msg::MarkerArray tl_id_marker_array; + + for (const auto & lanelet : lanelets) { + for (const auto & element : lanelet.regulatoryElementsAs()) { + visualization_msgs::msg::Marker marker; + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.ns = "traffic_light_reg_elem_id"; + marker.type = visualization_msgs::msg::Marker::TEXT_VIEW_FACING; + marker.lifetime = duration; + marker.action = visualization_msgs::msg::Marker::ADD; + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.color = c; + marker.scale.z = scale; + marker.frame_locked = false; + + std::ostringstream string_stream; + string_stream << "TLRegElemId:" << std::to_string(element->id()); + marker.text = string_stream.str(); + + marker.id = static_cast(lanelet.id()); + marker.pose.position.x = + (lanelet.rightBound().front().x() + lanelet.leftBound().front().x()) / 2; + marker.pose.position.y = + (lanelet.rightBound().front().y() + lanelet.leftBound().front().y()) / 2; + marker.pose.position.z = lanelet.rightBound().front().z(); + tl_id_marker_array.markers.push_back(marker); + } + } + + return tl_id_marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::generateTrafficLightIdMaker( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration, const double scale) +{ + visualization_msgs::msg::MarkerArray tl_id_marker_array; + + std::unordered_map traffic_light_map{}; + for (const auto & element : tl_reg_elems) { + for (const auto & light : element->trafficLights()) { + if (!light.isLineString()) { + continue; + } + const auto line = static_cast(light); + if (traffic_light_map.count(line.id()) == 0) { + visualization_msgs::msg::Marker marker; + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.ns = "traffic_light_id"; + marker.id = static_cast(line.id()); + marker.type = visualization_msgs::msg::Marker::TEXT_VIEW_FACING; + marker.lifetime = duration; + marker.action = visualization_msgs::msg::Marker::ADD; + marker.pose.position.x = (line.front().x() + line.back().x()) / 2; + marker.pose.position.y = (line.front().y() + line.back().y()) / 2; + marker.pose.position.z = line.front().z() + 1.0; + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.color = c; + marker.scale.z = scale; + marker.frame_locked = false; + + std::ostringstream string_stream; + string_stream << "referrer:" << element->id() << ","; + marker.text = string_stream.str(); + traffic_light_map.emplace(line.id(), marker); + } else { + std::ostringstream string_stream; + string_stream << element->id() << ","; + traffic_light_map.at(line.id()).text += string_stream.str(); + } + } + } + + for (const auto & [id, marker] : traffic_light_map) { + tl_id_marker_array.markers.push_back(marker); + } + + return tl_id_marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::detectionAreasAsMarkerArray( + const std::vector & da_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + visualization_msgs::msg::Marker line_marker; + + if (da_reg_elems.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = "detection_area"; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = duration; + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 1.0f; + marker.color.g = 1.0f; + marker.color.b = 1.0f; + marker.color.a = 0.999; + + std_msgs::msg::ColorRGBA line_c; + line_c.r = 0.5; + line_c.g = 0.5; + line_c.b = 0.5; + line_c.a = 0.999; + visualization::initLineStringMarker(&line_marker, "map", "detection_area_stopline", line_c); + + for (const auto & da_reg_elem : da_reg_elems) { + marker.points.clear(); + marker.colors.clear(); + marker.id = static_cast(da_reg_elem->id()); + + // area visualization + const auto detection_areas = da_reg_elem->detectionAreas(); + for (const auto & detection_area : detection_areas) { + geometry_msgs::msg::Polygon geom_poly; + utils::conversion::toGeomMsgPoly(detection_area, &geom_poly); + + std::vector triangles; + polygon2Triangle(geom_poly, &triangles); + + for (auto tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } // for triangles0 + } // for detection areas + marker_array.markers.push_back(marker); + + // stop line visualization + visualization::pushLineStringMarker(&line_marker, da_reg_elem->stopLine(), line_c, 0.5); + } // for regulatory elements + + marker_array.markers.push_back(line_marker); + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::noParkingAreasAsMarkerArray( + const std::vector & no_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + + if (no_reg_elems.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = "no_parking_area"; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = duration; + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 1.0f; + marker.color.g = 1.0f; + marker.color.b = 1.0f; + marker.color.a = 0.999; + + for (const auto & no_reg_elem : no_reg_elems) { + marker.points.clear(); + marker.colors.clear(); + marker.id = static_cast(no_reg_elem->id()); + + // area visualization + const auto no_parking_areas = no_reg_elem->noParkingAreas(); + for (const auto & no_parking_area : no_parking_areas) { + geometry_msgs::msg::Polygon geom_poly; + utils::conversion::toGeomMsgPoly(no_parking_area, &geom_poly); + + std::vector triangles; + polygon2Triangle(geom_poly, &triangles); + + for (auto tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } // for triangles0 + } // for no_parking areas + marker_array.markers.push_back(marker); + } // for regulatory elements + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::noStoppingAreasAsMarkerArray( + const std::vector & no_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + visualization_msgs::msg::Marker line_marker; + + if (no_reg_elems.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = "no_stopping_area"; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = duration; + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 1.0f; + marker.color.g = 1.0f; + marker.color.b = 1.0f; + marker.color.a = 0.999; + + std_msgs::msg::ColorRGBA line_c; + line_c.r = 0.5; + line_c.g = 0.5; + line_c.b = 0.5; + line_c.a = 0.999; + visualization::initLineStringMarker(&line_marker, "map", "no_stopping_area_stopline", line_c); + + for (const auto & no_reg_elem : no_reg_elems) { + marker.points.clear(); + marker.colors.clear(); + marker.id = static_cast(no_reg_elem->id()); + + // area visualization + const auto no_stopping_areas = no_reg_elem->noStoppingAreas(); + for (const auto & no_stopping_area : no_stopping_areas) { + geometry_msgs::msg::Polygon geom_poly; + utils::conversion::toGeomMsgPoly(no_stopping_area, &geom_poly); + + std::vector triangles; + polygon2Triangle(geom_poly, &triangles); + + for (auto tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } // for triangles0 + } // for no_stopping areas + marker_array.markers.push_back(marker); + const auto & stop_line = no_reg_elem->stopLine(); + // stop line visualization + if (stop_line) { + visualization::pushLineStringMarker(&line_marker, stop_line.value(), line_c, 0.5); + } + } // for regulatory elements + if (!line_marker.points.empty()) { + marker_array.markers.push_back(line_marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::speedBumpsAsMarkerArray( + const std::vector & sb_reg_elems, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + visualization_msgs::msg::Marker line_marker; + + if (sb_reg_elems.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = "speed_bump"; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = duration; + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 1.0f; + marker.color.g = 1.0f; + marker.color.b = 1.0f; + marker.color.a = 0.999; + + for (const auto & sb_reg_elem : sb_reg_elems) { + marker.points.clear(); + marker.colors.clear(); + marker.id = static_cast(sb_reg_elem->id()); + + // area visualization + const auto speed_bump = sb_reg_elem->speedBump(); + + geometry_msgs::msg::Polygon geom_poly; + utils::conversion::toGeomMsgPoly(speed_bump, &geom_poly); + + std::vector triangles; + polygon2Triangle(geom_poly, &triangles); + + for (auto tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } // for triangles0 + + marker_array.markers.push_back(marker); + } // for regulatory elements + + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::crosswalkAreasAsMarkerArray( + const std::vector & cw_reg_elems, const std_msgs::msg::ColorRGBA & c, + const rclcpp::Duration & duration) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + visualization_msgs::msg::Marker line_marker; + + if (cw_reg_elems.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = "crosswalk_areas"; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = duration; + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 0.8f; + marker.color.g = 0.8f; + marker.color.b = 0.0f; + marker.color.a = 0.999; + + for (const auto & cw_reg_elem : cw_reg_elems) { + marker.points.clear(); + marker.colors.clear(); + marker.id = static_cast(cw_reg_elem->id()); + + // area visualization + const auto crosswalk_areas = cw_reg_elem->crosswalkAreas(); + for (const auto & crosswalk_area : crosswalk_areas) { + geometry_msgs::msg::Polygon geom_poly; + utils::conversion::toGeomMsgPoly(crosswalk_area, &geom_poly); + + std::vector triangles; + polygon2Triangle(geom_poly, &triangles); + + for (auto tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } // for triangles0 + } + marker_array.markers.push_back(marker); + } + + marker_array.markers.push_back(line_marker); + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::pedestrianPolygonMarkingsAsMarkerArray( + const lanelet::ConstLineStrings3d & pedestrian_polygon_markings, + const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (pedestrian_polygon_markings.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker polygon_marker = + createPolygonMarker("pedestrian_polygon_marking", c); + for (const auto & linestring : pedestrian_polygon_markings) { + lanelet::ConstPolygon3d polygon; + if (utils::lineStringToPolygon(linestring, &polygon)) { + pushPolygonMarker(&polygon_marker, polygon, c); + } else { + RCLCPP_WARN_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + "pedestrian marking " << linestring.id() << " failed conversion."); + } + } + + if (!polygon_marker.points.empty()) { + marker_array.markers.push_back(polygon_marker); + } + + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::pedestrianLineMarkingsAsMarkerArray( + const lanelet::ConstLineStrings3d & pedestrian_line_markings, const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (pedestrian_line_markings.empty()) { + return marker_array; + } + + const float lss = 0.1; // line string size + visualization_msgs::msg::Marker line_marker; + visualization::initLineStringMarker(&line_marker, "map", "pedestrian_line_marking", c); + + for (const auto & linestring : pedestrian_line_markings) { + if ((linestring.size() < 3) && (linestring.front().id() != linestring.back().id())) { + pushLineStringMarker(&line_marker, linestring, c, lss); + } + } + + if (!line_marker.points.empty()) { + marker_array.markers.push_back(line_marker); + } + + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::parkingLotsAsMarkerArray( + const lanelet::ConstPolygons3d & parking_lots, const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (parking_lots.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = createPolygonMarker("parking_lots", c); + for (const auto & polygon : parking_lots) { + pushPolygonMarker(&marker, polygon, c); + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} +visualization_msgs::msg::MarkerArray visualization::parkingSpacesAsMarkerArray( + const lanelet::ConstLineStrings3d & parking_spaces, const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (parking_spaces.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = createPolygonMarker("parking_space", c); + for (const auto & linestring : parking_spaces) { + lanelet::ConstPolygon3d polygon; + if (utils::lineStringWithWidthToPolygon(linestring, &polygon)) { + pushPolygonMarker(&marker, polygon, c); + } else { + std::cerr << "parking space " << linestring.id() << " failed conversion." << std::endl; + } + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::generateLaneletIdMarker( + const lanelet::ConstLanelets & road_lanelets, const std_msgs::msg::ColorRGBA & c, + const std::string & ns, const double scale) +{ + visualization_msgs::msg::MarkerArray markers; + for (const auto & ll : road_lanelets) { + visualization_msgs::msg::Marker marker; + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Clock().now(); + marker.ns = ns; + marker.id = static_cast(ll.id()); + marker.type = visualization_msgs::msg::Marker::TEXT_VIEW_FACING; + marker.action = visualization_msgs::msg::Marker::ADD; + const auto centerline = ll.centerline(); + const size_t target_position_index = centerline.size() / 2; + const auto & target_position = centerline[target_position_index]; + marker.pose.position.x = target_position.x(); + marker.pose.position.y = target_position.y(); + marker.pose.position.z = target_position.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.color = c; + marker.scale.z = scale; + marker.frame_locked = false; + marker.text = std::to_string(ll.id()); + markers.markers.push_back(marker); + } + return markers; +} + +visualization_msgs::msg::MarkerArray visualization::obstaclePolygonsAsMarkerArray( + const lanelet::ConstPolygons3d & obstacle_polygons, const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (obstacle_polygons.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = createPolygonMarker("obstacles", c); + for (const auto & polygon : obstacle_polygons) { + pushPolygonMarker(&marker, polygon, c); + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::lineStringsAsMarkerArray( + const std::vector & line_strings, const std::string & name_space, + const std_msgs::msg::ColorRGBA & c, const float lss) +{ + visualization_msgs::msg::MarkerArray ls_marker_array; + if (line_strings.empty()) { + return ls_marker_array; + } + std::unordered_set added; + visualization_msgs::msg::Marker ls_marker; + visualization::initLineStringMarker(&ls_marker, "map", name_space, c); + + for (const auto & ls : line_strings) { + if (!exists(added, ls.id())) { + visualization::pushLineStringMarker(&ls_marker, ls, c, lss); + added.insert(ls.id()); + } + } + ls_marker_array.markers.push_back(ls_marker); + return ls_marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::laneletsBoundaryAsMarkerArray( + const lanelet::ConstLanelets & lanelets, const std_msgs::msg::ColorRGBA & c, + const bool viz_centerline, const std::string & additional_namespace) +{ + const float lss = 0.1; // line string size + const float lss_center = static_cast(std::max(lss * 0.1, 0.02)); + + std::unordered_set added; + visualization_msgs::msg::Marker left_line_strip; + visualization_msgs::msg::Marker right_line_strip; + visualization_msgs::msg::Marker start_bound_line_strip; + visualization_msgs::msg::Marker center_line_strip; + visualization_msgs::msg::Marker center_arrows; + visualization::initLineStringMarker( + &left_line_strip, "map", additional_namespace + "left_lane_bound", c); + visualization::initLineStringMarker( + &right_line_strip, "map", additional_namespace + "right_lane_bound", c); + visualization::initLineStringMarker( + &start_bound_line_strip, "map", additional_namespace + "lane_start_bound", c); + visualization::initLineStringMarker( + ¢er_line_strip, "map", additional_namespace + "center_lane_line", c); + visualization::initArrowsMarker( + ¢er_arrows, "map", additional_namespace + "center_line_arrows", c); + + for (const auto & lll : lanelets) { + lanelet::ConstLineString3d left_ls = lll.leftBound(); + lanelet::ConstLineString3d right_ls = lll.rightBound(); + lanelet::ConstLineString3d center_ls = lll.centerline(); + lanelet::LineString3d start_bound_ls(lanelet::utils::getId()); + start_bound_ls.push_back(lanelet::Point3d( + lanelet::utils::getId(), left_ls.front().x(), left_ls.front().y(), left_ls.front().z())); + start_bound_ls.push_back(lanelet::Point3d( + lanelet::utils::getId(), right_ls.front().x(), right_ls.front().y(), right_ls.front().z())); + + if (!exists(added, left_ls.id())) { + visualization::pushLineStringMarker(&left_line_strip, left_ls, c, lss); + added.insert(left_ls.id()); + } + if (!exists(added, right_ls.id())) { + visualization::pushLineStringMarker(&right_line_strip, right_ls, c, lss); + added.insert(right_ls.id()); + } + if (!exists(added, start_bound_ls.id())) { + visualization::pushLineStringMarker(&start_bound_line_strip, start_bound_ls, c, lss); + added.insert(start_bound_ls.id()); + } + if (viz_centerline && !exists(added, center_ls.id())) { + visualization::pushLineStringMarker(¢er_line_strip, center_ls, c, lss_center); + visualization::pushArrowsMarker(¢er_arrows, center_ls, c); + added.insert(center_ls.id()); + } + } + + visualization_msgs::msg::MarkerArray marker_array; + if (!left_line_strip.points.empty()) { + marker_array.markers.push_back(left_line_strip); + } + if (!right_line_strip.points.empty()) { + marker_array.markers.push_back(right_line_strip); + } + if (!center_line_strip.points.empty()) { + marker_array.markers.push_back(center_line_strip); + } + if (!start_bound_line_strip.points.empty()) { + marker_array.markers.push_back(start_bound_line_strip); + } + if (!center_arrows.points.empty()) { + marker_array.markers.push_back(center_arrows); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::trafficLightsAsTriangleMarkerArray( + const std::vector & tl_reg_elems, + const std_msgs::msg::ColorRGBA & c, const rclcpp::Duration & duration, const double scale) +{ + // convert to to an array of linestrings and publish as marker array using + // existing function + + std::vector line_strings; + visualization_msgs::msg::Marker marker; + visualization::initTrafficLightTriangleMarker(&marker, "traffic_light_triangle", duration); + + for (const auto & tl : tl_reg_elems) { + lanelet::LineString3d ls; + + const auto lights = tl->trafficLights(); + for (const auto & lsp : lights) { + if (lsp.isLineString()) { // traffic lights can either polygons or linestrings + lanelet::ConstLineString3d ls = static_cast(lsp); + visualization::pushTrafficLightTriangleMarker(&marker, ls, c, scale); + } + } + } + + visualization_msgs::msg::MarkerArray marker_array; + marker_array.markers.push_back(marker); + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::laneletsAsTriangleMarkerArray( + const std::string & ns, const lanelet::ConstLanelets & lanelets, + const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + visualization_msgs::msg::Marker marker; + + if (lanelets.empty()) { + return marker_array; + } + + marker.header.frame_id = "map"; + marker.header.stamp = rclcpp::Time(); + marker.frame_locked = false; + marker.ns = ns; + marker.id = 0; + marker.type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker.lifetime = rclcpp::Duration(0, 0); + marker.pose.position.x = 0.0; // p.x(); + marker.pose.position.y = 0.0; // p.y(); + marker.pose.position.z = 0.0; // p.z(); + marker.pose.orientation.x = 0.0; + marker.pose.orientation.y = 0.0; + marker.pose.orientation.z = 0.0; + marker.pose.orientation.w = 1.0; + marker.scale.x = 1.0; + marker.scale.y = 1.0; + marker.scale.z = 1.0; + marker.color.r = 1.0f; + marker.color.g = 1.0f; + marker.color.b = 1.0f; + marker.color.a = 0.999; + + for (const auto & ll : lanelets) { + std::vector triangles; + lanelet2Triangle(ll, &triangles); + + for (const auto & tri : triangles) { + geometry_msgs::msg::Point tri0[3]; + + for (int i = 0; i < 3; i++) { + utils::conversion::toGeomMsgPt(tri.points[i], &tri0[i]); + + marker.points.push_back(tri0[i]); + marker.colors.push_back(c); + } + } + } + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + + return marker_array; +} + +void visualization::initTrafficLightTriangleMarker( + visualization_msgs::msg::Marker * marker, const std::string & ns, + const rclcpp::Duration & duration) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + marker->header.frame_id = "map"; + marker->header.stamp = rclcpp::Time(); + marker->frame_locked = false; + marker->ns = ns; + marker->id = 0; + marker->type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + marker->lifetime = duration; + + marker->pose.position.x = 0.0; // p.x(); + marker->pose.position.y = 0.0; // p.y(); + marker->pose.position.z = 0.0; // p.z(); + marker->pose.orientation.x = 0.0; + marker->pose.orientation.y = 0.0; + marker->pose.orientation.z = 0.0; + marker->pose.orientation.w = 1.0; + marker->scale.x = 1.0; + marker->scale.y = 1.0; + marker->scale.z = 1.0; + marker->color.r = 1.0f; + marker->color.g = 1.0f; + marker->color.b = 1.0f; + marker->color.a = 0.999; +} + +void visualization::pushTrafficLightTriangleMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & cl, const double scale) +{ + if (marker == nullptr) { + std::cerr << __FUNCTION__ << ": marker is null pointer!" << std::endl; + return; + } + + double h = 0.7; + if (ls.hasAttribute("height")) { + lanelet::Attribute attr = ls.attribute("height"); + h = std::stod(attr.value()); + } + + // construct triangles and add to marker + + // define polygon of traffic light border + Eigen::Vector3d v[4]; + v[0] << ls.front().x(), ls.front().y(), ls.front().z(); + v[1] << ls.back().x(), ls.back().y(), ls.back().z(); + v[2] << ls.back().x(), ls.back().y(), ls.back().z() + h; + v[3] << ls.front().x(), ls.front().y(), ls.front().z() + h; + + Eigen::Vector3d c = (v[0] + v[1] + v[2] + v[3]) / 4; + + if (scale > 0.0 && scale != 1.0) { + for (auto & i : v) { + i = (i - c) * scale + c; + } + } + geometry_msgs::msg::Point tri0[3]; + utils::conversion::toGeomMsgPt(v[0], &tri0[0]); + utils::conversion::toGeomMsgPt(v[1], &tri0[1]); + utils::conversion::toGeomMsgPt(v[2], &tri0[2]); + geometry_msgs::msg::Point tri1[3]; + utils::conversion::toGeomMsgPt(v[0], &tri1[0]); + utils::conversion::toGeomMsgPt(v[2], &tri1[1]); + utils::conversion::toGeomMsgPt(v[3], &tri1[2]); + + for (const auto & i : tri0) { + marker->points.push_back(i); + marker->colors.push_back(cl); + } + for (const auto & i : tri1) { + marker->points.push_back(i); + marker->colors.push_back(cl); + } +} + +void visualization::initLineStringMarker( + visualization_msgs::msg::Marker * marker, const std::string & frame_id, const std::string & ns, + const std_msgs::msg::ColorRGBA & c) +{ + if (marker == nullptr) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker is null pointer!"); + return; + } + + marker->header.frame_id = frame_id; + marker->header.stamp = rclcpp::Time(); + marker->frame_locked = false; + marker->ns = ns; + marker->action = visualization_msgs::msg::Marker::ADD; + marker->type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + + marker->id = 0; + marker->pose.orientation.x = 0.0; + marker->pose.orientation.y = 0.0; + marker->pose.orientation.z = 0.0; + marker->pose.orientation.w = 1.0; + marker->scale.x = 1.0; + marker->scale.y = 1.0; + marker->scale.z = 1.0; + marker->color = c; +} + +void visualization::pushLineStringMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & c, const float lss) +{ + if (marker == nullptr) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker is null pointer!"); + return; + } + + // fill out lane line + if (ls.size() < 2) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker line size is 1 or 0!"); + return; + } + for (auto i = ls.begin(); i + 1 != ls.end(); i++) { + geometry_msgs::msg::Point p; + const auto heading = + static_cast(std::atan2((*(i + 1)).y() - (*i).y(), (*(i + 1)).x() - (*i).x())); + + const auto x_offset = static_cast(lss * 0.5 * std::sin(heading)); + const auto y_offset = static_cast(lss * 0.5 * std::cos(heading)); + + p.x = (*i).x() + x_offset; + p.y = (*i).y() - y_offset; + p.z = (*i).z(); + marker->points.push_back(p); + p.x = (*i).x() - x_offset; + p.y = (*i).y() + y_offset; + p.z = (*i).z(); + marker->points.push_back(p); + p.x = (*(i + 1)).x() + x_offset; + p.y = (*(i + 1)).y() - y_offset; + p.z = (*(i + 1)).z(); + marker->points.push_back(p); + marker->colors.push_back(c); + p.x = (*(i + 1)).x() - x_offset; + p.y = (*(i + 1)).y() + y_offset; + p.z = (*(i + 1)).z(); + marker->points.push_back(p); + p.x = (*(i + 1)).x() + x_offset; + p.y = (*(i + 1)).y() - y_offset; + p.z = (*(i + 1)).z(); + marker->points.push_back(p); + p.x = (*i).x() - x_offset; + p.y = (*i).y() + y_offset; + p.z = (*i).z(); + marker->points.push_back(p); + marker->colors.push_back(c); + } +} + +void visualization::initArrowsMarker( + visualization_msgs::msg::Marker * marker, const std::string & frame_id, const std::string & ns, + const std_msgs::msg::ColorRGBA & c) +{ + if (marker == nullptr) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker is null pointer!"); + return; + } + + marker->header.frame_id = frame_id; + marker->header.stamp = rclcpp::Time(); + marker->frame_locked = false; + marker->ns = ns; + marker->action = visualization_msgs::msg::Marker::ADD; + marker->type = visualization_msgs::msg::Marker::TRIANGLE_LIST; + + marker->id = 0; + marker->pose.orientation.x = 0.0; + marker->pose.orientation.y = 0.0; + marker->pose.orientation.z = 0.0; + marker->pose.orientation.w = 1.0; + marker->scale.x = 1.0; + marker->scale.y = 1.0; + marker->scale.z = 1.0; + marker->color = c; +} + +void visualization::pushArrowsMarker( + visualization_msgs::msg::Marker * marker, const lanelet::ConstLineString3d & ls, + const std_msgs::msg::ColorRGBA & c) +{ + if (marker == nullptr) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker is null pointer!"); + return; + } + + // fill out lane line + if (ls.size() < 2) { + RCLCPP_ERROR_STREAM( + rclcpp::get_logger("lanelet2_extension.visualization"), + __FUNCTION__ << ": marker line size is 1 or 0!"); + return; + } + for (auto i = ls.begin(); i + 1 != ls.end(); i++) { + const auto heading = + static_cast(std::atan2((*(i + 1)).y() - (*i).y(), (*(i + 1)).x() - (*i).x())); + + const float sin_offset = std::sin(heading); + const float cos_offset = std::cos(heading); + const double width = 0.3; + const double height = 1.0; + + geometry_msgs::msg::Point p; + p.x = (*i).x() + sin_offset * width; + p.y = (*i).y() - cos_offset * width; + p.z = (*i).z(); + marker->points.push_back(p); + p.x = (*i).x() - sin_offset * width; + p.y = (*i).y() + cos_offset * width; + p.z = (*i).z(); + marker->points.push_back(p); + p.x = (*i).x() + cos_offset * height; + p.y = (*i).y() + sin_offset * height; + p.z = (*i).z(); + marker->points.push_back(p); + marker->colors.push_back(c); + } +} + +visualization_msgs::msg::MarkerArray visualization::intersectionAreaAsMarkerArray( + const lanelet::ConstPolygons3d & intersection_areas, const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (intersection_areas.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = createPolygonMarker("intersection_area", c); + for (const auto & polygon : intersection_areas) { + pushPolygonMarker(&marker, polygon, c); + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::noObstacleSegmentationAreaAsMarkerArray( + const lanelet::ConstPolygons3d & no_obstacle_segmentation_area, + const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (no_obstacle_segmentation_area.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = createPolygonMarker("no_obstacle_segmentation_area", c); + for (const auto & polygon : no_obstacle_segmentation_area) { + pushPolygonMarker(&marker, polygon, c); + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray +visualization::noObstacleSegmentationAreaForRunOutAsMarkerArray( + const lanelet::ConstPolygons3d & no_obstacle_segmentation_area_for_run_out, + const std_msgs::msg::ColorRGBA & c) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (no_obstacle_segmentation_area_for_run_out.empty()) { + return marker_array; + } + + visualization_msgs::msg::Marker marker = + createPolygonMarker("no_obstacle_segmentation_area_for_run_out", c); + for (const auto & polygon : no_obstacle_segmentation_area_for_run_out) { + pushPolygonMarker(&marker, polygon, c); + } + + if (!marker.points.empty()) { + marker_array.markers.push_back(marker); + } + return marker_array; +} + +visualization_msgs::msg::MarkerArray visualization::hatchedRoadMarkingsAreaAsMarkerArray( + const lanelet::ConstPolygons3d & hatched_road_markings_area, + const std_msgs::msg::ColorRGBA & area_color, const std_msgs::msg::ColorRGBA & line_color) +{ + visualization_msgs::msg::MarkerArray marker_array; + if (hatched_road_markings_area.empty()) { + return marker_array; + } + + // polygon + visualization_msgs::msg::Marker area_marker = + createPolygonMarker("hatched_road_markings_area", area_color); + for (const auto & polygon : hatched_road_markings_area) { + pushPolygonMarker(&area_marker, polygon, area_color); + } + + if (!area_marker.points.empty()) { + marker_array.markers.push_back(area_marker); + } + + // line strings + const float lss = 0.1; // line string size + visualization_msgs::msg::Marker line_strip; + visualization::initLineStringMarker( + &line_strip, "map", "hatched_road_markings_bound", line_color); + + for (const auto & polygon : hatched_road_markings_area) { + lanelet::LineString3d bound_ls(lanelet::utils::getId()); + for (const auto & point : polygon) { + bound_ls.push_back( + lanelet::Point3d(lanelet::utils::getId(), point.x(), point.y(), point.z())); + } + if (!bound_ls.empty()) { + bound_ls.push_back(bound_ls.front()); + } + visualization::pushLineStringMarker(&line_strip, bound_ls, line_color, lss); + } + if (!line_strip.points.empty()) { + marker_array.markers.push_back(line_strip); + } + + return marker_array; +} +} // namespace lanelet + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/package.xml b/lanelet2_extension/package.xml new file mode 100644 index 0000000..3a40dc9 --- /dev/null +++ b/lanelet2_extension/package.xml @@ -0,0 +1,42 @@ + + + + lanelet2_extension + 0.1.0 + The lanelet2_extension package contains libraries to handle Lanelet2 format data. + mitsudome-r + Masahiro Sakamoto + Mamoru Sobue + Takayuki Murooka + Kosuke Takeuchi + Apache License 2.0 + + ament_cmake_auto + autoware_cmake + + autoware_auto_mapping_msgs + autoware_auto_planning_msgs + autoware_planning_msgs + autoware_utils + geographiclib + geometry_msgs + lanelet2_core + lanelet2_io + lanelet2_maps + lanelet2_projection + lanelet2_routing + lanelet2_traffic_rules + lanelet2_validation + pugixml-dev + range-v3 + rclcpp + tf2 + tf2_geometry_msgs + visualization_msgs + + ament_cmake_ros + + + ament_cmake + + diff --git a/lanelet2_extension/src/check_right_of_way.cpp b/lanelet2_extension/src/check_right_of_way.cpp new file mode 100644 index 0000000..8b2a8be --- /dev/null +++ b/lanelet2_extension/src/check_right_of_way.cpp @@ -0,0 +1,97 @@ +// Copyright 2015-2022 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include + +int main(int argc, char ** argv) +{ + if (argc < 2) { + std::cout << "usage: ros2 run lanelet2_extension check_right_of_way "; + return 0; + } + + // NOLINTBEGIN + const std::string map_path = std::string(argv[1]); + // NOLINTEND + + lanelet::ErrorMessages errors{}; + lanelet::projection::MGRSProjector projector{}; + lanelet::LaneletMapPtr map = lanelet::load(map_path, projector, &errors); + for (auto && error : errors) std::cout << error << std::endl; + + lanelet::traffic_rules::TrafficRulesPtr traffic_rules = + lanelet::traffic_rules::TrafficRulesFactory::create( + lanelet::Locations::Germany, lanelet::Participants::Vehicle); + lanelet::routing::RoutingGraphPtr routing_graph_ptr = + lanelet::routing::RoutingGraph::build(*map, *traffic_rules); + + auto rows = map->regulatoryElementLayer // filter elem whose Subtype is RightOfWay + | + ranges::views::filter([](auto && elem) { + const auto & attrs = elem->attributes(); + auto it = attrs.find(lanelet::AttributeName::Subtype); + return it != attrs.end() && it->second == lanelet::AttributeValueString::RightOfWay; + }) // transform to lanelet::RightOfWay + | ranges::views::transform([](auto && elem) { + return std::move(std::dynamic_pointer_cast(elem)); + }); + + for (auto && row : rows) { + const auto & right_of_ways = row->rightOfWayLanelets(); + const auto & yields = row->yieldLanelets(); + std::set yield_ids; + for (auto && yield : yields) { + yield_ids.insert(yield.id()); + } + + std::set conflicting_ids; + for (auto && right_of_way : right_of_ways) { + const std::vector & conflicting_lanelets = + lanelet::utils::getConflictingLanelets(routing_graph_ptr, right_of_way); + for (auto && conflict : conflicting_lanelets) conflicting_ids.insert(conflict.id()); + } + + std::vector unnecessary_yields; + set_difference( + yield_ids.begin(), yield_ids.end(), conflicting_ids.begin(), conflicting_ids.end(), + std::inserter(unnecessary_yields, unnecessary_yields.end())); + if (unnecessary_yields.empty()) continue; + std::cout << "RightOfWay " << row->id() << ": ["; + const char * delim = ""; + for (auto && unnecessary_yield : unnecessary_yields) + std::cout << std::exchange(delim, ",") << unnecessary_yield; + std::cout << "] are unnecessary yield" << std::endl; + } +} diff --git a/lanelet2_extension/src/sample_code.cpp b/lanelet2_extension/src/sample_code.cpp new file mode 100644 index 0000000..d4595fb --- /dev/null +++ b/lanelet2_extension/src/sample_code.cpp @@ -0,0 +1,125 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/projection/mgrs_projector.hpp" +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" + +#include + +#include +#include +#include + +#include +#include + +void loadingAutowareOSMFile(const std::string & map_file_path) +{ + lanelet::LaneletMapPtr lanelet_map; + lanelet::ErrorMessages errors; + lanelet::GPSPoint gps_point; + gps_point.lat = 49.0; + gps_point.lon = 8.4; + lanelet::Origin origin(gps_point); + lanelet::projection::UtmProjector projector(lanelet::Origin(gps_point), true, false); + + // Autoware OSM file parser is registered into lanelet2 library. + // Therefore, you can used it by just specifying "autoware_osm_handler" parser + // in load function. + lanelet_map = lanelet::load(map_file_path, "autoware_osm_handler", projector, &errors); + + // If you want to use default parser, explicitly name the parser + lanelet_map = lanelet::load(map_file_path, "osm_handler", projector, &errors); +} + +void usingMGRSProjector() +{ + // MGRS Projector projects lat/lon to x,y,z point in MGRS 100km grid. + // The origin is automatically calculated so you don't have to select any + // origin. + lanelet::projection::MGRSProjector projector; + + // Let's convert lat/lng point into mgrs xyz point. + lanelet::GPSPoint gps_point; + gps_point.lat = 49.0; + gps_point.lon = 8.4; + gps_point.ele = 0.0; + + lanelet::BasicPoint3d mgrs_point = projector.forward(gps_point); + std::cout << mgrs_point << std::endl; + + // You can get MGRS Code of projected grid. + std::string mgrs_grid = projector.getProjectedMGRSGrid(); + std::cout << mgrs_grid << std::endl; + + // You can also reverse project from MGRS point to lat/lon. + // You have to set which MGRS grid it is from or it will reuse last projected + // grid + lanelet::GPSPoint projected_gps_point = projector.reverse(mgrs_point); + std::cout << projected_gps_point.lat << " " << projected_gps_point.lon << std::endl; + lanelet::GPSPoint projected_gps_point2 = + lanelet::projection::MGRSProjector::reverse(mgrs_point, mgrs_grid); + std::cout << projected_gps_point2.lat << " " << projected_gps_point2.lon << " " << std::endl; +} + +void usingAutowareTrafficLight(const std::string & map_file_path) +{ + lanelet::LaneletMapPtr lanelet_map; + lanelet::ErrorMessages errors; + lanelet::projection::MGRSProjector projector; + lanelet_map = lanelet::load(map_file_path, "autoware_osm_handler", projector, &errors); + + for (const auto & lanelet : lanelet_map->laneletLayer) { + // You can access to traffic light element as AutowareTrafficLight class + const auto autoware_traffic_lights = + lanelet.regulatoryElementsAs(); + for (const auto & light : autoware_traffic_lights) { + // You can access to the position of each lamps(light bulb) in traffic + // light + for (const auto & light_bulb_string : light->lightBulbs()) { + std::cout << light_bulb_string.id() << std::endl; + } + // Since AutowareTrafficLight class is inheriting lanelet::TrafficLight + // class, you can also access to outline of traffic light by the same + // method. + for (const auto & light_string : light->trafficLights()) { + std::cout << light_string.id() << std::endl; + } + } + + // You can also access to same traffic light element as default TrafficLight + // class + auto traffic_lights = lanelet.regulatoryElementsAs(); + for (const auto & light : traffic_lights) { + for (const auto & light_string : light->trafficLights()) { + std::cout << light_string.id() << std::endl; + } + } + } +} + +int main(int argc, char * argv[]) +{ + rclcpp::init(argc, argv); + auto node = rclcpp::Node::make_shared("sample_code"); + const std::string map_file_path = node->declare_parameter("map_file", ""); + loadingAutowareOSMFile(map_file_path); + usingMGRSProjector(); + usingAutowareTrafficLight(map_file_path); + return 0; +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/src/validation.cpp b/lanelet2_extension/src/validation.cpp new file mode 100644 index 0000000..4b08714 --- /dev/null +++ b/lanelet2_extension/src/validation.cpp @@ -0,0 +1,179 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/projection/mgrs_projector.hpp" +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" + +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +namespace +{ +namespace keyword +{ +constexpr const char * Id = "id"; +constexpr const char * Osm = "osm"; +constexpr const char * Tag = "tag"; +constexpr const char * Key = "k"; +constexpr const char * Node = "node"; +constexpr const char * Elevation = "ele"; +} // namespace keyword + +void printUsage() +{ + std::cout << "Usage:" << std::endl + << "ros2 run lanelet2_extension autoware_lanelet2_validation" + " --ros-args -p map_file:=" + << std::endl; +} +} // namespace + +void validateElevationTag(const std::string & filename) +{ + pugi::xml_document doc; + auto result = doc.load_file(filename.c_str()); + if (!result) { + std::cerr << result.description() << std::endl; + exit(1); + } + + auto osmNode = doc.child(keyword::Osm); + for (auto node = osmNode.child(keyword::Node); node; node = node.next_sibling(keyword::Node)) { + const auto id = node.attribute(keyword::Id).as_llong(lanelet::InvalId); + if (!node.find_child_by_attribute(keyword::Tag, keyword::Key, keyword::Elevation)) { + std::cerr << "failed to find elevation tag for node: " << id << std::endl; + } + } +} + +// NOLINTBEGIN(readability-function-cognitive-complexity) +void validateTrafficLight(const lanelet::LaneletMapPtr lanelet_map) +{ + if (!lanelet_map) { + std::cerr << "Missing map. Are you sure you set correct path for map?" << std::endl; + exit(1); + } + + for (const auto & lanelet : lanelet_map->laneletLayer) { + const auto autoware_traffic_lights = + lanelet.regulatoryElementsAs(); + if (autoware_traffic_lights.empty()) { + continue; + } + for (const auto & light : autoware_traffic_lights) { + if (light->lightBulbs().empty()) { + std::cerr << "regulatory element traffic light " << light->id() + << " is missing optional light_bulb member. You won't be able to use region_tlr " + "node with this map" + << std::endl; + } + for (const auto & light_string : light->lightBulbs()) { + if (!light_string.hasAttribute("traffic_light_id")) { + std::cerr << "light_bulb " << light_string.id() << " is missing traffic_light_id tag" + << std::endl; + } + } + for (const auto & base_string_or_poly : light->trafficLights()) { + if (!base_string_or_poly.isLineString()) { + std::cerr + << "traffic_light " << base_string_or_poly.id() + << " is polygon, and only linestring class is currently supported for traffic lights" + << std::endl; + } + const auto base_string = static_cast(base_string_or_poly); + if (!base_string.hasAttribute("height")) { + std::cerr << "traffic_light " << base_string.id() << " is missing height tag" + << std::endl; + } + } + } + } +} +// NOLINTEND(readability-function-cognitive-complexity) + +void validateTurnDirection(const lanelet::LaneletMapPtr lanelet_map) +{ + if (!lanelet_map) { + std::cerr << "Missing map. Are you sure you set correct path for map?" << std::endl; + exit(1); + } + + lanelet::traffic_rules::TrafficRulesPtr traffic_rules = + lanelet::traffic_rules::TrafficRulesFactory::create( + lanelet::Locations::Germany, lanelet::Participants::Vehicle); + lanelet::routing::RoutingGraphPtr vehicle_graph = + lanelet::routing::RoutingGraph::build(*lanelet_map, *traffic_rules); + + for (const auto & lanelet : lanelet_map->laneletLayer) { + if (!traffic_rules->canPass(lanelet)) { + continue; + } + + const auto conflicting_lanelets_or_areas = vehicle_graph->conflicting(lanelet); + if (conflicting_lanelets_or_areas.empty()) { + continue; + } + if (!lanelet.hasAttribute("turn_direction")) { + std::cerr + << "lanelet " << lanelet.id() + << " seems to be intersecting other lanelet, but does not have turn_direction tagging." + << std::endl; + } + } +} + +int main(int argc, char * argv[]) +{ + rclcpp::init(argc, argv); + auto node = rclcpp::Node::make_shared("autoware_lanelet_validation"); + + std::string map_path; + try { + map_path = node->declare_parameter("map_file"); + } catch (...) { + std::cerr << "failed find map_file parameter! No file to load" << std::endl; + printUsage(); + return 1; + } + lanelet::LaneletMapPtr lanelet_map; + lanelet::ErrorMessages errors; + lanelet::projection::MGRSProjector projector; + lanelet_map = lanelet::load(map_path, "autoware_osm_handler", projector, &errors); + + std::cout << "starting validation" << std::endl; + + validateElevationTag(map_path); + validateTrafficLight(lanelet_map); + validateTurnDirection(lanelet_map); + + std::cout << "finished validation" << std::endl; + + return 0; +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_message_conversion.cpp b/lanelet2_extension/test/src/test_message_conversion.cpp new file mode 100644 index 0000000..4f31ab5 --- /dev/null +++ b/lanelet2_extension/test/src/test_message_conversion.cpp @@ -0,0 +1,175 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/message_conversion.hpp" +#include "lanelet2_extension/utility/query.hpp" + +#include +#include + +#include + +using lanelet::Lanelet; +using lanelet::LineString3d; +using lanelet::Point3d; +using lanelet::utils::getId; +using lanelet::utils::conversion::toGeomMsgPt; + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() : single_lanelet_map_ptr(new lanelet::LaneletMap()) + { + Point3d p1; + Point3d p2; + Point3d p3; + Point3d p4; + Point3d p5; + Point3d p6; + Point3d p7; + LineString3d traffic_light_base; + LineString3d traffic_light_bulbs; + LineString3d stop_line; + + p1 = Point3d(getId(), 0., 0., 0.); + p2 = Point3d(getId(), 0., 1., 0.); + + p3 = Point3d(getId(), 1., 0., 0.); + p4 = Point3d(getId(), 1., 1., 0.); + + LineString3d ls_left(getId(), {p1, p2}); + LineString3d ls_right(getId(), {p3, p4}); + + Lanelet lanelet(getId(), ls_left, ls_right); + + single_lanelet_map_ptr->add(lanelet); + } + + ~TestSuite() override = default; + + lanelet::LaneletMapPtr single_lanelet_map_ptr; + +private: +}; + +TEST_F(TestSuite, BinMsgConversion) // NOLINT for gtest +{ + autoware_auto_mapping_msgs::msg::HADMapBin bin_msg; + lanelet::LaneletMapPtr regenerated_map(new lanelet::LaneletMap); + + lanelet::utils::conversion::toBinMsg(single_lanelet_map_ptr, &bin_msg); + + ASSERT_NE(0U, bin_msg.data.size()) << "converted bin message does not have any data"; + + lanelet::utils::conversion::fromBinMsg(bin_msg, regenerated_map); + + auto original_lanelet = lanelet::utils::query::laneletLayer(single_lanelet_map_ptr); + auto regenerated_lanelet = lanelet::utils::query::laneletLayer(regenerated_map); + + ASSERT_EQ(original_lanelet.front().id(), regenerated_lanelet.front().id()) + << "regenerated map has different id"; +} + +TEST_F(TestSuite, ToGeomMsgPt) // NOLINT for gtest +{ + Point3d lanelet_pt(getId(), -0.1, 0.2, 3.0); + + geometry_msgs::msg::Point32 geom_pt32; + geom_pt32.x = -0.1; + geom_pt32.y = 0.2; + geom_pt32.z = 3.0; + + geometry_msgs::msg::Point geom_pt; + toGeomMsgPt(geom_pt32, &geom_pt); + ASSERT_FLOAT_EQ(geom_pt32.x, geom_pt.x) + << " converted value is different from original geometry_msgs::msg::Point"; + ASSERT_FLOAT_EQ(geom_pt32.y, geom_pt.y) + << " converted value is different from original geometry_msgs::msg::Point"; + ASSERT_FLOAT_EQ(geom_pt32.z, geom_pt.z) + << " converted value is different from original geometry_msgs::msg::Point"; + + geom_pt = toGeomMsgPt(geom_pt32); + ASSERT_FLOAT_EQ(geom_pt32.x, geom_pt.x) + << " converted value is different from original geometry_msgs::msg::Point"; + ASSERT_FLOAT_EQ(geom_pt32.y, geom_pt.y) + << " converted value is different from original geometry_msgs::msg::Point"; + ASSERT_FLOAT_EQ(geom_pt32.z, geom_pt.z) + << " converted value is different from original geometry_msgs::msg::Point"; + + toGeomMsgPt(lanelet_pt.basicPoint(), &geom_pt); + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().x(), geom_pt.x) + << " converted value is different from original " + "lanelet::basicPoint"; + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().y(), geom_pt.y) + << " converted value is different from original " + "lanelet::basicPoint"; + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().z(), geom_pt.z) + << " converted value is different from original " + "lanelet::basicPoint"; + + geom_pt = toGeomMsgPt(lanelet_pt.basicPoint()); + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().x(), geom_pt.x) + << " converted value is different from original " + "lanelet::basicPoint"; + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().y(), geom_pt.y) + << " converted value is different from original " + "lanelet::basicPoint"; + ASSERT_DOUBLE_EQ(lanelet_pt.basicPoint().z(), geom_pt.z) + << " converted value is different from original " + "lanelet::basicPoint"; + + toGeomMsgPt(lanelet_pt, &geom_pt); + ASSERT_DOUBLE_EQ(lanelet_pt.x(), geom_pt.x) + << " converted value is different from original lanelet::Point3d"; + ASSERT_DOUBLE_EQ(lanelet_pt.y(), geom_pt.y) + << " converted value is different from original lanelet::Point3d"; + ASSERT_DOUBLE_EQ(lanelet_pt.z(), geom_pt.z) + << " converted value is different from original lanelet::Point3d"; + + geom_pt = toGeomMsgPt(lanelet_pt); + ASSERT_DOUBLE_EQ(lanelet_pt.x(), geom_pt.x) + << " converted value is different from original lanelet::Point3d"; + ASSERT_DOUBLE_EQ(lanelet_pt.y(), geom_pt.y) + << " converted value is different from original lanelet::Point3d"; + ASSERT_DOUBLE_EQ(lanelet_pt.z(), geom_pt.z) + << " converted value is different from original lanelet::Point3d"; + + lanelet::ConstPoint2d point_2d = lanelet::utils::to2D(lanelet_pt); + + toGeomMsgPt(point_2d, &geom_pt); + ASSERT_DOUBLE_EQ(point_2d.x(), geom_pt.x) + << " converted value is different from original lanelet::Point2d"; + ASSERT_DOUBLE_EQ(point_2d.y(), geom_pt.y) + << " converted value is different from original lanelet::Point2d"; + ASSERT_DOUBLE_EQ(0.0, geom_pt.z) + << " converted value is different from original lanelet::Point2d"; + + geom_pt = toGeomMsgPt(point_2d); + ASSERT_DOUBLE_EQ(point_2d.x(), geom_pt.x) + << " converted value is different from original lanelet::Point2d"; + ASSERT_DOUBLE_EQ(point_2d.y(), geom_pt.y) + << " converted value is different from original lanelet::Point2d"; + ASSERT_DOUBLE_EQ(0.0, geom_pt.z) + << " converted value is different from original lanelet::Point2d"; +} + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_projector.cpp b/lanelet2_extension/test/src/test_projector.cpp new file mode 100644 index 0000000..3f3e7b8 --- /dev/null +++ b/lanelet2_extension/test/src/test_projector.cpp @@ -0,0 +1,159 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/projection/mgrs_projector.hpp" +#include "lanelet2_extension/projection/transverse_mercator_projector.hpp" + +#include +#include + +#include + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() = default; + ~TestSuite() override = default; +}; + +TEST(TestSuite, ForwardMGRSProjection) // NOLINT for gtest +{ + lanelet::projection::MGRSProjector projector; + // lat/lon in Tokyo + lanelet::GPSPoint gps_point; + gps_point.lat = 35.652832; + gps_point.lon = 139.839478; + gps_point.ele = 12.3456789; + lanelet::BasicPoint3d mgrs_point = projector.forward(gps_point); + + // projected z value should not change + ASSERT_DOUBLE_EQ(mgrs_point.z(), gps_point.ele) + << "Forward projected z value should be " << gps_point.ele; + + // https://www.movable-type.co.uk/scripts/latlong-utm-mgrs.html + // round the projected value to mm since the above reference only gives value + // in mm precision + ASSERT_EQ(projector.getProjectedMGRSGrid(), "54SUE") << "Projected grid should be " + << "54SUE"; + double rounded_x_mm = round(mgrs_point.x() * 1000) / 1000.0; + ASSERT_DOUBLE_EQ(rounded_x_mm, 94946.081) << "Forward projected x value should be " << 94946.081; + double rounded_y_mm = round(mgrs_point.y() * 1000) / 1000.0; + ASSERT_DOUBLE_EQ(rounded_y_mm, 46063.748) << "Forward projected y value should be " << 46063.748; +} + +TEST(TestSuite, ReverseMGRSProjection) // NOLINT for gtest +{ + lanelet::projection::MGRSProjector projector; + lanelet::BasicPoint3d mgrs_point; + mgrs_point.x() = 94946.0; + mgrs_point.y() = 46063.0; + mgrs_point.z() = 12.3456789; + + projector.setMGRSCode("54SUE"); + lanelet::GPSPoint gps_point = projector.reverse(mgrs_point); + + // projected z value should not change + ASSERT_DOUBLE_EQ(gps_point.ele, mgrs_point.z()) + << "Reverse projected z value should be " << mgrs_point.z(); + + // https://www.movable-type.co.uk/scripts/latlong-utm-mgrs.html + // round the projected value since the above reference only gives value up to + // precision of 1e-8 + double rounded_lat = round(gps_point.lat * 1e8) / 1e8; + ASSERT_DOUBLE_EQ(rounded_lat, 35.65282525) + << "Reverse projected latitude value should be " << 35.65282525; + double rounded_lon = round(gps_point.lon * 1e8) / 1e8; + ASSERT_DOUBLE_EQ(rounded_lon, 139.83947721) + << "Reverse projected longitude value should be " << 139.83947721; +} + +TEST(TestSuite, ForwardTransverseMercatorProjection) // NOLINT for gtest +{ + lanelet::projection::TransverseMercatorProjector projector( + lanelet::Origin({35.652832, 139.839478})); + + // lat/lon in Tokyo + lanelet::GPSPoint gps_point; + gps_point.lat = 35.652832; + gps_point.lon = 139.839478; + gps_point.ele = 12.3456789; + lanelet::BasicPoint3d projected_point = projector.forward(gps_point); + + // projected z value should not change + ASSERT_DOUBLE_EQ(projected_point.z(), gps_point.ele) + << "Forward projected z value should be " << gps_point.ele; + + double rounded_x_mm = round(projected_point.x() * 1000) / 1000.0; + ASSERT_DOUBLE_EQ(rounded_x_mm, 0.0) << "Forward projected x value should be " << 0.0; + double rounded_y_mm = round(projected_point.y() * 1000) / 1000.0; + ASSERT_DOUBLE_EQ(rounded_y_mm, 0.0) << "Forward projected y value should be " << 0.0; +} + +TEST(TestSuite, ReverseTransverseMercatorProjection) // NOLINT for gtest +{ + lanelet::projection::TransverseMercatorProjector projector( + lanelet::Origin({35.652832, 139.839478})); + + lanelet::BasicPoint3d local_point; + local_point.x() = 0.0; + local_point.y() = 0.0; + local_point.z() = 12.3456789; + + lanelet::GPSPoint gps_point = projector.reverse(local_point); + + // projected z value should not change + ASSERT_DOUBLE_EQ(gps_point.ele, local_point.z()) + << "Reverse projected z value should be " << local_point.z(); + + // https://www.movable-type.co.uk/scripts/latlong-utm-mgrs.html + // round the projected value since the above reference only gives value up to + // precision of 1e-8 + double rounded_lat = round(gps_point.lat * 1e8) / 1e8; + ASSERT_DOUBLE_EQ(rounded_lat, 35.652832) + << "Reverse projected latitude value should be " << 35.652832; + double rounded_lon = round(gps_point.lon * 1e8) / 1e8; + ASSERT_DOUBLE_EQ(rounded_lon, 139.839478) + << "Reverse projected longitude value should be " << 139.839478; +} + +TEST(TestSuite, ForwardAndReverseTransverseMercatorProjection) // NOLINT for gtest +{ + lanelet::projection::TransverseMercatorProjector projector(lanelet::Origin({35.0, 139.0})); + + // lat/lon in Tokyo + lanelet::GPSPoint gps_point; + gps_point.lat = 35.652832; + gps_point.lon = 139.839478; + gps_point.ele = 12.3456789; + lanelet::BasicPoint3d projected_point = projector.forward(gps_point); + lanelet::GPSPoint gps_point_converted = projector.reverse(projected_point); + + // projected z value should not change + ASSERT_DOUBLE_EQ(gps_point_converted.ele, gps_point.ele) + << "Forward projected z value should be " << gps_point.ele; + EXPECT_NEAR(gps_point_converted.lat, gps_point.lat, 0.0001) + << "Forward and Reversed latitude should match the original latitude"; + EXPECT_NEAR(gps_point_converted.lon, gps_point.lon, 0.0001) + << "Forward and Reversed longitude should match the original longitude"; +} + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_query.cpp b/lanelet2_extension/test/src/test_query.cpp new file mode 100644 index 0000000..3fa73cf --- /dev/null +++ b/lanelet2_extension/test/src/test_query.cpp @@ -0,0 +1,149 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" +#include "lanelet2_extension/utility/query.hpp" + +#include +#include + +#include + +using lanelet::Lanelet; +using lanelet::LineString3d; +using lanelet::Point3d; +using lanelet::Points3d; +using lanelet::utils::getId; + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() : sample_map_ptr(new lanelet::LaneletMap()) + { + // create sample lanelets + Point3d p1; + Point3d p2; + Point3d p3; + Point3d p4; + + p1 = Point3d(getId(), 0., 0., 0.); + p2 = Point3d(getId(), 0., 1., 0.); + + p3 = Point3d(getId(), 1., 0., 0.); + p4 = Point3d(getId(), 1., 1., 0.); + + LineString3d ls_left(getId(), {p1, p2}); + LineString3d ls_right(getId(), {p3, p4}); + + Lanelet road_lanelet(getId(), ls_left, ls_right); + road_lanelet.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Road; + + Lanelet crosswalk_lanelet(getId(), ls_left, ls_right); + crosswalk_lanelet.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Crosswalk; + + // create sample traffic light + Point3d p5; + Point3d p6; + Point3d p7; + Point3d p8; + Point3d p9; + Point3d p10; + Point3d p11; + Point3d p12; + LineString3d traffic_light_base; + LineString3d traffic_light_bulbs; + LineString3d stop_line; + + p6 = Point3d(getId(), 0., 1., 4.); + p7 = Point3d(getId(), 1., 1., 4.); + + p8 = Point3d(getId(), 0., 1., 4.5); + p9 = Point3d(getId(), 0.5, 1., 4.5); + p10 = Point3d(getId(), 1., 1., 4.5); + + p11 = Point3d(getId(), 0., 0., 0.); + p12 = Point3d(getId(), 1., 0., 0.); + + traffic_light_base = LineString3d(getId(), Points3d{p6, p7}); + traffic_light_bulbs = LineString3d(getId(), Points3d{p8, p9, p10}); + stop_line = LineString3d(getId(), Points3d{p11, p12}); + + auto tl = lanelet::autoware::AutowareTrafficLight::make( + getId(), lanelet::AttributeMap(), {traffic_light_base}, stop_line, {traffic_light_bulbs}); + + road_lanelet.addRegulatoryElement(tl); + + // add items to map + sample_map_ptr->add(road_lanelet); + sample_map_ptr->add(crosswalk_lanelet); + } + + ~TestSuite() override = default; + + lanelet::LaneletMapPtr sample_map_ptr; + +private: +}; + +TEST_F(TestSuite, QueryLanelets) // NOLINT for gtest +{ + lanelet::ConstLanelets all_lanelets = lanelet::utils::query::laneletLayer(sample_map_ptr); + ASSERT_EQ(2U, all_lanelets.size()) << "failed to retrieve all lanelets"; + + lanelet::ConstLanelets subtype_lanelets = + lanelet::utils::query::subtypeLanelets(all_lanelets, lanelet::AttributeValueString::Road); + ASSERT_EQ(1U, subtype_lanelets.size()) << "failed to retrieve road lanelet by subtypeLanelets"; + + lanelet::ConstLanelets road_lanelets = lanelet::utils::query::roadLanelets(all_lanelets); + ASSERT_EQ(1U, road_lanelets.size()) << "failed to retrieve road lanelets"; + + lanelet::ConstLanelets crosswalk_lanelets = + lanelet::utils::query::crosswalkLanelets(all_lanelets); + ASSERT_EQ(1U, crosswalk_lanelets.size()) << "failed to retrieve crosswalk lanelets"; +} + +TEST_F(TestSuite, QueryTrafficLights) // NOLINT for gtest +{ + lanelet::ConstLanelets all_lanelets = lanelet::utils::query::laneletLayer(sample_map_ptr); + + auto traffic_lights = lanelet::utils::query::trafficLights(all_lanelets); + ASSERT_EQ(1U, traffic_lights.size()) << "failed to retrieve traffic lights"; + + auto autoware_traffic_lights = lanelet::utils::query::autowareTrafficLights(all_lanelets); + ASSERT_EQ(1U, autoware_traffic_lights.size()) << "failed to retrieve autoware traffic lights"; +} + +TEST_F(TestSuite, QueryStopLine) // NOLINT for gtest +{ + lanelet::ConstLanelets all_lanelets = lanelet::utils::query::laneletLayer(sample_map_ptr); + lanelet::ConstLanelets road_lanelets = lanelet::utils::query::roadLanelets(all_lanelets); + + auto stop_lines = lanelet::utils::query::stopLinesLanelets(all_lanelets); + ASSERT_EQ(1U, stop_lines.size()) << "failed to retrieve stop lines from all lanelets"; + + auto stop_lines2 = lanelet::utils::query::stopLinesLanelet(road_lanelets.front()); + ASSERT_EQ(1U, stop_lines2.size()) << "failed to retrieve stop lines from a lanelet"; +} + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_regulatory_elements.cpp b/lanelet2_extension/test/src/test_regulatory_elements.cpp new file mode 100644 index 0000000..7037e95 --- /dev/null +++ b/lanelet2_extension/test/src/test_regulatory_elements.cpp @@ -0,0 +1,145 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/regulatory_elements/autoware_traffic_light.hpp" + +#include +#include +#include + +#include +#include + +using lanelet::LineString3d; +using lanelet::LineStringOrPolygon3d; +using lanelet::Point3d; +using lanelet::Points3d; +using lanelet::utils::getId; + +namespace +{ +template +std::vector convertToVector(T item) +{ + std::vector vector = {item}; + return vector; +} +} // namespace + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() = default; + ~TestSuite() override = default; +}; + +TEST(TestSuite, FactoryConstructsTrafficLight) // NOLINT for gtest +{ + Point3d p1; + Point3d p2; + Point3d p3; + Point3d p4; + Point3d p5; + Point3d p6; + Point3d p7; + LineStringOrPolygon3d traffic_light_base; + LineString3d traffic_light_bulbs; + LineString3d stop_line; + + p1 = Point3d(getId(), 0., 1., 4.); + p2 = Point3d(getId(), 1., 1., 4.); + + p3 = Point3d(getId(), 0., 1., 4.5); + p4 = Point3d(getId(), 0.5, 1., 4.5); + p5 = Point3d(getId(), 1., 1., 4.5); + + p6 = Point3d(getId(), 0., 0., 0.); + p7 = Point3d(getId(), 1., 0., 0.); + + Points3d base = {p1, p2}; + Points3d bulbs = {p3, p4, p5}; + Points3d stop = {p6, p7}; + + traffic_light_base = LineString3d(getId(), base); + traffic_light_bulbs = LineString3d(getId(), bulbs); + stop_line = LineString3d(getId(), stop); + + auto tl = lanelet::autoware::AutowareTrafficLight::make( + getId(), lanelet::AttributeMap(), convertToVector(traffic_light_base), stop_line, + convertToVector(traffic_light_bulbs)); + + auto factoryTl = lanelet::RegulatoryElementFactory::create( + tl->attribute(lanelet::AttributeName::Subtype).value(), + std::const_pointer_cast(tl->constData())); + EXPECT_TRUE(!!std::dynamic_pointer_cast(factoryTl)); +} + +TEST(TestSuite, TrafficLightWorksAsExpected) // NOLINT for gtest +{ + Point3d p1; + Point3d p2; + Point3d p3; + Point3d p4; + Point3d p5; + Point3d p6; + Point3d p7; + + LineStringOrPolygon3d traffic_light_base; + LineStringOrPolygon3d traffic_light_base2; + LineString3d traffic_light_bulbs; + LineString3d traffic_light_bulbs2; + LineString3d stop_line; + + p1 = Point3d(getId(), 0., 1., 4.); + p2 = Point3d(getId(), 1., 1., 4.); + + p3 = Point3d(getId(), 0., 1., 4.5); + p4 = Point3d(getId(), 0.5, 1., 4.5); + p5 = Point3d(getId(), 1., 1., 4.5); + + p6 = Point3d(getId(), 0., 0., 0.); + p7 = Point3d(getId(), 1., 0., 0.); + + Points3d base = {p1, p2}; + Points3d bulbs = {p3, p4, p5}; + Points3d stop = {p6, p7}; + + traffic_light_base = {LineString3d(getId(), base)}; + traffic_light_base2 = {LineString3d(getId(), base)}; + traffic_light_bulbs = {LineString3d(getId(), bulbs)}; + traffic_light_bulbs2 = {LineString3d(getId(), bulbs)}; + stop_line = LineString3d(getId(), stop); + + auto tl = lanelet::autoware::AutowareTrafficLight::make( + getId(), lanelet::AttributeMap(), convertToVector(traffic_light_base), stop_line, + convertToVector(traffic_light_bulbs)); + tl->setStopLine(stop_line); + EXPECT_EQ(stop_line, tl->stopLine()); + tl->addTrafficLight(traffic_light_base2); + EXPECT_EQ(2ul, tl->trafficLights().size()); + tl->addLightBulbs(traffic_light_bulbs2); + EXPECT_EQ(2ul, tl->lightBulbs().size()); + tl->removeLightBulbs(traffic_light_bulbs); + EXPECT_EQ(1ul, tl->lightBulbs().size()); +} + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_route_checker.cpp b/lanelet2_extension/test/src/test_route_checker.cpp new file mode 100644 index 0000000..660d33e --- /dev/null +++ b/lanelet2_extension/test/src/test_route_checker.cpp @@ -0,0 +1,100 @@ +// Copyright 2022 TIER IV, Inc. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming) + +#include "lanelet2_extension/utility/message_conversion.hpp" +#include "lanelet2_extension/utility/route_checker.hpp" + +#include +#include + +#include +#include + +using lanelet::Lanelet; +using lanelet::LineString3d; +using lanelet::Point3d; +using lanelet::utils::getId; + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() : sample_map_ptr(new lanelet::LaneletMap()) + { + // create sample lanelets + const Point3d p1(getId(), 0.0, 0.0, 0.0); + const Point3d p2(getId(), 0.0, 1.0, 0.0); + + const LineString3d ls_left(getId(), {p1, p2}); + + const Point3d p3(getId(), 1.0, 0.0, 0.0); + const Point3d p4(getId(), 1.0, 0.0, 0.0); + + const LineString3d ls_right(getId(), {p3, p4}); + + const Lanelet lanelet(getId(), ls_left, ls_right); + + sample_map_ptr->add(lanelet); + + // create sample routes + autoware_planning_msgs::msg::LaneletPrimitive map_primitive; + autoware_planning_msgs::msg::LaneletSegment map_segment1; + autoware_planning_msgs::msg::LaneletSegment map_segment2; + + for (size_t i = 0; i < 2; i++) { + map_primitive.id = lanelet.id(); + map_segment1.primitives.push_back(map_primitive); + map_primitive.id = ls_left.id(); + map_segment2.primitives.push_back(map_primitive); + } + sample_route1.segments.push_back(map_segment1); + sample_route2.segments.push_back(map_segment2); + } + + ~TestSuite() override = default; + + lanelet::LaneletMapPtr sample_map_ptr; + autoware_planning_msgs::msg::LaneletRoute sample_route1; // valid route + autoware_planning_msgs::msg::LaneletRoute sample_route2; // invalid route + +private: +}; + +TEST_F(TestSuite, isRouteValid) // NOLINT for gtest +{ + autoware_auto_mapping_msgs::msg::HADMapBin bin_msg; + + const auto route_ptr1 = + std::make_shared(sample_route1); + const auto route_ptr2 = + std::make_shared(sample_route2); + + // toBinMsg is tested at test_message_conversion.cpp + lanelet::utils::conversion::toBinMsg(sample_map_ptr, &bin_msg); + + ASSERT_TRUE(lanelet::utils::route::isRouteValid(*route_ptr1, sample_map_ptr)) + << "The route should be valid, which should be created on the same map as the current one"; + ASSERT_FALSE(lanelet::utils::route::isRouteValid(*route_ptr2, sample_map_ptr)) + << "The route should be invalid, which should be created on the different map from the current " + "one"; +} + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension/test/src/test_utilities.cpp b/lanelet2_extension/test/src/test_utilities.cpp new file mode 100644 index 0000000..4d53c03 --- /dev/null +++ b/lanelet2_extension/test/src/test_utilities.cpp @@ -0,0 +1,167 @@ +// Copyright 2015-2019 Autoware Foundation +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// NOLINTBEGIN(readability-identifier-naming, cppcoreguidelines-avoid-goto) + +#include "lanelet2_extension/utility/utilities.hpp" + +#include +#include +#include +#include + +#include + +using lanelet::Lanelet; +using lanelet::LineString3d; +using lanelet::Point3d; +using lanelet::utils::getId; + +class TestSuite : public ::testing::Test // NOLINT for gtest +{ +public: + TestSuite() : sample_map_ptr(new lanelet::LaneletMap()) + { + // create sample lanelets + Point3d p1; + Point3d p2; + Point3d p3; + Point3d p4; + Point3d p5; + Point3d p6; + Point3d p7; + Point3d p8; + Point3d p9; + Point3d p10; + + p1 = Point3d(getId(), 0., 0., 0.); + p2 = Point3d(getId(), 0., 1., 0.); + p3 = Point3d(getId(), 1., 0., 0.); + p4 = Point3d(getId(), 1., 1., 0.); + + LineString3d ls_left(getId(), {p1, p2}); + LineString3d ls_right(getId(), {p3, p4}); + + p5 = Point3d(getId(), 0., 2., 0.); + p6 = Point3d(getId(), 1., 2., 0.); + + LineString3d ls_left2(getId(), {p2, p5}); + LineString3d ls_right2(getId(), {p4, p6}); + + p7 = Point3d(getId(), 0., 3., 0.); + p8 = Point3d(getId(), 1., 3., 0.); + + LineString3d ls_left3(getId(), {p5, p7}); + LineString3d ls_right3(getId(), {p6, p8}); + + p9 = Point3d(getId(), 0., 1., 0.); + p10 = Point3d(getId(), 1., 1., 0.); + + LineString3d ls_left4(getId(), {p9, p5}); + LineString3d ls_right4(getId(), {p10, p6}); + + road_lanelet = Lanelet(getId(), ls_left, ls_right); + road_lanelet.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Road; + + next_lanelet = Lanelet(getId(), ls_left2, ls_right2); + next_lanelet.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Road; + + next_lanelet2 = Lanelet(getId(), ls_left3, ls_right3); + next_lanelet2.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Road; + + merging_lanelet = Lanelet(getId(), ls_left4, ls_right4); + merging_lanelet.attributes()[lanelet::AttributeName::Subtype] = + lanelet::AttributeValueString::Road; + + sample_map_ptr->add(road_lanelet); + sample_map_ptr->add(next_lanelet); + sample_map_ptr->add(next_lanelet2); + sample_map_ptr->add(merging_lanelet); + } + + ~TestSuite() override = default; + + lanelet::LaneletMapPtr sample_map_ptr; + Lanelet road_lanelet; + Lanelet next_lanelet; + Lanelet next_lanelet2; + Lanelet merging_lanelet; + +private: +}; + +TEST_F(TestSuite, OverwriteLaneletsCenterline) // NOLINT for gtest +{ + double resolution = 5.0; + bool force_overwrite = false; + lanelet::utils::overwriteLaneletsCenterline(sample_map_ptr, resolution, force_overwrite); + + for (const auto & lanelet : sample_map_ptr->laneletLayer) { + ASSERT_TRUE(lanelet.hasCustomCenterline()) << "failed to calculate fine centerline"; + } +} + +/* +TEST(Utilities, copyZ) // NOLINT for gtest +{ + using lanelet::utils::copyZ; + + LineString3d ls1; + LineString3d ls2; + + ASSERT_NO_THROW(copyZ(ls1, ls2)); + ls1.push_back(Point3d(lanelet::InvalId, 0.0, 0.0, 5.0)); + ASSERT_NO_THROW(copyZ(ls1, ls2)); + ls2.push_back(Point3d(lanelet::InvalId, 0.0, 0.0, 0.0)); + ASSERT_NO_THROW(copyZ(ls1, ls2)); + EXPECT_EQ(ls2.front().z(), ls1.front().z()); + ls1.push_back(Point3d(lanelet::InvalId, 1.0, 0.0, 2.0)); + ls2.push_back(Point3d(lanelet::InvalId, 3.0, 0.0, 0.0)); + ASSERT_NO_THROW(copyZ(ls1, ls2)); + EXPECT_EQ(ls2.front().z(), ls1.front().z()); + EXPECT_EQ(ls2.back().z(), ls1.back().z()); + + ls1.push_back(Point3d(lanelet::InvalId, 2.0, 0.0, 0.0)); + ls1.push_back(Point3d(lanelet::InvalId, 3.0, 0.0, 3.0)); + lanelet::Points3d points; + points.emplace_back(lanelet::InvalId, 0.0, 0.0, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 0.5, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 1.0, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 1.5, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 2.0, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 2.5, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 3.0, 0.0); + points.emplace_back(lanelet::InvalId, 0.0, 3.5, 0.0); + ASSERT_NO_THROW(copyZ(ls1, points)); + EXPECT_EQ(points[0].z(), 5.0); + EXPECT_EQ(points[1].z(), 3.5); + EXPECT_EQ(points[2].z(), 2.0); + EXPECT_EQ(points[3].z(), 1.0); + EXPECT_EQ(points[4].z(), 0.0); + EXPECT_EQ(points[5].z(), 1.5); + EXPECT_EQ(points[6].z(), 3.0); + EXPECT_EQ(points[7].z(), 3.0); +} +*/ + +int main(int argc, char ** argv) +{ + testing::InitGoogleTest(&argc, argv); + return RUN_ALL_TESTS(); +} + +// NOLINTEND(readability-identifier-naming, cppcoreguidelines-avoid-goto) diff --git a/lanelet2_extension_python/CMakeLists.txt b/lanelet2_extension_python/CMakeLists.txt new file mode 100644 index 0000000..2b9e028 --- /dev/null +++ b/lanelet2_extension_python/CMakeLists.txt @@ -0,0 +1,31 @@ +cmake_minimum_required(VERSION 3.14) +project(lanelet2_extension_python) + +find_package(autoware_cmake REQUIRED) +find_package(python_cmake_module REQUIRED) + +autoware_package() + +find_package(BoostPython REQUIRED) + +include_directories( + ${BoostPython_INCLUDE_DIRS} + +) +ament_python_install_package(${PROJECT_NAME}) + +set(CMAKE_SHARED_LIBRARY_PREFIX "") +ament_auto_add_library(_${PROJECT_NAME}_boost_python_utility SHARED + src/utility.cpp +) +ament_auto_add_library(_${PROJECT_NAME}_boost_python_projection SHARED + src/projection.cpp +) +ament_auto_add_library(_${PROJECT_NAME}_boost_python_regulatory_elements SHARED + src/regulatory_elements.cpp +) +install(TARGETS _${PROJECT_NAME}_boost_python_utility _${PROJECT_NAME}_boost_python_projection _${PROJECT_NAME}_boost_python_regulatory_elements + DESTINATION "${PYTHON_INSTALL_DIR}/${PROJECT_NAME}" +) + +ament_package() diff --git a/lanelet2_extension_python/example/example.py b/lanelet2_extension_python/example/example.py new file mode 100644 index 0000000..c9311bc --- /dev/null +++ b/lanelet2_extension_python/example/example.py @@ -0,0 +1,195 @@ +from geometry_msgs.msg import Point +from geometry_msgs.msg import Pose +import lanelet2 +import lanelet2.geometry +from lanelet2_extension_python.projection import MGRSProjector +import lanelet2_extension_python.utility.query as query +import lanelet2_extension_python.utility.utilities as utilities +import matplotlib.pyplot as plt +import numpy as np + + +def test_projection(): + return MGRSProjector(lanelet2.io.Origin(0.0, 0.0)) + + +def test_io(map_path, projection): + return lanelet2.io.load(map_path, projection) + + +def plot_ll2_id(ll2, ax, text): + xs, ys = np.array([pt.x for pt in ll2.centerline]), np.array([pt.y for pt in ll2.centerline]) + x, y = np.average(xs), np.average(ys) + ax.text(x, y, text) + + +def plot_linestring(linestring, ax, color, linestyle, label, **kwargs): + xs = [pt.x for pt in linestring] + ys = [pt.y for pt in linestring] + ax.plot(xs, ys, color=color, linestyle=linestyle, label=label, **kwargs) + + +def test_utility_utilities(lanelet_map, routing_graph): + lanelet108 = lanelet_map.laneletLayer.get(108) + lanelet108_next = query.getSucceedingLaneletSequences(routing_graph, lanelet108, 100.0) + lanelet108_seq = [lanelet108, *lanelet108_next[0]] + lanelet108_seq_combined = utilities.combineLaneletsShape(lanelet108_seq) + lanelet108_seq_combined_fine_centerline = utilities.generateFineCenterline( + lanelet108_seq_combined, 1.0 + ) + lanelet108_seq_combined_right_offset = utilities.getRightBoundWithOffset( + lanelet108_seq_combined, 1.0, 1.0 + ) + lanelet108_seq_combined_left_offset = utilities.getLeftBoundWithOffset( + lanelet108_seq_combined, 1.0, 1.0 + ) + fig = plt.figure() + ax = fig.add_subplot(1, 3, 1) + ax.axis("equal") + plot_linestring(lanelet108_seq_combined.leftBound, ax, "orange", "-", "108 left") + plot_linestring(lanelet108_seq_combined.rightBound, ax, "orange", "-", "108 right") + plot_linestring(lanelet108_seq_combined_fine_centerline, ax, "orange", "--", "108 center") + plot_linestring(lanelet108_seq_combined_right_offset, ax, "cyan", "--", "108 right offset") + plot_linestring(lanelet108_seq_combined_left_offset, ax, "red", "--", "108 left offset") + [plot_ll2_id(ll2, ax, str(ll2.id)) for ll2 in lanelet108_seq] + ax.set_title("test of combineLaneletsShape ~ getLeftBoundWithOffset") + + expanded_lanelet108 = utilities.getExpandedLanelet(lanelet108, 1.0, -1.0) + expanded_lanelet108_seq = utilities.getExpandedLanelets(lanelet108_seq, 2.0, -2.0) + ax = fig.add_subplot(1, 3, 2) + ax.axis("equal") + plot_linestring(expanded_lanelet108.leftBound, ax, "orange", "-", "expanded 108 left(1.0)") + plot_linestring(expanded_lanelet108.rightBound, ax, "orange", "-", "expanded 108 right(-1.0)") + plot_linestring(expanded_lanelet108.centerline, ax, "orange", "--", "expanded 108 center") + [ + ( + plot_linestring(ll2.leftBound, ax, "orange", "-", None), + plot_linestring(ll2.rightBound, ax, "orange", "-", None), + ) + for ll2 in expanded_lanelet108_seq + ] + [plot_ll2_id(ll2, ax, f"{ll2.id}(2.0)") for ll2 in expanded_lanelet108_seq] + ax.set_title("test of getExpandedLanelet(s)") + + print(f"""{utilities.getLaneletLength2d(lanelet108)=}""") + print(f"""{utilities.getLaneletLength2d(lanelet108_seq)=}""") + print(f"""{utilities.getLaneletLength3d(lanelet108)=}""") + print(f"""{utilities.getLaneletLength3d(lanelet108_seq)=}""") + + search_pose = Pose(position=Point(x=3685.0, y=73750.0)) + arc_coords = utilities.getArcCoordinates(lanelet108_seq, search_pose) + print( + f"""utilities.getArcCoordinates(lanelet108_seq, search_pose) = (length: {arc_coords.length}, distance: {arc_coords.distance})""" + ) + closest_lanelet = query.getClosestLanelet(lanelet108_seq, search_pose) + assert closest_lanelet.id == 156 + closest_segment = utilities.getClosestSegment( + lanelet2.core.BasicPoint2d(x=search_pose.position.x, y=search_pose.position.y), + closest_lanelet.centerline, + ) + ax = fig.add_subplot(1, 3, 3) + ax.axis("equal") + plot_linestring(closest_lanelet.leftBound, ax, "orange", "--", "156 left") + plot_linestring(closest_lanelet.rightBound, ax, "orange", "--", "156 right") + plot_linestring(closest_lanelet.centerline, ax, "cyan", "--", "156 center") + plot_linestring(closest_segment, ax, "red", "-", "closest segment", linewidth=2) + ax.scatter([search_pose.position.x], [search_pose.position.y], marker="o", label="search_pose") + + print(f"""{utilities.getLaneletAngle(closest_lanelet, search_pose.position)=}""") + print(f"""{utilities.isInLanelet(search_pose, closest_lanelet)=}""") + print(f"""{utilities.isInLanelet(search_pose, closest_lanelet, 5.0)=}""") + closest_center_pose = utilities.getClosestCenterPose(closest_lanelet, search_pose.position) + ax.scatter( + [closest_center_pose.position.x], + [closest_center_pose.position.y], + marker="o", + label="closest_center_pose", + ) + print(f"""{utilities.getLateralDistanceToCenterline(closest_lanelet, search_pose)=}""") + print(f"""{utilities.getLateralDistanceToClosestLanelet(lanelet108_seq, search_pose)=}""") + plt.legend() + plt.show() + + +def test_utility_query(lanelet_map, routing_graph): + lanelets = query.laneletLayer(lanelet_map) + lanelet56 = lanelet_map.laneletLayer.get(56) + lanelet108 = lanelet_map.laneletLayer.get(108) + print(f"""{len(query.subtypeLanelets(lanelets, "road"))=}""") + print(f"""{len(query.subtypeLanelets(lanelets, "road"))=}""") + print(f"""{len(query.crosswalkLanelets(lanelets))=}""") + print(f"""{len(query.walkwayLanelets(lanelets))=}""") + print(f"""{len(query.roadLanelets(lanelets))=}""") + print(f"""{len(query.shoulderLanelets(lanelets))=}""") + print(f"""{len(query.trafficLights(lanelets))=}""") + print(f"""{len(query.autowareTrafficLights(lanelets))=}""") + print(f"""{len(query.detectionAreas(lanelets))=}""") + print(f"""{len(query.noStoppingAreas(lanelets))=}""") + print(f"""{len(query.noParkingAreas(lanelets))=}""") + print(f"""{len(query.speedBumps(lanelets))=}""") + print(f"""{len(query.crosswalks(lanelets))=}""") + print(f"""{len(query.curbstones(lanelet_map))=}""") + print(f"""{len(query.getAllPolygonsByType(lanelet_map, "parking_lot"))=}""") + print(f"""{len(query.getAllParkingLots(lanelet_map))=}""") + print(f"""{len(query.getAllPartitions(lanelet_map))=}""") + print(f"""{len(query.getAllParkingSpaces(lanelet_map))=}""") + print(f"""{len(query.getAllFences(lanelet_map))=}""") + print(f"""{len(query.getAllPedestrianPolygonMarkings(lanelet_map))=}""") + print(f"""{len(query.getAllPedestrianLineMarkings(lanelet_map))=}""") + print(f"""{len(query.stopLinesLanelets(lanelets))=}""") + print(f"""{len(query.stopLinesLanelet(lanelet108))=}""") + print(f"""{len(query.stopSignStopLines(lanelets))=}""") + lanelet56_centerline_center = np.sum([p.basicPoint() for p in lanelet56.centerline]) * ( + 1.0 / len(lanelet56.centerline) + ) + search_point = Point( + x=lanelet56_centerline_center.x, + y=lanelet56_centerline_center.y, + z=lanelet56_centerline_center.z, + ) + print(f"""{search_point=}""") + print(f"""{[ll2.id for ll2 in query.getLaneletsWithinRange(lanelets, search_point, 15.0)]=}""") + search_point_2d = lanelet2.core.BasicPoint2d( + x=lanelet56_centerline_center.x, y=lanelet56_centerline_center.y + ) + print( + f"""{[ll2.id for ll2 in query.getLaneletsWithinRange(lanelets, search_point_2d, 15.0)]=}""" + ) + print(f"""{[ll2.id for ll2 in query.getLaneChangeableNeighbors(routing_graph, lanelet108)]=}""") + print( + f"""{[ll2.id for ll2 in query.getLaneChangeableNeighbors(routing_graph, query.roadLanelets(lanelets), search_point)]=}""" + ) + print(f"""{[ll2.id for ll2 in query.getAllNeighbors(routing_graph, lanelet56)]=}""") + print( + f"""{[ll2.id for ll2 in query.getAllNeighbors(routing_graph, query.roadLanelets(lanelets), search_point)]=}""" + ) + print(f"""{[ll2.id for ll2 in query.getAllNeighborsLeft(routing_graph, lanelet56)]=}""") + print(f"""{[ll2.id for ll2 in query.getAllNeighborsRight(routing_graph, lanelet56)]=}""") + search_pose = Pose() + search_pose.position = search_point + print( + f"""{(query.getClosestLanelet(lanelets, search_pose).id if query.getClosestLanelet(lanelets, search_pose) else None)=}""" + ) + print(f"""{[ll2.id for ll2 in query.getCurrentLanelets(lanelets, search_point)]=}""") + print( + f"""{[[ll2.id for ll2 in ll2s] for ll2s in query.getSucceedingLaneletSequences(routing_graph, lanelet108, 100.0)]=}""" + ) + print( + f"""{[[ll2.id for ll2 in ll2s] for ll2s in query.getPrecedingLaneletSequences(routing_graph, lanelet108, 100.0)]=}""" + ) + + +if __name__ == "__main__": + proj = test_projection() + # https://docs.google.com/uc?export=download&id=1499_nsbUbIeturZaDj7jhUownh5fvXHd. + # See https://autowarefoundation.github.io/autoware-documentation/main/tutorials/ad-hoc-simulation/planning-simulation/ + lanelet_map = test_io("", proj) + + traffic_rules = lanelet2.traffic_rules.create( + lanelet2.traffic_rules.Locations.Germany, + lanelet2.traffic_rules.Participants.Vehicle, + ) + routing_graph = lanelet2.routing.RoutingGraph(lanelet_map, traffic_rules) + + test_utility_utilities(lanelet_map, routing_graph) + test_utility_query(lanelet_map, routing_graph) diff --git a/lanelet2_extension_python/lanelet2_extension_python/__init__.py b/lanelet2_extension_python/lanelet2_extension_python/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/lanelet2_extension_python/lanelet2_extension_python/impl/__init__.py b/lanelet2_extension_python/lanelet2_extension_python/impl/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/lanelet2_extension_python/lanelet2_extension_python/projection/__init__.py b/lanelet2_extension_python/lanelet2_extension_python/projection/__init__.py new file mode 100644 index 0000000..b5e7067 --- /dev/null +++ b/lanelet2_extension_python/lanelet2_extension_python/projection/__init__.py @@ -0,0 +1,3 @@ +import lanelet2_extension_python._lanelet2_extension_python_boost_python_projection as _projection_cpp + +MGRSProjector = _projection_cpp.MGRSProjector diff --git a/lanelet2_extension_python/lanelet2_extension_python/regulatory_elements/__init__.py b/lanelet2_extension_python/lanelet2_extension_python/regulatory_elements/__init__.py new file mode 100644 index 0000000..010ecc9 --- /dev/null +++ b/lanelet2_extension_python/lanelet2_extension_python/regulatory_elements/__init__.py @@ -0,0 +1,10 @@ +import lanelet2_extension_python._lanelet2_extension_python_boost_python_regulatory_elements as _regulatory_elements_cpp + +AutowareTrafficLight = _regulatory_elements_cpp.AutowareTrafficLight +Crosswalk = _regulatory_elements_cpp.Crosswalk +DetectionArea = _regulatory_elements_cpp.DetectionArea +NoParkingArea = _regulatory_elements_cpp.NoParkingArea +NoStoppingArea = _regulatory_elements_cpp.NoStoppingArea +RoadMarking = _regulatory_elements_cpp.RoadMarking +SpeedBump = _regulatory_elements_cpp.SpeedBump +VirtualTrafficLight = _regulatory_elements_cpp.VirtualTrafficLight diff --git a/lanelet2_extension_python/lanelet2_extension_python/utility/__init__.py b/lanelet2_extension_python/lanelet2_extension_python/utility/__init__.py new file mode 100644 index 0000000..5ba63f1 --- /dev/null +++ b/lanelet2_extension_python/lanelet2_extension_python/utility/__init__.py @@ -0,0 +1 @@ +import lanelet2_extension_python.regulatory_elements # noqa diff --git a/lanelet2_extension_python/lanelet2_extension_python/utility/query.py b/lanelet2_extension_python/lanelet2_extension_python/utility/query.py new file mode 100644 index 0000000..7ac7206 --- /dev/null +++ b/lanelet2_extension_python/lanelet2_extension_python/utility/query.py @@ -0,0 +1,95 @@ +from geometry_msgs.msg import Point +from geometry_msgs.msg import Pose +import lanelet2.core +import lanelet2_extension_python._lanelet2_extension_python_boost_python_utility as _utility_cpp + +# from rclpy.serialization import deserialize_message +from rclpy.serialization import serialize_message + +laneletLayer = _utility_cpp.laneletLayer +subtypeLanelets = _utility_cpp.subtypeLanelets +crosswalkLanelets = _utility_cpp.crosswalkLanelets +walkwayLanelets = _utility_cpp.walkwayLanelets +roadLanelets = _utility_cpp.roadLanelets +shoulderLanelets = _utility_cpp.shoulderLanelets +trafficLights = _utility_cpp.trafficLights +autowareTrafficLights = _utility_cpp.autowareTrafficLights +detectionAreas = _utility_cpp.detectionAreas +noStoppingAreas = _utility_cpp.noStoppingAreas +noParkingAreas = _utility_cpp.noParkingAreas +speedBumps = _utility_cpp.speedBumps +crosswalks = _utility_cpp.crosswalks +curbstones = _utility_cpp.curbstones +getAllPolygonsByType = _utility_cpp.getAllPolygonsByType +getAllObstaclePolygons = _utility_cpp.getAllObstaclePolygons +getAllParkingLots = _utility_cpp.getAllParkingLots +getAllPartitions = _utility_cpp.getAllPartitions +getAllFences = _utility_cpp.getAllFences +getAllPedestrianPolygonMarkings = _utility_cpp.getAllPedestrianPolygonMarkings +getAllPedestrianLineMarkings = _utility_cpp.getAllPedestrianLineMarkings +getAllParkingSpaces = _utility_cpp.getAllParkingSpaces +getLinkedParkingSpaces = _utility_cpp.getLinkedParkingSpaces +getLinkedLanelet = _utility_cpp.getLinkedLanelet +getLinkedLanelets = _utility_cpp.getLinkedLanelets +getLinkedParkingLot = _utility_cpp.getLinkedParkingLot +stopLinesLanelets = _utility_cpp.stopLinesLanelets +stopLinesLanelet = _utility_cpp.stopLinesLanelet +stopSignStopLines = _utility_cpp.stopSignStopLines + + +def getLaneletsWithinRange(lanelets, point, rng): + if isinstance(point, Point): + point_byte = serialize_message(point) + return _utility_cpp.getLaneletsWithinRange_point(lanelets, point_byte, rng) + if isinstance(point, lanelet2.core.BasicPoint2d): + return _utility_cpp.getLaneletsWithinRange(lanelets, point, rng) + raise TypeError("argument point is neither BasicPoint2d nor Point") + + +def getLaneChangeableNeighbors(*args): + if len(args) == 2 and isinstance(args[1], lanelet2.core.Lanelet): + return _utility_cpp.getLaneChangeableNeighbors(args[0], args[1]) + if len(args) == 3 and isinstance(args[2], Point): + point_byte = serialize_message(args[2]) + return _utility_cpp.getLaneChangeableNeighbors_point(args[0], args[1], point_byte) + raise TypeError("argument number does not match or 3rd argument is not Point type") + + +def getAllNeighbors(*args): + if len(args) == 2 and isinstance(args[1], lanelet2.core.Lanelet): + return _utility_cpp.getAllNeighbors(args[0], args[1]) + if len(args) == 3 and isinstance(args[2], Point): + point_byte = serialize_message(args[2]) + return _utility_cpp.getAllNeighbors_point(args[0], args[1], point_byte) + + +getAllNeighborsLeft = _utility_cpp.getAllNeighborsLeft +getAllNeighborsRight = _utility_cpp.getAllNeighborsRight + + +def getClosestLanelet(lanelets, pose: Pose): + pose_byte = serialize_message(pose) + return _utility_cpp.getClosestLanelet(lanelets, pose_byte) + + +def getClosestLaneletWithConstrains( + lanelets, pose: Pose, closest_lanelet, dist_threshold, yaw_threshold +): + pose_byte = serialize_message(pose) + return _utility_cpp.getClosestLaneletWithConstrains( + lanelets, pose_byte, closest_lanelet, dist_threshold, yaw_threshold + ) + + +def getCurrentLanelets(lanelets, point: Point): + if isinstance(point, Point): + point_byte = serialize_message(point) + return _utility_cpp.getCurrentLanelets_point(lanelets, point_byte) + if isinstance(point, Pose): + pose_byte = serialize_message(point) + return _utility_cpp.getCurrentLanelets_pose(lanelets, pose_byte) + raise TypeError("argument number does not match or 2nd argument is not Point/Pose type") + + +getSucceedingLaneletSequences = _utility_cpp.getSucceedingLaneletSequences +getPrecedingLaneletSequences = _utility_cpp.getPrecedingLaneletSequences diff --git a/lanelet2_extension_python/lanelet2_extension_python/utility/utilities.py b/lanelet2_extension_python/lanelet2_extension_python/utility/utilities.py new file mode 100644 index 0000000..27acf99 --- /dev/null +++ b/lanelet2_extension_python/lanelet2_extension_python/utility/utilities.py @@ -0,0 +1,75 @@ +from geometry_msgs.msg import Point +from geometry_msgs.msg import Pose +from geometry_msgs.msg import Quaternion +import lanelet2 +import lanelet2_extension_python._lanelet2_extension_python_boost_python_utility as _utility_cpp +from rclpy.serialization import serialize_message + +combineLaneletsShape = _utility_cpp.combineLaneletsShape +generateFineCenterline = _utility_cpp.generateFineCenterline +getCenterlineWithOffset = _utility_cpp.getCenterlineWithOffset +getRightBoundWithOffset = _utility_cpp.getRightBoundWithOffset +getLeftBoundWithOffset = _utility_cpp.getLeftBoundWithOffset +getExpandedLanelet = _utility_cpp.getExpandedLanelet +getExpandedLanelets = _utility_cpp.getExpandedLanelets +overwriteLaneletsCenterline = _utility_cpp.overwriteLaneletsCenterline +getConflictingLanelets = _utility_cpp.getConflictingLanelets +lineStringWithWidthToPolygon = _utility_cpp.lineStringWithWidthToPolygon +lineStringToPolygon = _utility_cpp.lineStringToPolygon + + +def getLaneletLength2d(*args): + if len(args) == 1 and isinstance(args[0], lanelet2.core.Lanelet): + return _utility_cpp.getLaneletLength2d(args[0]) + if len(args) == 1 and isinstance(args[0], list): + return _utility_cpp.getLaneletLength2d(args[0]) + raise TypeError( + "argument number does not match or 1st argument is not Lanelet or [Lanelet] type" + ) + + +def getLaneletLength3d(*args): + if len(args) == 1 and isinstance(args[0], lanelet2.core.Lanelet): + return _utility_cpp.getLaneletLength3d(args[0]) + if len(args) == 1 and isinstance(args[0], list): + return _utility_cpp.getLaneletLength3d(args[0]) + raise TypeError( + "argument number does not match or 1st argument is not Lanelet or [Lanelet] type" + ) + + +def getArcCoordinates(lanelet_sequence, pose: Pose): + pose_byte = serialize_message(pose) + return _utility_cpp.getArcCoordinates(lanelet_sequence, pose_byte) + + +getClosestSegment = _utility_cpp.getClosestSegment +getPolygonFromArcLength = _utility_cpp.getPolygonFromArcLength + + +def getLaneletAngle(lanelet, point: Point): + point_byte = serialize_message(point) + return _utility_cpp.getLaneletAngle(lanelet, point_byte) + + +def isInLanelet(pose: Pose, lanelet, radius=0.0): + pose_byte = serialize_message(pose) + return _utility_cpp.isInLanelet(pose_byte, lanelet, radius) + + +def getClosestCenterPose(lanelet, point: Point): + point_byte = serialize_message(point) + pose_array = _utility_cpp.getClosestCenterPose(lanelet, point_byte) + pos = Point(x=pose_array[0], y=pose_array[1], z=pose_array[2]) + quat = Quaternion(x=pose_array[3], y=pose_array[4], z=pose_array[5], w=pose_array[6]) + return Pose(position=pos, orientation=quat) + + +def getLateralDistanceToCenterline(lanelet, pose: Pose): + pose_byte = serialize_message(pose) + return _utility_cpp.getLateralDistanceToCenterline(lanelet, pose_byte) + + +def getLateralDistanceToClosestLanelet(lanelet_sequence, pose: Pose): + pose_byte = serialize_message(pose) + return _utility_cpp.getLateralDistanceToClosestLanelet(lanelet_sequence, pose_byte) diff --git a/lanelet2_extension_python/package.xml b/lanelet2_extension_python/package.xml new file mode 100644 index 0000000..d6444e4 --- /dev/null +++ b/lanelet2_extension_python/package.xml @@ -0,0 +1,31 @@ + + + + lanelet2_extension_python + 0.1.0 + The lanelet2_extension_python package contains Python bindings for lanelet2_extension package + Mamoru Sobue + Apache License 2.0 + + ament_cmake_auto + autoware_cmake + python_cmake_module + + geometry_msgs + lanelet2_core + lanelet2_extension + lanelet2_io + lanelet2_projection + lanelet2_python + lanelet2_routing + lanelet2_traffic_rules + lanelet2_validation + libboost-python-dev + rclcpp + + ament_cmake_ros + + + ament_cmake + + diff --git a/lanelet2_extension_python/src/projection.cpp b/lanelet2_extension_python/src/projection.cpp new file mode 100644 index 0000000..1f70a21 --- /dev/null +++ b/lanelet2_extension_python/src/projection.cpp @@ -0,0 +1,42 @@ +// Copyright 2023 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Mamoru Sobue + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include + +#include + +#include + +#include + +BOOST_PYTHON_MODULE(_lanelet2_extension_python_boost_python_projection) +{ + namespace bp = boost::python; + + bp::class_< + lanelet::projection::MGRSProjector, std::shared_ptr, + bp::bases>("MGRSProjector", bp::init("origin")); + bp::class_< + lanelet::projection::TransverseMercatorProjector, + std::shared_ptr, + bp::bases>( + "TransverseMercatorProjector", bp::init("origin")); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension_python/src/regulatory_elements.cpp b/lanelet2_extension_python/src/regulatory_elements.cpp new file mode 100644 index 0000000..acddb81 --- /dev/null +++ b/lanelet2_extension_python/src/regulatory_elements.cpp @@ -0,0 +1,307 @@ +// Copyright 2023 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Mamoru Sobue + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +namespace bp = boost::python; + +// from lanelet2_python/src/core.cpp + +void format_helper([[maybe_unused]] std::ostream & os) +{ +} + +template +void format_helper(std::ostream & os, const std::string & s, const Args &... Args_) +{ + if (!s.empty()) { + os << ", "; + } + os << s; + format_helper(os, Args_...); +} + +template +void format_helper(std::ostream & os, const T & next, const Args &... Args_) +{ + os << ", "; + os << next; + format_helper(os, Args_...); +} + +template +void format(std::ostream & os, const T & first, const Args &... Args_) +{ + os << first; + format_helper(os, Args_...); +} + +template +std::string make_repr(const char * name, const Args &... Args_) +{ + std::ostringstream os; + os << name << '('; + format(os, Args_...); + os << ')'; + return os.str(); +} + +std::string repr(const bp::object & o) +{ + bp::object repr = bp::import("builtins").attr("repr"); + return bp::call(repr.ptr(), o); +} + +std::string repr(const lanelet::AttributeMap & a) +{ + if (a.empty()) { + return {}; + } + return repr(bp::object(a)); +} + +std::string repr(const lanelet::RegulatoryElementConstPtrs & regulatory_elements) +{ + if (regulatory_elements.empty()) { + return {}; + } + return repr(bp::list(regulatory_elements)); +} + +BOOST_PYTHON_MODULE(_lanelet2_extension_python_boost_python_regulatory_elements) +{ + // autoware_traffic_light + bp::class_< + lanelet::autoware::AutowareTrafficLight, boost::noncopyable, + std::shared_ptr, bp::bases>( + "AutowareTrafficLight", "autoware traffic light regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::AutowareTrafficLight::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("trafficLights"), + bp::arg("stopline") = lanelet::Optional(), + bp::arg("lightBulbs") = lanelet::LineString3d({})))) + .def( + "lightBulbs", + +[](lanelet::autoware::AutowareTrafficLight & self) { return self.lightBulbs(); }) + .def("addLightBulbs", &lanelet::autoware::AutowareTrafficLight::addLightBulbs) + .def("removeLightBulbs", &lanelet::autoware::AutowareTrafficLight::removeLightBulbs) + .def( + "__repr__", +[](lanelet::autoware::AutowareTrafficLight & r) { + return make_repr( + "AutowareTrafficLight", r.id(), repr(bp::dict(r.constData()->parameters)), + repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // crosswalk + bp::class_< + lanelet::autoware::Crosswalk, boost::noncopyable, std::shared_ptr, + bp::bases>( + "Crosswalk", "autoware crosswalk regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::Crosswalk::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("crosswalk_lanelet"), + bp::arg("crosswalk_area"), bp::arg("stop_line")))) + .def( + "crosswalkAreas", +[](lanelet::autoware::Crosswalk & self) { return self.crosswalkAreas(); }) + .def( + "stopLines", +[](lanelet::autoware::Crosswalk & self) { return self.stopLines(); }) + .def( + "crosswalkLanelet", + +[](lanelet::autoware::Crosswalk & self) { return self.crosswalkLanelet(); }) + .def("addCrosswalkArea", &lanelet::autoware::Crosswalk::addCrosswalkArea) + .def("removeCrosswalkArea", &lanelet::autoware::Crosswalk::removeCrosswalkArea) + .def( + "__repr__", +[](lanelet::autoware::Crosswalk & r) { + return make_repr( + "Crosswalk", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // detection_area + bp::class_< + lanelet::autoware::DetectionArea, boost::noncopyable, + std::shared_ptr, bp::bases>( + "DetectionArea", "detection_area regulatory element", bp::no_init) + .def( + "__init__", + bp::make_constructor( + &lanelet::autoware::DetectionArea::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("detectionAreas"), bp::arg("stopLine")))) + .def( + "detectionAreas", + +[](lanelet::autoware::DetectionArea & self) { return self.detectionAreas(); }) + .def("addDetectionArea", &lanelet::autoware::DetectionArea::addDetectionArea) + .def("removeDetectionArea", &lanelet::autoware::DetectionArea::removeDetectionArea) + .def( + "stopLine", +[](lanelet::autoware::DetectionArea & self) { return self.stopLine(); }) + .def("setStopLine", &lanelet::autoware::DetectionArea::setStopLine) + .def("removeStopLine", &lanelet::autoware::DetectionArea::removeStopLine) + .def( + "__repr__", +[](lanelet::autoware::DetectionArea & r) { + return make_repr( + "DetectionArea", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // no_parking_area + bp::class_< + lanelet::autoware::NoParkingArea, boost::noncopyable, + std::shared_ptr, bp::bases>( + "NoParkingArea", "no_parking_area regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::NoParkingArea::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("no_parking_areas")))) + .def( + "noParkingAreas", + +[](lanelet::autoware::NoParkingArea & self) { return self.noParkingAreas(); }) + .def("addNoParkingArea", &lanelet::autoware::NoParkingArea::addNoParkingArea) + .def("removeNoParkingArea", &lanelet::autoware::NoParkingArea::removeNoParkingArea) + .def( + "__repr__", +[](lanelet::autoware::NoParkingArea & r) { + return make_repr( + "NoParkingArea", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // no_stopping_area + bp::class_< + lanelet::autoware::NoStoppingArea, boost::noncopyable, + std::shared_ptr, bp::bases>( + "NoStoppingArea", "no_stopping_area regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::NoStoppingArea::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("no_stopping_areas"), + bp::arg("stopLine") = lanelet::Optional()))) + .def( + "noStoppingAreas", + +[](lanelet::autoware::NoStoppingArea & self) { return self.noStoppingAreas(); }) + .def("addNoStoppingArea", &lanelet::autoware::NoStoppingArea::addNoStoppingArea) + .def("removeNoStoppingArea", &lanelet::autoware::NoStoppingArea::removeNoStoppingArea) + .def( + "stopLine", +[](lanelet::autoware::NoStoppingArea & self) { return self.stopLine(); }) + .def("setStopLine", &lanelet::autoware::NoStoppingArea::setStopLine) + .def("removeStopLine", &lanelet::autoware::NoStoppingArea::removeStopLine) + .def( + "__repr__", +[](lanelet::autoware::NoParkingArea & r) { + return make_repr( + "NoParkingArea", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // road_marking + bp::class_< + lanelet::autoware::RoadMarking, boost::noncopyable, + std::shared_ptr, bp::bases>( + "RoadMarking", "road_marking regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::RoadMarking::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("road_marking")))) + .def( + "roadMarking", +[](lanelet::autoware::RoadMarking & self) { return self.roadMarking(); }) + .def("setRoadMarking", &lanelet::autoware::RoadMarking::setRoadMarking) + .def("removeRoadMarking", &lanelet::autoware::RoadMarking::removeRoadMarking) + .def( + "__repr__", +[](lanelet::autoware::RoadMarking & r) { + return make_repr( + "RoadMarking", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // speed_bump + bp::class_< + lanelet::autoware::SpeedBump, boost::noncopyable, std::shared_ptr, + bp::bases>( + "SpeedBump", "speed_bump regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::SpeedBump::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("speed_bump")))) + .def( + "speedBump", +[](lanelet::autoware::SpeedBump & self) { return self.speedBump(); }) + .def("addSpeedBump", &lanelet::autoware::SpeedBump::addSpeedBump) + .def("removeSpeedBump", &lanelet::autoware::SpeedBump::removeSpeedBump) + .def( + "__repr__", +[](lanelet::autoware::SpeedBump & r) { + return make_repr( + "SpeedBump", r.id(), repr(bp::dict(r.constData()->parameters)), repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + // virtual_traffic_light + bp::class_< + lanelet::autoware::VirtualTrafficLight, boost::noncopyable, + std::shared_ptr, bp::bases>( + "VirtualTrafficLight", "virtual_traffic_light regulatory element", bp::no_init) + .def( + "__init__", bp::make_constructor( + &lanelet::autoware::VirtualTrafficLight::make, bp::default_call_policies(), + (bp::arg("Id"), bp::arg("attributes"), bp::arg("virtual_traffic_light")))) + .def( + "getVirtualTrafficLight", + +[](lanelet::autoware::VirtualTrafficLight & self) { return self.getVirtualTrafficLight(); }) + .def( + "getStopLine", + +[](lanelet::autoware::VirtualTrafficLight & self) { return self.getStopLine(); }) + .def( + "getStartLine", + +[](lanelet::autoware::VirtualTrafficLight & self) { return self.getStartLine(); }) + .def( + "getEndLines", + +[](lanelet::autoware::VirtualTrafficLight & self) { return self.getEndLines(); }) + .def( + "__repr__", +[](lanelet::autoware::VirtualTrafficLight & r) { + return make_repr( + "VirtualTrafficLight", r.id(), repr(bp::dict(r.constData()->parameters)), + repr(r.attributes())); + }); + bp::implicitly_convertible< + std::shared_ptr, lanelet::RegulatoryElementPtr>(); + + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); + bp::register_ptr_to_python(); +} + +// NOLINTEND(readability-identifier-naming) diff --git a/lanelet2_extension_python/src/utility.cpp b/lanelet2_extension_python/src/utility.cpp new file mode 100644 index 0000000..fdd612f --- /dev/null +++ b/lanelet2_extension_python/src/utility.cpp @@ -0,0 +1,564 @@ +// Copyright 2023 Autoware Foundation. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Authors: Mamoru Sobue + +// NOLINTBEGIN(readability-identifier-naming) + +#include +#include +#include +#include + +#include +#include + +#include +#include +#include + +#include +#include + +namespace bp = boost::python; + +namespace +{ + +/* + * utilities.cpp + */ +lanelet::Optional lineStringWithWidthToPolygon( + const lanelet::ConstLineString3d & linestring) +{ + lanelet::ConstPolygon3d poly{}; + if (lanelet::utils::lineStringWithWidthToPolygon(linestring, &poly)) { + return poly; + } else { + return {}; + } +} + +lanelet::Optional lineStringToPolygon( + const lanelet::ConstLineString3d & linestring) +{ + lanelet::ConstPolygon3d poly{}; + if (lanelet::utils::lineStringToPolygon(linestring, &poly)) { + return poly; + } else { + return {}; + } +} + +lanelet::ArcCoordinates getArcCoordinates( + const lanelet::ConstLanelets & lanelet_sequence, const std::string & pose_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + return lanelet::utils::getArcCoordinates(lanelet_sequence, pose); +} + +double getLaneletAngle(const lanelet::ConstLanelet & lanelet, const std::string & point_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + point_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = point_byte.size(); + for (size_t i = 0; i < point_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = point_byte[i]; + } + geometry_msgs::msg::Point point; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &point); + return lanelet::utils::getLaneletAngle(lanelet, point); +} + +bool isInLanelet( + const std::string & pose_byte, const lanelet::ConstLanelet & lanelet, const double radius = 0.0) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + return lanelet::utils::isInLanelet(pose, lanelet, radius); +} + +std::vector getClosestCenterPose( + const lanelet::ConstLanelet & lanelet, const std::string & search_point_byte) +{ + rclcpp::SerializedMessage serialized_point_msg; + static constexpr size_t message_header_length = 8u; + serialized_point_msg.reserve(message_header_length + search_point_byte.size()); + serialized_point_msg.get_rcl_serialized_message().buffer_length = search_point_byte.size(); + for (size_t i = 0; i < search_point_byte.size(); ++i) { + serialized_point_msg.get_rcl_serialized_message().buffer[i] = search_point_byte[i]; + } + geometry_msgs::msg::Point search_point; + static rclcpp::Serialization serializer_point; + serializer_point.deserialize_message(&serialized_point_msg, &search_point); + const geometry_msgs::msg::Pose pose = lanelet::utils::getClosestCenterPose(lanelet, search_point); + // NOTE: it was difficult to return the deserialized pose_byte and serialize the pose_byte on + // python-side. So this function returns [*position, *quaternion] as double array + const auto & xyz = pose.position; + const auto & quat = pose.orientation; + return std::vector({xyz.x, xyz.y, xyz.z, quat.x, quat.y, quat.z, quat.w}); +} + +double getLateralDistanceToCenterline( + const lanelet::ConstLanelet & lanelet, const std::string & pose_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + return lanelet::utils::getLateralDistanceToCenterline(lanelet, pose); +} + +double getLateralDistanceToClosestLanelet( + const lanelet::ConstLanelets & lanelet_sequence, const std::string & pose_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + return lanelet::utils::getLateralDistanceToClosestLanelet(lanelet_sequence, pose); +} + +/* + * query.cpp + */ + +lanelet::ConstLanelets subtypeLanelets( + const lanelet::ConstLanelets & lls, const std::string & subtype) +{ + return lanelet::utils::query::subtypeLanelets(lls, subtype.c_str()); +} + +lanelet::Optional getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstLanelets & all_road_lanelets, + const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstLanelet linked_lanelet; + if (lanelet::utils::query::getLinkedLanelet( + parking_space, all_road_lanelets, all_parking_lots, &linked_lanelet)) { + return linked_lanelet; + } else { + return {}; + } +} + +lanelet::Optional getLinkedLanelet( + const lanelet::ConstLineString3d & parking_space, + const lanelet::LaneletMapConstPtr & lanelet_map_ptr) +{ + lanelet::ConstLanelet linked_lanelet; + if (lanelet::utils::query::getLinkedLanelet(parking_space, lanelet_map_ptr, &linked_lanelet)) { + return linked_lanelet; + } else { + return {}; + } +} + +lanelet::Optional getLinkedParkingLot( + const lanelet::ConstLanelet & lanelet, const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstPolygon3d linked_parking_lot; + if (lanelet::utils::query::getLinkedParkingLot(lanelet, all_parking_lots, &linked_parking_lot)) { + return linked_parking_lot; + } else { + return {}; + } +} + +lanelet::Optional getLinkedParkingLot( + const lanelet::BasicPoint2d & current_position, const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstPolygon3d linked_parking_lot; + if (lanelet::utils::query::getLinkedParkingLot( + current_position, all_parking_lots, &linked_parking_lot)) { + return linked_parking_lot; + } else { + return {}; + } +} + +lanelet::Optional getLinkedParkingLot( + const lanelet::ConstLineString3d & parking_space, + const lanelet::ConstPolygons3d & all_parking_lots) +{ + lanelet::ConstPolygon3d linked_parking_lot; + if (lanelet::utils::query::getLinkedParkingLot( + parking_space, all_parking_lots, &linked_parking_lot)) { + return linked_parking_lot; + } else { + return {}; + } +} + +lanelet::ConstLanelets getLaneletsWithinRange_point( + const lanelet::ConstLanelets & lanelets, const std::string & point_byte, const double range) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + point_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = point_byte.size(); + for (size_t i = 0; i < point_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = point_byte[i]; + } + geometry_msgs::msg::Point point; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &point); + return lanelet::utils::query::getLaneletsWithinRange(lanelets, point, range); +} + +lanelet::ConstLanelets getLaneChangeableNeighbors_point( + const lanelet::routing::RoutingGraphPtr & graph, const lanelet::ConstLanelets & road_lanelets, + const std::string & point_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + point_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = point_byte.size(); + for (size_t i = 0; i < point_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = point_byte[i]; + } + geometry_msgs::msg::Point point; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &point); + return lanelet::utils::query::getLaneChangeableNeighbors(graph, road_lanelets, point); +} + +lanelet::ConstLanelets getAllNeighbors_point( + const lanelet::routing::RoutingGraphPtr & graph, const lanelet::ConstLanelets & road_lanelets, + const std::string & point_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + point_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = point_byte.size(); + for (size_t i = 0; i < point_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = point_byte[i]; + } + geometry_msgs::msg::Point point; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &point); + return lanelet::utils::query::getAllNeighbors(graph, road_lanelets, point); +} + +lanelet::Optional getClosestLanelet( + const lanelet::ConstLanelets & lanelets, const std::string & pose_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + lanelet::ConstLanelet closest_lanelet{}; + if (lanelet::utils::query::getClosestLanelet(lanelets, pose, &closest_lanelet)) { + return closest_lanelet; + } else { + return {}; + } +} + +lanelet::Optional getClosestLaneletWithConstrains( + const lanelet::ConstLanelets & lanelets, const std::string & pose_byte, + const double dist_threshold = std::numeric_limits::max(), + const double yaw_threshold = std::numeric_limits::max()) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + lanelet::ConstLanelet closest_lanelet{}; + if (lanelet::utils::query::getClosestLaneletWithConstrains( + lanelets, pose, &closest_lanelet, dist_threshold, yaw_threshold)) { + return closest_lanelet; + } else { + return {}; + } +} + +lanelet::ConstLanelets getCurrentLanelets_point( + const lanelet::ConstLanelets & lanelets, const std::string & point_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + point_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = point_byte.size(); + for (size_t i = 0; i < point_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = point_byte[i]; + } + geometry_msgs::msg::Point point; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &point); + lanelet::ConstLanelets current_lanelets{}; + lanelet::utils::query::getCurrentLanelets(lanelets, point, ¤t_lanelets); + return current_lanelets; +} + +lanelet::ConstLanelets getCurrentLanelets_pose( + const lanelet::ConstLanelets & lanelets, const std::string & pose_byte) +{ + rclcpp::SerializedMessage serialized_msg; + static constexpr size_t message_header_length = 8u; + serialized_msg.reserve(message_header_length + pose_byte.size()); + serialized_msg.get_rcl_serialized_message().buffer_length = pose_byte.size(); + for (size_t i = 0; i < pose_byte.size(); ++i) { + serialized_msg.get_rcl_serialized_message().buffer[i] = pose_byte[i]; + } + geometry_msgs::msg::Pose pose; + static rclcpp::Serialization serializer; + serializer.deserialize_message(&serialized_msg, &pose); + lanelet::ConstLanelets current_lanelets{}; + lanelet::utils::query::getCurrentLanelets(lanelets, pose, ¤t_lanelets); + return current_lanelets; +} + +} // namespace + +// for handling functions with default arguments +/// utilities.cpp +BOOST_PYTHON_FUNCTION_OVERLOADS( + generateFineCenterline_overload, lanelet::utils::generateFineCenterline, 1, 2) +BOOST_PYTHON_FUNCTION_OVERLOADS( + getCenterlineWithOffset_overload, lanelet::utils::getCenterlineWithOffset, 2, 3) +BOOST_PYTHON_FUNCTION_OVERLOADS( + getRightBoundWithOffset_overload, lanelet::utils::getRightBoundWithOffset, 2, 3) +BOOST_PYTHON_FUNCTION_OVERLOADS( + getLeftBoundWithOffset_overload, lanelet::utils::getLeftBoundWithOffset, 2, 3) +BOOST_PYTHON_FUNCTION_OVERLOADS( + overwriteLaneletsCenterline_overload, lanelet::utils::overwriteLaneletsCenterline, 1, 3) +BOOST_PYTHON_FUNCTION_OVERLOADS(isInLanelet_overload, ::isInLanelet, 2, 3) + +/// query.cpp +BOOST_PYTHON_FUNCTION_OVERLOADS( + stopSignStopLines_overload, lanelet::utils::query::stopSignStopLines, 1, 2) +BOOST_PYTHON_FUNCTION_OVERLOADS( + getClosestLaneletWithConstrains_overload, ::getClosestLaneletWithConstrains, 2, 4) +BOOST_PYTHON_FUNCTION_OVERLOADS( + getPrecedingLaneletSequences_overload, lanelet::utils::query::getPrecedingLaneletSequences, 3, 4) + +BOOST_PYTHON_MODULE(_lanelet2_extension_python_boost_python_utility) +{ + /* + * utilities.cpp + */ + bp::def("combineLaneletsShape", lanelet::utils::combineLaneletsShape); + bp::def( + "generateFineCenterline", lanelet::utils::generateFineCenterline, + generateFineCenterline_overload()); + bp::def( + "getCenterlineWithOffset", lanelet::utils::getCenterlineWithOffset, + getCenterlineWithOffset_overload()); + bp::def( + "getRightBoundWithOffset", lanelet::utils::getRightBoundWithOffset, + getRightBoundWithOffset_overload()); + bp::def( + "getLeftBoundWithOffset", lanelet::utils::getLeftBoundWithOffset, + getLeftBoundWithOffset_overload()); + bp::def("getExpandedLanelet", lanelet::utils::getExpandedLanelet); + bp::def("getExpandedLanelets", lanelet::utils::getExpandedLanelets); + bp::def( + "overwriteLaneletsCenterline", lanelet::utils::overwriteLaneletsCenterline, + overwriteLaneletsCenterline_overload()); + bp::def("getConflictingLanelets", lanelet::utils::getConflictingLanelets); + bp::def("lineStringWithWidthToPolygon", ::lineStringWithWidthToPolygon); + bp::def("lineStringToPolygon", ::lineStringToPolygon); + bp::def( + "getLaneletLength2d", lanelet::utils::getLaneletLength2d); + bp::def( + "getLaneletLength3d", lanelet::utils::getLaneletLength3d); + bp::def( + "getLaneletLength2d", lanelet::utils::getLaneletLength2d); + bp::def( + "getLaneletLength3d", lanelet::utils::getLaneletLength3d); + bp::def("getArcCoordinates", ::getArcCoordinates); // depends ros msg + bp::def("getClosestSegment", lanelet::utils::getClosestSegment); + bp::def("getPolygonFromArcLength", lanelet::utils::getPolygonFromArcLength); + bp::def("getLaneletAngle", ::getLaneletAngle); // depends on ros msg + bp::def("isInLanelet", ::isInLanelet, isInLanelet_overload()); // depends ros msg + bp::def("getClosestCenterPose", ::getClosestCenterPose); // depends ros msg + // NOTE: required for the return-value of getClosestCenterPose + bp::class_>("[position, quaternion]") + .def(bp::vector_indexing_suite>()); + bp::def("getLateralDistanceToCenterline", ::getLateralDistanceToCenterline); // depends ros msg + bp::def( + "getLateralDistanceToClosestLanelet", ::getLateralDistanceToClosestLanelet); // depends ros msg + + /* + * query.cpp + */ + bp::def("laneletLayer", lanelet::utils::query::laneletLayer); + bp::def("subtypeLanelets", ::subtypeLanelets); + bp::def("crosswalkLanelets", lanelet::utils::query::crosswalkLanelets); + bp::def("walkwayLanelets", lanelet::utils::query::walkwayLanelets); + bp::def("roadLanelets", lanelet::utils::query::roadLanelets); + bp::def("shoulderLanelets", lanelet::utils::query::shoulderLanelets); + bp::def("trafficLights", lanelet::utils::query::trafficLights); + + bp::def("autowareTrafficLights", lanelet::utils::query::autowareTrafficLights); + converters::VectorToListConverter>(); + + bp::def("detectionAreas", lanelet::utils::query::detectionAreas); + converters::VectorToListConverter>(); + + bp::def("noStoppingAreas", lanelet::utils::query::noStoppingAreas); + converters::VectorToListConverter>(); + + bp::def("noParkingAreas", lanelet::utils::query::noParkingAreas); + converters::VectorToListConverter>(); + + bp::def("speedBumps", lanelet::utils::query::speedBumps); + converters::VectorToListConverter>(); + + bp::def("crosswalks", lanelet::utils::query::crosswalks); + converters::VectorToListConverter>(); + + bp::def("curbstones", lanelet::utils::query::curbstones); + bp::def("getAllPolygonsByType", lanelet::utils::query::getAllPolygonsByType); + bp::def("getAllObstaclePolygons", lanelet::utils::query::getAllObstaclePolygons); + bp::def("getAllParkingLots", lanelet::utils::query::getAllParkingLots); + bp::def("getAllPartitions", lanelet::utils::query::getAllPartitions); + bp::def("getAllFences", lanelet::utils::query::getAllFences); + bp::def( + "getAllPedestrianPolygonMarkings", lanelet::utils::query::getAllPedestrianPolygonMarkings); + bp::def("getAllPedestrianLineMarkings", lanelet::utils::query::getAllPedestrianLineMarkings); + bp::def("getAllParkingSpaces", lanelet::utils::query::getAllParkingSpaces); + + bp::def( + "getLinkedParkingSpaces", lanelet::utils::query::getLinkedParkingSpaces); + bp::def( + "getLinkedParkingSpaces", lanelet::utils::query::getLinkedParkingSpaces); + // NOTE: required for iterating the return-value of getLinkedParkingSpaces/getAllParkingLots, but + // this causes RuntimeWarning for duplicate to-Python converter + bp::class_("lanelet::ConstLineStrings3d") + .def(bp::vector_indexing_suite()); + bp::class_("lanelet::ConstPolygons3d") + .def(bp::vector_indexing_suite()); + + bp::def( + const lanelet::ConstLineString3d &, const lanelet::ConstLanelets &, + const lanelet::ConstPolygons3d &)>("getLinkedLanelet", ::getLinkedLanelet); + bp::def( + const lanelet::ConstLineString3d &, const lanelet::LaneletMapConstPtr &)>( + "getLinkedLanelet", ::getLinkedLanelet); + bp::def( + "getLinkedLanelets", lanelet::utils::query::getLinkedLanelets); + bp::def( + "getLinkedLanelets", lanelet::utils::query::getLinkedLanelets); + bp::def( + const lanelet::ConstLanelet &, const lanelet::ConstPolygons3d &)>( + "getLinkedParkingLot", ::getLinkedParkingLot); + bp::def( + const lanelet::BasicPoint2d &, const lanelet::ConstPolygons3d &)>( + "getLinkedParkingLot", ::getLinkedParkingLot); + bp::def( + const lanelet::ConstLineString3d &, const lanelet::ConstPolygons3d &)>( + "getLinkedParkingLot", ::getLinkedParkingLot); + bp::def( + "getLinkedParkingSpaces", lanelet::utils::query::getLinkedParkingSpaces); + bp::def( + "getLinkedLanelets", lanelet::utils::query::getLinkedLanelets); + bp::def("stopLinesLanelets", lanelet::utils::query::stopLinesLanelets); + bp::def("stopLinesLanelet", lanelet::utils::query::stopLinesLanelet); + bp::def( + "stopSignStopLines", lanelet::utils::query::stopSignStopLines, stopSignStopLines_overload()); + bp::def( + "getLaneletsWithinRange", lanelet::utils::query::getLaneletsWithinRange); + bp::def( + "getLaneletsWithinRange_point", ::getLaneletsWithinRange_point); // depends on ros msg + bp::def( + "getLaneChangeableNeighbors", lanelet::utils::query::getLaneChangeableNeighbors); + bp::def( + "getLaneChangeableNeighbors_point", ::getLaneChangeableNeighbors_point); // depends on ros msg + bp::def( + "getAllNeighbors", lanelet::utils::query::getAllNeighbors); + bp::def("getAllNeighbors_point", ::getAllNeighbors_point); // depends on ros msg + bp::def("getAllNeighborsLeft", lanelet::utils::query::getAllNeighborsLeft); + bp::def("getAllNeighborsRight", lanelet::utils::query::getAllNeighborsRight); + bp::def("getClosestLanelet", ::getClosestLanelet); // depends on ros msg + bp::def( + "getClosestLaneletWithConstrains", ::getClosestLaneletWithConstrains, + getClosestLaneletWithConstrains_overload()); // depends on ros msg + bp::def("getCurrentLanelets_point", ::getCurrentLanelets_point); // depends on ros msg + bp::def("getCurrentLanelets_pose", ::getCurrentLanelets_pose); // depends on ros msg + // NOTE: this is required for iterating getCurrentLanelets return value directly + bp::class_("lanelet::ConstLanelets") + .def(bp::vector_indexing_suite()); + // NOTE: this is required for return-type of getSucceeding/PrecedingLaneletSequences + bp::class_>("std::vector") + .def(bp::vector_indexing_suite>()); + bp::def("getSucceedingLaneletSequences", lanelet::utils::query::getSucceedingLaneletSequences); + bp::def( + "getPrecedingLaneletSequences", lanelet::utils::query::getPrecedingLaneletSequences, + getPrecedingLaneletSequences_overload()); +} + +// NOLINTEND(readability-identifier-naming) From 354b57b0c4d68f8abb39360fd4bd9aa3e64a4e2f Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:33:04 +0900 Subject: [PATCH 02/13] update readme Signed-off-by: Yutaka Kondo --- README.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 101 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8d1e47e..85e360b 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,101 @@ -# autoware_lanelet2_extension -Extension library of Lanelet2 +# lanelet2_extension package + +This package contains external library for Lanelet2 and is meant to ease the use of Lanelet2 in Autoware. + +## Lanelet Format for Autoware + +Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](./docs/lanelet2_format_extension.md). + +## Code API + +### IO + +#### Autoware OSM Parser + +Autoware Lanelet2 Format uses .osm extension as original Lanelet2. +However, there are some custom tags that is used by the parser. + +Currently, this includes: + +- reading `` tag which contains information about map format version and map version. + +The parser is registered as "autoware_osm_handler" as lanelet parser + +### Projection + +#### MGRS Projector + +MGRS projector projects latitude longitude into MGRS Coordinates. + +#### Transverse Mercator Projector + +This projector projects latitude and longitude into Transverse Mercator coordinate. +This is similar to [UTM projector](https://github.com/fzi-forschungszentrum-informatik/Lanelet2/blob/master/lanelet2_projection/src/UTM.cpp) in the Lanelet2 library, but uses a custom central meridian on a given origin. + +### Regulatory Elements + +#### Autoware Traffic Light + +Autoware Traffic Light class allows you to retrieve information about traffic lights. +Autoware Traffic Light class contains following members: + +- traffic light shape +- light bulbs information of traffic lights +- stopline associated to traffic light + +#### Right Of Way + +Autoware intersection module requires the information on which lanes can be ignored for object detection, like those lanes whose traffic light color is red when that of ego is green, etc. `right_of_way` tag is a regulatory element that consists of a tuple of (`right_of_way`s and `yield_lane`s), and `right_of_way`s have priority over`yield_lane`s. Although `right_of_way` tag itself is defined in Lanelet2, this package provides proper conditions on how this tag should be set. + +### Utility + +#### Message Conversion + +This contains functions to convert lanelet map objects into ROS messages. +Currently it contains following conversions: + +- lanelet::LaneletMapPtr to/from autoware_auto_mapping_msgs::msg::HADMapBin +- lanelet::Point3d to geometry_msgs::Point +- lanelet::Point2d to geometry_msgs::Point +- lanelet::BasicPoint3d to geometry_msgs::Point + +#### Query + +This module contains functions to retrieve various information from maps. +e.g. crosswalks, trafficlights, stoplines + +#### Utilities + +This module contains other useful functions related to Lanelet. +e.g. matching waypoint with lanelets + +#### Route Checker + +This module contains a function to check the loading route is valid or not. +If it is invalid, puts warning without dying. +The case valid is when the route is created on the same map as the current one. + +### Visualization + +Visualization contains functions to convert lanelet objects into visualization marker messages. +Currently it contains following conversions: + +- lanelet::Lanelet to Triangle Markers +- lanelet::LineString to LineStrip Markers +- TrafficLights to Triangle Markers + +## Nodes + +### lanelet2_extension_sample + +Code for this explains how this lanelet2_extension library is used. +The executable is not meant to do anything. + +### autoware_lanelet2_extension + +This node checks if an .osm file follows the Autoware version of Lanelet2 format. +You can check by running: + +```sh +ros2 run lanelet2_extension autoware_lanelet2_validation --ros-args -p map_file:= +``` From 080f1128cb35f8d408d70bb15ad6388fd81631f0 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:33:53 +0900 Subject: [PATCH 03/13] import settings from autoware_common Signed-off-by: Yutaka Kondo --- .clang-format | 47 ++ .clang-tidy | 461 ++++++++++++++++++ .github/CODEOWNERS | 7 + .github/CODEOWNERS-manual | 0 .github/ISSUE_TEMPLATE/bug.yaml | 71 +++ .github/ISSUE_TEMPLATE/config.yml | 13 + .github/ISSUE_TEMPLATE/task.yaml | 42 ++ .github/PULL_REQUEST_TEMPLATE.md | 8 + .github/PULL_REQUEST_TEMPLATE/small-change.md | 40 ++ .../PULL_REQUEST_TEMPLATE/standard-change.md | 50 ++ .github/dependabot.yaml | 10 + .github/stale.yml | 12 + .github/sync-files-reverse-reference.yaml | 39 ++ .github/sync-files.yaml | 32 ++ ...ild-and-test-differential-self-hosted.yaml | 58 +++ .../build-and-test-differential.yaml | 91 ++++ .../workflows/build-and-test-self-hosted.yaml | 46 ++ .../build-and-test-with-reverse-depends.yaml | 52 ++ .github/workflows/build-and-test.yaml | 66 +++ .../workflows/cancel-previous-workflows.yaml | 14 + .github/workflows/check-build-depends.yaml | 37 ++ .../clang-tidy-pr-comments-manually.yaml | 62 +++ .github/workflows/clang-tidy-pr-comments.yaml | 63 +++ .github/workflows/github-release.yaml | 78 +++ .github/workflows/pre-commit-autoupdate.yaml | 37 ++ .github/workflows/pre-commit-optional.yaml | 19 + .github/workflows/pre-commit.yaml | 27 + .github/workflows/semantic-pull-request.yaml | 12 + .../workflows/spell-check-differential.yaml | 16 + .../sync-files-reverse-reference.yaml | 24 + .github/workflows/sync-files.yaml | 33 ++ .../update-codeowners-from-packages.yaml | 33 ++ .markdown-link-check.json | 16 + .markdownlint.yaml | 11 + .pre-commit-config-optional.yaml | 6 + .pre-commit-config.yaml | 95 ++++ .prettierignore | 2 + .prettierrc.yaml | 20 + .yamllint.yaml | 22 + CODE_OF_CONDUCT.md | 132 +++++ CONTRIBUTING.md | 3 + CPPLINT.cfg | 14 + DISCLAIMER.md | 46 ++ build_depends.repos | 9 + codecov.yaml | 22 + setup.cfg | 15 + 46 files changed, 2013 insertions(+) create mode 100644 .clang-format create mode 100644 .clang-tidy create mode 100644 .github/CODEOWNERS create mode 100644 .github/CODEOWNERS-manual create mode 100644 .github/ISSUE_TEMPLATE/bug.yaml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/task.yaml create mode 100644 .github/PULL_REQUEST_TEMPLATE.md create mode 100644 .github/PULL_REQUEST_TEMPLATE/small-change.md create mode 100644 .github/PULL_REQUEST_TEMPLATE/standard-change.md create mode 100644 .github/dependabot.yaml create mode 100644 .github/stale.yml create mode 100644 .github/sync-files-reverse-reference.yaml create mode 100644 .github/sync-files.yaml create mode 100644 .github/workflows/build-and-test-differential-self-hosted.yaml create mode 100644 .github/workflows/build-and-test-differential.yaml create mode 100644 .github/workflows/build-and-test-self-hosted.yaml create mode 100644 .github/workflows/build-and-test-with-reverse-depends.yaml create mode 100644 .github/workflows/build-and-test.yaml create mode 100644 .github/workflows/cancel-previous-workflows.yaml create mode 100644 .github/workflows/check-build-depends.yaml create mode 100644 .github/workflows/clang-tidy-pr-comments-manually.yaml create mode 100644 .github/workflows/clang-tidy-pr-comments.yaml create mode 100644 .github/workflows/github-release.yaml create mode 100644 .github/workflows/pre-commit-autoupdate.yaml create mode 100644 .github/workflows/pre-commit-optional.yaml create mode 100644 .github/workflows/pre-commit.yaml create mode 100644 .github/workflows/semantic-pull-request.yaml create mode 100644 .github/workflows/spell-check-differential.yaml create mode 100644 .github/workflows/sync-files-reverse-reference.yaml create mode 100644 .github/workflows/sync-files.yaml create mode 100644 .github/workflows/update-codeowners-from-packages.yaml create mode 100644 .markdown-link-check.json create mode 100644 .markdownlint.yaml create mode 100644 .pre-commit-config-optional.yaml create mode 100644 .pre-commit-config.yaml create mode 100644 .prettierignore create mode 100644 .prettierrc.yaml create mode 100644 .yamllint.yaml create mode 100644 CODE_OF_CONDUCT.md create mode 100644 CONTRIBUTING.md create mode 100644 CPPLINT.cfg create mode 100644 DISCLAIMER.md create mode 100644 build_depends.repos create mode 100644 codecov.yaml create mode 100644 setup.cfg diff --git a/.clang-format b/.clang-format new file mode 100644 index 0000000..b41fae9 --- /dev/null +++ b/.clang-format @@ -0,0 +1,47 @@ +# Modified from https://github.com/ament/ament_lint/blob/master/ament_clang_format/ament_clang_format/configuration/.clang-format +Language: Cpp +BasedOnStyle: Google + +AccessModifierOffset: -2 +AlignAfterOpenBracket: AlwaysBreak +AllowShortFunctionsOnASingleLine: InlineOnly +BraceWrapping: + AfterClass: true + AfterFunction: true + AfterNamespace: true + AfterStruct: true +BreakBeforeBraces: Custom +ColumnLimit: 100 +ConstructorInitializerIndentWidth: 0 +ContinuationIndentWidth: 2 +DerivePointerAlignment: false +PointerAlignment: Middle +ReflowComments: true +IncludeCategories: + # C++ system headers + - Regex: <[a-z_]*> + Priority: 6 + CaseSensitive: true + # C system headers + - Regex: <.*\.h> + Priority: 5 + CaseSensitive: true + # Boost headers + - Regex: boost/.* + Priority: 4 + CaseSensitive: true + # Message headers + - Regex: .*_msgs/.* + Priority: 3 + CaseSensitive: true + - Regex: .*_srvs/.* + Priority: 3 + CaseSensitive: true + # Other Package headers + - Regex: <.*> + Priority: 2 + CaseSensitive: true + # Local package headers + - Regex: '".*"' + Priority: 1 + CaseSensitive: true diff --git a/.clang-tidy b/.clang-tidy new file mode 100644 index 0000000..c4533f5 --- /dev/null +++ b/.clang-tidy @@ -0,0 +1,461 @@ +Checks: " + -*, + boost-use-to-string, + bugprone-argument-comment, + bugprone-assert-side-effect, + bugprone-bad-signal-to-kill-thread, + bugprone-bool-pointer-implicit-conversion, + bugprone-branch-clone, + bugprone-copy-constructor-init, + bugprone-dangling-handle, + bugprone-dynamic-static-initializers, + bugprone-exception-escape, + bugprone-fold-init-type, + bugprone-forward-declaration-namespace, + bugprone-forwarding-reference-overload, + bugprone-inaccurate-erase, + bugprone-incorrect-roundings, + bugprone-integer-division, + bugprone-lambda-function-name, + bugprone-macro-parentheses, + bugprone-macro-repeated-side-effects, + bugprone-misplaced-operator-in-strlen-in-alloc, + bugprone-misplaced-widening-cast, + bugprone-move-forwarding-reference, + bugprone-multiple-statement-macro, + bugprone-not-null-terminated-result, + bugprone-parent-virtual-call, + bugprone-posix-return, + bugprone-signed-char-misuse, + bugprone-sizeof-container, + bugprone-sizeof-expression, + bugprone-string-constructor, + bugprone-string-integer-assignment, + bugprone-string-literal-with-embedded-nul, + bugprone-suspicious-enum-usage, + bugprone-suspicious-memset-usage, + bugprone-suspicious-missing-comma, + bugprone-suspicious-semicolon, + bugprone-suspicious-string-compare, + bugprone-swapped-arguments, + bugprone-terminating-continue, + bugprone-throw-keyword-missing, + bugprone-too-small-loop-variable, + bugprone-unchecked-optional-access, + bugprone-undefined-memory-manipulation, + bugprone-undelegated-constructor, + bugprone-unhandled-self-assignment, + bugprone-unused-raii, + bugprone-unused-return-value, + bugprone-use-after-move, + bugprone-virtual-near-miss, + cppcoreguidelines-avoid-goto, + cppcoreguidelines-init-variables, + cppcoreguidelines-interfaces-global-init, + cppcoreguidelines-macro-usage, + cppcoreguidelines-narrowing-conversions, + cppcoreguidelines-no-malloc, + cppcoreguidelines-pro-bounds-pointer-arithmetic, + cppcoreguidelines-pro-type-const-cast, + cppcoreguidelines-pro-type-cstyle-cast, + cppcoreguidelines-pro-type-member-init, + cppcoreguidelines-pro-type-reinterpret-cast, + cppcoreguidelines-pro-type-static-cast-downcast, + cppcoreguidelines-pro-type-union-access, + cppcoreguidelines-slicing, + cppcoreguidelines-special-member-functions, + google-build-explicit-make-pair, + google-build-namespaces, + google-build-using-namespace, + google-explicit-constructor, + google-global-names-in-headers, + google-upgrade-googletest-case, + hicpp-exception-baseclass, + hicpp-multiway-paths-covered, + hicpp-no-assembler, + hicpp-signed-bitwise, + llvm-namespace-comment, + misc-definitions-in-headers, + misc-misplaced-const, + misc-new-delete-overloads, + misc-non-copyable-objects, + misc-redundant-expression, + misc-static-assert, + misc-throw-by-value-catch-by-reference, + misc-unconventional-assign-operator, + misc-uniqueptr-reset-release, + misc-unused-alias-decls, + misc-unused-parameters, + misc-unused-using-decls, + modernize-concat-nested-namespaces, + modernize-deprecated-headers, + modernize-deprecated-ios-base-aliases, + modernize-loop-convert, + modernize-make-shared, + modernize-make-unique, + modernize-pass-by-value, + modernize-raw-string-literal, + modernize-redundant-void-arg, + modernize-replace-auto-ptr, + modernize-replace-disallow-copy-and-assign-macro, + modernize-replace-random-shuffle, + modernize-return-braced-init-list, + modernize-shrink-to-fit, + modernize-unary-static-assert, + modernize-use-auto, + modernize-use-bool-literals, + modernize-use-default-member-init, + modernize-use-emplace, + modernize-use-equals-default, + modernize-use-equals-delete, + modernize-use-nodiscard, + modernize-use-noexcept, + modernize-use-nullptr, + modernize-use-override, + modernize-use-transparent-functors, + modernize-use-uncaught-exceptions, + modernize-use-using, + openmp-use-default-none, + performance-faster-string-find, + performance-for-range-copy, + performance-implicit-conversion-in-loop, + performance-inefficient-algorithm, + performance-inefficient-string-concatenation, + performance-inefficient-vector-operation, + performance-move-const-arg, + performance-move-constructor-init, + performance-no-automatic-move, + performance-no-int-to-ptr, + performance-noexcept-move-constructor, + performance-trivially-destructible, + performance-type-promotion-in-math-fn, + performance-unnecessary-copy-initialization, + performance-unnecessary-value-param, + portability-simd-intrinsics, + readability-const-return-type, + readability-container-size-empty, + readability-convert-member-functions-to-static, + readability-delete-null-pointer, + readability-else-after-return, + readability-function-cognitive-complexity, + readability-identifier-naming, + readability-inconsistent-declaration-parameter-name, + readability-isolate-declaration, + readability-make-member-function-const, + readability-misleading-indentation, + readability-misplaced-array-index, + readability-non-const-parameter, + readability-redundant-access-specifiers, + readability-redundant-control-flow, + readability-redundant-declaration, + readability-redundant-function-ptr-dereference, + readability-redundant-member-init, + readability-redundant-smartptr-get, + readability-redundant-string-cstr, + readability-redundant-string-init, + readability-simplify-boolean-expr, + readability-simplify-subscript-expr, + readability-static-accessed-through-instance, + readability-static-definition-in-anonymous-namespace, + readability-string-compare, + readability-uniqueptr-delete-release" + +WarningsAsErrors: " + boost-use-to-string, + bugprone-dangling-handle, + bugprone-fold-init-type, + bugprone-inaccurate-erase, + bugprone-incorrect-roundings, + bugprone-misplaced-widening-cast, + bugprone-sizeof-container, + bugprone-sizeof-expression, + bugprone-string-constructor, + bugprone-suspicious-enum-usage, + bugprone-suspicious-memset-usage, + bugprone-suspicious-missing-comma, + bugprone-suspicious-semicolon, + bugprone-swapped-arguments, + bugprone-unused-raii, + bugprone-use-after-move, + llvm-namespace-comment, + misc-non-copyable-objects, + misc-redundant-expression, + misc-throw-by-value-catch-by-reference, + misc-unused-alias-decls, + misc-unused-parameters, + misc-unused-using-decls, + modernize-deprecated-headers, + modernize-redundant-void-arg, + modernize-use-bool-literals, + modernize-use-emplace, + modernize-use-equals-default, + modernize-use-equals-delete, + modernize-use-nullptr, + modernize-use-override, + modernize-use-using, + performance-faster-string-find, + performance-inefficient-algorithm, + readability-make-member-function-const, + readability-misleading-indentation, + readability-misplaced-array-index, + readability-string-compare" + +HeaderFilterRegex: ^(?!\/usr)(?!\/opt) + +AnalyzeTemporaryDtors: false + +FormatStyle: none + +CheckOptions: + - key: bugprone-argument-comment.CommentBoolLiterals + value: "0" + - key: bugprone-argument-comment.CommentCharacterLiterals + value: "0" + - key: bugprone-argument-comment.CommentFloatLiterals + value: "0" + - key: bugprone-argument-comment.CommentIntegerLiterals + value: "0" + - key: bugprone-argument-comment.CommentNullPtrs + value: "0" + - key: bugprone-argument-comment.CommentStringLiterals + value: "0" + - key: bugprone-argument-comment.CommentUserDefinedLiterals + value: "0" + - key: bugprone-argument-comment.IgnoreSingleArgument + value: "0" + - key: bugprone-argument-comment.StrictMode + value: "0" + - key: bugprone-assert-side-effect.AssertMacros + value: assert + - key: bugprone-assert-side-effect.CheckFunctionCalls + value: "0" + - key: bugprone-dangling-handle.HandleClasses + value: std::basic_string_view;std::experimental::basic_string_view + - key: bugprone-dynamic-static-initializers.HeaderFileExtensions + value: ",h,hh,hpp,hxx" + - key: bugprone-exception-escape.FunctionsThatShouldNotThrow + value: "" + - key: bugprone-exception-escape.IgnoredExceptions + value: "" + - key: bugprone-misplaced-widening-cast.CheckImplicitCasts + value: "0" + - key: bugprone-not-null-terminated-result.WantToUseSafeFunctions + value: "1" + - key: bugprone-signed-char-misuse.CharTypdefsToIgnore + value: "" + - key: bugprone-sizeof-expression.WarnOnSizeOfCompareToConstant + value: "1" + - key: bugprone-sizeof-expression.WarnOnSizeOfConstant + value: "1" + - key: bugprone-sizeof-expression.WarnOnSizeOfIntegerExpression + value: "0" + - key: bugprone-sizeof-expression.WarnOnSizeOfThis + value: "1" + - key: bugprone-string-constructor.LargeLengthThreshold + value: "8388608" + - key: bugprone-string-constructor.WarnOnLargeLength + value: "1" + - key: bugprone-suspicious-enum-usage.StrictMode + value: "0" + - key: bugprone-suspicious-missing-comma.MaxConcatenatedTokens + value: "5" + - key: bugprone-suspicious-missing-comma.RatioThreshold + value: "0.200000" + - key: bugprone-suspicious-missing-comma.SizeThreshold + value: "5" + - key: bugprone-suspicious-string-compare.StringCompareLikeFunctions + value: "" + - key: bugprone-suspicious-string-compare.WarnOnImplicitComparison + value: "1" + - key: bugprone-suspicious-string-compare.WarnOnLogicalNotComparison + value: "0" + - key: bugprone-too-small-loop-variable.MagnitudeBitsUpperLimit + value: "16" + - key: bugprone-unhandled-self-assignment.WarnOnlyIfThisHasSuspiciousField + value: "1" + - key: bugprone-unused-return-value.CheckedFunctions + value: ::std::async;::std::launder;::std::remove;::std::remove_if;::std::unique;::std::unique_ptr::release;::std::basic_string::empty;::std::vector::empty + - key: cert-dcl16-c.NewSuffixes + value: L;LL;LU;LLU + - key: cert-oop54-cpp.WarnOnlyIfThisHasSuspiciousField + value: "0" + - key: cppcoreguidelines-explicit-virtual-functions.IgnoreDestructors + value: "1" + - key: cppcoreguidelines-macro-usage.AllowedRegexp + value: ^DEBUG_* + - key: cppcoreguidelines-macro-usage.CheckCapsOnly + value: "0" + - key: cppcoreguidelines-macro-usage.IgnoreCommandLineMacros + value: "1" + - key: cppcoreguidelines-no-malloc.Allocations + value: ::malloc;::calloc + - key: cppcoreguidelines-no-malloc.Deallocations + value: ::free + - key: cppcoreguidelines-no-malloc.Reallocations + value: ::realloc + - key: cppcoreguidelines-non-private-member-variables-in-classes.IgnoreClassesWithAllMemberVariablesBeingPublic + value: "1" + - key: cppcoreguidelines-pro-type-member-init.IgnoreArrays + value: "0" + - key: cppcoreguidelines-pro-type-member-init.UseAssignment + value: "0" + - key: cppcoreguidelines-special-member-functions.AllowMissingMoveFunctions + value: "0" + - key: cppcoreguidelines-special-member-functions.AllowSoleDefaultDtor + value: "0" + - key: google-readability-braces-around-statements.ShortStatementLines + value: "1" + - key: google-readability-function-size.StatementThreshold + value: "800" + - key: google-readability-namespace-comments.ShortNamespaceLines + value: "10" + - key: google-readability-namespace-comments.SpacesBeforeComments + value: "2" + - key: hicpp-multiway-paths-covered.WarnOnMissingElse + value: "0" + - key: hicpp-signed-bitwise.IgnorePositiveIntegerLiterals + value: "0" + - key: misc-definitions-in-headers.HeaderFileExtensions + value: ",h,hh,hpp,hxx" + - key: misc-definitions-in-headers.UseHeaderFileExtension + value: "1" + - key: misc-throw-by-value-catch-by-reference.CheckThrowTemporaries + value: "1" + - key: misc-unused-parameters.StrictMode + value: "0" + - key: modernize-loop-convert.MaxCopySize + value: "16" + - key: modernize-loop-convert.MinConfidence + value: reasonable + - key: modernize-loop-convert.NamingStyle + value: CamelCase + - key: modernize-make-shared.IgnoreMacros + value: "1" + - key: modernize-make-shared.IncludeStyle + value: google + - key: modernize-make-shared.MakeSmartPtrFunction + value: std::make_shared + - key: modernize-make-shared.MakeSmartPtrFunctionHeader + value: memory + - key: modernize-make-unique.IgnoreMacros + value: "1" + - key: modernize-make-unique.IncludeStyle + value: google + - key: modernize-make-unique.MakeSmartPtrFunction + value: std::make_unique + - key: modernize-make-unique.MakeSmartPtrFunctionHeader + value: memory + - key: modernize-pass-by-value.IncludeStyle + value: google + - key: modernize-pass-by-value.ValuesOnly + value: "0" + - key: modernize-raw-string-literal.ReplaceShorterLiterals + value: "0" + - key: modernize-replace-auto-ptr.IncludeStyle + value: google + - key: modernize-replace-random-shuffle.IncludeStyle + value: google + - key: modernize-use-auto.MinTypeNameLength + value: "5" + - key: modernize-use-auto.RemoveStars + value: "0" + - key: modernize-use-default-member-init.IgnoreMacros + value: "1" + - key: modernize-use-default-member-init.UseAssignment + value: "0" + - key: modernize-use-emplace.ContainersWithPushBack + value: ::std::vector;::std::list;::std::deque + - key: modernize-use-emplace.SmartPointers + value: ::std::shared_ptr;::std::unique_ptr;::std::auto_ptr;::std::weak_ptr + - key: modernize-use-emplace.TupleMakeFunctions + value: ::std::make_pair;::std::make_tuple + - key: modernize-use-emplace.TupleTypes + value: ::std::pair;::std::tuple + - key: modernize-use-equals-default.IgnoreMacros + value: "1" + - key: modernize-use-equals-delete.IgnoreMacros + value: "1" + - key: modernize-use-nodiscard.ReplacementString + value: "[[nodiscard]]" + - key: modernize-use-noexcept.ReplacementString + value: "" + - key: modernize-use-noexcept.UseNoexceptFalse + value: "1" + - key: modernize-use-nullptr.NullMacros + value: "NULL" + - key: modernize-use-override.AllowOverrideAndFinal + value: "0" + - key: modernize-use-override.FinalSpelling + value: final + - key: modernize-use-override.IgnoreDestructors + value: "0" + - key: modernize-use-override.OverrideSpelling + value: override + - key: modernize-use-transparent-functors.SafeMode + value: "0" + - key: modernize-use-using.IgnoreMacros + value: "1" + - key: performance-faster-string-find.StringLikeClasses + value: std::basic_string + - key: performance-for-range-copy.AllowedTypes + value: "" + - key: performance-for-range-copy.WarnOnAllAutoCopies + value: "0" + - key: performance-inefficient-string-concatenation.StrictMode + value: "0" + - key: performance-inefficient-vector-operation.EnableProto + value: "0" + - key: performance-inefficient-vector-operation.VectorLikeClasses + value: ::std::vector + - key: performance-move-const-arg.CheckTriviallyCopyableMove + value: "1" + - key: performance-move-constructor-init.IncludeStyle + value: google + - key: performance-no-automatic-move.AllowedTypes + value: "" + - key: performance-type-promotion-in-math-fn.IncludeStyle + value: google + - key: performance-unnecessary-copy-initialization.AllowedTypes + value: "" + - key: performance-unnecessary-value-param.AllowedTypes + value: .*Ptr;.*SharedFuture + - key: performance-unnecessary-value-param.IncludeStyle + value: google + - key: portability-simd-intrinsics.Std + value: "" + - key: portability-simd-intrinsics.Suggest + value: "0" + - key: readability-function-cognitive-complexity.IgnoreMacros + value: "1" + - key: readability-else-after-return.WarnOnUnfixable + value: "1" + - key: readability-identifier-naming.NamespaceCase + value: lower_case + - key: readability-identifier-naming.ClassCase + value: CamelCase + - key: readability-identifier-naming.PrivateMemberSuffix + value: _ + - key: readability-identifier-naming.StructCase + value: CamelCase + - key: readability-identifier-naming.FunctionCase + value: lower_case + - key: readability-identifier-naming.VariableCase + value: lower_case + - key: readability-identifier-naming.GlobalConstantCase + value: lower_case + - key: readability-identifier-naming.GlobalConstantPrefix + value: g_ + - key: readability-identifier-naming.ConstexprVariableCase + value: lower_case + - key: readability-inconsistent-declaration-parameter-name.IgnoreMacros + value: "1" + - key: readability-inconsistent-declaration-parameter-name.Strict + value: "0" + - key: readability-redundant-smartptr-get.IgnoreMacros + value: "1" + - key: readability-redundant-string-init.StringNames + value: ::std::basic_string + - key: readability-simplify-subscript-expr.Types + value: ::std::basic_string;::std::basic_string_view;::std::vector;::std::array + - key: readability-static-accessed-through-instance.NameSpecifierNestingThreshold + value: "3" diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000..19ac6b4 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,7 @@ +### Copied from .github/CODEOWNERS-manual ### + +### Automatically generated from package.xml ### +autoware_cmake/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp +autoware_lint_common/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp +autoware_utils/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp +tmp/lanelet2_extension/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp diff --git a/.github/CODEOWNERS-manual b/.github/CODEOWNERS-manual new file mode 100644 index 0000000..e69de29 diff --git a/.github/ISSUE_TEMPLATE/bug.yaml b/.github/ISSUE_TEMPLATE/bug.yaml new file mode 100644 index 0000000..12a8579 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yaml @@ -0,0 +1,71 @@ +name: Bug +description: Report a bug +body: + - type: checkboxes + attributes: + label: Checklist + description: Confirm the following items before proceeding. If one cannot be satisfied, create a discussion thread instead. + options: + - label: I've read the [contribution guidelines](https://github.com/autowarefoundation/autoware/blob/main/CONTRIBUTING.md). + required: true + - label: I've searched other issues and no duplicate issues were found. + required: true + - label: I'm convinced that this is not my fault but a bug. + required: true + + - type: textarea + attributes: + label: Description + description: Write a brief description of the bug. + validations: + required: true + + - type: textarea + attributes: + label: Expected behavior + description: Describe the expected behavior. + validations: + required: true + + - type: textarea + attributes: + label: Actual behavior + description: Describe the actual behavior. + validations: + required: true + + - type: textarea + attributes: + label: Steps to reproduce + description: Write the steps to reproduce the bug. + placeholder: |- + 1. + 2. + 3. + validations: + required: true + + - type: textarea + attributes: + label: Versions + description: Provide the version information. You can omit this if you believe it's irrelevant. + placeholder: |- + - OS: + - ROS 2: + - Autoware: + validations: + required: false + + - type: textarea + attributes: + label: Possible causes + description: Write the possible causes if you have any ideas. + validations: + required: false + + - type: textarea + attributes: + label: Additional context + description: Add any other additional context if it exists. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..48765c2 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,13 @@ +blank_issues_enabled: false +contact_links: + - name: Question + url: https://github.com/autowarefoundation/autoware/discussions/new?category=q-a + about: Ask a question + + - name: Feature request + url: https://github.com/autowarefoundation/autoware/discussions/new?category=feature-requests + about: Send a feature request + + - name: Idea + url: https://github.com/autowarefoundation/autoware/discussions/new?category=ideas + about: Post an idea diff --git a/.github/ISSUE_TEMPLATE/task.yaml b/.github/ISSUE_TEMPLATE/task.yaml new file mode 100644 index 0000000..cd8322f --- /dev/null +++ b/.github/ISSUE_TEMPLATE/task.yaml @@ -0,0 +1,42 @@ +name: Task +description: Plan a task +body: + - type: checkboxes + attributes: + label: Checklist + description: Confirm the following items before proceeding. If one cannot be satisfied, create a discussion thread instead. + options: + - label: I've read the [contribution guidelines](https://github.com/autowarefoundation/autoware/blob/main/CONTRIBUTING.md). + required: true + - label: I've searched other issues and no duplicate issues were found. + required: true + - label: I've agreed with the maintainers that I can plan this task. + required: true + + - type: textarea + attributes: + label: Description + description: Write a brief description of the task. + validations: + required: true + + - type: textarea + attributes: + label: Purpose + description: Describe the purpose of the task. + validations: + required: true + + - type: textarea + attributes: + label: Possible approaches + description: Describe possible approaches for the task. + validations: + required: true + + - type: textarea + attributes: + label: Definition of done + description: Write the definition of done for the task. + validations: + required: true diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..97b0e95 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,8 @@ +**Note**: Confirm the [contribution guidelines](https://autowarefoundation.github.io/autoware-documentation/main/contributing/) before submitting a pull request. + +Click the `Preview` tab and select a PR template: + +- [Standard change](?expand=1&template=standard-change.md) +- [Small change](?expand=1&template=small-change.md) + +**Do NOT send a PR with this description.** diff --git a/.github/PULL_REQUEST_TEMPLATE/small-change.md b/.github/PULL_REQUEST_TEMPLATE/small-change.md new file mode 100644 index 0000000..2ff933c --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE/small-change.md @@ -0,0 +1,40 @@ +## Description + + + +## Tests performed + + + + +Not applicable. + +## Effects on system behavior + + + +Not applicable. + +## Pre-review checklist for the PR author + +The PR author **must** check the checkboxes below when creating the PR. + +- [ ] I've confirmed the [contribution guidelines]. +- [ ] The PR follows the [pull request guidelines]. + +## In-review checklist for the PR reviewers + +The PR reviewers **must** check the checkboxes below before approval. + +- [ ] The PR follows the [pull request guidelines]. + +## Post-review checklist for the PR author + +The PR author **must** check the checkboxes below before merging. + +- [ ] There are no open discussions or they are tracked via tickets. + +After all checkboxes are checked, anyone who has write access can merge the PR. + +[contribution guidelines]: https://autowarefoundation.github.io/autoware-documentation/main/contributing/ +[pull request guidelines]: https://autowarefoundation.github.io/autoware-documentation/main/contributing/pull-request-guidelines/ diff --git a/.github/PULL_REQUEST_TEMPLATE/standard-change.md b/.github/PULL_REQUEST_TEMPLATE/standard-change.md new file mode 100644 index 0000000..7aedefd --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE/standard-change.md @@ -0,0 +1,50 @@ +## Description + + + +## Related links + + + +## Tests performed + + + +## Notes for reviewers + + + +## Interface changes + + + +## Effects on system behavior + + + +## Pre-review checklist for the PR author + +The PR author **must** check the checkboxes below when creating the PR. + +- [ ] I've confirmed the [contribution guidelines]. +- [ ] The PR follows the [pull request guidelines]. + +## In-review checklist for the PR reviewers + +The PR reviewers **must** check the checkboxes below before approval. + +- [ ] The PR follows the [pull request guidelines]. +- [ ] The PR has been properly tested. +- [ ] The PR has been reviewed by the code owners. + +## Post-review checklist for the PR author + +The PR author **must** check the checkboxes below before merging. + +- [ ] There are no open discussions or they are tracked via tickets. +- [ ] The PR is ready for merge. + +After all checkboxes are checked, anyone who has write access can merge the PR. + +[contribution guidelines]: https://autowarefoundation.github.io/autoware-documentation/main/contributing/ +[pull request guidelines]: https://autowarefoundation.github.io/autoware-documentation/main/contributing/pull-request-guidelines/ diff --git a/.github/dependabot.yaml b/.github/dependabot.yaml new file mode 100644 index 0000000..0264c03 --- /dev/null +++ b/.github/dependabot.yaml @@ -0,0 +1,10 @@ +version: 2 +updates: + - package-ecosystem: github-actions + directory: / + schedule: + interval: daily + open-pull-requests-limit: 1 + labels: + - tag:bot + - type:github-actions diff --git a/.github/stale.yml b/.github/stale.yml new file mode 100644 index 0000000..bc99e43 --- /dev/null +++ b/.github/stale.yml @@ -0,0 +1,12 @@ +# Modified from https://github.com/probot/stale#usage + +# Number of days of inactivity before an Issue or Pull Request with the stale label is closed +daysUntilClose: false + +# Label to use when marking as stale +staleLabel: status:stale + +# Comment to post when marking as stale +markComment: > + This pull request has been automatically marked as stale because it has not had + recent activity. diff --git a/.github/sync-files-reverse-reference.yaml b/.github/sync-files-reverse-reference.yaml new file mode 100644 index 0000000..f5d016c --- /dev/null +++ b/.github/sync-files-reverse-reference.yaml @@ -0,0 +1,39 @@ +- repository: autowarefoundation/autoware.universe + files: + - source: .github/workflows/build-and-test.yaml + pre-commands: | + sd -s '${{ matrix.container-suffix }}' '' {source} + sd -f ms 'container-suffix:.*include:' 'include:' {source} + + sd "container: ghcr.io/autowarefoundation/autoware-universe:(\w+)-latest.*" "container: ros:\$1" {source} + sd "build_depends.humble.repos" "build_depends.repos" {source} + - source: .github/workflows/build-and-test-differential.yaml + pre-commands: | + sd -s '${{ matrix.container-suffix }}' '' {source} + sd -f ms 'container-suffix:.*include:' 'include:' {source} + + sd "container: ghcr.io/autowarefoundation/autoware-universe:(\w+)-latest.*" "container: ros:\$1" {source} + sd "build_depends.humble.repos" "build_depends.repos" {source} + - source: .github/workflows/build-and-test-differential-self-hosted.yaml + pre-commands: | + sd -s '${{ matrix.container-suffix }}' '' {source} + sd -f ms 'container-suffix:.*include:' 'include:' {source} + + sd "container: ghcr.io/autowarefoundation/autoware-universe:(\w+)-latest.*" "container: ros:\$1" {source} + sd "build_depends.humble.repos" "build_depends.repos" {source} + - source: .github/workflows/build-and-test-self-hosted.yaml + pre-commands: | + sd -s '${{ matrix.container-suffix }}' '' {source} + sd -f ms 'container-suffix:.*include:' 'include:' {source} + + sd "container: ghcr.io/autowarefoundation/autoware-universe:(\w+)-latest.*" "container: ros:\$1" {source} + sd "build_depends.humble.repos" "build_depends.repos" {source} + - source: .github/workflows/check-build-depends.yaml + pre-commands: | + sd "container: ghcr.io/autowarefoundation/autoware-universe:(\w+)-latest.*" "container: ros:\$1" {source} + sd "build_depends.humble.repos" "build_depends.repos" {source} + - source: .github/workflows/clang-tidy-pr-comments.yaml + - source: .github/workflows/clang-tidy-pr-comments-manually.yaml + - source: .github/workflows/update-codeowners-from-packages.yaml + - source: .pre-commit-config.yaml + - source: codecov.yaml diff --git a/.github/sync-files.yaml b/.github/sync-files.yaml new file mode 100644 index 0000000..39bcd3f --- /dev/null +++ b/.github/sync-files.yaml @@ -0,0 +1,32 @@ +- repository: autowarefoundation/autoware + files: + - source: CODE_OF_CONDUCT.md + - source: CONTRIBUTING.md + - source: DISCLAIMER.md + - source: LICENSE + - source: .github/ISSUE_TEMPLATE/bug.yaml + - source: .github/ISSUE_TEMPLATE/config.yml + - source: .github/ISSUE_TEMPLATE/task.yaml + - source: .github/PULL_REQUEST_TEMPLATE.md + - source: .github/PULL_REQUEST_TEMPLATE/small-change.md + - source: .github/PULL_REQUEST_TEMPLATE/standard-change.md + - source: .github/dependabot.yaml + - source: .github/stale.yml + - source: .github/workflows/cancel-previous-workflows.yaml + - source: .github/workflows/github-release.yaml + - source: .github/workflows/pre-commit.yaml + - source: .github/workflows/pre-commit-autoupdate.yaml + - source: .github/workflows/pre-commit-optional.yaml + - source: .github/workflows/semantic-pull-request.yaml + - source: .github/workflows/spell-check-differential.yaml + - source: .github/workflows/sync-files.yaml + - source: .clang-format + - source: .clang-tidy + - source: .markdown-link-check.json + - source: .markdownlint.yaml + - source: .pre-commit-config-optional.yaml + - source: .prettierignore + - source: .prettierrc.yaml + - source: .yamllint.yaml + - source: CPPLINT.cfg + - source: setup.cfg diff --git a/.github/workflows/build-and-test-differential-self-hosted.yaml b/.github/workflows/build-and-test-differential-self-hosted.yaml new file mode 100644 index 0000000..b684019 --- /dev/null +++ b/.github/workflows/build-and-test-differential-self-hosted.yaml @@ -0,0 +1,58 @@ +name: build-and-test-differential-self-hosted + +on: + pull_request: + types: + - opened + - synchronize + - labeled + workflow_dispatch: + +jobs: + prevent-no-label-execution: + uses: autowarefoundation/autoware-github-actions/.github/workflows/prevent-no-label-execution.yaml@v1 + with: + label: ARM64 + + build-and-test-differential-self-hosted: + needs: prevent-no-label-execution + if: ${{ needs.prevent-no-label-execution.outputs.run == 'true' }} + runs-on: [self-hosted, linux, ARM64] + container: ${{ matrix.container }} + strategy: + fail-fast: false + matrix: + rosdistro: + - humble + include: + - rosdistro: humble + container: ros:humble + build-depends-repos: build_depends.repos + steps: + - name: Check out repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get modified packages + id: get-modified-packages + uses: autowarefoundation/autoware-github-actions/get-modified-packages@v1 + + - name: Build + if: ${{ steps.get-modified-packages.outputs.modified-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-modified-packages.outputs.modified-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Test + if: ${{ steps.get-modified-packages.outputs.modified-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-test@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-modified-packages.outputs.modified-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} diff --git a/.github/workflows/build-and-test-differential.yaml b/.github/workflows/build-and-test-differential.yaml new file mode 100644 index 0000000..ad9fc66 --- /dev/null +++ b/.github/workflows/build-and-test-differential.yaml @@ -0,0 +1,91 @@ +name: build-and-test-differential + +on: + pull_request: + +jobs: + build-and-test-differential: + runs-on: ubuntu-latest + container: ${{ matrix.container }} + strategy: + fail-fast: false + matrix: + rosdistro: + - humble + include: + - rosdistro: humble + container: ros:humble + build-depends-repos: build_depends.repos + steps: + - name: Check out repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get modified packages + id: get-modified-packages + uses: autowarefoundation/autoware-github-actions/get-modified-packages@v1 + + - name: Build + if: ${{ steps.get-modified-packages.outputs.modified-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-modified-packages.outputs.modified-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Test + id: test + if: ${{ steps.get-modified-packages.outputs.modified-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-test@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-modified-packages.outputs.modified-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Upload coverage to CodeCov + if: ${{ steps.test.outputs.coverage-report-files != '' }} + uses: codecov/codecov-action@v3 + with: + files: ${{ steps.test.outputs.coverage-report-files }} + fail_ci_if_error: false + verbose: true + flags: differential + + clang-tidy-differential: + runs-on: ubuntu-latest + container: ros:humble + needs: build-and-test-differential + steps: + - name: Check out repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get modified packages + id: get-modified-packages + uses: autowarefoundation/autoware-github-actions/get-modified-packages@v1 + + - name: Get modified files + id: get-modified-files + uses: tj-actions/changed-files@v42 + with: + files: | + **/*.cpp + **/*.hpp + + - name: Run clang-tidy + if: ${{ steps.get-modified-files.outputs.all_changed_files != '' }} + uses: autowarefoundation/autoware-github-actions/clang-tidy@v1 + with: + rosdistro: humble + target-packages: ${{ steps.get-modified-packages.outputs.modified-packages }} + target-files: ${{ steps.get-modified-files.outputs.all_changed_files }} + clang-tidy-config-url: https://raw.githubusercontent.com/autowarefoundation/autoware/main/.clang-tidy + build-depends-repos: build_depends.repos diff --git a/.github/workflows/build-and-test-self-hosted.yaml b/.github/workflows/build-and-test-self-hosted.yaml new file mode 100644 index 0000000..e1a4c0b --- /dev/null +++ b/.github/workflows/build-and-test-self-hosted.yaml @@ -0,0 +1,46 @@ +name: build-and-test-self-hosted + +on: + schedule: + - cron: 0 0 * * * + workflow_dispatch: + +jobs: + build-and-test-self-hosted: + runs-on: [self-hosted, linux, ARM64] + container: ${{ matrix.container }} + strategy: + fail-fast: false + matrix: + rosdistro: + - humble + include: + - rosdistro: humble + container: ros:humble + build-depends-repos: build_depends.repos + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get self packages + id: get-self-packages + uses: autowarefoundation/autoware-github-actions/get-self-packages@v1 + + - name: Build + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Test + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-test@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} diff --git a/.github/workflows/build-and-test-with-reverse-depends.yaml b/.github/workflows/build-and-test-with-reverse-depends.yaml new file mode 100644 index 0000000..fd54629 --- /dev/null +++ b/.github/workflows/build-and-test-with-reverse-depends.yaml @@ -0,0 +1,52 @@ +name: build-and-test-with-reverse-depends + +on: + workflow_dispatch: + +jobs: + build-and-test-with-reverse-depends: + runs-on: ubuntu-latest + container: ros:humble + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Set up yq + uses: chrisdickinson/setup-yq@v1.0.1 + with: + yq-version: v4.25.1 + + - name: Clone reverse depends + run: | + git clone https://github.com/autowarefoundation/autoware.universe.git reverse_depends + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get self packages + id: get-self-packages + uses: autowarefoundation/autoware-github-actions/get-self-packages@v1 + + - name: Import depends of reverse depends + run: | + yq -i 'del(.repositories.* | select(.url == "https://github.com/autowarefoundation/autoware_common.git"))' reverse_depends/build_depends.repos + yq -i 'del(.repositories.* | select(.url == "https://github.com/tier4/autoware_auto_msgs.git"))' reverse_depends/build_depends.repos + vcs import reverse_depends < reverse_depends/build_depends.repos + rm -rf reverse_depends/map/lanelet2_extension + + - name: Build + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: humble + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: build_depends.repos + + - name: Test + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + id: test + uses: autowarefoundation/autoware-github-actions/colcon-test@v1 + with: + rosdistro: humble + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: build_depends.repos diff --git a/.github/workflows/build-and-test.yaml b/.github/workflows/build-and-test.yaml new file mode 100644 index 0000000..c34102c --- /dev/null +++ b/.github/workflows/build-and-test.yaml @@ -0,0 +1,66 @@ +name: build-and-test + +on: + push: + schedule: + - cron: 0 0 * * * + workflow_dispatch: + +jobs: + build-and-test: + if: ${{ github.event_name != 'push' || github.ref_name == github.event.repository.default_branch }} + runs-on: ubuntu-latest + container: ${{ matrix.container }} + strategy: + fail-fast: false + matrix: + rosdistro: + - humble + include: + - rosdistro: humble + container: ros:humble + build-depends-repos: build_depends.repos + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Free disk space (Ubuntu) + uses: jlumbroso/free-disk-space@v1.3.1 + with: + tool-cache: false + dotnet: false + swap-storage: false + large-packages: false + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get self packages + id: get-self-packages + uses: autowarefoundation/autoware-github-actions/get-self-packages@v1 + + - name: Build + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Test + if: ${{ steps.get-self-packages.outputs.self-packages != '' }} + id: test + uses: autowarefoundation/autoware-github-actions/colcon-test@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} + + - name: Upload coverage to CodeCov + if: ${{ steps.test.outputs.coverage-report-files != '' }} + uses: codecov/codecov-action@v3 + with: + files: ${{ steps.test.outputs.coverage-report-files }} + fail_ci_if_error: false + verbose: true + flags: total diff --git a/.github/workflows/cancel-previous-workflows.yaml b/.github/workflows/cancel-previous-workflows.yaml new file mode 100644 index 0000000..1da4d24 --- /dev/null +++ b/.github/workflows/cancel-previous-workflows.yaml @@ -0,0 +1,14 @@ +name: cancel-previous-workflows + +on: + pull_request_target: + +jobs: + cancel-previous-workflows: + runs-on: ubuntu-latest + steps: + - name: Cancel previous runs + uses: styfle/cancel-workflow-action@0.12.0 + with: + workflow_id: all + all_but_latest: true diff --git a/.github/workflows/check-build-depends.yaml b/.github/workflows/check-build-depends.yaml new file mode 100644 index 0000000..81618a1 --- /dev/null +++ b/.github/workflows/check-build-depends.yaml @@ -0,0 +1,37 @@ +name: check-build-depends + +on: + pull_request: + paths: + - build_depends*.repos + +jobs: + check-build-depends: + runs-on: ubuntu-latest + container: ${{ matrix.container }} + strategy: + fail-fast: false + matrix: + rosdistro: + - humble + include: + - rosdistro: humble + container: ros:humble + build-depends-repos: build_depends.repos + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Remove exec_depend + uses: autowarefoundation/autoware-github-actions/remove-exec-depend@v1 + + - name: Get self packages + id: get-self-packages + uses: autowarefoundation/autoware-github-actions/get-self-packages@v1 + + - name: Build + uses: autowarefoundation/autoware-github-actions/colcon-build@v1 + with: + rosdistro: ${{ matrix.rosdistro }} + target-packages: ${{ steps.get-self-packages.outputs.self-packages }} + build-depends-repos: ${{ matrix.build-depends-repos }} diff --git a/.github/workflows/clang-tidy-pr-comments-manually.yaml b/.github/workflows/clang-tidy-pr-comments-manually.yaml new file mode 100644 index 0000000..9bccd97 --- /dev/null +++ b/.github/workflows/clang-tidy-pr-comments-manually.yaml @@ -0,0 +1,62 @@ +name: clang-tidy-pr-comments-manually + +on: + workflow_dispatch: + inputs: + workflow_run_id_or_url: + description: The target workflow run ID or URL of the build-and-test-differential workflow + required: true +jobs: + clang-tidy-pr-comments-manually: + runs-on: ubuntu-latest + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Download analysis results + run: | + workflow_run_id=$(echo "${{ inputs.workflow_run_id_or_url }}" | sed -e "s|.*runs/||" -e "s|/jobs.*||") + gh run download "$workflow_run_id" -D /tmp || true + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: Check if the fixes.yaml file exists + id: check-fixes-yaml-existence + uses: autowarefoundation/autoware-github-actions/check-file-existence@v1 + with: + files: /tmp/clang-tidy-result/fixes.yaml + + - name: Set variables + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + id: set-variables + run: | + echo "pr-id=$(cat /tmp/clang-tidy-result/pr-id.txt)" >> $GITHUB_OUTPUT + echo "pr-head-repo=$(cat /tmp/clang-tidy-result/pr-head-repo.txt)" >> $GITHUB_OUTPUT + echo "pr-head-ref=$(cat /tmp/clang-tidy-result/pr-head-ref.txt)" >> $GITHUB_OUTPUT + + - name: Check out PR head + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + uses: actions/checkout@v3 + with: + repository: ${{ steps.set-variables.outputs.pr-head-repo }} + ref: ${{ steps.set-variables.outputs.pr-head-ref }} + persist-credentials: false + + - name: Replace paths in fixes.yaml + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + run: | + sed -i -e "s|/__w/|/home/runner/work/|g" /tmp/clang-tidy-result/fixes.yaml + cat /tmp/clang-tidy-result/fixes.yaml + + - name: Copy fixes.yaml to access from Docker Container Action + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + run: | + cp /tmp/clang-tidy-result/fixes.yaml fixes.yaml + + - name: Run clang-tidy-pr-comments action + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + uses: platisd/clang-tidy-pr-comments@v1 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + clang_tidy_fixes: fixes.yaml + pull_request_id: ${{ steps.set-variables.outputs.pr-id }} diff --git a/.github/workflows/clang-tidy-pr-comments.yaml b/.github/workflows/clang-tidy-pr-comments.yaml new file mode 100644 index 0000000..baaa0fb --- /dev/null +++ b/.github/workflows/clang-tidy-pr-comments.yaml @@ -0,0 +1,63 @@ +name: clang-tidy-pr-comments + +on: + workflow_run: + workflows: + - build-and-test-differential + types: + - completed + +jobs: + clang-tidy-pr-comments: + if: ${{ github.event.workflow_run.event == 'pull_request' && contains(fromJson('["success", "failure"]'), github.event.workflow_run.conclusion) }} + runs-on: ubuntu-latest + steps: + - name: Check out repository + uses: actions/checkout@v3 + + - name: Download analysis results + run: | + gh run download ${{ github.event.workflow_run.id }} -D /tmp || true + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: Check if the fixes.yaml file exists + id: check-fixes-yaml-existence + uses: autowarefoundation/autoware-github-actions/check-file-existence@v1 + with: + files: /tmp/clang-tidy-result/fixes.yaml + + - name: Set variables + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + id: set-variables + run: | + echo "pr-id=$(cat /tmp/clang-tidy-result/pr-id.txt)" >> $GITHUB_OUTPUT + echo "pr-head-repo=$(cat /tmp/clang-tidy-result/pr-head-repo.txt)" >> $GITHUB_OUTPUT + echo "pr-head-ref=$(cat /tmp/clang-tidy-result/pr-head-ref.txt)" >> $GITHUB_OUTPUT + + - name: Check out PR head + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + uses: actions/checkout@v3 + with: + repository: ${{ steps.set-variables.outputs.pr-head-repo }} + ref: ${{ steps.set-variables.outputs.pr-head-ref }} + persist-credentials: false + + - name: Replace paths in fixes.yaml + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + run: | + sed -i -e "s|/__w/|/home/runner/work/|g" /tmp/clang-tidy-result/fixes.yaml + cat /tmp/clang-tidy-result/fixes.yaml + + - name: Copy fixes.yaml to access from Docker Container Action + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + run: | + cp /tmp/clang-tidy-result/fixes.yaml fixes.yaml + + - name: Run clang-tidy-pr-comments action + if: ${{ steps.check-fixes-yaml-existence.outputs.exists == 'true' }} + uses: platisd/clang-tidy-pr-comments@v1 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + clang_tidy_fixes: fixes.yaml + pull_request_id: ${{ steps.set-variables.outputs.pr-id }} diff --git a/.github/workflows/github-release.yaml b/.github/workflows/github-release.yaml new file mode 100644 index 0000000..b426d0c --- /dev/null +++ b/.github/workflows/github-release.yaml @@ -0,0 +1,78 @@ +name: github-release + +on: + push: + branches: + - beta/v* + tags: + - v* + workflow_dispatch: + inputs: + beta-branch-or-tag-name: + description: The name of the beta branch or tag to release + type: string + required: true + +jobs: + github-release: + runs-on: ubuntu-latest + steps: + - name: Set tag name + id: set-tag-name + run: | + if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then + REF_NAME="${{ github.event.inputs.beta-branch-or-tag-name }}" + else + REF_NAME="${{ github.ref_name }}" + fi + + echo "ref-name=$REF_NAME" >> $GITHUB_OUTPUT + echo "tag-name=${REF_NAME#beta/}" >> $GITHUB_OUTPUT + + - name: Check out repository + uses: actions/checkout@v4 + with: + fetch-depth: 0 + ref: ${{ steps.set-tag-name.outputs.ref-name }} + + - name: Set target name for beta branches + id: set-target-name + run: | + if [[ "${{ steps.set-tag-name.outputs.ref-name }}" =~ "beta/" ]]; then + echo "target-name=${{ steps.set-tag-name.outputs.ref-name }}" >> $GITHUB_OUTPUT + fi + + - name: Create a local tag for beta branches + run: | + if [ "${{ steps.set-target-name.outputs.target-name }}" != "" ]; then + git tag "${{ steps.set-tag-name.outputs.tag-name }}" + fi + + - name: Run generate-changelog + id: generate-changelog + uses: autowarefoundation/autoware-github-actions/generate-changelog@v1 + + - name: Select verb + id: select-verb + run: | + has_previous_draft=$(gh release view --json isDraft -q ".isDraft" "${{ steps.set-tag-name.outputs.tag-name }}") || true + + verb=create + if [ "$has_previous_draft" = "true" ]; then + verb=edit + fi + + echo "verb=$verb" >> $GITHUB_OUTPUT + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: Release to GitHub + run: | + gh release ${{ steps.select-verb.outputs.verb }} "${{ steps.set-tag-name.outputs.tag-name }}" \ + --draft \ + --target "${{ steps.set-target-name.outputs.target-name }}" \ + --title "Release ${{ steps.set-tag-name.outputs.tag-name }}" \ + --notes "$NOTES" + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + NOTES: ${{ steps.generate-changelog.outputs.changelog }} diff --git a/.github/workflows/pre-commit-autoupdate.yaml b/.github/workflows/pre-commit-autoupdate.yaml new file mode 100644 index 0000000..23b403f --- /dev/null +++ b/.github/workflows/pre-commit-autoupdate.yaml @@ -0,0 +1,37 @@ +name: pre-commit-autoupdate + +on: + schedule: + - cron: 0 0 * * * + workflow_dispatch: + +jobs: + check-secret: + uses: autowarefoundation/autoware-github-actions/.github/workflows/check-secret.yaml@v1 + secrets: + secret: ${{ secrets.APP_ID }} + + pre-commit-autoupdate: + needs: check-secret + if: ${{ needs.check-secret.outputs.set == 'true' }} + runs-on: ubuntu-latest + steps: + - name: Generate token + id: generate-token + uses: tibdex/github-app-token@v2 + with: + app_id: ${{ secrets.APP_ID }} + private_key: ${{ secrets.PRIVATE_KEY }} + + - name: Run pre-commit-autoupdate + uses: autowarefoundation/autoware-github-actions/pre-commit-autoupdate@v1 + with: + token: ${{ steps.generate-token.outputs.token }} + pre-commit-config: .pre-commit-config.yaml + pr-labels: | + tag:bot + tag:pre-commit-autoupdate + pr-branch: pre-commit-autoupdate + pr-title: "ci(pre-commit): autoupdate" + pr-commit-message: "ci(pre-commit): autoupdate" + auto-merge-method: squash diff --git a/.github/workflows/pre-commit-optional.yaml b/.github/workflows/pre-commit-optional.yaml new file mode 100644 index 0000000..3873819 --- /dev/null +++ b/.github/workflows/pre-commit-optional.yaml @@ -0,0 +1,19 @@ +name: pre-commit-optional + +on: + pull_request: + +jobs: + pre-commit-optional: + runs-on: ubuntu-latest + steps: + - name: Check out repository + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Run pre-commit + uses: autowarefoundation/autoware-github-actions/pre-commit@v1 + with: + pre-commit-config: .pre-commit-config-optional.yaml + base-branch: origin/${{ github.base_ref }} diff --git a/.github/workflows/pre-commit.yaml b/.github/workflows/pre-commit.yaml new file mode 100644 index 0000000..c724885 --- /dev/null +++ b/.github/workflows/pre-commit.yaml @@ -0,0 +1,27 @@ +name: pre-commit + +on: + pull_request: + +jobs: + pre-commit: + if: ${{ github.event.repository.private }} # Use pre-commit.ci for public repositories + runs-on: ubuntu-latest + steps: + - name: Generate token + id: generate-token + uses: tibdex/github-app-token@v2 + with: + app_id: ${{ secrets.APP_ID }} + private_key: ${{ secrets.PRIVATE_KEY }} + + - name: Check out repository + uses: actions/checkout@v4 + with: + ref: ${{ github.event.pull_request.head.ref }} + + - name: Run pre-commit + uses: autowarefoundation/autoware-github-actions/pre-commit@v1 + with: + pre-commit-config: .pre-commit-config.yaml + token: ${{ steps.generate-token.outputs.token }} diff --git a/.github/workflows/semantic-pull-request.yaml b/.github/workflows/semantic-pull-request.yaml new file mode 100644 index 0000000..71224c2 --- /dev/null +++ b/.github/workflows/semantic-pull-request.yaml @@ -0,0 +1,12 @@ +name: semantic-pull-request + +on: + pull_request_target: + types: + - opened + - edited + - synchronize + +jobs: + semantic-pull-request: + uses: autowarefoundation/autoware-github-actions/.github/workflows/semantic-pull-request.yaml@v1 diff --git a/.github/workflows/spell-check-differential.yaml b/.github/workflows/spell-check-differential.yaml new file mode 100644 index 0000000..1fbf2ff --- /dev/null +++ b/.github/workflows/spell-check-differential.yaml @@ -0,0 +1,16 @@ +name: spell-check-differential + +on: + pull_request: + +jobs: + spell-check-differential: + runs-on: ubuntu-latest + steps: + - name: Check out repository + uses: actions/checkout@v4 + + - name: Run spell-check + uses: autowarefoundation/autoware-github-actions/spell-check@v1 + with: + cspell-json-url: https://raw.githubusercontent.com/tier4/autoware-spell-check-dict/main/.cspell.json diff --git a/.github/workflows/sync-files-reverse-reference.yaml b/.github/workflows/sync-files-reverse-reference.yaml new file mode 100644 index 0000000..8219686 --- /dev/null +++ b/.github/workflows/sync-files-reverse-reference.yaml @@ -0,0 +1,24 @@ +name: sync-files-reverse-reference + +on: + workflow_dispatch: + +jobs: + sync-files-reverse-reference: + runs-on: ubuntu-latest + steps: + - name: Generate token + id: generate-token + uses: tibdex/github-app-token@v2 + with: + app_id: ${{ secrets.APP_ID }} + private_key: ${{ secrets.PRIVATE_KEY }} + + - name: Run sync-files + uses: autowarefoundation/autoware-github-actions/sync-files@v1 + with: + token: ${{ steps.generate-token.outputs.token }} + config: .github/sync-files-reverse-reference.yaml + pr-branch: sync-files-reverse-reference + pr-title: "chore: sync files of reverse references" + pr-commit-message: "chore: sync files of reverse references" diff --git a/.github/workflows/sync-files.yaml b/.github/workflows/sync-files.yaml new file mode 100644 index 0000000..51e523b --- /dev/null +++ b/.github/workflows/sync-files.yaml @@ -0,0 +1,33 @@ +name: sync-files + +on: + schedule: + - cron: 0 0 * * * + workflow_dispatch: + +jobs: + check-secret: + uses: autowarefoundation/autoware-github-actions/.github/workflows/check-secret.yaml@v1 + secrets: + secret: ${{ secrets.APP_ID }} + + sync-files: + needs: check-secret + if: ${{ needs.check-secret.outputs.set == 'true' }} + runs-on: ubuntu-latest + steps: + - name: Generate token + id: generate-token + uses: tibdex/github-app-token@v2 + with: + app_id: ${{ secrets.APP_ID }} + private_key: ${{ secrets.PRIVATE_KEY }} + + - name: Run sync-files + uses: autowarefoundation/autoware-github-actions/sync-files@v1 + with: + token: ${{ steps.generate-token.outputs.token }} + pr-labels: | + tag:bot + tag:sync-files + auto-merge-method: squash diff --git a/.github/workflows/update-codeowners-from-packages.yaml b/.github/workflows/update-codeowners-from-packages.yaml new file mode 100644 index 0000000..8b3d240 --- /dev/null +++ b/.github/workflows/update-codeowners-from-packages.yaml @@ -0,0 +1,33 @@ +name: update-codeowners-from-packages + +on: + schedule: + - cron: 0 0 * * * + workflow_dispatch: + +jobs: + check-secret: + uses: autowarefoundation/autoware-github-actions/.github/workflows/check-secret.yaml@v1 + secrets: + secret: ${{ secrets.APP_ID }} + + update-codeowners-from-packages: + needs: check-secret + if: ${{ needs.check-secret.outputs.set == 'true' }} + runs-on: ubuntu-latest + steps: + - name: Generate token + id: generate-token + uses: tibdex/github-app-token@v2 + with: + app_id: ${{ secrets.APP_ID }} + private_key: ${{ secrets.PRIVATE_KEY }} + + - name: Run update-codeowners-from-packages + uses: autowarefoundation/autoware-github-actions/update-codeowners-from-packages@v1 + with: + token: ${{ steps.generate-token.outputs.token }} + pr-labels: | + tag:bot + tag:update-codeowners-from-packages + auto-merge-method: squash diff --git a/.markdown-link-check.json b/.markdown-link-check.json new file mode 100644 index 0000000..c71a3e4 --- /dev/null +++ b/.markdown-link-check.json @@ -0,0 +1,16 @@ +{ + "aliveStatusCodes": [200, 206, 403], + "ignorePatterns": [ + { + "pattern": "^http://localhost" + }, + { + "pattern": "^http://127\\.0\\.0\\.1" + }, + { + "pattern": "^https://github.com/.*/discussions/new" + } + ], + "retryOn429": true, + "retryCount": 10 +} diff --git a/.markdownlint.yaml b/.markdownlint.yaml new file mode 100644 index 0000000..babaaa1 --- /dev/null +++ b/.markdownlint.yaml @@ -0,0 +1,11 @@ +# See https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md for all rules. +default: true +MD013: false +MD024: + siblings_only: true +MD029: + style: ordered +MD033: false +MD041: false +MD046: false +MD049: false diff --git a/.pre-commit-config-optional.yaml b/.pre-commit-config-optional.yaml new file mode 100644 index 0000000..3b43f9a --- /dev/null +++ b/.pre-commit-config-optional.yaml @@ -0,0 +1,6 @@ +repos: + - repo: https://github.com/tcort/markdown-link-check + rev: v3.11.2 + hooks: + - id: markdown-link-check + args: [--quiet, --config=.markdown-link-check.json] diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..a5ca7b6 --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,95 @@ +ci: + autofix_commit_msg: "style(pre-commit): autofix" + +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v4.4.0 + hooks: + - id: check-json + - id: check-merge-conflict + - id: check-toml + - id: check-xml + - id: check-yaml + args: [--unsafe] + - id: detect-private-key + - id: end-of-file-fixer + - id: mixed-line-ending + - id: trailing-whitespace + args: [--markdown-linebreak-ext=md] + + - repo: https://github.com/igorshubovych/markdownlint-cli + rev: v0.33.0 + hooks: + - id: markdownlint + args: [-c, .markdownlint.yaml, --fix] + + - repo: https://github.com/pre-commit/mirrors-prettier + rev: v3.0.0-alpha.6 + hooks: + - id: prettier + + - repo: https://github.com/adrienverge/yamllint + rev: v1.30.0 + hooks: + - id: yamllint + + - repo: https://github.com/tier4/pre-commit-hooks-ros + rev: v0.8.0 + hooks: + - id: flake8-ros + - id: prettier-xacro + - id: prettier-launch-xml + - id: prettier-package-xml + - id: ros-include-guard + - id: sort-package-xml + + - repo: https://github.com/shellcheck-py/shellcheck-py + rev: v0.9.0.2 + hooks: + - id: shellcheck + + - repo: https://github.com/scop/pre-commit-shfmt + rev: v3.6.0-2 + hooks: + - id: shfmt + args: [-w, -s, -i=4] + + - repo: https://github.com/pycqa/isort + rev: 5.12.0 + hooks: + - id: isort + + - repo: https://github.com/psf/black + rev: 23.3.0 + hooks: + - id: black + args: [--line-length=100] + + - repo: https://github.com/pre-commit/mirrors-clang-format + rev: v16.0.0 + hooks: + - id: clang-format + types_or: [c++, c, cuda] + + - repo: https://github.com/cpplint/cpplint + rev: 1.6.1 + hooks: + - id: cpplint + args: [--quiet] + exclude: .cu + + - repo: https://github.com/python-jsonschema/check-jsonschema + rev: 0.23.2 + hooks: + - id: check-metaschema + files: ^.+/schema/.*schema\.json$ + + - repo: local + hooks: + - id: prettier-svg + name: prettier svg + description: Apply Prettier with plugin-xml to svg. + entry: prettier --write --list-different --ignore-unknown --print-width 200 --xml-self-closing-space false --xml-whitespace-sensitivity ignore + language: node + files: .svg$ + additional_dependencies: [prettier@2.7.1, "@prettier/plugin-xml@2.2.0"] diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 0000000..a3c34d0 --- /dev/null +++ b/.prettierignore @@ -0,0 +1,2 @@ +*.param.yaml +*.rviz diff --git a/.prettierrc.yaml b/.prettierrc.yaml new file mode 100644 index 0000000..e29bf32 --- /dev/null +++ b/.prettierrc.yaml @@ -0,0 +1,20 @@ +printWidth: 100 +tabWidth: 2 +overrides: + - files: package.xml + options: + printWidth: 1000 + xmlSelfClosingSpace: false + xmlWhitespaceSensitivity: ignore + + - files: "*.launch.xml" + options: + printWidth: 200 + xmlSelfClosingSpace: false + xmlWhitespaceSensitivity: ignore + + - files: "*.xacro" + options: + printWidth: 200 + xmlSelfClosingSpace: false + xmlWhitespaceSensitivity: ignore diff --git a/.yamllint.yaml b/.yamllint.yaml new file mode 100644 index 0000000..2c7bd08 --- /dev/null +++ b/.yamllint.yaml @@ -0,0 +1,22 @@ +extends: default + +ignore: | + *.param.yaml + +rules: + braces: + level: error + max-spaces-inside: 1 # To format with Prettier + comments: + level: error + min-spaces-from-content: 1 # To be compatible with C++ and Python + document-start: + level: error + present: false # Don't need document start markers + line-length: disable # Delegate to Prettier + truthy: + level: error + check-keys: false # To allow 'on' of GitHub Actions + quoted-strings: + level: error + required: only-when-needed # To keep consistent style diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..8dbcfb8 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,132 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, caste, color, religion, or sexual +identity and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +- Demonstrating empathy and kindness toward other people +- Being respectful of differing opinions, viewpoints, and experiences +- Giving and gracefully accepting constructive feedback +- Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +- Focusing on what is best not just for us as individuals, but for the overall + community + +Examples of unacceptable behavior include: + +- The use of sexualized language or imagery, and sexual attention or advances of + any kind +- Trolling, insulting or derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or email address, + without their explicit permission +- Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official e-mail address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders responsible for enforcement at +. +All complaints will be reviewed and investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Enforcement Guidelines + +Community leaders will follow these Community Impact Guidelines in determining +the consequences for any action they deem in violation of this Code of Conduct: + +### 1. Correction + +**Community Impact**: Use of inappropriate language or other behavior deemed +unprofessional or unwelcome in the community. + +**Consequence**: A private, written warning from community leaders, providing +clarity around the nature of the violation and an explanation of why the +behavior was inappropriate. A public apology may be requested. + +### 2. Warning + +**Community Impact**: A violation through a single incident or series of +actions. + +**Consequence**: A warning with consequences for continued behavior. No +interaction with the people involved, including unsolicited interaction with +those enforcing the Code of Conduct, for a specified period of time. This +includes avoiding interactions in community spaces as well as external channels +like social media. Violating these terms may lead to a temporary or permanent +ban. + +### 3. Temporary Ban + +**Community Impact**: A serious violation of community standards, including +sustained inappropriate behavior. + +**Consequence**: A temporary ban from any sort of interaction or public +communication with the community for a specified period of time. No public or +private interaction with the people involved, including unsolicited interaction +with those enforcing the Code of Conduct, is allowed during this period. +Violating these terms may lead to a permanent ban. + +### 4. Permanent Ban + +**Community Impact**: Demonstrating a pattern of violation of community +standards, including sustained inappropriate behavior, harassment of an +individual, or aggression toward or disparagement of classes of individuals. + +**Consequence**: A permanent ban from any sort of public interaction within the +community. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.1, available at +[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]. + +Community Impact Guidelines were inspired by +[Mozilla's code of conduct enforcement ladder][mozilla coc]. + +For answers to common questions about this code of conduct, see the FAQ at +[https://www.contributor-covenant.org/faq][faq]. Translations are available at +[https://www.contributor-covenant.org/translations][translations]. + +[homepage]: https://www.contributor-covenant.org +[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html +[mozilla coc]: https://github.com/mozilla/diversity +[faq]: https://www.contributor-covenant.org/faq +[translations]: https://www.contributor-covenant.org/translations diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..22c7ee2 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,3 @@ +# Contributing + +See . diff --git a/CPPLINT.cfg b/CPPLINT.cfg new file mode 100644 index 0000000..ba6bdf0 --- /dev/null +++ b/CPPLINT.cfg @@ -0,0 +1,14 @@ +# Modified from https://github.com/ament/ament_lint/blob/ebd524bb9973d5ec1dc48a670ce54f958a5a0243/ament_cpplint/ament_cpplint/main.py#L64-L120 +set noparent +linelength=100 +includeorder=standardcfirst +filter=-build/c++11 # we do allow C++11 +filter=-build/namespaces_literals # we allow using namespace for literals +filter=-runtime/references # we consider passing non-const references to be ok +filter=-whitespace/braces # we wrap open curly braces for namespaces, classes and functions +filter=-whitespace/indent # we don't indent keywords like public, protected and private with one space +filter=-whitespace/parens # we allow closing parenthesis to be on the next line +filter=-whitespace/semicolon # we allow the developer to decide about whitespace after a semicolon +filter=-build/header_guard # we automatically fix the names of header guards using pre-commit +filter=-build/include_order # we use the custom include order +filter=-build/include_subdir # we allow the style of "foo.hpp" diff --git a/DISCLAIMER.md b/DISCLAIMER.md new file mode 100644 index 0000000..1b5a9bb --- /dev/null +++ b/DISCLAIMER.md @@ -0,0 +1,46 @@ +DISCLAIMER + +“Autoware” will be provided by The Autoware Foundation under the Apache License 2.0. +This “DISCLAIMER” will be applied to all users of Autoware (a “User” or “Users”) with +the Apache License 2.0 and Users shall hereby approve and acknowledge all the contents +specified in this disclaimer below and will be deemed to consent to this +disclaimer without any objection upon utilizing or downloading Autoware. + +Disclaimer and Waiver of Warranties + +1. AUTOWARE FOUNDATION MAKES NO REPRESENTATION OR WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, WITH RESPECT TO PROVIDING AUTOWARE (the “Service”) + including but not limited to any representation or warranty (i) of fitness or + suitability for a particular purpose contemplated by the Users, (ii) of the + expected functions, commercial value, accuracy, or usefulness of the Service, + (iii) that the use by the Users of the Service complies with the laws and + regulations applicable to the Users or any internal rules established by + industrial organizations, (iv) that the Service will be free of interruption or + defects, (v) of the non-infringement of any third party's right and (vi) the + accuracy of the content of the Services and the software itself. + +2. The Autoware Foundation shall not be liable for any damage incurred by the + User that are attributable to the Autoware Foundation for any reasons + whatsoever. UNDER NO CIRCUMSTANCES SHALL THE AUTOWARE FOUNDATION BE LIABLE FOR + INCIDENTAL, INDIRECT, SPECIAL OR FUTURE DAMAGES OR LOSS OF PROFITS. + +3. A User shall be entirely responsible for the content posted by the User and + its use of any content of the Service or the Website. If the User is held + responsible in a civil action such as a claim for damages or even in a criminal + case, the Autoware Foundation and member companies, governments and academic & + non-profit organizations and their directors, officers, employees and agents + (collectively, the “Indemnified Parties”) shall be completely discharged from + any rights or assertions the User may have against the Indemnified Parties, or + from any legal action, litigation or similar procedures. + +Indemnity + +A User shall indemnify and hold the Indemnified Parties harmless from any of +their damages, losses, liabilities, costs or expenses (including attorneys' +fees or criminal compensation), or any claims or demands made against the +Indemnified Parties by any third party, due to or arising out of, or in +connection with utilizing Autoware (including the representations and +warranties), the violation of applicable Product Liability Law of each country +(including criminal case) or violation of any applicable laws by the Users, or +the content posted by the User or its use of any content of the Service or the +Website. diff --git a/build_depends.repos b/build_depends.repos new file mode 100644 index 0000000..6f78bec --- /dev/null +++ b/build_depends.repos @@ -0,0 +1,9 @@ +repositories: + tmp/autoware_auto_msgs: + type: git + url: https://github.com/tier4/autoware_auto_msgs.git + version: tier4/main + tmp/autoware_msgs: + type: git + url: https://github.com/autowarefoundation/autoware_msgs.git + version: main diff --git a/codecov.yaml b/codecov.yaml new file mode 100644 index 0000000..8ca2196 --- /dev/null +++ b/codecov.yaml @@ -0,0 +1,22 @@ +coverage: + status: + project: + default: + target: auto + patch: + default: + target: auto + +comment: + show_carryforward_flags: true + +flag_management: + default_rules: + carryforward: true + statuses: + - name_prefix: project- + type: project + target: auto + - name_prefix: patch- + type: patch + target: auto diff --git a/setup.cfg b/setup.cfg new file mode 100644 index 0000000..5214751 --- /dev/null +++ b/setup.cfg @@ -0,0 +1,15 @@ +[flake8] +# Modified from https://github.com/ament/ament_lint/blob/ebd524bb9973d5ec1dc48a670ce54f958a5a0243/ament_flake8/ament_flake8/configuration/ament_flake8.ini +extend-ignore = B902,C816,D100,D101,D102,D103,D104,D105,D106,D107,D203,D212,D404,I202,CNL100,E203,E501,Q000 +import-order-style = pep8 +max-line-length = 100 +show-source = true +statistics = true + +[isort] +profile=black +line_length=100 +force_sort_within_sections=true +force_single_line=true +reverse_relative=true +known_third_party=launch From 660490e4e1169f8a22513f26499297f8a87f125e Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:39:38 +0900 Subject: [PATCH 04/13] change repos dir Signed-off-by: Yutaka Kondo --- build_depends.repos | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/build_depends.repos b/build_depends.repos index 6f78bec..f9d2398 100644 --- a/build_depends.repos +++ b/build_depends.repos @@ -1,9 +1,9 @@ repositories: - tmp/autoware_auto_msgs: + autoware_auto_msgs: type: git url: https://github.com/tier4/autoware_auto_msgs.git version: tier4/main - tmp/autoware_msgs: + autoware_msgs: type: git url: https://github.com/autowarefoundation/autoware_msgs.git version: main From f4d8df8babf2b73b0ff0e864bbb88cc20002c4b3 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:47:00 +0900 Subject: [PATCH 05/13] fix CODEOWNER Signed-off-by: Yutaka Kondo --- .github/CODEOWNERS | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 19ac6b4..caecd8e 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1,7 +1,5 @@ ### Copied from .github/CODEOWNERS-manual ### ### Automatically generated from package.xml ### -autoware_cmake/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp -autoware_lint_common/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp -autoware_utils/** esteve.fernandez@tier4.jp ryohsuke.mitsudome@tier4.jp -tmp/lanelet2_extension/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp +lanelet2_extension/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp +lanelet2_extension_python/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp From c654e78caa1e6942eb1f3d3be7a81cb9717b2157 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Thu, 25 Apr 2024 22:50:40 +0900 Subject: [PATCH 06/13] append maintainer Signed-off-by: Yutaka Kondo --- .github/CODEOWNERS | 4 ++-- lanelet2_extension/package.xml | 3 ++- lanelet2_extension_python/package.xml | 3 ++- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index caecd8e..3be45ab 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1,5 +1,5 @@ ### Copied from .github/CODEOWNERS-manual ### ### Automatically generated from package.xml ### -lanelet2_extension/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp -lanelet2_extension_python/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp +lanelet2_extension/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp yutaka.kondo@tier4.jp +lanelet2_extension_python/** kosuke.takeuchi@tier4.jp mamoru.sobue@tier4.jp masahiro.sakamoto@tier4.jp ryohsuke.mitsudome@tier4.jp takayuki.murooka@tier4.jp yutaka.kondo@tier4.jp diff --git a/lanelet2_extension/package.xml b/lanelet2_extension/package.xml index 3a40dc9..2fe7bd9 100644 --- a/lanelet2_extension/package.xml +++ b/lanelet2_extension/package.xml @@ -2,13 +2,14 @@ lanelet2_extension - 0.1.0 + 0.1.1 The lanelet2_extension package contains libraries to handle Lanelet2 format data. mitsudome-r Masahiro Sakamoto Mamoru Sobue Takayuki Murooka Kosuke Takeuchi + Kosuke Takeuchi Apache License 2.0 ament_cmake_auto diff --git a/lanelet2_extension_python/package.xml b/lanelet2_extension_python/package.xml index d6444e4..9b01f9a 100644 --- a/lanelet2_extension_python/package.xml +++ b/lanelet2_extension_python/package.xml @@ -2,9 +2,10 @@ lanelet2_extension_python - 0.1.0 + 0.1.1 The lanelet2_extension_python package contains Python bindings for lanelet2_extension package Mamoru Sobue + Kosuke Takeuchi Apache License 2.0 ament_cmake_auto From 2cf10d44dc5885325a018b4eda3e351d8bf382c8 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Tue, 30 Apr 2024 15:10:33 +0900 Subject: [PATCH 07/13] fix readme Signed-off-by: Yutaka Kondo --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 85e360b..1720488 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ This package contains external library for Lanelet2 and is meant to ease the use ## Lanelet Format for Autoware -Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](./docs/lanelet2_format_extension.md). +Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](lanelet2_extension/docs/lanelet2_format_extension.md). ## Code API From 4d7248dcf789a20802fb9a4491e78ff8f9e3b243 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Tue, 30 Apr 2024 15:12:31 +0900 Subject: [PATCH 08/13] fix link Signed-off-by: Yutaka Kondo --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1720488..48b44a5 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ This package contains external library for Lanelet2 and is meant to ease the use ## Lanelet Format for Autoware -Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](lanelet2_extension/docs/lanelet2_format_extension.md). +Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](./lanelet2_extension/docs/lanelet2_format_extension.md). ## Code API From 7fdb243f58ee7b3ebc0527cb4a92e84e2c1e2cdc Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Tue, 30 Apr 2024 15:37:43 +0900 Subject: [PATCH 09/13] fix link Signed-off-by: Yutaka Kondo --- lanelet2_extension/docs/lanelet2_format_extension.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lanelet2_extension/docs/lanelet2_format_extension.md b/lanelet2_extension/docs/lanelet2_format_extension.md index 744fd12..7a98e72 100644 --- a/lanelet2_extension/docs/lanelet2_format_extension.md +++ b/lanelet2_extension/docs/lanelet2_format_extension.md @@ -5,7 +5,7 @@ About the basics of the default format, please refer to main [Lanelet2 repository](https://github.com/fzi-forschungszentrum-informatik/Lanelet2). (see [here](https://github.com/fzi-forschungszentrum-informatik/Lanelet2/blob/master/lanelet2_core/doc/LaneletPrimitives.md) about primitives) In addition to default Lanelet2 Format, users should add following mandatory/optional tags to their osm lanelet files as explained in reset of this document. -Users may use `autoware_lanelet2_validation` [node](../README.md#nodes) to check if their maps are valid. +Users may use `autoware_lanelet2_validation` [node](../../README.md#nodes) to check if their maps are valid. The following is the extra format added for Autoware: From bead9cd9d9c6e1aeced2ff4f6be365e85044c270 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Tue, 30 Apr 2024 18:06:59 +0900 Subject: [PATCH 10/13] revert readme Signed-off-by: Yutaka Kondo --- README.md => lanelet2_extension/README.md | 2 +- lanelet2_extension/docs/lanelet2_format_extension.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) rename README.md => lanelet2_extension/README.md (97%) diff --git a/README.md b/lanelet2_extension/README.md similarity index 97% rename from README.md rename to lanelet2_extension/README.md index 48b44a5..85e360b 100644 --- a/README.md +++ b/lanelet2_extension/README.md @@ -4,7 +4,7 @@ This package contains external library for Lanelet2 and is meant to ease the use ## Lanelet Format for Autoware -Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](./lanelet2_extension/docs/lanelet2_format_extension.md). +Autoware uses extended Lanelet2 Format for Autoware, which means you need to add some tags to default OSM file if you want to fully use Lanelet2 maps. For details about custom tags, please refer to this [document](./docs/lanelet2_format_extension.md). ## Code API diff --git a/lanelet2_extension/docs/lanelet2_format_extension.md b/lanelet2_extension/docs/lanelet2_format_extension.md index 7a98e72..744fd12 100644 --- a/lanelet2_extension/docs/lanelet2_format_extension.md +++ b/lanelet2_extension/docs/lanelet2_format_extension.md @@ -5,7 +5,7 @@ About the basics of the default format, please refer to main [Lanelet2 repository](https://github.com/fzi-forschungszentrum-informatik/Lanelet2). (see [here](https://github.com/fzi-forschungszentrum-informatik/Lanelet2/blob/master/lanelet2_core/doc/LaneletPrimitives.md) about primitives) In addition to default Lanelet2 Format, users should add following mandatory/optional tags to their osm lanelet files as explained in reset of this document. -Users may use `autoware_lanelet2_validation` [node](../../README.md#nodes) to check if their maps are valid. +Users may use `autoware_lanelet2_validation` [node](../README.md#nodes) to check if their maps are valid. The following is the extra format added for Autoware: From a09c434934069e014c8fe6f28bd6e764b1c1fb04 Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Wed, 1 May 2024 14:14:35 +0900 Subject: [PATCH 11/13] fix maintainer Signed-off-by: Yutaka Kondo --- lanelet2_extension/package.xml | 2 +- lanelet2_extension_python/package.xml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/lanelet2_extension/package.xml b/lanelet2_extension/package.xml index 2fe7bd9..ef99a6d 100644 --- a/lanelet2_extension/package.xml +++ b/lanelet2_extension/package.xml @@ -9,7 +9,7 @@ Mamoru Sobue Takayuki Murooka Kosuke Takeuchi - Kosuke Takeuchi + Yutaka Kondo Apache License 2.0 ament_cmake_auto diff --git a/lanelet2_extension_python/package.xml b/lanelet2_extension_python/package.xml index 9b01f9a..ba72996 100644 --- a/lanelet2_extension_python/package.xml +++ b/lanelet2_extension_python/package.xml @@ -5,7 +5,7 @@ 0.1.1 The lanelet2_extension_python package contains Python bindings for lanelet2_extension package Mamoru Sobue - Kosuke Takeuchi + Yutaka Kondo Apache License 2.0 ament_cmake_auto From e869c3ddb7dd36035caab88a7f06d9a3b479eb8a Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Wed, 1 May 2024 16:08:37 +0900 Subject: [PATCH 12/13] update build_depends Signed-off-by: Yutaka Kondo --- build_depends.repos | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/build_depends.repos b/build_depends.repos index f9d2398..89e4b62 100644 --- a/build_depends.repos +++ b/build_depends.repos @@ -3,7 +3,15 @@ repositories: type: git url: https://github.com/tier4/autoware_auto_msgs.git version: tier4/main + autoware_cmake: + type: git + url: https://github.com/autowarefoundation/autoware_cmake.git + version: main autoware_msgs: type: git url: https://github.com/autowarefoundation/autoware_msgs.git version: main + autoware_utils: + type: git + url: https://github.com/autowarefoundation/autoware_utils.git + version: main From 3af8cadf78f18a27cc73c5e0c7a1800763b6819b Mon Sep 17 00:00:00 2001 From: Yutaka Kondo Date: Wed, 1 May 2024 16:12:36 +0900 Subject: [PATCH 13/13] wip Signed-off-by: Yutaka Kondo --- build_depends.repos | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/build_depends.repos b/build_depends.repos index 89e4b62..fd28b09 100644 --- a/build_depends.repos +++ b/build_depends.repos @@ -5,13 +5,13 @@ repositories: version: tier4/main autoware_cmake: type: git - url: https://github.com/autowarefoundation/autoware_cmake.git - version: main + url: https://github.com/youtalk/autoware_cmake.git + version: import-from-autoware-common autoware_msgs: type: git url: https://github.com/autowarefoundation/autoware_msgs.git version: main autoware_utils: type: git - url: https://github.com/autowarefoundation/autoware_utils.git - version: main + url: https://github.com/youtalk/autoware_utils.git + version: import-from-autoware-common