Search Function Overview¶
The search function provides advanced filtering for both files and time-series data.
It supports Boolean logic, wildcards, and time-based filtering.
Search Behavior¶
- File-Level Filtering → e.g.
Voltage:>1
shows/hides entire files if any series matches. - Series-Level Filtering → e.g.
Frequency
shows only matching series. - Mixed Queries → e.g.
Voltage:>1 & Active Power
→ select files where Voltage > 1, then show Active Power series.
Query Syntax¶
Text Search¶
Frequency
→ match series containing "Frequency""Exact Match"
→ exact phrase (case-sensitive)file:pattern
→ match files by name (supports wildcards)
Boolean Operators¶
Voltage | Current
→ ORVoltage & Current
(or space) → AND!Reactive
→ NOT<...>
→ Grouping
Precedence: NOT
> AND
> OR
Wildcards¶
*
→ any chars (Volt*
→ "Voltage", "VoltDrop")?
→ one char (Curr?nt
→ "Current")
Time-Series Filtering¶
Column Matching¶
Voltage:>1
→ exact/substring matchVolt*:>1
→ starts with*Power:>100
→ ends with
Operators¶
:>
,:>=
,:<
,:<=
,:=
Time Ranges¶
Voltage:>1@5
→ at time 5Frequency:<49.5@0-10
→ between time 0–10
Quoted Names¶
"Active Power":>100
'Reactive Power':<=50
Examples¶
Frequency
→ match "Frequency"Voltage | Frequency
→ Voltage OR FrequencyPower & !Reactive
→ Power but not ReactiveVoltage:>1 & Active Power
→ Voltage > 1, then show Active PowerP_*:>100@5-10
→ P_* > 100 between times 5–10
Quick Reference Cheatsheet¶
Syntax | Meaning | Example |
---|---|---|
file:pattern |
Match files by name (wildcards ok) | file:case1* |
Term |
Match series containing term | Frequency |
"Exact Match" |
Case-sensitive exact phrase | "Active Power" |
A & B |
AND | Voltage & Current |
A | B |
OR | Voltage | Frequency |
!A |
NOT | !Reactive |
<A | B> & C |
Grouping with precedence | <Voltage | Frequency> & Power |
Col:>1 |
Greater than | Voltage:>1 |
Col:<=100 |
Less than or equal | "Active Power":<=100 |
Col:=50 |
Equal | Freq:=50 |
Col:>1@t |
At specific time | Voltage:>1@5 |
Col:<10@t1-t2 |
Across time range | Frequency:<49.5@0-10 |
* , ? |
Wildcards | Volt* , Curr?nt |
Notes¶
- Wildcards are case-sensitive
- Time ranges are inclusive, nearest timestamp used if exact not found
- Invalid queries fall back to text search