Quality Assurance Tools script

From OpenStreetMap Wiki
Jump to navigation Jump to search

This script could be used in JOSM to download errors from different error detectors, showing them as markers layers and check them one after another.

Current State of the Tool

The Quality Assurance Tool is no longer in development and is not functional in the most recent versions of JOSM. Please do not attempt to use this tool in the current state.

The repository of the tool is available for access. It is possible for someone to pick up development of the tool with sufficient coding background, and interest. Until then this page is left as a reference and advertisement for what the tool was capable of, and what features should be available if someone were to resume development

How To Use

Qat script download dlg screenshot small.png

Qat script logo.png

Features

Downloading errors from the menu.
Fixing errors one by one.
  • Errors download of currently observed area in JOSM, from different error detectors. The type of error can be selected from a menu or a toggle dialog, in the second case, multiple kinds of error can be downloaded at once.
  • Progressive correction of downloaded errors by clicking "next", "next", "next"...
  • Automatic flag to server (KeepRight, Osmose, Errori in OSM Italia Grp, housenumbervalidator) of false positive errors or information gathering for manual report (OSM Inspector) to the tool admin.
  • Flag errors to be ignored. They will be stored on a local black-list file and not shown to the mapper again.
  • Clickable markers for zooming/downloading a specific error. The level of the clicked marker must be activated.
  • Multiple favourite zones can be set so that only errors within it will be downloaded. It can be a rectangle, a polygon drawn by hand or an administrative boundary with specific tags (more info).
  • A list of favourites checks can be created by selecting different checks belonging to different tools and find them again quickly.
  • A local GPX file can be opened. Its waypoints will be used as positions that the user can visit in sequence to check for errors (more info).


Supported QA Tools

Tool Max number of errors downloaded Flag false positives Flag corrected error
OSM Inspector [1]
(not all checks)
None No No
KeepRight [2] 10000 Yes Yes
Osmose [3] 500 Yes Yes
Errori OSM Italia Grp [4] None Yes No
housenumbervalidator [5] None Yes Yes
Opening hours validator None No No

Usage

Video

Errors downloading

1. Zoom to the zone of your interest, in JOSM

2. download the errors from the "QA Tools" menu or the download dialog

"QA Tools" menu.
Download dialog.

Errors correction

Correct the downloaded errors one by one.

Qat script errorInfoBtn.png Show information about the current error.
Qat script notErrorBtn.png Flag this error to the server as a false positive.
(KeepRight - Osmose - Errori OSM Italia Grp - housenumbervalidator)
Gather information of this error on QA Tools -> False positive menu, to inform the admin of the service.
(OSM Inspector)
Qat script ignoreBtn.png I don't know what to do. Don't show me again this error and go to the next.
Qat script correctedBtn.png Flag this error to the server as corrected.
(KeepRight - Osmose - housenumbervalidator)
Qat script goToNextBtn.png Go to the next error.
Fixing dialog

Favourite zones

Editing favourite zones from Preferences

When a favourite zone is active, only errors within this area will be downloaded.

You can create a new favourite zone in one of these ways:

  • from the Preferences (see video from min 1:50)
  • by adding one or more text file into "qat_script/configuration/favourite_zones" directory.
    A file can contain a bbox, for a rectangular zone or a WKT geometry. In the second case, just copy a geometry from QGIS, paste it on a text file and, optionally, add a country code after the geometry description (e.g. file Rome.txt, content "MULTYPOLYGON(...)|IT").
    Pre-built zones: regions and counties of Italy.

Notes:

  • Holes in zones are not considered. If a favourite zone is created from a boundary only outer ways are used.
  • Warning. When a tool has a maximum number of errors that can be downloaded (10000 from KeepRight, 500 from Osmose), it may happen that not all the errors of the zone are shown, depending on the zone shape and errors position. If you want to be sure that you corrected all the errors of the zone, download them again after having corrected some or choose a rectangular favourite zone.
    Example (see image): suppose there are 80 errors in the favourite zone. The script downloads a maximum of 100 errors (green) from the rectangle (bbox) and shows to the user 60 errors falling inside the area (40 fall outside, top right). After 20 of 60 errors area corrected it will be possible to download the remaining 20 errors (red).

Local file

From QA Tools menu it is possible to open a local GPX file whose waypoints are used as errors positions.

Anyone who finds errors while analyzing OSM data may create a GPX with these errors as waypoints and ask a local community to check them one by one with QATs. The script can read the content of desc and osmid tags from the GPX file to:

  • show a description of the error in in QATs dialog
  • automatically download and select the affected OSM object.

Example:

<wpt lat="12.34567" lon="12.34567">
  <desc>This is a self intersecting way</desc>
  <extensions>
    <ogr:osmid>w12345567</ogr:osmid>
  </extensions>
</wpt>

Hints on how to create a suitable GPX from a PostGIS database created with osmosis.

SQL:

SELECT 'w'||id AS osmid, 'This is a self intersecting way' AS desc, ST_StartPoint(linestring) AS geometry
FROM ways
WHERE sql to find errors;

Export to GPX:

ogr2ogr -f "GPX" filename "PG:host=localhost user=username port=5432 dbname=dbname password=pwd" -sql "sql" -nlt "POINT" -dsco GPX_USE_EXTENSIONS=YES

Development

Code: on GitHub

Author: Simone F.

Contributors and credits: Gubaer, mcheck, Poppei82, operon, Xmypblu, QA tools authors ... see this page for credits.

Note. I wrote this script because I could not find a JOSM plugin which could fetch errors from multiple QA tools. I just know a bit of Python and I would be happy if this code could be used or could inspire someone to create a regular Java plugin with these features, or to extend an existing plugin.

If you want to translate the script's gui to your language, please translate this page.

See also

Errors correction:

Development: