DE
Offizielle Bedienungsanleitung

PyBullet Physics Engine

66 Seiten·1.5 MB·Software·PDF·ENDEFRITNLJA
PyBullet Physics Engine
Inhaltsverzeichnis 76 Abschnitte PyBullet Quickstart Guide · Einleitung · Hallo PyBullet World · Einschalten, Trennen · … AnzeigenAusblenden
PyBullet Quickstart Guidep.1Einleitungp.2Hallo PyBullet Worldp.3Einschalten, Trennenp.3Server bieten OpenGL Debug-Visualisierung. Verbindung mit DIRECT, GUIp.4setGravityp.6loadURDF,loadSDF, loadMJCFp.7saveWorldp.9saveState, saveBullet, restoreStatep.9createCollisionShape/VisualShapep.10createMultiBodyp.12stepSimulationp.13setRealTimeSimulationp.14getBasePositionAndOrientierungp.14resetBasePositionAndOrientierungp.15Transformationen: Position und Orientierungp.15getEulerFromQuaternionp.16getAPIVersionp.17Steuerung eines Robotersp.17Basis, Gelenke, Linksp.17getNumJoints, getJointInfop.18getNumJoints gibt einen ganzzahligen Wert zurück, der die Anzahl von Joints darstellt. getJointInfop.18setJointMotorControl2/Arrayp.19getJointState(s), resetJointStatp.21enableJointForceTorqueSensorp.22getLinkStatep.23getBaseVelocity, resetBase Velocitiesp.25Externe Kraft/Torquep.25getNumBodies, getBodyInfo, get BodyUniqueId, removeBodyp.26createConstraint, removeConstract, changeConsTRAINp.26getNumConstraints, getConstrainingUniqueIdp.28getConstraintInfo/Staatp.28getConstraintStatep.29getDynamicsInfo/changeDynamikp.29changeDynamics Ubersetzungenp.30setTimeStepp.31setPhysicsEngineParameterp.31resetSimulationp.32startStateLogging/stopStateloggingp.33Synthetische Kamera-Renderingp.35computeViewMatrixp.35computeProjectionMatrixp.36getCameraImagep.36getVisualShapeDatap.38changeVisualShape, loadTexturep.39loadTexturp.39Kollisionserkennungsabfragenp.40getOverlappingObjects, getAABBp.40Die getOverlappingObjects geben eine Liste von Objekt-Unique IDs zurück. getAABBp.40getContactPoints, getClosestPointsp.41getClosestPointsp.41rayTest, RayTestBatchp.42rayTestBatchp.43getCollisionShapeDatap.43Inverse Dynamik, Kinematikp.44calculatInverseDynamicsp.44BerechnetJacobian, MassMatrixp.44berechnetMassenMatrixp.45calculatInverseKinematicsp.46Reinforcement Learning Gym Envsp.48Umgebungen und Datenp.48Trainieren und Genießen: DQN, PPO, ESp.51Virtuelle Realitätp.54getVREvents,setVRCameraStatep.54Debug GUI, Zeilen, Text, Parameterp.56addUserDebugLine, Textp.56addUserDebugParameterp.57Der Rückgabewert ist der aktuellste Wert des Parameters. removeUserDebugItem/Allp.58removeAllUserDebugItemsp.58setDebugObjectColorp.58configurationDebugVisualizerp.59get/resetDebugVisualizerCamerap.59getKeyboardEvents, getMouseEventsp.60Bauen und installieren Sie PyBulletp.61Verwenden von Python Pipp.62Support, Tipps, Citationp.64
Page 1 of the PyBullet Physics Engine user manual — PyBullet Quickstart Guide
Seite 1 · Zum Vergrößern klicken
Seite 1

PyBullet Quickstart Guide

Synthetische Kamera-Rendering 35

Erwin Coumans, Yunfei Bai, 2017/2018

Besuchen Sie die Foren.

Hello PyBullet World 3

Kollisionserkennungsabfragen 39

loadURDF,loadSDF, loadMJCF 7

saveState, SaveBullet, restoreState 9

Inverse Dynamik, Kinematik 44

TransformsPosition und Orientierung 15

Reinforcement Learning Gym Envs 47

Umgebungen und Daten 47

Steuerung eines Roboters 17

Trainieren und genießenDQN, PPO, ES 50

Basis, Gelenke, Glieder 17

Debug GUI, Zeilen, Text, Parameter 55

getNumBodies, getBodyInfo, get BodyUniqueId, removeBody 26

createConstraint, removeConstract, changeKonstrainte 26

Bauen und installieren Sie PyBullet 60

Support, Tipps, Citation 63

45 weitere Labels / Kurztext auf dieser Seite anzeigen
setPhysicsEngineParameter 31 · resetSimulation 32 · startStateLogging/stopStatelogging 33 · computeViewMatrix 35 · competeProjectionMatriX 36 · Einleitung 2 · getCameraImage 36 · getVisualShapeData 38 · connect, disconnect 3 · changeVisuelleForm, loadTexture 39 · setGravity 6 · getOverlappingObjects, getAABB 40 · saveWorld 9 · getContactPoints, GetClosestPoints 41 · rayTest, rayCheckBatch 42 · createCollisionShape/VisalShape 10 · getCollisationShapeDaten 43 · CreateMultiBody 12 · stepSimulation 13 · setRealTimeSimulierung 14 · calculatInverseDynamics 44 · calculatedJacobian, MassMatrix 44 · resetBasePositionAndOrientation 15 · CalculatInverseKinematics 46 · getAPIVersion 17 · Virtuelle Realität 53 · getNumJoints, getJointInfo 18 · getVREvents,setVRCameraState 53 · getJoultMotorControl2/Array 19 · getjointState(s), resetJointStat 21 · addUserDebugLine, Text 55 · enableJointForceTorqueSensor 22 · add UserDorqueParameter 56 · getLinkState 23 · getBaseVelocity, resetBase Velocities 25 · setDebuggObjectColor 57 · applyExternalForce/Torgue 25 · appliedDebggVisualizer 58 · get/resetDebiffVisuellerKamera 58 · GetKeyboardEvents und getMouseEvents 59 · getnNumConstraints,getConstrainingtUniqueId 28 · getConstractInfo/State 28 · GetDynamicsInfo / changeDynamices 29
Page 2 of the PyBullet Physics Engine user manual — Einleitung
Seite 2 · Zum Vergrößern klicken
Seite 2

Einleitung

PyBullet ist ein einfach zu bedienendes Python-Modul für Physiksimulationen in den Bereichen Robotik, Spiele, visuelle Effekte und maschinelles Lernen. Mit PyBullet können Sie artikulierte Körper aus URDF, SDF, MJCF und anderen Dateiformaten laden. PyBullet bietet eine Simulation der Vorwärtsdynamik, inverse Dynamikberechnungen, Vorwärts- und Inverskinematik sowie Kollisionserkennung und Strahlschnittabfragen. Das Bullet Physics SDK umfasst PyBullet-Roboterbeispiele wie ein simuliertes Minitaur-Viertel, Humanoiden mit TensorFlow-Inferenz und KUKA-Arme, die Objekte erfassen.

PyBullet Physics Engine — Einleitung diagram (page 2)
Abb. 1 · Einleitung
PyBullet Physics Engine — Einleitung diagram (page 2)
Abb. 2 · Einleitung
PyBullet Physics Engine — Einleitung diagram (page 2)
Abb. 3 · Einleitung

Neben der Physiksimulation gibt es Bindungen zum Rendering, mit einem CPU-Renderer (TinyRender) und OpenGL Visualisierung sowie Unterstützung für Virtual Reality Headsets wie HTC Vive und Oculus Rift. PyBullet hat auch die Funktionalität, um Kollisionserkennungsanfragen (Nähepunkte, überlappende Paare, Strahlschnitttest usw.) durchzuführen und Debug-Rendering hinzuzufügen (Debuglinien und Text). PyBullet hat plattformübergreifende integrierte Client-Server-Unterstützung für Shared Memory, UDP und TCP Networking. So können Sie PyBullet unter Linux mit einer Verbindung zu einem Windows VR-Server ausführen. PyBullet wickelt die neue Bullet C-API, das so konzipiert ist, dass es unabhängig von der zugrunde liegenden Physik Engine und Render-Engine ist, sodass wir leicht zu neueren Versionen von Bullet migrieren oder eine andere Physik-Engine oder Rendering-Engine verwenden können. Standardmäßig verwendet PyBullet die Bullet 2.x API auf der CPU. Wir werden Bullet 3.x, das auf GPU läuft, auch mit OpenCL aussetzen. Es gibt auch eine C++ API ähnlich wie PyBullet, siehe b3RobotSimulatorClientAPI . PyBullet kann problemlos mit TensorFlow und Frameworks wie OpenAI Gym verwendet werden. Forscher von Google Brain [ 1 , 2 , 3 ], X , Stanford AI Lab und OpenAI verwenden PyBullet / Bullet C-API. Die Installation von PyBullet ist so einfach wie (sudo) pip install Py Bullet (Python 2.x), pip3 installation Py Bullet. Dadurch werden das PyBullet-Modul sowie die Py Bullet envs Gym-Umgebungen freigelegt.

Page 3 of the PyBullet Physics Engine user manual — Einschalten, Trennen
Seite 3 · Zum Vergrößern klicken
Seite 3

Hallo PyBullet World

Hier ist ein PyBullet Einführungsskript, das wir Schritt für Schritt besprechen:

import pybullet als p import time import pysobil data physicsClient = p.connect(p.GUI)#oder p.DIRECT für die nichtgrafische Version p.setAdditionalSearchPath(pybullet data.getDataPath/) #optional p.etGravity(0,0,-10) planeId = p.loadURDF("plane.urdf") cubeStartPos = [0,O,1] cubeOrientation = p .getQuaternionFromEuler([0,0)0,00] boxId= p.ladourDF('r2d2.urdef",cubeStartePos, cubestartorientation) for i in range (10000): p.stepSimulation() time.sleep(1./240.) cubePos; cubeORn = p

Einschalten, Trennen

Nach dem Import des PyBullet-Moduls ist das erste, was zu tun ist, die "Verbindung" zur Physiksimulation. PyBullet ist auf eine Client-Server-gesteuerte API ausgerichtet, wobei ein Client Befehle sendet und ein Physikserver den Status zurückgibt. PyBullet hat einige eingebaute Physik-Server: DIRECT und GUI. Sowohl GUI- als auch DIRECT-Verbindungen werden die Physiksimulation und das Rendern im selben Prozess wie PyBullet ausführen. Beachten Sie, dass im DIRECT-Modus nicht auf die OpenGL und VR Hardwarefunktionen zugegriffen werden kann, wie in den Kapiteln "Virtual Reality" und "Debug GUI, Lines, Text, Parameters" beschrieben. Der DIRECT-Modus ermöglicht das Rendern von Bildern mit dem eingebauten Softwarerenderer über die 'getCameraImage' API. Dies kann nützlich sein, um Simulationen in der Cloud auf Servern ohne GPU auszuführen. Sie können Ihre eigenen Datendateien bereitstellen oder das Paket PyBullet data verwenden, das mit Py Bullet ausgeliefert wird. Importieren Sie dazu pybullet data und registrieren Sie das Verzeichnis mit pybullet.setAdditionalSearchPath(pybullet®data.getDataPath)). getConnectionInfo

Wenn eine physicsClientId die Liste zurückgibt [isConnected, connectionMethod]

Page 4 of the PyBullet Physics Engine user manual — Server bieten OpenGL Debug-Visualisierung. Verbindung mit DIRECT, GUI
Seite 4 · Zum Vergrößern klicken
Seite 4
PyBullet Physics Engine — Server bieten OpenGL Debug-Visualisierung. Verbindung mit DIRECT, GUI diagram (page 4)
Abb. 4 · Server bieten OpenGL Debug-Visualisierung. Verbindun…

Diagramm mit verschiedenen Physik-Client (blau) und Physik Server (grün) Optionen. Dunkelgrün

Server bieten OpenGL Debug-Visualisierung. Verbindung mit DIRECT, GUI

Die DIRECT-Verbindung sendet die Befehle direkt an den Physiker, ohne Transportschicht und kein Grafikvisualisierungsfenster zu verwenden, und gibt nach Ausführung des Befehls den Status direkt zurück. Die GUI-Verbindung wird eine neue grafische Benutzeroberfläche (GUI) mit 3D OpenGL Rendering erstellen, die sich im gleichen Prozessraum wie PyBullet befindet. Unter Linux und Windows läuft diese GUI in einem separaten Thread, während sie unter OSX aufgrund von Betriebssystembeschränkungen im selben Thread ausgeführt wird. Unter Mac OSX sehen Sie möglicherweise ein sich drehendes Rad im OpenGL-Fenster, bis Sie einen "stepSimulation" -Befehl oder einen anderen PyBullet-Befehl ausführen. Die Befehle und Statusmeldungen werden zwischen dem PyBullet-Client und dem GUI Physiksimulationsserver mit einem gewöhnlichen Speicherpuffer gesendet. Es ist auch möglich, sich mit einem Physikserver in einem anderen Prozess auf demselben Computer oder auf einer entfernten Maschine über SHARED MEMORY-, UDP- oder TCP-Netzwerk zu verbinden. Siehe den Abschnitt über Shared Memory, UDP und TCP für Details. Im gegensatz zu fast allen anderen methoden analysiert diese methode keine keyword-argumente, da sie abwärtskompatibilität hat.

Page 5 of the PyBullet Physics Engine user manual — Server bieten OpenGL Debug-Visualisierung. Verbindung mit DIRECT, GUI
Seite 5 · Zum Vergrößern klicken
Seite 5

Die Connect-Input Argumente sind:

erforderlichVerbindungsmodusGanzzahl: DIRECT, GUI, SHARED MEMORY, UDP, TCPDIRECT-Modus erstellen Sie eine neue Physik-Engine und direkt mit ihm kommuniziert. GUI wird eine Physik-Engine mit grafischem GUIS-Frontend erstellen und damit kommunizieren. SHARED MEMORY verbindet sich mit einem vorhandenen Physik-Engine Prozess auf der gleichen Maschine und kommuniziert über einen gemeinsamen Speicher. TCP oder UDP wird über ein Netzwerk von TCP und UDP mit einem bestehenden Physikserver verbunden. fakultativSchlüsselintim Shared Memory-Modus, optionaler gemeinsam genutzter Speicherschlüssel. Beim Starten von ExampleBrowser oder SharedMemoryPhysics * können Sie den optionalen Befehlszeilen- --shared Memory Key verwenden, um die Taste festzulegen. Dies ermöglicht es, mehrere Server auf demselben Computer auszuführen. fakultativUdpNetworkAddress (UDP und TCP)StringIP-Adresse oder Hostname, z. B. "127.0.0.1" oder "localhost" oder „mymachine.domain.com fakultativUdpNetworkPort (UDP und TCP)GanzzahlUDP-Portnummer. Standard-UDP-Port ist 1234, standardmäßiger TCP-Port 6667 (entspricht den Standardwerten im Server) fakultativOptionenStringBefehlszeilenoption, die in den GUI-Server übertragen wurde. Momentan ist nur das Flag --opengl2 aktiviert: Standardmäßig verwendet Bullet OpenGL3, aber einige Umgebungen wie virtuelle Maschinen oder Remote-Desktopclients unterstützen nur OpenGl2. Nur ein Kommandozeilenargument kann im Moment weitergegeben werden.

connect gibt eine Physik-Client-ID oder -1 zurück, wenn nicht verbunden. Die Physik-Client-ID ist ein optionales Argument für die meisten anderen PyBullet-Befehle. Wenn Sie es nicht zur Verfügung stellen, wird Physik Client ID = 0 angenommen. Sie können sich mit mehreren verschiedenen Physikservern verbinden, außer GUI. Zum Beispiel: pybullet.connect(pybullet.DIRECT) pybullet.connect(pybullet.GUI, options="--opengl2") pybullet.connect(pybullet.SHARED MEMORY,1234) pybullet.connect(pybullet.UDP,"192.168.0.1") pybullet.connect(pybullet.UDP,localhost), 1234) pybullet.connect(pybullet.TCP,localhost), 6667 verbinden mit Shared Memory

Es gibt einige Physikserver, die eine Verbindung zum gemeinsamen Speicher ermöglichen: Der App SharedMemoryPhysics, der App sharedmemoryphysicS GUI und der Bullet-Beispielbrowser haben ein Beispiel unter Experimental/Physik Server, das eine Verbindung mit dem geteilten Speicher ermöglicht. Auf diese Weise können Sie die Physiksimulation und das Rendern in einem separaten Prozess ausführen.

Page 6 of the PyBullet Physics Engine user manual — setGravity
Seite 6 · Zum Vergrößern klicken
Seite 6

Sie können auch über den freigegebenen Speicher mit der App SharedMemoryPhysics VR, der Virtual Reality-Anwendung mit Unterstützung für Headmounted Display und 6-Dof-Tracking-Controllern wie HTC Vive und Oculus Rift mit Touch Controllern verbinden. Da das Valve OpenVR SDK nur unter Windows ordnungsgemäß funktioniert, kann die App SharedMemoryPhysics VR nur mit Premake (vorzugsweise) oder Cmake unter Windows erstellt werden. Verbindung über UDP oder TCP Networking

Für UDP-Netzwerke gibt es einen App PhysicsServerUDP, der auf einen bestimmten UDP Port hört. Es nutzt die Open Source enet Bibliothek für zuverlässige UDP-Netzwerke. Dies ermöglicht es Ihnen, die Physiksimulation und das Rendern auf einer separaten Maschine auszuführen. Für TCP verwendet PyBullet die Clsocket-Bibliothek. Dies kann nützlich sein, wenn Sie SSH-Tunnel von einer Maschine hinter einer Firewall zu einer Robotersimulation verwenden. Sie können beispielsweise einen Steuerstapel oder maschinelles Lernen mit PyBullet unter Linux ausführen, während der Physikserver in Virtual Reality unter Windows mit HTC Vive oder Rift ausgeführt wird. Eine weitere UDP-Anwendung ist die App PhysicsServerSharedMemoryBridgeUDP-Anwendung, die als Brücke zu einem vorhandenen Physikserver fungiert: Sie können sich über UDP mit dieser Bridge verbinden und die Bridge verbindet sich mit einem Physikserver unter Verwendung von Shared Memory: Die Bridge leitet Nachrichten zwischen Client und Server weiter. In ähnlicher Weise gibt es eine TCP-Version (Ersetzen von UDP durch TCP). Hinweis: Im Moment müssen sowohl Client als auch Server entweder 32bit oder 64bit Builds sein! Abschaltung

Sie können die Verbindung zu einem Physik-Server unter Verwendung der Physik-Client-ID, die durch den Verbindungsaufruf zurückgegeben wurde (falls nicht negativ), trennen. Ein "DIRECT" oder "GUI" Physikserver wird heruntergefahren. Ein separater (Out-of-Prozess) Physikserver wird weiterlaufen. Siehe auch 'resetSimulation', um alle Elemente zu entfernen. Trennparameter:

optional physicsClientId int, wenn Sie eine Verbindung zu mehreren Physik-Servern herstellen, können Sie auswählen, welche.

setGravity

Standardmäßig ist keine Gravitationskraft aktiviert.setGravitykönnen Sie die Standard-Schwerkraft für alle Objekte festlegen. Die setGravity-Eingabeparameter sind: (kein Rückgabewert)

Erforderliche gravityX schweben Schwerkraft entlang der X-Weltachse

Page 7 of the PyBullet Physics Engine user manual — loadURDF,loadSDF, loadMJCF
Seite 7 · Zum Vergrößern klicken
Seite 7
erforderlichSchwerkraftSchwimmkörperSchwerkraft entlang der Y-Weltachse erforderlichgravityZSchwimmkörperSchwerkraft entlang der Z-Weltachse fakultativphysicsClientIdintWenn Sie sich mit mehreren Physik-Servern verbinden, können Sie auswählen, welche.

