Alt+Shift+F — one of the JOSM windows
The filter window allows the user to temporarily disable certain types of objects based on one (or multiple) filters.
- not selectable using selection tools (with few minor exceptions in #4929, comment 14)
- not returned during Search action
- will disappear from several menus until filters are disabled (example: Help/Dialog/SelectionList#SmalltriangleinSelectbutton)
Simple usage is to enter single tag (or more complex expression similar to search) in "Text" column: objects complying with that text will be disabled.
More complex scenarios include filters as quick way to develop and test custom tagchecker rules (Extend JOSM?).
- De-clutter main view by (de-)activating features only when you need them. This allows for easier editing in areas with densely located objects or infrastructure.
- Completely hide features you don't use
- Avoid unnecessary or accidental edits
- Disable/separate objects that were fully tagged (using tag count and custom filters) from incomplete objects
- Disable recently modified objects (and it is irrelevant: if it modified by you or another person)
- Untagged objects
untaggedcan be used instead of Notes at osm.org. It is faster than to set/remove
fixme=resurvey- please don't overuse this principle
The filter lines are evaluated from top down, with respect to values in #Columns.
- E (Enable): Enable or disable this filter line.
- H (Hide elements from main view): normally, all matched objects are disabled, but you can completely hide them:
- disabled - visible and displayed as grey
- hidden - the chosen objects are completely hidden
- Text: The search term or property that defines the objects that are filtered. Every search query from Search action is supported:
- standard substring search (or exact search with "quotes")
- Regular expressions (standard Java)
- MapCSS syntax
- I (Inverse Filter): Normally, the specified objects are hidden and the rest is shown. If this option is activated, only the specified objects are shown and the rest is hidden.
- M (Filter Mode) - how a filter line is combined with filter lines above filter line in question:
- A (replace selection) - most users want this, filter lines with this mode are independent of each other
- R (replace selection) - effectively disable all filter lines above
- D (remove from selection) - un-filter all elements matched
- F (find in selection) - TODO
TODO explain 5 buttons.
|Filter text||Description or note|
|Doesn't handle relations perfectly|
|shop= + opening_hours= tagged objects|
|shop= + name= tagged objects|
|All nodes except shops. Geometry modification using mouse move disabled, but possible using other modes (ex. - Improve Way Accuracy mode (W))|
|Hide objects if you are the latest editor (useful during mass re-tagging and semi-mechanical edits)|
|Everything except highway= tagged objecets|
|De-clutters map, aggressive (sometimes you may want to keep buildings or amenity key)|
|Make it easier to select ways|
|Quickly see your changes|
|All nodes that's part of a highway|
|All natural and landuse areas formed by relations|
|Only roads for public transport. Good for mapping bus networks.|
See also Help/Action/Search#Examples other examples. If you have some clever filters, add them here.
If any filter is active, a transparent message box will appear in the top right corner of main view.
It is only visible if at least one object was disabled or hidden.