
Synthetische camera rendering 35
Erwin Coumans , Yunfei Bai , 2017/2018
Bezoek de forums .
Hallo PyBullet World 3
Aanvaringsdetectievragen 39
loadURDF, loadSDF, laadMJCF 7
saveState,saveBullet, restoreState 9
Inverse Dynamics, Kinematics 44
Versterking van het leren Gym Envs 47
Milieu en gegevens 47
Controle van een robot 17
Basis, Gewrichtsdelen, Links 17
Debug GUI, regels, tekst, parameters 55
GetNumBodies, getBodyInfo, krijgen BodyUniqueId, verwijderenBody 26
makenConstraint, verwijderenConstraint, veranderenConstraInt 26
Bouw en installeer PyBullet 60
Steun, tips, citation 63

PyBullet is een eenvoudig te gebruiken Python module voor natuurkunde simulaties voor robotica, games, visuele effecten en machine learning. Met PyBullet kunt u gelede lichamen van URDF, SDF, MJCF en andere bestandsformaten laden. PyBullet biedt vooruit dynamische simulatie, inverse dynamiek berekening, voor- en omgekeerde kinematica, botsing detectie en straal kruispunt vragen. De Bullet Physics SDK bevat PyBullet robotvoorbeelden zoals een gesimuleerde Minitaur viervoudige, humanoids die lopen met TensorFlow gevolgtrekking en KUKA armen grijpen objecten.



Naast de fysica simulatie, zijn er bindingen aan rendering met een CPU renderer (TinyRenderer) en OpenGL visualisatie en ondersteuning voor Virtual Reality-headsets zoals HTC Vive en Oculus Rift. PyBullet heeft ook functionaliteit om botsing detectie vragen (de dichtstbijzijnde punten, overlappend paren, straal kruispunt test enz.) uit te voeren en debug rendering toe te voegen (debuglijnen en tekst). PyBullet heeft cross-platform ingebouwde client-server ondersteuning voor gedeeld geheugen, UDP en TCP netwerken. Zo kun je PyBullet draaien op Linux, die verbinding maakt met een Windows VR-server. PyBullet wraps de nieuwe Bullet C-API , die is ontworpen om onafhankelijk van de onderliggende natuurkunde motor en rendermotor te zijn , zodat we gemakkelijk migreren naar nieuwere versies van Bullet of gebruik maken van een andere natuurkunde-engine of render motor. Standaard gebruikt PyBullet de Bullet 2.x API op de CPU. We zullen Bullet 3.x die op GPU met OpenCL ook ontmaskerd. Er is ook een C++ API vergelijkbaar met PyBullet, zie b3RobotSimulatorClientAPI . PyBullet kan eenvoudig worden gebruikt met TensorFlow en kaders zoals OpenAI Gym. Onderzoekers van Google Brain [ 1 , 2 , 3 ], X , Stanford Al Lab en OpenAI gebruiken PyBullet/Bulnet C-API. De installatie van PyBullet is zo eenvoudig als (sudo) pip installeren PyBulet (Python 2.x), Pip3 installeert PyBulinet. Dit zal de PyBullet module en PyBult envs Gym omgevingen blootleggen.

Hier is een PyBullet introductie script dat we stap voor stap bespreken:
import pybullet als p invoertijd importeren van pybulletje data fysicaClient = p.connect(p.GUI)#or p.DIRECT for non-graphical version p.setExtraSearchPath(pybullet data.getDataPath-[)) #optioneel p.setsGravity(0,0,10) planeId = p.loadURDF("plane.urdf") cubeStartPos= [0,1] cubeBeginOrientation = p!getQuaternionFromEuler([0,0]) boxId=p.loadhurDF(r2d2.urdf,"cubeStartePos, cubestartOrientation) for i in range (10000): p.stepSimulation() time.slaep(1./240.) cubePos; cubeOrn = p
Na het importeren van de PyBullet module, is 'connecting' met de natuurkunde simulatie. PyBullet is ontworpen rond een client-server aangedreven API, met een cliënt verzenden van commando's en een physics server terug te geven de status. PyBullet heeft een aantal ingebouwde natuurkunde servers: DIRECT en GUI. Zowel GUI als DIRECT verbindingen zullen de fysica simulatie en rendering uitvoeren in hetzelfde proces als PyBullet. Merk op dat in DIRECT-modus u geen toegang hebt tot de OpenGL en VR hardware functies, zoals beschreven in het hoofdstuk "Virtual Reality" en "Debug GUI, Lines, Text, Parameters." DIRECT modus maakt het mogelijk om afbeeldingen te renderen met behulp van de ingebouwde software render via de 'getCameraImage' API. Dit kan nuttig zijn voor het uitvoeren van simulaties in de cloud op servers zonder GPU. U kunt uw eigen gegevensbestanden leveren, of u kunt het PyBullet data pakket gebruiken dat met PyBultet wordt verzonden. Importeer hiervoor pybullet data en registreer de directory met behulp van Pybullet.setExtraarchPath(pybullet data.getDataPath()). krijgenConnectionInfo
Gezien een natuurkundeClientId zal de lijst [isConnected, connectionMethod] teruggeven


Diagram met verschillende natuurkunde client (blauw) en physics server (groen) opties. Donkergroen
De DIRECT-verbinding stuurt de commando's direct naar de natuurkunde engine, zonder gebruik te maken van een transport laag en geen grafische visualisatie venster, en geeft rechtstreeks na het uitvoeren van het commando. De GUI-verbinding zal een nieuwe grafische gebruikersinterface (GUI) maken met 3D OpenGL rendering, binnen dezelfde procesruimte als PyBullet. Op Linux en Windows draait deze GUI in een aparte thread, terwijl op OSX het werkt in dezelfde three als gevolg van beperkingen aan besturingssysteem. Op Mac OSX ziet u mogelijk een spinnend wiel in het OpenGL Window, totdat je een 'stepSimulation' of ander PyBullet commando uitvoert. De commando's en statusberichten worden verzonden tussen PyBullet client en de GUI physics simulatieserver met behulp van een gewone geheugenbuffer. Het is ook mogelijk om verbinding te maken met een natuurkundeserver in een ander proces op dezelfde machine of op een externe computer door gebruik te maken van Shared MEMORY, UDP of TCP netwerken. Zie de sectie over Gedeeld geheugen, UDP en TCP voor details. In tegenstelling tot bijna alle andere methoden, deze methode niet ontleden trefwoord argumenten, als gevolg van achterwaartse compatibiliteit.

De inputargumenten voor verbindingen zijn:
connect geeft een client-id of -1 terug als deze niet verbonden is. De physic client Id is een optioneel argument voor de meeste andere PyBullet commando's. Als je het niet verstrekt, zal het aannemen dat physic client id = 0. U kunt verbinding maken met meerdere verschillende natuurkundeservers, behalve voor GUI. Bijvoorbeeld: pybullet.connetct(pybullet.DIRECT) pybullet.connetct(pybullet.GUI, opties="--opengl2") pybullet.connett(pybullet.SHARED MEMORY,1234) pybullet.connett(pybullet.UDP,"192,668,1,") pybullet.connetct(pybullet.UDP,"localhost" 1234) pybullet.connect(pybullet.TCP,"localhost", 6667) verbinden met Shared Memory
Er zijn een paar natuurkundeservers die gedeelde geheugenverbinding mogelijk maken: de App SharedMemoryPhysics, App sharedMemorics GUI en de Bullet Example Browser heeft één voorbeeld onder Experimental/Fysics Server waarmee gedeeld geheugen verbinding kan worden gemaakt. Hiermee kunt u de natuurkunde simulatie en weergave in een apart proces uitvoeren.

U kunt ook via gedeeld geheugen verbinding maken met de App SharedMemoryPhysics VR, de Virtual Reality-applicatie met ondersteuning voor headmounted display en 6-dof tracked controllers zoals HTC Vive en Oculus Rift met Touchcontrollers. Aangezien de Valve OpenVR SDK alleen goed werkt onder Windows, kan de App SharedMemoryPhysics VR enkel worden gebouwd met behulp van premake (bij voorkeur) of cmake. verbinding maken met UDP of TCP-netwerk
Voor UDP-netwerken is er een App PhysicsServerUDP die naar een bepaalde UDP poort luistert. Het maakt gebruik van de open source enet bibliotheek voor betrouwbare UDP-netwerken. Hierdoor kunt u de natuurkunde simulatie en weergave uitvoeren op een aparte machine. Voor TCP PyBullet gebruikt de clsocket bibliotheek. Dit kan nuttig zijn bij het gebruik van SSH tunneling vanaf een machine achter de firewall tot aan een robotsimulatie. Bijvoorbeeld kunt u een control stack of machine learning uitvoeren met behulp van PyBullet op Linux, terwijl de physics-server draait in Windows in Virtual Reality door gebruik te maken van HTC Vive of Rift. Nog een UDP-toepassing is de App PhysicsServerSharedMemoryBridgeUDP applicatie die fungeert als brug naar een bestaande natuurkundeserver: je kunt via deze brug verbinding maken met UDP en de brug verbindt met een natuurkundige server door gebruik te maken van gedeeld geheugen: de brug passeert berichten tussen client en server. Op een vergelijkbare manier is er ook nog een TCP versie (vervang UDP door TCP). Opmerking: op dit moment moeten zowel client als server 32bit of 64bit builds zijn! loskoppelen
U kunt de verbinding verbreken van een physics-server, met behulp van het natuurkunde client Id teruggegeven door de call connect (als niet negatief). Een 'DIRECT' of 'GUI' physics-server zal afsluiten. Een aparte (buiten-proces) fysicaserver zal blijven draaien. Zie ook 'resetSimulatie' om alle items te verwijderen. Parameters voor het loskoppelen:
Optioneel physicsClientId int als je verbinding maakt met meerdere natuurkundeservers, kun je kiezen welke.
Standaard is er geen zwaartekracht ingeschakeld.setZwaartekrachtlaat je de standaard zwaartekrachtkracht voor alle objecten instellen. De setGravity input parameters zijn: (geen rendement)
vereiste zwaartekrachtX zweefkracht langs de X wereldas

De loadURDF zal een opdracht naar de natuurkundeserver sturen om een natuurkundig model te laden vanuit een Universal Robot Description File (URDF). Het URDF-bestand wordt gebruikt door het Robot Operating System (ROS project) om robots en andere objecten te beschrijven, werd gemaakt door de WillowGarage en de Open Source Robotics Foundation (OSRF). Veel robots hebben openbare URDF-bestanden, u kunt hier een beschrijving en tutorial vinden:http://wiki.ros.org/urdf/Tutorials Belangrijk: de meeste verbindingen (schuifregelaar, revolute, continu) hebben motoren standaard ingeschakeld die vrije beweging voorkomen. Dit is vergelijkbaar met een robotgewricht met zeer hoge wrijvingsharmonische aandrijving. U dient de gezamenlijke motorcontrolemodus en doelinstellingen in te stellen met behulp van pybullet.setJointMotorControl2. Zie de setJointMotorControl2 API voor meer informatie. Waarschuwing: standaard zal PyBullet enkele bestanden cache-bestanden om sneller laden. U kunt bestandencaching uitschakelen met behulp van setPhysicsEngineParameter(enableFileCaching=0). De loadURDF argumenten zijn:

loadURDF geeft een lichaam unieke id, een niet-negatieve integer waarde. Als het URDF-bestand niet geladen kan worden, zal dit gehele getal negatief zijn en geen geldig body unieke id. loadSDF, loadMJCF
U kunt ook objecten laden van andere bestandsformaten, zoals .bullet, .sdf en .mjcf. Deze bestandsformaten ondersteunen meerdere objecten, dus de retourwaarde is een lijst van unieke id's voor objecten. Het SDF-formaat wordt in detail uitgelegd ophttp://sdformat.org Het commando loadSDF haalt alleen enkele essentiële onderdelen van de SDF uit die gerelateerd zijn aan robotmodellen en geometrie, en negeert vele elementen met betrekking tot camera's, verlichting enzovoort. Het commando loadMJCF voert basisimport uit van MuJoCo MJCF xml bestanden, gebruikt in OpenAI Gym. Zie ook de Belangrijke opmerking onder loadURDF met betrekking tot standaard gezamenlijke motorinstellingen, en zorg ervoor dat setJointMotorControl2 wordt gebruikt.
loadBullet, loadSDF en loadMJCF zal een reeks object unieke id's teruggeven:
objectUniqueIds lijst van int
de lijst bevat het unieke object-id voor elk geladen voorwerp.

U kunt een approximate snapshot van de huidige wereld als PyBullet Python bestand, opgeslagen op de server. saveWorld kan nuttig zijn als basisbewerkingsfunctie, het opzetten van de robot, gezamenlijke hoeken, objectposities en omgeving bijvoorbeeld in VR. Later kun je gewoon het PyBullet Python bestand laden om de wereld opnieuw te creëren. De python snapshot bevat loadURDF commando's samen met initialisatie van gezamenlijke hoeken en object transformeert. Merk op dat niet alle instellingen in het wereldbestand opgeslagen zijn. De argumenten die worden aangevoerd zijn:
Wanneer u deterministische simulatie nodig hebt na herstel naar een eerder opgeslagen staat, moeten alle belangrijke state-informatie, inclusief contactpunten, worden bewaard. Het commando saveWorld is hiervoor niet voldoende. U kunt het commando "RestaurState" gebruiken om te herstellen van een snapshot die u met saveState (in-memory) hebt gemaakt of Bullet opslaan op de schijf. Het commando saveState neemt alleen een optionele clientServerId als invoer en geeft de status id terug. Het commando saveBullet zal de status opslaan in een .bullet bestand op schijf. De argumenten voor het commando "restaurState" zijn:
De bestandsnaam of status-id moet geldig zijn. Merk op dat herstelState de posities en gezamenlijke hoeken van objecten zal resetten naar de opgeslagen staat, evenals het herstellen van contactpunteninformatie. U moet ervoor zorgen dat de objecten en beperkingen worden ingesteld voordat u herstelstaat aanroept. Zie het voorbeeld van saveRestoreState.py.

Hoewel de aanbevolen en gemakkelijkste manier om spullen te maken in de wereld is het gebruik van de laden functies (loadURDF/SDF / MJCF / Bullet), kunt u ook botsingen en visuele vormen programmatisch creëren en ze gebruiken voor een multi lichaam met behulp van createMultiBody. Zie de createMultiBodyLinks.py en maakVisualShape.py voorbeeld in het Bullet Physics SDK. De inputparameters voor createCollisionShape zijn
De retourwaarde is een niet-negatieve int unieke id voor de botsingsvorm of -1 als het gesprek mislukt. VisualShape aanmaken
Je kunt een visuele vorm creëren op dezelfde manier als het maken van een botsingsvorm, met enkele aanvullende argumenten om de visuele verschijning te controleren, zoals diffuse en spectaculaire kleur. Wanneer u het GEOM MESH type gebruikt, kunt u wijzen naar een Wavefront OBJ bestand en de visuele

vorm zal een aantal parameters uit het materiaalbestand (.mtl) ontleden en een textuur laden. Merk op dat grote texturen (boven 1024x1024 pixels) de laad- en tijdprestaties kunnen vertragen. Zie voorbeelden/pybullet/examples/addPlanarReflection.py en creëerVisualShape.py

De inputparameters zijn

De retourwaarde is een niet-negatieve int unieke id voor de visuele vorm of -1 als het gesprek mislukt.
Hoewel de makkelijkste manier om spullen te maken in de wereld is met behulp van de laden functies (loadURDF/SDF/MJCF / Bullet), kunt u een multi lichaam creëren door middel van createMultiBody. Zie het createMultiBodyLinks.py voorbeeld in de Bullet Physics SDK. De parameters van createMultiBody lijken sterk op URDF en SDF-parameters. U kunt een multi lichaam met slechts één basis zonder gewrichten / kind links of u kunt maken van een meervoudig lichaam met gewrichten/kind koppelingen. Als je links aanlevert, zorg dan dat de grootte van elke lijst gelijk is (len(linkMasses) == len(linkCollisionShapeIndices) etc). De invoerparameters voor createMultiBody zijn:

optionele linkVisualShapeIndices lijst van int-lijst met de visuele vorm unieke id voor elke koppeling
optionele linkPositions lijst van vec3 lijst met lokale verbindingsposities, wat betreft moeder
optionele linkOriŽntenlijst van vec4 lijst met lokale linksoriëntaties, w.r.t. ouder
optionele linkInertialFramePositions lijst van de vec3 lijst met lokale inertiaalframe pos. in koppelingsframe
optionele linkInertialFrameOorsprongen lijst van vec4 lijst met lokale inertiaalframe orn. in koppelingsframe
optionele linkParentIndicaties lijst van int Link-index van de ouderkoppeling of 0 voor het basisnummer.
optionele linkJointTypes lijst van int-lijst van gewrichtstypen, één voor elke koppeling. Alleen GEMEENSCHAPPELIJK REVOLUTE, GEZAMENLIJKE PRISMATIC en GEVAARLIJK FIXED worden momenteel ondersteund.
optionele linkJointAxis lijst van de vec3 gemeenschappelijke as in lokaal kader
optioneel gebruikMaximalCoordinaten int experimenteel, het beste om 0/valse achter te laten.
optionele fysicaClientId int Als je verbonden bent met meerdere servers, kun je er een kiezen.
De rendementswaarde van createMultiBody is een niet-negatieve unieke id of -1 voor mislukking. Voorbeeld: cuid = pybullet.createCollisionShape(pybullet,GEOM BOX, halfExtents = [1, 1, 1]) mass= 0 #static Box Pybullet
stapSimulatie zal alle acties uitvoeren in een enkele vooruit dynamiek simulatiestap zoals botsing detectie, beperking oplossen en integratie. stapSimulatie invoerargumenten zijn optioneel:
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
stapSimulatie heeft geen rendementswaarden. Zie ook setRealTimeSimulatie om automatisch de physics-server vooruit dynamische simulatie op basis van zijn real time klok te laten lopen.

Standaard zal de physics-server niet instappen, tenzij u expliciet een 'stepSimulation' commando stuurt. Op deze manier kunt u controle determinisme van de simulatie te handhaven. Het is mogelijk om de simulatie in real-time te laten uitvoeren door het automatisch laten stappen van de physicsserver volgens zijn realtime klok (RTC) met behulp van het setRealTimeSimulatie commando. Als je de real-time simulatie inschakelt, hoef je geen 'stepSimulation' te noemen. Merk op dat setRealTimeSimulatie geen effect heeft in DIRECT modus: In de DIREC-modus gebeuren physicsserver en client met dezelfde conversatie, waarbij je elk commando start. In GUI-modus en in Virtual Reality modus, en TCP/UDP mode, de physics server draait op een aparte draad van de client (PyBullet), en setRealTimeSimulation staat toe dat de natuurkundeserverthread extra oproepen aan stapSimulatie toevoegen. De invoerparameters zijn:
vereist inschakelenRealTimeSimulatie int 0 om real-time simulatie uit te schakelen, 1 aan
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getBasePositionAndOrientation rapporteert de huidige positie en oriëntatie van het basis- (of root link) lichaam in Cartesiaanse wereldcoördinaten. De oriëntatie is een kwartion in [x,y,z,w] formaat. De getBasePositionAndOrientation input parameters zijn:
vereist objectUniqueId int-object uniek id, zoals geretourneerd van loadURDF.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getBasePositionAndOrientation geeft de positielijst van 3 praalwagens en oriëntatie terug als lijst met 4 drijvers in [x,y,z,w] volgorde. Gebruik getEulerFromQuaternion om het kwartier naar Euler te converteren indien nodig. Zie ook resetBasePositionAndOrientation om de positie en oriëntatie van het object te resetten.

Dit completeert het eerste PyBullet script. Kogelschepen met verschillende URDF-bestanden in de Bullet/data map.
U kunt de positie en oriëntatie van het basis- (wortel) object resetten. Het is het beste om dit alleen bij de start te doen, en niet tijdens een lopende simulatie omdat het commando zal overschrijven van alle natuurkundige simulatie. De lineaire en hoeksnelheid is ingesteld op nul. U kunt resetBaseVelocity gebruiken om te resetten naar een niet-nul lineaire en/of hoeksnelheid. De argumenten voor resetBasePositionAndOrientation zijn:
vereist objectUniqueId int-object uniek id, zoals geretourneerd van loadURDF.
vereiste posObj vec3 reset de basis van het object op de opgegeven positie in wereldruimtecoördinaten [X,Y,Z]
vereist ornObj vec4 reset de basis van het object op de gespecificeerde oriëntatie als wereldruimte quaternion [X,Y,Z,W]
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Er zijn geen argumenten om terug te keren.
De positie van objecten kan worden uitgedrukt in Cartesiaanse wereldruimtecoördinaten [x,y,z]. De oriëntatie (of rotatie) van objecten kan worden uitgedrukt met behulp van quaternions [x,y,z,w], euler hoeken [yaw, pitch, roll] of 3x3 matrices. PyBullet biedt een paar helper functies om te zetten tussen kwartionen, euler hoeken en 3x3 matrices. In toevoegingen zijn er enkele functies om te vermenigvuldigen en inverteren transformeert. ontvangQuaternionVanEuler en krijg EulerFromQuatertion
De PyBullet API gebruikt quaternions om oriëntaties te vertegenwoordigen. Aangezien quaternions niet erg intuïtief zijn voor mensen, bestaan er twee API's om te converteren tussen kwartionen en Euler hoeken. De getQuaternionFromEuler input argumenten zijn:
De X,Y,Z Euler hoeken zijn in radialen die 3 rotaties accumuleren en de rol rond de X uitdrukken.
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
getQuaternionFromEuler geeft een kwartier, vec4 lijst van 4 drijvende punt waarden [X,Y,Z,W].

De getEulerFromQuaternion input argumenten zijn:
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
getMatrixVan Quaternion is een nut API om een 3x3 matrix van een quaternion te creëren. De ingang is een kwartion en geeft een lijst van 9 floats, die de matrix vertegenwoordigen. vermenigvuldigenTransformations, reverseTransform
PyBullet biedt een paar helper functies te vermenigvuldigen en omgekeerde transformeert. Dit kan nuttig zijn om coördinaten van het ene naar het andere coördinaatsysteem te transformeren. De inputparameters van vermenigvuldigenTransforms zijn:
vereiste positieA vec3, lijst van 3 praalwagens
vereiste oriëntatieEen vec4, lijst van 4 praalwagens quaternion [x,y,z,w]
vereiste positieB vec3, lijst van 3 praalwagens
vereiste oriëntatieB vec4, lijst van 4 floats quaternion [x,y,z,w]
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
De rendementswaarde is een lijst van positie (vec3) en oriëntatie (vec4, quaternion x,y,x,w). De invoer- en uitvoerparameters van invertTransform zijn:
vereiste positie vec3, lijst van 3 praalwagens
vereiste oriëntatie vec4, lijst van 4 praalwagens quaternion [x,y,z,w]
De output van invertTransform is een positie (vec3) en oriëntatie (vec4, quaternion x,y,x,w).

U kunt de API-versie in een jaar-maand-0 dag formaat opvragen. U kunt alleen verbinding maken tussen de fysica client/server van dezelfde API versie, met hetzelfde aantal bits (32-bit / 64bit). Er is een optioneel ongebruikt argument physicsClientId, toegevoegd voor API consistentie.
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
In de Introductie hebben we al laten zien hoe PyBullet geïnitialiseerd moet worden en wat objecten geladen moeten worden. Als je de bestandsnaam in het loadURDF commando vervangt door "r2d2.urdf" kun je een R2D2-robot simuleren vanuit de ROS-tutorial. Laten we deze R2D2-robot besturen om te bewegen, rondkijken en de grijper onder controle houden. Daarvoor moeten we weten hoe toegang te krijgen tot de gezamenlijke motoren.

Een gesimuleerde robot zoals beschreven in een URDF-bestand heeft een basis, en eventueel verbindingen verbonden door gewrichten. Elk gewricht verbindt één ouderverbinding met een kind. Aan de basis van de hiërarchie is er één enkele wortel ouder die we base noemen. De basis kan ofwel volledig vast zijn, 0 vrijheidsgraden of geheel vrij met 6 graden van vrijheid. Aangezien elke link verbonden is met een ouder die één joint heeft, is het aantal gewrichten gelijk aan het aantal links. Regelmatige links hebben koppelingsindices in het bereik [0..getNumJoints()] Aangezien de basis geen reguliere 'link' is, gebruiken we de conventie van -1 als link

index. We gebruiken de conventie dat gezamenlijke frames worden uitgedrukt ten opzichte van het ouderscentrum in massa-inertiekader, die is afgestemd op de belangrijkste as traagheid.
Nadat u een robot laadt kunt u het aantal gewrichten met de getNumJoints API opvragen. Voor de r2d2.urf moet dit 15 teruggeven. getNumJoints invoerparameters:
vereist lichaamUniqueId int het lichaam unieke id, zoals geretourneerd door loadURDF etc.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Voor elke joint kunnen we wat informatie opvragen, zoals de naam en het type. getJointInfo invoerparameters
vereist lichaamUniqueId int het lichaam unieke id, zoals geretourneerd door loadURDF etc.
vereiste jointIndex int een index binnen het bereik [0 .. getNumJoints(bodyUniqueId))
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getJointInfo geeft een lijst met informatie terug:
JointIndex int dezelfde gezamenlijke index als de input parameter
JointName string de naam van het gewricht, zoals gespecificeerd in het bestand URDF (of SDF etc)
JointType int type van de verbinding, dit impliceert ook het aantal positie- en snelheidsvariabelen. JOINT REVOLUTE, JOINT PRISMATIC, GEWRICHT SPHERICAL, JOINT PLANAR, JOIN FIXED. Zie het gedeelte over Basis, Gezamenlijke en Links voor meer informatie.
qIndex int de eerste positieindex in de positionele toestand variabelen voor dit lichaam
uIndex int de eerste snelheidsindex van deze instantie
jointDamping float de gewrichtsdemping waarde, zoals gespecificeerd in het URDF bestand
gewrichtWrijving drijven de wrijvingswaarde van het gewricht, zoals gespecificeerd in het URDF-bestand
jointLowerLimit float Positional lower limit for slider and revolute (vinge) gewrichten.
gewrichtUpperLimit float Positieve bovengrens voor schuif- en revolute gewrichten. Waarden genegeerd in hoofdletter
vlaggen int gereserveerd

JointMaxForce float Maximale kracht gespecificeerd in URDF (mogelijk andere bestandsformaten) Merk op dat deze waarde niet automatisch wordt gebruikt. U kunt maxForce gebruiken in 'setJointMotorControl2'.
gewrichtMaxVelocity float Maximale snelheid gespecificeerd in URDF. Merk op dat de maximale snelheid niet wordt gebruikt in werkelijke motorbesturingsopdrachten momenteel.
linkNaamtekenreeks de naam van de koppeling, zoals gespecificeerd in het bestand URDF (of SDF etc.)
jointAxis vec3 gewrichtsas in lokaal kader (ongeldig voor GEZAMENLIJK FIXED)
ouderFramePos vec3 gezamenlijke positie in het moederframe
ouderFrameOrn vec3 gezamenlijke oriëntatie in bovenframe
parentIndex int ouder koppelingsindex, -1 voor basis
Opmerking:setJointMotorControl is verouderd en vervangen door setJointmotorConfiguration2 API. (Of nog beter gebruik setJointMotorControlArray). We kunnen een robot besturen door voor één of meer gewrichtsmotoren de gewenste besturingsmodus in te stellen. Tijdens de stapSimulatie zal de natuurkunde motor de motoren simuleren om de gegeven streefwaarde te bereiken die binnen de maximale kracht van de motor en andere beperkingen kan worden bereikt. Elke revolute gewricht en prismatische verbinding wordt standaard gemotoriseerd. Er zijn 3 verschillende motorbesturingsmodi: positieregeling, snelheidsregeling en koppelcontrole. U kunt de motor effectief uitschakelen met een kracht van 0. U moet de motor uitschakelen om direct koppelregeling te kunnen gebruiken. Bijvoorbeeld:
maxForce = 0 modus = p.VELOCITY CONTROL p.setJointMotorControl2(objUid, jointIndex, controlMode=mode, force=maxForce) Als je een wiel wilt hebben om de constante snelheid te handhaven met maximale kracht kun je:
maxForce = 500 p.setJointMotorControl2(bodyUniqueId=objUid,
jointIndex=0, controlMode=p.VELOCITY CONTROL, targetVelocity = doelvel, force = maxForce)

De argumenten voor de setJointMotorControl2 zijn:
vereist lichaamUniqueId int body unieke id als teruggegeven van loadURDF enz.
vereist jointIndex int link index binnen bereik [0..getNumJoints(bodyUniqueId) (let op die koppeling index == gezamenlijke index)
vereist controleMode int position CONTROL (wat eigenlijk CONTROL MODE POSITIE VELOCITY PD), VELOCTY CONtrol, TORQUE CONTROL
optioneel doelPosition float in position CONTROL de targetValue is een streefpositie van het gezamenlijke
optioneel doelVelocity float in VELOCITY CONTROL en position CONtrol het targetVelocity is de gewenste snelheid van de gezamenlijke, zie implementatie nota hieronder. Merk op dat de doelVelocity is niet de maximale gewrichtssnelheid. In position CONTROL/CONTROl MODE POSITIE VELOC ITY PD wordt de eindstreefsnelheid berekend met behulp van: kp*(erp*-[desiredPosition-currentPositie) /dt)+currentVelocity+kd *(m desiredVelocity - stroomVelocaly) .
Optionele kracht float in position CONTROL en VELOCITY CONtrol dit is de maximum motorkracht die wordt gebruikt om de streefwaarde te bereiken. In TORQUE CONTROL is dit de kracht/torque die elke simulatiestap moet worden toegepast.
optionele positieGain float Zie onderstaande implementatienota
optionele snelheidGain float Zie implementatie noot hieronder
optioneel maxVelocity float in position CONTROL dit beperkt de snelheid tot een maximum
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
te minimaliseren methode implementatie component beperking fout
position CONTROL-beperkingssnelheid en positiebeperking
error = position gain*(desired position-a ctual position)+velocity gains*( de sired velocity-actual velocitiesy)
VELOCITY CONTROL beperking pure snelheidsbeperking fout = de gewenste snelheid - werkelijke snelheid
TORQUE CONTROL externe kracht

Over het algemeen is het beter om te beginnen met VELOCITY CONTROL of position CONtrol. Het is veel moeilijker om TORQUE CONTROL (krachtregeling) te doen, aangezien het simuleren van de juiste krachten berust op zeer nauwkeurige URDF/SDF-bestandsparameters en systeemidentificatie (correcte massa's, traagheiden, midden in massalocatie, gewrichtsfrictie enz.). setJointMotorControlArray
In plaats van individuele oproepen voor elke verbinding, kunt u arrays passeren voor alle ingangen om het bellen overhead drastisch te verminderen. setJointMotorControlArray neemt dezelfde parameters als setJointmotorConfiguration2, behalve het vervangen van gehele getallen door lijsten met integers. De argumenten voor de setJointMotorControlArray zijn:
vereist lichaamUniqueId int body unieke id als teruggegeven van loadURDF enz.
vereiste gezamenlijkeIndices lijst van int index binnen bereik [0..getNumJoints(bodyUniqueId) (let op die linkindex ==gemeenschappelijke index)
vereist controleMode int position CONTROL, VELOCITY CONtrol, TORQUE CONTROL
optionele targetPositions lijst van float in position CONTROL de doelValue is streefpositie van het gezamenlijke
optionele targetVelocities lijst van float in VELOCITY CONTROL en position CONtrol de doelValue is streefsnelheid van het gezamenlijke, zie implementatie nota hieronder.
Optionele krachtlijst van float in position CONTROL en VELOCITY CONtrol dit is de maximum motorkracht die wordt gebruikt om de streefwaarde te bereiken. In TORQUE CONTROL is dit de kracht/torque die elke simulatiestap moet worden toegepast.
optionele positieGains lijst van float Zie onderstaande implementatienota
optionele snelheidGains lijst van float Zie implementatie opmerking hieronder
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Zie bullet3/examples/pybullet/tensorflow/humanoid running.py voor een voorbeeld van het gebruik van setJointMotorControlArray.
We kunnen verschillende toestandsvariabelen uit het gewricht opvragen met behulp van getJointState, zoals de gezamenlijke positie, snelheid, gezamenlijke reactiekrachten en gezamenlijk motorkoppel.

vereist lichaamUniqueId int body unieke id zoals teruggegeven door loadURDF etc
vereiste jointIndex int link index binnen bereik [0..getNumJoints(bodyUniqueId)]
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
jointPosition float De positiewaarde van dit gewricht.
gewrichtVelocity float De snelheidswaarde van dit gewricht.
JointReactionForces lijst van 6 praalwagens Dit zijn de gezamenlijke reactiekrachten, als een koppelsensor is ingeschakeld voor deze verbinding dan [Fx, Fy, Fz, Mx, My, Mz]. Zonder koppelsensor is het [0,0,0,0,0,0].
toegepastJointMotorTorque float Dit is het motorkoppel dat tijdens de laatste stap wordt uitgeoefendSimulatie. Merk op dat dit alleen van toepassing is in VELOCITY CONTROL en position CONtrol. Als u TORQUE CONTROL gebruikt, is het toegepaste koppel van de gewrichtsmotor precies wat u biedt. Het hoeft dus niet apart te worden gemeld.
getJointStates is de array versie van getJordanState. In plaats van in één joint te komen, passeer je een lijst met gezamenlijkeIndices. resetJointState
Je kunt de toestand van het gewricht resetten. Het is het beste om dit alleen bij de start te doen, terwijl niet met de simulatie wordt gestart: resetJointState overschrijft alle natuurkundesimulatie. Merk op dat we alleen 1-DOF gemotoriseerde gewrichten ondersteunen, momenteel een schuifgewricht of revolute verbindingen.
vereist lichaamUniqueId int body unieke id zoals teruggegeven door loadURDF etc
vereiste jointIndex int gewrichtsindex binnen bereik [0..getNumJoints(bodyUniqueId)]
vereist targetValue float de gezamenlijke positie (hoek in radialen of positie)
optioneel doelVelocity float de gewrichtssnelheid (hoek- of lineaire snelheid)
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
U kunt een gewrichtskracht/torque sensor in elk gewricht inschakelen of uitschakelen. Als u eenmaal ingeschakeld, als je een stapSimulatie uitvoert, zal de 'geJointState' rapporteren van de gezamenlijke reactie krachten in vaste graden
getJointState input parameters · getGezamenlijkestaat uitvoer

vrijheid: een vaste gezamenlijke meet alle 6DOF-gemeenschappelijke krachten/torques. Een revoluut/vinger gezamenlijke kracht / torque sensor meet 5DOF reactiekrachten langs alle assen behalve de scharnieras. De kracht die door een gezamenlijke motor wordt uitgeoefend, is beschikbaar in de toegepasteJointMotorTorque van getJointState. De inputargumenten omJointForceTorqueSensor in te schakelen zijn:
vereist lichaamUniqueId int body unieke id zoals teruggegeven door loadURDF etc
vereiste jointIndex int gewrichtsindex binnen bereik [0..getNumJoints(bodyUniqueId)]
Optioneel in staatSensor-int 1/True inschakelen, 0/False om de kracht/torque sensor uit te schakelen
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
U kunt ook de Cartesiaanse wereld positie en oriëntatie voor het centrum van massa van elke link met behulp getLinkState vragen. Het zal ook het lokale inertieframe van het massacentrum rapporteren aan de URDF-linkframe, om het gemakkelijker te maken om het grafische/visualisatiekader uit te rekenen. getLinkState invoerparameters
vereist lichaamUniqueId int body unieke id zoals teruggegeven door loadURDF etc
vereiste linkIndex int koppelingsindex
optionele computeLinkVelocity int Als ingesteld op 1 wordt de Cartesiaanse wereldsnelheid berekend en teruggegeven.
Optioneel berekenenForwardKinematics int indien ingesteld op 1 (of True), zal de Cartesiaanse wereldpositie/oriëntatie worden herberekend met behulp van voorwaartse kinematische technieken.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
linkWorldPosition vec3, lijst van 3 praalwagens Cartesiaanse positie van het centrum van massa
linkWorldOrientation vec4, lijst van 4 praalwagens Cartesiaanse oriëntatie van het massacentrum, in viering [x,y,z,w]
lokaleInertialFramePosition vec3, lijst van 3 floats plaatselijke positie offset of inertiaalframe (massacentrum) uitgedrukt in het URDF-linkframe
lokaleInertialFrameOrientation vec4, lijst van 4 drijft plaatselijke oriëntatie (quaternion [x,y,z,w]) offset van het traagheidsframe uitgedrukt in URD-linkframe.
getLinkState retourwaarden

worldLinkFramePosition vec3, lijst van 3 ploats wereldpositie van het URDF-linkframe
worldLinkFrameOrientation vec4, lijst van 4 floats wereldoriëntatie van het URDF-linkframe
wereldLinkLinearVelocity vec3, lijst van 3 ploats Cartesian World Speed. Alleen terug als je LinkVelocity niet-nul berekent.
wereldLinkAngularVelocity vec3, lijst van 3 ploats Cartesiaanse wereldwijde snelheid. Alleen terug als je LinkVelocity niet-nul berekent.
De relatie tussen URDF-linkframe en het centrum van massakader (beide in de wereldruimte) is: urdfLinkFrame = comLinkFraame * localInertialFramen.inverse(). Voor meer informatie over de koppeling en het inertiaalframe, zie ROS URDF tutorial.

Voorbeeldscripts (kan verouderd zijn, controleer de werkelijke Bullet/examples /pybullet/voorbeelden map.)
voorbeelden/pybullet/tensorflow/humanoid runnin g.py
laad een humanoïde en gebruik een getraind neuraal netwerk om het draaien te controleren met TensorFlow, opgeleid door OpenAI
voorbeelden/pybullet/gym/pybolletje envs/bullet /min itaur.py en minitaur gym enV.py
Minitaur omgeving voor OpenAI GYM en TensorFlow U kunt ook Python -m pybullet envs.examples.minitaur gym enV voorbeeld gebruiken nadat u pip-installeerde om de minitaur in actie te zien.
voorbeelden/pybullet/voorbeelden/quadruped.py laadt een viervoudige URDF-bestand, stap de simulatie, controleer de motoren voor een eenvoudige hopping gang op basis van sinusgolven.Zal ook loggen in de staat om te fileren met behulp van p.startStatelogging. Zie video .
voorbeelden/quadruped playback.py Creëer een viervoudige (Minitaur), lees logbestand en stel posities in als motorcontroledoelen.
voorbeelden/pybullet/examples/testrender.py laadt een URDF-bestand en render een afbeelding, krijg de beeldpunten (RGB, diepte, segmentatiemasker) en toont het image met MatPlotLib.
voorbeelden/pybullet/voorbeelden/testrender np.py Gelijkaardig aan testerdender.py, maar de pixeloverdracht versnellen met NumPy arrays. Omvat ook eenvoudige benchmark/timings.

voorbeelden/pybullet/voorbeelden/saveWorld.py Bewaar de status (positie, oriëntatie) van objecten in een pybullet Python scripts. Dit is vooral handig om een scène in VR op te zetten en de begintoestand op te slaan. Niet alle staten zijn geserialiseerd.
voorbeelden/pybullet/voorbeelden/inverse kinematic s.py
Laat zien hoe het CompilerInverseKinematics commando gebruikt wordt, waardoor een Kuka ARM klok aangemaakt kan worden
voorbeeld/pybullet/voorbeelden/rollPitchYaw.py Laat zien hoe schuifregelaar-GUI widgets gebruikt worden
voorbeelden/pybullet/examples/constraint.py Programmatisch een beperking creëren tussen links.
Voorbeelden/pybullet/voorbeelden/vrhand.py Bedien een hand met behulp van een VR-handschoen, gevolgd door een RV controller. Zie video .
Je krijgt toegang tot de lineaire en hoeksnelheid van een lichaam met behulp van getBaseVelocity. De invoerparameters zijn:
vereist lichaamUniqueId int body unieke id, zoals teruggekomen uit de belasting* methoden.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Dit geeft een lijst van twee vector3 waarden (3 floats in een lijst) die de lineaire snelheid [x,y,z] en hoeksnelheid [wx,wy,wz] in Cartesiaanse wereldruimtecoördinaten vertegenwoordigen. U kunt de lineaire en/of hoeksnelheid van een lichaam resetten met resetBaseVelocity. De invoerparameters zijn:
vereist objectUniqueId int body unieke id, zoals teruggekomen uit de belasting* methoden.
optionele lineaireVelocity vec3, lijst van 3 floats lineaire snelheid [x,y,z] in Cartesiaanse wereldcoördinaten.
optionele hoekVelocity vec3, lijst van 3 drijft hoeksnelheid [wx,wy,wz] in Cartesiaanse wereldcoördinaten.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
U kunt een kracht of koppel toepassen op een lichaam met behulp van applyExternForce en externe torque. Merk op dat deze methode alleen zal werken wanneer expliciet stappen in de simulatie met stapSimulatie, met andere woorden: setRealTimeSimulation(0). Na elke simulatiestap worden de externe krachten op nul gezet. Als u 'setRealTimeSimulatie(1) gebruikt, zal extern force/torque ongedefinieerd gedrag hebben (ofwel 0, 1 of meerdere kracht-/torquétoepassingen).

De invoerparameters zijn:
vereist objectUniqueId int object unieke id zoals weergegeven door ladingsmethoden.
vereiste linkIndex int koppeling index of -1 voor de basis.
vereiste krachtObj vec3, lijst van 3 drijfkrachten die moeten worden toegepast [x,y,z]. Zie vlaggen voor coördinatensysteem.
vereiste posObj vec3, lijst van 3 praalwagens positie op de koppeling waar de kracht wordt toegepast. Alleen voor solliciterenExterneForce. Zie vlaggen voor coördinatensysteem.
vereiste vlaggen int Geef het coördinatensysteem van kracht/positie op: ofwel WORLD FRAME voor Cartesiaanse wereldcoördinaten, ofwel LINK FRAME voor lokale verbindingscoördinaten.
getNumBodies zal het totale aantal lichamen in de physics-server teruggeven. Als je 'getNumBodies' gebruikt, kun je de unieke id's van het lichaam opvragen met behulp van 'getBodyUniqueId'. Merk op dat alle API's al body unieke id's teruggeven, dus je hoeft meestal nooit te getBodyUniqueId als u bijhouden van hen. getBodyInfo zal de basisnaam, zoals gewonnen uit het URDF, SDF, MJCF of andere
bestand. removeBody zal een lichaam verwijderen door zijn unieke id (van loadURDF, loadSDF etc).
URDF, SDF en MJCF specificeren gelede lichamen als boomstructuur zonder lussen. Met de 'createConstraint' kunt u specifieke links van lichamen verbinden om deze lussen te sluiten. Zie Bullet/examples/pybullet/voorbeelden/quadruped.py hoe je de poten van een viervoudige 5-bars gesloten lusverbinding kunt verbinden. Daarnaast kun je willekeurige beperkingen creëren tussen objecten, en tussen een voorwerp en een specifiek wereldkader. Zie Bullet/examples/pybullet/voorbeelden/constraint.py voor een voorbeeld. Het kan ook gebruikt worden om de beweging van natuurkundige objecten te controleren, aangedreven door geanimeerde frames zoals een VR controller. Het is beter om beperkingen te gebruiken, in plaats van de positie of snelheid direct voor een dergelijk doel vast te stellen, aangezien deze beperkingen worden opgelost samen met andere dynamicabeperkingen. aanmakenConstraint heeft de volgende invoerparameters:
optionele natuurkundeClientId int

vereiste ouderBodyUniqueId int moederlichaam unieke id
vereiste ouderLinkIndex int moederlink index (of -1 voor de basis)
vereist kindBodyUniqueId int kinderlichaam unieke id, of -1 voor geen lichaam (specificeer een niet-dynamisch kinderframe op wereldcoördinaten)
vereist kindLinkIndex int dochter koppeling index, of -1 voor de basis
vereist jointAxis vec3, lijst van 3 praalwagens gezamenlijke as, in kind koppeling kader
vereist ouderFramePosition vec3, lijst van 3 floats positie van het gewrichtsframe ten opzichte van de moeder centrum van massakader.
vereist kindFramePosition vec3, lijst van 3 drijft positie van het gewrichtsframe ten opzichte van een bepaald kindercentrum van massakader (of wereld oorsprong als geen kind opgegeven)
optionele ouderFrameOrientation vec4, lijst van 4 drijft de oriëntatie van het gewrichtsframe ten opzichte van het moedercentrum massacoördinaatkader
optioneel kindFrameOrientation vec4, lijst van 4 drijft de oriëntatie van het gewrichtsframe ten opzichte van het kindercentrum massacoördinaatkader (of wereld-origine kader als geen kind opgegeven)
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
createConstraint zal een geheel uniek id teruggeven, dat gebruikt kan worden om de beperking te wijzigen of verwijderen. Zie voorbeelden/pybullet/examples/mimicJointConstraint.py voor een voorbeeld van gemeenschappelijke GEAR en voorbeelden/piebullet / examples / minitaur.py for a GEMEENSCHAPPELIJK POINT2POINT and examples/pybollet/embraint.pyfor complemental FIXED. veranderingConstraint
changeConstraint stelt u in staat om parameters van een bestaande beperking te wijzigen. De invoerparameters zijn:
vereiste gebruikerConstraintUniqueId int unieke id teruggeven door createConstraint
optionele jointChildPivot vec3, lijst van 3 praalwagens bijgewerkt kind draaipunt, zie 'CreateConstraint'
optionele jointChildFrameOrientation vec4, lijst van 4 ploats bijgewerkt kindframe oriëntatie als kwartion
optionele maxForce float maximum force die beperking kan toepassen

optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Zie ook Bullet/examples/pybullet/exemplars/constraint.py removeConstraint zal een beperking verwijderen, gegeven door zijn unieke id. De invoerparameters zijn:
vereiste gebruikerConstraintUniqueId int unieke id zoals teruggeven door createConstraint
optionele natuurkundeClientId int unieke id zoals terug gegeven door 'connect'
U kunt het totale aantal beperkingen opvragen, gemaakt met behulp van 'createConstraint'. Optionele parameter is de int fysicaClientId. getConstraintUniqueId
getConstraintUniqueId zal een seriële index nemen in bereik 0..getNumConstraints, en rapporteert de beperking unieke id. Merk op dat de beperking unieke id's niet aan elkaar grenzend zijn, omdat u beperkingen kunt verwijderen. De input is de gehele serie-index en optioneel een natuurkundeClientId.
U kunt de beperkingsinfo opvragen en een unieke id geven. De inputparameters zijn
vereiste beperkingUniqueId int unieke id zoals teruggeven door createConstraint
optionele natuurkundeClientId int unieke id zoals terug gegeven door 'connect'
De uitvoerlijst is:
ouderBodyUniqueId int Zie aanmakenConstraint
ouderJointIndex int Zie aanmakenConstraint
childBodyUniqueId int Zie aanmakenConstraint
childLinkIndex int Zie aanmakenConstraint
commandType int Zie aanmakenConstraint

jointAxis vec3, lijst van 3 praalwagens Zie createConstraint
jointPivotInParent vec3, lijst met 3 praalwagens Zie createConstraint
jointPivotInChild vec3, lijst van 3 praalwagens Zie createConstraint
jointFrameOrientationParent vec4, lijst met 4 ploats Zie createConstraint
jointFrameOrientationChild vec4, lijst met 4 ploats Zie createConstraint
maxAppliedForce float Zie makenConstraint
Geef een unieke id, u kunt vragen naar de toegepaste beperkingen in de meest recente simulatiestap. De ingang is een unieke id en de output is een vector van beperkingskrachten, zijn dimensie is de vrijheidgraden die door deze beperkingen worden beïnvloed (bijvoorbeeld 6 DoF).
U kunt informatie krijgen over de massa, het centrum van massa, wrijving en andere eigenschappen van de basis en links. De invoerparameters om DynamicsInfo te krijgen zijn:
vereist lichaamUniqueId int object unieke id, zoals teruggegeven door loadURDF etc.
vereiste linkIndex int-link (gezamenlijke) index of -1 voor de basis.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
De informatie over de terugkeer is beperkt, we zullen meer informatie onthullen wanneer dat nodig is:
massa dubbele massa in kg
laterale wrijvingscoëfficiënt voor dubbele wrijving
vec3, lijst van 3 drijft lokale traagheidsdiagonaal. Merk op dat koppelingen en basis zijn gecentreerd rond het midden van de massa en uitgelijnd met de belangrijkste assen van traagheid.
lokale inertiaal pos vec3 positie van het traagheidsframe op de plaatselijke coördinaten van het gewrichtsframe
lokale traagheids orn vec4 oriëntatie van het inertieframe op plaatselijke coördinaten van de gezamenlijke kader
restitutie dubbele coëfficiënt van teruggave
lokale traagheidsdiagonaal

rolfrictie dubbele wals wrijvingscoëfficiënt orthogonaal naar contact normaal
Draaien wrijving dubbele spinne wrijvingscoëfficiënt rond contact normaal
contact demping dubbel -1 indien niet beschikbaar. dempen van contactbeperkingen.
contactstijfheid dubbele -1 indien niet beschikbaar. stijfheid van de contactbeperkingen.
U kunt de eigenschappen zoals massa, wrijving en restitutiecoëfficiënten veranderen met behulp van changeDynamics. De invoerparameters zijn:
vereist lichaamUniqueId int object unieke id, zoals teruggegeven door loadURDF etc.
vereiste linkIndex int koppeling index of -1 voor de basis
optionele massa dubbele verandering van de massa van het koppeling (of basis voor linkIndex -1)
optionele laterale wrijving dubbele zijdelingse (lineaire) contactfrictie
optioneel draaienWrijving dubbele torsie wrijving rond het contact normaal
optioneel rollenWrijving dubbele torsie wrijving orthogonaal om normaal contact
optionele teruggave dubbele springstof van contact. Hou het iets minder dan 1.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
optioneel lineairDamperen van dubbele lineaire demping van de koppeling (0.04 standaard)
optionele hoekVerdubbeling van de link (0.04 standaard)
optioneel contactStiffness dubbele stijfheid van de contactbeperkingen, samen met contactDamping.
optioneel contactDamping dubbele demping van de contactbeperkingen voor deze carrosserie/link. Samen gebruikt met contactStiffness. Dit overschrijft de waarde als het is opgegeven in het URDF-bestand in de contactsectie.
optionele wrijvingSankerint schakel een wrijvingsanker in of uitschakelen: positiefrictiecorrectie (standaard uitgeschakeld, tenzij ingesteld in de URDF-contactsectie)
optionele lokaleInertiaDiagnoale vec3 diagonal elementen van de traagheidstensor. Merk op dat de basis en koppelingen zijn gecentreerd rond het midden van massa en uitgelijnd met de belangrijkste assen inertie, zodat er geen off-diagonale elementen in de traagheid

Tensor.
U kunt de tijdstap van de natuurkundemotor instellen die wordt gebruikt bij het aanroepen van 'stepSimulation'. Het is het beste om deze methode alleen aan de start van een simulatie te noemen. Verander deze tijdstap niet regelmatig. setTimeStep kan ook worden bereikt met de nieuwe setPhysicsEngineParameter API. De invoerparameters zijn:
vereiste tijdStap float Elke keer dat je 'stepSimulatie' noemt, gaat de timeStep verder met "timeStepp."
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
U kunt natuurkunde engine parameters instellen met behulp van de setPhysicsEngineParameter API. De volgende invoerparameters worden blootgesteld:
optionele vasteTimeStep float physics engine tijdstap in een fractie van seconden, telkens als je 'stepSimulation' noemt. Zelfde als 'setTimeStep'
optionele numSolverIteraties int Kies het aantal beperkingsoplossers.
Optioneel gebruikSplitImple int Geavanceerde functie, alleen bij het gebruiken van maximale coördinaten: de positiebeperking oplossen en snelheidsbeperking op te lossen in twee fasen om grote penetratie herstelkrachten voorkomen.
optionele splitImpulsePenetrationTreshold float Gerelateerd aan 'useSplitImple': als de doordringing voor een bepaalde contactbeperking lager is dan deze gespecificeerde drempel, zal er geen splitsing van impuls plaatsvinden bij dat contact.
optioneel numSubStaps int Onderdeel de fysica simulatie stap verder door 'numSubsteps'. Dit zal de prestaties te ruilen boven nauwkeurigheid.
optionele botsingFilterMode int Gebruik 0 voor standaardbotsingsfilter: (groep A&maskB) EN (groep B&maska). Gebruik 1 om over te schakelen naar het OR-botsfilter: (groep

optioneel contactBreakingDreef Float Contactpunten met een afstand boven deze drempel worden niet verwerkt door de LCP-oplosser. Daarnaast worden AABB's uitgebreid met dit nummer. Standaardwaarden voor 0.02 in Bullet 2.x
optioneel maxNumCmdPer1ms int Experimental: voeg 1ms slaap toe als het aantal uitgevoerde commando's deze drempel overschrijdt.
Optioneel inschakelenFileCaching int Instellen op 0 om bestandscaching uit te schakelen, zoals .obj wavefront file laden
optionele restitutieVelocityDreshold float Als de relatieve snelheid onder deze drempel ligt, zal teruggave nul zijn.
optionele erp float-beperking foutreductie parameter (non-contact, non-friction)
optionele contactERP floatcontact foutreductie parameter
optionele wrijvingsfoutreductie parameter van de frictieERP (wanneer positie-wrijvingsankers zijn ingeschakeld)
Optioneel inschakelenConeFriction int Zet op 0 om impliciete kegel wrijving uit te schakelen en gebruik piramide benadering (cone is default)
optioneel deterministischOverlappingPairs int Instellen 1 om te activeren en 0 om het sorteren van overlappende paren uit te schakelen (achterwaartse compatibiliteit instelling).
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
setDefaultContactERP is een API om de standaard instellingen voor contactparameters in te stellen. Het zal worden gerold in de setPhysicsEngineParameter API. getphysicsEngineParameters
U kunt een aantal actuele natuurkunde engine parameters opvragen met behulp van het commando getPhysicsEngineParameters, gebruik makend van de optie 'physicscientId'. Dit zal terug genoemd tupels van parameters.
resetSimulatie zal alle objecten uit de wereld verwijderen en de wereld opnieuw instellen op initiële condities. Het vereist één optionele parameter: de physic client Id (in het geval u meerdere natuurkundeserververbindingen hebt gemaakt).
A&maskB) OR (groupB&maska)

Met de staat loggen kun je de toestand van de simulatie inloggen, zoals bijvoorbeeld de status van een of meer objecten na elke simulatiestap (na iedere oproep naar stapSimuleren of automatisch nadat elke simulatiestappen zijn ingeschakeld als setRealTimeSimulatie is geactiveerd). Hiermee kunt u trajecten van objecten registreren. Er is ook de mogelijkheid om te loggen van gemeenschappelijke staat van organen zoals basispositie en oriëntatie, gezamenlijke posities (hoeken) en gezamenlijke motorkrachten. Alle logbestanden die met startStateLogging worden gegenereerd, kunnen gelezen worden via C++ of Python scripts. Zie quadruped playback.py en kuka with cube playleback.pie voor Python scripts die de logbestanden lezen. U kunt bullet3/examples/Utils / RobotloggingUtil.cpp/h gebruiken om de logbestanden in C++ te lezen. Voor MP4 video-opname kunt u de logoptie STATE LOGGING VIDEO MP4 gebruiken. We zijn van plan om verschillende andere soorten logging te implementeren, waaronder het inloggen van de staat van VR controllers. Als speciaal geval hebben we de logging van de Minitaur robot geïmplementeerd. Het logbestand van PyBullet simulatie is identiek aan het echte Minitaur viervoudige logboek. Zie Bullet/examples/pybullet/voorbeelden/logMinitaur.py voor een voorbeeld. Belangrijk: verschillende loggers omvatten hun eigen interne tijdstempel dat begint bij nul wanneer gemaakt. Dit betekent dat je alle loggers tegelijkertijd moet starten, om synchroon te zijn. U moet ervoor zorgen dat de simulatie niet in real-time modus draait, terwijl u met het loggers start: gebruik pybullet.setRealTimeSimulation(0) voordat u aanmaakt welke Loggers er zijn.
vereiste loggingType int Er zijn verschillende soorten houtkap geïmplementeerd. STATE LOGGING MINITAUR: Dit vereist om de viervoudige / viervoetige.urdf en object unieke id van het vierde te laden. Het logt de tijdstempel, IMU roll/pitch/yaw, 8 been motorposities (q0-q7), 8 poten motorkoppels (u0-u7), de voorwaartse snelheid van het torso en modus (ongebruikt in simulatie). STATE LOGGING GENERIC ROBOT: Dit logt een logboek van de gegevens van ofwel alle objecten of geselecteerde (als objectUniqueIds wordt verstrekt). STATE LOGGING VIDEO MP4: dit opent een MP4-bestand en begint met het streamen van de OpenGL 3D visualizer-pixels naar het bestand via een fffmpeg-pipe. Het vereist ffmpeg geïnstalleerd. U kunt ook avconv (standaard op Ubuntu) gebruiken, maak gewoon een symbolische link zodat ffmpeg naar AvConv wijst. Op Windows, ffmpeg heeft een aantal problemen die scheuren / kleur artefacten veroorzaken in sommige gevallen. STATE LOGGING CONTACT POINTS STATE LOGGING VR CONTROLLERS.

STATE LOGGING PROFILE TIMINGS Dit zal een tijd bestand dumpen in JSON formaat dat kan worden geopend met behulp van Google Chrome over://tracing LOAD.
vereist bestandNaam stringbestandsnaam (absoluut of relatief pad) om de log file gegevens op te slaan.
optioneel objectUniqueIds lijst van int Als het leeg is, mag de logger elk voorwerp registreren. Anders logt de loggers alleen maar de voorwerpen in de lijst met objectenUniekids aan.
maxLogDof int Maximum aantal gezamenlijke vrije loggraden (met uitzondering van de basisdokken). Dit geldt voor STATE LOGGING GENERIC ROBOT DATA. Standaardwaarde is 12. Als een robot het aantal dufs overschrijdt, wordt hij helemaal niet geregistreerd.
Optioneel lichaamUniqueIdA int Geldt voor STATE LOGGING CONTACT POINTS. Indien beschikbaar, alleen logcontactpunten met instantieUniqueIdA.
optionele bodyUniqueIdB int Geldt voor STATE LOGGING CONTACT POINTS. Indien aanwezig, alleen logcontactpunten met instantieUniqueIdB.
Optionele linkIndexA int Geldt voor STATE LOGGING CONTACT POINTS. Indien aanwezig, log alleen contactpunten met linkIndexA voor bodyUniqueIdA.
optionele linkIndexB int Geldt voor STATE LOGGING CONTACT POINTS. Indien aanwezig, log alleen contactpunten met linkIndexB voor bodyUniqueIdA.
optioneel apparaatTypeFilter int-apparaatTypeFiller stelt u in staat om te selecteren welke VR apparaten moeten worden geregistreerd: VR DEVICE CONTROLLER, VR DEVICE HMD ,VR DEVEICe GENERIC TRACKER of een combinatie daarvan. Geldt voor STATE LOGGING VR CONTROLERS. De standaardwaarden zijn VR DEVICE CONTROLLER.
optionele logVlaggen int (opkomende PyBullet 1.3.1). STATE LOG JOINT TORQUES, om de koppelkoppels van gewrichten te loggen als gevolg van gewrichtsmotoren.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Het commando zal een niet-negatieve int logging teruggevenUniqueId, die kan worden gebruikt met stopStateLogging. Todo: documenteer de gegevens die voor elk logtype zijn geregistreerd. Gebruik voorlopig de utility's voor het lezen van logbestanden om erachter te komen, of kijk op C++ broncode van het loggen of Python dumpLog.py script. stoppenStatelogging
U kunt een logger stoppen met behulp van zijn houtkapUniqueId. profileTiming indienen
facultatief

PyBullet en Bullet hebben veel functies geinstrumenteerd zodat u kunt zien waar de tijd wordt besteed. U kunt die profiel timings dumpen in een bestand, dat kan worden bekeken met Google Chrome in het over://tracing venster via de LOAD functie. In de GUI kunt u op 'p' drukken om het dumpprofiel te starten/stoppen. In sommige gevallen wilt u mogelijk de timings van uw clientcode instrumenteren. U kunt profieltijden indienen met behulp van PyBullet. Hier is een voorbeeld uitvoer:
PyBullet heeft zowel een ingebouwde OpenGL GPU visualizer als een inbouw CPU renderer gebaseerd op TinyRender. Dit maakt het zeer gemakkelijk om beelden vanuit een willekeurige camerapositie te renderen. De synthetische camera wordt gespecificeerd door twee 4 bij vier matrices: de weergavematrix en de projectiematrix. Aangezien die niet erg intuïtief zijn, bestaan er een aantal helper methoden om de weergave en projectiematrix te berekenen vanuit begrijpelijke parameters.
De rekenViewMatrix invoerparameters zijn
vereist cameraEyePosition vec3, lijst van 3 drijft oogpositie in Cartesiaanse wereldcoördinaten
vereist cameraTargetPosition vec3, lijst van 3 floats positie van het doel (focus) punt, in Cartesiaanse wereldcoördinaten
vereiste cameraUpVector vec3, lijst van 3 zweven vector van de camera, in Cartesiaanse wereld coördinaten
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie
Output is de 4x4 viewmatrix, opgeslagen als een lijst van 16 praalwagens. BerekenViewMatrixVanYawPitchRoll
De inputparameters zijn
vereiste cameraTargetPosition lijst van 3 floats doel focuspunt in Cartesiaanse wereldcoördinaten
vereiste afstand van de floatafstand tot het focuspunt
vereist giergaai hoek in graden links/rechts rond de omhoog-as.
vereiste toonhoogte float pitch in graden omhoog/omlaag.

vereiste roll floatrol in graden rond voorvector
vereist upAxisIndex int 1 voor Y of 2 voor Z as omhoog.
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
Output is de 4x4 viewmatrix, opgeslagen als een lijst van 16 praalwagens.
De inputparameters zijn
vereist linker float links scherm (canvas) coördinaat
vereist rechter float rechts scherm (canvas) coördinaat
vereist bodem float onderaan scherm (canvas) coördinaat
vereist top float bovenscherm (canvas) coördinaat
vereist in de buurt van het vlak
vereiste ver zwevende verre vlakafstand
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
Output is de 4x4 projectiematrix, opgeslagen als een lijst van 16 praalwagens. BerekenProjectMatrixFOV
Dit commando zal ook een 4x4 projectiematrix teruggeven, met verschillende parameters. U kunt OpenGL documentatie bekijken voor de betekenis van de parameters. De invoerparameters zijn:
vereist fov drijfveld van zicht
vereiste aspect float-aspectverhouding
vereist in de buurtVal float nabij vlakte
vereiste farVal float veraf vlak afstand
optionele natuurkundeClientId int ongebruikt, toegevoegd voor API consistentie.
De getCameraImage API zal een RGB-afbeelding, een dieptebuffer en een segmentatiemaskerbuffer met unieke lichaamsid's van zichtbare objecten voor elke pixel teruggeven. Merk op dat PyBullet kan worden gecompileerd met de numpy optie: het gebruik van Numpy zal verbeteren de prestaties van kopiëren van de camera

pixels van C tot Python. Opmerking: de oude renderAfbeelding API is verouderd en vervangen door getCameraImage. getCameraAfbeeldingsinvoerparameters:
vereiste breedte int horizontale afbeeldingsresolutie in pixels
vereiste hoogte-int verticale afbeeldingsresolutie in pixels
optioneel viewMatrix 16 floats 4x4 viewmatrix, zie computeViewMatrice*
optionele projectieMatrix 16 floats 4x4 projection matrix, zie berekeningProject*
optionele lichtrichting vec3, lijst van 3 drijft lichte richting
optioneel lichtKleur vec3, lijst van 3 drijft richtingslichtkleur in [RED,GREEN,BLUE] binnen bereik 0.1
optioneel lichtAfstands-vlotte afstand van het lampje langs de genormaliseerde lichtrichting
optionele schaduw int 1 voor schaduwen, 0 voor geen schaduwen
optionele lichtAmbientCoeff floatlicht omgevingscoëfficiënt
optionele lichtDiffuseCoeff floatlicht diffuse coëfficiënt
optionele lichtSpecularCoeff floatlight Speculaire coëfficiënt
Optionele renderer int ER BULLET HARDWARE OPENG of ER TINY RENDEDER. Merk op dat DIRECT-modus geen OpenGL heeft, dus het vereist ER TINY RENDER.
Optionele vlaggen int ER SEGMENTATION MASK OBJECT AND L INKINDEX, Zie hieronder in de beschrijving van segmentatieMaskBuffer en voorbeeldcode.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getCameraAfbeelding geeft een lijst met parameters terug:
breedte int-breedte afbeeldingsresolutie in pixels (horizontaal)
hoogte int-hoogte afbeeldingsresolutie in pixels (verticaal)
rgbPixels lijst van [char RED,char GREEN,char BLUE, lijst met beeldpunten kleuren in R,G,B,A formaat,

char ALPHA] [0..breedte*hoogte] in bereik [0,255] voor elke kleur
dieptePixels lijst van float [0..width*height] depth buffer
segmentatieMaskBufferlijst van int [0..width*height] Alleen beschikbaar bij gebruik van ER TINY RENDER Voor elke pixels is het unieke id van een zichtbaar object. Als ER SEGMENTATION MASK OBJ ECT AND LINKINDEX wordt gebruikt, combineert de segmentatieMaskBuffer het object unieke id en koppelingsindex als volgt: waarde = voorwerpUniqueId + (linkIndex+1)
U kunt toegang krijgen tot visuele vorm informatie met getVisualShapeData. Je kunt dit gebruiken om je eigen renderingsmethode te overbruggen met PyBullet simulatie, en de wereld handmatig transformeren na elke simulatiestap. De invoerparameters zijn:
vereist objectUniqueId int object unieke id, zoals teruggegeven door een belastingsmethode.
optionele natuurkundeClientId int fysica client id zoals teruggeven door 'connect'
De output is een lijst van visuele vormgegevens, elke visual-vorm heeft de volgende indeling:
objectUniqueId int-object unieke id, hetzelfde als de invoer
linkIndex int koppeling index of -1 voor de basis
visueelGeometrieType int visuele geometrietype (TBD)
afmetingen vec3, lijst van 3 drijfmaten (grootte, lokale schaal) van de geometrie
meshAssetFileName string, lijst van tekens pad naar de driehoek gaas, indien aanwezig. Typisch relatief aan de URDF, SDF of MJCF bestand locatie, maar kan absoluut zijn.

localVisualFrame positie vec3, lijst van 3 floats standen van lokaal visueel kader, ten opzichte van koppeling/verbindingsframe
localVisualFrame oriëntatie vec4, lijst van 4 floats richting lokaal visueel kader ten opzichte van koppeling/gezamenlijk frame
rgbaColor vec4, lijst van 4 floats URDF kleur (indien gespecificeerd) in rood/groen/blauw/alfa
De natuurkunde simulatie gebruikt massacentrum als referentie voor de Cartesiaanse wereld transformeert, in getBasePositionAndOrientation en in krijgenLinkState. Als je zelf een rendering implementeert, moet je de lokale visuele transformatie transformeren naar wereldruimte en gebruik maken van het centrum van massawereldtransformatie en (inverse) plaatselijkeInertialFrame. U kunt de lokaleInertialFrame benaderen met behulp van de getLinkState API.
U kunt changeVisualShape gebruiken om de textuur van een vorm te veranderen. Deze textuur heeft momenteel alleen invloed op de software renderer (zie getCameraImage), niet het OpenGL visualisatie venster (nog).
vereist objectUniqueId int object unieke id, zoals weergegeven door de belastingsmethode.
vereiste jointIndex int link index
Optionele vormIndex int Experimenteel voor intern gebruik, aanbevolen om de vorm te negeren Index of laat het -1 achter. Het was de bedoeling om u een specifieke vormindex te laten kiezen, aangezien URDF (en SDF etc) meer dan 1 visuele vorm per koppeling kan hebben. Deze vormIndex komt overeen met de lijst die wordt geretourneerd door getVisualShapeData.
optionele textuurUniqueId int-textuur uniek id, zoals weergegeven door 'loadTexture' methode
optioneel rgbaColor vec4, lijst van 4 praalwagens
kleurcomponenten voor RED, GREEN, BLUE en ALFA, elk in bereik [0..1]. Alpha moet 0 (onzichtbaar) of 1 (zichtbaar), op dit moment zijn (nog geen transparantie).
Optioneel SpecularColor vec3 speculaire kleurcomponenten, RED-, GREEN- en BLUE-componenten kunnen van 0 tot groot getal (>100) zijn.
vereiste natuurkundeClientId int fysica client id zoals teruggeven door 'connect'
Laad een textuur uit het bestand en geef een niet-negatieve structuur unieke id terug als de lading slaagt. Deze unieke id kan gebruikt worden met changeVisualShape.

U kunt de contactgegevensinformatie opvragen die bestond tijdens het laatste 'stepSimulation'. Om de contactpunten te krijgen kunt u gebruik maken van de 'getContactPoints' API. Merk op dat de 'getContactPoints' geen informatie over het contactpunt opnieuw berekenen.
Deze query zal alle unieke id's van objecten die een as uitgelijnd omgrenzende doos overlappen met een gegeven as uitlijnen grenzendoos. Merk op dat de query conservatief is en extra objecten kan retourneren die geen echte AABB overlapping hebben. Dit gebeurt omdat de acceleratiestructuren een beetje heuristisch zijn dat AABB's iets vergroot (extra marge en geëxtrudeerd langs de snelheidsvector). De getOverlappingObjects input parameters zijn:
vereiste aabbMin vec3, lijst van 3 floats minimale coördinaten van de aabb
vereiste aabbMax vec3, lijst van 3 drijft maximum coördinaten van de aabb
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
U kunt de as uitgelijnd omgrenzende doos (in wereldruimte) opvragen, gegeven een object uniek id en eventueel ook een koppelingsindex. (als je de link index niet doorgeeft, of -1 gebruikt krijg je AABB van het basis). De inputparameters zijn
vereist lichaamUniqueId int object unieke id zoals teruggegeven door creatiemethoden.
optionele linkIndex int-link index binnen bereik [0..getNumJoints(...)]
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.

De terugkeerstructuur is een lijst van vec3, aabbMin (x,y,z) en aabbMax (x. y,z), in wereldruimtecoördinaten. Zie ook het getAABB.py voorbeeld.
De getContactPoints API geeft de contactpunten terug die zijn berekend tijdens het meest recente gesprek naar stapSimulation. De invoerparameters zijn als volgt:
optioneel orgaanEen in-in-alleen rapportage van contactpunten met instantie A
optionele BYB-int alleen contactpunten rapporteren die lichaam B betrekken
optionele linkIndexA int Alleen contactpunten rapporteren die een koppeling bevattenIndex A van bodyA
optionele linkIndexB int Alleen contactpunten rapporteren die een koppeling bevattenIndex B van bodyB
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getContactPoints zal een lijst van contactpunten teruggeven. Elk contactpunt heeft de volgende velden:
bodyUniqueIdA int body unieke id van lichaam A
bodyUniqueIdB int lichaam unieke id van het lichaam B
linkIndexA int koppelingsindex van lichaam A, -1 voor basis
linkIndexB int koppelingsindex van lichaam B, -1 voor basis
positionOnA vec3, lijst van 3 praalwagens contact positie op A, in Cartesiaanse wereld coördinaten
positionOnB vec3, lijst van 3 praalwagens contact positie op B, in Cartesiaanse wereld coördinaten
contactNormalOnB vec3, lijst van 3 vlotten normaal contact op B, wijzend naar A
contactAfstands-voelerafstand, positief voor scheiding, negatief voor penetratie
normaalForce float normale kracht toegepast tijdens de laatste 'stepSimulatie'
contactVlag int gereserveerd

Het is ook mogelijk om de dichtstbijzijnde punten te berekenen, onafhankelijk van stapSimulation. Hierdoor kun je ook de dichtstbijzijnde punten van objecten met een willekeurige scheidingsafstand berekenen. In deze zoekopdracht zullen geen normale krachten gerapporteerd worden. getClosestPoints invoerparameters:
vereist lichaamEen int object unieke id voor eerste voorwerp (A)
vereist bodyB int object unieke id voor tweede voorwerp (B)
vereiste afstand zweven Als de afstand tussen objecten deze maximale afstand overschrijdt, mogen geen punten worden teruggegeven.
optionele linkIndexA int-link index voor object A (-1 voor basis)
optionele linkIndexB int-linkindex voor object B (-1 voor basis)
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
getClosestPoints geeft een lijst van de dichtstbijzijnde punten terug in hetzelfde formaat als krijgenContactPointen (maar normaalForce is altijd nul in dit geval)
Je kunt een enkele raycast uitvoeren om de kruising informatie van het eerste object hit te vinden. De rayTest-invoerparameters zijn:
vereiste straalFromPosition vec3, lijst van 3 vlotten start van de straal in wereldcoördinaten
vereiste straalToPosition vec3, lijst van 3 drijft eind van de straal in wereldcoördinaten
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
De raytestvraag geeft de volgende informatie terug in geval van een kruispunt:
objectUniqueId int-object uniek id van het getroffen voorwerp
linkIndex int koppelingsindex van het hit object, of -1 als geen/ouder.
De breukfractie raakte de fractie langs het straalgebied [0,1] in een straal van ongeveer [0,1) over de straal.
hit positie vec3, lijst van 3 praalwagens geraakt positie in Cartesiaanse wereld coördinaten
hit normale vec3, lijst van 3 praalwagens normaal in Cartesiaanse wereld coördinaten

Dit is vergelijkbaar met de rayTest, maar kunt u een reeks van stralen te voorzien voor snellere uitvoering. De grootte van 'rayFromPositions' moet gelijk zijn aan de omvang van 'RayToPosities'. Je kunt één straal resultaat per straal, zelfs als er geen kruispunt: je moet het objectUniqueId veld gebruiken om te controleren of de ray iets heeft geraakt: Als het voorwerpUniekid is -1, dan wordt er niets getroffen. In dat geval is de 'hitfractie' 1. Het maximum aantal stralen per partij is pybullet.MAX RAY INTERSECTION BATCH SIZE. De rayTest-invoerparameters zijn:
vereiste rayFromPositions lijst van vec3, lijst met 3 praalwagens
lijst van startpunten voor elke straal, in wereldcoördinaten
vereiste rayToPositions lijst van vec3, lijst met 3 praalwagens
lijst van eindpunten voor elke straal in wereldcoördinaten
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
De output is één straalkruisingsresultaat per inputstraal, met dezelfde informatie als in bovenstaande rayTest-query.
U kunt de botsgeometrie type en andere botsing vorm informatie van bestaande body base en links met behulp van deze query. Het werkt zeer vergelijkbaar met krijgenVisualShapeData. De invoerparameters voor getCollisionShapeData zijn:
vereist objectUniqueId int-object uniek id, ontvangen van loadURDF etc
vereiste linkIndex int koppeling index of -1 voor de basis
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
De rendementswaarde is een lijst met de volgende inhoud:
object uniek id int-object unieke ID

linkIndex int koppeling index of -1 voor de basis
afmetingen vec3 hangt af van het meetkundetype: voor GEOM BOX: maten, voor de geom SPHERE-afmetingen[0] = straal, voor GEOM CAPSULE en GEOM CYLINDER, dimensies[0]= hoogte (lengte), afmeting[1] = radius. Voor GEOM MESH is de dimensies de schaalfactor.
lokale frame pos vec3 Plaats van het aanvaringsraam ten opzichte van de middenmassa/inertiaal kader.
lokale framing orn vec4 Lokale oriëntatie van het aanvaringsframe ten opzichte van de inertiaal.
berekenenInverseDynamics
BerekenInverseDynamics zal de krachten berekenen die nodig zijn om de gegeven gezamenlijke versnellingen te bereiken, vanaf gespecificeerde gemeenschappelijke posities en snelheden. De rekenInverseDynamics input parameters zijn:
vereist lichaamUniqueId int body unieke id, zoals geretourneerd door loadURDF etc.
vereiste lijst van gemeenschappelijke posities (hoeken) voor elke vrijheidsgraden (DoF). Merk op dat vaste gewrichten hebben 0 graden van vrijheid. De basis wordt in alle gevallen overgeslagen/ontmanteld (zwevende base en vaste voet).
vereiste objVelocities lijst van drijvende gewrichtssnelheden voor elke vrijheidsgraden (DoF)
vereiste objAcceleratieslijst van float gewenste gewrichtsversnellingen voor elke vrijheidsgraden (DoF)
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
calculationInverseDynamics geeft een lijst van gezamenlijke krachten voor elke mate van vrijheid terug.
BerekenJacobian zal de translationele en rotatie jacobische racisten berekenen voor een punt op een koppeling, bijvoorbeeld. x dot = J * q dots. De teruggekeerde Jacobiërs zijn iets anders afhankelijk van of de root link is vast of drijvend. Als het zweven, zullen de Jacobiërs kolommen die overeenkomen met de rootlink graden van vrijheid bevatten; indien vastgesteld hebben de Jakobs alleen maar columns geassocieerd aan de gewrichten. De functie call neemt de volledige beschrijving van het kinematische, dit is omdat

calculationInverseDynamics wordt eigenlijk eerst genoemd en de gewenste jacobiën worden hier uit gehaald; daarom is het redelijk om indien gewenst nul vectoren voor gewrichtssnelheden en versnellingen door te geven. De berekeningJacobiaanse invoerparameters zijn:
vereist lichaamUniqueId int body unieke id, zoals geretourneerd door loadURDF etc.
vereiste linkIndex int koppeling index voor de jacobian.
vereist lokalePosition lijst van float het punt op de opgegeven link om te berekenen voor de jacobian.
vereiste lijst van posities in de gezamenlijke positie (hoeken)
vereiste objVelocities lijst van vlottende gewrichtssnelheden
vereiste objAcceleraties lijst van float gewenste gewrichtsversnellingen
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
berekenenJacobian rendement:
vereist lineaireJacobian mat3x ((dof), (dof))
de vertaling jacobian, x dot = J t * q dots.
vereist hoekigJacobian mat3x ((dof), (dof))
de rotatie-jacobian, r dot = J r * q dots.
calculerenMassMatrix zal de systeem traagheid voor een gelede lichaam berekenen gezien zijn gezamenlijke posities.
vereist lichaamUniqueId int body unieke id, zoals geretourneerd door loadURDF etc.
vereiste objPositions array van float
jointPositions voor elke link.
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
Het resultaat is de vierkante massamatrix met afmetingen dofCount * dofCount, opgeslagen als een lijst van dufComber rijen, elke rij is een lijst met dopCount massa matrix elementen. Inverse Kinematica
Je kunt de gezamenlijke hoeken berekenen die ervoor zorgen dat de eindeffector een bepaalde doelpositie bereikt in Cartesische wereldruimte. In het interne gebruik van een verbeterde versie van Samuel Buss Inverse Kinematics bibliotheek. Op dit moment alleen de Gedempte Last Squares methode met of zonder Null

Ruimtecontrole is blootgesteld, met één doel voor eindeffectoren. Optioneel kunt u ook de doeloriëntatie van het eindeffector specificeren. Daarnaast is er een optie om de nulruimte te gebruiken voor het specificeren van gezamenlijke limieten en rustvormen. Deze optionele null-space ondersteuning vereist alle 4 lijsten (lowerLimits, upperLimits, jointRanges, restPoses), anders zal regelmatig IK worden gebruikt. Zie ook inverse kinematics.py voorbeeld in Bullet/examples / pylolet/voorbeelden map voor details.
calculationInverseKinematics input parameters zijn:
vereist lichaamUniqueId int body unieke id, zoals geretourneerd door loadURDF
vereiste endEffectorLinkIndex int eindeffector koppelingsindex
vereist doelPosition vec3, lijst van 3 ploats target positie in Cartesian wereld ruimte
Optioneel doelOrientation vec3, lijst van 4 ploats target orientation in Cartesian world space, quaternion [x,y,w,z]. Indien niet gespecificeerd, zal IK in zuivere positie worden gebruikt.
optionele lagereLimits lijst van praalwagens [0..nDof] Optioneel null-space IK vereist alle 4 lijsten (lowerLimits, upperLimmits, jointRanges, restPoses). Anders wordt regelmatig IK gebruikt.
optionele lijst van praalwagens [0..nDof] lagerLimit en bovensteLimits geven gezamenlijke limieten
optionele jointRances lijst van praalwagens [0..nDof]
optionele restPoses lijst van praalwagens [0..nDof] Begeer een IK-oplossing dichter bij een bepaalde rustpositie
optionele jointDamping lijst van praalwagens [0..nDof] gewrichtDampen laat toe om de IK-oplossing af te stemmen met behulp van gewrichtsdempingsfactoren
Optioneel oplosapparaat int p.IK DLS of p.UK SDLS, Damped Least Squares of Selectieve Demped Last Squares zoals beschreven in het papier van Samuel Buss "Selectively Dempded Least Plaves for Inverse Kinematics."
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
calculationInverseKinematics geeft een lijst van gezamenlijke posities terug. Zie Bullet/examples/pybullet/inverse kinematics.py voor een voorbeeld. Merk op dat de berekeningInverseKinematics kan een bij benadering resultaat geven in eind-effector locatie. U kunt meer nauwkeurige resultaten met behulp van de " accurate CalculateInverseKinematics" voorbeeldcode.



Een suite van RL Gym Omgevingen worden geïnstalleerd tijdens "pip installatie pybullet." Dit omvat PyBullet versies van de OpenAI Gym omgevingen zoals mier, hopper, humanoid en walker. Er zijn ook omgevingen die zowel in simulatie als op echte robots van toepassing zijn, zoals de Ghost Robotics Minitaur viervoudig, de MIT racecar en de KUKA-robotarmgrijpende omgeving. De broncode van pybullet, pybulle envs, Pybullet data en de voorbeelden zijn hier: https://github.com/bulletphysics/bullet3/tree/master/examples/pybullet/gym U kunt de omgeving trainen met RL trainingsalgoritmen zoals DQN, PPO, TRPO en DPPG. Er zijn verschillende pre-getrainde voorbeelden beschikbaar, je kunt er zo van genieten: pip install pybullet, tensorflow, gympython -m Pybullet envs.examples.enjoy TF HumanoidBulletEnv v0 2017may python-m pybullet enVs. examples
Nadat je "sudo pip install pybullet" hebt geïnstalleerd, zijn de Pybullet envs en pybullet data pakketten beschikbaar. Het importeren van het pybullet envs pakket zal de omgeving automatisch registreren in OpenAI Gym. U kunt een lijst van de Bullet omgevingen in gym met behulp van de volgende Python lijn: print(









Simulatie van de Ghost Robotics Minitaur verviervoudigde op een vlakke grond. Beloning gebaseerd op afstand. Maak de klasse met behulp van Gym: env = gym.make('MinitaurBulletEnv-v0') of maak het milieu direct aan door gebruik te maken van deze klasse, met parameters: import pybullet envs.bullet.minitaur gym enve als e env= e.MinitaurBultetEnv(render=True)
Simulatie van de MIT RC Racecar. Beloning gebaseerd op afstand tot de willekeurig geplaatste bal. Waarnemingen zijn balpositie (x,y) in cameraframe. De actieruimte van de omgeving kan discreet (voor DQN) of continu zijn (voor PPO, TRPO en DPPG). import pybullet envs.bullet.racecarGymEnv as e env = e.RacecarGymEnv(isDiscrete=False ,renders=True) env.reset()
Hetzelfde als de RacecarBulletEnv-v0, maar observaties zijn camera pixels.
Simulatie van de KUKA Iiwa robotarm, waarbij een voorwerp in het bakje wordt vastgepakt. De belangrijkste beloning gebeurt een het einde, wanneer de gripped kan grijpen van het object boven een bepaalde hoogte. Een paar zeer kleine beloning / kosten gebeurt elke stap: de kost van actie en afstand tussen grijper en object. Observatie omvat de x,y positie van het object. Let op: deze omgeving heeft problemen training momenteel, we kijken ernaar.
KukaCamBulletEnv-v0 Zelfde als KukaBulleetEnv - v0, maar observatie zijn camera pixels.

We hebben de Roboschool omgevingen naar pybulette gebracht. De omgevingen van de Roboschool zijn harder dan die in MuJoCo Gym.
Ant is zwaarder, waardoor het meestal twee of meer poten op de grond heeft.
Humanoid profiteert van meer realistische energiekosten (= koppel × hoeksnelheid) afgetrokken van beloning.

Het is ook mogelijk om toegang te krijgen tot de gegevens, zoals URDF/SDF robot assets, Wavefront.OBJ bestanden uit het pybullet data pakket. Hier is een voorbeeld hoe je dit kunt doen: importeer pybullet importeren Pybullet data datapath = pybulet data.getDataPath() pybullet.connect(pybullet.GUI) pybullet (GUI).setExtraSearchPath(datapath) pybollet.loadURDF("r2d2.urdf,"[0,0,1]) Als alternatief, handmatig toevoegen van het datapad aan de bestandsnaam in loadURdif/SDF commando's.
Voor discrete Gymomgevingen zoals de KukaBulletEnv-v0 en RacecarBulleetEnv - v0 kunt u OpenAI Baselines DQN gebruiken om het model te trainen met behulp van een afzonderlijke actieruimte. Enkele voorbeelden zijn hoe te trainen en genieten van deze discrete omgeving: python -m pybullet envs.baselines.train pybullet cartpole Python-m pybollet nlevs.basislijnen.traine pyboullet racecar OpenAI Baselins zal een .PKL bestand opslaan op gespecificeerde intervallen wanneer het model verbetert. Dit .PKL bestand wordt gebruikt in de genieten-scripts: python -m pybullet envs.baselines.enjoy pybullet cartpole pythons -m Pybullet=envS.baseleins.enjoy pyboullet racecar Er zijn ook enkele pre-trainde modellen die je kunt genieten van buiten het vak. Hier is een lijst van voorgetrainde omgevingen om te genieten:
InvertedPendulumBulletEnv-v0 · OmgekeerdDoublePendulumbBulletEnvV0 · OmgekeerdPendullusSwingupBulletEnv - v0

Python -m pybullet envs.examples.enjoy TF AntBulletEnv v0 2017maypython-m pybollet nlevs. examples Tf AntBulleetEnv v0*2017 may python m pybulairet enVs.emjoy/TF/HopperBulleyEnv &v0=2017mays python (pythone) envs, examples.enjoy T F Hopper BullletEv v0 2018may python -m gybullet env.exemples.nl
U kunt verschillende pybulletomgevingen trainen met TensorFlow Agents PPO . Eerste installatie van de vereiste Python pakketten: pip install gym, tensorflow, agents, pybullet, ruamel.yaml Dan voor training gebruik: python -m pybullet envs.agents.train ppo --config=pybullet pendulum --logdir=pendulum De volgende omgevingen zijn beschikbaar als Agents config: pybulet penducum pybulley dubbele pendulum pybulket penduilumvleugelpiybullet chetah pybulletten ant pybulette racecar pybulles minitaur U kunt Tensorboard gebruiken om het verloop van de opleiding te zien: tensorboard -- logdir = pendulumb --port=2222 Open een web browser en bezoek lokalehost:222222 pagina. Hier is een voorbeeldgrafiek van Tensorboard voor de slingertraining:

Na training kunt u het getrainde model visualiseren, een video maken of deze visualisatieren met behulp van een natuurkundeserver (python -m pybullet envs.examples.runServer of VoorbeeldBrowser in de fysica-servermodus of Virtual Reality). Als u een lokale GUI physics-server start, zal de visualiser (bullet client.py) automatisch verbinding maken

Gebruik OpenGL hardware rendering om de video te maken. Anders zal het gebruik van de CPU miniverender in plaats daarvan. Om de video te genereren, gebruik je: python -m pybullet envs.agents.visualize ppo --logdir=pendulum/xxxxx --outdir = pendulum video Op een vergelijkbare manier kun je de Minitaur robot trainen en visualiseren: Python -mpybullet env s.agents.train pPO --config=pybulet minitaur -- logdir=pybollet minitaur Hier is een voorbeeld van het verloop van de Minitaurus:https://www.youtube.com/watch?v=tfqCHDoFHRQ Evolution Strategieën (ES)
Er is een blog artikel van David Ha (hardmaru) hoe te trainen PyBullet omgeving met behulp van Evolution Strategies ophttp://blog.otoro.net/2017/11/12/evolving-stable-strategies. Trein met PyTorch PPO
We zullen een beschrijving toevoegen hoe je kunt beginnen met PyTorch en pybullet. Zie ondertussen deze repository: https://github.com/ikostrikov/pytorch-a2c-ppo-acktr

Zie ook de vr Bullet snelstart gids. De VR-fysicaserver gebruikt de OpenVR API voor ondersteuning van HTC Vive en Oculus Rift Touch controller. OpenVR werkt momenteel aan Windows, Valve is ook bezig met een Linux versie. Zie ookhttps://www.youtube.com/watch?v=VMJyZtHQL50 voor een video van het VR voorbeeld, deel van Bullet, die volledig kan worden gecontroleerd met behulp van PyBullet over gedeeld geheugen, UDP of TCP verbinding. Voor VR op Windows, wordt aanbevolen om de Bullet Physics SDK te compileren met behulp van Microsoft Visual Studio (MSVC). Genereer MSVC projectbestanden door het "build visual studio vr pybullet double.bat" script te draaien. U kunt dit kleine script aanpassen om te wijzen naar de locatie van Python etc. Zorg ervoor dat je overschakelt naar de 'Release' configuratie van MSVC en bouw en voer het App PhysicsServer SharedMemory VR*.exe uit. Standaard zal deze VR-applicatie een lege wereld tonen met trackers/controllers (indien beschikbaar).

getVREvents zal een lijst van evenementen voor geselecteerde VR-apparaten die status sinds de laatste oproep om VREventen te krijgen, wijzigen. Wanneer geen apparaat wordt verstrektTypeFilter, is de standaard om alleen VR DEVICE CONTROLLER status te rapporteren. U kunt kiezen uit elke combinatie van apparaten zoals VR DEVICE CONTROLLER, VR DEVICE & HMD (Head Mounted Device) en VR = DEVISE GENERIC TRACKER (zoals de HTC Vive Tracker). Merk op dat VR DEVICE HMD en VR DEVICE GENERIC TRACKER alleen positie- en oriëntatiegebeurtenissen rapporteren. getVREvents heeft de volgende parameters:
optioneel apparaatTypeFilter int standaard is VR DEVICE CONTROLLER. U kunt ook kiezen voor VR DEVICE HMD of VR DEVICE GENERIC TRACKER of een combinatie van hen.
optioneel allesAnalogAxes int 1 voor alle analoge assen, 0 met slechts één as
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je er een kiezen.
De outputparameters zijn:

controllerId int controller index (0.MAX VR CONTROLERS)
controllerPosition vec3, lijst van 3 praalwagens controller positie, in de wereld ruimte Cartesiaanse coördinaten
controllerOrientation vec4, lijst van 4 floats controller oriëntatie kwartion [x,y,z,w] in de wereldruimte
controllerAnalogeAxis float analoge as waarde
numButtonEvents int aantal knop gebeurtenissen sinds laatste oproep om VREvenementen te krijgen
numMoveEvents int aantal bewegende gebeurtenissen sinds laatste oproep om VREvenementen te krijgen
knoppen int[64], lijst met button statuss (OpenVR heeft maximaal 64 toetsen)
vlaggen voor elke knop: VR BUTTON IS DOWN (momenteel ingedrukt), VR BUTTON WAS TRIGGERED (is ten minste één keer gedaald sinds laatste cal om VRVEvents te krijgen, VR & BUTTON/WAS-RELATED (werd uitgebracht minstens eenmaal sinds de vorige oproep tot het verkrijgen vanVRGEvent). Merk op dat alleen VR BUTTON IS DOWN actuele status rapporteert. Bijvoorbeeld als de knop naar beneden en omhoog ging, kun je zien aan de BERICHT/VERWANTE vlaggen, ook al is IS DOWN nog steeds vals. Merk op dat in het logbestand, die knoppen zijn verpakt met 10 knopen in 1 geheel getal (3 bits per knoop).
alleAnalogAxes (alleen indien uitdrukkelijk gevraagd!)
lijst van 10 floats momenteel, MAX VR ANALOGU AXIS is 5, voor elke as x en y waarde.
Zie Bullet/examples/pybullet/exemplaren/vrEvents.py voor een voorbeeld van VR tekening en Bullet / examples / pylullet/voorbeelden/vrTracker.py om HMD en generische tracker te volgen. setVRCameraState
setVRCameraState staat het mogelijk om de camera root transform offset positie en oriëntatie. Hierdoor kan de positie van de VR-camera in de virtuele wereld worden bepaald. Het is ook mogelijk om de VR Camera een object te laten volgen, zoals bijvoorbeeld het voertuig. setVRCameraState heeft de volgende argumenten (er zijn geen rendementswaarden):
optionele rootPosition vec3, vector van 3 floats camerawortelpositie
optionele rootOrientation vec4, vector van 4 floats cameraworteloriëntatie in quaternion formaat [x,y,z,w].
optionele trackObject vec3, vector van 3 drijft het object unieke id om te volgen
optionele trackObjectVlag int flags.VR CAMERA TRACK OBJECT ORIËNTATIO N (indien ingeschakeld, zowel positie als oriëntatie wordt gevolgd)
optionele fysicaClientId int als je verbonden bent met meerdere servers, kun je kiezen

Eén.
PyBullet heeft een aantal functionaliteiten om het gemakkelijker te maken debuggen, visualiseren en afstellen van de simulatie. Deze functie is alleen nuttig als er een 3D visualisatievenster bestaat, zoals GUI-modus of wanneer deze verbonden wordt met een afzonderlijke physicsserver (zoals Voorbeeldbrowser in de 'Physic Server' modus of standalone Physics Server met OpenGL GUI).
U kunt een 3D-lijn opgeven die wordt gespecificeerd door het 3d startpunt (vanaf) en eindpunt (naar), de kleur [rood, groen, blauw], de lijnbreedte en duur in seconden. De argumenten om UserDebugline toe te voegen zijn:
vereiste lijnFromXYZ vec3, lijst van 3 praalwagens
startpunt van de lijn in Cartesiaanse wereldcoördinaten
vereist lijnToXYZ vec3, lijst van 3 praalwagens
eindpunt van de lijn in Cartesiaanse wereldcoördinaten
optionele lijnColorRGB vec3, lijst van 3 praalwagens
RGB-kleur [rood, groen, blauw] elk onderdeel in bereik [0..1]
optionele lijnBreedte floatlijnbreedte (beperkt door OpenGL implementatie)
optioneel levensduurTijdsfloat gebruik 0 voor permanente lijn, of positieve tijd in seconden (na de regel met automatisch worden verwijderd)
optionele ouderObjectUniqueId int nieuw in komende PyBullet 1.0.8: teken lijn in lokale coördinaten van een moederobject/link.
optionele parentLinkIndex int nieuw in de komende PyBullet 1.0.8: teken lijn in lokale coördinaten van een ouderobject/link.
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
addUserDebugLine zal een niet-negatieve unieke id teruggeven, waarmee u de regel kunt verwijderen met behulp van removeUsers DebugItem. addUserDebugText
U kunt een aantal 3D tekst op een specifieke locatie toevoegen met behulp van kleur en grootte. De argumenten die worden aangevoerd zijn:

vereiste teksttekst als tekenreeks (array van tekens)
vereiste tekstPosition vec3, lijst van 3 praalwagens
3d positie van de tekst in Cartesiaanse wereldcoördinaten [x,y,z]
optionele tekstColorRGB vec3, lijst van 3 praalwagens
RGB-kleur [rood, groen, blauw] elk onderdeel in bereik [0..1]
optionele tekstgrootte float Tekstformaat
optioneel levensduurTijdsfloat gebruik 0 voor permanente tekst, of positieve tijd in seconden (na de tekst met automatisch worden verwijderd)
optionele tekstOrientatie vec4, lijst van 4 praalwagens
Standaard zal debugtekst altijd met een camera geconfronteerd worden, automatisch roteren. Door een tekstoriëntatie (quaternion) te specificeren, wordt de oriëntatie in wereldruimte of lokale ruimte vastgelegd (wanneer ouder gespecificeerd is). Merk op dat een andere implementatie/schaduw wordt gebruikt voor tekst met camera naar voren, met verschillende uitstraling: de camera-tekst maakt gebruik van bitmaplettertypen en tekst met gespecificeerde oriëntatie gebruikt TrueType lettertypes.
optionele ouderObjectUniqueId int nieuw in komende PyBullet 1.0.8: teken lijn in lokale coördinaten van een moederobject/link.
optionele parentLinkIndex int nieuw in de komende PyBullet 1.0.8: teken lijn in lokale coördinaten van een ouderobject/link.
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
addUserDebugText zal een niet-negatieve unieke id teruggeven, waarmee u de regel kunt verwijderen met removeUsers DebugItem. Zie ook pybullet/voorbeelden / debugDrawItems.py
addUserDebugParameter kunt u aangepaste schuifregelaars toevoegen om parameters af te stemmen. Het zal een uniek ID teruggeven. Hiermee kunt u de waarde van de parameter lezen met behulp van readUserDebugParameter. De invoerparameters van addUserDebugParameter zijn:
vereiste paramNaam tekenreeksnaam van de parameter
vereist bereikMin float minimum waarde
vereist bereikMax float maximum waarde
vereiste startValue float beginwaarde
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen

De invoerparameters van readUserDebugParameter zijn:
vereist itemUniekId int het unieke id teruggegeven door 'addUserDebugParameter)
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
De functies om debuglijnen, tekst of parameters toe te voegen zullen een niet-negatieve unieke id teruggeven als het gelukt is. U kunt het debug-item verwijderen met behulp van dit unieke id door gebruik te maken van de removeUserDebugItem methode.
vereist itemUniqueId int unieke id van het debug-item dat verwijderd moet worden (regel, tekst etc)
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
Deze API zal alle debug items (tekst, regels etc.) verwijderen.
De ingebouwde OpenGL visualisaties hebben een wireframe debug rendering feature: druk op 'w' om te schakelen. Het wireframe heeft een aantal standaard kleuren. U kunt de kleur van een specifiek object overschrijven en linken met setDebugObjectColor. De invoerparameters zijn:
vereist objectUniqueId int unieke id van het voorwerp
vereiste linkIndex int koppelingsindex
optioneel objectDebugColorRGB vec3, lijst van 3 ploats debugkleur in [Rood,Groen,Blauw]. Indien niet opgegeven, zal de aangepaste kleur worden verwijderd.
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen

U kunt een aantal instellingen van de ingebouwde OpenGL visualisatie instellen, zoals het inschakelen of uitschakelen van wireframe, schaduwen en GUI rendering. Dit is handig omdat sommige laptops of Desktop GUI's prestatieproblemen hebben met onze OpenGL 3 visualisatie.
VEREIST VLAG INT DE FUNCTIE OM AAN TE ZETTEN OF UIT TE SCHAKELEN, ZOALS COV ENABLE WIREFRAME, COV ENABLE SHADOWS,COV ENABLE GUI, COV ENABLE$VR PICKING, COV ENACTIVE VR TELEPORTING, COV ENABLE RENDERING, COF ENABILITY TINY RENDERER, CO V ENAVABLE VR RENDER CONTROLLERS, COB ENIBEL KEYBOARD SHORTCUTS, COVER ENABEL MOUSE PLIKKEN, COW ENABILI Y AXIS UP (Z IS STANDAARD WORLD UP AS),COV ENDABLE RGB BUFFER PREVIEW, COVARE ENIBLE DEEPHIC BUUFFER PRECORD, COVERSABLE SEGMENT MARK PREVIVAL
vereist int 0 of 1 inschakelen
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
U kunt de 3D OpenGL-debug visualizer cameraafstand (tussen oog en camera doelpositie), camera gier en pitch en camera target positie resetten.
vereiste cameraAfstandsafstand van oog naar doelpositie
vereiste cameraYaw floatcamera gierhoek (in graden) links/rechts
vereiste cameraPitch floatcamera pitch hoek (in graden) omhoog/omlaag
vereist cameraTargetPosition vec3, lijst van 3 floats cameraTartetPositie is het focuspunt voor de camera
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen

U kunt de breedte en hoogte (in pixels) van de camera, het uitzicht en projectiematrix met behulp van dit commando. Invoerparameter is de optionele natuurkundeClientId. Uitvoerinformatie is:
breedte intbreedte van de cameraafbeelding in pixels
hoogte inthoogte van de cameraafbeelding in pixels
viewMatrix float16, lijst van 16 praalwagens
weergavematrix van de camera
projectieMatrix float16, lijst van 16 praalwagens
projectiematrix van de camera
cameraUp float3, lijst van 3 praalwagens
boven as van de camera, in Cartesiaanse wereld ruimte coördinaten
cameraVoorwaarts float3, lijst van 3 praalwagens
voorste as van de camera, in Cartesiaanse wereld ruimtecoördinaten
horizontale float3, lijst van 3 praalwagens
TBD. Dit is een horizontale vector die gebruikt kan worden om stralen te genereren (voor het kiezen van de muis of voor het creëren van een eenvoudige ray tracer bijvoorbeeld)
verticale float3, lijst van 3 praalwagens
TBD.Dit is een verticale vector die kan worden gebruikt om stralen(voor muis picking of het creëren van een eenvoudige ray tracer bijvoorbeeld te genereren).
gier de yauw hoek van de camera, in Cartesische lokale ruimte coördinaten
pitch float toonhoogte hoek van de camera, in Cartesische lokale ruimte coördinaten
dist float afstand tussen de camera en het doel van de camera
doelfloat3, lijst van 3 drijfwielen
doel van de camera, in Cartesiaanse wereld ruimte coördinaten
Je kunt alle toetsenbordevenementen ontvangen die er gebeurd zijn sinds de laatste keer dat je 'getKeyboardEvents' noemde. Elk evenement heeft een sleutelcode en staat. De staat is een beetje vlag combinatie van KEY IS DOWN, KEY WAS TRIGGEED en KEY-WAS-RELEaseD. Als een sleutel van 'up' naar 'down' staat gaat, dan ontvangt u de KEY IS DOWN-staat en ook de KEEY WAS TRIGGEED toestand. Als een sleutel ingedrukt en vrijgegeven is, zal de status KEY IS DOWN zijn en KEY WAS RELATED.

SOMMIGE SPECIALE TOETSEN WORDEN GEDEFINIEERD: B3G F1 ... B3 G F12, B3GO LEFT ARROW, B4G RIGHT AROW, B2G UP ARLOW, B6G DOWN ARW, B7G PAGE UP, B5G PAGE DOWN, B8G SUM, B1G UND, B0G D, B9G BACK. De input van getKeyboardEvents is een optionele natuurkundeClientId:
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
De output is een woordenboek van keycode 'toets' en toetsenbord staat "waarde." getMouseEvents
Net als bij KeyboardEvents, kunt u de muis gebeurtenissen die gebeurd sinds het laatste gesprek om te krijgenMouseEvent. Alle muismove-evenementen worden samengevoegd tot één muis move-gebeurtenis met de meest up-to-date positie. Bovendien zijn alle muisknop gebeurtenissen voor een bepaalde knop samengevoegd. Als er een knop naar beneden en omhoog ging, zal de staat 'KEY WAS TRIGGERED' zijn. We gebruiken de KEY WAS TRIGGEED /KEY IS DOWN /Khey WAs RELEASE voor de muisknop staat. Invoerargumenten voor getMouseEvents zijn:
optionele natuurkundeClientId int als je verbonden bent met meerdere servers, kun je er een kiezen
De uitvoer is een lijst van muis gebeurtenissen in het volgende formaat:
eventType int MOUSE MOVE EVENT=1, MOuse BUTTON EVENT=2
muisPosX float x-coördinaten van de muis pointer
muisPosY float y-coördinaten van de muis pointer
knopIndex int-toetsenindex voor linker/midden/rechter muisknop
knopState int flag KEY WAS TRIGGERED /KEY IS DOWN /KY WAs RELATESED
Er zijn een paar verschillende manieren om PyBullet te installeren op Windows, Mac OSX en Linux. We gebruiken Python 2.7 en Pythons 3.5.2, maar verwachten dat de meeste Pythone 2.x en Pythyn 3.x versies zouden moeten werken. De makkelijkste om PyBullet aan het werk te krijgen is met behulp van pip of python setup.py:

Zorg ervoor dat Python en pip is geïnstalleerd, en voer vervolgens: pip installeren pybullet Merk op dat als je PIP gebruikt om PyBullet te installeren, het nog steeds voordelig is om ook de C++ Bullet Physics SDK te installeren: het bevat gegevensbestanden, natuurkunde servers en gereedschappen die nuttig zijn voor PyBULET. Je kunt ook 'python setup.py build' en 'python setup install.py installeer' draaien in de root van de Bullet Physics SDK (verkrijg het SDK uithttp://github.com/bulletphysics/bulletje3) Zie ookhttps://pypi.python.org/pypi/pybullet Als alternatief kunt u PyBullet installeren vanaf broncode met behulp van premake (Windows) of cmake: Gebruik makend Premake voor Windows
Zorg ervoor dat een Python versie is geïnstalleerd in c:\python-3.5.2 (of andere versie map naam) Eerst krijg je de broncode van github, met behulp van git kloonhttps://github.com/bulletphysics/bulletje3 Klik op build visual studio vr pybullet double.bat en open het 0 Bullet3Solution.sln project in Visual Studio, converteer projecten indien nodig. Schakel over naar Release mode en compileer het 'pybullet' project.

Dan zijn er een paar opties om pybullet te importeren in een Python tolk:

cd c:\python-3.5.2\dlls
mklink pybullet.pyd c:\develop\bullet3\bin\pybullet vs2010.dll Dan Python.exe uitvoeren en import-pijltje moet werken. Gebruik van cmake op Linux en Mac OSX

○ pybullet.connect(pybullet.GUI,options="-opengl2") ● Als alternatief kunt u de natuurkundeserver draaien op een externe machine met UDP of TCP brug en verbinding maken van lokale laptop naar de remote server via UDP tunneling. (todo: beschrijving van stappen in detail)
Vraag: Waar gaan we heen om steun en om kwesties te rapporteren? Antwoord: Er is een discussieforum ophttp://pybullet.org/Bullet en een nummer tracker ophttps://github.com/bulletphysics/bulletje3 Vraag: Hoe voegen we een citaat toe aan PyBullet in onze academische paper? Antwoord: @MISC{coumans2018,
auteur = {Erwin Coumans en Yunfei Bai}, titel = ~ PyBullet, een Python module voor natuurkunde simulatie voor spellen, robotica en machine learning}, hoe gepubliceerd = \url{http://pybullet.org } Vraag: Wat gebeurt er met Bullet 2.x en de Bullet 3 OpenCL implementatie? Antwoord: PyBullet is de Bullet C-API aan het inpakken. We zullen de Bullet 3 OpenCL GPU API (en toekomstige Bullet 4.x API) achter deze C-API plaatsen. Dus als je PyBullet of de C-API gebruikt, ben je toekomstbestendig. Niet te verwarren met de Bullet 2.x C++ API. Vraag: Moet ik koppel/krachtregeling of snelheids- en positiecontrolemodus gebruiken? In het algemeen is het beste om te beginnen met positie of snelheidscontrole. Er is veel meer inspanning nodig om de kracht/torque controle betrouwbaar te krijgen. Vraag: Hoe de zwaartekracht alleen voor sommige delen van een robot (bijvoorbeeld de arm) uit te schakelen? Antwoord:
Op dit moment is deze niet blootgesteld, dus je zou ofwel draai van zwaartekracht versnelling voor alle objecten moeten toepassen en handmatig de zwaartekracht gebruiken voor de voorwerpen die het nodig hebben.

Of je kunt actief zwaartekracht compenserende krachten berekenen, zoals gebeurt op een echte robot. Omdat Bullet een volledig beperkingssysteem heeft, zou het triviaal zijn om die anti-zwaartekrachtkrachten te berekenen: Je kunt een tweede simulatie uitvoeren (PyBullet laat je verbinding maken met meerdere natuurkundeservers) en de robot onder zwaartekracht plaatsen, gezamenlijke positiecontrole instellen zodat deze positie naar wens blijft staan en die 'antigravity' krachten verzamelen. Pas die dan toe in de hoofdsimulatie. Vraag: Hoe objecten op-/afschalen? Antwoord: U kunt de globale waarde van ScaleFactor als optioneel argument gebruiken omURDF en loadSDF te laden. Anders is het schalen van visuele vormen en botsingsvormen deel uit van de meeste bestandsformaten, zoals URDF en SDF. Op dit moment kun je objecten niet opnieuw schalen. Vraag: Hoe kan ik texturen in mijn modellen krijgen? Antwoord: U kunt het Wavefront .obj bestandsformaat gebruiken. Dit zal materiële bestanden ondersteunen (.mtl). Er zijn verschillende voorbeelden van texturen in de Bullet/data map. U kunt de textuur voor bestaande texture objecten wijzigen met behulp van de 'changeTexture' API. Vraag: Welke textuur bestandsformaten zijn geldig voor PyBullet? Antwoord: Bullet gebruikt stb image om textuurbestanden te laden, die PNG, JPG, TGA, GIF etc. laadt. zie stb image.h voor details Vraag: Hoe kan ik de prestaties en stabiliteit van het detecteren van botsingen verbeteren? Antwoord: Er zijn vele manieren om te optimaliseren, bijvoorbeeld vorm type 1) Kies een of meerdere primitieve botsingsvormtypes zoals doos, bol, capsule, cilinder voor het benaderen van een object in plaats van convexe of concave driehoek meshes. 2) Als je echt driehoek meshes moet gebruiken, maak dan een convexe decompositie met behulp van Hierarchical Geschatte Convex Decomposition (v-HACD). Het test hacd hulpprogramma zet convex driehoeksmash om in een OBJ-bestand naar een nieuw OBj bestand met meerdere bolle rompobjecten. Zie bijvoorbeeld Bullet/data/teddy vhacd.urdf die wijst op Bullet / data/teddy2 VHACD CHs.obj , of eend vhacd.urdf wijzen naar deck vHacd .ob j. 3) Verminder het aantal hoekpunten in een driehoeksmaas. Zo heeft Blender 3D een grote maasdecimation modifier die je interactief het resultaat van de mesh vereenvoudiging laat zien. 4) Gebruik rolfrictie en spinnende wrijving voor ronde objecten zoals bol, capsules en robot grippers met behulp van de en knooppunten binnen Knooppunten. Zie bijvoorbeeld Bullet/data/sphere2.urdf 5) Gebruik een kleine hoeveelheid conformiteit voor wielen met behulp van de binnenin de URDF xml knooppunt. Zie bijvoorbeeld het Bullet/data/husky/huski.urdf voertuig. 6) Gebruik de dubbele precisie bouw van Bullet, dit is goed voor zowel contact stabiliteit en botsing nauwkeurigheid. Kies een goede inperkingsoplossing en tijdstap.

Antwoord: standaard gebruiken Bullet en PyBullet een exacte impliciete kegelfrictie voor het Coulomb wrijvingsmodel. Daarnaast kunt u het rollen en draaien wrijving door toevoeging van een en knooppunt binnen de knooppunt, zie bijvoorbeeld de Bullet/data/sphere2.urdf. In plaats van de kegel wrijving, kunt u piramidale benadering. Vraag: Wat voor constante of drempel binnen Bullet, dat maakt hoge snelheden onmogelijk?
Antwoord: Standaard is Bullet afhankelijk van discrete botsingsdetectie in combinatie met penetratieherstel. Het louter op discrete botsingsdetectie toepassen betekent dat een object niet sneller mag reizen dan zijn eigen straal binnen één tijdstap. PyBullet gebruikt 1./240 als standaard tijdstap. Tijdstappen groter dan 1./60 kunnen instabiliteiten invoeren om verschillende redenen (diepe penetraties, numeriek geïntegreerde). Bullet heeft een optie voor continue botsing detectie om aanrijdingen te vangen bij objecten die sneller dan hun eigen straal binnen één tijdstap bewegen. Helaas kan deze continue botsingsdetectie zijn eigen problemen (prestatie en niet-fysieke respons, gebrek aan restitutie) introduceren.Daarom is dit experimentele kenmerk standaard niet ingeschakeld.
Pagina's waarnaar wordt verwezen in deze handleiding — fabrikant, ondersteuning en downloads.
Eigenaren en ons team reageren doorgaans binnen een dag — en uw vraag helpt ook de volgende persoon.
Stel als eerste een vraag — andere eigenaren of ons team geven antwoord.