loadURDF,loadSDF, loadMJCF

Das loadURDF sendet einen Befehl an den Physikserver, ein physikalisches Modell aus einer Universal Robot Description File (URDF) zu laden. Die URDF-Datei wird vom ROS-Projekt (Robot Operating System) zur Beschreibung von Robotern und anderen Objekten verwendet, sie wurde von der WillowGarage und der Open Source Robotics Foundation (OSRF) erstellt. Viele Roboter haben öffentliche URDF-Dateien, eine Beschreibung und ein Tutorial finden Sie hier:http://wiki.ros.org/urdf/Tutorials Wichtiger Hinweis: Die meisten Gelenke (Schiebeschieber, Revolute, Continuous) haben standardmäßig Motoren aktiviert, die eine freie Bewegung verhindern. Dies ist ähnlich wie bei einem Robotergelenk mit sehr hochreibungsfähigem Oberwellenantrieb. Sie sollten den gemeinsamen Motorsteuerungsmodus und die Zieleinstellungen mit pybullet.setJointMotorControl2 einstellen. Sehen Sie sich die setJointMotorControl2 API für weitere Informationen an. Warnung: Standardmäßig wird PyBullet einige Dateien zwischenspeichern, um das Laden zu beschleunigen. Sie können das Datei-Caching mit setPhysicsEngineParameter(enableFileCachling=0) deaktivieren. Die LoadURDF-Argumente sind:

erforderlichfileNameStringeinen relativen oder absoluten Pfad zur URDF-Datei auf dem Dateisystem des Physikservers. fakultativbasePositionvec3Erzeugen der Basis des Objekts an der angegebenen Position in den Weltraumkoordinaten [X,Y,Z] fakultativbaseOrientierungvec4Erstellen Sie die Basis des Objekts in der angegebenen Ausrichtung als Weltraum Quaternion [X,Y,Z,W] fakultativuseMaximalKoordinatenintExperimentell. Standardmäßig werden die Joints in der URDF-Datei mit dem Reduced Coordinate Verfahren erstellt: Die Joints werden mit dem Featherstone Articulated Body Algorithmus (btMultiBody in Bullet 2.x) simuliert. Die Option useMaximalCoordinates erzeugt einen starren Körper mit 6 Freiheitsgrad für jedes Glied, und die Einschränkungen zwischen diesen starren Körpers werden verwendet, um Gelenke zu modellieren. fakultativuseFixedBaseintErzwingen Sie die Basis des geladenen Objekts, um statisch zu sein fakultativFlaggenintURDF VERWENDUNGSINERTIA AUS DATEI: Standardmäßig berechnete Bullet den Trägheitstensor basierend auf Masse und Volumen der Kollisionsform neu. Wenn Sie einen genaueren Trägheitstensor bereitstellen können, verwenden Sie dieses Flag.
Page 8 of the PyBullet Physics Engine user manual — loadURDF,loadSDF, loadMJCF
Seite 8 · Zum Vergrößern klicken
Seite 8
URDF-NUTZUNGSSELBSTKOLLISION: Standardmäßig deaktiviert Bullet die Selbstkollision. Diese Flagge lässt es uns aktivieren. Sie können das Selbstkollisionsverhalten mit den folgenden Flags anpassen: URDF USE SELF COLLISION EXCLUDE PARENT wird die Selbstkollision zwischen direkt verbundenen Links (Elternteil und Kind) verwerfen. URDF VERWENDUNG SELBSTKOLLISION AUSSCHLUSS ALLE PAR ENTS verwerfen Selbstkollisionen zwischen einem Kind Link und einer seiner Vorfahren (Eltern, Eltern von Eltern, bis zur Basis). URDF VERWENDUNG IMPLICIT CYLINDER, wird einen glatten impliziten Zylinder verwenden. Standardmäßig wird Bullet den Zylinder in einen konvexen Rumpf tesselate. fakultativglobalSkalierungSchwimmkörperglobalScaling wird einen Skalierungsfaktor auf das URDF-Modell anwenden. fakultativphysicsClientIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

loadURDF gibt eine Body Unique ID, einen nicht negativen Ganzzahlwert zurück. Wenn die URDF-Datei nicht geladen werden kann, ist diese ganze Zahl negativ und keine gültige Body eindeutige ID. loadSDF,loadMJCF

Sie können auch Objekte aus anderen Dateiformaten wie .bullet, .sdf und .mjcf laden. Diese Dateiformate unterstützen mehrere Objekte, so dass der Rückgabewert eine Liste von Objekt-Unique IDs ist. Das SDF-Format wird ausführlich unterhttp://sdformat.org Der Befehl loadSDF extrahiert nur einige wesentliche Teile der SDF, die sich auf Robotermodelle und -geometrie beziehen, und ignoriert viele Elemente im Zusammenhang mit Kameras, Lichtern usw. Der Befehl loadMJCF führt den grundlegenden Import von MuJoCo MJCF-XML-Dateien aus, die in OpenAI Gym verwendet werden. Siehe auch die Wichtige Anmerkung unter loadURDF bezüglich der Standardeinstellungen für gemeinsame Motoren und stellen Sie sicher, dass setJointMotorControl2 verwendet wird.

erforderlichfileNameStringeinen relativen oder absoluten Pfad zur URDF-Datei auf dem Dateisystem des Physikservers. fakultativuseMaximalKoordinatenintExperimentell. Siehe loadURDF für weitere Details. fakultativglobalSkalierungSchwimmkörperjedes Objekt wird mit diesem Skalierungsfaktor skaliert (einschließlich Links, Linkrahmen, Gelenkansätze und lineare Verbindungsgrenzen) fakultativphysicsClientIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

loadBullet,loadSDF und loadMJCF geben eine Reihe von Objekt-Unique IDs zurück:

objectUniqueIds Liste der int

die Liste enthält für jedes geladene Objekt eine eindeutige ID.

Page 9 of the PyBullet Physics Engine user manual — saveState, saveBullet, restoreState
Seite 9 · Zum Vergrößern klicken
Seite 9

saveWorld

Sie können eine ungefähre Momentaufnahme der aktuellen Welt als PyBullet Python-Datei erstellen, die auf dem Server gespeichert ist. saveWorld kann als grundlegende Bearbeitungsfunktion nützlich sein, indem Roboter, Gelenkwinkel, Objektpositionen und Umgebung beispielsweise in VR eingerichtet werden. Später können Sie einfach die PyBullet Python-Datei laden, um die Welt neu zu erstellen. Der Python-Snapshot enthält loadURDF Befehle zusammen mit der Initialisierung von Gelenkwinkeln und Objekttransformationen. Beachten Sie, dass nicht alle Einstellungen in der Weltdatei gespeichert sind. Die Eingangsargumente lauten:

erforderlichfileNameStringDateiname der PyBullet-Datei. fakultativclientServerIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

saveState, saveBullet, restoreState

Wenn Sie eine deterministische Simulation nach der Wiederherstellung eines zuvor gespeicherten Zustands benötigen, müssen alle wichtigen Statusinformationen einschließlich Kontaktpunkten gespeichert werden. Das SaveWorld-Kommando reicht dafür nicht aus. Sie können den Befehl restoreState verwenden, um aus einem Snapshot wiederherzustellen, der mit saveState (in-Memory) oder SaveBullet (auf Festplatte) aufgenommen wurde. Der saveState-Befehl nimmt nur eine optionale clientServerId als Eingabe und gibt die Statusid zurück. Der Befehl saveBullet speichert den Zustand in einer .bullet-Datei auf der Festplatte. Die Eingabeargumente des Befehls restoreState sind:

fakultativfileNameStringDateiname der .bullet-Datei, die mit einem saveBullet-Befehl erstellt wurde. fakultativstateIdintState ID zurückgegeben von saveState fakultativclientServerIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Entweder der Dateiname oder die Status-ID muss gültig sein. Beachten Sie, dass restoreState die Positionen und Gelenkwinkel von Objekten in den gespeicherten Zustand zurücksetzt sowie Kontaktpunktinformationen wiederherstellt. Sie müssen sicherstellen, dass die Objekte und Einschränkungen eingerichtet sind, bevor Sie restoreState aufrufen. Siehe das Beispiel saveRestoreState.py.

Page 10 of the PyBullet Physics Engine user manual — createCollisionShape/VisualShape
Seite 10 · Zum Vergrößern klicken
Seite 10

createCollisionShape/VisualShape

Obwohl der empfohlene und einfachste Weg, um Dinge in der Welt zu erstellen, die Ladefunktionen (loadURDF / SDF / MJCF / Bulllet) ist, können Sie auch Kollisions- und visuelle Formen programmgesteuert erstellen und sie verwenden, um einen Multibody mit createMultiBody zu erzeugen. Siehe das Beispiel createMultiBodyLinks.py und createVisualShape.py im Bullet Physics SDK. Die Eingangsparameter für createCollisionShape sind

erforderlichshapeTypeintGEOM-SPHÄRE, GEOMBOX, GEOMMKAPSEL, -GEOMZYLINDER, GEOMINENEBENE, GEOMENGMASCHEN fakultativRadiusSchwimmkörperSTANDARD 0.5: GEOM-SPHÄRE, GEOM-KAPSEL, GEOMMZYLINDER fakultativhalbe Ausdehnungenvec3 Liste von 3 FloatsStandard [1,1,1]: für GEOM BOX fakultativHöheSchwimmkörperStandard: 1: für GEOM CAPSULE, GEOM CYLINDER fakultativfileNameStringDateiname für GEOM MESH, derzeit nur Wavefront .obj. Erstellt konvexe Rümpfe für jedes Objekt (markiert als 'o') in der .obj-Datei. fakultativmeshScalevec3 Liste von 3 FloatsStandard: [1,1,1] für GEOM MESH fakultativEbeneNormalvec3 Liste von 3 FloatsStandard: [0,0,1] für GEOM PLANE fakultativFlaggenintGEOM FORCE CONCAVE TRIMESH: Für GEOM MESH wird ein konkaves statisches Dreieck-Mesh erstellt. Dies sollte nicht mit dynamischen / bewegten Objekten verwendet werden, nur für statisches (Masse = 0) Gelände. fakultativKollisions-Schemaverknüpfungvec3translatorischer Versatz der Kollisionsform gegenüber dem Kulissenrahmen fakultativKollisionRahmenOr-Ausrichtungvec4Drehversatz (Quarterion x,y,z,w) der Kollisionsform gegenüber dem Kulissenrahmen fakultativphysicsClientIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Der Rückgabewert ist eine nicht negative int eindeutige ID für die Kollisionsform oder -1, wenn der Anruf fehlgeschlagen ist. createVisualShape

Sie können eine visuelle Form auf ähnliche Weise wie die Erstellung einer Kollisionsform erstellen, mit einigen zusätzlichen Argumenten zur Steuerung des optischen Erscheinungsbildes, z. B. diffuse und spiegelnde Farbe. Wenn Sie den Typ GEOM MESH verwenden, können Sie auf eine Wavefront OBJ-Datei und die visuelle

Page 11 of the PyBullet Physics Engine user manual — createCollisionShape/VisualShape
Seite 11 · Zum Vergrößern klicken
Seite 11

shape analysiert einige Parameter aus der Materialdatei (.mtl) und lädt eine Textur. Beachten Sie, dass große Texturen (über 1024x1024 Pixel) die Lade- und Laufzeitleistung verlangsamen können. Siehe Beispiele/pybullet/beispiele/addPlanarReflection.py und createVisualShape.py

PyBullet Physics Engine — createCollisionShape/VisualShape diagram (page 11)
Abb. 5 · createCollisionShape/VisualShape

Die Eingangsparameter sind

erforderlichshapeTypeintGEOM-SPHÄRE, GEOMBOX, GEOMMKAPSEL, -GEOMZYLINDER, GEOMINENEBENE, GEOMENGMASCHEN fakultativRadiusSchwimmkörperstandard 0.5: nur für GEOM SPHERE, GEOM CAPSULE, GEOM CYLINDER fakultativhalbe Ausdehnungenvec3 Liste von 3 FloatsStandard [1,1,1]: nur für GEOM BOX fakultativLängeSchwimmkörperStandard: 1: nur für GEOM CAPSULE, GEOM CYLINDER (Länge = Höhe) fakultativfileNameStringDateiname für GEOM MESH, derzeit nur Wavefront .obj. Erstellt konvexe Rümpfe für jedes Objekt (markiert als 'o') in der .obj-Datei. fakultativmeshScalevec3 Liste von 3 FloatsStandard: [1,1,1],nur für GEOM MESH fakultativEbeneNormalvec3 Liste von 3 FloatsStandard: [0,0,1] nur für GEOM PLANE fakultativFlaggenintUngenutzt / zu entscheiden fakultativrgbaFarbevec4, Liste von 4 FloatsFarbkomponenten für Rot, Grün, Blau und Alpha jeweils im Bereich [0..1] fakultativspecularFarbevec3, Liste von 3 Floatsspiegelnde Reflexionsfarbe, rote, grüne und blaue Bestandteile im Bereich [0..1] fakultativvisualFramePositionvec3, Liste dertranslatorischer Versatz der visuellen Form gegenüber dem Link
Page 12 of the PyBullet Physics Engine user manual — createMultiBody
Seite 12 · Zum Vergrößern klicken
Seite 12
3 SchwimmerRahmen fakultativvisualFrameOrientatio nvec4, Liste von 4 FloatsDrehversatz (Quarterion x,y,z,w) der Sichtform gegenüber dem Verknüpfungsrahmen fakultativphysicsClientIdintWenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Der Rückgabewert ist eine nicht negative int eindeutige ID für die visuelle Form oder -1, wenn der Anruf fehlgeschlagen ist.

createMultiBody

Obwohl der einfachste Weg, um Dinge in der Welt zu erstellen ist mit den Ladefunktionen (loadURDF / SDF / MJCF / Kugel), können Sie einen Multi-Body erstellen. Siehe das Beispiel createMultiBodyLinks.py im Bullet Physics SDK. Die Parameter von createMultiBody sind den URDF- und SDF-Parametern sehr ähnlich. Sie können einen Mehrkörper mit nur einer einzigen Basis ohne Gelenke / Kinderverbindungen erstellen oder Sie können ein Mehrkörper-Gelenk/Kinderverbindungen erstellen. Wenn Sie Links bereitstellen, stellen Sie sicher, dass die Größe jeder Liste gleich ist (len(linkMasses) == len(linkCollisionShapeIndices) usw.).

fakultativbaseMaßnahmeSchwimmkörperMasse der Basis in kg (bei Verwendung von SI-Einheiten) fakultativbaseCollisionShapeIndexinteindeutige ID von createCollisionShape oder -1. Sie können die Kollisionsform für mehrere Multibodies wiederverwenden (Instanzierung) fakultativbaseVisualShapeIndexinteindeutige ID von createVisualShape oder -1. Sie können die visuelle Form wiederverwenden (Instancing) fakultativbasePositionvec3, Liste von 3 FloatsKartesische Weltposition der Basis fakultativbaseOrientierungvec4, Liste von 4 FloatsOrientierung der Base als Quaternion [x,y,z,w] fakultativbaseInertialFramePositionvec3, Liste von 3 FloatsLokale Lage des Inertialrahmens fakultativbaseInertialFrameOrientierungvec4, Liste von 4 FloatsLokale Ausrichtung des Inertialrahmens, [x,y,z,w] fakultativlinkMassesListe der SchwimmerListe der Massenwerte, einer für jeden Link. fakultativlinkCollisionShapeIndicesListe der intListe der eindeutigen ID, eine für jeden Link.
Page 13 of the PyBullet Physics Engine user manual — stepSimulation
Seite 13 · Zum Vergrößern klicken
Seite 13

optionaler LinkVisualShapeIndices Liste der int-Liste der visuellen Form eindeutige ID für jeden Link

optionale linkPositionsliste der vec3-Liste lokaler Linkpositionen in Bezug auf das Mutterunternehmen

optional linkOrientations list of vec4 list of local link orientations, w.r.t. Mutter

optional linkInertialFramePositionsliste der vec3-Liste des lokalen Inertialrahmens Pos. im Link-Rahmen

optional linkInertialFrameOrientations list of vec4 list of local inertial frame orn. im Link-Rahmen

optional linkParentIndices Liste des int Link Index des übergeordneten Links oder 0 für die Basis.

optional linkJointTypes Liste der int-Liste von gemeinsamen Typen, eine für jeden Link. Nur JOINT REVOLUTE, JOint PRISMATIC und JOIT FIXED werden derzeit unterstützt.

optionaler LinkJointAxis-Liste der vec3-Gemeinsamen Achse im lokalen Rahmen

optional useMaximalKoordinatiert int experimentell, am besten 0/false lassen.

optional physicsClientId int Wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Der Rückgabewert von createMultiBody ist eine nicht negative eindeutige ID oder -1 für den Fehler. Beispiel: cuid = pybullet.createCollisionShape(pybullet .GEOM BOX, halfExtents = [1, 1, 1]) mass= 0 #static box pybullet.createrMultiBody(mass,cuid) Siehe auch createMultiBodiLinks.py, CreateObstacleCourse.py und createVisualShape.py im Ordner Bullet/examples/pybullets/beispiele.

stepSimulation

stepSimulation führt alle Aktionen in einem einzigen Schritt zur Simulation der Vorwärtsdynamik aus, wie z. B. Kollisionserkennung, Einschränkungslösung und Integration. stepSimulation-Eingabeargumente sind optional:

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

stepSimulation hat keine Rückgabewerte. Siehe auch setRealTimeSimulation, um den Physikserver automatisch eine Dynamiksimulation basierend auf seiner Echtzeituhr ausführen zu lassen.

Page 14 of the PyBullet Physics Engine user manual — getBasePositionAndOrientierung
Seite 14 · Zum Vergrößern klicken
Seite 14

setRealTimeSimulation

Standardmäßig wird der Physikserver die Simulation nicht durchführen, es sei denn, Sie senden ausdrücklich einen Befehl "stepSimulation". Auf diese Weise können Sie den Kontrolldeterminismus der Simulation beibehalten. Es ist möglich, die Simulation in Echtzeit auszuführen, indem der Physikserver automatisch mit dem Befehl setRealTimeSimulation gemäß seiner Real-time-clock (RTC) Schritt macht. Wenn Sie die Echtzeit-Simulation aktivieren, müssen Sie nicht 'stepSimulierung' aufrufen. Beachten Sie, dass setRealTimeSimulation im DIRECT-Modus keine Auswirkungen hat: Im DIREKT-Modus finden Physikserver und -client im selben Thread statt und Sie lösen jeden Befehl aus. Im GUI-Modus und im Virtual Reality-Modus sowie TCP/UDP-Modus läuft der Physikserver in einem separaten Thread vom Client (PyBullet), und setRealTimeSimulation ermöglicht es dem PhysicsServer, zusätzliche Aufrufe zu stepSimule hinzuzufügen. Die Eingangsparameter sind:

required enableRealTimeSimulation int 0 zur Deaktivierung der Echtzeitsimulation, 1 zum Aktivieren

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getBasePositionAndOrientierung

getBasePositionAndOrientation meldet die aktuelle Position und Orientierung der Basis (oder Wurzelverbindung) des Körpers in kartesischen Weltkoordinaten. Die Orientierung ist eine Quaternion im [x,y,z,w] Format. Die getBasePositionAndOrientierungs-Eingangsparameter sind:

required objectUniqueId int Object unique id, wie von loadURDF zurückgegeben.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getBasePositionAndOrientation gibt die Positionsliste von 3 Floats und Orientierung als Liste von 4 Floats in [x,y,z,w] Reihenfolge zurück. Verwenden Sie getEulerFromQuaternion, um die Quaternion bei Bedarf in Euler umzuwandeln. Siehe auch resetBasePositionAndOrientation, um die Position und Ausrichtung des Objekts zurückzusetzen.

