Google Git
Sign in
eclipse / www.eclipse.org / simopenpass / 1f067c381a9cf3fa2b6956b5bf2583326ac857d0 / . / content / html / user_guide / sim_user_guide / components / vehicle.html
blob: 52c603e970d777787dd221eba4eeb8c3d3c14c13 [file] [log] [blame]
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>VehicleComponents &mdash; OpenPASS Documentation</title>
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<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/tabs.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/custom.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 type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
<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 type="text/javascript" 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="Basic Example" href="../examples/basic.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">
9999.9999.9999
</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="main navigation">
<p class="caption"><span class="caption-text">Installation Guides</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/10_gui_installation_guide.html">GUI Installation Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/20_sim_installation_guide.html">Simulation Installation Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../installation_guide/21_pcm_installation_guide.html">PCM Installation Guide</a></li>
</ul>
<p class="caption"><span class="caption-text">User Guides</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../10_gui_user_guide.html">GUI User Guide</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../20_sim_user_guide.html">Simulation User Guide</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../../20_sim_user_guide.html#intended-audience">Intended Audience</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../20_sim_user_guide.html#primer">Primer</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../20_sim_user_guide.html#inputs-in-depth">Inputs in Depth</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../20_sim_user_guide.html#outputs-in-depth">Outputs in Depth</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../../20_sim_user_guide.html#components-in-depth">Components in Depth</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="driver.html">Driver</a></li>
<li class="toctree-l3"><a class="reference internal" href="spawner.html">Spawner</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">VehicleComponents</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#aeb">AEB</a></li>
<li class="toctree-l4"><a class="reference internal" href="#dynamicstrajectoryfollower">DynamicsTrajectoryFollower</a></li>
<li class="toctree-l4"><a class="reference internal" href="#sensorgeometric2d">SensorGeometric2D</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../20_sim_user_guide.html#use-cases-examples">Use Cases Examples</a></li>
</ul>
</li>
</ul>
<p class="caption"><span class="caption-text">Advanced topics</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../advanced_topics/10_documentation.html">Documentation Concept</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../advanced_topics/20_simulator_advanced.html">Simulator</a></li>
</ul>
<p class="caption"><span class="caption-text">Other Information</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../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="top navigation">
<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="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="../../20_sim_user_guide.html">Simulation User Guide</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">
<div class="section" id="vehiclecomponents">
<span id="components-vehiclecomponents"></span><h1>VehicleComponents<a class="headerlink" href="#vehiclecomponents" title="Permalink to this headline"></a></h1>
<div class="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>
</div>
<div class="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>
</div>
<div class="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="../input/profilescatalog.html#profilescatalog-vehicleprofiles"><span class="std std-ref">VehicleProfiles</span></a>.</p>
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../examples/basic.html" class="btn btn-neutral float-right" title="Basic Example" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
<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>
</div>
<hr/>
<div role="contentinfo">
<p>
&#169; Copyright 2021 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 type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>