Skip to content

Commit 2d3645b

Browse files
committed
Add canonicalURL to all docs
1 parent d99d59e commit 2d3645b

File tree

5,113 files changed

+700216
-679764
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

5,113 files changed

+700216
-679764
lines changed

de/README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
1+
---
2+
canonicalUrl: https://docs.px4.io/main/de/README
3+
---
4+
15
<div style="float:right; padding:10px; margin-right:20px;"><a href="https://px4.io/"><img src="../assets/site/logo_pro_small.png" title="PX4 Logo" width="180px" /></a></div>
26

37
# PX4 Autopilot User Guide ({{ $themeConfig.px4_version }})
@@ -6,7 +10,7 @@
610

711
PX4 is the _Professional Autopilot_. Developed by world-class developers from industry and academia, and supported by an active world wide community, it powers all kinds of vehicles from racing and cargo drones through to ground vehicles and submersibles.
812

9-
:::tip
13+
:::tip
1014
This guide contains everything you need to assemble, configure, and safely fly a PX4-based vehicle. Interested in contributing? Check out the [Development](development/development.md) section. :::
1115

1216
## How Do I Get Started?
@@ -100,7 +104,7 @@ The _Dronecode Calendar_ shows important community events for platform users and
100104
- [Pacific Time – Tijuana](https://calendar.google.com/calendar/embed?src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&ctz=America%2FTijuana)
101105
- [Australia – Melbourne/Sydney/Hobart](https://calendar.google.com/calendar/embed?src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&ctz=Australia%2FSydney)
102106

103-
:::tip
107+
:::tip
104108
The calendar default timezone is Central European Time (CET).
105109

106110
:::

de/SUMMARY.md

Lines changed: 704 additions & 700 deletions
Large diffs are not rendered by default.

de/advanced/README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,5 @@
1+
---
2+
canonicalUrl: https://docs.px4.io/main/de/advanced/README
3+
---
4+
15
# Advanced Topics

de/advanced/computer_vision.md

Lines changed: 61 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,61 @@
1-
# Computer Vision (Optical Flow, MoCap, VIO, Avoidance)
2-
3-
[Computer vision](https://en.wikipedia.org/wiki/Computer_vision) techniques enable computers to use visual data to make sense of their environment.
4-
5-
PX4 uses computer vision systems (primarily running on [Companion Computers](../companion_computer/README.md)) in order to support the following features:
6-
7-
- [Optical Flow](#optical-flow) provides 2D velocity estimation (using a downward facing camera and a downward facing distance sensor).
8-
- [Motion Capture](#motion-capture) provides 3D pose estimation using a vision system that is _external_ to the vehicle. It is primarily used for indoor navigation.
9-
- [Visual Inertial Odometry](#visual-inertial-odometry-vio) provides 3D pose and velocity estimation using an onboard vision system and IMU. It is used for navigation when global position information is absent or unreliable.
10-
- [Obstacle Avoidance](../computer_vision/obstacle_avoidance.md) provides full navigation around obstacles when flying a planned path (currently missions are supported). This uses [PX4/PX4-Avoidance](https://github.com/PX4/PX4-Avoidance) running on a companion computer.
11-
- [Collision Prevention](../computer_vision/collision_prevention.md) is used to stop vehicles before they can crash into an obstacle (primarily when flying in manual modes).
12-
13-
:::tip
14-
The [PX4 Vision Autonomy Development Kit](../complete_vehicles/px4_vision_kit.md) (Holybro) is a robust and inexpensive kit for developers working with computer vision on PX4. It comes with no pre-installed software, but does include an example implementation of obstacle avoidance to demonstrate the capabilities of the platform.
15-
:::
16-
17-
## Motion Capture
18-
19-
Motion Capture (MoCap) is a technique for estimating the 3D _pose_ (position and orientation) of a vehicle using a positioning mechanism that is _external_ to the vehicle. MoCap systems most commonly detect motion using infrared cameras, but other types of cameras, Lidar, or Ultra Wideband (UWB) may also be used.
20-
21-
:::note
22-
MoCap is commonly used to navigate a vehicle in situations where GPS is absent (e.g. indoors), and provides position relative to a _local_ coordinate system.
23-
:::
24-
25-
For information about MoCap see:
26-
27-
- [External Position Estimation](../ros/external_position_estimation.md)
28-
- [Flying with Motion Capture (VICON, Optitrack)](../tutorials/motion-capture.md)
29-
- [EKF > External Vision System](../advanced_config/tuning_the_ecl_ekf.md#external-vision-system)
30-
31-
## Visual Inertial Odometry (VIO)
32-
33-
Visual Inertial Odometry (VIO) is used for estimating the 3D _pose_ (position and orientation) and _velocity_ of a moving vehicle relative to a _local_ starting position. It is commonly used to navigate a vehicle in situations where GPS is absent (e.g. indoors) or unreliable (e.g. when flying under a bridge).
34-
35-
VIO uses [Visual Odometry](https://en.wikipedia.org/wiki/Visual_odometry) to estimate vehicle _pose_ from visual information, combined with inertial measurements from an IMU (to correct for errors associated with rapid vehicle movement resulting in poor image capture).
36-
37-
:::note
38-
One difference between VIO and [MoCap](#motion-capture) is that VIO cameras/IMU are vehicle-based, and additionally provide velocity information.
39-
:::
40-
41-
For information about configuring VIO on PX4 see:
42-
43-
- [EKF > External Vision System](../advanced_config/tuning_the_ecl_ekf.md#external-vision-system)
44-
- [T265 Setup guide](../peripherals/camera_t265_vio.md)
45-
46-
## Optical Flow
47-
48-
[Optical Flow](../sensor/optical_flow.md) provides 2D velocity estimation (using a downward facing camera and a downward facing distance sensor).
49-
50-
For information about optical flow see:
51-
52-
- [Optical Flow](../sensor/optical_flow.md)
53-
- [EKF > Optical Flow](../advanced_config/tuning_the_ecl_ekf.md#optical-flow)
54-
55-
## External Resources
56-
57-
- [XTDrone](https://github.com/robin-shaun/XTDrone/blob/master/README.en.md) - ROS + PX4 simulation environment for computer vision. The [XTDrone Manual](https://www.yuque.com/xtdrone/manual_en) has everything you need to get started!
1+
---
2+
canonicalUrl: https://docs.px4.io/main/de/advanced/computer_vision
3+
---
4+
5+
# Computer Vision (Optical Flow, MoCap, VIO, Avoidance)
6+
7+
[Computer vision](https://en.wikipedia.org/wiki/Computer_vision) techniques enable computers to use visual data to make sense of their environment.
8+
9+
PX4 uses computer vision systems (primarily running on [Companion Computers](../companion_computer/README.md)) in order to support the following features:
10+
11+
- [Optical Flow](#optical-flow) provides 2D velocity estimation (using a downward facing camera and a downward facing distance sensor).
12+
- [Motion Capture](#motion-capture) provides 3D pose estimation using a vision system that is _external_ to the vehicle. It is primarily used for indoor navigation.
13+
- [Visual Inertial Odometry](#visual-inertial-odometry-vio) provides 3D pose and velocity estimation using an onboard vision system and IMU. It is used for navigation when global position information is absent or unreliable.
14+
- [Obstacle Avoidance](../computer_vision/obstacle_avoidance.md) provides full navigation around obstacles when flying a planned path (currently missions are supported). This uses [PX4/PX4-Avoidance](https://github.com/PX4/PX4-Avoidance) running on a companion computer.
15+
- [Collision Prevention](../computer_vision/collision_prevention.md) is used to stop vehicles before they can crash into an obstacle (primarily when flying in manual modes).
16+
17+
:::tip
18+
The [PX4 Vision Autonomy Development Kit](../complete_vehicles/px4_vision_kit.md) (Holybro) is a robust and inexpensive kit for developers working with computer vision on PX4. It comes with no pre-installed software, but does include an example implementation of obstacle avoidance to demonstrate the capabilities of the platform.
19+
:::
20+
21+
## Motion Capture
22+
23+
Motion Capture (MoCap) is a technique for estimating the 3D _pose_ (position and orientation) of a vehicle using a positioning mechanism that is _external_ to the vehicle. MoCap systems most commonly detect motion using infrared cameras, but other types of cameras, Lidar, or Ultra Wideband (UWB) may also be used.
24+
25+
:::note
26+
MoCap is commonly used to navigate a vehicle in situations where GPS is absent (e.g. indoors), and provides position relative to a _local_ coordinate system.
27+
:::
28+
29+
For information about MoCap see:
30+
31+
- [External Position Estimation](../ros/external_position_estimation.md)
32+
- [Flying with Motion Capture (VICON, Optitrack)](../tutorials/motion-capture.md)
33+
- [EKF > External Vision System](../advanced_config/tuning_the_ecl_ekf.md#external-vision-system)
34+
35+
## Visual Inertial Odometry (VIO)
36+
37+
Visual Inertial Odometry (VIO) is used for estimating the 3D _pose_ (position and orientation) and _velocity_ of a moving vehicle relative to a _local_ starting position. It is commonly used to navigate a vehicle in situations where GPS is absent (e.g. indoors) or unreliable (e.g. when flying under a bridge).
38+
39+
VIO uses [Visual Odometry](https://en.wikipedia.org/wiki/Visual_odometry) to estimate vehicle _pose_ from visual information, combined with inertial measurements from an IMU (to correct for errors associated with rapid vehicle movement resulting in poor image capture).
40+
41+
:::note
42+
One difference between VIO and [MoCap](#motion-capture) is that VIO cameras/IMU are vehicle-based, and additionally provide velocity information.
43+
:::
44+
45+
For information about configuring VIO on PX4 see:
46+
47+
- [EKF > External Vision System](../advanced_config/tuning_the_ecl_ekf.md#external-vision-system)
48+
- [T265 Setup guide](../peripherals/camera_t265_vio.md)
49+
50+
## Optical Flow
51+
52+
[Optical Flow](../sensor/optical_flow.md) provides 2D velocity estimation (using a downward facing camera and a downward facing distance sensor).
53+
54+
For information about optical flow see:
55+
56+
- [Optical Flow](../sensor/optical_flow.md)
57+
- [EKF > Optical Flow](../advanced_config/tuning_the_ecl_ekf.md#optical-flow)
58+
59+
## External Resources
60+
61+
- [XTDrone](https://github.com/robin-shaun/XTDrone/blob/master/README.en.md) - ROS + PX4 simulation environment for computer vision. The [XTDrone Manual](https://www.yuque.com/xtdrone/manual_en) has everything you need to get started!

de/advanced/dev_env_unsupported.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,16 @@
1-
# Unsupported Developer Toolchains
2-
3-
This section contains topics about _unsupported_ development platforms and tools (i.e. tools for which the code dev team are unlikely to be able to provide much advice).
4-
5-
:::tip
6-
See [Toolchain Installation](../dev_setup/dev_env.md) for information about the environments and tools we do support!
7-
:::
8-
9-
:::warning
10-
The environments and tools in this section are rarely tested and may not work.
11-
You should not use these unless you are and expert with the environment and capable of debugging the environment yourself.
12-
:::
1+
---
2+
canonicalUrl: https://docs.px4.io/main/de/advanced/dev_env_unsupported
3+
---
4+
5+
# Unsupported Developer Toolchains
6+
7+
This section contains topics about _unsupported_ development platforms and tools (i.e. tools for which the code dev team are unlikely to be able to provide much advice).
8+
9+
:::tip
10+
See [Toolchain Installation](../dev_setup/dev_env.md) for information about the environments and tools we do support!
11+
:::
12+
13+
:::warning
14+
The environments and tools in this section are rarely tested and may not work.
15+
You should not use these unless you are and expert with the environment and capable of debugging the environment yourself.
16+
:::

0 commit comments

Comments
 (0)