Page 15 of the PyBullet Physics Engine user manual — Transformationen: Position und Orientierung
Seite 15 · Zum Vergrößern klicken
Seite 15

Dies vervollständigt das erste PyBullet-Skript. Bullet wird mit mehreren URDF-Dateien im Ordner "Bullet/Data" ausgeliefert.

resetBasePositionAndOrientierung

Sie können die Position und Orientierung der Basis (root) jedes Objekts zurücksetzen. Es ist am besten, dies nur zu Beginn und nicht während einer laufenden Simulation zu tun, da der Befehl den Effekt aller physikalischen Simulationen außer Kraft setzt. Die lineare und die Winkelgeschwindigkeit werden auf Null gesetzt. Sie können resetBaseVelocity verwenden, um eine lineare und/oder Winkelgeschwindigkeit von ungleich Null zurückzusetzen. Die Eingabeargumente für resetBasePositionAndOrientation sind:

required objectUniqueId int Object unique id, wie von loadURDF zurückgegeben.

required posObj vec3 setzt die Basis des Objekts an der angegebenen Position in den Weltraumkoordinaten zurück [X,Y,Z]

required ornObj vec4 setzt die Basis des Objekts in der angegebenen Orientierung als Weltraum-Quarterion zurück [X,Y,Z,W]

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Es gibt keine Rückkehrargumente.

Transformationen: Position und Orientierung

Die Position von Objekten kann in kartesischen Weltraumkoordinaten [x,y,z] ausgedrückt werden. Die Orientierung (oder Rotation) von Objekten kann mit Quaternionen [x,y,z,w], Eulerwinkeln [Yaw, Nick, Roll] oder 3 x 3-Matrizen ausgedrückt werden. PyBullet bietet einige Hilfsfunktionen, um zwischen Quaternionen, Eulerwinkeln und 3x3-Matrizen zu konvertieren. Zusätzlich gibt es einige Funktionen, um Transformationen zu multiplizieren und invertieren. getQuaternionFromEuler und getEulersFromQuatternion

Die PyBullet API verwendet Quaternionen, um Orientierungen darzustellen. Da Quaternionen für Menschen nicht sehr intuitiv sind, gibt es zwei APIs zwischen Quaternions und Euler-Winkeln zu konvertieren. Die getQuaternionFromEuler-Eingabeargumente sind:

eulerAngle vec3 erforderlichListe von 3 Floats

Die X,Y,Z Euler Winkel sind in Radiant und akkumulieren 3 Umdrehungen zum Ausdruck bringen die Rolle um das X, Nick um Y und Gier um die Z-Achse.

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

getQuaternionFromEuler gibt eine Quaternion, vec4 Liste von 4 Gleitkommawerten [X,Y,Z,W] zurück.

Page 16 of the PyBullet Physics Engine user manual — getEulerFromQuaternion gibt eine Liste von 3 Gleitkommawerten zurück, a vec3. getMatrixFromQuaternion
Seite 16 · Zum Vergrößern klicken
Seite 16

getEulerFromQuaternion

Die getEulerFromQuaternion-Inputargumente sind:

erforderliches Quaternion vec4Liste von 4 Floats Das Quaternion-Format ist [x,y,z,w]

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

getEulerFromQuaternion gibt eine Liste von 3 Gleitkommawerten zurück, a vec3. getMatrixFromQuaternion

getMatrixFromQuaternion ist eine Utility-API zum Erstellen einer 3x3-Matrizen aus einem Quaternion. Der Input ist eine Quaternion und gibt eine Liste von 9 Floats aus, die die Matrix darstellen. multiplikatorTransforms, inverttransform

PyBullet bietet einige Hilfsfunktionen für Multiplikations- und Inverstransformationen. Dies kann hilfreich sein, um Koordinaten von einem zum anderen Koordinatensystem zu transformieren. Die Eingangsparameter von multiTransforms sind:

required positionA vec3, Liste von 3 Floats

required orientationA vec4, Liste von 4 floats quaternion [x,y,z,w]

required positionB vec3, Liste von 3 floats

required orientationB vec4, Liste von 4 Floats quaternion [x,y,z,w]

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

Der Rückgabewert ist eine Liste von Position (VEC3) und Orientierung (VAC4, Quaternion x,y,x,w). Die Eingangs- und Ausgangsparameter von invertTransform sind:

erforderliche Position vec3, Liste von 3 Schwimmern

erforderliche Ausrichtung vec4, Liste von 4 Floats Quaternion [x,y,z,w]

Die Ausgabe von invertTransform ist eine Position (VEC3) und Orientierung (VAC4, Quaternion x,y,x,w).

Page 17 of the PyBullet Physics Engine user manual — Basis, Gelenke, Links
Seite 17 · Zum Vergrößern klicken
Seite 17

getAPIVersion

Sie können die API-Version in einem Jahr-Monat-0-Tag-Format abfragen. Sie können nur zwischen Physik-Client / Server der gleichen API-Version mit derselben Bitanzahl (32 Bit / 64 Bit) verbinden. Es gibt ein optionales nicht verwendetes Argument physicsClientId, das für die API-Konsistenz hinzugefügt wurde.

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

Steuerung eines Roboters

In der Einleitung haben wir bereits gezeigt, wie man PyBullet initialisiert und einige Objekte lädt. Wenn Sie den Dateinamen im Befehl loadURDF durch "r2d2.urdf" ersetzen, können Sie einen R2D2-Roboter aus dem ROS-Tutorial simulieren. Lassen Sie uns diesen R2D2-Roboter steuern, um sich zu bewegen, umzusehen und den Greifer zu kontrollieren. Dazu müssen wir wissen, wie man auf seine gemeinsamen Motoren zugreifen kann.

Basis, Gelenke, Links

PyBullet Physics Engine — Basis, Gelenke, Links diagram (page 17)
Abb. 6 · Basis, Gelenke, Links

Ein simulierter Roboter, wie er in einer URDF-Datei beschrieben ist, hat eine Basis und optional Verbindungen, die durch Gelenke verbunden sind. Jedes Joint verbindet einen Elternlink mit einem Kinderlink. An der Wurzel der Hierarchie gibt es ein einzelnes Stammelternteil, das wir Basis nennen. Die Basis kann entweder vollständig fixiert, 0 Freiheitsgrade oder völlig frei mit 6 Freiheitsgraden sein. Da jede Verbindung mit einem Elternteil über ein einziges Gelenk verbunden ist, entspricht die Anzahl der Verbindungen der Anzahl der Verknüpfungen. Reguläre Links haben Linkindizes im Bereich [0..getNumJoints()] Da die Basis kein regulärer 'Link' ist, verwenden wir als Link die Konvention von -1

Page 18 of the PyBullet Physics Engine user manual — getNumJoints gibt einen ganzzahligen Wert zurück, der die Anzahl von Joints darstellt. getJointInfo
Seite 18 · Zum Vergrößern klicken
Seite 18

Index. Wir verwenden die Konvention, dass Gelenkrahmen relativ zum Elternzentrum des Massenträgheitsrahmens ausgedrückt werden, der mit der Hauptachse der Trägigkeit ausgerichtet ist.

getNumJoints, getJointInfo

Nachdem Sie einen Roboter geladen haben, können Sie die Anzahl der Gelenke mithilfe der getNumJoints API abfragen. Für die r2d2.urdf sollte diese 15 zurückgeben. getNumJoints-Eingangsparameter:

required bodyUniqueId int the body unique id, wie von loadURDF usw. zurückgegeben

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getNumJoints gibt einen ganzzahligen Wert zurück, der die Anzahl von Joints darstellt. getJointInfo

Für jeden Joint können wir einige Informationen abfragen, wie z. B. seinen Namen und Typ. getJointInfo Eingabeparameter

required bodyUniqueId int the body unique id, wie von loadURDF usw. zurückgegeben

required jointIndex int ein Index im Bereich [0 ..] getNumJoints(bodyUniqueId)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getJointInfo gibt eine Liste von Informationen zurück:

jointIndex im selben gemeinsamen Index wie der Eingabeparameter

jointName string the name of the common, wie in der URDF-Datei (oder SDF etc.) angegeben

jointType int type des Gelenks, dies impliziert auch die Anzahl der Position und Geschwindigkeit Variablen. JOINT REVOLUTE, JOINT PRISMATIC, JOINT*SPHERICAL, JOINT/PLANAR, JOINT Siehe den Abschnitt über Basis, Joint und Links für weitere Details.

qIndex int der erste Positionsindex in den positionellen Zustandsvariablen für diesen Körper

uIndex int der erste Geschwindigkeitsindex in den Geschwindigkeitszustandsvariablen für diesen Körper

jointDamping float den gemeinsamen Dämpfungswert, wie in der URDF-Datei angegeben

jointFriction float den Wert der Gelenkreibung, wie in der URDF-Datei angegeben

jointLowerLimit float Positionale Untergrenze für Schieber- und Drehgelenke.

jointUpperLimit float Positionale Obergrenze für Schieber- und Drehgelenke. Nicht berücksichtigte Werte im Fall des oberen

Flaggen int reserviert

Page 19 of the PyBullet Physics Engine user manual — setJointMotorControl2/Array
Seite 19 · Zum Vergrößern klicken
Seite 19

limit < unteres Limit.

jointMaxForce float Maximale Kraft angegeben in URDF (möglicherweise andere Dateiformate) Beachten Sie, dass dieser Wert nicht automatisch verwendet wird. Sie können maxForce in 'setJointMotorControl2' verwenden.

jointMaxVelocity float Maximale Geschwindigkeit spezifiziert in URDF. Beachten Sie, dass die maximale Geschwindigkeit im Moment nicht in tatsächlichen Motorsteuerbefehlen verwendet wird.

linkName string den Namen des Links, wie in der URDF-Datei (oder SDF etc.) angegeben

jointAxis vec3 Gelenkachse im lokalen Rahmen (ignoriert für JOINT FIXED)

parentFramePos vec3 gemeinsame Position im Parent Frame

parentFrameOrn vec3 gemeinsame Orientierung im Parent Frame

parentIndex int Parent Link Index, -1 für Basis

setJointMotorControl2/Array

Anmerkung:setJointMotorControl ist veraltet und wird durch die setJoINTMotorControl2 API ersetzt. (Oder noch besser setJointMotorControlArray verwenden). Wir können einen Roboter steuern, indem wir den gewünschten Steuerungsmodus für einen oder mehrere gemeinsame Motoren einstellen. Während der stepSimulation simuliert die Physik-Engine die Motoren, um den vorgegebenen Zielwert zu erreichen, der innerhalb der maximalen Motorkräfte und anderer Einschränkungen erreicht werden kann. Jedes Drehgelenk und prismatische Gelenk wird standardmäßig motorisiert. Es gibt 3 verschiedene Motorsteuerungsmodi: Positionsregelung, Geschwindigkeitskontrolle und Drehmomentregelung. Sie können den Motor effektiv deaktivieren, indem Sie eine Kraft von 0 verwenden. Sie müssen den Motor deaktivieren, um eine direkte Drehmomentregelung zu verwenden. Zum Beispiel:

maxForce = 0 mode = p.VELOCITY CONTROL p.setJointMotorControl2(objUid, jointIndex, controlMode=mode, force=maxForce) Wenn Sie möchten, dass ein Rad eine konstante Geschwindigkeit beibehält, können Sie mit einer maximalen Kraft:

maxForce = 500 p.setJointMotorControl2(bodyUniqueId=objUid),

jointIndex=0, controlMode=p.VELOCITY CONTROL, targetVelocity = targetVel, force = maxForce

Page 20 of the PyBullet Physics Engine user manual — setJointMotorControl2/Array
Seite 20 · Zum Vergrößern klicken
Seite 20

Die Eingabeargumente für setJointMotorControl2 lauten:

required bodyUniqueId int body unique id wie von loadURDF zurückgegeben etc.

