Search & Filtering¶
The search bar filters what's visible in the sidebar. Type a query and series and files that don't match your pattern are hidden.
Most of the time you can type a word to find series by name, but the search system also supports boolean logic, wildcards, value-based filtering, and file-level queries.
Searching for Series¶
Simple Text Search¶
Type any text to filter series by name. Matching is case-insensitive and works as a substring match.
| You type | What shows up |
|---|---|
voltage |
Any series with "voltage" in the name — Voltage_A, Bus_Voltage_1, etc. |
freq |
Frequency, Freq_Response, Low_Freq_Mode, etc. |
A file stays visible as long as at least one of its series matches.
Exact Matching with Quotes¶
Wrap a term in double quotes to match the full series name exactly (still case-insensitive).
| You type | Matches | Doesn't match |
|---|---|---|
"Frequency" |
Frequency |
Frequency_Response, Low_Freq |
"Active Power" |
Active Power |
Reactive Power, Active_Power_Output |
Wildcards¶
*matches any characters (including none)?matches exactly one character
| Pattern | Matches | Doesn't match |
|---|---|---|
Volt* |
Voltage, Volt_Drop, Volt |
Line_Voltage |
*Current* |
Line_Current, Current_A |
— |
V?ltage |
Voltage, Valtage |
Vllltage |
Combining with Boolean Operators¶
| Operator | Syntax | Example |
|---|---|---|
| AND | space or & |
voltage current or voltage & current |
| OR | | |
voltage | current |
| NOT | ! |
!reactive |
| Grouping | < > |
<voltage | current> & phase_a |
Precedence: NOT > AND > OR
So voltage | current & !reactive is evaluated as voltage | (current & (!reactive)).
Use angle brackets to override precedence: <voltage | current> & phase_a means "series matching voltage OR current, that also contain phase_a".
Examples¶
| Query | What it does |
|---|---|
voltage |
Series containing "voltage" |
voltage | frequency |
Series containing "voltage" or "frequency" |
power & !reactive |
Series with "power" but not "reactive" |
<voltage | current> & phase_a |
Voltage or current series, filtered to phase A |
Filtering by Data Values¶
You can filter series based on their actual data values using a : after the column name. This is useful for finding series that exceed a threshold or fall within a range. At present this is a little complicated, and not very performant so there will be a new filtering feature added in a future update.
Basic Value Filters¶
Syntax: column_name:operator value
| Operator | Meaning |
|---|---|
:> |
Greater than |
:>= |
Greater than or equal |
:< |
Less than |
:<= |
Less than or equal |
:= |
Equal to |
Examples:
| Query | Meaning |
|---|---|
Voltage:>1 |
Series where any Voltage value exceeds 1 |
Freq*:<=50 |
Series starting with "Freq" where any value is at or below 50 |
*Power:>100 |
Series ending with "Power" where any value exceeds 100 |
The column name supports the same matching as regular search — no wildcards means exact-then-substring matching, wildcards use glob matching.
Filtering at a Specific Time¶
Add @time to check the value at a particular point in time:
This checks if Voltage is greater than 1 at time 5. If the exact timestamp doesn't exist, the nearest available point is used.
Filtering Across a Time Range¶
Add @start-end to check values within a time window:
This checks if Frequency drops below 49.5 at any point between time 0 and 10. Both ends of the range are inclusive.
Column Names with Spaces¶
Use quotes around the column name when it contains spaces or special characters:
How Value Filters Affect Visibility¶
Value filters work at the file level — if any series in a file satisfies the condition, the entire file is shown. This is different from text search, which filters individual series.
Mixed Queries (Value + Text)¶
You can combine value filters with text search in the same query. When you do, the two parts serve different purposes:
- Value filter decides which files to show
- Text search decides which series within those files to show
For example:
This means: show files where any Voltage value exceeds 1, then within those files only show series containing "Active Power".
Another example:
Show files where any P_* series exceeds 100 between time 5 and 10, then within those files only show series containing "frequency".
Filtering by File Name¶
Use the file: prefix to filter at the file level instead of the series level:
This shows only files whose name matches case1*, and displays all series within those files. The matching supports wildcards and is case-insensitive, just like series search.
| Query | What it shows |
|---|---|
file:simulation |
Files with "simulation" in the name |
file:case1* |
Files starting with "case1" |
file:*.csv |
Files ending with ".csv" |
Quick Reference¶
| Syntax | What it does | Example |
|---|---|---|
term |
Substring match (case-insensitive) | voltage |
"term" |
Exact full-name match | "Active Power" |
*, ? |
Wildcards | Volt*, V?lt |
A B or A & B |
AND | voltage current |
A | B |
OR | voltage | frequency |
!A |
NOT | !reactive |
<A | B> & C |
Grouping | <voltage | current> & phase_a |
col:>val |
Value greater than | Voltage:>1 |
col:>=val |
Value greater or equal | Freq:>=50 |
col:<val |
Value less than | Power:<100 |
col:<=val |
Value less or equal | Current:<=5 |
col:=val |
Value equals | Freq:=60 |
col:>val@t |
Value at time point | Voltage:>1@5 |
col:<val@t1-t2 |
Value in time range | Freq:<49.5@0-10 |
"col name":>val |
Quoted column name | "Active Power":>100 |
file:pattern |
Filter by file name | file:case1* |
Notes¶
- Simple queries (no special characters) are faster than advanced ones — just type and results appear instantly
- Invalid queries silently fall back: unrecognised syntax won't error, but the series won't match
- Time ranges are inclusive on both ends, and use the nearest available timestamp if an exact match doesn't exist