Changes between Version 7 and Version 32 of Help/Dialog/Validator


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/Validator

    v7 v32  
    11[[TranslatedPages]]
     2[[PageOutline(2-10,Table of Contents)]]
    23
    3 = Validator Dialog =
     4= Validator window =
    45
    5 [[Image(source:trunk/images/dialogs/validator.png)]] ''Keyboard shortcut:'' **{{{Alt+Shift+V}}}**
     6[[Image(source:trunk/images/dialogs/validator.png)]] ''Keyboard shortcut:'' **{{{Alt+Shift+V}}}** — one of the [Help/ToggleDialogs#Toactivateawindow JOSM windows]
    67
    78The **JOSM Validator** is a feature of JOSM which checks and fixes invalid data.
     
    910== Usage ==
    1011
    11 * Click on the new tick icon [[Image(source:/trunk/images/dialogs/validator.png)]] (''open the validation window'') in the vertical toolbar to show the validator panel on the right (or use the keyboard shortcut: {{{Alt+Shift+V}}}).
    1212* Select the data you want to validate (or deselect to validate everything)
    13 * Click on the ''Validate'' button [[Image(source:/trunk/images/dialogs/validator.png,15)]] at the bottom of the validator panel or press {{{Shift+V}}} to run the validation process
     13* Click on the ''Validate'' button [[Image(source:/trunk/images/dialogs/validator.png,15)]] at the bottom of the validator panel or press {{{Shift+V}}} to run the validation process:
     14 * if there are no [wiki:/Help/Dialog/SelectionList currently selected objects], then it it checks all objects in [wiki:/Help/Dialog/LayerList#LayerButtons the current layer]
     15 * if there are [wiki:/Help/Dialog/SelectionList selected objects], then it checks only selected objects
    1416* While some of the errors must be manually fixed, most of them can be automatically fixed. Just select the error or errors and click the ''Fix'' button [[Image(source:/trunk/images/dialogs/fix.png,15)]] to automatically fix them. You can select multiple errors, and all of them will be fixed.
     17* Use right click menu to "Zoom to problem"
     18* Multiple objects with the same symptom are [wiki:Help/Validator/MapCSSTagChecker#Grouping grouped together]
    1519
    16 The validator is an automatic test tool. It can show you errors in the data, but it may also tell you errors, which aren't real.
     20The validator is an automatic test tool. It can show you possible errors in the data, but it may also tell you errors, which aren't real.
    1721
    18 **Don't fix errors when you aren't sure something is really wrong.**
     22[[Image(validator_using.gif)]]
     23
     24=== Don't fix errors when you aren't sure something is really wrong ===
    1925
    2026Validator will check the data and display all errors, categorized as ''errors'' [[Image(source:/trunk/images/data/error.png,15)]], ''warnings'' [[Image(source:/trunk/images/data/warning.png,15)]], and ''other'' [[Image(source:/trunk/images/data/other.png,15)]], depending on the severity of the error.
    2127By default only warnings of level error and warning will be displayed. Warnings of level ''other'' produce a lot more validation errors for valid data and thus need more care from the user.
    2228
    23 [[Image(validator.png)]]
     29[[Image(validator2.png)]]
    2430
    25 This dialog allows to start a verification process of the data.
     31This window allows to start a verification process of the data.
    2632
    27 You have 4 buttons in this:
    28 * [[Image(source:/trunk/images/dialogs/select.png)]] Select - Select the objects of the selected error.
    29 * [[Image(source:/trunk/images/dialogs/validator.png)]] Validation - Start validation process for current selection or all objects (when nothing selected).
    30 * [[Image(source:/trunk/images/dialogs/fix.png)]] Fix - Fix an error (only when automatically fixable).
    31 * [[Image(source:/trunk/images/dialogs/delete.png)]] Ignore - Ignore an error or a group of errors in future tests.
     33You have five buttons in this:
     34* [[Image(source:/trunk/images/dialogs/select.png)]] Select – Select the objects of the selected error.
     35* [[Image(source:/trunk/images/dialogs/search.png)]] Lookup – Looks up the selected primitives in the error list
     36* [[Image(source:/trunk/images/dialogs/validator.png)]] Validation – Start validation process for current selection or all objects (when nothing selected).
     37* [[Image(source:/trunk/images/dialogs/fix.png)]] Fix – Fix an error (only when automatically fixable).
     38* [[Image(source:/trunk/images/dialogs/delete.png)]] Ignore – Ignore an error or a group of errors in future tests.
    3239
    3340When a validation process has been finished all results will appear in the list. Also a new validation layer is added, which shows you where problem cases lie in the map.
     
    3643
    3744When 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 opens, if not already open, and the validation results
    38 are copied in the validation dialog, so they can be checked and fixed.
     45are copied in the validation window, so they can be checked and fixed.
    3946
    4047== Validation layer ==
     
    4249If not disabled through preferences a validator run will open a validator layer.
    4350
    44 = See also =
     51== Validation result can depend on the downloaded area ==
     52
     53Some 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 [wiki:Help/Action/NewLayer new empty layer] or when you download single objects via [Action/Download#DownloadfromOverpassAPI 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.
     54
     55Some validator rules are limited to defined areas (e.g. countries), see [wiki:Help/Styles/MapCSSImplementation#Territoryselector Territoryselectors].
     56
     57== Advanced Preferences ==
     58
     59There are some advanced settings which can be changed in the [[Help/Preferences/Advanced|advanced preference]]:
     60
     61* `osm-primitives.showid`: set to `true`/`false` to display/hide the osm id of the object in the list
     62* `osm-primitives.showcoor`: set to `true`/`false` to display/hide the coordinates of the object in the list
     63
     64== See also ==
     65* [wiki:Rules external Validator rules]
    4566* [wiki:/Help/Preferences/Validator Validator preferences] and description of validator tests
    46 * [wiki:/Help/HowTo/ValidatorExamples Some examples] howto use validator
     67* [wiki:/Help/Validator/MapCSSTagChecker MapCSSTagChecker] - about the syntax of validator checks, which are based on MapCSS
     68* The plugin [https://wiki.openstreetmap.org/wiki/JOSM/Plugins/PT_Assistant PT Assistant], which adds validator rules
    4769
    4870----
    49 Back to [wiki:/Help/ToggleDialogs Toggle Dialogs][[BR]]
     71Back to [wiki:/Help/ToggleDialogs Windows][[BR]]
    5072Back to [wiki:/Help Main Help]