[WIP] added advanced plane documentation

[frede791]

Add documentation for the Advanced Plane that provides better aerodynamic simulation than the regular plane.
The plane is currently being added to PX4 in PX4/PX4-Autopilot#22167.
The advanced lift drag plugin that forms the centerpiece of the model was merged into Gazebo in gazebosim/gz-sim#2185.

[frede791]

Just noticed the path is wrong. Shouldn't it be going to: ../sim_gazebo_gz/vehicles.md not ../gazebo_vehicles

[hamishwillee]

I'm good with this (modulo your comments on the release note). I presume though we'll wait on the PX4 PR to merge first?

[frede791]

@hamishwillee Yes, I'll let you know once the advanced plane has been merged into PX4.

[hamishwillee]

Yes, I'll let you know once the advanced plane has been merged into PX4.

Thanks very much. This looks good. Note, I added WIP to the title just to remind me not to merge prematurely.

[frede791]

@hamishwillee The advanced plane has been merged, so this can be merged as well now.
One issue: The advanced lift drag plugin is not yet released as part of the gz distribution. Should we maybe make a note of that on this page somewhere?

[github-actions]

No flaws found

[hamishwillee]

One issue: The advanced lift drag plugin is not yet released as part of the gz distribution. Should we maybe make a note of that on this page somewhere?

make px4_sitl gz_advanced_plane seems to work for me on main, so I think that this can merge. What difference would it make for users to add this note?
i.e. if this will affect people then sure, we should add a note as a post process - but it does not appear to.

[frede791]

@hamishwillee Did you get a plugin error? Because that is what currently happens for me.

[hamishwillee]

@frede791 I didn't see a plugin error, but now I do.

INFO  [gz_bridge] world: default, model name: advanced_plane_0, simulation model: advanced_plane
[Err] [SystemLoader.cc:119] Failed to load system plugin: (Reason: Could not find shared library)
- Requested plugin name: [gz::sim::systems::AdvancedLiftDrag]
- Requested library name: [gz-sim-advanced-lift-drag-system]
- Library search paths:
  - /home/ubuntu/.gz/sim/plugins/
  - /usr/lib/x86_64-linux-gnu/gz-sim-7/plugins/
  - /home/ubuntu/.ignition/gazebo/plugins/

So yes, if this is actually broken we do need a note. Can you add one? Ideally with a link to issue that we can track to allow us to remove the note when this works.