All docs
Table·
method
Table.filter
keeps the rows where a boolean mask column is true
Python
filter(mask: Column) -> Table
Returns Table — a new immutable Table with only the matching rows
Parameters#
| name | type | default | description |
|---|---|---|---|
mask |
Column |
— | a boolean Column expression, e.g. t["score"] > 10 |
Example#
Python
t.filter(t["score"] > 10) # → only the high scorers
Combine conditions with & (and), | (or), ~ (not):
Python
t.filter((t["score"] > 10) & t["name"].is_valid())
Notes#
mask must be a boolean Column built from the same table — comparisons (> >= < <= == !=),
& / | / ~, and is_valid() / is_null() all produce one. Every call returns a new
Table; the original is untouched.
See also#
Guides: Tables & data flow
By LSD Team · Last updated Jul 17, 2026
Ask on Discord
View as Markdown