blob: acba301b03d0349a784734dcb6532ab22c806068 [file] [log] [blame]
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>VehicleComponents &mdash; OpenPASS Documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
<link rel="shortcut icon" href="../../../_static/openPASS.ico"/>
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
<script src="../../../_static/jquery.js"></script>
<script src="../../../_static/underscore.js"></script>
<script src="../../../_static/doctools.js"></script>
<script src="../../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
<link rel="next" title="Simulator" href="../../../advanced_topics/20_simulator_advanced.html" />
<link rel="prev" title="Spawner" href="spawner.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../../index.html" class="icon icon-home"> openPASS
<img src="../../../_static/openPASS.png" class="logo" alt="Logo"/>
</a>
<div class="version">
0.9.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">Installation Guide</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/10_getting_started.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/20_install_prerequisites.html">Installing Prerequisites</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/30_install_openpass.html">Installing OpenPASS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/50_further_guidance.html">Further Guidance</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/60_conan.html">Building with Conan</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">User Guides</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../10_overview.html">Overview</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../20_tutorials.html">Tutorials</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../30_gui_plugins.html">GUI Plugins</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../40_configs_in_depth.html">Configs in Depth</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../50_outputs_in_depth.html">Outputs in Depth</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../60_scenario_simulation.html">Simulator</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../10_overview.html">Overview</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../20_components.html">Component View</a><ul class="current">
<li class="toctree-l3 current"><a class="reference internal" href="../20_components.html#components-in-depth">Components in Depth</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="driver.html">Driver</a></li>
<li class="toctree-l4"><a class="reference internal" href="spawner.html">Spawner</a></li>
<li class="toctree-l4 current"><a class="current reference internal" href="#">VehicleComponents</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Advanced topics</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../advanced_topics/20_simulator_advanced.html">Simulator</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../advanced_topics/30_testing.html">EndToEnd Test Framework</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Developer Information</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../developer_information/10_ide_support.html">IDE Support</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer_information/20_documentation.html">Documentation Concept</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Other Information</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../other_information/10_external_dependencies.html">External Dependencies</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../other_information/20_glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../other_information/30_license.html">License</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../../index.html">openPASS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="../../60_scenario_simulation.html">Simulator</a> &raquo;</li>
<li><a href="../20_components.html">Component View</a> &raquo;</li>
<li>VehicleComponents</li>
<li class="wy-breadcrumbs-aside">
<a href="../../../_sources/user_guide/sim_user_guide/components/vehicle.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="vehiclecomponents">
<span id="components-vehiclecomponents"></span><h1>VehicleComponents<a class="headerlink" href="#vehiclecomponents" title="Permalink to this headline"></a></h1>
<section id="aeb">
<span id="components-aeb"></span><h2>AEB<a class="headerlink" href="#aeb" title="Permalink to this headline"></a></h2>
<p>The Autonomous Emergency Braking system checks if a collision is likely to occur in the near future and, if necessary, brakes to avoid the collision.
In each timestep, the system evaluates all objects detected by a Sensor and calculates the time to collision (TTC) for this object based on the perceived movement of the object.
If, for any object, the TTC is lower than the threshold of the component, then the component gets activated. The system deactivates if the TTC is larger than 1,5 times the threshold of the component.</p>
<table class="tight-table docutils align-default">
<colgroup>
<col style="width: 29%" />
<col style="width: 5%" />
<col style="width: 3%" />
<col style="width: 63%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Attribute</p></th>
<th class="head"><p>Type</p></th>
<th class="head"><p>Unit</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>CollisionDetectionLongitudinalBoundary</p></td>
<td><p>Double</p></td>
<td><p>m</p></td>
<td><p>Additional length added the vehicle boundary when checking for collision detection</p></td>
</tr>
<tr class="row-odd"><td><p>CollisionDetectionLateralBoundary</p></td>
<td><p>Double</p></td>
<td><p>m</p></td>
<td><p>Additional width added the vehicle boundary when checking for collision detection</p></td>
</tr>
<tr class="row-even"><td><p>TTC</p></td>
<td><p>Double</p></td>
<td><p>s</p></td>
<td><p>Time to collision which is used to trigger AEB</p></td>
</tr>
<tr class="row-odd"><td><p>Acceleration</p></td>
<td><p>Double</p></td>
<td><p>m/s²</p></td>
<td><p>Braking acceleration when activated</p></td>
</tr>
</tbody>
</table>
<div class="highlight-xml notranslate"><div class="highlight"><pre><span></span><span class="nt">&lt;ProfileGroup</span> <span class="na">Type=</span><span class="s">&quot;AEB&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Profile</span> <span class="na">Type=</span><span class="s">&quot;AEB&quot;</span> <span class="na">Name=</span><span class="s">&quot;AEB1&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;CollisionDetectionLongitudinalBoundary&quot;</span> <span class="na">Value=</span><span class="s">&quot;4.0&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;CollisionDetectionLateralBoundary&quot;</span> <span class="na">Value=</span><span class="s">&quot;1.5&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;TTC&quot;</span> <span class="na">Value=</span><span class="s">&quot;2.0&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;Acceleration&quot;</span> <span class="na">Value=</span><span class="s">&quot;-2&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;/Profile&gt;</span>
...
<span class="nt">&lt;/ProfileGroup&gt;</span>
</pre></div>
</div>
</section>
<section id="dynamicstrajectoryfollower">
<span id="components-trajectoryfollower"></span><h2>DynamicsTrajectoryFollower<a class="headerlink" href="#dynamicstrajectoryfollower" title="Permalink to this headline"></a></h2>
<p>This module forces agents to drive according to a specific trajectory. The trajectory is defined in the scenario. This module is disabled by default and is activated if a trajectory from openSCENARIO is triggered.
It is always important that the trajectories matches the current scenery file, otherwise the Agent could be placed outside of valid lanes. If the agent gets placed on a invalid position, it will be deleted.</p>
<p>All attributes are required.</p>
<table class="tight-table docutils align-default">
<colgroup>
<col style="width: 15%" />
<col style="width: 3%" />
<col style="width: 83%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Attribute</p></th>
<th class="head"><p>Type</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>AutomaticDeactivation</p></td>
<td><p>Bool</p></td>
<td><p>If true, the trajectory follower relinquishes control of the vehicle after the final instruction in the TrajectoryFile.</p></td>
</tr>
<tr class="row-odd"><td><p>EnforceTrajectory</p></td>
<td><p>Bool</p></td>
<td><p>If true, the trajectory follower overrides external input related to the vehicle’s travel.</p></td>
</tr>
</tbody>
</table>
<div class="highlight-xml notranslate"><div class="highlight"><pre><span></span><span class="nt">&lt;ProfileGroup</span> <span class="na">Type=</span><span class="s">&quot;DynamicsTrajectoryFollower&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Profile</span> <span class="na">Name=</span><span class="s">&quot;BasicTrajectoryFollower&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Bool</span> <span class="na">Key=</span><span class="s">&quot;AutomaticDeactivation&quot;</span> <span class="na">Value=</span><span class="s">&quot;true&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Bool</span> <span class="na">Key=</span><span class="s">&quot;EnforceTrajectory&quot;</span> <span class="na">Value=</span><span class="s">&quot;true&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;/Profile&gt;</span>
<span class="nt">&lt;/ProfileGroup&gt;</span>
</pre></div>
</div>
</section>
<section id="sensorgeometric2d">
<span id="components-geometric2d"></span><h2>SensorGeometric2D<a class="headerlink" href="#sensorgeometric2d" title="Permalink to this headline"></a></h2>
<p>This sensor is selected, when a sensor is parameterized as ProfileGroup “Geometric2D”.</p>
<table class="tight-table docutils align-default">
<colgroup>
<col style="width: 22%" />
<col style="width: 4%" />
<col style="width: 3%" />
<col style="width: 71%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
<th class="head"><p>Type</p></th>
<th class="head"><p>Unit</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>DetectionRange</p></td>
<td><p>Double</p></td>
<td><p>m</p></td>
<td><p>Detection range</p></td>
</tr>
<tr class="row-odd"><td><p>EnableVisualObstruction</p></td>
<td><p>Bool</p></td>
<td></td>
<td><p>Activates 2D sensor obstruction calculation</p></td>
</tr>
<tr class="row-even"><td><p>FailureProbability</p></td>
<td><p>Double</p></td>
<td></td>
<td><p>Probability of an object detection failure</p></td>
</tr>
<tr class="row-odd"><td><p>Latency</p></td>
<td><p>Double</p></td>
<td><p>s</p></td>
<td><p>Sensor latency</p></td>
</tr>
<tr class="row-even"><td><p>OpeningAngleH</p></td>
<td><p>Double</p></td>
<td><p>rad</p></td>
<td><p>Horizontal opening angle</p></td>
</tr>
<tr class="row-odd"><td><p>RequiredPercentageOfVisibleArea</p></td>
<td><p>Double</p></td>
<td></td>
<td><p>Required percentage of an object within the sensor cone to trigger a detection</p></td>
</tr>
</tbody>
</table>
<div class="highlight-xml notranslate"><div class="highlight"><pre><span></span><span class="nt">&lt;ProfileGroup</span> <span class="na">Type=</span><span class="s">&quot;Geometric2D&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Profile</span> <span class="na">Name=</span><span class="s">&quot;Standard&quot;</span><span class="nt">&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;DetectionRange&quot;</span> <span class="na">Value=</span><span class="s">&quot;300&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Bool</span> <span class="na">Key=</span><span class="s">&quot;EnableVisualObstruction&quot;</span> <span class="na">Value=</span><span class="s">&quot;false&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;FailureProbability&quot;</span> <span class="na">Value=</span><span class="s">&quot;0&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;NormalDistribution</span> <span class="na">Key=</span><span class="s">&quot;Latency&quot;</span> <span class="na">Max=</span><span class="s">&quot;0.0&quot;</span> <span class="na">Mean=</span><span class="s">&quot;0.0&quot;</span> <span class="na">Min=</span><span class="s">&quot;0.0&quot;</span> <span class="na">SD=</span><span class="s">&quot;0.0&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;OpeningAngleH&quot;</span> <span class="na">Value=</span><span class="s">&quot;0.35&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;Double</span> <span class="na">Key=</span><span class="s">&quot;RequiredPercentageOfVisibleArea&quot;</span> <span class="na">Value=</span><span class="s">&quot;0.001&quot;</span><span class="nt">/&gt;</span>
<span class="nt">&lt;/Profile&gt;</span>
<span class="nt">&lt;/ProfileGroup&gt;</span>
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Sensors also need a mounting position, defined w.r.t. the coordinate system of the vehicle (center of rear axis).
See also <a class="reference internal" href="../../configs/profilescatalog.html#profilescatalog-vehicleprofiles"><span class="std std-ref">VehicleProfiles</span></a>.</p>
</div>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="spawner.html" class="btn btn-neutral float-left" title="Spawner" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="../../../advanced_topics/20_simulator_advanced.html" class="btn btn-neutral float-right" title="Simulator" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2022 OpenPASS Working Group.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>