Skip to content

Commit f714573

Browse files
committed
docs: fixed gross errors
1 parent 0739bee commit f714573

File tree

7 files changed

+40
-40
lines changed

7 files changed

+40
-40
lines changed

docs/en/animation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The key parameter that defines the logic of animation playback is the `start_act
2626
* `fly` - executing *the logic of immediate flight*
2727
* `takeoff` - execution of *the logic of flight to the first point*
2828

29-
f the copter takes off from the ground in the animation file, at the start of the animation, the instantaneous playback logic (fly)** will be applied: the copter with the motors turned off plays the color from the animation as long as it is stationary, turns the motors on before the moment of takeoff, then after `arming_time` starts to follow the points specified in the animation.
29+
If the copter takes off from the ground in the animation file, at the start of the animation, the instantaneous playback logic (fly)** will be applied: the copter with the motors turned off plays the color from the animation as long as it is stationary, turns the motors on before the moment of takeoff, then after `arming_time` starts to follow the points specified in the animation.
3030

3131
If in the animation file the copter starts to fly in the air, at the start of the animation will be applied **flight logic to the first point (takeoff)**: The copter with the motors turned off plays the color from the animation as long as it is stationary, turns the motors on before takeoff, then takes off in `takeoff_height` time, then moves to the first point in `reach_first_point_time` and then starts to follow the points specified in the animation.
3232

@@ -42,7 +42,7 @@ Create object animations in [Blender](https://www.blender.org) or use [examples]
4242
The copter can be represented by any three-dimensional object (e.g., a cube or a ball), and the LED strip color will be extracted from the object color property. Consider the following facts and recommendations when creating an animation:
4343

4444
* For easy conversion and uploading of animation to copters, objects corresponding to copters should have names corresponding to the names of these copters.
45-
* Blender distance units are converted into meters
45+
* Blender distance units are converted into meters.
4646
* The default delay between frames in [Copter settings](.../../drone/config/spec/configspec_client.ini) is 0.1 seconds (parameter `frame_delay` in ANIMATION section), pay attention when setting the frame rate in Blender animation.
4747
* Make sure that the speed of the copters is not too high ( maximum of 3 m/s for the room, maximum of 5 m/s for the street): the addon will give a warning but will still convert the animation.
4848

@@ -70,4 +70,4 @@ optional arguments:
7070
--config Set this option to print config info.
7171
```
7272

73-
This utility displays full information about the client's animation and configuration settings (optional), as well as both possible playback options for the animation, which allows to analyze the actions of the copters before a real flight.
73+
This utility displays full information about the client's animation and configuration settings (optional), as well as both possible playback options for the animation, which allows to analyze the actions of the copters before a real flight.

docs/en/blender-addon.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The Addon for Blender is designed to convert Blender's copters flight animations into flight paths for each copter of the animation, including the color of objects at any given time.
44

5-
## Installation and configuration
5+
## Installation and configuration
66