erforderlichen jointIndex int Link Index im Bereich [0..getNumJoints(bodyUniqueId) (beachten Sie, dass der Linkindex == gemeinsamer Index)

required controlMode int POSITION CONTROL (was tatsächlich CONTROL MODE POSITion VELOCITY PD ist), VELOCity CONTRAL, TORQUE CONTRIL

optional targetPosition float in POSITION CONTROL the goalValue ist Zielposition des Joints

optional targetVelocity float in VELOCITY CONTROL und POSITION CONTRAOL die targetVenocity ist die gewünschte Geschwindigkeit des Gelenks, siehe Durchführung Anmerkung unten. Beachten Sie, dass die targetVelocity nicht die maximale gemeinsame Geschwindigkeit ist. In POSITION CONTROL/CONTROLL MODE POSITion VELOC ITY PD wird die endgültige Zielgeschwindigkeit berechnet mit: kp*(erp* (desiredPosition-currentPosition)/dt)+ currentVelocity +kd *(m desiringVeocity - currentVenocity).

optionaler Kraftfluss in POSITION CONTROL und VELOCITY CONTRAOL (dies ist die maximale Motorkraft, mit der der Zielwert erreicht wurde). In TORQUE CONTROL ist dies die Kraft/das Drehmoment, das bei jedem Simulationsschritt aufgebracht werden muss.

optionale PositionGain float Siehe Implementierungshinweis unten

optionale velocityGain float Siehe Durchführungshinweis

optionaler maxVelocity-Schwimm in POSITION CONTROL, dadurch wird die Geschwindigkeit auf ein Maximum begrenzt

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Zu minimierender Fehler bei der Implementierung von Komponenteneinschränkungen

POSITION CONTROL-Beschränkungsgeschwindigkeit und Positionsbeschränkung

Fehler = position gain*(desired position-a ctual position)+velocity gains*(de sired velocität-actal velocation)

VELOCITY CONTROL constraint pure velocity constrainte error = desired velocity - actual veocity

TORQ KONTROLLE der äußeren Kraft

Page 21 of the PyBullet Physics Engine user manual — getJointState(s), resetJointStat
Seite 21 · Zum Vergrößern klicken
Seite 21

Generell ist es am besten, mit VELOCITY CONTROL oder POSITION CONTRAOL zu beginnen. Es ist viel schwieriger, TORQUE CONTROL (Kraftsteuerung) durchzuführen, da die Simulation der richtigen Kräfte auf sehr genauen Parametern von URDF/SDF-Datei und Systemidentifikation beruht (korrekte Massen, Trägheiten, Lage des Schwerpunkts, Gelenkreibung usw.). setJointMotorControlArray

Anstatt einzelne Anrufe für jeden Joint zu tätigen, können Sie Arrays für alle Eingaben übergeben, um den Overhead-Aufruf drastisch zu reduzieren. setJointMotorControlArray nimmt die gleichen Parameter wie setJoultMotorControl2 an, außer dass Ganzzahlen durch Listen von Ganzzahlen ersetzt werden. Die Eingabeargumente für setJointMotorControlArray sind:

required bodyUniqueId int body unique id wie von loadURDF zurückgegeben etc.

Erforderliche jointIndices-Liste des int-Index im Bereich [0..getNumJoints(bodyUniqueId) (Anmerkung: Linkindex == gemeinsamer Index)]

erforderliche controlMode int POSITION CONTROL, VELOCITY CONTRAL, TORQUE CONTRIE

optionale targetPositionsliste des Floats in POSITION CONTROL the goalValue ist die Zielposition der gemeinsamen

optionale targetVelocities-Liste des Schwimmers in VELOCITY CONTROL und POSITION CONTRAOL (Zielwert ist die Zielgeschwindigkeit der Verbindung, siehe Durchführungshinweis unten).

optionale Kräfteliste des Schwimmers in POSITION CONTROL und VELOCITY CONTRAOL (dies ist die maximale motorische Kraft, die zum Erreichen des Zielwerts verwendet wird). In TORQUE CONTROL ist dies die Kraft/das Drehmoment, das bei jedem Simulationsschritt aufgebracht werden muss.

optionale PositionListe des Floats Siehe Durchführungshinweis unten

optionale velocityGains-Liste des Schwimmers siehe Durchführungshinweis unten

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Siehe bullet3/beispiele/pybullet/tensorflow/humanoid running.py für ein Beispiel von setJointMotorControlArray.

getJointState(s), resetJointStat

Wir können mehrere Zustandsvariablen aus dem Gelenk mit getJointState abfragen, wie die gemeinsame Position, Geschwindigkeit, gemeinsame Reaktionskräfte und das gemeinsame Motormoment.

Page 22 of the PyBullet Physics Engine user manual — enableJointForceTorqueSensor
Seite 22 · Zum Vergrößern klicken
Seite 22

required bodyUniqueId int body eindeutige ID, die von loadURDF zurückgegeben wird

erforderlichen jointIndex int Link Index im Bereich [0..getNumJoints(bodyUniqueId)]

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

jointPosition float Der Positionswert dieses Joints.

jointVelocity float Der Geschwindigkeitswert dieses Gelenks.

jointReactionForces Liste von 6 Schwimmern Dies sind die gemeinsamen Reaktionskräfte, wenn ein Drehmomentsensor für dieses Gelenk aktiviert ist es [Fx, Fy, Fz, Mx, My, Mz]. Ohne Drehmomentsensor ist es [0,0,0).

appliedJointMotorTorque float Dies ist das Motormoment, das während der letzten SchrittSimulation angewendet wurde. Beachten Sie, dass dies nur in VELOCITY CONTROL und POSITION CONTRAOL gilt. Wenn Sie TORQUE CONTROL verwenden, ist das angewendete gemeinsame Motormoment genau das, was Sie angeben, so dass es nicht erforderlich ist, es separat zu melden.

getJointStates ist die Array-Version von GetJointSate. Anstatt einen einzigen jointIndex zu übergeben, geben Sie eine Liste von jointIndices weiter. resetJointState

Sie können den Zustand des Joints zurücksetzen. Am besten ist es, dies nur am Anfang zu tun, ohne die Simulation auszuführen: resetJointState überschreibt alle physikalischen Simulationen. Beachten Sie, dass wir derzeit nur 1-DOF-Motorgelenke unterstützen, Gleitgelenk oder Drehgelenke.

required bodyUniqueId int body eindeutige ID, die von loadURDF zurückgegeben wird

Erforderlicher jointIndex int Joint Index im Bereich [0..getNumJoints(bodyUniqueId)]

required targetValue float die gemeinsame Position (Winkel in Radiant oder Position)

optionale ZielVelocity schwebt die gemeinsame Geschwindigkeit (Winkel- oder Lineargeschwindigkeit)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

enableJointForceTorqueSensor

Sie können einen Gelenkkraft-/Drehmomentsensor in jedem Gelenk aktivieren oder deaktivieren. Sobald aktiviert, wenn Sie eine stepSimulation durchführen, wird der 'getJointState' die gemeinsamen Reaktionskräfte in den festgelegten Graden von

getJointState-Eingangsparameter · getJoultState

Page 23 of the PyBullet Physics Engine user manual — getLinkState
Seite 23 · Zum Vergrößern klicken
Seite 23

Freiheit: Ein festes Gelenk misst alle 6DOF-Gelenkkräfte / -drehmomente. Ein Revolute / Scharnier-Gelenkkraft / Drehmomentsensor misst 5DOF Reaktionskräfte entlang aller Achsen außer der Gelenkachse. Die aufgebrachte Kraft eines gemeinsamen Motors steht im angelegtenJointMotorTorque von getJointState zur Verfügung. Die Eingabeargumente für enableJointForceTorqueSensor sind:

required bodyUniqueId int body eindeutige ID, die von loadURDF zurückgegeben wird

Erforderlicher jointIndex int Joint Index im Bereich [0..getNumJoints(bodyUniqueId)]

optional enableSensor int 1/True to enable, 0/False to deaktivieren den Kraft-Drehmomentsensor

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getLinkState

Sie können auch die kartesische Weltposition und Orientierung für das Massenzentrum jedes Links mit getLinkState abfragen. Es wird auch den lokalen Inertialrahmen des Massenzentrums an den URDF-Linkframe melden, um die Berechnung des Grafik-/Visualisierungsrahmens zu erleichtern. getLinkState-Eingangsparameter

required bodyUniqueId int body eindeutige ID, die von loadURDF zurückgegeben wird

benötigter linkIndex int Link Index

optional computeLinkVelocity int Wenn auf 1 gesetzt, wird die kartesische Weltgeschwindigkeit berechnet und zurückgegeben.

optional computeForwardKinematics int, wenn auf 1 (oder True) gesetzt wird, die kartesische Weltposition/-orientierung mit Vorwärtskinematik neu berechnet.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

linkWorldPosition vec3, Liste der 3 Floats kartesische Position des Massenzentrums

linkWorldOrientation vec4, Liste der 4 Floats Kartesische Ausrichtung des Massenzentrums in Quaternion [x,y,z,w]

localInertialFramePosition vec3, Liste der 3 floats Lokalposition Offset des Inertialrahmen (Massenschwerpunkt), ausgedrückt im URDF-Linkframe

localInertialFrameOrientation vec4, Liste von 4 floats Local orientation (quaternion [x,y,z,w]) offset des Inertialframes ausgedrückt in URDF link frame.

getLinkState Rückgabewerte

Page 24 of the PyBullet Physics Engine user manual — getLinkState
Seite 24 · Zum Vergrößern klicken
Seite 24

worldLinkFramePosition vec3, Liste der 3 floats Weltposition des URDF-Verbindungsrahmens

worldLinkFrameOrientation vec4, Liste der 4 Floats Weltausrichtung des URDF-Verbindungsrahmens

worldLinkLinearVelocity vec3, Liste der 3 Floats kartesische Weltgeschwindigkeit. Nur zurückgegeben, wenn computeLinkVelocity nicht Null ist.

worldLinkAngularVelocity vec3, Liste der 3 Floats kartesische Weltgeschwindigkeit. Nur zurückgegeben, wenn computeLinkVelocity nicht Null ist.

Die Beziehung zwischen dem URDF-Linkframe und der Mitte des Massenrahmens (beide im Weltraum) ist: urdfLinkFrame = comLinkFRAMe * localInertialFrames.inverse(). Weitere Informationen zum Link und dem Inertialrahmen finden Sie im ROS URDF-Tutorial.

PyBullet Physics Engine — getLinkState diagram (page 24)
Abb. 7 · getLinkState

Beispielskripte (könnte veraltet sein, überprüfen Sie den aktuellen Ordner Bullet / Beispiele / Piybullet / Beispiele.)

Beispiele/Pybullet/Tensorflow/Humanoid runnin g.py

Laden Sie ein Humanoid und verwenden Sie ein trainiertes neuronales Netzwerk, um den Lauf mit TensorFlow zu steuern, das von OpenAI trainiert wird

Beispiele/pybullet/gym/pybullet envs/bullet /min itaur.py und minitaur gym envid.py

Minitaur-Umgebung für OpenAI GYM und TensorFlow Sie können auch python -m pybullet envs.examples.minitaur gym enV beispiel verwenden, nachdem Sie das Pip installiert haben, um den Minitaurus in Aktion zu sehen.

Beispiele/pybullet/beispiele/quadruped.py laden eine vierfach aus der URDF-Datei, Schritt die Simulation, steuern Sie die Motoren für einen einfachen Sprunggang basierend auf Sinuswellen.Wird auch den Zustand mit p.startStateLogging protokollieren Siehe Video.

examples/quadruped playback.py Erstellen Sie eine vierfache (Minitaur), lesen Sie die Protokolldatei und legen Sie Positionen als Motorsteuerziele fest.

examples/pybullet/beispiels/testrender.py laden eine URDF-Datei und rendern ein Bild, erhalten die Pixel (RGB, Tiefe, Segmentierungsmaske) und zeigen das Bild mit MatPlotLib an.

examples/pybullet/beispiele/testrender np.py Ähnlich wie testrender.py, aber beschleunigen Sie die Pixelübertragung mit NumPy-Arrays. Beinhaltet auch einfache Benchmarks/Timings.

Page 25 of the PyBullet Physics Engine user manual — Externe Kraft/Torque
Seite 25 · Zum Vergrößern klicken
Seite 25

examples/pybullet/beispiels/saveWorld.py Speichern Sie den Zustand (Position, Orientierung) von Objekten in Python-Skripte mit Pybullet. Dies ist vor allem nützlich, um eine Szene in VR einzurichten und den Anfangszustand zu speichern. Nicht jeder Staat ist serialisiert.

Beispiele/Pybullet/Beispiele/inverse kinematic s.py

Zeigen Sie, wie der Befehl calculatInverseKinematics verwendet wird und erstellen Sie eine Kuka ARM Uhr

Beispiele/pybullet/beispiele/rollPitchYaw.py Zeigen Sie, wie man Slider-GUI-Widgets verwendet

examples/pybullet/beispiele/constraint.py Programmatisch eine Einschränkung zwischen den Links erstellen.

Beispiele/pybullet/beispiele/vrhand.py Steuern Sie eine Hand mit einem VR-Handschuh, der von einer VR-Steuerung verfolgt wird. Siehe Video.

getBaseVelocity, resetBase Velocities

Sie erhalten Zugriff auf die lineare und Winkelgeschwindigkeit der Basis eines Körpers mit getBaseVelocity. Die Eingangsparameter sind:

required bodyUniqueId int body unique id, wie von den Load*-Methoden zurückgegeben.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Dies gibt eine Liste von zwei Vektor3-Werten (3 Floats in einer Liste) zurück, die die lineare Geschwindigkeit [x,y,z] und Winkelgeschwindigkeit [wx,wy,wz] in kartesischen Weltraumkoordinaten darstellen. Sie können die lineare und/oder Winkelgeschwindigkeit der Basis eines Körpers mit resetBaseVelocity zurücksetzen. Die Eingangsparameter sind:

required objectUniqueId int body unique id, wie von den load*-Methoden zurückgegeben.

optional linearVelocity vec3, Liste von 3 schwimmt linearer Geschwindigkeit [x,y,z] in Kartesian Weltkoordinaten.

optional angleVelocity vec3, Liste von 3 floats Winkelgeschwindigkeit [wx,wy,wz] in kartesischen Weltkoordinaten.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Externe Kraft/Torque

Sie können eine Kraft oder ein Drehmoment auf einen Körper mit applyExternalForce und applicationExternTorque anwenden. Beachten Sie, dass diese Methode nur funktioniert, wenn die Simulation mit stepSimulation explizit gestartet wird, d.h. setRealTimeSimulierung(0). Nach jedem Simulationsschritt werden die äußeren Kräfte auf Null abgebaut. Wenn Sie 'setRealTimeSimulation(1) verwenden, hat applyExternalForce/Torque undefiniertes Verhalten (entweder 0, 1 oder mehrere Kraft- / Drehmomentanwendungen).

Page 26 of the PyBullet Physics Engine user manual — createConstraint, removeConstract, changeConsTRAIN
Seite 26 · Zum Vergrößern klicken
Seite 26

Die Eingangsparameter sind:

required objectUniqueId int Object unique id as return by load methods.

linkIndex int Link Index oder -1 für die Basis erforderlich.

required forceObj vec3, Liste von 3 aufzubringenden Schwimmern Kraft-/Drehmomentvektoren [x,y,z]. Siehe Flaggen für Koordinatensystem.

erforderliche posObj vec3, Liste von 3 Schwimmer Position auf dem Link, wo die Kraft angewendet wird. Nur für applyExternalForce. Siehe Flaggen für Koordinatensystem.

Erforderliche Flaggen int Geben Sie das Koordinatensystem der Kraft/Position an: entweder WORLD FRAME für kartesische Weltkoordinaten oder LINK FRAME für lokale Link-Koordinaten.

getNumBodies, getBodyInfo, get BodyUniqueId, removeBody

getNumBodies gibt die Gesamtzahl der Körper im Physikserver zurück. Wenn Sie 'getNumBodies' verwendet haben, können Sie die eindeutigen Körper-IDs mit 'getBodyUniqueId' abfragen. Beachten Sie, dass alle APIs bereits Body-Unique-IDs zurückgeben, so dass Sie getBodyUniqueId normalerweise nie verwenden müssen, wenn Sie sie im Auge behalten. getBodyInfo gibt den Basisnamen zurück, wie er aus URDF, SDF, MJCF oder anderen Quellen extrahiert wurde.

Datei. removeBody entfernt einen Körper durch seine eindeutige ID (von loadURDF,loadSDF usw.).

createConstraint, removeConstract, changeConsTRAIN

URDF, SDF und MJCF spezifizieren artikulierte Körper als Baumstrukturen ohne Schleifen. Mit der 'createConstraint' können Sie bestimmte Verbindungen von Körpern verbinden, um diese Schleifen zu schließen. Siehe Bullet/beispiele/pybullet/beispielen/quadruped.py, wie man die Beine einer vierfach 5-bar-geschlossenen Schleife verbindet. Darüber hinaus können Sie beliebige Einschränkungen zwischen Objekten und zwischen einem Objekt und einem bestimmten Weltrahmen erstellen. Siehe Bullet/beispiele/pybullet/beispielen/constraint.py für ein Beispiel. Es kann auch verwendet werden, um die Bewegung von Physikobjekten zu steuern, angetrieben durch animierte Frames wie einen VR-Controller. Es ist besser, Einschränkungen zu verwenden, anstatt die Position oder Geschwindigkeit direkt für diesen Zweck festzulegen, da diese Beschränkungen zusammen mit anderen dynamischen Einschränkungen gelöst werden. createConstraint hat folgende Eingabeparameter:

optional physicsClientId int

Page 27 of the PyBullet Physics Engine user manual — getNumBodies, getBodyInfo, get BodyUniqueId, removeBody
Seite 27 · Zum Vergrößern klicken
Seite 27

required parentBodyUniqueId int parent body unique id

parentLinkIndex int parent link index (oder -1 für die Basis)

required childBodyUniqueId int Child Body unique id, oder -1 for no body (geben Sie einen nicht-dynamischen Kinderrahmen in Weltkoordinaten an)

childLinkIndex int Child Link Index oder -1 für die Basis

jointType int JointJOINT PRISMATIC, JOINT FIXE, JOINT*POINT2POINT, JOINT/GEAR

erforderliche jointAxis vec3, Liste von 3 Schwimmern Gelenkachse, in Child Link Rahmen

erforderliche parentFramePosition vec3, Liste von 3 schwebt Position des Gelenkrahmens relativ zum Elternzentrum des Massenrahmens.

Erforderliche childFramePosition vec3, Liste von 3 schwimmt Position des Gelenkrahmens relativ zu einem gegebenen Kinderzentrum der Masse Rahmen (oder Weltursprung, wenn kein Kind angegeben)

optional parentFrameOrientation vec4, Liste von 4 schwebt die Ausrichtung des Gelenkrahmens relativ zum Elternzentrum des Massenkoordinatenrahmens

optional childFrameOrientation vec4, Liste von 4 schwebt die Ausrichtung des Gelenkrahmens relativ zum Kinderzentrum des Massenkoordinatenrahmens (oder Weltursprungsrahmen, wenn kein Kind angegeben ist)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

createConstraint gibt eine ganzzahlige eindeutige ID zurück, mit der die Einschränkung geändert oder entfernt werden kann. Siehe Beispiele/pybullet/beispiele/mimicJointConstraint.py für ein Beispiel von JOINT GEAR und examples/pyculet/beispielen/minitaur.py for a JOART POINT2POINT and applications/pypullet/examples/constraind.py to JOINIT FIXED. changeConstraint

changeConstraint ermöglicht es Ihnen, Parameter einer bestehenden Einschränkung zu ändern. Die Eingangsparameter sind:

required userConstraintUniqueId int unique id zurückgegeben von createConstract

optional jointChildPivot vec3, Liste von 3 Floats aktualisierter Kinder-Pot, siehe 'createConstraint'

optional jointChildFrameOrientation vec4, Liste von 4 Floats aktualisiert Child Frame Orientierung als Quaternion

optional maxForce float maximale Kraft, die Einschränkung anwenden kann

Page 28 of the PyBullet Physics Engine user manual — getConstraintInfo/Staat
Seite 28 · Zum Vergrößern klicken
Seite 28

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Siehe auch Bullet/beispiele/pybullet/beispielen/constraint.py removeConstraind entfernt eine Einschränkung, die durch seine eindeutige ID gegeben ist. Seine Eingangsparameter sind:

required userConstraintUniqueId int unique id as return by createConsraint

optional physicsClientId int unique id as return by 'connect'

getNumConstraints, getConstrainingUniqueId

Sie können nach der Gesamtzahl von Einschränkungen abfragen, die mit 'createConstraint' erstellt wurden. Optionaler Parameter ist die int physicsClientId. getConstraintUniqueId

getConstraintUniqueId nimmt einen seriellen Index im Bereich 0..getNumConstracts und meldet die eindeutige Constraint-ID. Beachten Sie, dass die Constraint-Unique IDs möglicherweise nicht zusammenhängend sind, da Sie Einschränkungen entfernen können. Die Eingabe ist der Integer Serial Index und optional eine physicsClientId.

getConstraintInfo/Staat

Sie können die Einschränkungsinformationen abfragen und eine eindeutige Beschränkungs-ID angeben. Die Eingangsparameter sind

required constraintUniqueId int unique id wie von createConstraint zurückgegeben

optional physicsClientId int unique id as return by 'connect'

Die Ausgabeliste lautet:

parentBodyUniqueId int Siehe createConstraint

parentJointIndex int Siehe createConstraint

childBodyUniqueId int Siehe createConstraint

childLinkIndex int Siehe createConstraint

constraintType int See createConstraint

Page 29 of the PyBullet Physics Engine user manual — getDynamicsInfo/changeDynamik
Seite 29 · Zum Vergrößern klicken
Seite 29

jointAxis vec3, Liste der 3 Floats Siehe createConstraint

jointPivotInParent vec3, Liste der 3 Floats Siehe createConstraint

jointPivotInChild vec3, Liste der 3 Floats Siehe createConstraint

jointFrameOrientationParent vec4, Liste von 4 Floats Siehe createConstraint

jointFrameOrientationChild vec4, Liste von 4 Floats Siehe createConstraint

maxAppliedForce float Siehe createConstraint

getConstraintState

Geben Sie eine eindeutige Einschränkungs-ID an, können Sie im letzten Simulationsschritt nach den angewendeten Einschränkungen abfragen. Die Eingabe ist eine eindeutige Constraint-ID und die Ausgabe ein Vektor von Constraintkräften, ihre Dimension sind die Freiheitsgrade, die durch die Einschränkung beeinflusst werden (eine feste Beschränkung betrifft beispielsweise 6 DoF).

getDynamicsInfo/changeDynamik

Sie können Informationen über die Masse, den Massenschwerpunkt, Reibung und andere Eigenschaften der Basis und Verbindungen erhalten. Die Eingangsparameter für getDynamicsInfo sind:

required bodyUniqueId int object unique id, wie von loadURDF usw. zurückgegeben

LinkIndex int link (Joint) Index oder -1 für die Basis.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Die Rückgabeinformationen sind begrenzt, wir werden mehr Informationen preisgeben, wenn wir sie benötigen:

Masse Doppelmasse in kg

Seitenreibungs-Doppelreibwert

vec3, Liste von 3 schwimmt lokale Trägheit diagonal. Beachten Sie, dass Verbindungen und Basis um den Massenschwerpunkt herum zentriert sind und mit den Hauptträgheitsachsen ausgerichtet sind.

Lokale Trägheit pos vec3 Position des Inertialrahmens in lokalen Koordinaten des Gelenkrahmens

Lokale inertial orn vec4 Orientierung des Inertialrahmens in lokalen Koordinaten des Gelenkrahmens

Doppelter Rückgabekoeffizient

Diagonale der lokalen Trägheit

Page 30 of the PyBullet Physics Engine user manual — changeDynamics Ubersetzungen
Seite 30 · Zum Vergrößern klicken
Seite 30

Rollreibung Doppelrollreibzahl orthogonal zur Kontaktnormalen

Spinnreibung Doppelspinnreibung um die Kontaktnormale

Kontaktdämpfungsdoppel -1, falls nicht verfügbar. Dämpfung von Kontaktzwängen.

Kontaktsteifigkeit doppelt -1, falls nicht verfügbar. Steifigkeit der Kontaktzwangen.

changeDynamics Ubersetzungen

Sie können die Eigenschaften wie Masse, Reibung und Restitutionskoeffizienten mit changeDynamics ändern. Die Eingangsparameter sind:

required bodyUniqueId int object unique id, wie von loadURDF usw. zurückgegeben

benötigter linkIndex int Link Index oder -1 für die Basis

optionale Masse doppelt ändern Sie die Masse des Links (oder Basis für linkIndex -1)

optional lateralFriction doppelte seitliche (lineare) Kontaktreibung

optionale Spinnerei doppelte Torsionsreibung um die Kontaktnormalen

optionales RollenFriction doppelte Torsionsreibung orthogonal zur Kontaktnormalität

fakultative Rückgabe doppelter Kontaktfederung. Halten Sie es ein bisschen weniger als 1.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

optional linearDampfen doppelter Lineardämpfung der Verbindung (0.04 standardmäßig)

optionale Winkeldämpfung der Doppelwinkeldämpfe des Gliedes (0.04 standardmäßig)

optionale Kontaktsteifigkeit doppelter Steifheit der Kontaktzwänge, zusammen mit contactDamping verwendet.

optionaler KontaktDämpfen der doppelten Dämpfung der Berührungszwangen für diesen Körper/Link. Wird zusammen mit contactStiffness verwendet. Dieser Wert wird überschrieben, wenn er in der URDF-Datei im Kontaktabschnitt angegeben wurde.

optionale ReibungAnchor int Aktivieren oder Deaktivieren eines Reibankers: Lagekorrektur der Reibung (standardmäßig deaktiviert, sofern nicht im URDF-Kontaktabschnitt festgelegt)

optionale localInertiaDiagnoal vec3 Diagonale Elemente des Trägheitstensors. Beachten Sie, dass die Basis und Verbindungen um den Massenmittelpunkt zentriert sind und mit den Hauptträgheitsachsen ausgerichtet sind, so dass es keine außerdiagonalen Elemente in der Trägigkeit gibt

Page 31 of the PyBullet Physics Engine user manual — setPhysicsEngineParameter
Seite 31 · Zum Vergrößern klicken
Seite 31

Tensor.

setTimeStep

Sie können den Zeitschritt der Physik-Engine festlegen, der beim Aufruf von 'stepSimulation' verwendet wird. Es ist am besten, diese Methode nur zu Beginn einer Simulation aufzurufen. Ändern Sie diesen Zeitschritt nicht regelmäßig. setTimeStep kann auch mit der neuen setPhysicsEngineParameter API erreicht werden. Die Eingangsparameter sind:

Erforderlicher timeStep float Jedes Mal, wenn Sie 'stepSimulation' aufrufen, wird der timeStEP mit 'timeStep' fortgesetzt.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

setPhysicsEngineParameter

Sie können Physik-Engine-Parameter mit der setPhysicsEngineParameter API festlegen. Folgende Eingangsparameter sind belichtet:

optionaler FixedTimeStep float physics engine-Zeitschritt in Sekundenbruchteilen, jedes Mal wenn Sie 'stepSimulation' aufrufen. Wie "setTimeStep"

optional numSolverIterations int Wählen Sie die Anzahl der Constraint-Solutionr Iterationen.

optionale FunktionSplitImpulse int Advanced, nur bei Verwendung maximaler Koordinaten: Teilen Sie die Positions- und Geschwindigkeitsbegrenzungslösung in zwei Stufen auf, um eine enorme Penetration zu verhindern.

optional splitImpulsePenetrationThreshold float In Bezug auf 'useSplitImpulse': Wenn die Penetration für eine bestimmte Kontakteinschränkung kleiner als dieser angegebene Schwellenwert ist, wird kein Split-Impuls für diesen Kontakt auftreten.

optional numSubSteps int Unterteilen Sie den Physiksimulationsschritt durch 'numSubSchritte' weiter. Dies wird die Leistung über Genauigkeit handeln.

optionale KollisionFilterMode int Use 0 für Standard-Kollisionsfilter: (Gruppe A&maskB) UND (groupB&maskeA). Verwenden Sie 1 zum ODER-Kollisionsfilter: (Gruppe)

Page 32 of the PyBullet Physics Engine user manual — resetSimulation
Seite 32 · Zum Vergrößern klicken
Seite 32

optional contactBreakingThreshold float Kontaktpunkte mit einer Entfernung, die diesen Schwellenwert überschreitet, werden vom LCP-Solver nicht verarbeitet. Zusätzlich werden AABBs um diese Nummer erweitert. Standardmäßig 0,02 in Bullet 2.x.

optional maxNumCmdPer1ms int Experimental: Fügen Sie 1ms Schlaf hinzu, wenn die Anzahl der ausgeführten Befehle diesen Schwellenwert überschreitet.

optional enableFileCaching int Auf 0 setzen, um das Datei-Cachen zu deaktivieren, wie z. B. .obj wavefront file loading

optionale RestitutionVelocityThreshold float Wenn die Relativgeschwindigkeit unter diesem Schwellenwert liegt, ist die Rückgabe Null.

Parameter zur Verringerung des Fehlers bei der Reduzierung von Erp-Float-Einschränkungen (berührungslos, reibungsfrei)

optionaler Parameter zur Verringerung des Schwimmkontaktfehlers bei KontaktERP

optionaler Parameter für die Verringerung des Reibungsfehlers bei Schwimmern (wenn Lagereibungsanker aktiviert sind)

optional aktivierenConeFriction int Auf 0 setzen, um implizite Konusreibung zu deaktivieren und Pyramiden-Näherung (Konus ist standardmäßig) zu verwenden

optional deterministicOverlappingPairs int Setzen Sie auf 1 um das Sortieren von überlappenden Paaren zu aktivieren und 0, um es zu deaktivieren (Einstellung der Rückwärtskompatibilität).

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

setDefaultContactERP ist eine API zum Festlegen der Standardeinstellung des Kontaktparameters. Es wird in die setPhysicsEngineParameter API integriert. getPhysicsEngineParameters

Sie können einige aktuelle Parameter der Physik-Engine mit dem Befehl getPhysicsEngineParameters abfragen, indem Sie die optionale 'physicsClientId' verwenden. Dies gibt benannte Tupel von Parametern zurück.

resetSimulation

resetSimulation entfernt alle Objekte aus der Welt und setzt die Welt auf Anfangsbedingungen zurück. Es nimmt einen optionalen Parameter: die Physik-Client-ID (falls Sie mehrere Physikserververbindungen erstellt haben).

A&maskB ODER (groupB&maskeA)

Page 33 of the PyBullet Physics Engine user manual — startStateLogging/stopStatelogging
Seite 33 · Zum Vergrößern klicken
Seite 33

startStateLogging/stopStatelogging

Mit der Statusprotokollierung können Sie den Zustand der Simulation protokollieren, z. B. den Zustand eines oder mehrerer Objekte nach jedem Simulationsschritt (nach jedem Aufruf von stepSimulation oder automatisch nach jedem Simulatorschritt bei aktivierter setRealTimeSimration). Dies ermöglicht es Ihnen, Trajektorien von Objekten aufzuzeichnen. Es besteht auch die Möglichkeit, den gemeinsamen Zustand von Körpern wie Basisposition und -orientierung, Gelenkpositionen (Winkel) und gemeinsame motorische Kräfte zu protokollieren. Alle Log-Dateien, die mit startStateLogging generiert werden, können über C++ oder Python Skripte gelesen werden. Siehe quadruped playback.py und kuka with cube playBack.py für Python-Skripte, die Protokolldateien lesen. Sie können bullet3/examples/Utils/RobotLoggingUtil.cpp/h verwenden, um die Protokolldateien in C++ zu lesen. Für MP4-Videoaufnahmen können Sie die Logging-Option STATE LOGGING VIDEO MP4 verwenden. Wir planen, verschiedene andere Arten der Protokollierung zu implementieren, einschließlich des Zustands von VR-Controllern. Als Sonderfall haben wir die Protokollierung des Minitaur-Roboters implementiert. Die Protokolldatei aus der PyBullet-Simulation ist identisch mit der echten Minitaur Vierfachprotokolldatei. Siehe Bullet/beispiele/pybullet/beispielen/logMinitaur.py für ein Beispiel. Wichtig: Verschiedene Logger enthalten ihren eigenen internen Zeitstempel, der bei Null beginnt. Das bedeutet, dass Sie alle Logger gleichzeitig starten müssen, um synchron zu sein. Sie müssen sicherstellen, dass die Simulation beim Starten der Logger nicht im Echtzeitmodus ausgeführt wird: Verwenden Sie pybullet.setRealTimeSimulation(0) bevor Sie die Logger erstellen.

required loggingType int Es sind verschiedene Arten von Protokollierung implementiert. STATE LOGGING MINITAUR: Dies erfordert das Laden der quadruped/quadruping.urdf und die Objekt-Unique id aus dem Quadrupe. Es protokolliert den Zeitstempel, IMU Roll / Pitch / Gier, 8-Bein Motorpositionen (q0-q7), 8 Bein Motordrehmomente (u0-u7), die Vorwärtsgeschwindigkeit des Rumpfes und Mode (in der Simulation nicht verwendet). STATE LOGGING GENERIC ROBOT: Hierdurch wird ein Protokoll der Daten aller Objekte oder ausgewählter protokolliert (wenn objectUniqueIds bereitgestellt wird). STATE LOGGING VIDEO MP4: Dies öffnet eine MP4-Datei und startet das Streamen der OpenGL 3D-Visualisierungspixel mit einem ffmpeg pipe in die Datei. Es wird ffmpeg installiert erfordern. Sie können auch avconv (Standard auf Ubuntu) verwenden, erstellen Sie einfach einen symbolischen Link, so dass ffmpeg auf avConv verweist. Unter Windows hat ffmpeg einige Probleme, die in einigen Fällen zu Reiß- / Farbartefakten führen. STATE LOGGING CONTACT POINTS STATE PROTOKOLLING VR CONTROLLER.

Page 34 of the PyBullet Physics Engine user manual — startStateLogging/stopStatelogging
Seite 34 · Zum Vergrößern klicken
Seite 34

STATE LOGGING PROFILE TIMINGS Dies wird eine Timing-Datei im JSON-Format dumpen, die mit Google Chrome über://tracing LOAD geöffnet werden kann.

Dateiname String-Dateiname (absolut oder relativer Pfad), um die Protokolldateidaten zu speichern.

optional objectUniqueIds list of int Wenn leer gelassen, kann der Logger jedes Objekt protokollieren, ansonsten protokolliert der Loggger nur die Objekte in der ObjectUniqueIDs-Liste.

maxLogDof int Maximale Anzahl gemeinsamer Freiheitsgrade zum Loggen (ausgenommen die Basis-Dofs). Dies gilt für STATE LOGGING GENERIC ROBOT DATA. Standardwert ist 12. Wenn ein Roboter die Anzahl der Dofs überschreitet, wird er überhaupt nicht protokolliert.

optional bodyUniqueIdA int Gilt für STATE LOGGING CONTACT POINTS. Falls vorhanden,nur Protokoll-Kontaktstellen mit bodyUniqueIdA.

optional bodyUniqueIdB int Gilt für STATE LOGGING CONTACT POINTS. Falls vorhanden,nur Protokoll-Kontaktstellen mit bodyUniqueIdB.

optional linkIndexA int Gilt für STATE LOGGING CONTACT POINTS. Falls vorhanden,nur Protokoll-Kontaktstellen mit LinkIndexA für bodyUniqueIdA.

optional linkIndexB int Gilt für STATE LOGGING CONTACT POINTS. Falls vorhanden,nur Protokoll-Kontaktstellen mit LinkIndexB für bodyUniqueIdA.

optional deviceTypeFilter int deviceTypesfilter ermöglicht Ihnen die Auswahl, welche VR-Geräte Sie protokollieren möchten: VR DEVICE CONTROLLER, VR Device HMD ,VR DEvice GENeric TRACKER oder eine beliebige Kombination davon. Gilt für STATE LOGGING VR CONTROLLERS. Standardwerte sind VR DEVICE CONTROLLER.

optional logFlags int (nächstes PyBullet 1.3.1) STATE LOG JOINT TORQUES, um gemeinsame Drehmomente aufgrund von gemeinsamen Motoren zu protokollieren.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Der Befehl gibt eine nicht negative int loggingUniqueId zurück, die mit stopStateLogging verwendet werden kann. Todo: Dokumentieren Sie die Daten, die für jeden Protokollierungstyp protokolliert werden. Verwenden Sie vorerst die Protokollleseprogramme, um herauszufinden, oder überprüfen Sie den C++-Quellcode des Logging-oder Python dumpLog.py Skripts. stopStateLogging

Sie können einen Logger mit seiner loggingUniqueId stoppen. submitProfileTiming

fakultativ

Page 35 of the PyBullet Physics Engine user manual — computeViewMatrix
Seite 35 · Zum Vergrößern klicken
Seite 35

PyBullet und Bullet haben viele Funktionen instrumentiert, so dass Sie sehen können, wo die Zeit verbracht wird. Sie können diese Profil-Timings in eine Datei ablegen, die mit Google Chrome im Fenster about://tracing über die LOAD-Funktion angezeigt werden kann. In der GUI können Sie "p" drücken, um den Profil-Dump zu starten / zu stoppen. In einigen Fällen möchten Sie möglicherweise die Timings Ihres Clientcodes instrumentieren. Sie können Profil-Timings mit PyBullet einreichen. Hier ein Beispiel für die Ausgabe:

Synthetische Kamera-Rendering

PyBullet verfügt sowohl über einen Build-in OpenGL GPU Visualizer als auch über einen auf TinyRenderer basierenden Build-In CPU Renderer. Dies macht es sehr einfach, Bilder von einer beliebigen Kameraposition zu rendern. Die synthetische Kamera wird durch zwei 4 mal 4-Matrizen spezifiziert: die Ansichtsmatrix und die Projektionsmatrix. Da diese nicht sehr intuitiv sind, gibt es einige Helfermethoden, um die Ansichts- und Projektionsmatrix aus verständlichen Parametern zu berechnen.

computeViewMatrix

Die Eingangsparameter von computeViewMatrix sind

erforderliche cameraEyePosition vec3, Liste der 3 floats Augenposition in kartesischen Weltkoordinaten

required cameraTargetPosition vec3, Liste von 3 floats Position des Ziel- (Fokus) Punkt, in kartesischen Weltkoordinaten

cameraUpVector vec3, Liste der 3 Floats up Vektoren der Kamera, in kartesischen Weltkoordinaten

optional physicsClientId int unused,zur API-Konsistenz hinzugefügt

Ausgabe ist die 4x4-Ansichtsmatrix, gespeichert als Liste von 16 Floats. computeViewMatrixFromYawPitchRoll

Die Eingangsparameter sind

erforderliche cameraTargetPosition Liste von 3 Floats Zielfokuspunkt in kartesischen Weltkoordinaten

erforderliche Entfernung Schwimmabstand vom Auge zum Fokuspunkt

erforderlicher Gierschwimm-Gierwinkel in Grad links/rechts um die Hochachse.

erforderlicher Pitch-Float-Pitch in Grad nach oben/unten.

Page 36 of the PyBullet Physics Engine user manual — getCameraImage
Seite 36 · Zum Vergrößern klicken
Seite 36

erforderliche Rollfloat-Rolle in Grad um den Vorwärtsvektor

required upAxisIndex int entweder 1 für Y oder 2 für Z-Achse nach oben.

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

Ausgabe ist die 4x4-Ansichtsmatrix, gespeichert als Liste von 16 Floats.

computeProjectionMatrix

Die Eingangsparameter sind

erforderliche linke Float-Linksbildschirm (Canvas)

erforderliche rechte Float-Rechtsbildschirm (Canvas) koordinat

erforderliche Bottom-Float-Coordinate (Canvas)

erforderliche Top-Float-Koordinate (Canvas)

vorgeschrieben nahe am Schwimmkörper in der Nähe von Ebenen

erforderliche Fernschwimmer-Fernabmessung

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

Ausgabe ist die 4x4-Projektionsmatrix, gespeichert als Liste von 16 Floats. computeProjectionMatrixFOV

Dieser Befehl gibt auch eine 4x4-Projektionsmatrix zurück, die verschiedene Parameter verwendet. Sie können die OpenGL-Dokumentation auf die Bedeutung der Parameter überprüfen. Die Eingangsparameter sind:

erforderliches fov float Sichtfeld

erforderliches Aspekt-Float-Aspektverhältnis

erforderliche Nahabtriebsfläche nahe der Ebene

erforderliche farVal float Far-Plane-Entfernung

optional physicsClientId int unused, hinzugefügt für API-Konsistenz.

getCameraImage

Die getCameraImage API gibt ein RGB-Bild, einen Tiefenpuffer und eine Segmentierungsmaske mit körperspezifischen IDs sichtbarer Objekte für jedes Pixel zurück. Beachten Sie, dass PyBullet mit der Option numpy kompiliert werden kann: Die Verwendung von numpys verbessert die Leistung des Kopierens der Kamera

Page 37 of the PyBullet Physics Engine user manual — computeProjectionMatrix
Seite 37 · Zum Vergrößern klicken
Seite 37

Pixel von C bis Python. Hinweis: Die alte renderImage API ist veraltet und wird durch getCameraImage ersetzt. getCameraImage-Eingabeparameter:

erforderliche Breite int horizontale Bildauflösung in Pixeln

erforderliche Höhen-int vertikale Bildauflösung in Pixeln

optional viewMatrix 16 floats 4x4 View Matrix, siehe computeViewMatriX*

optional projectionMatrix 16 floats 4x4 Projektionsmatrix, siehe computeProjection*

optional lightDirection vec3, Liste von 3 floats Lichtrichtung

optional lightFarbe vec3, Liste von 3 schwimmt gerichtet Lichtfarbe in [RED, GREEN, BLUE] im Bereich 0..1

optional lightDistanzschwimmabstand des Lichts entlang der normalisierten lightDirection

optional Shadow int 1 für Schatten, 0 für keine Schatten

optional lightAmbientCoeff floatlight ambient coefficient

optional lightDiffuseCoeff float light diffus coefficient

optional lightSpecularCoeff float light spektischer Koeffizient

optionaler Renderer int ER BULLET HARDWARE OPENGL oder ER TINY RENDERER. Beachten Sie, dass der DIRECT-Modus keine OpenGL hat und daher ER TINY RENDERER erforderlich ist.

optionale Flags in ER SEGMENTATION MASK OBJECT AND L INKINDEX, siehe unten unter Beschreibung der SegmentierungMaskBuffer und Beispielcode.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getCameraImage gibt eine Liste von Parametern zurück:

Breite int Breite Bildauflösung in Pixeln (horizontal)

Bildauflösung in Höhe und Höhe in Pixeln (vertikal)

rgbPixels Liste von [char RED,char GREEN,char BLUE, list of pixel colors in R,G,B,A format]

Page 38 of the PyBullet Physics Engine user manual — getVisualShapeData
Seite 38 · Zum Vergrößern klicken
Seite 38

char ALPHA [0..width*height] in range [0,.255] für jede Farbe

depthPixels Liste des Schwimmer-Tiefenpuffers [0..width*height]

SegmentierungMaskBuffer-Liste von int [0..width*height] Nur verfügbar bei Verwendung von ER TINY RENDERER. Für jedes Pixel die sichtbare Objekt eindeutige ID. Wenn ER SEGMENTATION MASK OBJ ECT AND LINKINDEX verwendet wird, kombiniert die SegmentierungMaskBuffer den Objekt-Indikator und Linkindex wie folgt: value = objectUniqueId + (linkIndex+1)

getVisualShapeData

Sie können auf visuelle Forminformationen mit getVisualShapeData zugreifen. Sie können dies verwenden, um Ihre eigene Rendering-Methode mit der PyBullet-Simulation zu überbrücken und nach jedem Simulationsschritt manuell die Welttransformationen zu synchronisieren. Die Eingangsparameter sind:

required objectUniqueId int Object unique id, wie durch eine Load-Methode zurückgegeben.

optional physicsClientId int Physics client id wie von 'connect' zurückgegeben

Die Ausgabe ist eine Liste von visuellen Formdaten, jede visuelle Form hat das folgende Format:

objectUniqueId int Object unique id, identisch mit der Eingabe

linkIndex int Link Index oder -1 für die Basis

visualGeometryType int Visual geometry type (TBD)

Abmessungen vec3, Liste von 3 Floats-Dimensionen (Größe, lokaler Maßstab) der Geometrie

meshAssetFileName string, list of chars path to the triangle mesh (falls vorhanden). Typischerweise relativ zum URDF-, SDF- oder MJCF-Dateispeicherort, könnte aber absolut sein.

Page 39 of the PyBullet Physics Engine user manual — loadTextur
Seite 39 · Zum Vergrößern klicken
Seite 39

localVisualFrame-Position vec3, Liste von 3 floats Position des lokalen visuellen Rahmens, relativ zu Link / Joint Frame

localVisualFrame-Orientierung vec4, Liste von 4 Floats (Orientierungen des lokalen visuellen Rahmens relativ zum Link/Gelenkrahmen)

rgbaColor vec4, Liste von 4 URDF-Farben (falls angegeben) in rot/grün/blau/alpha

Die Physiksimulation verwendet das Massenzentrum als Referenz für die kartesischen Welttransformationen in getBasePositionAndOrientation und in GetLinkState. Wenn Sie Ihr eigenes Rendering implementieren, müssen Sie die lokale visuelle Transformation in den Weltraum transformieren und dabei das Zentrum der Massenwelttransformation und den (inversen) lokalen InertialFrame nutzen. Sie können über die getLinkState API auf den localInertialFrame zugreifen.

changeVisualShape, loadTexture

Sie können changeVisualShape verwenden, um die Textur einer Form zu ändern. Diese Textur betrifft derzeit nur den Software-Renderer (siehe getCameraImage), nicht das OpenGL Visualisierungsfenster (noch).

required objectUniqueId int Object unique id, wie durch Load-Methode zurückgegeben.

JointIndex int Link Index erforderlich

optional shapeIndex int Experimental für den internen Gebrauch, empfohlen ShapeIndex ignorieren oder -1 lassen. Die Absicht war, einen bestimmten Formindex zum Ändern auswählen zu lassen, da URDF (und SDF usw.) mehr als 1 visuelle Form pro Link haben können. Dieser shapeIndex entspricht der von getVisualShapeData zurückgegebenen Listenbestellung.

optional textureUniqueId int textur unique id, wie von der 'loadTexture'-Methode zurückgegeben

optional rgbaColor vec4, Liste von 4 Floats

Farbkomponenten für RED, GREEN, BLUE und ALPHA jeweils im Bereich [0..1] Alpha muss im Moment 0 (unsichtbar) oder 1 (sichtbar), noch keine Transparenz, sein.

Farbfarben-Spiegelkomponenten, RED, GREEN und BLUE können von 0 bis zu einer großen Anzahl (> 100) betragen.

required physicsClientId int Physics Client-ID wie von 'connect' zurückgegeben

loadTextur

Laden Sie eine Textur aus der Datei und geben Sie eine nicht negative Textur-Unique ID zurück, wenn das Laden erfolgreich ist. Diese eindeutige ID kann mit changeVisualShape verwendet werden.

Page 40 of the PyBullet Physics Engine user manual — Die getOverlappingObjects geben eine Liste von Objekt-Unique IDs zurück. getAABB
Seite 40 · Zum Vergrößern klicken
Seite 40

Kollisionserkennungsabfragen

Sie können die Kontaktpunktinformationen abfragen, die während der letzten 'stepSimulation' vorhanden waren. Um die Kontaktpunkte zu erhalten, können Sie die 'getContactPoints'-API verwenden. Beachten Sie, dass die 'getContactPoints' keine Kontaktpunktinformationen neu berechnen.

getOverlappingObjects, getAABB

Diese Abfrage gibt alle eindeutigen IDs von Objekten zurück, deren achsenorientierte Begrenzungsbox sich mit einer gegebenen achsgerichteten BegrenzungsBox überlappen. Beachten Sie, dass die Abfrage konservativ ist und möglicherweise zusätzliche Objekte zurückgibt, bei denen sich keine tatsächlichen AABB-Überlappungen befinden. Dies geschieht, weil die Beschleunigungsstrukturen eine Heuristik haben, die die AABBs ein wenig vergrößert (extra Margin und extrudiert entlang des Geschwindigkeitsvektors). Die Eingangsparameter von getOverlappingObjects sind:

erforderliche aabbMin vec3, Liste von 3 Floats Mindestkoordinaten des aabB

erforderliche aabbMax vec3, Liste von 3 Floats maximale Koordinaten der aabB

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Die getOverlappingObjects geben eine Liste von Objekt-Unique IDs zurück. getAABB

Sie können die achsenorientierte Begrenzungsbox (im Weltraum) abfragen, wenn eine eindeutige Objekt-ID und optional ein Linkindex angegeben sind. (Wenn Sie den Link-Index nicht übergeben oder -1 verwenden, erhalten Sie die AABB der Basis). Die Eingangsparameter sind

required bodyUniqueId int object unique id, wie von Erstellungsmethoden zurückgegeben.

optionaler linkIndex int Link Index im Bereich [0..getNumJoints(..)]

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Page 41 of the PyBullet Physics Engine user manual — getClosestPoints
Seite 41 · Zum Vergrößern klicken
Seite 41

Die Rückgabestruktur ist eine Liste von vec3, aabbMin (x,y,z) und aabBMax (x ,y ,z), die in den Koordinaten des Weltraums aufgeführt sind. Siehe auch das Beispiel getAABB.py.

getContactPoints, getClosestPoints

Die getContactPoints API gibt die Kontaktpunkte zurück, die während des letzten Aufrufs von stepSimulation berechnet wurden. Seine Eingangsparameter sind wie folgt:

optionale StelleA meldet nur Kontaktstellen, an denen die Stelle A beteiligt ist

optional bodyB meldet nur Kontaktstellen, an denen Body B beteiligt ist

optional linkIndexA int Melden Sie nur Kontaktstellen, an denen LinkIndexB von bodyA beteiligt ist

optional linkIndexB int Nur Kontaktstellen melden, die LinkIndex B von bodyB betreffen

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getContactPoints gibt eine Liste von Kontaktpunkten zurück. Jede Kontaktstelle hat folgende Felder:

bodyUniqueIdA int body eindeutige ID von Körper A

bodyUniqueIdB intbody eindeutige ID von Body B

linkIndexA int Link Index von Körper A, -1 für Basis

linkIndexB int Link Index von Body B, -1 für Base

positionOnA vec3, Liste der 3 Floats Kontaktposition auf A, in kartesischen Weltkoordinaten

positionOnB vec3, Liste der 3 Floats Kontaktposition auf B, in kartesischen Weltkoordinaten

contactNormalOnB vec3, Liste der 3 Floats Kontakt normal auf B, zeigt in Richtung A

Abstand Schwimmer-Kontaktabstand, positiv zum Trennen, negativ zum Eindringen

normalForce float normale Kraft, die während der letzten 'stepSimulation' aufgebracht wurde

getClosestPoints

contactFlag int reserved

Page 42 of the PyBullet Physics Engine user manual — rayTest, RayTestBatch
Seite 42 · Zum Vergrößern klicken
Seite 42

Es ist auch möglich, die nächstliegenden Punkte unabhängig von stepSimulation zu berechnen. Auf diese Weise können Sie auch nächstgelegene Punkte von Objekten mit einem beliebigen Abstand berechnen. In dieser Abfrage werden keine normalen Kräfte gemeldet. getClosestPoints-Eingangsparameter:

required bodyA int object unique id für das erste Objekt (A)

required bodyB int object unique id für zweites Objekt (B)

Wenn der Abstand zwischen Objekten diesen maximalen Abstand überschreitet, dürfen keine Punkte zurückgegeben werden.

optionaler linkIndexA int Link Index für Objekt A (-1 für Basis)

optionaler linkIndexB int Link Index für Objekt B (-1 für Basis)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

getClosestPoints gibt eine Liste der nächstgelegenen Punkte im gleichen Format wie getContactPoints zurück (normalForce ist in diesem Fall jedoch immer Null).

rayTest, RayTestBatch

Sie können einen einzelnen Raycast durchführen, um die Schnittpunktinformationen des ersten Objekttreffers zu finden. Die Eingangsparameter für RayTest sind:

required rayFromPosition vec3, Liste von 3 Floats Beginn des Strahls in Weltkoordinaten

required rayToPosition vec3, Liste der 3 Floats Ende des Strahls in Weltkoordinaten

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Die raytest-Abfrage gibt im Falle einer Kreuzung folgende Informationen zurück:

objectUniqueId int Object eindeutige ID des getroffenen Objekts

linkIndex int Link Index des Trefferobjekts oder -1, falls keine/Elternteil.

Trefferfraktion Float-Trefffraktion entlang des Strahls im Bereich [0,1] entlang des Strahlenganges.

Trefferposition vec3, Liste der 3 Floats in kartesischen Weltkoordinaten getroffen

Treffer normal vec3, Liste der 3 Floats trafen in kartesischen Weltkoordinaten normal

Page 43 of the PyBullet Physics Engine user manual — getCollisionShapeData
Seite 43 · Zum Vergrößern klicken
Seite 43

rayTestBatch

Dies ist ähnlich wie der RayTest, ermöglicht es Ihnen jedoch, ein Array von Strahlen für eine schnellere Ausführung bereitzustellen. Die Größe von 'rayFromPositions' muss der Größe von "rayToPositions" entsprechen. Sie können pro Strahl ein Ray-Ergebnis erhalten, auch wenn es keinen Schnittpunkt gibt: Sie müssen das Feld objectUniqueId verwenden, um zu überprüfen, ob der Ray etwas getroffen hat: Wenn die objectUniquid -1 ist, gibt es keinen Treffer. In diesem Fall ist der 'Treffer-Bruch' 1. Die maximale Anzahl von Strahlen pro Charge ist pybullet.MAX RAY INTERSECTION BATCH SIZE. Die Eingangsparameter für RayTest sind:

required rayFromPositions list of vec3, Liste der drei Floats

Liste der Startpunkte für jeden Strahl in Weltkoordinaten

required rayToPositions list of vec3, Liste der drei Floats

Liste der Endpunkte für jeden Strahl in Weltkoordinaten

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Die Ausgabe ist ein Strahlschnittergebnis pro Eingangsstrahl mit den gleichen Informationen wie in der obigen rayTest-Abfrage.

getCollisionShapeData

Sie können die Kollisionsgeometrie und andere Informationen zur Kollisionsform der vorhandenen Körperbasis und Links mit dieser Abfrage abfragen. Es funktioniert sehr ähnlich wie getVisualShapeData. Die Eingangsparameter für getCollisionShapeData sind:

required objectUniqueId int Object unique id, empfangen von loadURDF etc.

benötigter linkIndex int Link Index oder -1 für die Basis

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Der Rückgabewert ist eine Liste mit folgenden Inhalten:

object unique id int Object unique ed

Page 44 of the PyBullet Physics Engine user manual — BerechnetJacobian, MassMatrix
Seite 44 · Zum Vergrößern klicken
Seite 44

linkIndex int Link Index oder -1 für die Basis

Geometrietyp int geometrischer TypGEOM BOX, GEOM SPHERE, GEOM CAPSULE, GEOME MESH, GEOMA PLANE

Die Abmessungen vec3 hängen vom Geometrietyp ab: für GEOM BOX: Ausdehnungen, für GEom SPHERE-Dimensionen[0] = Radius, für geom CAPSULE und geom=cylinder, Dimensionen [0] gleich Höhe (Länge), Maße[1] = Radius. Für GEOM MESH sind Dimensionen der Skalierungsfaktor.

Dateiname-String Nur für GEOM MESHDateiname (und Pfad) der Kollisionsmessh-Asset

Lokale Position des Kollisionsrahmens in Bezug auf den Massen-/Trägheitsmittelpunkt.

Lokale Ausrichtung des Kollisionsrahmens in Bezug auf den Inertialrahmen.

Inverse Dynamik, Kinematik

calculatInverseDynamics

calculatInverseDynamics berechnet die Kräfte, die benötigt werden, um die gegebenen Gelenkbeschleunigungen zu erreichen, ausgehend von bestimmten Gelenkpositionen und -geschwindigkeiten. Die Eingangsparameter von calculatInverseDynamics sind:

required bodyUniqueId int body unique id, wie von loadURDF usw. zurückgegeben

Erforderliche objPositions Liste der Schwimmgelenkpositionen (Winkel) für jeden Freiheitsgrad (DoF). Beachten Sie, dass feste Verbindungen 0 Freiheitsgrade haben. Die Basis wird in allen Fällen übersprungen/ignoriert (floating Base und fixed base).

Liste der Schwimmgelenkgeschwindigkeiten für jeden Freiheitsgrad (DoF)

Liste der gewünschten Schwimmerbeschleunigungen für jeden Freiheitsgrad (DoF)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

calculatInverseDynamics gibt eine Liste von gemeinsamen Kräften für jeden Freiheitsgrad zurück.

BerechnetJacobian, MassMatrix

Berechnet wird jacobian die translationalen und rotatorischen jacobians für einen Punkt auf einem Link, z.B. x dot = J * q dote. Die zurückgegebenen jacobians unterscheiden sich geringfügig, je nachdem, ob der root-link fest oder schwimmend ist. Wenn sie schwimmen, werden die jacobians spalten enthalten, die den root-link-freiheitsgraden entsprechen; wenn fixiert, haben die jakobian nur säulen, die mit den gelenken verbunden sind. Der Funktionsaufruf nimmt die vollständige Beschreibung des kinematischen Zustands an, weil

Page 45 of the PyBullet Physics Engine user manual — berechnetMassenMatrix
Seite 45 · Zum Vergrößern klicken
Seite 45

CalculatInverseDynamics wird eigentlich zuerst aufgerufen und die gewünschten Jacobian werden daraus extrahiert; Daher ist es sinnvoll, Nullvektoren für Gelenkgeschwindigkeiten und Beschleunigungen zu passieren, wenn gewünscht. Die Eingangsparameter von calculatJacobian sind:

required bodyUniqueId int body unique id, wie von loadURDF usw. zurückgegeben

LinkIndex int link index für den jacobian.

Erforderliche localposition liste des float-punktes auf dem angegebenen link, um den jacobian zu berechnen.

Erforderliche objPositions Liste der Schwimmgelenkpositionen (Winkel)

erforderliche objVelocities-Liste der Schwimmergelenkgeschwindigkeiten

erforderliche objBeschleunigungsliste der gewünschten Schwimmerbeschleunigungen

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Berechnet jacobian kehrt zurück:

erforderliche lineareJacobian mat3x ((dof), (dof) (doff)

der translationale jacobian, x dot = J t * q doten.

Requirement angularJacobian mat3x ((dof), (dof) (doff)

Rotationsjakobian, r dot = J r * q dote.

berechnetMassenMatrix

Die Berechnung von MassMatrix berechnet die Systemträgheit für einen Gelenkkörper aufgrund seiner gemeinsamen Positionen.

required bodyUniqueId int body unique id, wie von loadURDF usw. zurückgegeben

erforderliches objPositionen-Array von Float

jointPositionen für jeden Link.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Das Ergebnis ist die quadratische Massematrix mit den Dimensionen dofCount * dofComunt, gespeichert als Liste von DofCount-Zeilen, jede Zeile ist eine Liste der DofCommund-Massenmatrixelemente. Inverse Kinematik

Sie können die Gelenkwinkel berechnen, durch die der Endeffektor eine bestimmte Zielposition im kartesischen Weltraum erreicht. Bullet verwendet intern eine verbesserte Version der Samuel Buss Inverse Kinematics Library. Im Moment nur die Damped Least Squares Methode mit oder ohne Null

Page 46 of the PyBullet Physics Engine user manual — calculatInverseKinematics
Seite 46 · Zum Vergrößern klicken
Seite 46

Die Raumkontrolle ist mit einem einzigen Endeffektor-Ziel ausgesetzt. Optional können Sie auch die Zielausrichtung des Endeffektors angeben. Darüber hinaus gibt es eine Option, den Nullraum zu verwenden, um gemeinsame Grenzen und Ruheposen festzulegen. Diese optionale Null-Space Unterstützung erfordert alle 4 Listen (lowerLimits, upperLimit, jointRanges, restPoses), ansonsten wird reguläre IK verwendet. Siehe auch inverse kinematics.py Beispiel im Ordner Bullet/beispiele/pybullet/beispielen für Details.

calculatInverseKinematics

calculatInverseKinematics Eingangsparameter sind:

required bodyUniqueId int body unique id, wie von loadURDF zurückgegeben

required endEffectorLinkIndex int-end effector link index (Deutsche Ausgabe)

required targetPosition vec3, Liste von 3 floats Zielposition im kartesischen Weltraum

optional targetOrientation vec3, Liste der 4 Floats Zielorientierung im kartesischen Weltraum, quaternion [x,y,w,z]. Wenn nicht angegeben, wird die reine Position IK verwendet.

optionale Liste der Floats von lowerLimits [0..nDof] Optionaler Nullraum IK erfordert alle 4 Listen (lowerLimit, upperLimit und jointRange). Ansonsten wird reguläres IK verwendet.

optional upperLimits Liste der Schwimmer [0..nDof] lowerLimit und upperLimis legen gemeinsame Grenzwerte fest

optional jointRanges Liste der Floats [0..nDof]

optionale restPoses Liste der Floats [0..nDof] Bevorzugung einer IK-Lösung näher an einer gegebenen Ruhepose

optional jointDamping Liste der Schwimmer [0..nDof] JointDampling ermöglicht die Abstimmung der IK-Lösung unter Verwendung von gemeinsamen Dämpfungsfaktoren

optionale Solver int p.IK DLS oder p.IK SDLS, Damped Least Squares oder Selective Damped Leath Squares, wie sie im Paper von Samuel Buss "Selectively Damped Lath Squares for Inverse Kinematics" beschrieben sind.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

calculatInverseKinematics gibt eine Liste gemeinsamer Positionen zurück. Siehe Bullet/beispiele/pybullet/inverse kinematics.py für ein Beispiel. Beachten Sie, dass die calculatInverseKinematics ein ungefähres Ergebnis in der Endeffektorposition liefern kann. Genauere Ergebnisse können Sie mit dem Beispielcode "pecificCalculateInverseKinematics" erhalten.

Page 47 of the PyBullet Physics Engine user manual — calculatInverseKinematics
Seite 47 · Zum Vergrößern klicken
Seite 47
Page 47 of the PyBullet Physics Engine user manual — calculatInverseKinematics
Page 48 of the PyBullet Physics Engine user manual — Umgebungen und Daten
Seite 48 · Zum Vergrößern klicken
Seite 48

Reinforcement Learning Gym Envs

Eine Suite von RL Gym Environments wird während "Pip install pybullet" installiert. Dazu gehören PyBullet-Versionen der OpenAI Gym Umgebungen wie Ameise, Hopper, Humanoid und Walker. Es gibt auch Umgebungen, die in der Simulation sowie auf reale Roboter gelten, wie das Ghost Robotics Minitaur vierfach vervierfacht, das MIT-Rennwagen und die KUKA Roboterarm greifende Umgebung. Der Quellcode von pybullet, pybulets envs, pysuLet data und die Beispiele sind hier: https://github.com/bulletphysics/bullets3/tree/master/examples/pybullet/gym Sie können die Umgebungen mit RL-Trainingsalgorithmen wie DQN, PPO, TRPO und DDPG trainieren. Mehrere vortrainierte Beispiele sind verfügbar, Sie können sie wie folgt genießen: pip install pybullet, Tensorflow, Fitnessstudio python -m pybullet envs.examples.enjoy TF HumanoidBulletEnv v0 2017kann pythaon - m pybollet envS.exambles.kukaGymEnva Test

Umgebungen und Daten

Nachdem Sie "sudo pip install pybullet" installiert haben, sind die Pakete pybullet envs und pybollt data verfügbar. Durch den Import des Pakets pybullet envs werden die Umgebungen automatisch bei OpenAI Gym registriert. Sie können eine Liste der Bullet-Umgebungen im Fitnessstudio mit folgender Python-Zeile erhalten: print()

PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 8 · Umgebungen und Daten
PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 9 · Umgebungen und Daten
PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 10 · Umgebungen und Daten
PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 11 · Umgebungen und Daten
PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 12 · Umgebungen und Daten
PyBullet Physics Engine — Umgebungen und Daten diagram (page 48)
Abb. 13 · Umgebungen und Daten
6 weitere Labels / Kurztext auf dieser Seite anzeigen
MinitaurBulletEnv-v0 · CartPoleBulletsEnV-vO · HumanoidBullettEn V-v 0 · RacecarBullétEn v-v0) AntBulletEenV-V0 · HopperBulLETEnFV
Page 49 of the PyBullet Physics Engine user manual — Reinforcement Learning Gym Envs
Seite 49 · Zum Vergrößern klicken
Seite 49
PyBullet Physics Engine — Reinforcement Learning Gym Envs diagram (page 49)
Abb. 14 · Reinforcement Learning Gym Envs
PyBullet Physics Engine — Reinforcement Learning Gym Envs diagram (page 49)
Abb. 15 · Reinforcement Learning Gym Envs

Die Simulation des Ghost Robotics Minitaur vervierfachte sich auf einem flachen Boden. Belohnung basierend auf der zurückgelegten Entfernung. Erstellen Sie die Klasse mit Gym: env = gym.make('MinitaurBulletEnv-v0') oder erstellen Sie die Umgebung direkt mit den Parametern: Importieren pybullet envs.bullet.minitaur gym enV als e envi = e.MinitauriRender=True

Simulation des MIT RC Racecar. Belohnung basierend auf der Entfernung zum zufällig platzierten Ball. Beobachtungen sind die Ballposition (x,y) im Kamerarahmen. Der Aktionsraum der Umgebung kann diskret (für DQN) oder kontinuierlich sein (für PPO, TRPO und DDPG). importieren pybullet envs.bullet.racecarGymEnv als e env = e.RacecarGYMEnV(isDiscrete=False,renders=True) envi.reset()

Ähnlich wie das RacecarBulletEnv-v0, aber Beobachtungen sind Kamerapixel.

Simulation des Roboterarms KUKA Iiwa, der ein Objekt in einem Tablett erfasst. Die Hauptbelohnung geschieht am Ende, wenn der Greifte das Objekt über einer bestimmten Höhe ergreifen kann. Einige sehr kleine Belohnung / Kosten passieren jeden Schritt: die Aktionskosten und der Abstand zwischen Greifer und Objekt. Die Beobachtung umfasst die x,y-Position des Objekts. Hinweis: Diese Umgebung hat derzeit Probleme beim Training, wir untersuchen sie.

KukaCamBulletEnv-v0 Das gleiche wie KukaBulletsEnV-vO, aber Beobachtung sind Kamerapixel.

8 weitere Labels / Kurztext auf dieser Seite anzeigen
KukaBulletEnv-v0 · HalfCheetahBulletsEnV-vO · Walker2DBullettEn V-v 0 · Beschreibung des Umweltnamens · MinitaurBulLetEn v-v0) RacecarBullétEnvix · RacecarZedBulleTEnVI
Page 50 of the PyBullet Physics Engine user manual — Reinforcement Learning Gym Envs
Seite 50 · Zum Vergrößern klicken
Seite 50

Wir portierten die Roboschool-Umgebungen auf Pybullet. Die Roboschool-Umgebungen sind härter als die MuJoCo Gym-Umgebung.

Ameisen sind schwerer und ermutigen sie, typischerweise zwei oder mehr Beine auf dem Boden zu haben.

Humanoid profitiert von realistischeren Energiekosten (= Drehmoment × Winkelgeschwindigkeit), die von der Belohnung abgezogen werden.

5 weitere Labels / Kurztext auf dieser Seite anzeigen
AntBulletEnv-v0 · HalfCheetahBulletsEnV-vO · HumanoidBullettEn V-v 0 · HopperBulleEn v-v0) Walker2DBulléTEnF
Page 51 of the PyBullet Physics Engine user manual — Trainieren und Genießen: DQN, PPO, ES
Seite 51 · Zum Vergrößern klicken
Seite 51

