Skip to content

Commit

Permalink
The Betaflight blackbox explorer curves MinMax values control manual (b…
Browse files Browse the repository at this point in the history
…etaflight#421)

* added new doc files

* added links to manual page and images

* The text and images are updated

* the 'Close' menu item description is added to text

* Update BBE-MinMax-control-manual.md

Added short title/header

* Update BBE-MinMax-control-manual.md

Text edition

* the headers are edited

* added some bookmarks

* Update docs/wiki/guides/current/Black-Box-logging-and-usage.md

The links text edition

Co-authored-by: nerdCopter <56646290+nerdCopter@users.noreply.github.com>

---------

Co-authored-by: nerdCopter <56646290+nerdCopter@users.noreply.github.com>
  • Loading branch information
demvlad and nerdCopter committed May 13, 2024
1 parent 1871fbf commit 9558851
Show file tree
Hide file tree
Showing 15 changed files with 119 additions and 0 deletions.
115 changes: 115 additions & 0 deletions docs/wiki/guides/current/BBE-MinMax-control-manual.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
# Blackbox Explorer MinMax control

The MinMax control feature can control curves scale and placement quickly and full.
The current MinMax curves settings are showed at 'Configure graphs' dialog box in the "Minimum" and "Maximum" columns.
![image](./images/1.jpg)
The MinMax values can be changed:

- By direct input into table cells at 'Configure graphs' dialog box. It is possible to changes values manualy or set default values by double mouse click at values field.
- By using context menu

To show context menu you must do right mouse click on Minimum or Maximum values field what you want to edit.
The main context menu:
![image](./images/2.jpg)

## Main menu

The main menu include following parts:

1. The menu actions to edit all curves
2. The menu actions to edit <a href="#one">one curves</a> what you selected by right mouse click (The 'Gyro pitch' for example at the picture)
3. The <a href="#extended">extended</a> mode

## Actions

- 'Like this one' - apply MinMax of curve what you selected by right mouse click ('Gyro pitch' for example) to all curves.
- 'Full range' - set the all curves MinMax values from Log file data during the all flight time
- 'One scale' - set all curves to one scale
- 'Centered' - The curves are centered around X-axis
- 'Zoom in', 'Zoom out' - change zoom for all curves
- 'Default' - set the all curves MinMax values to default

## <a name="one">Single curve submenu</a>

The single curve submenu has same actions:

![image](./images/3.jpg)

## Contect menu

If you open context menu for one curves chart, then you see the short menu:

![image](./images/4.jpg)

## <a name="extended">Extended Mode</a>

The main menu has extended mode. You need press the 'Shift' key to activate it and select the submenu, what you need.

![image](./images/5.jpg)

### The 'Like this one' extended submenu.

You can change MinMax values and select curves what you need by using the checkboxes to apply these values.
Click 'SET MIN-MAX VALUES' item for apply.
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/6.jpg)

### The 'Full range' extended submenu.

You can select curves what you need by using the checkboxes to apply values.
Click 'At all global log time' menu item to set MinMax values from log data during all time.
Click 'At local window time' menu item to set MinMax values from current time interval at the chart window.
Click 'At markere time range' menu item to set MinMax values from markered time interval what you select by using "I", "O" keys. If it is not select then will apply all log time interval.
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/7.jpg)

### The 'One scale' extended submenu.

You can select curves what you need by using the checkboxes to set the same scale.
Click 'SET SET CURVES TO SAME SCALE' item for apply
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/8.jpg)

### The 'Centered' extended submenu.

You can select curves what you need by using the checkboxes to centered.
Click 'SET CURVES TO ZERO OFFSET' item for apply
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/9.jpg)

### The 'Zoom in', 'Zoom out' extended submenu.

You can set the zoom procent value and select curves what you need by using the checkboxes to apply zoom.
Click 'ZOOM IN', 'ZOOM OUT' items for apply zoom
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/10.jpg)

### The 'Default' extended submenu.

You can select curves what you need by using the checkboxes to apply default values.
Click 'SET CURVES TO DEFAULT' item for apply
Click 'Back' menu item to go back to main menu or click 'Close' menu item to close it.
Click 'Apply change' or 'Cancel' button on the main 'Configure graphs' dialog box to close the menu and dialog box immediately
![image](./images/11.jpg)

### The single curve submenu has one 'Full range' extended item:

It is like 'Full range' extended submenu, but for one selected curve only.
![image](./images/12.jpg)

## The examples of using curves MinMax control

1. If you know what curves MinMax values you need, then you can set it directly in MinMax input fields,
open main menu and apply 'Like this one' action to set it for the all curves.
Also, you can use extended 'Like this one' submenu to set different MinMax for selected curves.
2. You can use the 'Full range' main menu item or extended submenu to auto set MinMax for selected time range.
Then you can use 'Centered' and 'One scale' actions to auto format values.

At this picture the Gyro and Setpoint are set to one full range scale and the PID values are in the other own full range scale.
The all are centered.
![image](./images/13.jpg)
4 changes: 4 additions & 0 deletions docs/wiki/guides/current/Black-Box-logging-and-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,10 @@ Some features are automatically disabled depending upon the firmware you are run

Do click on all the buttons to learn what they do and '?' for the Keyboard Short cuts.

#### Betaflight blackbox explorer Version 3.7

[Blackbox Explorer MinMax control](/docs/wiki/guides/current/BBE-MinMax-control-manual)

### How to obtain data to evaluate noise frequency for setting the Notch filter.

Super simple visual explanation of the gyro data sequence through the filters:
Expand Down
Binary file added docs/wiki/guides/current/images/1.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/10.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/11.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/12.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/13.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/2.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/3.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/4.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/5.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/6.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/7.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/8.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/wiki/guides/current/images/9.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9558851

Please sign in to comment.