wiki:Help/Dialog/Validator

The gif animation should get an update which should include the usage of the lookup button.

Validator panel

source:trunk/resources/images/dialogs/validator.png Keyboard shortcut: Alt+Shift+V — one of the JOSM panels

The JOSM Validator is a feature of JOSM which checks and fixes invalid data.

Usage

  • Click on the source:trunk/resources/images/dialogs/validator.png Validation button at the bottom of the validator panel or press Shift+V to run the validation process:
  • Most of the errors must be manually fixed, while some of them can be automatically fixed by selecting the error or errors and clicking the source:trunk/resources/images/dialogs/fix.png Fix button.
  • Use the right click menu to "Zoom to problem".
  • Multiple objects with the same symptom are grouped together.

The validator is an automatic test tool. It can show you errors in the data, but it is not perfect and may also tell you errors, which indeed aren't errors ("false positives"). Thus every by the validator marked object should be checked by the user before changing it.

https://github.com/mapbox/mapping/wiki/Reviewing-your-edits#usage https://github.com/mapbox/mapping/issues/162

The validator will check the data and display all errors, categorized as source:trunk/resources/images/data/error.svg errors, source:trunk/resources/images/data/warning.svg warnings, and source:trunk/resources/images/data/other.svg other, depending on the severity of the error as a list. Additionally a new validation layer is added, which shows you where the problem cases are located in the mapview (can be disabled in the preferences). By default only errors of level error and warning will be displayed. Warnings of level other can be enabled in the preferences but produce more false positives and thus need more care from the user.

There are six buttons in the validator panel:

  • source:trunk/resources/images/dialogs/select.png Select – Select the objects of the selected error.
  • source:trunk/resources/images/dialogs/search.png Lookup – Looks up the selected objects in the error list
  • source:trunk/resources/images/dialogs/validator.png Validation – Start validation process for current selection or all objects (when nothing selected).
  • source:trunk/resources/images/dialogs/fix.png Fix – Fix an error (only when automatically fixable).
  • source:trunk/resources/images/dialogs/fix.png Ignore – Ignore an error or a group of errors in future tests.
  • source:trunk/resources/images/dialogs/fix.png Manage Ignore – Shows a dialog to change the list of previously ignored errors.

Ignore List Management

This dialog allows to remove items from the ignore list. You can use the delete key or the right mouse button to remove items. If you see only numbers and no descriptive texts the list was migrated from older JOSM versions. In this case it is recommended to remove all items and ignore them again to get the descriptive texts shown above.

Note: in the context menu of an error in the list there is the entry source:trunk/resources/images/dialogs/delete.svg Ignore for now. This just removes the entry from the list but does not add it to the ignore list. Therefore it will appear again on the next validation run.

Validation on upload

If not disabled the validation process is also started on each upload to the server. For uploads only the modified elements are tested. If you abort the upload, the validator panel displays the result of the validation.

Validation result can depend on the downloaded area

Some validator tests include a check whether the tested object is in or out of the downloaded area to avoid false positives. The not downloaded area is displayed with a yellow hatching. Downloaded ways can end in the not downloaded area. If e.g. a waterway ends in the downloaded area then the validator warns that it should be connected to another waterway. If the waterway ends out of the downloaded area then the validator will not warn because it doesn't know if there is really an error because the possible connected waterway was not downloaded. The validator will also not warn if there was never an area download in this data layer (there is no yellow hatching in this layer). Such a layer exists when you e.g. create a new empty layer or when you download single objects via Overpass. In both cases the data is assumed as incomplete and handled like out of the downloaded area to avoid false positives and a lot unnecessary warnings.

Some validator rules are limited to defined areas (e.g. countries), see Territoryselectors.

Advanced Preferences

There are some advanced settings which can be changed in the advanced preferences:

  • osm-primitives.showid: set to true/false to display/hide the osm id of the object in the list
  • osm-primitives.showcoor: set to true/false to display/hide the coordinates of the object in the list

See also


Back to Windows menu
Back to Sidebar
Back to Main Help

Last modified 3 months ago Last modified on 2020-03-23T16:40:45+01:00

Attachments (4)

Download all attachments as: .zip