From 29e8e14cc142451c078ff0fc4549ccb88763469d Mon Sep 17 00:00:00 2001 From: "sergi.e" <59253112+sergi-e@users.noreply.github.com> Date: Fri, 3 Apr 2020 13:57:11 +0200 Subject: [PATCH] Sergi e/rss docs (#2686) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * RSS first add * RSS docs first draft.· * Second draft. * Codacy fixes * Readme update --- Docs/adv_rss.md | 128 ++++++++++ .../rss_carla_integration_architecture.png | Bin 0 -> 246765 bytes Docs/index.md | 2 + Docs/python_api.md | 182 +++++++++++-- Docs/ref_sensors.md | 239 ++++++++++++++---- PythonAPI/docs/sensor.yml | 151 +++++++++-- PythonAPI/docs/sensor_data.yml | 186 +++++++++++--- README.md | 2 +- mkdocs.yml | 1 + 9 files changed, 773 insertions(+), 118 deletions(-) create mode 100644 Docs/adv_rss.md create mode 100644 Docs/img/rss_carla_integration_architecture.png diff --git a/Docs/adv_rss.md b/Docs/adv_rss.md new file mode 100644 index 000000000..d14527c2c --- /dev/null +++ b/Docs/adv_rss.md @@ -0,0 +1,128 @@ +# RSS Sensor + +CARLA integrates the [C++ Library for Responsibility Sensitive Safety](https://github.com/intel/ad-rss-lib) in the client library. This feature allows users to investigate behaviours of RSS without having to implement anything. CARLA will take care of providing the input, and applying the output to the AD systems on the fly. + +* [__Overview__](#overview) +* [__Compilation__](#compilation) + * [Dependencies](#dependencies) + * [Build](#build) +* [__Current state__](#current-state) + * [RssSensor](#rsssensor) + * [RssRestrictor](#rssrestrictor) + +!!! Important + This feature is a work in progress. Right now, it is only available for the Linux build. + +--- +## Overview + +The RSS library implements a mathematical model for safety assurance. It receives sensor information, and provides restrictions to the controllers of a vehicle. To sum up, the RSS module uses the sensor data to define __situations__. A situation describes the state of the ego vehicle with an element of the environment. For each situation, safety checks are made, and a proper response is calculated. The overall response is the result of all of the combined. For specific information on the library, read the [documentation](https://intel.github.io/ad-rss-lib/), especially the [Background section](https://intel.github.io/ad-rss-lib/ad_rss/Overview/). + +This is implemented in CARLA using two elements. + +* __RssSensor__ is in charge of the situation analysis, and response generation using the *ad-rss-lib*. +* __RssRestrictor__ applies the response by restricting the commands of the vehicle. + +The following image sketches the integration of __RSS__ into the CARLA architecture. + +![Interate RSS into CARLA](img/rss_carla_integration_architecture.png) + +__1. The server.__ +     __-__ Sends a camera image to the client. (Only if the client needs visualization). +     __-__ Provides the RssSensor with world data. +     __-__ Sends a physics model of the vehicle to the RssRestrictor. (Only if the default values are overwritten). +__2. The client.__ +     __-__ Provides the *RssSensor* with some [parameters](https://intel.github.io/ad-rss-lib/ad_rss/Appendix-ParameterDiscussion/) to be considered. +     __-__ Sends to the *RssResrictor* an initial [carla.VehicleControl](python_api.md#carla.VehicleControl). +__3. The RssSensor.__ +     __-__ Uses the *ad-rss-lib* to extract situations, do safety checks, and generate a response. +     __-__ Sends the *RssRestrictor* a response containing the proper response and aceleration restrictions to be applied. +     __-__ Asks the server to do some debug drawings to visualize the results of the calculations. +__4. The RssRestrictor__ +     __-__ If the client asks for it, applies the response to the [carla.VehicleControl](python_api.md#carla.VehicleControl), and returns the resulting one. + +!!! Important + Debug drawings can delay the RSS response, so they should be disabled during automated RSS evaluations. Use [carla.RssVisualizationMode](python_api.md#carla.RssVisualizationMode) to change the visualization settings. + +[![RSS sensor in CARLA](img/rss_carla_integration.png)](https://www.youtube.com/watch?v=UxKPXPT2T8Q) +
Visualization of the RssSensor results.
+ +--- +## Compilation + +The RSS integration has to be built aside from the rest of CARLA. The __ad-rss-lib__ comes with an LGPL-2.1 open-source license that creates conflict. It has to be linked statically into *libCarla*. + +As a reminder, the feature is only available for the Linux build so far. + +### Dependencies + +There are additional prerequisites required for building RSS and its dependencies. Take a look at the [official documentation](https://intel.github.io/ad-rss-lib/BUILDING)) to know more about this. + +Dependencies provided by Ubunutu (>= 16.04). +```sh +sudo apt-get install libgtest-dev libpython-dev libpugixml-dev libproj-dev libtbb-dev +``` + +The dependencies are built using [colcon](https://colcon.readthedocs.io/en/released/user/installation.html), so it has to be installed. +```sh +pip3 install --user -U colcon-common-extensions +``` + +There are some additional dependencies for the Python bindings. +```sh +sudo apt-get install castxml +pip install --user pygccxml +pip install --user https://bitbucket.org/ompl/pyplusplus/get/1.8.1.zip +``` + +### Build + +Once this is done, the full set of dependencies and RSS components can be built. + +* Compile LibCarla to work with RSS. + +```sh +make LibCarla.client.rss +``` + +* Compile the PythonAPI to include the RSS feature. + +```sh +make PythonAPI.rss +``` + +* As an alternative, a package can be built directly. +```sh +make package.rss +``` + +--- +## Current state + +### RssSensor + +[__carla.RssSensor__](python_api.md#carla.RssSensor) supports [ad-rss-lib v3.0.0 feature set](https://intel.github.io/ad-rss-lib/RELEASE_NOTES_AND_DISCLAIMERS) completely, including intersections and [stay on road](https://intel.github.io/ad-rss-lib/ad_rss_map_integration/HandleRoadBoundaries/) support. + +So far, the server provides the sensor with ground truth data of the surroundings that includes the state of other vehicles and traffic lights. Future improvements of this feature will add to the equation pedestrians, and more information of the OpenDRIVE map among others. + +### RssRestrictor + +When the client calls for it, the [__carla.RssRestrictor__](python_api.md#carla.RssRestrictor) will modify the vehicle controller to best reach the desired accelerations or decelerations by a given response. + +Due to the stucture of [carla.VehicleControl](python_api.md#carla.VehicleControl) objects, the restrictions applied have certain limitations. These controllers include `throttle`, `brake` and `streering` values. However, due to car physics and the simple control options these might not be met. The restriction intervenes in lateral direction simply by counter steering towards the parallel lane direction. The brake will be activated if deceleration requested by RSS. This depends on vehicle mass and brake torques provided by the [carla.Vehicle](python_api.md#carla.Vehicle). + +!!! Note + In an automated vehicle controller it might be possible to adapt the planned trajectory to the restrictions. A fast control loop (>1KHz) can be used to ensure these are followed. + +--- + +That sets the basics regarding the RSS sensor in CARLA. Find out more about the specific attributes and parameters in the [sensor reference](ref_sensors.md#rss-sensor). + +Open CARLA and mess around for a while. If there are any doubts, feel free to post these in the forum. + +
+

+ +CARLA forum +

+
diff --git a/Docs/img/rss_carla_integration_architecture.png b/Docs/img/rss_carla_integration_architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..256d105b825f1acdc25001ee69f2ae0e06444a90 GIT binary patch literal 246765 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]wqZ%c(Zc<)$AazkmP6u=Pr1 zJ&s$i)yXXDsMd1wHR2)bY!qF3;<(!6F1V;rbsp(2I!Ss7*pvSp+4hui+E?97g(*M| zyV7nY&?-0Dup_i|;g=4+lqs1RLX0%XOH@XyXzamP4LNtmDeDhPm*UM-> z8(a>DW7m&=R;(1leBs?R>?hQ63XDN%WO z=Zd`1egs}ICE5XZ!+ZJPE_y=ojbT!bAw)ax!~nQ=uryEZGAPh~lUJ`M;o!=4?`;n->DM1ha2D+B;sgmx=LCH&Y?#!pqc@PtX-IcbF$A~Y>(+5kh?Vfu~3!sqV z>O^pc-KGm@4X#SizV96!*;nG$NiwdIJU6+o2zHu}&(Q0Ibpp z=8SxgVlOJr`!HWI^?s7)jVoY{O8rR!6SoTnernWeHvUn|MuKMx7JS%U+zL}_oHn{d zsS?~>mLqV++hG~kWeoY|ARsr}+W*aJ*F>GdhXAU?I^xtvrB$1IoooR=+fAKY<)mM# ze+mS87guLMrOEE+H`NAnNhg6#kF?=aC}}?t*g&q`PnX$aEFtnF4LcR1z~Q#6L2`Gf zd<1O@5U2C4Q3R^&wa)SDx9yh_^if)lVo zq^aaovU9hN7eTXjA7q;BM{L~{qaja7{p%L@h^Et(>=%VESlYq|?Cr?s0K}r|e%bDQ znPp8{%_?}GvgnEvicQo416}^$g797j?F_?e@retCMJ=fJv(_VaDJGmF#>W(Q>Z_Rr z{BB7r$!Xg3GEQc9@Yoa}@ogQgT_5;Z399~{Ex4p{+|08odKZT)#aw=Y0|Sc3nm)%2j;%$EScCJClCRwl?dT%PZywG~6-?we>PD*D>>@#p@8yj_v3L zr(u$Z1NJRu{OSDW+S>HmCPTs#^^;%f&g=z?dWnS6l$;M?8c@9emxM{h*)yfEa|^0N zCRoug9S?$}AM%jo=Zu%xBs1h|c@Dy{5DdP!cAp$qrP!`YPmL93t3_cyTlH(#NV$1+U2fSj=yD0uaP#T@G*Gu} z*ZYhzbMeCdKcLF0zBuoE2@sGdiOt0+&W%46Vl}-jx1M9&5(1+6LQ}nu{`Fxq=^rAN zW3J2f=X?cwodNg^md{@glAh0Y@xgsm)FRg-2vE+LZ$Bl>splNgIz2vqD<Mmc4q-MTt@(o&n0m)v2aVo+}d|+1Ic?ys=nM%i%+}Mr&^Z za&W-W7C5#6B%exRq=Am5=I8$#o|0EeZes3bl>HXQtRxtt)@r{AKsMmwp)uiTSZ7H} z&lGjkA67EWOK4vLvY+Mbe+{*N&SQ3j&(Yfl2wX-XO6avgUX9l8mX+rJ&plE9SGJ^} z-MCHQ+JN3OtnBHVl%3B{om6q-{jCgKOY1xTqWRzJ{_kj7P&kpD(7byPoo}S6hh;eZ_S-ecb*ufwm~`YWw21fXlpvpwye(+<)nS## zBpn`DhS}lY_bQy2QIXe|9j--7%{+HLQ!?(cZULTL*P zr;*bgI;8TVhU7{1+C_6fbS~0zl~zX*L#-(P5gMWaG=h$x^0%G`aFC@dXv#*N?X~yR zqB`>|{CJ#=_TRPm=PR}d@&W8HY&x4(&ncj_u*GTNs+a3!f_$_wHP`7k`Yj6V!uND{ z90g`BpN9%TKH^GpdgE6FL@ClLdp_(mQs)-D`YE2uA|%3?KB%4jQ?%ER<40Wq*~4r3 z9aHimPmP@%wrj(QOAb@=?g93y=i6QzCLR(K#DTJ&SHuyiH z&ATW)ItE&7sBCB#6iy5ktziqreatTKc2Oc(-9gjg0R@x7d}5=EDsdSpppo^x*OMVK zyaZd3_}4wp)h&V`iUKSGv=v8N1Bs^mTaP8Bl43G>Z>+rvC`v8)W}oa-GxK?W!&`d= z+j5;Sp&lH=qNuLVN$_0Rk&t_$f+>;mcW^;JY&Iom~Hysl%no=Nh0SkB0~Yl3wqu z!zV;mS^7<L8(@Fq#wh#o@SIM#kK5*?`>&5QEE{!wDEh z@2WyWq)`&tGAp;ff>-Qt=)i)B2>wsdcvl7QZhnvIzXk|8iTgFlWswi;_MoC8_8znu z?w0pdn>?}*NCZ_p?HF`B6(!-rSL(1@jG+=(u~-25QS^3h%@23RnMCJCW{MyDwrmA~u#GH#>&q=Mv!%7$NB`bAe|$aSyPnIt*=7OqoEdyj zAv7fGbbCL+`6LmzQIJka)4==wg0A1Lm~9bD+}A6)21|~Cx`YHjKb5nd%T5CJ!U@m! z<+{aNnDyk9sBPO4?s@Ud`P{b2;~lC+A+jzJkmt^`_vMhi0}hWwV_f}LPEkjbz9X*^ z)VR9CrZcgFH!1=BnLqVGJ8r{noXzy}WD@6po`@v@{Ia9=VTyh%zp0gE1#jt3QMwZA+-zAn;nYZofo{+_VI ze3pDVvXAb$BR-(Ky#~}IkF=bh^}Dw%ldv}cG5NkP_20gS?rlhV`t>96{u1v0K5FCc zLl`NGt}Qs~H4zEeAw^f+-SWcea9R$4q}X+ zlRGV==P;J+#YMRE1p|aUsoLwp>UI6UO+o)Y@~n4%Zh>kDyNTWu+{k0lTJu9Am@|Yy zofh3Mp^M^j^C@!1ZIo&P0=T)6Hg%NjY?JUWCA>q5?n5`ot!HQmd32Pc)s`{a^F!@O z$|?cm!Q-&A83)PoWI|^QAX*q%2G=ARx9X$15DW}Djgs7x3|J5Hwtae>fWU~|ko0}X zHq#~-*CZJ5-zRt)=pka8`V5Fydy>_P&(eoMwr=w|vdZFnzM(6-(XQp+9QB>V1^VVjcu2gFaWX?PEu}J@MOK6C(!P+p=uC z2MECO?GRAaX?d=91Moh8=mc^u9)y`exT4Mn_J*k=|N9&KX>CRV$-U%L`N$Q9958yX zWFMx_4)wv*FYR&X1)SXsV*{gBevdc2<6BQK{YA`XJ-SY_HR{YvC`JL}3yLg}XBRltP$B1tO3?BTNco%OjL z^WVcy>$w%%6D#4+aKVq`W*7*by@X4qGejgM!Q{tYk``Xli7h?B3SmMz5MzfNjgn1F zqh6@qUAG*9na?^%;Hu^qUrzlzj$>5_WB|;qy{}Z24D{3l2*OnQ9s>qWOOtt}3zOVz zzP0JP#>5BM50wFwlJ$~U*+}MyZ{K0KYS!6?>Eox(@;5BbiO zVMDe>8cN&mLRr@Nf5O0jcK|(}^ZEU4I{!3S!&6g1oA;@|+UDQ8^f{7nh03PbKJsff zW8ez$vm903s>+j3Hg=8&eN6lbEou6pR6PSW{n)RUjIJr?pEdl#bXzR)LaQDMw9aU| zOzH3HSFs(HYk#M*{1CfI{8g>i&?pxJ(;_5w=-Dol{Jdq{1h^!|jNJdO%Z5VMiKa_q z@Q~J1wOed#E-0-5UOmxDu&5j>Tar@&xT_{&YN_y!_73sm3qM`5ZJ#jx+qNk?Z6U52 zH~B>xk6B)&-4+w*lOh+B?;!sZ;ARQV8phS@(YM@xO}D@?o1xKV;F;B-E%vFp-0~+t zKn_ykpA?KkC0Ntl`Z)x7r<0|CLjCWt3Y2dIPhXrROGGv5MOv_f;^I(KbGdW&)tzme zNW(s7ZSa|X3YvSrLkcoZrX>yY&N^{0B@W$++`u2V8? zR6m`=ouxvaXE=L%XQ)lUMA@XE zZYR9+QneSK2I}Q!!u*=|&@H8GixRCbtz)(Te&P?Z+Ne^g)K)3Ad^uTHfR)JbTm-hl zT99qj*?4Ii)$#lRwmM5~nY>V+y@~eF-}TR)tUjF2YRvqh#3D)KK+hdFY~byv^~fjZ8F% z1P`X;Zr?I}xwdP!N%^i*!({W9LfPk?17hY6~vrT-8E>i`2F46#bk(Otjt7dG$7vmYqj=427 zapjj@HrEYn-|P_jbHClGm*9cAYO@w`HiI`%nW0p-C2rnpK{K)b-aFmDfI3@jb^hp| z=~7yHty&msYio~_VTp%s6RO;443z@he#<@oE4h@=2Iu{)aTmArv|FHoS8H-(3n$^p z{%1uyE!{X-$B>Kz`u3{{Kc#Y?c3>o5uXNEbpBMWbDAlxG)LqNp7_gzXsA1rRf4MWu zzB&_AOw3ptS~o2?%L&?yKwM=wdm&#OFVx)+dknvc6TrMTT<##Y#^hd^^_ET20`wkwDU7M)XFV2m|11{V}xm)>+vge5^n$PiT!&`S?>|I)9nd~ zXd0CRu+j#b(DYh6F?SIIJ}_V_3N-1AfQwDyc0?{NF3tr_A`1cAWzh#KjB3p)Gh9M8 zvzM_o7E@2i$;sbHNkv8w*k7G|xVXB?5Dz1?n*p0h)WM;WRy#fDtOO{rz;t4Ll9BYx zE%>EXw<{-Lc3|V+5Y_jV=CN>_n~pr%dTlLd-5`)>mB)yQ0iD}(W!aZZObTZbLsjY( z#-Bn%qjonh(TO=RabLfSy53(~3&5t7?e0QNpU_+S5dbWH_-Is%lTLZ_ba788gj&3A zSM9Scw^Ff-BuZZMS&KZ3F9U^boi%vdZzU^}Wrp^RUJt?Q_&Xryy@$PE%qCC8*n)g> zmw0ii=ET#BCpbsXlR;}=X_(3eLUvS#E%nUOTpD_`?4;pF4=|E{p zFF%(huO7XQ84Dp{Jv9X=J0fZRiiOAT1(%FZx5ggaAEXo6WolTRO+lB(Lz+w?JEzx8Z862_KG-fN)j^!u+mUK2o7=nVeT7CB+o?TZpYX-g z&BdkL5%n5+K2l*KHx)!pC7mspG=09mpi7^*ORruoN^d@#fyjTk8d=EyVMgHQ03M8x z1_Co9V;(Coqb*uxHfFQf3Oj`%1j~JTc+|&WQZ-VORXXYN>T;<)$Vkw_#p0A7Joe^z z5fM5mZ>~8S!3i)%+St60H%al0jKu!-?VAJL1EaIvL*50(+u#-Y(p%WIoXEo5=CPqv zHrxp(DSpPcPcu4v^ePD}QHz2K1-H{*XIa`QEMzlI_C5*XbVf0X?~YHIk+7t1JIBV&xK{b&hcQXH@+hlgK{Sf4+CzKUve z*sKVN#%bQ-ay@$4e7(n0cT-d||D)D+W%WuaTl%YGGBr$AR|2~wjR}U5E^9&T55)vn zkIN$?ZMjz9mtrI@1xq&oH(&VyyV_#vx!)Ynvf-wBo)HWtalM%NCA|QgK$fOVQls0> z!4&NS!?ZJ9B{eRe!tI!kns3q{M{Xh&$qHW!G^@-z>?s|VfGWUo81cd&<@>n$Z(8+smhxUJl&|F8lb;8!iQSeA}9T>`&E4kr8TH`eKuh8;1=Q$mOKAo zg=HjwM#u`SLa>^x1!A+s`Fcll|Dd40vq}b5p7`mRnVD@3kwN4f&+IkUk@#?~B9X3d z&BSS#iQ#k)Bn0n=_ZV?OD}CX93Nx;ZW_4kreEXm6I_)Z&QJ`iAc9jIxkX;FD!LG8z z;SV=Y9TG4D2eI2_rt>hT${tOTlT~wcz2&kz$Fwxhwv^`L%1JgBT^b9I40_k z?Ayr}Lx&J^_Gu)UdJ2oI*6Q=|7KLkgQT<)Hu{I%V!M6bCgY{R<)R+&Cg2TQ(nEcx0 ziKeDzU+FJms_)+y<0MV+h1)0svR;UXb|<(>?>66_X%c8DKCBeG$(h`PJy{@RkiMcW~k%4IcDhEbWKuLYb|1tI|I~6U(37G4XdoH595)V~=4p{3_ zbqvcI*W-0Nb`Heh?C#fk*#sl31!@?U8$h%c)5bYgBm4I4*S-%k%GoP*8!3@XrKDS_ z!p7WAfjhHx*aEjFk;-I^WPEPQF+b7_rHzD8(+TE)_tYywc8gq1IIhU}k46bomTE`- zX%jxe&dAxnFCKD1f26-{>y1hmdG0ndjw4@Jy8a?7>oyNrQ4p;}&@j>av{^?p*7~7O zL8pbHll}APiCjE-JkB|aiNfEjCU&qmnn=#)VYJWQ7pSm3}_X^B*x(7sPmnk7y$cWm2 zUv`7boPSo~Mn;A~a>g=Q%JHyWw??51uWuCV>9dC^qPPr5bVr&`1yCZ}1s?ceVq^P( z;Gz~2R_m^M-N792{fgjMXH_8er)-y*&c83^1*KqF0)}yvx6eC>O+7UtBrW28D1#}sun+3;@?W&FH$eZz^w;;# zKuE*#6>X}-+vjZ9v**w{fmi*8wKHEeJFpA0@?*1{{|gPB{$UI?#x6Yb@LKIa0yo zkzIS3sy?b>6Cp~k>c!=%!qRw5GLhU#q@82ms-^eKH`Au>6xCKxLU2ToSgqPd&E(T` zXXd`9+>K>!zNbRjnO>ABBeCw}z|ZBPa}x^SWXCA25NLd^`1TQvLOKTBfd2j6ZTTqt zKwwsVCywHlls*^>dI|IySuBJcR!N!Oo-o{AHy4HKO>R^NH=CIe6qO*b3or2 z%GnRs9);RsPQ>#ulcln=#!>q@#H9{eKIHhlnA&-}IpjAJ9-9W?M5ElAxsiz6>l0yS zBo6gKx*dsg9oN-v51SoRJ0rd9iS;5i)FQWl=SO*jRK0u71rjh+s&b#^g4}HGr*%N-`irAgXzPsm+J5uRreS`_S9|piC-_9a8&u% z4@?!nf<*K2@l|Xo5lQ)0ER}utsZ-8VoSKH(W)Ljc+D`Q)410}OnB-f_bah{F{$l!W zGxbe<0X!?J5)LDJ+bs7ah6QM{I z;rlIEzA;FviBr`7T~Xs+#S7|rydP6j>M{1+Xvm5U4!=J>*!BdbDIdoPOXsWenhX+i z5hYkXF#*mJ9J4GbMuiXV7*0UJFJWWD2rL5~rN%bFQo33YGwRmb2<>5yxnvVGm6etK z0&~sja;f|nY-J}3C~p)Z)?05}+Ji8SAHPFCcE&oS_^8SQa0oBVuF z(NWIZ9WURy6t_IuADCEdSbKHT{%wiO76}&1x#DCfsA*+CJ;Ehqn1{ciX?ZVQLR!4} z`n2L__s#EXpDSw_F^t0-_uvh=vrj{!@)q1TnInsM(a%qjn*y#fGY*AjzMAqIC8}j> zPl(W#@PQ6#HCfm@7N?MA#YH+D4C_O+n2aJx29(oEK@1iL)jE};L|?BN=ELd%t!^`z zqog&T%QjZ@I3m=pz5%3_A^N66^H{HoB6IJXdCO;arG)+hg+YsQiRl-8R`_?-MD)bu zbk-cqa`*IR)0*qL5yJw6;O%{(`i<3Y6y z4{T%FeG!mzwY&b5QR(6exDWO+KRNL@A?CCZ46MOnB(j=_3jz}Fo{%i5*j_KH?g^2h zkS)rQ;~awitAsISJ3kPy?XxyA8BT?aq&C+-107DU)9i;pj#H^?;2yAH5kWyg(PQYc zHA?-L@t&()x5D$xZE!LOf;#z()5p?`HaXc5##yk928?P{OctA{A2+9SERlH;`F?fA zs%66!(i|yAt!z!(bhz-J@5GR;ICMG|`q8G|Jm!GeToxag;K$zXe(ZRHX}RWhm1>Ny z_jx!*irmHv?bBNc`5QjY5-H(JA6%D`Q^v+Ii!UdcPA?QJTip&PT`w$~P=*fPEB~&6 zrFdPN=5}9Yv*7Z$*`Ur{jk))lLE^UniM;)rM~%WIeFu}OCk$Z<+mRSej#m`#GrDA- z>1n?5Fc?{qA>`dN3QWlk9mos%3TrS!%!v0L_$y+$WUlFrR_+FvReLJT>BE?DqlsI_ z>gTSoKLN!;TFQjl=s9W775~a`tMf-2gOqUwvnzGurY_UD#uHV|4RZAvRC59~2Ae0% z<)p76RmGwxe-KGOHY6aS;9XH~y#ndj@hw0N2P+W*y@bsUEBqQ(hK4Upc#$BGUd$M) z9}+AkJsA8Kf{-5$BmBtHdFaQxGc{{6o5*0^IVmY=m0br2{5|e(&+W*1&gb3bAcdV2 z%phEjxo2~Cfa5(hj)XV?%je99+CW_wX1M1{mFafU5VxQ2CH-hCC3g70 zR!l3roI_90wM@U9x@z{G%#_BpZv2(TL5PYLFcg!>toQEJ$RdrRQ^Tqi9v|Ns^?@OTPOoc>LS_K6;bC+0gs%9k~04nPN0H`20 zaGF9APU6BI0P2SlF4JlE;>x%5>|Xu(XFcCNX)DS~hv6kX)$;Sn>@6=aE%gFV(JW@Y zNtoE7RE51X&3L7OXN$Il&^aGQE-()OzfWku47jC1@g?z9$(!KR~S#e>s4-6k+`lX$6 zEA+mNg$FLJsdw=>aZxu4P_{CUsyGE#l67eDk z<9HzSPb|cUgtZ@*RXM_YPw0J#7{|KJ&c&rZA&e4jnpPS`nj;vw zMTo6D5i2a4P$VrxJ3yMP-i^abH1sn28!C?fFPUAcT6TY{K#ALJcwmUam>oY{NpkC@ z=wgZga-q&%f?u{OIP7{{4=4{hPZw;buL|1ox|^MH;L6kUH&ly6YSYj z1C`!5F+>7nSBc@iOQ?n)g+UXjD<+(2OeMSeg!s4f(biZ&`8-?nwOXxBy4AoAbY~ry zJwfK@=j$mnHmlN4e^;g7y}e5QVWZR)@=&J)GrL0iS48w#+Ndvm3j}Or5(DNIl zDX4P!nGyT=R-UyRNM-3wQtqJ7e_%owy4eWO@M6(pqk|N`4)05R%w58ZSm1hn5H{w5 z!>}L9L3koKq0Y02C(F?|0vYvmhCw%{UoxpdEN}ctBm-Ftv5JIxoe8PWaDJ+$s5Y#) zN%CkM==Utuae7KtMHa@9i2ifNU?z<6Ww&1Zk7YA>kyX2+*NGoC>n{-8to%>|Pa(+e zFXu&SC~^*)Mu_WV%VuJ&*tCupv4G+vRy
7?n4xAcN!+m@mT#0)CJxQ0GG3 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%0Ajkw87r4g~xjLjai7w8{^uAJNWx%Dgb~LsR(Umxm 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 — Register the events in a simulation and play it again. [__Rendering options__](adv_rendering_options.md) — From quality settings to no-render or off-screen modes. + [__RSS sensor__](adv_rss.md) + — An implementation of RSS in the CARLA client library. [__Synchrony and time-step__](adv_synchrony_timestep.md) — Client-server communication and simulation time. [__Traffic Manager__](adv_traffic_manager.md) diff --git a/Docs/python_api.md b/Docs/python_api.md index e7e0642b9..41dfc1fa9 100644 --- a/Docs/python_api.md +++ b/Docs/python_api.md @@ -1150,21 +1150,158 @@ Parses the axis' orientations to string. --- +## carla.RssEgoDynamicsOnRoute +Part of the data contained inside a [carla.RssResponse](#carla.RssResponse) describing the state of the vehicle. The parameters include its current dynamics, and how it is heading regarding the target route. + +

Instance Variables

+- **ego_speed** (_libad_physics_python.Speed_) +The ego vehicle's speed. +- **min_stopping_distance** (_libad_physics_python.Distance_) +The current minimum stopping distance. +- **ego_center** (_libad_map_access_python.ENUPoint_) +The considered enu position of the ego vehicle. +- **ego_heading** (_libad_map_access_python.ENUHeading_) +The considered heading of the ego vehicle. +- **ego_center_within_route** (_bool_) +States if the ego vehicle's center is within the route. +- **crossing_border** (_bool_) +States if the vehicle is already crossing one of the lane borders. +- **route_heading** (_libad_map_access_python.ENUHeading_) +The considered heading of the route. +- **route_nominal_center** (_libad_map_access_python.ENUPoint_) +The considered nominal center of the current route. +- **heading_diff** (_libad_map_access_python.ENUHeading_) +The considered heading diff towards the route. +- **route_speed_lat** (_libad_physics_python.Speed_) +The ego vehicle's speed component _lat_ regarding the route. +- **route_speed_lon** (_libad_physics_python.Speed_) +The ego vehicle's speed component _lon_ regarding the route. +- **route_accel_lat** (_libad_physics_python.Acceleration_) +The ego vehicle's acceleration component _lat_ regarding the route. +- **route_accel_lon** (_libad_physics_python.Acceleration_) +The ego vehicle's acceleration component _lon_ regarding the route. +- **avg_route_accel_lat** (_libad_physics_python.Acceleration_) +The ego vehicle's acceleration component _lat_ regarding the route smoothened by an average filter. +- **avg_route_accel_lon** (_libad_physics_python.Acceleration_) +The ego acceleration component _lon_ regarding the route smoothened by an average filter. + +

Methods

+ +

Dunder methods

+- **\__str__**(**self**) + +--- + +## carla.RssResponse +
Inherited from _[carla.SensorData](#carla.SensorData)_

Class that contains the output of a [carla.RssSensor](#carla.RssSensor). This is the result of the RSS calculations performed for the parent vehicle of the sensor. + +A [carla.RssRestrictor](#carla.RssRestrictor) will use the data to modify the [carla.VehicleControl](#carla.VehicleControl) of the vehicle. + +

Instance Variables

+- **response_valid** (_bool_) +States if the response is valid. It is __False__ if calculations failed or an exception occured. +- **proper_response** (_libad_rss_python.ProperResponse_) +The proper response that the RSS calculated for the vehicle. +- **acceleration_restriction** (_libad_rss_python.AccelerationRestriction_) +Acceleration restrictions to be applied, according to the RSS calculation. +- **rss_state_snapshot** (_libad_rss_python.RssStateSnapshot_) +Detailed RSS states at the current moment in time. +- **ego_dynamics_on_route** (_[carla.RssEgoDynamicsOnRoute](#carla.RssEgoDynamicsOnRoute)_) +Current ego vehicle dynamics regarding the route. + +

Methods

+ +

Dunder methods

+- **\__str__**(**self**) + +--- + +## carla.RssRestrictor +These objects apply restrictions to a [carla.VehicleControl](#carla.VehicleControl). It is part of the CARLA implementation of the [C++ Library for Responsibility Sensitive Safety](https://github.com/intel/ad-rss-lib). This class works hand in hand with a [rss sensor](ref_sensors.md#rss-sensor), which provides the data of the restrictions to be applied. + +

Methods

+- **restrict_vehicle_control**(**self**, **vehicle_control**, **restriction**, **ego_dynamics_on_route**, **vehicle_physics**) +Applies the safety restrictions given by a [carla.RssSensor](#carla.RssSensor) to a [carla.VehicleControl](#carla.VehicleControl). + - **Parameters:** + - `vehicle_control` (_[carla.VehicleControl](#carla.VehicleControl)_) – The input vehicle control to be restricted. + - `restriction` (_libad_rss_python.AccelerationRestriction_) – Part of the response generated by the sensor. Contains restrictions to be applied to the acceleration of the vehicle. + - `ego_dynamics_on_route` (_[carla.RssEgoDynamicsOnRoute](#carla.RssEgoDynamicsOnRoute)_) – Part of the response generated by the sensor. Contains dynamics and heading of the vehicle regarding its route. + - `vehicle_physics` (_[carla.RssEgoDynamicsOnRoute](#carla.RssEgoDynamicsOnRoute)_) – The current physics of the vehicle. Used to apply the restrictions properly. + - **Return:** _[carla.VehicleControl](#carla.VehicleControl)_ + +--- + +## carla.RssRoadBoundariesMode +Enum declaration used in [carla.RssSensor](#carla.RssSensor) to enable or disable the [stay on road](https://intel.github.io/ad-rss-lib/ad_rss_map_integration/HandleRoadBoundaries/) feature. In summary, this feature considers the road boundaries as virtual objects. The minimum safety distance check is applied to these virtual walls, in order to make sure the vehicle does not drive off the road. + +

Instance Variables

+- **On** +Enables the _stay on road_ feature. +- **Off** +Disables the _stay on road_ feature. + +--- + +## carla.RssSensor +
Inherited from _[carla.Sensor](#carla.Sensor)_

This sensor works a bit differently than the rest. Take look at the [specific documentation](adv_rss.md), and the [rss sensor reference](ref_sensors.md#rss-sensor) to gain full understanding of it. + +The RSS sensor uses world information, and a [RSS library](https://github.com/intel/ad-rss-lib) to make safety checks on a vehicle. The output retrieved by the sensor is a [carla.RssResponse](#carla.RssResponse). This will be used by a [carla.RssRestrictor](#carla.RssRestrictor) to modify a [carla.VehicleControl](#carla.VehicleControl) before applying it to a vehicle. + +

Instance Variables

+- **ego_vehicle_dynamics** (_libad_rss_python.RssDynamics_) +States the [RSS parameters](https://intel.github.io/ad-rss-lib/ad_rss/Appendix-ParameterDiscussion/) that the sensor will consider for the ego vehicle. +- **other_vehicle_dynamics** (_libad_rss_python.RssDynamics_) +States the [RSS parameters](https://intel.github.io/ad-rss-lib/ad_rss/Appendix-ParameterDiscussion/) that the sensor will consider for the rest of vehicles. +- **road_boundaries_mode** (_[carla.RssRoadBoundariesMode](#carla.RssRoadBoundariesMode)_) +Switches the [stay on road](https://intel.github.io/ad-rss-lib/ad_rss_map_integration/HandleRoadBoundaries/) feature. By default is __On__. +- **visualization_mode** (_[carla.RssVisualizationMode](#carla.RssVisualizationMode)_) +Sets the visualization of the RSS on the server side. By default is __All__. These drawings may delay de RSS so it is best to set this to __Off__ when evaluating RSS performance. +- **routing_targets** (_vector<[carla.Transform](#carla.Transform)>_) +The current list of targets considered to route the vehicle. If no routing targets are defined, a route is generated at random. + +

Methods

+- **append_routing_target**(**self**, **routing_target**) +Appends a new target position to the current route of the vehicle. + - **Parameters:** + - `routing_target` (_[carla.Transform](#carla.Transform)_) – New target point for the route. Choose these after the intersections to force the route to take the desired turn. +- **reset_routing_targets**(**self**) +Erases the targets that have been appended to the route. +- **drop_route**(**self**) +Discards the current route. If there are targets remaining in **routing_targets**, creates a new route using those. Otherwise, a new route is created at random. + +

Dunder methods

+- **\__str__**(**self**) + +--- + +## carla.RssVisualizationMode +Enum declaration used to state the visualization RSS calculations server side. Depending on these, the [carla.RssSensor](#carla.RssSensor) will use a [carla.DebugHelper](#carla.DebugHelper) to draw different elements. These drawings take some time and might delay the RSS responses. It is best to disable them when evaluating RSS performance. + +

Instance Variables

+- **Off** +- **RouteOnly** +- **VehicleStateOnly** +- **VehicleStateAndRoute** +- **All** + +--- + ## carla.Sensor -
Inherited from _[carla.Actor](#carla.Actor)_

Sensors compound a specific family of actors quite diverse and unique. They are normally spawned as attachment/sons of a vehicle (take a look at [carla.World](#carla.World) to learn about actor spawning). Sensors are thoroughly designed to retrieve different types of data that they are listening to. The data they receive is shaped as different subclasses inherited from [carla.SensorData](#carla.SensorData) (depending on the sensor). - - Most sensors can be divided in two groups: those receiving data on every tick (cameras, point clouds and some specific sensors) and those who only receive under certain circumstances (trigger detectors). CARLA provides a specific set of sensors and their blueprint can be found in [carla.BlueprintLibrary](#carla.BlueprintLibrary). All the information on their preferences and settlement can be found [here](ref_sensors.md), but the list of those available in CARLA so far goes as follow: - Receive data on every tick: - - [Gnss sensor](ref_sensors.md#gnss-sensor). - - [IMU sensor](ref_sensors.md#imu-sensor). - - [Radar](ref_sensors.md#radar-sensor). - - [Depth camera](ref_sensors.md#depth-camera). - - [Lidar raycast](ref_sensors.md#lidar-raycast-sensor). - - [RGB camera](ref_sensors.md#rgb-camera). - - [Semantic Segmentation camera](ref_sensors.md#semantic-segmentation-camera). - Only receive data when triggered: - - [Collision detector](ref_sensors.md#collision-detector). - - [Lane invasion detector](ref_sensors.md#lane-invasion-detector). +

Inherited from _[carla.Actor](#carla.Actor)_

Sensors compound a specific family of actors quite diverse and unique. They are normally spawned as attachment/sons of a vehicle (take a look at [carla.World](#carla.World) to learn about actor spawning). Sensors are thoroughly designed to retrieve different types of data that they are listening to. The data they receive is shaped as different subclasses inherited from [carla.SensorData](#carla.SensorData) (depending on the sensor). + + Most sensors can be divided in two groups: those receiving data on every tick (cameras, point clouds and some specific sensors) and those who only receive under certain circumstances (trigger detectors). CARLA provides a specific set of sensors and their blueprint can be found in [carla.BlueprintLibrary](#carla.BlueprintLibrary). All the information on their preferences and settlement can be found [here](ref_sensors.md), but the list of those available in CARLA so far goes as follow. + Receive data on every tick. + - [Depth camera](ref_sensors.md#depth-camera). + - [Gnss sensor](ref_sensors.md#gnss-sensor). + - [IMU sensor](ref_sensors.md#imu-sensor). + - [Lidar raycast](ref_sensors.md#lidar-raycast-sensor). + - [Radar](ref_sensors.md#radar-sensor). + - [RGB camera](ref_sensors.md#rgb-camera). + - [RSS sensor](ref_sensors.md#rss-sensor). + - [Semantic Segmentation camera](ref_sensors.md#semantic-segmentation-camera). + Only receive data when triggered. + - [Collision detector](ref_sensors.md#collision-detector). + - [Lane invasion detector](ref_sensors.md#lane-invasion-detector). - [Obstacle detector](ref_sensors.md#obstacle-detector).

Instance Variables

@@ -1185,15 +1322,16 @@ Commands the sensor to stop listening for data. --- ## carla.SensorData -Base class for all the objects containing data generated by a [carla.Sensor](#carla.Sensor). This objects should be the argument of the function said sensor is listening to, in order to work with them. Each of these sensors needs for a specific type of sensor data. The relation between available sensors and their corresponding data goes like: - - Cameras (RGB, depth and semantic segmentation): [carla.Image](#carla.Image). - - Collision detector: [carla.CollisionEvent](#carla.CollisionEvent). - - Gnss detector: [carla.GnssMeasurement](#carla.GnssMeasurement). - - IMU detector: [carla.IMUMeasurement](#carla.IMUMeasurement). - - Lane invasion detector: [carla.LaneInvasionEvent](#carla.LaneInvasionEvent). - - Lidar raycast: [carla.LidarMeasurement](#carla.LidarMeasurement). - - Obstacle detector: [carla.ObstacleDetectionEvent](#carla.ObstacleDetectionEvent). +Base class for all the objects containing data generated by a [carla.Sensor](#carla.Sensor). This objects should be the argument of the function said sensor is listening to, in order to work with them. Each of these sensors needs for a specific type of sensor data. Hereunder is a list of the sensors and their corresponding data. + - Cameras (RGB, depth and semantic segmentation): [carla.Image](#carla.Image). + - Collision detector: [carla.CollisionEvent](#carla.CollisionEvent). + - Gnss detector: [carla.GnssMeasurement](#carla.GnssMeasurement). + - IMU detector: [carla.IMUMeasurement](#carla.IMUMeasurement). + - Lane invasion detector: [carla.LaneInvasionEvent](#carla.LaneInvasionEvent). + - Lidar raycast: [carla.LidarMeasurement](#carla.LidarMeasurement). + - Obstacle detector: [carla.ObstacleDetectionEvent](#carla.ObstacleDetectionEvent). - Radar detector: [carla.RadarMeasurement](#carla.RadarMeasurement). + - RSS sensor: [carla.RssResponse](#carla.RssResponse).

Instance Variables

- **frame** (_int_) diff --git a/Docs/ref_sensors.md b/Docs/ref_sensors.md index bffd52f87..4f9309155 100644 --- a/Docs/ref_sensors.md +++ b/Docs/ref_sensors.md @@ -1,15 +1,16 @@ # Sensors reference - * [__Collision detector__](#collision-detector) - * [__Depth camera__](#depth-camera) - * [__GNSS sensor__](#gnss-sensor) - * [__IMU sensor__](#imu-sensor) - * [__Lane invasion detector__](#lane-invasion-detector) - * [__Lidar raycast sensor__](#lidar-raycast-sensor) - * [__Obstacle detector__](#obstacle-detector) - * [__Radar sensor__](#radar-sensor) - * [__RGB camera__](#rgb-camera) - * [__Semantic segmentation camera__](#semantic-segmentation-camera) + * [__Collision detector__](#collision-detector) + * [__Depth camera__](#depth-camera) + * [__GNSS sensor__](#gnss-sensor) + * [__IMU sensor__](#imu-sensor) + * [__Lane invasion detector__](#lane-invasion-detector) + * [__Lidar raycast sensor__](#lidar-raycast-sensor) + * [__Obstacle detector__](#obstacle-detector) + * [__Radar sensor__](#radar-sensor) + * [__RGB camera__](#rgb-camera) + * [__RSS sensor__](#rss-sensor) + * [__Semantic segmentation camera__](#semantic-segmentation-camera) --- @@ -18,7 +19,7 @@ * __Blueprint:__ sensor.other.collision * __Output:__ [carla.CollisionEvent](python_api.md#carla.CollisionEvent) per collision. -This sensor registers an event each time its parent actor collisions against something in the world. Several collisions may be detected during a single simulation step. +This sensor registers an event each time its parent actor collisions against something in the world. Several collisions may be detected during a single simulation step. To ensure that collisions with any kind of object are detected, the server creates "fake" actors for elements such as buildings or bushes so the semantic tag can be retrieved to identify it. Collision detectors do not have any configurable attribute. @@ -63,9 +64,9 @@ Collision detectors do not have any configurable attribute. ## Depth camera * __Blueprint:__ sensor.camera.depth -* __Output:__ [carla.Image](python_api.md#carla.Image) per step (unless `sensor_tick` says otherwise). +* __Output:__ [carla.Image](python_api.md#carla.Image) per step (unless `sensor_tick` says otherwise). -The camera provides a raw data of the scene codifying the distance of each pixel to the camera (also known as **depth buffer** or **z-buffer**) to create a depth map of the elements. +The camera provides a raw data of the scene codifying the distance of each pixel to the camera (also known as **depth buffer** or **z-buffer**) to create a depth map of the elements. The image codifies depth value per pixel using 3 channels of the RGB color space, from less to more significant bytes: _R -> G -> B_. The actual distance in meters can be decoded with: @@ -75,8 +76,8 @@ normalized = (R + G * 256 + B * 256 * 256) / (256 * 256 * 256 - 1) in_meters = 1000 * normalized ``` -The output [carla.Image](python_api.md#carla.Image) should then be saved to disk using a [carla.colorConverter](python_api.md#carla.ColorConverter) that will turn the distance stored in RGB channels into a __[0,1]__ float containing the distance and then translate this to grayscale. -There are two options in [carla.colorConverter](python_api.md#carla.ColorConverter) to get a depth view: __Depth__ and __Logaritmic depth__. The precision is milimetric in both, but the logarithmic approach provides better results for closer objects. +The output [carla.Image](python_api.md#carla.Image) should then be saved to disk using a [carla.colorConverter](python_api.md#carla.ColorConverter) that will turn the distance stored in RGB channels into a __[0,1]__ float containing the distance and then translate this to grayscale. +There are two options in [carla.colorConverter](python_api.md#carla.ColorConverter) to get a depth view: __Depth__ and __Logaritmic depth__. The precision is milimetric in both, but the logarithmic approach provides better results for closer objects. ![ImageDepth](img/capture_depth.png) @@ -203,7 +204,7 @@ There are two options in [carla.colorConverter](python_api.md#carla.ColorConvert ## GNSS sensor * __Blueprint:__ sensor.other.gnss -* __Output:__ [carla.GNSSMeasurement](python_api.md#carla.GnssMeasurement) per step (unless `sensor_tick` says otherwise). +* __Output:__ [carla.GNSSMeasurement](python_api.md#carla.GnssMeasurement) per step (unless `sensor_tick` says otherwise). Reports current [gnss position](https://www.gsa.europa.eu/european-gnss/what-gnss) of its parent object. This is calculated by adding the metric position to an initial geo reference location defined within the OpenDRIVE map definition. @@ -416,17 +417,17 @@ Provides measures that accelerometer, gyroscope and compass would retrieve for t * __Blueprint:__ sensor.other.lane_invasion * __Output:__ [carla.LaneInvasionEvent](python_api.md#carla.LaneInvasionEvent) per crossing. -Registers an event each time its parent crosses a lane marking. -The sensor uses road data provided by the OpenDRIVE description of the map to determine whether the parent vehicle is invading another lane by considering the space between wheels. -However there are some things to be taken into consideration: +Registers an event each time its parent crosses a lane marking. +The sensor uses road data provided by the OpenDRIVE description of the map to determine whether the parent vehicle is invading another lane by considering the space between wheels. +However there are some things to be taken into consideration: -* Discrepancies between the OpenDRIVE file and the map will create irregularities such as crossing lanes that are not visible in the map. -* The output retrieves a list of crossed lane markings: the computation is done in OpenDRIVE and considering the whole space between the four wheels as a whole. Thus, there may be more than one lane being crossed at the same time. +* Discrepancies between the OpenDRIVE file and the map will create irregularities such as crossing lanes that are not visible in the map. +* The output retrieves a list of crossed lane markings: the computation is done in OpenDRIVE and considering the whole space between the four wheels as a whole. Thus, there may be more than one lane being crossed at the same time. This sensor does not have any configurable attribute. !!! Important - This sensor works fully on the client-side. + This sensor works fully on the client-side. #### Output attributes @@ -466,11 +467,11 @@ This sensor does not have any configurable attribute. * __Blueprint:__ sensor.lidar.ray_cast * __Output:__ [carla.LidarMeasurement](python_api.md#carla.LidarMeasurement) per step (unless `sensor_tick` says otherwise). -This sensor simulates a rotating Lidar implemented using ray-casting. -The points are computed by adding a laser for each channel distributed in the vertical FOV. The rotation is simulated computing the horizontal angle that the Lidar rotated in a frame. The point cloud is calculated by doing a ray-cast for each laser in every step: +This sensor simulates a rotating Lidar implemented using ray-casting. +The points are computed by adding a laser for each channel distributed in the vertical FOV. The rotation is simulated computing the horizontal angle that the Lidar rotated in a frame. The point cloud is calculated by doing a ray-cast for each laser in every step: `points_per_channel_each_step = points_per_second / (FPS * channels)` -A Lidar measurement contains a packet with all the points generated during a `1/FPS` interval. During this interval the physics are not updated so all the points in a measurement reflect the same "static picture" of the scene. +A Lidar measurement contains a packet with all the points generated during a `1/FPS` interval. During this interval the physics are not updated so all the points in a measurement reflect the same "static picture" of the scene. This output contains a cloud of simulation points and thus, can be iterated to retrieve a list of their [`carla.Location`](python_api.md#carla.Location): @@ -577,10 +578,10 @@ for location in lidar_measurement: ## Obstacle detector * __Blueprint:__ sensor.other.obstacle -* __Output:__ [carla.ObstacleDetectionEvent](python_api.md#carla.ObstacleDetectionEvent) per obstacle (unless `sensor_tick` says otherwise). +* __Output:__ [carla.ObstacleDetectionEvent](python_api.md#carla.ObstacleDetectionEvent) per obstacle (unless `sensor_tick` says otherwise). -Registers an event every time the parent actor has an obstacle ahead. -In order to anticipate obstacles, the sensor creates a capsular shape ahead of the parent vehicle and uses it to check for collisions. +Registers an event every time the parent actor has an obstacle ahead. +In order to anticipate obstacles, the sensor creates a capsular shape ahead of the parent vehicle and uses it to check for collisions. To ensure that collisions with any kind of object are detected, the server creates "fake" actors for elements such as buildings or bushes so the semantic tag can be retrieved to identify it. @@ -660,19 +661,19 @@ To ensure that collisions with any kind of object are detected, the server creat ## Radar sensor * __Blueprint:__ sensor.other.radar -* __Output:__ [carla.RadarMeasurement](python_api.md#carla.RadarMeasurement) per step (unless `sensor_tick` says otherwise). +* __Output:__ [carla.RadarMeasurement](python_api.md#carla.RadarMeasurement) per step (unless `sensor_tick` says otherwise). -The sensor creates a conic view that is translated to a 2D point map of the elements in sight and their speed regarding the sensor. This can be used to shape elements and evaluate their movement and direction. Due to the use of polar coordinates, the points will concentrate around the center of the view. +The sensor creates a conic view that is translated to a 2D point map of the elements in sight and their speed regarding the sensor. This can be used to shape elements and evaluate their movement and direction. Due to the use of polar coordinates, the points will concentrate around the center of the view. -Points measured are contained in [carla.RadarMeasurement](python_api.md#carla.RadarMeasurement) as an array of [carla.RadarDetection](python_api.md#carla.RadarDetection), which specifies their polar coordinates, distance and velocity. +Points measured are contained in [carla.RadarMeasurement](python_api.md#carla.RadarMeasurement) as an array of [carla.RadarDetection](python_api.md#carla.RadarDetection), which specifies their polar coordinates, distance and velocity. This raw data provided by the radar sensor can be easily converted to a format manageable by __numpy__: ```py # To get a numpy [[vel, altitude, azimuth, depth],...[,,,]]: points = np.frombuffer(radar_data.raw_data, dtype=np.dtype('f4')) points = np.reshape(points, (len(radar_data), 4)) -``` +``` -The provided script `manual_control.py` uses this sensor to show the points being detected and paint them white when static, red when moving towards the object and blue when moving away: +The provided script `manual_control.py` uses this sensor to show the points being detected and paint them white when static, red when moving towards the object and blue when moving away: ![ImageRadar](img/sensor_radar.png) @@ -762,17 +763,17 @@ The provided script `manual_control.py` uses this sensor to show the points bein * __Blueprint:__ sensor.camera.rgb * __Output:__ [carla.Image](python_api.md#carla.Image) per step (unless `sensor_tick` says otherwise).. -The "RGB" camera acts as a regular camera capturing images from the scene. +The "RGB" camera acts as a regular camera capturing images from the scene. [carla.colorConverter](python_api.md#carla.ColorConverter) -If `enable_postprocess_effects` is enabled, a set of post-process effects is applied to the image for the sake of realism: +If `enable_postprocess_effects` is enabled, a set of post-process effects is applied to the image for the sake of realism: -* __Vignette:__ darkens the border of the screen. -* __Grain jitter:__ adds some noise to the render. -* __Bloom:__ intense lights burn the area around them. -* __Auto exposure:__ modifies the image gamma to simulate the eye adaptation to darker or brighter areas. -* __Lens flares:__ simulates the reflection of bright objects on the lens. -* __Depth of field:__ blurs objects near or very far away of the camera. +* __Vignette:__ darkens the border of the screen. +* __Grain jitter:__ adds some noise to the render. +* __Bloom:__ intense lights burn the area around them. +* __Auto exposure:__ modifies the image gamma to simulate the eye adaptation to darker or brighter areas. +* __Lens flares:__ simulates the reflection of bright objects on the lens. +* __Depth of field:__ blurs objects near or very far away of the camera. The `sensor_tick` tells how fast we want the sensor to capture the data. @@ -1066,18 +1067,161 @@ Since these effects are provided by UE, please make sure to check their document
Array of BGRA 32-bit pixels.
+
+ +--- +## RSS sensor + +* __Blueprint:__ sensor.other.rss +* __Output:__ [carla.RssResponse](python_api.md#carla.RssResponse) per step (unless `sensor_tick` says otherwise). + +!!! Important + It is highly recommended to read the specific [rss documentation](adv_rss.md) before reading this. + +This sensor integrates the [C++ Library for Responsibility Sensitive Safety](https://github.com/intel/ad-rss-lib) in CARLA. It is disabled by default in CARLA, and it has to be explicitly built in order to be used. + +The RSS sensor calculates the RSS state of a vehicle and retrieves the current RSS Response as sensor data. The [carla.RssRestrictor](python_api.md#carla.RssRestrictor) will use this data to adapt a [carla.VehicleControl](python_api.md#carla.VehicleControl) before applying it to a vehicle. + +These controllers can be generated by an *Automated Driving* stack or user input. For instance, hereunder there is a fragment of code from `PythonAPI/examples/manual_control_rss.py`, where the user input is modified using RSS when necessary. + +__1.__ Checks if the __RssSensor__ generates a valid response containing restrictions. +__2.__ Gathers the current dynamics of the vehicle and the vehicle physics. +__3.__ Applies restrictions to the vehicle control using the response from the RssSensor, and the current dynamics and physicis of the vehicle. + +```py +rss_restriction = self._world.rss_sensor.acceleration_restriction if self._world.rss_sensor and self._world.rss_sensor.response_valid else None +if rss_restriction: + rss_ego_dynamics_on_route = self._world.rss_sensor.ego_dynamics_on_route + vehicle_physics = world.player.get_physics_control() +... + vehicle_control = self._restrictor.restrict_vehicle_control( + vehicle_control, rss_restriction, rss_ego_dynamics_on_route, vehicle_physics) +``` + + +#### The carla.RssSensor class + +The blueprint for this sensor has no modifiable attributes. However, the [carla.RssSensor](python_api.md#carla.RssSensor) object that it instantiates has attributes and methods that are detailed in the Python API reference. Here is a summary of them. + + + + + + + + + + + + + + + + + + + + + + + +
carla.RssSensor variablesTypeDescription
+ego_vehicle_dynamics libad_rss_python.RssDynamicsRSS parameters to be applied for the ego vehicle
+other_vehicle_dynamics libad_rss_python.RssDynamicsRSS parameters to be applied for the other vehicles
road_boundaries_modecarla.RssRoadBoundariesModeEnables/Disables the stay on road feature. Default is On.
visualization_modecarla.RssVisualizationModeStates the visualization of the RSS calculations. Default is All.
+
+ +```py +# Fragment of manual_control_rss.py +# The carla.RssSensor is updated when listening for a new carla.RssResponse +def _on_rss_response(weak_self, response): +... + self.timestamp = response.timestamp + self.response_valid = response.response_valid + self.proper_response = response.proper_response + self.acceleration_restriction = response.acceleration_restriction + self.ego_dynamics_on_route = response.ego_dynamics_on_route +``` + +!!! Warning + This sensor works fully on the client side. There is no blueprint in the server. Changes on the attributes will have effect __after__ the *listen()* has been called. + +The methods available in this class are related to the routing of the vehicle. RSS calculations are always based on a route of the ego vehicle through the road network. + +The sensor allows to control the considered route by providing some key points, which could be the [carla.Transform](python_api.md#carla.Transform) in a [carla.Waypoint](python_api.md#carla.Waypoint). These points are best selected after the intersections to force the route to take the desired turn. + + + + + + + + + + + + + + + + + + +
carla.RssSensor methodsDescription
routing_targetsGet the current list of routing targets used for route.
append_routing_targetAppend an additional position to the current routing targets.
reset_routing_targetsDeletes the appended routing targets.
drop_routeDiscards the current route and creates a new one.
+
+ +```py +# Update the current route +self.sensor.reset_routing_targets() +if routing_targets: + for target in routing_targets: + self.sensor.append_routing_target(target) +``` + +!!! Note + If no routing targets are defined, a random route is created. + +#### Output attributes + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
carla.RssResponse attributesTypeDescription
response_validboolValidity of the response data.
proper_response libad_rss_python.ProperResponseProper response that the RSS calculated for the vehicle.
acceleration_restrictionlibad_rss_python.AccelerationRestrictionAcceleration restrictions of the RSS calculation.
rss_state_snapshotlibad_rss_python.RssStateSnapshotRSS states at the current point in time.
ego_dynamics_on_routecarla.RssEgoDynamicsOnRouteCurrent ego vehicle dynamics regarding the route.
--- ## Semantic segmentation camera -* __Blueprint:__ sensor.camera.semantic_segmentation -* __Output:__ [carla.Image](python_api.md#carla.Image) per step (unless `sensor_tick` says otherwise). +* __Blueprint:__ sensor.camera.semantic_segmentation +* __Output:__ [carla.Image](python_api.md#carla.Image) per step (unless `sensor_tick` says otherwise). -This camera classifies every object in sight by displaying it in a different color according to its tags (e.g., pedestrians in a different color than vehicles). +This camera classifies every object in sight by displaying it in a different color according to its tags (e.g., pedestrians in a different color than vehicles). When the simulation starts, every element in scene is created with a tag. So it happens when an actor is spawned. The objects are classified by their relative file path in the project. For example, meshes stored in `Unreal/CarlaUE4/Content/Static/Pedestrians` are tagged as `Pedestrian`. - -The server provides an image with the tag information __encoded in the red channel__: A pixel with a red value of `x` belongs to an object with tag `x`. -This raw [carla.Image](python_api.md#carla.Image) can be stored and converted it with the help of __CityScapesPalette__ in [carla.ColorConverter](python_api.md#carla.ColorConverter) to apply the tags information and show picture with the semantic segmentation. + +The server provides an image with the tag information __encoded in the red channel__: A pixel with a red value of `x` belongs to an object with tag `x`. +This raw [carla.Image](python_api.md#carla.Image) can be stored and converted it with the help of __CityScapesPalette__ in [carla.ColorConverter](python_api.md#carla.ColorConverter) to apply the tags information and show picture with the semantic segmentation. The following tags are currently available: @@ -1266,4 +1410,3 @@ The following tags are currently available:

- diff --git a/PythonAPI/docs/sensor.yml b/PythonAPI/docs/sensor.yml index 8bf6af47b..d7f0027f2 100644 --- a/PythonAPI/docs/sensor.yml +++ b/PythonAPI/docs/sensor.yml @@ -6,28 +6,29 @@ parent: carla.Actor # - DESCRIPTION ------------------------ doc: > - Sensors compound a specific family of actors quite diverse and unique. They are normally spawned as attachment/sons of a vehicle (take a look at carla.World to learn about actor spawning). Sensors are thoroughly designed to retrieve different types of data that they are listening to. The data they receive is shaped as different subclasses inherited from carla.SensorData (depending on the sensor). - - Most sensors can be divided in two groups: those receiving data on every tick (cameras, point clouds and some specific sensors) and those who only receive under certain circumstances (trigger detectors). CARLA provides a specific set of sensors and their blueprint can be found in carla.BlueprintLibrary. All the information on their preferences and settlement can be found [here](ref_sensors.md), but the list of those available in CARLA so far goes as follow: - Receive data on every tick: - - [Gnss sensor](ref_sensors.md#gnss-sensor). - - [IMU sensor](ref_sensors.md#imu-sensor). - - [Radar](ref_sensors.md#radar-sensor). - - [Depth camera](ref_sensors.md#depth-camera). - - [Lidar raycast](ref_sensors.md#lidar-raycast-sensor). - - [RGB camera](ref_sensors.md#rgb-camera). - - [Semantic Segmentation camera](ref_sensors.md#semantic-segmentation-camera). - Only receive data when triggered: - - [Collision detector](ref_sensors.md#collision-detector). - - [Lane invasion detector](ref_sensors.md#lane-invasion-detector). - - [Obstacle detector](ref_sensors.md#obstacle-detector). + Sensors compound a specific family of actors quite diverse and unique. They are normally spawned as attachment/sons of a vehicle (take a look at carla.World to learn about actor spawning). Sensors are thoroughly designed to retrieve different types of data that they are listening to. The data they receive is shaped as different subclasses inherited from carla.SensorData (depending on the sensor). + + Most sensors can be divided in two groups: those receiving data on every tick (cameras, point clouds and some specific sensors) and those who only receive under certain circumstances (trigger detectors). CARLA provides a specific set of sensors and their blueprint can be found in carla.BlueprintLibrary. All the information on their preferences and settlement can be found [here](ref_sensors.md), but the list of those available in CARLA so far goes as follow. + Receive data on every tick. + - [Depth camera](ref_sensors.md#depth-camera). + - [Gnss sensor](ref_sensors.md#gnss-sensor). + - [IMU sensor](ref_sensors.md#imu-sensor). + - [Lidar raycast](ref_sensors.md#lidar-raycast-sensor). + - [Radar](ref_sensors.md#radar-sensor). + - [RGB camera](ref_sensors.md#rgb-camera). + - [RSS sensor](ref_sensors.md#rss-sensor). + - [Semantic Segmentation camera](ref_sensors.md#semantic-segmentation-camera). + Only receive data when triggered. + - [Collision detector](ref_sensors.md#collision-detector). + - [Lane invasion detector](ref_sensors.md#lane-invasion-detector). + - [Obstacle detector](ref_sensors.md#obstacle-detector). # - PROPERTIES ------------------------- instance_variables: - var_name: is_listening type: boolean doc: > - When True the sensor will be waiting for data. + When True the sensor will be waiting for data. # - METHODS ---------------------------- methods: - def_name: listen @@ -37,7 +38,7 @@ doc: > The called function with one argument containing the sensor data. doc: > - The function the sensor will be calling to every time a new measurement is received. This function needs for an argument containing an object type carla.SensorData to work with. + The function the sensor will be calling to every time a new measurement is received. This function needs for an argument containing an object type carla.SensorData to work with. # -------------------------------------- - def_name: stop doc: > @@ -45,4 +46,120 @@ # -------------------------------------- - def_name: __str__ # -------------------------------------- + + - class_name: RssSensor + parent: carla.Sensor + # - DESCRIPTION ------------------------ + doc: > + This sensor works a bit differently than the rest. Take look at the [specific documentation](adv_rss.md), and the [rss sensor reference](ref_sensors.md#rss-sensor) to gain full understanding of it. + + + The RSS sensor uses world information, and a [RSS library](https://github.com/intel/ad-rss-lib) to make safety checks on a vehicle. The output retrieved by the sensor is a carla.RssResponse. This will be used by a carla.RssRestrictor to modify a carla.VehicleControl before applying it to a vehicle. + # - PROPERTIES ------------------------- + instance_variables: + - var_name: ego_vehicle_dynamics + type: libad_rss_python.RssDynamics + doc: > + States the [RSS parameters](https://intel.github.io/ad-rss-lib/ad_rss/Appendix-ParameterDiscussion/) that the sensor will consider for the ego vehicle. + - var_name: other_vehicle_dynamics + type: libad_rss_python.RssDynamics + doc: > + States the [RSS parameters](https://intel.github.io/ad-rss-lib/ad_rss/Appendix-ParameterDiscussion/) that the sensor will consider for the rest of vehicles. + - var_name: road_boundaries_mode + type: carla.RssRoadBoundariesMode + doc: > + Switches the [stay on road](https://intel.github.io/ad-rss-lib/ad_rss_map_integration/HandleRoadBoundaries/) feature. By default is __On__. + - var_name: visualization_mode + type: carla.RssVisualizationMode + doc: > + Sets the visualization of the RSS on the server side. By default is __All__. These drawings may delay de RSS so it is best to set this to __Off__ when evaluating RSS performance. + - var_name: routing_targets + type: vector + doc: > + The current list of targets considered to route the vehicle. If no routing targets are defined, a route is generated at random. + # - METHODS ---------------------------- + methods: + - def_name: append_routing_target + params: + - param_name: routing_target + type: carla.Transform + doc: > + New target point for the route. Choose these after the intersections to force the route to take the desired turn. + doc: > + Appends a new target position to the current route of the vehicle. + - def_name: reset_routing_targets + doc: > + Erases the targets that have been appended to the route. + - def_name: drop_route + doc: > + Discards the current route. If there are targets remaining in **routing_targets**, creates a new route using those. Otherwise, a new route is created at random. + # -------------------------------------- + - def_name: __str__ + # -------------------------------------- + + - class_name: RssRestrictor + parent: + # - DESCRIPTION ------------------------ + doc: > + These objects apply restrictions to a carla.VehicleControl. It is part of the CARLA implementation of the [C++ Library for Responsibility Sensitive Safety](https://github.com/intel/ad-rss-lib). This class works hand in hand with a [rss sensor](ref_sensors.md#rss-sensor), which provides the data of the restrictions to be applied. + # - PROPERTIES ------------------------- + instance_variables: + + # - METHODS ---------------------------- + methods: + - def_name: restrict_vehicle_control + params: + - param_name: vehicle_control + type: carla.VehicleControl + doc: > + The input vehicle control to be restricted. + - param_name: restriction + type: libad_rss_python.AccelerationRestriction + doc: > + Part of the response generated by the sensor. Contains restrictions to be applied to the acceleration of the vehicle. + - param_name: ego_dynamics_on_route + type: carla.RssEgoDynamicsOnRoute + doc: > + Part of the response generated by the sensor. Contains dynamics and heading of the vehicle regarding its route. + - param_name: vehicle_physics + type: carla.RssEgoDynamicsOnRoute + doc: > + The current physics of the vehicle. Used to apply the restrictions properly. + return: + carla.VehicleControl + doc: > + Applies the safety restrictions given by a carla.RssSensor to a carla.VehicleControl. + # -------------------------------------- + + - class_name: RssRoadBoundariesMode + # - DESCRIPTION ------------------------ + doc: > + Enum declaration used in carla.RssSensor to enable or disable the [stay on road](https://intel.github.io/ad-rss-lib/ad_rss_map_integration/HandleRoadBoundaries/) feature. In summary, this feature considers the road boundaries as virtual objects. The minimum safety distance check is applied to these virtual walls, in order to make sure the vehicle does not drive off the road. + # - PROPERTIES ------------------------- + instance_variables: + - var_name: 'On' + doc: > + Enables the _stay on road_ feature. + # -------------------------------------- + - var_name: 'Off' + doc: > + Disables the _stay on road_ feature. + # -------------------------------------- + + - class_name: RssVisualizationMode + # - DESCRIPTION ------------------------ + doc: > + Enum declaration used to state the visualization RSS calculations server side. Depending on these, the carla.RssSensor will use a carla.DebugHelper to draw different elements. These drawings take some time and might delay the RSS responses. It is best to disable them when evaluating RSS performance. + # - PROPERTIES ------------------------- + instance_variables: + - var_name: 'Off' + # -------------------------------------- + - var_name: RouteOnly + # -------------------------------------- + - var_name: VehicleStateOnly + # -------------------------------------- + - var_name: VehicleStateAndRoute + # -------------------------------------- + - var_name: All + # -------------------------------------- ... diff --git a/PythonAPI/docs/sensor_data.yml b/PythonAPI/docs/sensor_data.yml index 342a49a2a..71ae80f4f 100644 --- a/PythonAPI/docs/sensor_data.yml +++ b/PythonAPI/docs/sensor_data.yml @@ -5,15 +5,16 @@ - class_name: SensorData # - DESCRIPTION ------------------------ doc: > - Base class for all the objects containing data generated by a carla.Sensor. This objects should be the argument of the function said sensor is listening to, in order to work with them. Each of these sensors needs for a specific type of sensor data. The relation between available sensors and their corresponding data goes like: - - Cameras (RGB, depth and semantic segmentation): carla.Image. - - Collision detector: carla.CollisionEvent. - - Gnss detector: carla.GnssMeasurement. - - IMU detector: carla.IMUMeasurement. - - Lane invasion detector: carla.LaneInvasionEvent. - - Lidar raycast: carla.LidarMeasurement. - - Obstacle detector: carla.ObstacleDetectionEvent. - - Radar detector: carla.RadarMeasurement. + Base class for all the objects containing data generated by a carla.Sensor. This objects should be the argument of the function said sensor is listening to, in order to work with them. Each of these sensors needs for a specific type of sensor data. Hereunder is a list of the sensors and their corresponding data. + - Cameras (RGB, depth and semantic segmentation): carla.Image. + - Collision detector: carla.CollisionEvent. + - Gnss detector: carla.GnssMeasurement. + - IMU detector: carla.IMUMeasurement. + - Lane invasion detector: carla.LaneInvasionEvent. + - Lidar raycast: carla.LidarMeasurement. + - Obstacle detector: carla.ObstacleDetectionEvent. + - Radar detector: carla.RadarMeasurement. + - RSS sensor: carla.RssResponse. # - PROPERTIES ------------------------- instance_variables: - var_name: frame @@ -33,21 +34,21 @@ - class_name: ColorConverter # - DESCRIPTION ------------------------ doc: > - Class that defines conversion patterns that can be applied to a carla.Image in order to show information provided by carla.Sensor. Depth conversions cause a loss of accuracy, as sensors detect depth as float that is then converted to a grayscale value between 0 and 255. Take a look a this [recipe](ref_code_recipes.md#converted-image-recipe) to see an example of how to create and save image data for sensor.camera.semantic_segmentation. + Class that defines conversion patterns that can be applied to a carla.Image in order to show information provided by carla.Sensor. Depth conversions cause a loss of accuracy, as sensors detect depth as float that is then converted to a grayscale value between 0 and 255. Take a look a this [recipe](ref_code_recipes.md#converted-image-recipe) to see an example of how to create and save image data for sensor.camera.semantic_segmentation. # - PROPERTIES ------------------------- instance_variables: - var_name: CityScapesPalette doc: > - Converts the image to a segmentated map using tags provided by the blueprint library. Used by sensor.camera.semantic_segmentation. + Converts the image to a segmentated map using tags provided by the blueprint library. Used by sensor.camera.semantic_segmentation. - var_name: Depth doc: > - Converts the image to a linear depth map. Used by sensor.camera.depth. + Converts the image to a linear depth map. Used by sensor.camera.depth. - var_name: LogarithmicDepth doc: > - Converts the image to a depth map using a logarithmic scale, leading to better precision for small distances at the expense of losing it when further away. + Converts the image to a depth map using a logarithmic scale, leading to better precision for small distances at the expense of losing it when further away. - var_name: Raw doc: > - No changes applied to the image. + No changes applied to the image. - class_name: Image parent: carla.SensorData @@ -63,7 +64,7 @@ - var_name: height type: int doc: > - Image height in pixels. + Image height in pixels. - var_name: width type: int doc: > @@ -84,12 +85,12 @@ - param_name: path type: str doc: > - Path that will contain the image. + Path that will contain the image. - param_name: color_converter type: carla.ColorConverter default: Raw doc: > - Default Raw will make no changes. + Default Raw will make no changes. doc: > Saves the image to disk using a converter pattern stated as `color_converter`. The default conversion pattern is Raw that will make no changes to the image. # -------------------------------------- @@ -122,7 +123,7 @@ - var_name: channels type: int doc: > - Number of lasers shot. + Number of lasers shot. - var_name: horizontal_angle type: float doc: > @@ -130,7 +131,7 @@ - var_name: raw_data type: bytes doc: > - List of 3D points received as data. + List of 3D points received as data. # - METHODS ---------------------------- methods: - def_name: save_to_disk @@ -138,7 +139,7 @@ - param_name: path type: str doc: > - Saves the point cloud to disk as a .ply file describing data from 3D scanners. The files generated are ready to be used within [MeshLab](http://www.meshlab.net/), an open source system for processing said files. Just take into account that axis may differ from Unreal Engine and so, need to be reallocated. + Saves the point cloud to disk as a .ply file describing data from 3D scanners. The files generated are ready to be used within [MeshLab](http://www.meshlab.net/), an open source system for processing said files. Just take into account that axis may differ from Unreal Engine and so, need to be reallocated. # -------------------------------------- - def_name: get_point_count params: @@ -170,7 +171,7 @@ parent: carla.SensorData # - DESCRIPTION ------------------------ doc: > - Class that defines a collision data for sensor.other.collision. The sensor creates one of this for every collision detected which may be many for one simulation step. Learn more about this [here](ref_sensors.md#collision-detector). + Class that defines a collision data for sensor.other.collision. The sensor creates one of this for every collision detected which may be many for one simulation step. Learn more about this [here](ref_sensors.md#collision-detector). # - PROPERTIES ------------------------- instance_variables: - var_name: actor @@ -180,7 +181,7 @@ - var_name: other_actor type: carla.Actor doc: > - The second actor involved in the collision. + The second actor involved in the collision. - var_name: normal_impulse type: carla.Vector3D doc: > @@ -190,13 +191,13 @@ parent: carla.SensorData # - DESCRIPTION ------------------------ doc: > - Class that defines the obstacle data for sensor.other.obstacle. Learn more about this [here](ref_sensors.md#obstacle-detector). + Class that defines the obstacle data for sensor.other.obstacle. Learn more about this [here](ref_sensors.md#obstacle-detector). # - PROPERTIES ------------------------- instance_variables: - var_name: actor type: carla.Actor doc: > - The actor the sensor is attached to. + The actor the sensor is attached to. - var_name: other_actor type: carla.Actor doc: > @@ -204,7 +205,7 @@ - var_name: distance type: float doc: > - Distance between `actor` and `other`. + Distance between `actor` and `other`. # - METHODS ---------------------------- methods: - def_name: __str__ @@ -214,7 +215,7 @@ parent: carla.SensorData # - DESCRIPTION ------------------------ doc: > - Class that defines lanes invasion for sensor.other.lane_invasion. It works only client-side and is dependant on OpenDRIVE to provide reliable information. The sensor creates one of this every time there is a lane invasion, which may be more than once per simulation step. Learn more about this [here](ref_sensors.md#lane-invasion-detector). + Class that defines lanes invasion for sensor.other.lane_invasion. It works only client-side and is dependant on OpenDRIVE to provide reliable information. The sensor creates one of this every time there is a lane invasion, which may be more than once per simulation step. Learn more about this [here](ref_sensors.md#lane-invasion-detector). # - PROPERTIES ------------------------- instance_variables: - var_name: actor @@ -258,7 +259,7 @@ parent: carla.SensorData # - DESCRIPTION ------------------------ doc: > - Class that defines the data registered by a sensor.other.imu, regarding the sensor's transformation according to the current carla.World. It essentially acts as accelerometer, gyroscope and compass. + Class that defines the data registered by a sensor.other.imu, regarding the sensor's transformation according to the current carla.World. It essentially acts as accelerometer, gyroscope and compass. # - PROPERTIES ------------------------- instance_variables: - var_name: accelerometer @@ -288,12 +289,12 @@ - var_name: raw_data type: bytes doc: > - The complete information of the carla.RadarDetection the radar has registered. + The complete information of the carla.RadarDetection the radar has registered. # - METHODS ---------------------------- methods: - def_name: get_detection_count doc: > - Retrieves the number of entries generated, same as **\__str__()**. + Retrieves the number of entries generated, same as **\__str__()**. # -------------------------------------- - def_name: __getitem__ params: @@ -317,7 +318,7 @@ - class_name: RadarDetection # - DESCRIPTION ------------------------ doc: > - Data contained inside a carla.RadarMeasurement. Each of these represents one of the points in the cloud that a sensor.other.radar registers and contains the distance, angle and velocity in relation to the radar. + Data contained inside a carla.RadarMeasurement. Each of these represents one of the points in the cloud that a sensor.other.radar registers and contains the distance, angle and velocity in relation to the radar. # - PROPERTIES ------------------------- instance_variables: - var_name: altitude @@ -343,4 +344,129 @@ methods: - def_name: __str__ # -------------------------------------- + + - class_name: RssResponse + parent: carla.SensorData + # - DESCRIPTION ------------------------ + doc: > + Class that contains the output of a carla.RssSensor. This is the result of the RSS calculations performed for the parent vehicle of the sensor. + + + A carla.RssRestrictor will use the data to modify the carla.VehicleControl of the vehicle. + # - PROPERTIES ------------------------- + instance_variables: + - var_name: response_valid + type: bool + doc: > + States if the response is valid. It is __False__ if calculations failed or an exception occured. + # -------------------------------------- + - var_name: proper_response + type: libad_rss_python.ProperResponse + doc: > + The proper response that the RSS calculated for the vehicle. + # -------------------------------------- + - var_name: acceleration_restriction + type: libad_rss_python.AccelerationRestriction + doc: > + Acceleration restrictions to be applied, according to the RSS calculation. + # -------------------------------------- + - var_name: rss_state_snapshot + type: libad_rss_python.RssStateSnapshot + doc: > + Detailed RSS states at the current moment in time. + # -------------------------------------- + - var_name: ego_dynamics_on_route + type: carla.RssEgoDynamicsOnRoute + doc: > + Current ego vehicle dynamics regarding the route. + # - METHODS ---------------------------- + methods: + - def_name: __str__ + # -------------------------------------- + + - class_name: RssEgoDynamicsOnRoute + # - DESCRIPTION ------------------------ + doc: > + Part of the data contained inside a carla.RssResponse describing the state of the vehicle. The parameters include its current dynamics, and how it is heading regarding the target route. + # - PROPERTIES ------------------------- + instance_variables: + - var_name: ego_speed + type: libad_physics_python.Speed + doc: > + The ego vehicle's speed. + # -------------------------------------- + - var_name: min_stopping_distance + type: libad_physics_python.Distance + doc: > + The current minimum stopping distance. + # -------------------------------------- + - var_name: ego_center + type: libad_map_access_python.ENUPoint + doc: > + The considered enu position of the ego vehicle. + # -------------------------------------- + - var_name: ego_heading + type: libad_map_access_python.ENUHeading + doc: > + The considered heading of the ego vehicle. + # -------------------------------------- + - var_name: ego_center_within_route + type: bool + doc: > + States if the ego vehicle's center is within the route. + # -------------------------------------- + - var_name: crossing_border + type: bool + doc: > + States if the vehicle is already crossing one of the lane borders. + # -------------------------------------- + - var_name: route_heading + type: libad_map_access_python.ENUHeading + doc: > + The considered heading of the route. + # -------------------------------------- + - var_name: route_nominal_center + type: libad_map_access_python.ENUPoint + doc: > + The considered nominal center of the current route. + # -------------------------------------- + - var_name: heading_diff + type: libad_map_access_python.ENUHeading + doc: > + The considered heading diff towards the route. + # -------------------------------------- + - var_name: route_speed_lat + type: libad_physics_python.Speed + doc: > + The ego vehicle's speed component _lat_ regarding the route. + # -------------------------------------- + - var_name: route_speed_lon + type: libad_physics_python.Speed + doc: > + The ego vehicle's speed component _lon_ regarding the route. + # -------------------------------------- + - var_name: route_accel_lat + type: libad_physics_python.Acceleration + doc: > + The ego vehicle's acceleration component _lat_ regarding the route. + # -------------------------------------- + - var_name: route_accel_lon + type: libad_physics_python.Acceleration + doc: > + The ego vehicle's acceleration component _lon_ regarding the route. + # -------------------------------------- + - var_name: avg_route_accel_lat + type: libad_physics_python.Acceleration + doc: > + The ego vehicle's acceleration component _lat_ regarding the route smoothened by an average filter. + # -------------------------------------- + - var_name: avg_route_accel_lon + type: libad_physics_python.Acceleration + doc: > + The ego acceleration component _lon_ regarding the route smoothened by an average filter. + # - METHODS ---------------------------- + methods: + - def_name: __str__ + # -------------------------------------- + ... diff --git a/README.md b/README.md index c409c509f..9eec0ab81 100644 --- a/README.md +++ b/README.md @@ -97,6 +97,6 @@ CARLA specific code is distributed under MIT License. CARLA specific assets are distributed under CC-BY License. -The ad-rss-lib library compiled and linked by the [RSS Integration build variant](Docs/rss_lib_integration.md) introduces LGPL-2.1-only License. +The ad-rss-lib library compiled and linked by the [RSS Integration build variant](Docs/adv_rss.md) introduces LGPL-2.1-only License. Note that UE4 itself follows its own license terms. diff --git a/mkdocs.yml b/mkdocs.yml index b71166154..b37277f55 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -26,6 +26,7 @@ nav: - Advanced steps: - 'Recorder': 'adv_recorder.md' - 'Rendering options': 'adv_rendering_options.md' + - 'RSS sensor': 'adv_rss.md' - 'Synchrony and time-step': 'adv_synchrony_timestep.md' - 'Traffic Manager': 'adv_traffic_manager.md' - References: