This documentation reflects AI2-THOR version 2.1.0. For the latest AI2-THOR documentation, visit ai2thor.allenai.org.

Miscellaneous Actions

Remove Object from Scene

Remove an object from the current scene by objectId. This can be used to edit scenes by removing specific objects if desired.

event = controller.step(dict(action='RemoveFromScene', objectId="Mug|0.25|-0.27"))
Parameter Type Description Default
objectId string the string unique id of the target object null

Make All Pickupable Objects Moveable

Reset kinematics of all pickupable objects in the scene so that they are affected by gravity. This is to ensure immediate physics reactions in cases where objects are thrown or pushed into each other and they need to bounce and react immediately. Without running this, some objects might default to stationary placement, where they will not immediately respond to physics. Use this if running a scene with the intention of realistically throwing/pushing/colliding objects around.

event = controller.step(dict(action='MakeAllPickupableObjectsMoveable'))

AddThirdPartyCamera

Add a third party camera to the scene. See Event / Metadata section for information on how to receive the frame.

controller.step(
    dict(
        action='AddThirdPartyCamera',
        rotation=dict(x=0, y=90, z=0),
        position=dict(x=-1.25, y=1.0, z=-1.0)
        )
    )



UpdateThirdPartyCamera

Update the position/rotation of a thirdPartyCamera. Both rotation and position are required.

controller.step(
    dict(
        action='UpdateThirdPartyCamera',
        thirdPartyCameraId=0, # id is available in the metadata response
        rotation=dict(x=0, y=90, z=0),
        position=dict(x=-1.25, y=1.0, z=-1.5)
        )
    )



Next Steps

Continue on to the Event/Metadata documentation for metadata information.