tdw 1.9.2.0

3D simulation environment

ThreeDWorld (TDW)

ThreeDWorld (TDW) is a platform for interactive multi-modal physical simulation. With TDW, users can simulate high-fidelity sensory data and physical interactions between mobile agents and objects in a wide variety of rich 3D environments.

• Code of Conduct
• Changelog
• License
• Website
• Example controllers

1. General guide to TDW

1.1 Setup

1. Install TDW
2. Upgrade TDW

1.2 Core Concepts

1. The controller
2. Auto-launching the TDW build
3. Commands
4. Design philosophy of TDW
5. Scenes
6. Avatars and cameras
7. Add-ons and the ThirdPersonCamera
8. Objects
9. Output data
10. Images

1.3 Troubleshooting

1. How to report an issue
2. Common errors
3. Performance optimizations
4. Good coding practices
5. The Logger add-on

2. Tutorials

2.1 Objects and Scenes

1. Overview
2. Scripted object placement (floorplan layouts)
3. Visual materials, textures, and colors
4. Procedural generation (scenes)
5. Units and data formats
6. Bounds output data
7. Procedural generation (objects)
8. Raycast output data
9. Overlap output data
10. Reset a scene

High-level API: Floorplan

2.2 3D Model Libraries

1. Overview
2. Free models
3. Non-free models
4. Add your own models to TDW
5. Add ShapeNet models to TDW

2.3 Visual Perception

1. Overview
2. Instance ID segmentation colors (_id pass)
3. Semantic category segmentation colors (_category pass)
4. Depth maps (_depth and _depth_simple passes)
5. Motion perception (_flow pass)
6. Other image passes (_mask, _normals, and _albedo passes)
7. Occlusion output data

2.4 Camera Controls

1. Overview
2. Move a camera
3. Rotate a camera
4. Follow an object
5. The CinematicCamera add-on

2.5 Photorealism

1. Overview
2. Lighting (HDRI skyboxes)
3. Post-processing
4. Depth of field

High-level API: tdw_image_dataset

2.6 Physics

Overview

2.6.1 Physics (PhysX)

1. PhysX
2. Object physics parameters
3. Rigidbodies output data
4. Collision output data
5. Apply forces to objects
6. Composite objects (objects with affordances)
7. Skip physics frames
8. Disable physics

High-level API: tdw_physics

2.6.2 Physics (Flex)

1. Flex
2. Solid and soft actors
3. Cloth actors
4. Fluid and source actors
5. Move, rotate, and scale Flex objects
6. FlexParticles output data
7. Apply forces to Flex objects
8. Reset a Flex scene
9. Other Flex commands

High-level API: tdw_physics

2.8 Audio

1. Overview
2. Initialize audio and play .wav files
3. Resonance Audio
4. PyImpact (dynamic impact sounds)
5. Recording audio
6. PyImpact (advanced API)
7. Audio perception

2.9 Video Recording

1. Overview
2. Image-only video
3. Video with audio

2.10 Agents

Overview

2.10.1 Robots

1. Overview
2. The Robot add-on
3. Robot arm add-ons
4. Robot collision detection
5. Select a robot
6. Add your own robots to TDW
7. Robotics API (low-level)
8. Add a camera to a robot

2.10.2 Magnebots

1. Magnebot API (external repo)

2.10.3 Human user interaction

1. Overview
2. Keyboard controls
3. Virtual reality

2.10.4 Embodied avatars

1. The EmbodiedAvatar

2.11 Multi-agent simulations

1. Overview
2. Custom agent classes

2.12 Navigation

1. Overview
2. NavMesh pathfinding
3. Occupancy maps

2.13 Non-physics objects

1. Overview
2. Position markers
3. Textured quads
4. Non-physics humanoids

2.14 Misc. remote server topics

1. Launch a TDW build on a remote server from a personal computer
2. Remote rendering with xpra

2.15 Misc. other topics

1. C# source code
2. Freezing your code

3. API Documentation

3.1 Command API

• Command API
• Output Data

3.2 tdw module API

tdw

• AssetBundleCreator
• AssetBundleCreatorBase
• AudioUtils
• Controller
• IntPair
• QuaternionUtils
• RemoteBuildLauncher
• RobotCreator
• TDWUtils

tdw.add_ons

• AddOn
• AudioInitializer
• AudioInitializerBase
• AvatarBody
• Benchmark
• CinematicCamera
• CollisionManager
• EmbodiedAvatar
• Floorplan
• ImageCapture
• Keyboard
• Logger
• ModelVerifier
• ObjectManager
• OccupancyMap
• PhysicsAudioRecorder
• PyImpact
• ResonanceAudioInitializer
• Robot
• RobotArm
• RobotBase
• StepPhysics
• ThirdPersonCamera
• ThirdPersonCameraBase

tdw.collision_data

• CollisionBase
• CollisionObjEnv
• CollisionObjObj

tdw.flex_data

• FluidType

tdw.librarian

• HdriSkyboxLibrarian
• HumanoidAnimationLibrarian
• HumanoidLibrarian
• MaterialLibrarian
• ModelLibrarian
• RobotLibrarian
• SceneLibrarian

tdw.model_tests

• MissingMaterials
• ModelReport
• ModelTest
• PhysicsQuality
• RotateObjectTest

tdw.object_data

• Bound
• ObjectStatic
• Rigidbody
• Transform

tdw.physics_audio

• AudioMaterial
• Base64Sound
• CollisionAudioEvent
• CollisionAudioInfo
• CollisionAudioType
• Modes
• ObjectAudioStatic
• ScrapeMaterial
• ScrapeModel
• ScrapeSubObject

tdw.release

• Build
• Pypi

tdw.robot_data

• Drive
• JointDynamic
• JointStatic
• JointType
• NonMoving
• RobotDynamic
• RobotStatic

tdw.scene_data

• RegionBounds
• SceneBounds

4. Performance benchmarks

1. Performance benchmarks
2. Image capture
3. Object data
4. Command deserialization