Es ist auch möglich, auf die Daten wie URDF/SDF-Roboter Assets und Wavefront.OBJ Dateien aus dem Paket pybullet data zuzugreifen. Hier ist ein Beispiel, wie dies zu tun: importieren pybullet Import pybullet data datapath = pybollt data.getDataPath() pybullet.connect(pybullet.GUI) pybullet .setAdditionalSearchPath(datapath) pylbullet:loadURDF("r2d2.urdf",[0,0,1]) Alternativ kann der Datenpfad manuell an den Dateinamen in den Befehlen loadURDF/SDF angefügt werden.

Trainieren und Genießen: DQN, PPO, ES

Für diskrete Gym-Umgebungen wie KukaBulletEnv-v0 und RacecarBulletsEnV-vO können Sie OpenAI Baselines DQN verwenden, um das Modell mit einem separaten Aktionsraum zu trainieren. Einige Beispiele bieten, wie Sie diese diskreten Umgebungen trainieren und genießen können: python -m pybullet envs.baselines.train pybullet/cartpole pytheon - m pybullet enVs. baselines. train pybrolet racecar OpenAI Baselines speichert eine .PKL-Datei in bestimmten Intervallen, wenn sich das Modell verbessert. Diese .PKL-Datei wird in den Enjoy-Skripten verwendet: python -m pybullet envs.baselines.enjoy pybullet/cartpole pytheon - m pybullet enVs. baselines.dejoy/pybullets racecar Es gibt auch einige vortrainierte Modelle, die Sie out-of-the-box genießen können. Hier ist eine Liste von vortrainierten Umgebungen zu genießen:

