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 line is detailed. The command line can be accessed by pressing the SPACE key. It allows users to quickly combine filters and use the filter library with ease.

The search grammar — the s command, its tokens, searching within the current results with ss — is described once, in the Search Filters section of the command list; the search panel itself is described in the manual. This annex keeps only the filter library and examples.

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. Start the search you want to keep (s command followed by filters).

2. Open the search panel (TAB or CTRL-F) and select the History tab.

3. Click the bookmark icon of the search to save.

4. Give the filter a name and confirm.

To use a filter saved in the library,

1. Open the search panel (TAB or CTRL-F) and select the Saved tab.

2. Search for the desired filter.

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

Examples

Here are some examples of using filters in the command line:

Position type	Checker structure	Command
Pure race		s nc
Short race		s nc P<70
Hitting on the ace point		s m"6/1*"
Backgame 1-4	points 24, 21 made	s p>35
Take/Pass decision at -2 -4	empty dice on upper player’s side, score -2/-4	s s d
Too good to double	empty dice on lower player’s side	s d e>1000
Blitz with at least 20% gammon	made points in home board, men on the bar	s g>20
Player 1 errors greater than 40 millipoints		s E>40
Positions whose comment contains Aachen2024		s t"Aachen2024"
One back checker to bring home		s k1,1
Escaping from the 20 point	point 20	s m"20/"
Prime versus prime	indicate the primes	s
Ace-point bear-off	opponent’s ace point made	s P<60
Double with at least 20 pip lead	empty dice on lower player’s side	s d p<-20
Positions from match 5		s ma5
Positions from matches 2 to 4		s ma2,4
Positions from matches 23 and 43		s ma23 ma43
Positions from tournament 1		s tn1
Errors in tournament 2		s tn2 E>40

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