7. Annex: Advanced Filter Usage

Warning

This section is for advanced users of blunderDB who wish to fully leverage the position search features.

Filters are at the heart of position analysis in blunderDB. Their use allows for searching specific positions with great precision. In this section, the use of filters through the COMMAND mode is detailed. The COMMAND mode can be accessed by pressing the SPACE key. It allows users to quickly combine filters and use the filter library with ease.

7.1. Command-line search for positions

To perform a search using filters,

  1. Switch to EDIT mode using the TAB key.

  2. Edit the current position.

  3. Switch to COMMAND mode using the SPACE key.

  4. Use the command s followed, optionally, by filters.

  5. Start the search with the ENTER key.

Warning

Don’t forget to clear the current position before starting a search (BACKSPACE key), if it isn’t the one you want, to avoid excessively filtering checker structures.

Note

The list of available filters in COMMAND mode is provided in Section 4.4.

7.2. Search in Current Results

It is possible to refine a search by searching among the currently filtered positions. This allows you to progressively narrow down the results.

In COMMAND mode, use the ss command followed by filters (e.g.: ss nc, ss E>40). The ss command works from NORMAL mode, after a prior search.

The search window (CTRL-F) also offers a “Search in current results” checkbox for the same functionality.

7.3. Filter Library

The filter library allows the user to save search commands to facilitate their thematic studies.

To add a filter to the library,

  1. Switch to EDIT mode.

  2. Open the filter library by pressing CTRL-B.

  3. Edit the current position.

  4. Give a name to the filter.

  5. Edit the search command.

  6. Save the search command using the “Add” button.

Tip

While editing the command, you can use the UP and DOWN arrow keys to navigate through the command history.

To use a filter saved in the library,

  1. Switch to NORMAL mode.

  2. Open the filter library by pressing CTRL-B.

  3. Search for the desired filter.

  4. Double-click on the filter to start the search.

7.4. Examples

Here are some examples of using filters in COMMAND mode:

Examples of searching within current results:

Scenario

Command

After s nc, search for short races

ss P<70

After s g>20, keep only errors

ss E>40

After s tn1, search for cube decisions

ss d