Get Started

Welcome to the SDF documentation! This is a great place for new and experienced SDF users to start. Each category to the left presents a collection of relevant documentation.

Use the Edit button in the upper right corner of a tutorial page to go directly to its source at

Installation instruction.
Quickstart guide to SDF parsing.
Installation instruction.
Quickstart guide to SDF parsing.
Specifying pose in SDFormat.
Specifying model kinematics with links and joints in SDFormat.
Adding shapes to a model with collisions and visuals in SDFormat.
Creating worlds in SDFormat.
Setting the material properties of visuals in SDFormat.
Describing existing behavior for element naming, definition of coordinate frames, referencing parent and child links, and nested model behavior.
Proposing new behavior for SDF 1.7, including semantics for the pose frame attribute, the frame element, new rules for element naming, and corresponding examples.
Proposal for supporting custom elements and attributes in SDFormat and libsdformat.