diff --git a/docs/sensors.rst b/docs/sensors.rst index 6851a797..35f869d1 100644 --- a/docs/sensors.rst +++ b/docs/sensors.rst @@ -57,6 +57,9 @@ respectively. Each sensor ``class`` has its own additional parameters, listed in the next sections. +3D LiDARs +----------------------------------------- + HELIOS 32 (26 deg FOV) ########################## @@ -343,3 +346,31 @@ Depth (RGBD) camera .. literalinclude:: ../definitions/rgbd_camera.sensor.xml :language: xml + + +GNSS sensor ("GPS") +--------------------- +A "GPS sensor" can be attached to a robot with the code shown below. +For it to work, the ``world`` XML needs to have a :ref:`georeference tag `. + +.. dropdown:: To use in your robot, copy and paste this inside a ```` or ```` tag. + :open: + + .. code-block:: xml + + + +.. dropdown:: All parameters available in gnss.sensor.xml + + File: `mvsim_tutorial/definitions/gnss.sensor.xml `_ + + .. literalinclude:: ../definitions/gnss.sensor.xml + :language: xml + + diff --git a/docs/world.rst b/docs/world.rst index 42ad793d..434fc7af 100644 --- a/docs/world.rst +++ b/docs/world.rst @@ -39,6 +39,7 @@ First, we have global definitions on the simulation itself, the GUI, and the lig world_global world_gui + world_georeference world_lighting World contents diff --git a/docs/world_georeference.rst b/docs/world_georeference.rst new file mode 100644 index 00000000..63a5b510 --- /dev/null +++ b/docs/world_georeference.rst @@ -0,0 +1,31 @@ +.. _world-georeference: + +Georeference options +-------------------------------------------- + +For GNSS ("GPS") sensors to work, they need to know the transformation between +the simulator world local coordinates and the Earth. +This can be specified with a ```` tag as documented below. + + +.. code-block:: xml + :caption: Georeference example (Using geodetic coordinates) + + + ... + + + 36.894718 + -2.316988 + 100.0 + 0.0 + + ... + + + +- ``yy`` and ``xx``. Geodetic coordinates of the world (0,0,0) origin. + +- ``zz``: The height over the WGS84 ellipsoid for the world (0,0,0). + +- ``tt``: An optional rotation (in degrees) if you want North not to be aligned with +Y as it is the default.