Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

dynamicCapsuleList

Liste d'obstacles dynamique basée sur des capsules

Depuis R2020b

Description

L'objet dynamicCapsuleList gère deux listes d'objets de collision basés sur des capsules dans un espace 2D. Les objets de collision sont séparés en deux listes, les corps du moi et les obstacles. Pour les corps de l'ego et les obstacles en 3D, voir l'objet dynamicCapsuleList3D .

Chaque objet de collision dans les deux listes comporte trois éléments clés :

• ID –– Entier qui identifie chaque objet, stocké dans la propriété EgoIDs pour les corps de l'ego et dans la propriété ObstacleIDs pour les obstacles.

• États –– Localisation et orientation de l'objet sous forme d'une matrice M-par 3, où chaque ligne est de la forme [x y theta] et M est le nombre d'états le long du chemin de l'objet dans le cadre du monde. La liste des états suppose que chaque état est séparé par un intervalle de temps fixe. xy-les positions sont en mètres, et theta est en radians. L'origine locale par défaut est située au centre du demi-cercle gauche de la capsule.

• Géométrie –– Taille de l'objet basé sur la capsule en fonction d'une longueur et d'un rayon spécifiés. Le rayon s'applique aux embouts du demi-cercle et la longueur s'applique à la longueur du rectangle central. Pour décaler la géométrie de la capsule et l'origine locale par rapport au point d'origine par défaut, spécifiez une transformation fixe par rapport au cadre local de la capsule.

Utilisez les fonctions d'objet pour ajouter, supprimer et mettre à jour dynamiquement les géométries et les états des différents objets de votre environnement. Pour ajouter un corps d'ego, consultez la fonction objet addEgo . Pour ajouter un obstacle, voir la fonction objet addObstacle .

Après avoir spécifié tous les états des objets, validez les chemins du corps de l'ego et vérifiez les collisions avec des obstacles à chaque étape à l'aide de la fonction objet checkCollision . La fonction vérifie uniquement si un corps du moi entre en collision avec un obstacle, ignorant les collisions entre uniquement des obstacles ou uniquement des corps du moi.

Création

Syntaxe

obstacleList = dynamicCapsuleList

Description

obstacleList = dynamicCapsuleList crée une liste d'obstacles dynamique basée sur des capsules sans corps ni obstacles d'ego. Pour commencer à créer une liste d'obstacles, utilisez les fonctions d'objet addEgo ou addObstacle .

Propriétés

MaxNumSteps — Nombre maximum de pas de temps dans la liste d'obstacles

31 (par défaut) | entier positif

Nombre maximum de pas de temps dans la liste d'obstacles, spécifié sous forme d'entier positif. Le nombre d'étapes détermine la longueur maximale du champ States pour un corps ou un obstacle spécifique de l'ego.

Types de données : double

EgoIDs — Liste des identifiants pour les corps de l'ego

vecteur d'entiers positifs

Ce propriété est en lecture seule.

Liste d'identifiants pour les corps du moi, renvoyés sous forme de vecteur d'entiers positifs.

Types de données : double

ObstacleIDs — ID des obstacles

vecteur d'entiers positifs

Ce propriété est en lecture seule.

Liste d'identifiants d'obstacles, renvoyés sous forme de vecteur d'entiers positifs.

Types de données : double

NumObstacles — Nombre d'obstacles dans la liste

entier

Ce propriété est en lecture seule.

Nombre d'obstacles dans la liste, renvoyé sous forme d'entier.

Types de données : double

NumEgos — Nombre de corps du moi dans la liste

entier

Ce propriété est en lecture seule.

Nombre de corps du moi dans la liste, renvoyé sous forme d'entier.

Types de données : double

Fonctions d'objet

addEgo	Ajouter les corps de l'ego à la liste des capsules
addObstacle	Add obstacles to 2-D capsule list
checkCollision	Vérifier les collisions entre les corps de l'ego et les obstacles
egoGeometry	Propriétés géométriques des corps du moi
egoPose	Poses of ego bodies
obstacleGeometry	Propriétés géométriques des obstacles
obstaclePose	Poses d'obstacles
removeEgo	Supprimer les corps de l'ego de la liste des capsules
removeObstacle	Supprimer les obstacles de la liste des capsules
show	Afficher les corps de l'ego et les obstacles dans l'environnement
updateEgoGeometry	Mettre à jour les propriétés géométriques des corps du moi
updateEgoPose	Mettre à jour les états des corps du moi
updateObstacleGeometry	Mettre à jour les propriétés géométriques des obstacles
updateObstaclePose	Mettre à jour les états des obstacles

Exemples

Construisez des chemins corporels de l'ego et vérifiez les collisions avec des obstacles

