#ifndef OSRM_EXTRACTOR_GUIDANCE_INTERSECTION_HPP_ #define OSRM_EXTRACTOR_GUIDANCE_INTERSECTION_HPP_ #include #include #include #include "extractor/guidance/turn_instruction.hpp" #include "util/bearing.hpp" #include "util/guidance/toolkit.hpp" #include "util/node_based_graph.hpp" #include "util/typedefs.hpp" // EdgeID namespace osrm { namespace extractor { namespace guidance { // the shape of an intersection only knows about edge IDs and bearings struct IntersectionShapeData { EdgeID eid; double bearing; double segment_length; }; inline auto makeCompareShapeDataByBearing(const double base_bearing) { return [base_bearing](const auto &lhs, const auto &rhs) { return util::bearing::angleBetweenBearings(base_bearing, lhs.bearing) < util::bearing::angleBetweenBearings(base_bearing, rhs.bearing); }; } inline auto makeCompareAngularDeviation(const double angle) { return [angle](const auto &lhs, const auto &rhs) { return util::guidance::angularDeviation(lhs.angle, angle) < util::guidance::angularDeviation(rhs.angle, angle); }; } // When viewing an intersection from an incoming edge, we can transform a shape into a view which // gives additional information on angles and whether a turn is allowed struct IntersectionViewData : IntersectionShapeData { IntersectionViewData(const IntersectionShapeData &shape, const bool entry_allowed, const double angle) : IntersectionShapeData(shape), entry_allowed(entry_allowed), angle(angle) { } bool entry_allowed; double angle; bool CompareByAngle(const IntersectionViewData &other) const; }; // A Connected Road is the internal representation of a potential turn. Internally, we require // full list of all connected roads to determine the outcome. // The reasoning behind is that even invalid turns can influence the perceived angles, or even // instructions themselves. An pososible example can be described like this: // // aaa(2)aa // a - bbbbb // aaa(1)aa // // will not be perceived as a turn from (1) -> b, and as a U-turn from (1) -> (2). // In addition, they can influence whether a turn is obvious or not. b->(2) would also be no // turn-operation, // but rather a name change. // // If this were a normal intersection with // // cccccccc // o bbbbb // aaaaaaaa // // We would perceive a->c as a sharp turn, a->b as a slight turn, and b->c as a slight turn. struct ConnectedRoad final : IntersectionViewData { ConnectedRoad(const IntersectionViewData &view, const TurnInstruction instruction, const LaneDataID lane_data_id) : IntersectionViewData(view), instruction(instruction), lane_data_id(lane_data_id) { } TurnInstruction instruction; LaneDataID lane_data_id; // used to sort the set of connected roads (we require sorting throughout turn handling) bool compareByAngle(const ConnectedRoad &other) const; // make a left turn into an equivalent right turn and vice versa void mirror(); OSRM_ATTR_WARN_UNUSED ConnectedRoad getMirroredCopy() const; }; // small helper function to print the content of a connected road std::string toString(const ConnectedRoad &road); using IntersectionShape = std::vector; // Common operations shared among IntersectionView and Intersections. // Inherit to enable those operations on your compatible type. CRTP pattern. template struct EnableIntersectionOps { // Find the turn whose angle offers the least angular deviation to the specified angle // For turn angles [0, 90, 260] and a query of 180 we return the 260 degree turn. auto findClosestTurn(double angle) const { auto comp = makeCompareAngularDeviation(angle); return std::min_element(self()->begin(), self()->end(), comp); } private: auto self() { return static_cast(this); } auto self() const { return static_cast(this); } }; struct IntersectionView final : std::vector, // EnableIntersectionOps // { using Base = std::vector; bool valid() const { return std::is_sorted(begin(), end(), std::mem_fn(&IntersectionViewData::CompareByAngle)); }; }; struct Intersection final : std::vector, // EnableIntersectionOps // { using Base = std::vector; /* * Check validity of the intersection object. We assume a few basic properties every set of * connected roads should follow throughout guidance pre-processing. This utility function * allows checking intersections for validity */ bool valid() const; // given all possible turns, which is the highest connected number of lanes per turn. This value // is used, for example, during generation of intersections. std::uint8_t getHighestConnectedLaneCount(const util::NodeBasedDynamicGraph &) const; }; } // namespace guidance } // namespace extractor } // namespace osrm #endif /*OSRM_EXTRACTOR_GUIDANCE_INTERSECTION_HPP_*/