Changes between Version 30 and Version 51 of Help/Dialog/Validator


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Dialog/Validator

    v30 v51  
    1 [[TranslatedPages]]
     1[[TranslatedPages(outdated=The gif animation should get an update which should include the usage of the lookup button.)]]
    22[[PageOutline(2-10,Table of Contents)]]
    33
    4 = Validator window =
     4= Validator panel =
    55
    6 [[Image(source:trunk/images/dialogs/validator.png)]] ''Keyboard shortcut:'' **{{{Alt+Shift+V}}}** — one of the [Help/ToggleDialogs#Toactivateawindow JOSM windows]
     6[[JOSMImage(dialogs/validator,48,link=,middle,margin-right=20)]] ''Keyboard shortcut:'' **`Alt+Shift+V`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]
    77
    88The **JOSM Validator** is a feature of JOSM which checks and fixes invalid data.
    99
     10
    1011== Usage ==
     12* Click on the [[JOSMImage(dialogs/validator)]] ''Validation'' button at the bottom of the validator panel or press `Shift+V` to run the validation process:
     13 * If there are currently no [wikitr:/Help/Dialog/SelectionList selected objects], then it checks all objects in [wikitr:/Help/Dialog/LayerList#LayerButtons the current layer].
     14 * If there are selected objects, then it checks only selected objects.
     15* 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 [[JOSMImage(dialogs/fix)]] ''Fix'' button. As Validator might not be always perfect, it is still the user's duty to check the result of the action.
     16 * The two tables, [wikitr:/Help/Preferences/Validator#TestsTable Tests] and [wikitr:/Help/Preferences/Validator#MapCssBasedTests MapCSS Tests] offer little more explanation about each the test.
     17* Use the right click menu to "Zoom to problem".
     18* Multiple objects with the same symptom are [wikitr:/Help/Validator/MapCSSTagChecker#Grouping grouped together].
    1119
    12 * 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:
    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
    16 * 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]
     20The 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.
    1921
    20 The 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.
     22[[Image(validator_using.gif,link=)]]
    2123
    22 [[Image(validator_using.gif)]]
     24The validator will check the data and display all errors, categorized as [[JOSMImage(data/error)]] ''errors'', [[JOSMImage(data/warning)]] ''warnings'', and [[JOSMImage(data/other)]] ''other'', depending on the severity of the error as a list. Additionally a new [wikitr:/Help/Dialog/LayerList 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.
    2325
    24 === Don't fix errors when you aren't sure something is really wrong ===
     26[[Image(validator2.png,link=)]]
    2527
    26 Validator 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.
    27 By 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.
     28There are six buttons in the validator panel:
     29||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =||
     30||  [[JOSMImage(dialogs/select)]]  || Select || || Select the objects of the selected error. ||
     31||  [[JOSMImage(dialogs/search)]]  || Lookup || || Looks up the selected objects in the error list. ||
     32||  [[JOSMImage(dialogs/validator)]]  || Validation ||  `shift+V`  || Start validation process for current selection or all objects (when nothing selected). ||
     33||  [[JOSMImage(dialogs/fix)]]  || Fix || || Fix an error (only when automatically fixable). ||
     34||  [[JOSMImage(dialogs/fix)]]  || Ignore || || Ignore an error or a group of errors in future tests. Does not work with new objects (`id:0`). ||
     35||  [[JOSMImage(dialogs/fix)]]  || Manage Ignore || || Shows a dialog to change the list of previously ignored errors. ||
    2836
    29 [[Image(validator2.png)]]
     37=== Context Menu ===
     38A right click on listed objects offers following menu:
     39||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =||
     40||  [[JOSMImage(dialogs/autoscale/problem)]]  || [wikitr:/Help/Action/ZoomToProblem Zoom to problem] ||  `6`  || Zoom the view to the problem. ||
     41||  [[JOSMImage(dialogs/edit)]]  || Edit ||  || Opens a [wikitr:/Help/Dialog/RelationEditor relation editor] for each [[JOSMImage(data/relation)]] [wikitr:/Help/Concepts/Object#Relations relation]. ||
     42||  [[JOSMImage(dialogs/delete,28,link=,middle)]]  || Ignore for now ||  || Delete the specific entry from the list. This just removes the entry from the list but does not add it to the ignore list ||
    3043
    31 This window allows to start a verification process of the data.
     44== Ignore List Management ==
     45[[Image(ValidatorIgnoreListManagement.png,link=)]]
    3246
    33 You 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.
     47This 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.**
    3948
    40 When 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.
     49**Note:** in the context menu of an error in the list there is the entry [[JOSMImage(dialogs/delete,24,middle,link=))]] ''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.
     50
     51[[Image(IgnoreForNow.png,link=)]]
     52
    4153
    4254== Validation on upload ==
     55If 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.
    4356
    44 When 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
    45 are copied in the validation window, so they can be checked and fixed.
    46 
    47 == Validation layer ==
    48 
    49 If not disabled through preferences a validator run will open a validator layer.
    5057
    5158== Validation result can depend on the downloaded area ==
     59Some 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 [wikitr:/Help/Action/NewLayer new empty layer] or when you download single objects via [wikitr:/Help/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.
    5260
    53 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 [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.
     61Some validator rules are limited to defined areas (e.g. countries), see [wikitr:/Help/Styles/MapCSSImplementation#Territoryselector Territoryselectors].
    5462
    55 There are plans to limit validation rules to defined areas (e.g. countries), see #10387.
     63
     64== Preferences ==
     65There are some (advanced) settings, available, to influence the displayed object`s information in the list, see [wikitr:/Help/Dialog/SelectionList#Preferences Selection list preferences].
     66
    5667
    5768== See also ==
    58 * [wiki:Rules external Validator rules]
    59 * [wiki:/Help/Preferences/Validator Validator preferences] and description of validator tests
    60 * [wiki:/Help/Validator/MapCSSTagChecker MapCSSTagChecker] - about the syntax of validator checks, which are based on MapCSS
    61 * The plugin [https://wiki.openstreetmap.org/wiki/JOSM/Plugins/PT_Assistant PT Assistant], which adds validator rules
     69* [wikitr:/Rules external Validator rules]
     70* [wikitr:/Help/Preferences/Validator Validator preferences] and description of validator tests
     71* [wikitr:/Help/Validator/MapCSSTagChecker MapCSSTagChecker] - about the syntax of validator checks, which are based on MapCSS
     72* The plugin [osmwiki:JOSM/Plugins/PT_Assistant PT Assistant], which adds validator rules
    6273
    6374----
    64 Back to [wiki:/Help/ToggleDialogs Windows][[BR]]
    65 Back to [wiki:/Help Main Help]
     75Back to [wikitr:/Help/Menu/Windows Windows menu] \\
     76Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
     77Back to [wikitr:/Help/Menu Main Menu] \\
     78Back to [wikitr:/Help Main Help]