Construisez un chemin corporel de l'ego et maintenez les états d'obstacles à l'aide de l'objet dynamicCapsuleList . Visualisez les états de tous les objets de l'environnement à différents horodatages. Validez le chemin du corps de l’ego en vérifiant les collisions avec des obstacles dans l’environnement.

Créez l'objet dynamicCapsuleList . Extrayez le nombre maximum d'étapes à utiliser comme nombre d'horodatages pour vos chemins d'objet.

obsList = dynamicCapsuleList;
numSteps = obsList.MaxNumSteps;

Ajouter un corps d'ego

Définissez un corps d'ego en spécifiant l'ID, la géométrie et l'état ensemble dans une structure. La géométrie de la capsule a une longueur de 3 m et un rayon de 1 m. Spécifiez l'état sous forme de chemin linéaire de x = 0m à x = 100m.

egoID1 = 1;
geom = struct("Length",3,"Radius",1,"FixedTransform",eye(3));
states = linspace(0,1,obsList.MaxNumSteps)'.*[100 0 0];

egoCapsule1 = struct('ID',egoID1,'States',states,'Geometry',geom);
addEgo(obsList,egoCapsule1);

show(obsList,"TimeStep",[1:numSteps]);
ylim([-20 20])

Ajouter des obstacles

Spécifiez les états de deux obstacles séparés du corps du moi de 5 m dans des directions opposées sur l'axe  y . Supposons que les obstacles ont la même géométrie geom que le corps de l'ego.

obsState1 = states + [0 5 0];
obsState2 = states + [0 -5 0];

obsCapsule1 = struct('ID',1,'States',obsState1,'Geometry',geom);
obsCapsule2 = struct('ID',2,'States',obsState2,'Geometry',geom);

addObstacle(obsList,obsCapsule1);
addObstacle(obsList,obsCapsule2);

show(obsList,"TimeStep",[1:numSteps]);
ylim([-20 20])

Mettre à jour les obstacles

Modifiez l'emplacement de vos obstacles et les dimensions géométriques au fil du temps. Utilisez la structure générée précédemment, modifiez les champs et mettez à jour les obstacles à l'aide des fonctions objets updateObstacleGeometry et updateObstaclePose . Réduit le rayon du premier obstacle à 0,5 m et modifie le chemin pour le déplacer vers le corps de l'ego.

obsCapsule1.Geometry.Radius = 0.5;

obsCapsule1.States = ...
    [linspace(0,100,numSteps)' ... % x
     linspace(5,-4,numSteps)' ... % y 
     zeros(numSteps,1)]; % theta

updateObstacleGeometry(obsList,1,obsCapsule1);
updateObstaclePose(obsList,1,obsCapsule1);

Vérifier les collisions

Visualisez les nouveaux chemins. Montrer où se situent les collisions entre le corps de l'ego et un obstacle, que l'écran met en évidence en rouge. Notez que les collisions entre les obstacles ne sont pas vérifiées.

show(obsList,"TimeStep",[1:numSteps],"ShowCollisions",1);
ylim([-20 20])
xlabel("X (m)")
ylabel("Y (m)")

Vérifiez par programme les collisions à l'aide de la fonction objet checkCollision . La fonction renvoie un vecteur de valeurs logiques qui indique l'état de chaque pas de temps. Le vecteur est transposé à des fins d'affichage.

collisions = checkCollision(obsList)'

collisions = 1x31 logical array

   0   0   0   0   0   0   0   0   0   0   0   0   1   1   1   1   1   1   1   1   1   1   0   0   0   0   0   0   0   0   0

Pour valider des chemins avec un grand nombre d'étapes, utilisez la fonction any sur le vecteur des valeurs de collision.

if any(collisions)
    disp("Collision detected.")
end

Collision detected.

Mettre à jour le chemin de l'ego

Spécifiez un nouveau chemin pour le corps de l’ego. Visualisez à nouveau les chemins, affichant les collisions.

egoCapsule1.States = ...
    [linspace(0,100,numSteps)' ... % x
    3*sin(linspace(0,2*pi,numSteps))' ... % y
    zeros(numSteps,1)]; % theta

updateEgoPose(obsList,1,egoCapsule1);

show(obsList,"TimeStep",[1:numSteps],"ShowCollisions",1);
ylim([-20 20])

Capacités étendues

Génération de code C/C++
Générez du code C et C++ avec MATLAB® Coder™.

Historique des versions

Introduit dans R2020b

Voir aussi

Objets

• dynamicCapsuleList3D

Fonctions

• addEgo | addObstacle | checkCollision | egoGeometry | egoPose | obstacleGeometry | obstaclePose | removeEgo | removeObstacle | show | updateEgoGeometry | updateEgoPose | updateObstacleGeometry | updateObstaclePose

Rubriques

• Highway Trajectory Planning Using Frenet Reference Path