Changes between Version 52 and Version 71 of Help/Preferences/Validator


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Validator

    v52 v71  
    1 [[TranslatedPages(outdated=This page is incomplete. Lot's of tests not described.)]]
    2 [[PageOutline(2-4,Table of Contents)]]
     1[[TranslatedPages(outdated=This page is incomplete. Lot's of tests not described. Screenshot for rules is missing.)]]
     2[[PageOutline(2-4,Table of Content)]]
    33
    44= Preferences > Data Validator =
    5 [[JOSMImage(preferences/validator,48,link=,middle,margin-right=20,margin-bottom=10)]]
    6 
    7 An OSM data validator that checks for common errors made by users and editor programs.
     5[[JOSMImage(preferences/validator,48,link=,middle,margin-right=20,margin-bottom=10)]] **An OSM data validator that checks for common errors made by users and editor programs.**
    86
    97== Tests ==#Tests
    … …  
    2624By default, all error and warning tests are active.
    2725
    28 [[Image(validator_settings.gif,link=)]]
    29 
    30261. If you are a OSM newbie and encountered validation error about objects you haven't touched, please ignore these messages for now.
    31271. Validator can be wrong or incomplete about all tagging practices. Don't fix errors when you aren't sure something is really wrong.
    32281. First, refer to [wikitr:/Help/Dialog/Validator Validator panel] - how to use validator
    3329
     30[[Image(PreferencesValidatorTests.png,link=,600)]]
     31
    3432The fourth column contains also **(video)** explanations. The table is incomplete.
    3533
     34[=#TestsTable]
    3635||= **Type** =||= **Message** =||= **''What is checked''** =||= **Additional help** =||= **Autofix** =||
    3736||||
    … …  
    4342||  [[JOSMImage(data/warning)]]  || Multiple associatedStreet relations || an object is in more than one `associatedStreet` relation. || ||  no  ||
    4443||||
     44||||= **API Capabilities** =|||||| errors against API capabilities ||
     45||  [[JOSMImage(data/error)]]  || Way contains more than … nodes. It should be replaced by a multipolygon || || || ||
     46||  [[JOSMImage(data/error)]]  || Way contains more than … nodes. It should be split or simplified || || || ||
     47||||
    4548||||= **Barriers and entrances** =|||||| errors in [[osmwiki:Barriers]] and [[osmwiki:Key:entrance]]. ||
    4649||||
    … …  
    5255||||= **Conditional Keys** =|| usage of `*:conditional` tags. |||| Imprecise rules covered at [osmwiki:Conditional_restrictions osm wiki page "Conditional restrictions"] ||
    5356||||
     57||||= **Connectivity Relations** =|||||| Validates connectivity relations ||
     58||  [[JOSMImage(data/error)]]  || Connectivity tag missing comma between optional and non-optional values || || ||  no  ||
     59||  [[JOSMImage(data/error)]]  || Connectivity tag contains unusual data || || ||  no  ||
     60||  [[JOSMImage(data/warning)]]  || Connectivity relation without connectivity tag || || ||  no  ||
     61||  [[JOSMImage(data/warning)]]  || Inconsistent lane numbering between relation and member tags || || ||  no  ||
     62||  [[JOSMImage(data/warning)]]  || Multiple `via` roles only allowed with ways || || ||  no  ||
     63||  [[JOSMImage(data/warning)]]  || Relation member is missing a `lanes` or `*:lanes` tag || || ||  no  ||
     64||  [[JOSMImage(data/warning)]]  || Relation should not contain mixed `via` ways and nodes || || ||  no  ||
     65||  [[JOSMImage(data/warning)]]  || This connectivity may already be implied || || ||  no  ||
     66||||
    5467||||= **Crossing barriers / boundaries / ways** =|||||| ||
    5568||  [[JOSMImage(data/warning)]]  || Crossing ways || ways (with highway/railway/waterway tags) that cross in same layer with no crossing node || 1. [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Crossing_ways%22_with_shortcuts.ogv (video) usually you need to add a common node] or \\ 2. add appropriate [[osmwiki:Key:layer]] (and possibly [[osmwiki:Key:bridge]] or [[osmwiki:Key:tunnel]]) ||  no  ||
    5669||  [[JOSMImage(data/warning)]]  || Crossing barrier/building || barrier crossing a building in same layer with no crossing node || ||  no  ||
    5770||||
    58 ||||= **Duplicated nodes** =|||||| ''Advanced preference:'' \\ `validator.duplicatenodes.precision`: rounding precision in degree  ''(default: `0.0` or `1e7`)'' ||
     71||||= **Cycle detector** =|||||| Detects cycles (loops) in [[https://en.wikipedia.org/wiki/Drainage_system_(geomorphology)|drainage systems]]. \\ \\ ''Advanced preference:'' \\ `validator.CycleDetector.directionalWaterways`:  directional waterway values ''(default: `["river", "stream", "tidal_channel", "drain", "ditch", "fish_pass"]`)'' ||
     72||  [[JOSMImage(data/error)]]  || Cycle in directional waterway network || || ||  no  ||
     73||||
     74||||= **Duplicated nodes** =|||||| ''Advanced preference:'' \\ `validator.duplicatenodes.precision`: rounding precision in degree  ''(default: `1e-6` since r17612, `1-e7` before)'' ||
    5975||  [[JOSMImage(data/error)]]  || Duplicated nodes || no nodes in the very same location || Merge the nodes into only one, adding the properties from all nodes to the merged one || ||
    6076||||
    … …  
    6884||||= **Highways** =|||||| semantic checks on highways. ||
    6985||||
     86||||= **Internet tags** =|||||| errors in internet-related tags ||
     87||||
    7088||||= **Lane tags** =|||||| `lanes:*` tags, see [osmwiki:Lanes] ||
     89||||
     90||||= **Long segments** =|||||| long way segments, which are usually errors \\ \\ ''Advanced preference:'' `validator.maximum.segment.length`: maximum segment length in meters ''(default: `15,000`)'' ||
     91||  [[JOSMImage(data/warning)]]  || Long segments - Very long segment of … kilometers || way segment length above certain configured value || For real world objects it makes sence to add some way nodes. ||  no  ||
    7192||||
    7293||||= **Tag checker (MapCSS based)** =|||||| different kind of checks based on MapCSS, including [wikitr:/Rules external rules]. See [#TagCheckerRules Tag checker rules] tab and detailed description [#MapCssBasedTests below]. ||
    … …  
    82103|| ||= **Enable strict mode.** =||||||  even stricter rules, disabled by default \\ \\ ''Preference:'' \\ `validator.OpeningHourTest.strict` ''(default: `false`)'' ||
    83104||||
    84 ||||= **Overlapping ways** =|| a connection between two nodes is not used by more than one way. \\ \\ ''Advanced preference:'' \\ `overlapping-ways.ignored-keys` - list of ignored keys |||| [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Overlapping_ways%22_with_shortcuts.ogv (video) Using selection, split and middle mouse] ||
    85 ||  [[JOSMImage(data/warning)]]  || Overlapping (high)ways || two (high)ways that share the same nodes || ||  no  ||
    86 ||  [[JOSMImage(data/other)]]  || Highways share segment with area || a way with `highway=*` sharing consecutive nodes with a closed way or multipolygon || Depending on the mapping style and the tags of the involved area these overlaps are ok or not. It definitively makes selecting the objects and distinguishing between them harder ||  no  ||
    87 ||||
    88 ||||= **Power lines** =|||||| nodes in power lines that do not have a power=tower/pole tag. ||
     105||||= **Overlapping ways** =|| a connection between two nodes is not used by more than one way. \\ \\ ''Advanced preferences:'' \\ `overlapping-ways.ignored-keys` - list of ignored keys \\ `overlapping-ways.ignore-layer` ''(default: `false`)'' \\ `overlapping-ways.only-known-linear` ''(default: `true`)'' |||| [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Overlapping_ways%22_with_shortcuts.ogv (video) Using selection, split and middle mouse] ||
     106||  [[JOSMImage(data/error)]]  || Overlapping high-/rail-/waterways || two ways with `highway=*`, `railway=*` or `waterway=*` that share the same nodes || ||  no  ||
     107||  [[JOSMImage(data/error)]]  || Way contains segment twice || || ||  no  ||
     108||  [[JOSMImage(data/warning)]]  || High-/Rail-/Waterway shares segment with linear way || a way with `highway=*`, `railway=*` or `waterway=*` sharing consecutive nodes with another open way || ||  no  ||
     109||  [[JOSMImage(data/other)]]  || High-/Rail-/Waterway shares segment with other way || a way with `highway=*`, `railway=*` or `waterway=*` sharing consecutive nodes with a closed way or multipolygon || Depending on the mapping style and the tags of the involved area these overlaps are ok or not. It definitively makes selecting the objects and distinguishing between them harder ||  no  ||
     110||  [[JOSMImage(data/other)]]  || Ways share segment || || ||  no  ||
     111||||
     112||||= **Power lines** =|||||| ''Advanced preferences:'' \\ `validator.PowerLines.hilly_compensation` ''(default: `0.2`)'' \\ `validator.PowerLines.hilly_threshold` ''(default: `4.0`)'' ||
     113||  [[JOSMImage(data/warning)]]  || node without power=* || nodes in power lines/minor_lines that do not have a power=tower/pole/portal tag ||  ||  no  ||
     114||  [[JOSMImage(data/warning)]]  || Mixed reference numbering || node ref numbering continuity on power supporting features (pole, tower etc.) along the line || ways are highlighted ||  no  ||
     115||  [[JOSMImage(data/warning)]]  || Reference numbering don't match majority of way's nodes || node ref numbering continuity on power supporting features (pole, tower etc.) along the line || nodes are highlighted ||  no  ||
     116||  [[JOSMImage(data/warning)]]  || Node connects a power line or cable with an object which is not related to the power infrastructure ||  ||  ||  no  ||
     117||  [[JOSMImage(data/warning)]]  || Possibly missing line support node within power line || ways where are unusually long segments without line support feature || when water data is also in the dataset, the intersecting length is discarded, e.g. line over a river ||  no  ||
     118||  [[JOSMImage(data/warning)]]  || Possibly wrong power line type used || ways where the line type is possibly misused || ||  no  ||
     119||||
     120||||= **Public Transport Route** =|||||| errors in [osmwiki:Public_Transport#Service_routes public transport route relations]
    89121||||
    90122||||= **Relation checker** =|||||| errors in relations. ||
    … …  
    95127||||= **Self-intersecting ways** =|||||| ways that contain some of their nodes more than once. ||
    96128||  [[JOSMImage(data/warning)]]  || Self-intersecting ways || a way crosses itself || Remove the self-crossing, remove overlapping parts or split way || ||
     129||||
     130||||= **Sharp angles** =|||||| sharp angles on roads \\ \\ ''Advanced preferences:'' \\ `validator.sharpangles.maxlength` ''(default: `10.0`)'' \\ `validator.sharpangles.maxangle` ''(default: `45.0`)'' \\ `validator.sharpangles.ignorerailway` \\ `validator.sharpangles.ignorehighway` ||
    97131||||
    98132||||= **Similarly named ways** =|||||| ways with similar names that may have been misspelled. ||
    … …  
    118152||  [[JOSMImage(data/warning)]]  || Unclosed ways || way types, which should be closed really are closed || Close unclosed ways ||  no  ||
    119153||||
    120 ||||= **Unconnected highways / natural lands and landuses / power ways / railways / waterways** |||||| a way has an endpoint very near to another way. \\ \\ ''Advanced preferences:'' \\ `validator.UnconnectedWays.node_way_distance` ''(default: `10.0`)'' \\ `validator.UnconnectedWays.way_way_distance` ''(default: `0.0`)'' ||
    121 ||  [[JOSMImage(data/warning)]]  || Way end node near other highway || End point of a way is very near to other ways || Connect the ways or when really unconnected set a 'noexit' tag to prevent further warnings ||  no  ||
     154||||= **Unconnected highways / natural lands and landuses / power ways / railways / waterways** |||||| a way has an endpoint very near to another way. \\ \\ ''Advanced preferences:'' \\ `validator.UnconnectedWays.node_way_distance` ''(default: `10.0`)'' \\ `validator.UnconnectedWays.node_way_distance_railway` ''(default: `1.0`)'' \\ `validator.UnconnectedWays.way_way_distance` ''(default: `0.0`)'' ||
     155||  [[JOSMImage(data/warning)]]  || Way end node near other highway || End point of a way is very near to other ways || Connect the ways or when really unconnected add `noexit=yes` tag to prevent further warnings ||  no  ||
     156||  [[JOSMImage(data/warning)]]  || Way end node near other way || || ||  no  ||
     157||  [[JOSMImage(data/other)]]  || Connected way end node near other way || || ||  no  ||
     158||  [[JOSMImage(data/other)]]  || Way node near other way || || ||  no  ||
    122159||||
    123160||||= **Untagged and unconnected nodes** =|||||| untagged nodes that are not part of any way. ||
    124 ||  [[JOSMImage(data/warning)]]  || Unconnected nodes without physical tags || untagged nodes that are not part of any way || 1. If it is yours node, you are to decide if to remove it otherwise \\ 2. Download parent relations and contact mappers who added these nodes in unclear cases || ||
     161||  [[JOSMImage(data/warning)]]  || Unconnected nodes without physical tags - \\ No tags \\ Has key `created_by` or `converted_by` \\ Has key `source` \\ Has key `watch` || nodes not part of any way without tags or only `created_by`, `converted_by`, `source` or `watch` || 1. If the node was created by yourself, you are to decide if to remove it otherwise \\ 2. [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent relations] and contact mappers who added these nodes in unclear cases ||  yes  ||
     162||  [[JOSMImage(data/warning)]]  || Unconnected nodes without physical tags - \\ Has key `note` or `comment` or `description` \\ Has tag containing `fixme` || nodes not part of any way with only `note`, `comment`, `description` or `fixme` || 1. If the node was created by yourself, you are to decide if to remove it otherwise \\ 2. [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent relations] and contact mappers who added these nodes in unclear cases ||  no  ||
    125163||||
    126164||||= **Untagged, empty and one node ways** =|||||| untagged, empty and one node ways. ||
    127 ||  [[JOSMImage(data/error)]]  || Incomplete ways || ways with zero or only one node || Removes the way || ||
    128 ||  [[JOSMImage(data/warning)]]  || Untagged ways || untagged ways || 1. describe them correctly if you know this objects or \\ 2. leave them until somebody describes them ||  no  ||
     165||  [[JOSMImage(data/error)]]  || Empty ways \\ \\ One node ways || Invalid ways with zero or only one node || 1. Look at the [wikitr:/Help/Action/ObjectHistory object's history] \\ 2. Remove the way (autofix) ||  yes  ||
     166||  [[JOSMImage(data/warning)]]  || Unnamed ways || highway without `name` or `ref` || Add `name` or `ref` if known or `noname=yes` if sure that the way does not have a name ||  no  ||
     167||  [[JOSMImage(data/warning)]]  || Untagged ways (commented!) || ways without any tag (or only with `comment`, `description`, `fixme` or `note`) and without membership in a relation || 0. if working with incomplete data, [wikitr:/Help/Action/DownloadParentWaysAndRelation download parent relations] \\ 1. describe them correctly if you know this objects or \\ 2. leave them until somebody describes them ||  no  ||
     168||  [[JOSMImage(data/other)]]  || Unnamed junction || highway with `junction` and  without `name` or `ref` || Add `name` or `ref` if known or `noname=yes` if sure that the junction does not have a name ||  no  ||
    129169||||
    130170||||= **Way connected to Area** =|||||| ways connected to areas. ||
    … …  
    132172||||
    133173||||= **Wrongly Ordered Ways** =|||||| direction of water, land and coastline ways.  ||
    134 ||||
    135 ||||= **Uncategorized** =|||||| Descriptions that need to be checked, updated and added to one of the categories above. ||
     174||  [[JOSMImage(data/warning)]]  || Reversed coastline: land not on left side \\ \\ Reversed land: land not on left side || wrong way direction of `natural=coastline` \\ \\ wrong way direction of `natural=land` || [wikitr:/Help/Action/ReverseWays Reverse way] direction ||  no  ||
     175||||
     176||||= **''Uncategorized''** =|||||| Descriptions that need to be checked, updated and added to one of the categories above or MapCSS below ||
    136177|| || Check property keys || misspelled property keys. See the [source:/trunk/resources/data/validator/words.cfg words.cfg] for file of misspelled property keys || Replace wrong key with right one || ||
    137178|| || Empty properties || properties with empty values || || ||
    138179||  [[JOSMImage(data/other)]]  || Key 'x' invalid. - ... || illegal key combinations, names and similar issues || ||
    139180||  [[JOSMImage(data/other)]]  || Nodes with the same name || two nodes have equal name || || ||
    140 ||  [[JOSMImage(data/other)]]  || Unknown property value || proper use of tags || If it is your new tag, it is good idea document it at wiki [[osmwiki:Any tags you like]] || ||
     181||  [[JOSMImage(data/other)]]  || Unknown property value || proper use of tags || If it is your new tag, it is a good idea to document it at the OSM-wiki ([osmwiki:"Any tags you like"]) ||  no ||
    141182
    142183
    … …  
    153194* [[JOSMImage(dialogs/edit)]] modify selected entry
    154195* [[JOSMImage(dialogs/delete)]] delete items from the list
    155 The [[JOSMImage(preferences/reset,link=,24,middle)]] reset button at the bottom resets the ''active rules'' to default.
     196The [[JOSMImage(preferences/reset,link=,24,middle)]] reset button at the bottom resets the ''active rules'' to default, removing any manually added entry.
    156197
    157198=== MapCSS-based tests ===#MapCssBasedTests
    … …  
    186227== Advanced Preferences ==
    187228More advanced preferences not described, yet.
    188 * `validator.auto_reload_local_rules` - wether to auto-reload local rules after file changes
    189 * `validator.autozoom` - wether to [wikitr:/Help/Action/ZoomToProblem Zoom to problem], automatically
     229* `validator.auto_reload_local_rules` - whether to auto-reload local rules after file changes
     230* `validator.autozoom` - whether to [wikitr:/Help/Action/ZoomToProblem Zoom to problem], automatically
     231* `validator.check_assert_local_rules` - whether to enable MapCSS assertions for local rules
    190232* `validator.ignorelist` - the ignore list
    191233* `validator.ignorelist.version` - format version of the ignore list