Gazebo | Ignition | Community
Ask Your Question

Which SDFormat corresponds to version of Gazebo

asked 2017-02-16 01:13:38 -0500

davetcoleman gravatar image

I've searched around and its not clear which version of the SDF spec (1.4-1.6) corresponds to Gazebo7, etc. My Ubuntu 16.04 package manager says I have SDFormat4 install, further confusing me. Why isn't the binary release matching the spec version?

From the Gazebo changelog, it seems Gazebo7 uses 1.6, but its not 100% clear. Perhaps this can be added to the documentation/website somewhere?

edit retag flag offensive close merge delete


This is a common source of confusion, see this question for example:

chapulina gravatar imagechapulina ( 2017-02-16 11:29:54 -0500 )edit

Gazebo7 should support SDF 1.6 but I cannot find a clear answer by simply looking at dpkg, changelogs or

hugomatic gravatar imagehugomatic ( 2017-02-17 16:14:16 -0500 )edit

How can we improve this for others?

davetcoleman gravatar imagedavetcoleman ( 2017-02-20 18:38:42 -0500 )edit

1 Answer

Sort by ยป oldest newest most voted

answered 2017-02-21 09:36:48 -0500

Jose Luis Rivero gravatar image

The SDF spec version supported has nothing to do with the versioning of SDFormat package. SDF is a format specification and as such, it has it's own versions: 1.4, 1.5, 1.6 (as of today). In debian/ubuntu it is distributed with the package name of sdformat-sdf and it is not strictly related to a particular version of the rest of SDFormat packages although all them come from the same source tarball.

SDFormat is a C++ software which works with the SDF specification. It follows semantic versioning and major versions corresspond to changes in ABI. It versioning scheme has nothing to do with the SDF protocol supported.

The confusion could come from the fact that both are hosted in the same repository and are installed together. In Gazebo we use the dependency directly on SDFormat since it would bring the SDF protocol needed by a particular version (plus the expected API, etc).

edit flag offensive delete link more


On there should be a table comparing Gazebo version to SDFormat verison like there is on Maybe a link to more details (the ones you just provided here). Where can I open a ticket for this documentation request?

davetcoleman gravatar imagedavetcoleman ( 2017-02-22 03:41:23 -0500 )edit

I started something like this on this pull request to gazebo tutorials: @jose-luis-rivero, what do you think of adding information about the SDF spec there too? Feel free to commit directly to that branch if you wish.

chapulina gravatar imagechapulina ( 2017-02-22 09:15:08 -0500 )edit

I've added some information to that PR: , hopefully it will help with the problem. We could also consider to add the information about SDF vs SDFormat in the front page.

Jose Luis Rivero gravatar imageJose Luis Rivero ( 2017-02-22 10:20:12 -0500 )edit

Thank you!

chapulina gravatar imagechapulina ( 2017-02-22 10:37:16 -0500 )edit
Login/Signup to Answer

Question Tools

1 follower


Asked: 2017-02-16 01:13:38 -0500

Seen: 4,224 times

Last updated: Feb 21 '17