InvertedPendulumBulletEnv-v0 · InvertiertDoublePendelBulletsEnV-vO · InversionPenDulumSwingupBullettEnvid-v0)

Page 52 of the PyBullet Physics Engine user manual — Trainieren und Genießen: DQN, PPO, ES
Seite 52 · Zum Vergrößern klicken
Seite 52

python -m pybullet envs.examples.enjoy AntBulletEnv v0 2017kann pythan -m Pybullets envills.dejoy-Twist epod hop Lk kann pythan -m tybullet=envS.examples.envod infod toxcan können pyton -m m pybulllet denvs/example.engoy f InvertedDoublePendulumEnvat bumples.depad lcnet invertedCietupBullettEnV pjung inverdirtSWingupBimblerEnvit vo 2017können pytan-tv engs.componsedSwingup

Sie können verschiedene Pybullet-Umgebungen mit TensorFlow Agents PPO trainieren. Installieren Sie zuerst die erforderlichen Python-Pakete: pip install gym, tensorflow, agenten, pybullet, ruamel.yaml Dann für das Training verwenden: python -m pybullet envs.agents.train ppo --config=pybullet pendulum --logdir=pendutum Die folgenden Umgebungen sind als Agenten config verfügbar: pysullet pendulum pybollt pendelswingup pybrollet&cheetah pybust ant pybalt racecar pyballat minitaurSie können Tensorboard verwenden, um den Fortschritt des Trainings zu sehen: tensor board --logdir=pendel port=2222 Öffnen Sie einen Webbrowser und besuchen localhost:2222 Seite Hier ist ein Beispielgraph von Tensorboard für das Pendeltraining:

PyBullet Physics Engine — Trainieren und Genießen: DQN, PPO, ES diagram (page 52)
Abb. 16 · Trainieren und Genießen: DQN, PPO, ES

Nach dem Training können Sie das trainierte Modell visualisieren, ein Video erstellen oder es mit einem Physikserver (python -m pybullet envs.examples.runServer oder ExampleBrowser im Physik-Servermodus oder in Virtual Reality) visualisieren. Wenn Sie einen lokalen GUI-Physikserver starten, wird der Visualizer (bullet client.py) automatisch eine Verbindung herstellen

Page 53 of the PyBullet Physics Engine user manual — Trainieren und Genießen: DQN, PPO, ES
Seite 53 · Zum Vergrößern klicken
Seite 53

Dazu und verwenden Sie OpenGL-Hardwarerendering, um das Video zu erstellen. Andernfalls wird stattdessen der CPU-Tinangerer verwendet. Um das Video zu erzeugen, verwenden Sie: python -m pybullet envs.agents.visualize ppo --logdir=pendulum/xxxxx --outdir = pendulum video In ähnlicher Weise können Sie den Minitaur-Roboter trainieren und visualisieren: pYTHON -m Pybullets enVs.agenten.train ppos --config=pybullet minitaur --logDir=pybull minitauri Hier ist ein Beispiel für einen Gang des Minitaurus:https://www.youtube.com/watch?v=tfqCHDoFHRQ Evolutionsstrategien (ES)

Es gibt einen Blog-Artikel von David Ha (hardmaru), wie man PyBullet Umgebungen mit Evolution Strategies trainierthttp://blog.otoro.net/2017/11/12/evolving-stable-strategies. Zug mit PyTorch-PPO

Wir werden einige Beschreibungen hinzufügen, wie Sie mit PyTorch und Pybullet beginnen können. Siehe in der Zwischenzeit dieses Repository: https://github.com/ikostrikov/pytorch-a2c-ppo-acktr

Page 54 of the PyBullet Physics Engine user manual — getVREvents,setVRCameraState
Seite 54 · Zum Vergrößern klicken
Seite 54

Virtuelle Realität

Siehe auch die vrBullet Quickstart Anleitung. Der VR-Physikserver verwendet die OpenVR API für HTC Vive und Oculus Rift Touch Controller Unterstützung. OpenVR arbeitet derzeit an Windows, Valve arbeitet auch an einer Linux-Version. Siehe auchhttps://www.youtube.com/watch?v=VMJyZtHQL50 für ein Beispielvideo des VR-Beispiels, Teil von Bullet, das vollständig mit PyBullet über eine gemeinsame Speicher-, UDP- oder TCP-Verbindung gesteuert werden kann. Für VR unter Windows wird empfohlen, das Bullet Physics SDK mit Microsoft Visual Studio (MSVC) zu kompilieren. Erstellen Sie MSVC-Projektdateien, indem Sie das Skript "build visual studio vr pybullet double.bat" ausführen. Sie können dieses kleine Skript so anpassen, dass es auf den Standort von Python usw. zeigt. Wechseln Sie auf die Konfiguration "Freigeben" von MSVC und erstellen und ausführen der App PhysicsServer SharedMemory VR*.exe. Standardmäßig wird diese VR-Anwendung eine leere Welt mit Trackern / Controllern (falls verfügbar) präsentieren.

PyBullet Physics Engine — Virtuelle Realität diagram (page 54)
Abb. 17 · Virtuelle Realität

getVREvents,setVRCameraState

getVREvents gibt Listenereignisse für ausgewählte VR-Geräte zurück, die seit dem letzten Aufruf von getVREvents den Status geändert haben. Wenn kein deviceTypeFilter bereitgestellt wird, ist der Standardwert nur VR DEVICE CONTROLLER-Status zu melden. Sie können eine beliebige Kombination von Geräten wie VR DEVICE CONTROLLER, VR Device HMD (Head Mounted Device) und VR device GENeric Tracker wählen (wie den HTC Vive Tracker). Beachten Sie, dass VR DEVICE HMD und VR DeVICE/GENERIC TRACKER nur Positions- und Orientierungsereignisse melden. getVREvents hat folgende Parameter:

optional deviceTypeFilter int standardmäßig ist VR DEVICE CONTROLLER. Sie können auch VR DEVICE HMD oder VR DeVICE/GENERIC TRACKER oder eine beliebige Kombination davon wählen.

optional allAnalogAxes int 1 für alle analogen Achsen, 0 mit nur einer einzigen Achse

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen.

Die Ausgabeparameter sind:

Page 55 of the PyBullet Physics Engine user manual — Virtuelle Realität
Seite 55 · Zum Vergrößern klicken
Seite 55

controllerId int Controller-Index (0..MAX VR CONTROLLERS)

controllerPosition vec3, Liste der 3 floats Controllerposition, im Weltraum kartesische Koordinaten

controllerOrientation vec4, Liste der 4 floats Controller-Orientierung quaternion [x,y,z,w] im Weltraum

controllerAnalogueAxis float analoger Achsenwert

numButtonEvents int Anzahl der Button-Ereignisse seit dem letzten Aufruf von getVREvents

numMoveEvents int Anzahl der Move-Ereignisse seit dem letzten Aufruf von getVREvents

buttons int[64], Liste der Button-Zustände (OpenVR hat maximal 64 Buttons)

Flags für jede Schaltfläche: VR BUTTON IS DOWN (derzeit gedrückt), VR BOTTON/WAS TRIGGERED (wurde seit dem letzten Aufruf von getVREvents mindestens einmal heruntergefahren, vr BUNTON WAS*RELEASED) (wäre seit dem ersten Aufruf von GetVREventS mindestens einmal freigegeben). Beachten Sie, dass nur VR BUTTON IS DOWN den aktuellen Zustand meldet. Wenn der Button beispielsweise herunter und hoch ging, können Sie an den Flags RELEASE/TRIGGERED erkennen, obwohl IS DOWN immer noch falsch ist. Beachten Sie, dass diese Schaltflächen in der Protokolldatei mit 10 Tasten in 1 Ganzzahl (3 Bit pro Taste) gepackt sind.

deviceType int type des GerätsVR DEVICE CONTROLLER, VR/DEVICES HMD ODER VR-DEVICS GENERIC TRACKER

allAnalogAxes (nur wenn ausdrücklich gewünscht!)

Liste von derzeit 10 Floats, MAX VR ANALOGUE AXIS ist 5, für jede Achse x und y Wert.

Siehe Bullet/beispiele/pybullet/beispielen/vrEvents.py für ein Beispiel von VR-Zeichnung und Bullet / beispiele/ybullet / beispielen/ vrTracker.py, um HMD und generischen Tracker zu verfolgen. setVRCameraState

setVRCameraState ermöglicht es, die Position und Ausrichtung der Kamera-Roottransformation zu verstellen. Dies ermöglicht es, die Position der VR-Kamera in der virtuellen Welt zu steuern. Es ist auch möglich, die VR-Kamera ein Objekt wie z. B. ein Fahrzeug verfolgen zu lassen. setVRCameraState hat folgende Argumente (es gibt keine Rückgabewerte):

optional rootPosition vec3, Vektor von 3 floats Kamerawurzelposition

optional rootOrientation vec4, Vektor von 4 floats Kamerawurzelausrichtung im Format quaternion [x,y,z,w].

optional trackObject vec3, Vektor von 3 schwimmt die Objekt-Unique-ID zum Tracken

optional trackObjectFlag int flags.VR CAMERA TRACK OBJECT ORIENTATIO N (sofern aktiviert, werden sowohl Position als auch Orientierung verfolgt)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie

Page 56 of the PyBullet Physics Engine user manual — addUserDebugLine, Text
Seite 56 · Zum Vergrößern klicken
Seite 56

eine.

Debug GUI, Zeilen, Text, Parameter

PyBullet verfügt über einige Funktionen, die das Debuggen, Visualisieren und Tune der Simulation erleichtern. Diese Funktion ist nur nützlich, wenn es ein 3D-Visualisierungsfenster gibt, z. B. den GUI-Modus oder wenn Sie mit einem separaten Physikserver verbunden sind (z. B: Beispielbrowser im Modus "Physics Server" oder Standalone Physics Server mit OpenGL GUIS).

addUserDebugLine, Text

Sie können eine 3D-Linie hinzufügen, die durch einen 3D Startpunkt (von) und Endpunkt (bis), eine Farbe [rot, grün, blau], eine Linienbreite und eine Dauer in Sekunden angegeben wird. Die Argumente für addUserDebugline sind:

erforderliche lineFromXYZ vec3, Liste von 3 Floats

Startpunkt der Linie in kartesischen Weltkoordinaten

erforderliche lineToXYZ vec3, Liste von 3 Floats

Endpunkt der Linie in den Koordinaten der kartesischen Welt

optional lineColorRGB vec3, Liste von 3 Schwimmern

RGB-Farbe [Rot, Grün, Blau] jede Komponente im Bereich [0..1]

optionale LinieWidth float line width (begrenzt durch OpenGL-Implementierung)

optional lifeTime float Verwendung 0 für permanente Linie, oder positive Zeit in Sekunden (danach wird die Zeile automatisch entfernt)

optional parentObjectUniqueId int new im kommenden PyBullet 1.0.8: Zeichnen Sie eine Linie in lokalen Koordinaten eines übergeordneten Objekts/Links.

optional parentLinkIndex int new im kommenden PyBullet 1.0.8: Zeichnen Sie eine Linie in lokalen Koordinaten eines übergeordneten Objekts/Links.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

addUserDebugLine gibt eine nicht negative eindeutige ID zurück, mit der Sie die Zeile über removeUsersendDebuggItem entfernen können. addUserDebugText

Sie können an einem bestimmten Ort einen 3D-Text mit einer Farbe und Größe hinzufügen. Die Eingangsargumente lauten:

Page 57 of the PyBullet Physics Engine user manual — addUserDebugParameter
Seite 57 · Zum Vergrößern klicken
Seite 57

Texttext, der als Zeichenkette dargestellt wird (Zeichenreihe)

required textPosition vec3, Liste von 3 Floats

3d Position des Textes in kartesischen Weltkoordinaten [x,y,z]

optional textColorRGB vec3, Liste von 3 Floats

RGB-Farbe [Rot, Grün, Blau] jede Komponente im Bereich [0..1]

optional textSize float Textgröße

optional lifeTime float verwenden 0 für permanenten Text oder positive Zeit in Sekunden (danach wird der Text automatisch entfernt)

optional textOrientation vec4, Liste von 4 Floats

Standardmäßig wird Debug-Text immer der Kamera gegenüberstehen, automatisch rotieren. Durch die Angabe einer Textorientierung (Quarternion) wird diese im Weltraum oder lokalen Raum festgelegt (wenn das Elternsystem angegeben ist). Beachten Sie, dass eine andere Implementierung / Shader für kameragerichteten Text mit unterschiedlichem Aussehen verwendet wird: Kameragewandter Text verwendet Bitmap-Schriftarten, Text mit spezifizierter Ausrichtung verwendet TrueType-Schrifte.

optional parentObjectUniqueId int new im kommenden PyBullet 1.0.8: Zeichnen Sie eine Linie in lokalen Koordinaten eines übergeordneten Objekts/Links.

optional parentLinkIndex int new im kommenden PyBullet 1.0.8: Zeichnen Sie eine Linie in lokalen Koordinaten eines übergeordneten Objekts/Links.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

addUserDebugText gibt eine nicht negative eindeutige ID zurück, mit der Sie die Zeile über removeUsersendFig. Siehe auch pybullet/beispiele/debugDrawItems.py

addUserDebugParameter

Mit addUserDebugParameter können Sie benutzerdefinierte Schieberegler hinzufügen, um Parameter zu stimmen. Es wird eine einzigartige ID zurückgegeben. Auf diese Weise können Sie den Wert des Parameters mit readUserDebugParameter lesen. Die Eingangsparameter von addUserDebugParameter sind:

erforderlich paramName string name des Parameters

erforderliches rangeMin float Minimum

erforderlicher BereichMax float Maximalwert

erforderlich startValue float Startwert

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Page 58 of the PyBullet Physics Engine user manual — setDebugObjectColor
Seite 58 · Zum Vergrößern klicken
Seite 58

Die Eingangsparameter von readUserDebugParameter sind:

required itemUniqueId int the unique id return by 'addUserDebugParameter'

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Der Rückgabewert ist der aktuellste Wert des Parameters. removeUserDebugItem/All

Die Funktionen zum Hinzufügen von Benutzer-Debugzeilen, Text oder Parametern geben eine nicht negative eindeutige ID zurück, wenn sie erfolgreich ist. Sie können das Debug-Element mit dieser eindeutigen ID entfernen, indem Sie die removeUserDebugItem-Methode verwenden.Die Eingabeparameter sind:

required itemUniqueId int unique id des zu entfernenden Debug-Elements (Zeile, Text etc.)

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

removeAllUserDebugItems

Diese API entfernt alle Debug-Elemente (Text, Zeilen usw.).

setDebugObjectColor

Die integrierten OpenGL-Visualisierungsgeräte verfügen über eine Wireframe-Debug-Rendering-Funktion: Drücken Sie "w", um zu schalten. Der Wireframe hat einige Standardfarben. Sie können die Farbe eines bestimmten Objekts überschreiben und mit setDebugObjectColor verlinken. Die Eingangsparameter sind:

required objectUniqueId int unique id des Objekts

benötigter linkIndex int Link Index

optional objectDebugColorRGB vec3, Liste von 3 floats debugg Farbe in [Rot, Grün, Blau]. Wenn nicht vorgesehen, wird die benutzerdefinierte Farbe entfernt.

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Page 59 of the PyBullet Physics Engine user manual — get/resetDebugVisualizerCamera
Seite 59 · Zum Vergrößern klicken
Seite 59

configurationDebugVisualizer

Sie können einige Einstellungen des integrierten OpenGL-Visualisierungstools konfigurieren, z. B. das Aktivieren oder Deaktivieren von Wireframe, Shadows und GUI-Rendering. Dies ist nützlich, da einige Laptops oder Desktop-GUIs Leistungsprobleme mit unserem OpenGL 3-Visualizer haben.

ERFORDERLICHES FLAG IN DEM FEATURE ZUM AKTIVIEREN ODER DEAKTIVIEREN, WIE COV ENABLE WIREFRAME, COV ENABLE/SHADOWS,COV ENABILITY GUI, COVI ENIVE VR PICKING, COV ENATIVE VR TELEPORTING, COIV EN ABLE RENDERING,COV INY RENDER, COVA ENBLE VRS CONTROLLERS, COVO ENILE KEYBOARD SHORTCUTS, COV DEABLE MOUSE PICKED, COW ENLE Y AXIS UP (Z IST DIE STANDARD-WELTACHSE),COV ENBARE RGB BUFFER PREVIEW, COVIS ENALE DEPTH BUCKER PREVISION, COVE ENIBLE TIEFE BUUFF PREVIEW

required enable int 0 oder 1

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Beispielpybullet.co nfigureDebugVisualizer( pybullet.CO V ENABLE WIREFRAM,1)

get/resetDebugVisualizerCamera

