RoadGeometry.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447
  1. #ifndef ROADGEOMETRY_H
  2. #define ROADGEOMETRY_H
  3. #include <vector>
  4. #include <string>
  5. //Prototypes
  6. class RoadGeometry;
  7. class GeometryLine;
  8. class GeometrySpiral;
  9. class GeometryArc;
  10. using std::vector;
  11. using std::string;
  12. /**
  13. * RoadGeometry class is responsible for storing the basic chordline geometry properties
  14. *
  15. */
  16. class RoadGeometry
  17. {
  18. protected:
  19. /**
  20. * Base record properties
  21. */
  22. double mS;
  23. double mX;
  24. double mY;
  25. double mHdg;
  26. double mLength;
  27. double mS2;
  28. short int mGeomType; //0-line, 2-arc, 1-spiral 3-poly3 4-parampoly3
  29. public:
  30. /**
  31. * Constructor that initializes the base properties of teh record
  32. */
  33. RoadGeometry(double s, double x, double y, double hdg, double length);
  34. /**
  35. * Clones and returns the new geometry record
  36. */
  37. virtual RoadGeometry* Clone() const;
  38. //-------------------------------------------------
  39. /**
  40. * Sets the type of the geometry
  41. * 0: Line, 1: Arc, 2: Spiral
  42. */
  43. void SetGeomType(short int geomType);
  44. /**
  45. * Setter for the base properties
  46. */
  47. void SetBase(double s, double x, double y, double hdg, double length, bool recalculate=true);
  48. void SetS(double s);
  49. void SetX(double x);
  50. void SetY(double y);
  51. void SetHdg(double hdg);
  52. void SetLength(double length);
  53. //-------------------------------------------------
  54. /**
  55. * Getter for the geometry type
  56. */
  57. short int GetGeomType();
  58. /**
  59. * Getter for the base properties
  60. */
  61. double GetS();
  62. double GetS2();
  63. double GetX();
  64. double GetY();
  65. double GetHdg();
  66. double GetLength();
  67. //-------------------------------------------------
  68. /**
  69. * Evaluation methods
  70. */
  71. virtual bool CheckInterval (double s_check);
  72. virtual void GetCoords(double s_check, double &retX, double &retY);
  73. virtual void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  74. protected:
  75. /**
  76. * Computes the required vars
  77. */
  78. virtual void ComputeVars();
  79. };
  80. //----------------------------------------------------------------------------------
  81. /**
  82. * GeometryLine inherits the RoadGeometry class but adds no additional properties
  83. *
  84. */
  85. class GeometryLine:public RoadGeometry
  86. {
  87. public:
  88. /**
  89. * Constructor that initializes the base properties of the record
  90. */
  91. GeometryLine (double s, double x, double y, double hdg, double length);
  92. /**
  93. * Clones and returns the new geometry record
  94. */
  95. RoadGeometry* Clone() const;
  96. //-------------------------------------------------
  97. /**
  98. * Setter for the base properties
  99. */
  100. void SetAll(double s, double x, double y, double hdg, double length);
  101. //-------------------------------------------------
  102. /**
  103. * Gets the coordinates at the sample S offset
  104. */
  105. void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  106. };
  107. //----------------------------------------------------------------------------------
  108. /**
  109. * GeometryArc inherits the RoadGeometry class and adds Curvature property
  110. *
  111. */
  112. class GeometryArc: public RoadGeometry
  113. {
  114. private:
  115. /**
  116. * Base record properties
  117. */
  118. double mCurvature;
  119. /**
  120. * Optimization related variables
  121. */
  122. double mCircleX;
  123. double mCircleY;
  124. /**
  125. * Computation variables
  126. */
  127. double mStartAngle;
  128. public:
  129. /**
  130. * Constructor that initializes the base properties of the record
  131. */
  132. GeometryArc (double s, double x, double y, double hdg, double length, double curvature);
  133. /**
  134. * Clones and returns the new geometry record
  135. */
  136. RoadGeometry* Clone() const;
  137. //-------------------------------------------------
  138. /**
  139. * Setter for the base properties
  140. */
  141. void SetAll(double s, double x, double y, double hdg, double length, double curvature);
  142. void SetCurvature(double curvature);
  143. //-------------------------------------------------
  144. /**
  145. * Getter for the base properties
  146. */
  147. double GetCurvature();
  148. //-------------------------------------------------
  149. /**
  150. * Gets the coordinates at the sample S offset
  151. */
  152. void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  153. protected:
  154. /**
  155. * Computes the required vars
  156. */
  157. virtual void ComputeVars();
  158. };
  159. //----------------------------------------------------------------------------------
  160. /**
  161. * GeometrySpiral inherits the RoadGeometry class and adds Curvature properties
  162. *
  163. */
  164. class GeometrySpiral: public RoadGeometry
  165. {
  166. private:
  167. /**
  168. * Base record properties
  169. */
  170. double mCurvatureStart;
  171. double mCurvatureEnd;
  172. /**
  173. * Computation variables
  174. */
  175. static const double sqrtPiO2;
  176. double mA;
  177. double mCurvature;
  178. double mDenormalizeFactor;
  179. double mEndX;
  180. double mEndY;
  181. bool mNormalDir;
  182. double differenceAngle;
  183. double mRotCos;
  184. double mRotSin;
  185. public:
  186. /**
  187. * Constructor that initializes the base properties of the record
  188. */
  189. GeometrySpiral (double s, double x, double y, double hdg, double length, double curvatureStart,double curvatureEnd);
  190. /**
  191. * Clones and returns the new geometry record
  192. */
  193. RoadGeometry* Clone() const;
  194. //-------------------------------------------------
  195. /**
  196. * Setter for the base properties
  197. */
  198. void SetAll(double s, double x, double y, double hdg, double length, double curvatureStart,double curvatureEnd);
  199. void SetCurvatureStart(double curvature);
  200. void SetCurvatureEnd(double curvature);
  201. //-------------------------------------------------
  202. /**
  203. * Getter for the base properties
  204. */
  205. double GetCurvatureStart();
  206. double GetCurvatureEnd();
  207. //-------------------------------------------------
  208. /**
  209. * Gets the coordinates at the sample S offset
  210. */
  211. void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  212. protected:
  213. /**
  214. * Computes the required vars
  215. */
  216. virtual void ComputeVars();
  217. };
  218. //----------------------------------------------------------------------------------
  219. /**
  220. * GeometryPoly3 inherits the RoadGeometry class and adds polynomial properties
  221. *
  222. */
  223. class GeometryPoly3: public RoadGeometry
  224. {
  225. private:
  226. /**
  227. * Base record properties
  228. */
  229. double mA;
  230. double mB;
  231. double mC;
  232. double mD;
  233. public:
  234. /**
  235. * Constructor that initializes the base properties of the record
  236. */
  237. GeometryPoly3 (double s, double x, double y, double hdg, double length, double a,double b,double c,double d );
  238. /**
  239. * Clones and returns the new geometry record
  240. */
  241. RoadGeometry* Clone() const;
  242. //-------------------------------------------------
  243. /**
  244. * Setter for the base properties
  245. */
  246. void SetAll(double s, double x, double y, double hdg, double length, double a,double b,double c,double d);
  247. double GetA();
  248. double GetB();
  249. double GetC();
  250. double GetD();
  251. void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  252. };
  253. //----------------------------------------------------------------------------------
  254. /**
  255. * GeometryPoly3 inherits the RoadGeometry class and adds polynomial properties, Added By Yuchuli,2019.11.1
  256. *
  257. */
  258. class GeometryParamPoly3: public RoadGeometry
  259. {
  260. private:
  261. /**
  262. * Base record properties
  263. */
  264. double muA;
  265. double muB;
  266. double muC;
  267. double muD;
  268. double mvA;
  269. double mvB;
  270. double mvC;
  271. double mvD;
  272. bool mbNormal = true;
  273. public:
  274. /**
  275. * Constructor that initializes the base properties of the record
  276. */
  277. GeometryParamPoly3 (double s, double x, double y, double hdg, double length, double ua,double ub,double uc,double ud,double va, double vb, double vc,double vd );
  278. /**
  279. * Clones and returns the new geometry record
  280. */
  281. RoadGeometry* Clone() const;
  282. //-------------------------------------------------
  283. /**
  284. * Setter for the base properties
  285. */
  286. void SetAll(double s, double x, double y, double hdg, double length, double a,double b,double c,double d,double va, double vb, double vc,double vd );
  287. double GetuA();
  288. double GetuB();
  289. double GetuC();
  290. double GetuD();
  291. double GetvA();
  292. double GetvB();
  293. double GetvC();
  294. double GetvD();
  295. void GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  296. };
  297. //----------------------------------------------------------------------------------
  298. /**
  299. * GeometryBlock is a class used to combine multiple geometry records into blocks.
  300. * The basic use for this is to combine spiral-arc-spiral sequence of records into
  301. * a signel "Turn" block for an easier way to define turns, keeping close to the
  302. * road building practice of curvature use for transitions between straight segments and arcs
  303. */
  304. class GeometryBlock
  305. {
  306. private:
  307. /**
  308. * Vector of geometry records that make up a block
  309. */
  310. vector<RoadGeometry*> mGeometryBlockElement;
  311. public:
  312. /**
  313. * Constructor
  314. */
  315. GeometryBlock();
  316. /**
  317. * Copy constructor
  318. */
  319. GeometryBlock(const GeometryBlock& geomBlock);
  320. /**
  321. * Assignment operator overload
  322. */
  323. const GeometryBlock& operator=(const GeometryBlock& otherGeomBlock);
  324. //-------------------------------------------------
  325. /**
  326. * Methods used to add geometry recors to the geometry record vector
  327. */
  328. void AddGeometryLine(double s, double x, double y, double hdg, double length);
  329. void AddGeometryArc(double s, double x, double y, double hdg, double length, double curvature);
  330. void AddGeometrySpiral(double s, double x, double y, double hdg, double length, double curvatureStart,double curvatureEnd);
  331. void AddGeometryPoly3(double s, double x, double y, double hdg, double length, double a,double b,double c,double d);
  332. void AddGeometryParamPoly3(double s, double x, double y, double hdg, double length, double ua,double ub,double uc,double ud,double va,double vb,double vc,double vd);
  333. //-------------------------------------------------
  334. /**
  335. * Getter for the geometry record at a given index position of the vector
  336. */
  337. RoadGeometry* GetGeometryAt(int index);
  338. /**
  339. * Getter for the overal block length (summ of geometry record lengths)
  340. */
  341. double GetBlockLength();
  342. /**
  343. * Checks if the block is a straight line block or a turn
  344. */
  345. bool CheckIfLine();
  346. //-------------------------------------------------
  347. /**
  348. * Recalculates the geometry blocks when one of the geometry records is modified
  349. * Makes sure that every geometry records starts where the previous record ends
  350. */
  351. void Recalculate(double s, double x, double y, double hdg);
  352. //-------------------------------------------------
  353. /**
  354. * Evaluation methods
  355. */
  356. double GetLastS2();
  357. RoadGeometry* GetLastGeometry();
  358. virtual short int GetLastCoords(double &s, double &retX, double &retY, double &retHDG);
  359. bool CheckInterval(double s_check);
  360. virtual short int GetCoords(double s_check, double &retX, double &retY);
  361. virtual short int GetCoords(double s_check, double &retX, double &retY, double &retHDG);
  362. //-------------------------------------------------
  363. /**
  364. * Destructor
  365. */
  366. ~GeometryBlock();
  367. };
  368. #endif