77
* Download and install the latest version of Blender 2.83 from [the official website](https://www.blender.org/download/).
88
* Open Blender, select `Edit > Preferences` from the top menu. In the opened settings window, select `Add-ons` in the side panel. Click the button `Install...` in the upper right corner of the window. In the dialog box, open the path to the addon folder [clever-show/blender-addon](.../../blender-addon/) and select the file `addon.py`. Click `Install Add-on from file...`. Addon is now installed.
@@ -28,4 +28,4 @@ For more information, click the arrow icon to the left of the activation field.
2828

2929
* `Documentation` - leads to the addon's documentation page
3030
* `Report a bug` - leads to the issues page of the clever-show repository
31-
* `Remove` - removes the addon (before installing a new version it is recommended to remove the old one)
31+
* `Remove` - removes the addon (before installing a new version it is recommended to remove the old one)

docs/en/client.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ This section configures the animation processing. A separate module [animation](
110110

111111
An animation frame is a set of data necessary to position the copter and determine its led strip color. In the current version of the software the animation frame is represented by a sequence of numbers `x y zaw r g b` in the line `.csv` of the animation file, where:
112112

113-
* `x', `y', `z' - copter coordinates in the current frame, in meters
113+
* `x',`y', `z' - copter coordinates in the current frame, in meters
114114
* `yaw` - the copter's yaw in radians
115115
* `r`, `g`, `b` - components of the color of the copter led strip, integers from 0 to 255
116116

@@ -137,7 +137,7 @@ If the copter takes off from the ground in the animation file, at the start of t
137137

138138
* `frame_delay` - playback time of one frame in seconds
139139

140-
* `yaw` - copter rotation during flight to points, in degrees. If `nan', the copter preserves its original orientation in flight. If `animation` - the copter rotates by yaw from the animation file.
140+
* `yaw` - copter rotation during flight to points, in degrees. If `nan`, the copter preserves its original orientation in flight. If `animation` - the copter rotates by yaw from the animation file.
141141

142142
* `ratio` - scale of animation (ratio_x, ratio_y, ratio_z) along the axis (x, y, z)
143143

@@ -161,7 +161,7 @@ This section configures the program of emergency protection of the copter from a
161161

162162
* `enabled` - boolean value, determines whether to use emergency protection in case of loss of visual position or collision with an object.
163163
* `log_state` - boolean value, determines whether the copter state will be logged in the service log: `armed: {} | mode: {} | vis_dt: {:.2f} | pos_delta: {:.2f} | pos_dt: {:.2f} | range: {:.2f} | watchdog_action: {}`.
164-
* `action` - action upon emergency protection triggering. Available options: `land` - landing of the copter in the flight controllers mode AUTO.LAND, `emergency_land` - landing of the copter with the gradual reduction of the motor power, `disarm` - switching off the motors. ** Attention!** It is not recommended to use the AUTO.LAND mode with the barometer turned off - when the altitude source in flight is lost, e.g. laser reading or visual position, the AUTO.LAND mode does not guarantee the landing of the copter, because it is oriented to the altitude reading. It is recommended to use the `emergency_land` mode to land the copter when positioning it using a visual position or laser and the possibility of losing data from these systems.
164+
* `action` - action upon emergency protection triggering. Available options: `land` - landing of the copter in the flight controllers mode AUTO.LAND, `emergency_land` - landing of the copter with the gradual reduction of the motor power, `disarm` - switching off the motors. **Warning!** It is not recommended to use the AUTO.LAND mode with the barometer turned off - when the altitude source in flight is lost, e.g. laser reading or visual position, the AUTO.LAND mode does not guarantee the landing of the copter, because it is oriented to the altitude reading. It is recommended to use the `emergency_land` mode to land the copter when positioning it using a visual position or laser and the possibility of losing data from these systems.
165165
* `vision_pose_delay_after_arm` - time after takeoff of the copter in seconds, required to get the visual position. During this time after takeoff, the visual position loss protection will not work. This parameter is useful when using the emergency protection module in conjunction with the positioning system with aruco markers located on the floor: at takeoff copter has no visual position for some time.
166166
* `vision_pose_timeout` - time in seconds after losing the visual position, after which the emergency protection is triggered.
167167
* `position_delta_max` - the maximum distance between the current position and the point where the copter should now be in meters. Required to check for collision of the copter with objects. If the distance between the current position of the copter and the point where the copter should be now is greater than this number (in meters), an emergency protection is triggered.
@@ -183,8 +183,8 @@ System settings for client's service commands
183183

184184
#### NTP section
185185

186-
In addition to time synchronization (with millisecond precision) using the chrony package, there is an alternative - the ability to use external (in case the local network has a connection to the Internet) or intranet NTP-servers. ** Attention!** For correct system operation, both the server and the clients** must use a single method of time synchronization (a set of parameters in this section). This section is fully unified for both server and clients.
186+
In addition to time synchronization (with millisecond precision) using the chrony package, there is an alternative - the ability to use external (in the presence of a local network connection to the Internet) or intranet NTP-servers. **Warning!** For proper system operation, both **the server and the clients** must use a single method of time synchronization (set of parameters in this section). This section is fully unified for both server and clients.
187187

188-
* `use_ntp` - determines whether time synchronization using NTP will be used. (if `False', the local OS time will be used (synchronized automatically when using chrony). * It is recommended to use chrony instead of NTP*.
188+
* `use` - determines whether time synchronization using NTP will be used. (if `False', the local OS time will be used (synchronized automatically when using chrony). *It is recommended to use chrony instead of NTP*.
189189
* `host` - host name or IP address of the NTP server (local or remote)
190-
* `port` - port used by the NTP server
190+
* `port` - port used by the NTP server

docs/en/image-building.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ sudo apt install docker.io
1212

1313
## Local build with modified Clover settings
1414

15-
* Place the Clover configuration folders (`launch`, `map` and `camera_info`) in the`builder/clever-config` [folder](../../builder/clever-config) in the clever-show source directory.
15+
* Place the Clover configuration folders (`launch`, `map` and `camera_info`) in the`builder/clever-config` [folder](../../builder/clever-config) in the clever-show source directory.
1616
* All files from the `launch` folder will be copied to the `/home/pi/catkin_ws/src/clever/clever/launch' directory in the built image.
1717
* All files from the `map` folder will be copied to the `/home/pi/catkin_ws/src/clever/aruco_pose/map` directory in the built image.
1818
* All files from the `camera_info` folder will be copied to the `/home/pi/catkin_ws/src/clever/clever/camera_info` directory in the built image.

docs/en/positioning.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ The `clover` software officially supports the following [positioning systems](ht
44

55
* [optical flow](https://clover.coex.tech/en/optical_flow.html)
66
* [aruco](https://clover.coex.tech/en/aruco.html)
7-
* [gps](https://clover.coex.tech/en/gps.html)
7+
* [gps](https://clover.coex.tech/en/gps.html)
88

99
The `clever-show` software supports all positioning systems supporte by`clover`.
1010

@@ -28,13 +28,13 @@ If the takeoff was successful, reproduce the client configuration, positioning s
2828
* The copter configuration file (`.ini`) can be saved by right-clicking on the row with the configured copter, selecting `Edit config` from the drop-down menu and then clicking the button `Save as`. You can also drag a cell from the `configuration` column to the file manager of your system - the server will automatically copy the configuration file to the open directory of the file manager.
2929
* The server configuration file (`.ini`) can be saved by selecting `Server -> Edit server config` from the top menu and then clicking the button `Save as`.
3030
* The flight controller configuration file can be saved by connecting to the flight controller through [QGroundControl](http://qgroundcontrol.com) application. It is possible to connect directly to the flight controller [via USB port](https://clover.coex.tech/en/connection.html) or [via TCP or UDP bridge](https://clover.coex.tech/en/gcs_bridge.html) (the TCP bridge is configured in the `clever-show` image by default, in the `Host Address` field you can enter the name of the copter instead of the ip address with the addition of .local at the end, e.g. clover-1.local). After connection you should go to [section](https://docs.px4.io/master/en/advanced_config/parameters.html#tools) `Parameters -> Tools -> Save to file...` and choose the path to save the parameter file.
31-
* * The camera calibration file is useful for refinement of visual positioning. The name of the calibration file should consist of the id of the copter, for which the calibration was made, with the addition of the extension `.yaml', e.g. `clover-1.yaml'. To get the calibration files, use the [manual](https://clover.coex.tech/ru/camera_calibration.html).
31+
* The camera calibration file is useful for refinement of visual positioning. The name of the calibration file should consist of the id of the copter, for which the calibration was made, with the addition of the extension `.yaml', e.g.`clover-1.yaml'. To get the calibration files, use the [manual](https://clover.coex.tech/ru/camera_calibration.html).
3232

3333
After loading the necessary files from the configured copter, copy these files to the other copters: select the necessary copters in the table and use the commands `Send -> Configuration`, `Send -> Launch files folder`, `Send -> FCU parameters file`, `Send -> Camera calibrations` from the `Selected drones` section of the [server](server.md#Selected-drones) application .
3434

3535
## Settings of clever-show server and client
3636

37-
The `clever-show' software suite includes many status checks of the copters to minimize the number of failed launches as well as a set of parameters to configure the positioning systems. All settings are stored in client and server application configuration files. Each positioning system has its own features that need to be taken into account when configuring the server-client interaction. Below are the settings that you need to pay attention to when configuring the client and server:
37+
The `clever-show` software suite includes many status checks of the copters to minimize the number of failed launches as well as a set of parameters to configure the positioning systems. All settings are stored in client and server application configuration files. Each positioning system has its own features that need to be taken into account when configuring the server-client interaction. Below are the settings that you need to pay attention to when configuring the client and server:
3838

3939
* Server:
4040
* [CHECKS](server.md#checks) section - server side copter telemetry checks
@@ -99,7 +99,7 @@ Server configuration with values applicable to work with `optical flow`: [server
9999

100100
To set the parameters manually, use the command `Server -> Edit config` from the top menu of the server.
101101

102-
#### Option 2. Reset all server configuration settings
102+
#### Option 2. Reset all server configuration options
103103

104104
In order to configure the server configuration for positioning by optical flow, you can reset the configuration data to default values. To do this, delete the generated configuration file on the server:
105105

0 commit comments

Comments
 (0)