Sie können den 3D OpenGL Debug Visualizer Kameraabstand (zwischen Augen- und Kamerazielposition), Kamera Gier und Tonhöhe sowie die Kameraziellage zurücksetzen.

erforderliche KameraFentation von der Zielposition des Auges zur Zielposition

erforderliche KameraYaw float camera Gierwinkel (in Grad) links/rechts

erforderlich cameraPitch float Kamera Pitchwinkel (in Grad) nach oben/unten

cameraTargetPosition vec3, Liste der 3 Floats CameraTargePosition ist der Fokuspunkt der Kamera

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Page 60 of the PyBullet Physics Engine user manual — getKeyboardEvents, getMouseEvents
Seite 60 · Zum Vergrößern klicken
Seite 60

Beispiel: pybullet.resetDebugVisualizerCamera( cameraDistance=3, cameraYaw=30, cameraPitch=52, cameraTargetPosition=[0,0,0) getDebuggVisalizerCama

Sie können die Breite und Höhe (in Pixeln) der Kamera, ihre Ansicht und Projektionsmatrix mit diesem Befehl abrufen. Der Eingabeparameter ist die optionale physicsClientId. Die Ausgabeinformationen sind:

Breite int Breite des Kamerabildes in Pixeln

Höhe int Höhe des Kamerabildes in Pixeln

viewMatrix float16, Liste der 16 Floats

Ansichtsmatrix der Kamera

projectionMatrix float16, Liste der 16 Floats

Projektionsmatrix der Kamera

cameraUp float3, Liste von 3 Floats

nach oben gerichtete Achse der Kamera, in kartesischen Weltraumkoordinaten

cameraForward float3, Liste von 3 Floats

Vorderachse der Kamera, in kartesischen Weltraumkoordinaten

horizontaler Float3, Liste von 3 Schwimmern

TBD. Dies ist ein horizontaler Vektor, der zur Erzeugung von Strahlen verwendet werden kann (zum Beispiel zum Mauspicken oder Erstellen eines einfachen Raytracers).

vertikaler Float3, Liste von 3 Schwimmern

TBD.Dies ist ein vertikaler Vektor, der verwendet werden kann, um Strahlen zu erzeugen (zum Beispiel für die Mausauswahl oder das Erstellen eines einfachen Raytracers).

Gierwinkel der Kamera, in kartesischen lokalen Raumkoordinaten

Pitch-Float-Pitchwinkel der Kamera, in kartesischen lokalen Raumkoordinaten

Dist-Float-Abstand zwischen Kamera und Zielkamera

Target Float3, Liste von 3 Floats

Ziel der Kamera, in kartesischen Weltraumkoordinaten

getKeyboardEvents, getMouseEvents

Sie können alle Keyboard-Events erhalten, die seit dem letzten Mal aufgetreten sind, als Sie 'getKeyboardEvents' aufgerufen haben. Jedes Ereignis hat einen Schlüsselcode und einen Zustand. Der Zustand ist eine Bit-Flag Kombination aus KEY IS DOWN, KEy WAS TRIGGERED und Key Was RelEASED. Wenn ein Schlüssel von "oben" zu "unten" wechselt, erhalten Sie den Zustand KEY IS DOWN sowie den Status KEy WAS TRIGGERED. Wenn eine Taste gedrückt und freigegeben wurde, ist der Zustand KEY IS DOWN und KEy WAS RELEASED.

Page 61 of the PyBullet Physics Engine user manual — Bauen und installieren Sie PyBullet
Seite 61 · Zum Vergrößern klicken
Seite 61

EINIGE SPEZIELLE SCHLÜSSEL SIND DEFINIERT: B3G F1 ... B3 G F12, B3G LEFT ARROW, B3-G RIGHT ARROW; B3 G UP ARROW — B3-G DOWN ARROW Der Input von getKeyboardEvents ist eine optionale physicsClientId:

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Die Ausgabe ist ein Wörterbuch des Keycode 'key' und Tastaturzustands 'value'. getMouseEvents

Ähnlich wie bei getKeyboardEvents können Sie die Mausereignisse abrufen, die seit dem letzten Aufruf von getMouseEvents aufgetreten sind. Alle Mausbewegungsereignisse werden zu einem einzigen Mausbewegung-Ereignis mit der aktuellsten Position zusammengeführt. Zusätzlich werden alle Maustastenereignisse für eine bestimmte Schaltfläche zusammengeführt. Wenn ein Button herunter und hoch ging, wird der Zustand 'KEY WAS TRIGGERED' sein. Wir verwenden den KEY WAS TRIGGERED /KEY IS DOWN /KeY WAS RELEASED für die Maustastenzustände. Eingabeargumente für getMouseEvents sind:

optional physicsClientId int, wenn Sie mit mehreren Servern verbunden sind, können Sie einen auswählen

Die Ausgabe ist eine Liste von Mausereignissen im folgenden Format:

eventTyp int MOUSE MOVE EVENT=1, MOUSe BUTTON EVEND=2

mousePosX float x-Koordinaten des Mauszeigers

mousePosY float y-Koordinaten des Mauszeigers

buttonIndex int-Button Index für Links/Mitte/Rechts Maustaste

buttonStaatskennzeichen KEY WAS TRIGGERED /KEY IS DOWN/KEy WASS RELEASED

Bauen und installieren Sie PyBullet

Es gibt einige verschiedene Möglichkeiten, PyBullet unter Windows, Mac OSX und Linux zu installieren. Wir verwenden Python 2.7 und Python 3.5.2, aber wir erwarten, dass die meisten Versionen von Python 2.x und Python 3.x funktionieren sollten. Am einfachsten ist es, PyBullet zum Arbeiten zu bringen, wenn man pip oder python setup.py verwendet:

Page 62 of the PyBullet Physics Engine user manual — Verwenden von Python Pip
Seite 62 · Zum Vergrößern klicken
Seite 62

Verwenden von Python Pip

Stellen Sie sicher, dass Python und Pip installiert sind, und führen Sie dann aus: pip install pybullet Beachten Sie, dass es bei Verwendung von Pip zur Installation von PyBullet immer noch vorteilhaft ist, auch das C++ Bullet Physics SDK zu installieren: Es enthält Datendateien, Physikserver und Tools, die für Py Bullet nützlich sind. Sie können auch 'python setup.py build' und 'python setup.pi install' in der Wurzel des Bullet Physics SDK ausführen (das SDK erhalten von)http://github.com/bulletphysics/bullets3) Siehe auchhttps://pypi.python.org/pypi/pybullet Alternativ können Sie PyBullet aus dem Quellcode mit Premake (Windows) oder Cmake installieren: Verwenden von Premake für Windows

Stellen Sie sicher, dass einige Python-Versionen in c:\python-3.5.2 (oder einem anderen Versionsordnernamen) installiert sind Holen Sie sich zuerst den Quellcode von github mithilfe des Gitklonshttps://github.com/bulletphysics/bullets3 Klicken Sie auf build visual studio vr pybullet double.bat und öffnen Sie das Projekt 0 Bullet3Solution.sln in Visual Studio, konvertieren Sie Projekte bei Bedarf. Wechseln Sie in den Release-Modus und kompilieren Sie das "Pybullet" -Projekt.

PyBullet Physics Engine — Verwenden von Python Pip diagram (page 62)
Abb. 18 · Verwenden von Python Pip

Dann gibt es ein paar Optionen zum Importieren von Pybullet in einem Python-Interpreter:

1. Benennt pybullet vs2010.dll in pybull.pyd und startet den Python.exe-Interpreter mit bullet/bin als aktuellem Arbeitsverzeichnis. Optional zum Debuggen: Umbenennen Sie bullet/bin/pybullet vs2010 debug.dll zu pybullet&d.pyd und starten Sie python d.exe) 2 Benennt Bullet/bin /pybullets vS 2010.dl in pybulllet.pyD und verwendet die Befehlsanweisung PYTHONPATH=c:\develop\bullet3\bin (ersetzen mit dem tatsächlichen Ordner, in dem sich Bullet befindet) oder erstellen Sie diese Umgebungsvariable PYThONPATHER unter Verwendung von Windows GUI 3) Erstellen Sie eine Administratoraufforderung (cmd.Exe) und erstellen Sie einen symbolischen Link wie folgt
Page 63 of the PyBullet Physics Engine user manual — Verwenden von Python Pip
Seite 63 · Zum Vergrößern klicken
Seite 63

cd c:\python-3.5.2\dlls

mklink pybullet.pyd c:\develop\bullet3\bin\pybullet vs2010.dll Dann führen Sie python.exe aus und importieren Pybullets sollte funktionieren. Mit cmake auf Linux und Mac OSX

1. Download und Installation von cmake 2) Führen Sie das Shell-Skript im Stammbuch aus Bullet: build cmake pybullet double.sh 3 Stellen Sie sicher, dass Python unser pybullet.so Modul findet: Exportieren PYTHONPATH = / your path to bullet/build c Make/examples/pybullets Das ist es. Testen Sie das Pybullet, indem Sie einen Python-Interpreter ausführen und geben Sie "Pybullets importieren" ein, um zu sehen, ob das Modul geladen wird. Wenn ja, können Sie mit den Pybullet-Skripten in Bullet / Beispiele / Pietro spielen. Mögliche Mac OSX Probleme
  • Wenn Sie Probleme beim Importieren von Pybullet auf Mac OSX haben, stellen Sie sicher, dass Sie den richtigen Python-Interpreter ausführen und die in -DPYTHON INCLUDE DIR und -DPyldon LIBRARY festgelegten Inklusionsbibliotheken (mit cmake) verwenden. Es ist möglich, dass Sie mehrere Python-Interpreter installiert haben, zum Beispiel bei der Verwendung von Homebrew. Siehe diesen Kommentar als Beispiel. Mögliche Linux-Probleme
  • Stellen Sie sicher, dass OpenGL installiert ist
  • Wenn Sie Anaconda als Python-Verteilung verwenden, installieren Sie conda libgcc so dass „GLIBCXX gefunden wird (siehe <a href="http://askubuntu.com/questions/575505/glibcxx-3-4-20-not-found-how-to-fix-this-error" rel="nofollow noopener" target=" blank">httP://askutuntu.de/questments/57555/gLibbxx-3-4-20-nots-foand-how -to-fin-this -errors</a>)
  • Es ist möglich, dass cmake die Python-Libs nicht finden kann, wenn Anaconda als Python-Verteilung verwendet wird. Sie können sie manuell hinzufügen, indem Sie zur ../build cmake/CMakeCache.txt-Datei gehen und folgende Zeile ändern:
Page 64 of the PyBullet Physics Engine user manual — Support, Tipps, Citation
Seite 64 · Zum Vergrößern klicken
Seite 64

„PYTHON LIBRARY:FILEPATH=/usr/lib/python2.7/config-x86 64-linux-gnu/libpythan2.7 .so GPU oder virtuelle Maschine ohne OpenGL 3

  • Standardmäßig verwendet PyBullet OpenGL 3. Einige Remote-Desktopumgebungen und GPUs unterstützen OpenGL 3 nicht, was zu Artefakten (grauer Bildschirm) oder sogar Abstürzen führt. Sie können das Flag --opengl2 verwenden, um auf OpenGL 2 zurückzugreifen. Dies wird nicht vollständig unterstützt, aber es gibt Ihnen eine Möglichkeit, die Szene zu sehen.:

○ pybullet.connect(pybullet.GUI,options="--opengl2") ● Alternativ können Sie den Physikserver mit UDP oder TCP Bridge auf dem Remotecomputer ausführen und sich über das UDP Tunneling vom lokalen Laptop zum entfernten Server verbinden. (todo: Schritte im Detail beschreiben)

Support, Tipps, Citation

Frage: Wohin gehen wir, um Unterstützung zu erhalten und Probleme zu melden? Antwort: Es gibt ein Diskussionsforum beihttp://pybullet.org/Bullet und ein Issue Tracker beihttps://github.com/bulletphysics/bullets3 Frage: Wie fügen wir ein Zitat zu PyBullet in unserer wissenschaftlichen Arbeit hinzu? Antwort: @MISC{coumans2018),

Autor = {Erwin Coumans und Yunfei Bai}, Titel = {PyBullet, ein Python-Modul für Physiksimulationen für Spiele, Robotik und maschinelles Lernen}, Howpublished = {\url{)http://pybullet.org } year = {2016--2018} } Frage: Was passiert mit Bullet 2.x und der OpenCL Implementierung von Bullet 3? Antwort: PyBullet wickelt die Bullet C-API ein. Wir werden die Bullet 3 OpenCL GPU API (und zukünftige Bullet 4.x API) hinter diese C-API stellen. Wenn Sie also PyBullet oder die C-API verwenden, sind Sie zukunftssicher. Nicht zu verwechseln mit der Bullet 2.x C++ API. Frage: Sollte ich Drehmoment / Kraftsteuerung oder Geschwindigkeits- / Positionsregelung verwenden? Im Allgemeinen ist es am besten, mit der Positions- oder Geschwindigkeitskontrolle zu beginnen. Es wird viel mehr Aufwand erfordern, um Kraft-/Drehmomentenregelung zuverlässig arbeiten zu lassen. Frage: Wie kann man die Schwerkraft nur für einige Teile eines Roboters (z. B. den Arm) abschalten? Antwort:

Im Moment ist dies nicht ausgesetzt, so dass Sie entweder für alle Objekte eine Schwerkraftbeschleunigung durchführen und manuell Gravitation auf die Objekte anwenden müssen, die sie benötigen.

Page 65 of the PyBullet Physics Engine user manual — Support, Tipps, Citation
Seite 65 · Zum Vergrößern klicken
Seite 65

Oder Sie können aktiv die Schwerkraftkompensationskräfte berechnen, wie es bei einem echten Roboter der Fall ist. Da Bullet über ein vollständiges Einschränkungssystem verfügt, wäre es trivial, diese Antigravitationskräfte zu berechnen: Sie könnten eine zweite Simulation ausführen (PyBullet ermöglicht Ihnen die Verbindung mit mehreren Physikservern) und den Roboter unter Schwerkraft positionieren, die gemeinsame Positionssteuerung so einstellen, dass sie die gewünschte Position behält, und diese "Anti-Schwerkraft" -Kräfte sammeln. Wenden Sie diese dann in der Hauptsimulation an. Frage: Wie skalieren Sie Objekte nach oben / unten? Antwort: Sie können den globalScaleFactor-Wert als optionales Argument für loadURDF undloadSDF verwenden. Ansonsten ist die Skalierung von visuellen Formen und Kollisionsformen Teil der meisten Dateiformate, wie URDF und SDF. Im Moment können Sie Objekte nicht neu skalieren. Frage: Wie kann ich Texturen in meinen Modellen erhalten? Antwort: Sie können das Wavefront .obj-Dateiformat verwenden. Dies unterstützt Materialdateien (.mtl). Es gibt verschiedene Beispiele mit Texturen im Bullet / Datenordner. Sie können die Textur für vorhandene texturierte Objekte mit der API "changeTexture" ändern. Frage: Welche Texturdateiformate sind für PyBullet gültig? Antwort: Bullet verwendet stb image, um Texturdateien zu laden, die PNG, JPG, TGA, GIF usw. laden. siehe stb image.h für Details. Frage: Wie kann ich die Leistung und Stabilität der Kollisionserkennung verbessern? Antwort: Es gibt viele Möglichkeiten zur Optimierung, zum Beispiel Formtyp 1 Wählen Sie einen oder mehrere primitive Kollisionsformtypen wie Box, Kugel, Kapsel, Zylinder aus, um ein Objekt zu approximieren, anstatt konvexe oder konkave Dreieckmaschen zu verwenden. Wenn Sie wirklich Dreiecksmaschen verwenden müssen, erstellen Sie eine konvexe Zerlegung mit Hierarchischer Approximater Konvex-Dekomposition (v-HACD). Das Dienstprogramm test hacd konvertiert das konvexe Dreiecksnetz in einer OBJ-Datei in eine neue OB J-Datei mit mehreren konveX-Rümpfenobjekten. Siehe zum Beispiel Bullet/data/teddy vhacd.urdf, der auf Bullet / data/tedly2 VHACD CHs.obj zeigt oder duck vHacd .urDf, die auf duck*vhakd.obJ zeigen. 3) Reduzieren Sie die Anzahl der Eckpunkte in einem Dreiecksnetz. Zum Beispiel hat Blender 3D einen großartigen Mesh-Dezimationsmodifikator, mit dem Sie interaktiv das Ergebnis der Mesh Vereinfachung sehen können. 4) Verwenden Sie Roll- und Spinnreibung für runde Objekte wie Kugeln und Kapseln sowie Robotergreifer mit dem und Knoten innerhalb Knoten. Siehe zum Beispiel Bullet/data/sphere2.urdf 5) Verwenden Sie eine kleine Menge an Compliance für Räder mit dem innerhalb des URDF xml-Knoten. Siehe zum Beispiel das Bullet/data/husky/husky.urdf Fahrzeug. 6) Verwenden Sie den doppelten Präzisionsbau von Bullet, dies ist sowohl für Kontaktstabilität als auch Kollisionsgenauigkeit gut. Wählen Sie eine gute Constraint-Solver-Einstellung und einen Zeitschritt.

Page 66 of the PyBullet Physics Engine user manual — Support, Tipps, Citation
Seite 66 · Zum Vergrößern klicken
Seite 66
7. Entferne die Physiksimulation von den Grafiken. PyBullet macht das bereits für die GUI und verschiedene Physik-Server: Die OpenGL Grafikvisualisierung läuft unabhängig von der physikalischen Simulation im eigenen Thread. Frage: Welche Möglichkeiten gibt es für das Friktionshandling?

Antwort: Standardmäßig verwenden Bullet und PyBullet eine exakte implizite Konusreibung für das Coulomb-Reibungsmodell. Darüber hinaus können Sie Roll- und Spinnreibung aktivieren, indem Sie eine und Knoten innerhalb des Node, siehe zum Beispiel Bullet/data/sphere2.urdf. Anstelle der Kegelreibung können Sie eine pyramidenförmige Approximation aktivieren. Frage: Welche Konstante oder Schwelle in Bullet, die hohe Geschwindigkeiten unmöglich macht?

Antwort: Standardmäßig setzt Bullet auf diskrete Kollisionserkennung in Kombination mit Penetration Recovery. Sich auf eine rein diskrete Kollisionserkennung zu verlassen, bedeutet, dass ein Objekt innerhalb eines Zeitschritts nicht schneller als sein eigener Radius reisen sollte. PyBullet verwendet 1./240 als Standardzeitschritt. Zeitschritte größer als 1./60 können aus verschiedenen Gründen Instabilitäten einführen (tiefe Durchdringungen, numerischer Integrator). Bullet hat eine Option für die kontinuierliche Kollisionserkennung, um Kollisionen von Objekten zu erfassen, die sich innerhalb eines Zeitschritts schneller als ihr eigener Radius bewegen. Leider kann diese kontinuierliche Kollisionserkennung eigene Probleme (Leistung und nicht-physische Reaktion, mangelnde Restitution) mit sich bringen, daher ist dieses experimentelle Merkmal standardmäßig nicht aktiviert.

Quellen

Referenzen & Links

In dieser Anleitung genannte Seiten – Hersteller, Support und Downloads.

Frage zu PyBullet Physics Engine stellen

Besitzer und unser Team antworten in der Regel innerhalb eines Tages – und Ihre Frage hilft auch anderen weiter.

Add your email to get notified when it’s answered — no spam, ever.

0 questions
Noch keine Fragen zu PyBullet Physics Engine

Stellen Sie die erste Frage — andere Nutzer oder unser Team antworten Ihnen.

Originaldokument

PyBullet Physics Engine PDF-Anleitung

66 Seiten·1.5 MB·Software·PDF
Klicken Sie oben auf eine Seite, um sie hier zu öffnen
Seite 1 / …
100%
Seiten werden geladen…