JOSM/Plugins/Scanaerial

From OpenStreetMap Wiki
< JOSM‎ | Plugins(Redirected from Scanaerial)
Jump to: navigation, search

General

JOSM screenshot showing unmapped tundra with Bing Imagery
JOSM screenshot showing tundra with mapped lakes and Bing Imagery
JOSM screenshot showing tundra with mapped lakes, data only

Scanaerial is a package with python code to scan aerial pictures.

Requirements

  • JOSM (current version)
  • Ext_tools plug-in for JOSM
  • Python & needed libraries (run library_check.py to find out if a library is missing)
    • Python Image Library (in Gentoo: dev-python/imaging). This is only available in Python 2.7 and is not currently available in the newer 3+ versions.
    • Python Projection Library (in Gentoo: dev-python/pyproj)
  • Current Scanaerial-Script

Setup

Windows

  • Unzip the archive and put it in a directory you like (e.g. C:\scanaerial\)
  • Install Python, version 2.7 recommended (in our example installed to C:\python27\)
  • Install needed Python libraries (Python Imaging Library (PIL) & Python Projection Library (PyProj))
  • Install Ext_tools-Plugin in JOSM (more information on JOSM/Plugins#Installation) & Restart JOSM
  • In JOSM press F12 and go to Ext_tools configuration
  • Add a new tool by clicking the button saying so. Give the tool a good name (scanaerial would be an idea) and paste this as commandline:
C:\python27\python.exe C:\scanaerial\scanaerial.py {lat} {lon} {TZoom}

or if there is a space in the name of the directory (e.g. C:\scan aerial\)

C:\python27\python.exe "C:\scan aerial\scanaerial.py" {lat} {lon} {TZoom}

It will create a new menu item in the tools menu.

Linux

  • Unzip the contents of the downloaded archive to the JOSM Plugin directory. Put it to: ~/.josm/plugins/ext_tools/scanaerial
  • Install Python + needed libraries
  • Install Ext_tools-Plugin in JOSM (more information on JOSM/Plugins#Installation) & Restart JOSM
  • In JOSM press F12 and go to Ext_tools configuration
  • Add a new tool by clicking the button saying so. Give the tool a good name (scanaerial would be an idea) and paste this as commandline:
/home/<username>/.josm/plugins/ext_tools/scanaerial/scanaerial.py {lat} {lon} {TZoom}

It will create a new menu item in the tools menu. (NB: Syntax may change soon. Due to a bug in Ext_tools you can not write “~” instead of “home”)

Using Scanaerial

  • To invoke scanaerial press ctrl+k or select the new menu item. Now point the cursor on the area you want to trace and left-click.
  • For best result you may finetune the values in scanaerial.cfg

Finetuning Config-File

Key Function Default value
fixedzoomlevel use this zoomlevel, if Ext_tools did not tell via TZoom 13
wmsname name of the WMS Source (only for the tag string) Bing or LandSAT Imagery
wms_server_url you may choose your favourite WMS server http://irs.gis-lab.info/?layers=landsat&
projection projection that is used on the WMS server EPSG:3857
tile_sizex,-y leave it to 256 unless you know what you do 256
douglas_peucker_epsilon maximum roughness for smoothening the line 0.60
deactivate_simplifying exact meaning ? 0
colour_str colour sensitivity 30
maxfilter_setting how many times should we apply the smoothening? 3

Fan stuff

if you like scanaerial you can show others that you use it by putting

[[Category:Scanaerial User]]

in your Userpage.

See Also