Scanaerial
From OpenStreetMap Wiki
Contents |
General
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)
- 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 Imagery |
| wms_server_url | you may choose your favourite WMS server | http://wms.latlon.org/?layers=bing& |
| 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.
