vehicle

Добавьте транспортное средство в ведущий сценарий

Описание

vc = vehicle(scenario) добавляет Vehicle объект, vc, к ведущему сценарию, scenario. Транспортное средство имеет значения свойств по умолчанию.

Vehicles является специализированным типом кубоида агента объект, (имеющий форму поля), который имеет четыре колеса. Для получения дополнительной информации о том, как транспортные средства заданы, смотрите Агентов и Транспортные средства.

пример

vc = vehicle(scenario,Name,Value) свойства транспортного средства наборов с помощью одной или нескольких пар "имя-значение". Например, можно установить положение, скорость, размерности, ориентацию и колесную базу транспортного средства.

Примеры

свернуть все

Создайте ведущий сценарий, содержащий кривую дорогу, две дороги подряд и двух агентов: автомобиль и велосипед. Оба агента проходят дорога в течение 60 секунд.

Создайте ведущий объект сценария.

scenario = drivingScenario('SampleTime',0.1','StopTime',60);

Создайте кривую дорогу с помощью дорожных центральных точек после дуги круга с 800-метровым радиусом. Дуга запускается на уровне 0 °, заканчивается на уровне 90 ° и производится в шаге на 5 °.

angs = [0:5:90]';
R = 800;
roadcenters = R*[cosd(angs) sind(angs) zeros(size(angs))];
roadwidth = 10;
road(scenario,roadcenters,roadwidth);

Добавьте две дороги подряд с шириной по умолчанию, с помощью дорожных центральных точек в каждом конце.

roadcenters = [700 0 0; 100 0 0];
road(scenario,roadcenters)
roadcenters = [400 400 0; 0 0 0];
road(scenario,roadcenters)

Получите дорожные контуры.

rbdry = roadBoundaries(scenario);

Добавьте автомобиль и велосипед к сценарию. Расположите автомобиль в начале первой дороги подряд.

car = vehicle(scenario,'Position',[700 0 0],'Length',3,'Width',2,'Height',1.6);

Расположите велосипед дальше в будущем.

bicycle = actor(scenario,'Position',[706 376 0]','Length',2,'Width',0.45,'Height',1.5);

Постройте сценарий.

plot(scenario,'Centerline','on','RoadCenters','on');
title('Scenario');

Отобразите положения агента и профили.

poses = actorPoses(scenario)
poses=2×1 struct array with fields:
    ActorID
    Position
    Velocity
    Roll
    Pitch
    Yaw
    AngularVelocity

profiles = actorProfiles(scenario)
profiles=2×1 struct array with fields:
    ActorID
    ClassID
    Length
    Width
    Height
    OriginOffset
    MeshVertices
    MeshFaces
    RCSPattern
    RCSAzimuthAngles
    RCSElevationAngles

Входные параметры

свернуть все

Ведущий сценарий в виде drivingScenario объект.

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: vehicle('Length',2.2,'Width',0.6,'Height',1.5) создает транспортное средство с размерностями мотоцикла. Модули исчисляются в метрах.

Идентификатор классификации агента в виде разделенной запятой пары, состоящей из 'ClassID' и неотрицательное целое число.

Задайте ClassID значения, чтобы группироваться агенты, которые имеют подобные размерности, шаблоны радарного поперечного сечения (RCS) или другие свойства. Как лучшая практика, перед добавляющими агентами к drivingScenario возразите, определите систему классификации агента, которую вы хотите использовать. Затем при создании агентов задайте ClassID пара "имя-значение", чтобы установить идентификаторы классификации согласно схеме.

Предположим, что вы хотите создать сценарий, содержащий этих агентов:

  • Два автомобиля, один из которых является автомобилем, оборудованным датчиком

  • Грузовик

  • Велосипед

Код показывает демонстрационную систему классификации для этого сценария, где 1 относится к автомобилям, 2 относится к грузовикам и 3 относится к велосипедам. Автомобили имеют свойства транспортного средства по умолчанию. Грузовик и велосипед имеют размерности типичного грузовика и велосипеда, соответственно.

scenario = drivingScenario;
ego = vehicle(scenario,'ClassID',1);
car = vehicle(scenario,'ClassID',1);
truck = vehicle(scenario,'ClassID',2,'Length',8.2,'Width',2.5,'Height',3.5);
bicycle = actor(scenario,'ClassID',3,'Length',1.7,'Width',0.45,'Height',1.7);

ClassID по умолчанию из 0 резервируется для объекта неизвестного или неприсвоенного класса. Если вы планируете импортировать drivingScenario объекты в приложение Driving Scenario Designer, не оставляйте ClassID свойство набора агентов к 0. Приложение не распознает ClassID из 0 для агентов и возвращает ошибку. Вместо этого установите ClassID значения агентов согласно системе классификации агента используются в приложении.

ClassIDClassName
1Автомобиль
2Грузовик
3Велосипед
4Пешеход
5Барьер

Расширенная объектная mesh в виде extendedObjectMesh объект.

Цвет отображения транспортного средства в виде разделенной запятой пары, состоящей из 'PlotColor' и триплет RGB, шестнадцатеричный цветовой код, название цвета или короткое название цвета.

Транспортное средство появляется в заданном, раскрашивают всю программируемую визуализацию сценария, включая plot функция, chasePlot функция и функции построения графика birdsEyePlot объекты. Если вы импортируете сценарий в приложение Driving Scenario Designer, то транспортное средство появляется в этом, раскрашивают всю визуализацию приложения. Если вы импортируете сценарий в Simulink®, то транспортное средство появляется в этом, раскрашивают Bird's-Eye Scope.

Если вы не задаете цвет для транспортного средства, функция присваивает один на основе порядка цвета по умолчанию Axes объекты. Для получения дополнительной информации смотрите ColorOrder свойство для Axes объекты.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое названиеТриплет RGBШестнадцатеричный цветовой кодВнешний вид
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB® во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешний вид
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Позиция вращательного центра транспортного средства в виде разделенной запятой пары, состоящей из 'Position' и [x y z] вектор с действительным знаком.

Вращательный центр транспортного средства является средней точкой своей задней оси. Транспортное средство расширяет назад расстоянием, равным заднему нависающему краю. Транспортное средство расширяет вперед расстояние, равное сумме колесной базы и прямого нависающего края. Модули исчисляются в метрах.

Пример: [10;50;0]

Скорость (v) транспортного средства сосредотачивается в x - y - и z - направления в виде разделенной запятой пары, состоящей из 'Velocity' и [v x v y v z] вектор с действительным знаком. 'Position' пара "имя-значение" задает центр транспортного средства. Модули исчисляются в метрах в секунду.

Пример: [-4;7;10]

Угол отклонения от курса транспортного средства в виде разделенной запятой пары, состоящей из 'Yaw' и действительный скаляр. Yaw является углом вращения транспортного средства вокруг z - ось и положителен в направлении по часовой стрелке. Угловые значения перенесены к области значений [–180, 180]. Модули в градусах.

Пример: -0.4

Передайте угол транспортного средства в виде разделенной запятой пары, состоящей из 'Pitch' и действительный скаляр. Pitch является углом вращения транспортного средства вокруг y - ось и положителен в направлении по часовой стрелке. Угловые значения перенесены к области значений [–180, 180]. Модули в градусах.

Пример: 5.8

Угол вращения транспортного средства в виде разделенной запятой пары, состоящей из 'Roll' и действительный скаляр. Roll является углом вращения транспортного средства вокруг x - ось и положителен в направлении по часовой стрелке. Угловые значения перенесены к области значений [–180, 180]. Модули в градусах.

Пример: -10

Скорость вращения (ω) транспортного средства, в мировых координатах в виде разделенной запятой пары, состоящей из 'AngularVelocity' и [ω x ω y ω z] вектор с действительным знаком. Модули в градусах в секунду.

Пример: [20 40 20]

Длина транспортного средства в виде разделенной запятой пары, состоящей из 'Length' и положительный действительный скаляр. Модули исчисляются в метрах.

Пример: 5.5

Ширина транспортного средства в виде разделенной запятой пары, состоящей из 'Width' и положительный действительный скаляр. Модули исчисляются в метрах.

Пример: 2.0

Высота транспортного средства в виде разделенной запятой пары, состоящей из 'Height' и положительный действительный скаляр. Модули исчисляются в метрах.

Пример: 2.1

Шаблон радарного поперечного сечения (RCS) транспортного средства в виде разделенной запятой пары, состоящей из 'RCSPattern' и Q-by-P матрица с действительным знаком. RCS является функцией азимута и углов вертикального изменения, где:

  • Q является количеством углов вертикального изменения, заданных 'RCSElevationAngles' пара "имя-значение".

  • P является количеством углов азимута, заданных 'RCSAzimuthAngles' пара "имя-значение".

Модули находятся в децибелах на квадратный метр (dBsm).

Пример: 5.8

Углы азимута шаблона транспортного средства RCS в виде разделенной запятой пары, состоящей из 'RCSAzimuthAngles' и P - элемент вектор с действительным знаком. P является количеством углов азимута. Значения находятся в области значений [-180 °, 180 °].

Каждый элемент RCSAzimuthAngles задает угол азимута соответствующего столбца 'RCSPattern' пара "имя-значение". Модули в градусах.

Пример: [-90:90]

Углы вертикального изменения шаблона транспортного средства RCS в виде разделенной запятой пары, состоящей из 'RCSElevationAngles' и Q - элемент вектор с действительным знаком. Q является количеством углов вертикального изменения. Значения находятся в области значений [-90 °, 90 °].

Каждый элемент RCSElevationAngles задает угол вертикального изменения соответствующей строки 'RCSPattern' пара "имя-значение". Модули в градусах.

Пример: [0:90]

Передний нависающий край транспортного средства в виде разделенной запятой пары, состоящей из 'FrontOverhang' и действительный скаляр. Передний нависающий край является расстоянием, которое транспортное средство расширяет вне передней оси. Если транспортное средство не расширяет мимо передней оси, то передний нависающий край отрицателен. Модули исчисляются в метрах.

Пример: 0.37

Задний нависающий край транспортного средства в виде разделенной запятой пары, состоящей из 'RearOverhang' и действительный скаляр. Задний нависающий край является расстоянием, которое транспортное средство расширяет вне задней оси. Если транспортное средство не расширяет мимо задней оси, то задний нависающий край отрицателен. Отрицательный задний нависающий край распространен в грузовиках полуприцепа, где такси грузовика не нависает над задним колесом. Модули исчисляются в метрах.

Пример: 0.32

Расстояние между передними и задними осями транспортного средства в виде разделенной запятой пары, состоящей из 'Wheelbase' и положительный действительный скаляр. Модули исчисляются в метрах.

Пример: 1.51

Выходные аргументы

свернуть все

Ведущее транспортное средство сценария, возвращенное как Vehicle объект, принадлежащий ведущему сценарию, задан в scenario.

Можно изменить Vehicle объект путем изменения его значений свойств. Имена свойства соответствуют аргументам пары "имя-значение", используемым, чтобы создать объект.

Единственным свойством, которое вы не можете изменить, является ActorID, который является положительным целым числом, указывающим на уникальный, заданный сценарием ID транспортного средства.

Чтобы задать и визуализировать движение транспортного средства, используйте эти функции:

trajectory

Создайте агента или траекторию транспортного средства в ведущем сценарии

chasePlot

Эгоцентрический проективный перспективный график

Чтобы получить информацию о характеристиках транспортного средства, используйте эти функции:

actorPoses

Положения, скорости и ориентации агентов в ведущем сценарии

actorProfiles

Физический и радарные характеристики агентов в ведущем сценарии

targetOutlines

Основы целей просматриваются агентом

targetPoses

Целевые положения и ориентации относительно автомобиля, оборудованного датчиком

driving.scenario.targetsToEgo

Преобразуйте целевые положения агента от мировых координат сценария к координатам автомобиля, оборудованного датчиком

driving.scenario.targetsToScenario

Преобразуйте целевые положения агента от координат автомобиля, оборудованного датчиком до мировых координат сценария

Чтобы получить информацию о дорогах и маршрутах, что транспортное средство включено, используйте эти функции:

roadBoundaries

Получите дорожные контуры

driving.scenario.roadBoundariesToEgo

Преобразуйте дорожные контуры в координаты автомобиля, оборудованного датчиком

currentLane

Получите текущий маршрут агента

laneBoundaries

Получите контуры маршрута маршрута агента

laneMarkingVertices

Вершины маркировки маршрута и поверхности в ведущем сценарии

roadMesh

Поймайте в сети представление самых близких дорог агента в ведущем сценарии.

Больше о

свернуть все

Агенты и транспортные средства

В ведущих сценариях actor является кубоидом объект, (имеющий форму поля) с определенной длиной, шириной и высотой. Агенты также имеют шаблон радарного поперечного сечения (RCS), заданный в dBsm, который можно совершенствовать путем установки углового азимута и координат вертикального изменения. Положение агента задано как центр его нижней поверхности. Эта центральная точка используется в качестве вращательного центра агента, его точки контакта с землей и его источника в его системе локальной координаты. В этой системе координат:

  • X - ось указывает вперед от агента.

  • Y - точки оси, оставленные от агента.

  • Z - ось подчеркивает от земли.

Прокрутитесь, сделайте подачу, и отклонение от курса по часовой стрелке положительно при взгляде в прямом направлении X - Y - и Z - оси, соответственно.

vehicle является агентом, который перемещается в колеса. Транспортные средства имеют три дополнительных свойства, которые управляют размещением их передней и задней оси.

  • Wheelbase — Расстояние между передними и задними осями

  • Front overhang — Расстояние между передней стороной транспортного средства и передней осью

  • Rear overhang — Расстояние между задней осью и задней частью транспортного средства

В отличие от других типов агентов, положение транспортного средства задано точкой на том основании, что ниже центра ее задней оси. Эта точка соответствует естественному центру вращения транспортного средства. Как с агентами нетранспортного средства, эта точка является источником в системе локальной координаты транспортного средства, где:

  • X - ось указывает вперед от транспортного средства.

  • Y - точки оси, оставленные от транспортного средства.

  • Z - ось подчеркивает от земли.

Прокрутитесь, сделайте подачу, и отклонение от курса по часовой стрелке положительно при взгляде в прямом направлении X - Y - и Z - оси, соответственно.

Эта таблица показывает список общих агентов и их размерностей. Задавать эти значения в Actor и Vehicle объекты, набор соответствующие показанные свойства.

Классификация агентовОбъект агентаСвойства агента
LengthWidthHeightFrontOverhangRearOverhangWheelbaseRCSPattern
ПешеходActor0,24 м0,45 м1,7 мНет данныхНет данныхНет данных– 8 dBsm
АвтомобильVehicle4,7 м1,8 м1,4 м0,9 м1,0 м2,8 м10 dBsm
МотоциклVehicle2,2 м0,6 м1,5 м0,37 м0,32 м1,51 м0 dBsm

Введенный в R2017a

Для просмотра документации необходимо авторизоваться на сайте