In Squey, Filter is a generic term that refers to a computation or a filtering process. It applies to a part or to all the data being investigated and might produce a change on the two following items:
About visible Layers
One should always keep in mind that the Events that might get a change in their color property are not necessarily all the Events that appear visible on screen, but only the Events that are, at the same time, visible and in the active Layer.
Conclusion: to put things in simple terms:
Presets of Filters
Regular users of Squey often need to save and reuse specific settings of some Filters they need to apply frequently on a well known category of data or Events. To satisfy that need, Presets of Filterss of Filters are available on all Filters of Squey.
The two following icons make it possible to save or load Presets of Filterss:
: use this icon when you want to load an existing Presets of Filters.
Through the list of Presets of Filterss, it is possible to rename or remove (i.e. delete) an existing Presets of Filters. A right-click on such an existing Presets of Filters offers the following possibilities:
Load: use this if you want to load the settings held by that Presets of Filters.
Save: use this menu entry only if you want to overwrite the settings of this existing Presets of Filters.
Rename: self explanatory.
Remove: use this menu entry to delete the targeted existing Presets of Filters.
Axis Gradient Filter
The aim of this Filter is to colorize Events according to the value they carry on one of their dimension. The idea is very simple: suppose the third Axis carries the hour of the Event, from 00:00:00 (at the very bottom of the Axis) to 23:59:59 (at the very top of the Axis). If the third Axis is used to apply an Axis Gradient Filter, then a green-to-red color gradient will be used to map the hour to a particular color:
Events get a green color if they happen early during the day.
Events get a yellow color if they happen around noon.
Events get a red color if they happen by the end of the day.
Let’s have a look at a real example! We start by a selection of Events that have no color indication:
This Axis Gradient Filter is usefull if you want to correlate positions (i.e. values) of Events on a specific Axis (the third one in our example) with one Axis or possibly many other Axis. Without beeing very accurate, the color information given to the Events by the color gradient is a very easy way to get an intuitive feeling of possible links between the selected Axis and the other Axes.
This filter’s dialog gives access to one parameter: the considered axis which is controlled using a combo-box.
There are two ways to access this filter.
By using the ‘Axis gradient…’ menu entry:
By right-clicking on a column in the listing view:
Frequency Gradient Filter
This filter’s dialog gives access to three parameters.
The first parameter enables to choose the considered axis. It is controlled using a combo-box.
The second one enables to choose between a linear or a logarithmic scale to map the frequences to the resulting color. It is controlled using a combo-box.
The last parameter enables to graphically define the frequency range for which the gradient will be applied to. The lower and upper bounds handles can be dragged as usual sliders. The bounds can be set more precisely using the two spinboxes. To set the range fastly (but with less precision), the lower bound can be changed by left-clicking in the color-ramp and the upper bound can be changed by right-clicking in the color-ramp.
There are one way to access this filter.
By using the ‘Frequency gradient…’ menu entry:
Multiple Values Search Filter
The Multiple Values Search Filter is a text based selection Filter. It does not change the color of Events. Its purpose is to select, from the current Selection of Events, all the Events that carry a value, on a given Axis, that belongs to a list of patterns provided by the user.
The Multiple Values Search Filter looks like this:
To use this Filter, there are some parameters and options available to the user. We now present them shortly.
This parameter controls either the match must consider case or not.
This parameter controls either the match considers the whole field must or not.
This parameter controls either the expression is a constant string to match or a regular expression.
Regular expressions are way slower than plain text because of the inherent cost of regular expressions, but also because fields internal representations can no longer be used for doing the comparisons.
This parameter controls the expression to use for the search. If the expression contains more than one line, the result of the search will be the union of the result of the search using each line.
This parameter controls either the expression is used to accept events or is used to ignore them.
This parameter enables to choose the considered axis.
There are two ways to access this filter.
By using the ‘Multiple values…’ menu entry:
By right-clicking on a cell in the listing view:
There are two ways to use this filter.
To run immediatly the search using a value present in the listing, right-click on the wanted value’s cell to open the context menu and select the ‘search for this value’ action:
To open the search dialog using a value present in the listing, right-click on the wanted value’s cell to open the context menu and select the ‘search using this value…’ action: