Welcome!

This is the website for the Staffordshire LUG, or Linux Users Group.

Here you will find a number of articles written by existing group members, details on joining the mailing list, a host of helpful links and regular updates on our meet-ups.

We’re always happy to see new members, so feel free to join-in the activities via the following methods:

Staffslug Mailing List

#staffslug on irc.freenode.net

We strive to be a friendly group of people, and welcome any questions or queries regarding Linux or simply open-source software in general.

Jameter Software Development Tool

Jameter Software Development Tool

StaffsLUG member Dave Boucher has released a new project called Jameter.
It’s a software development tool whose aim is to allow you to produce
your own games using the Lua programming language. Anyone who is
interested should take a look at www.jameter.org

Fedora 13

Get Fedora 13

OpenStreetMap

This is an article based on the presentation given at StaffsLUG on 10th March 2010 by Russ Phillips.
Download the presentation.

What is it? How Useful is it?

OpenStreetMap (OSM) is an attempt to create free geographic data for the whole world. The important point here is that the data is free, not just the map images. Editing is done in a wiki-like manner, which allows OSM to respond very quickly to change. After the Haiti earthquake earlier this year, OSM had updated maps within a couple of days, showing damaged buildings, blocked roads, refugee camps etc. This data was converted into maps for GPS receivers, allowing aid workers to navigate much more easily.

In March, Roy Van Keulen, TomTom’s VP of ecommerce, told PC Pro, "There are services like OpenStreetMap, and it’s good, but sometimes there’s not a bridge when it told you there would be." In fact, in at least one instance, the opposite is true. In November 2009, floods rendered bridges in Workington (Cumbria) impassable. Within a day, OSM’s map had been updated to show the bridges as being inaccessible. In April 2010, the army opened a temporary bridge, and on the day it was opened, OSM was updated to show it as being usable. TomTom’s web site still tried to route people over the damaged bridges, and didn’t show the temporary bridge at all.

Routes over Workington Bridges

Like TomTom, OSM isn’t perfect. Despite what Mr Van Keulen seems to think, the problem isn’t that OSM will tell there is a bridge where there isn’t one. The real problem is that OSM doesn’t know about all the bridges, roads etc that do exist. It’s improving all the time, though, and at the start of May 2010, OSM had all UK motorways and B roads, about 90% of A roads, and 70% of other roads. OSM doesn’t just know about roads, though – it also knows about almost all UK hospitals, and 20% of pharmacies.

Not Just a Pretty Map

As I said in the introduction, OSM isn’t just a map – it’s geographic data. This is an important distinction, because having access to the raw data allows developers and users to use it for unexpected things. If your only access is an API, then you can’t do anything that the API doesn’t cater for, which effectively means you can’t do anything that the API writers didn’t think of.

OSM data is used for many different things. I wrote a web site called Healthwhere which allows a user to find a pharmacy or hospital close to them. It’s specifically designed to be just as usable on my phone’s 2″ screen as on my desktop’s 19″ screen.

OpenCycleMap is a map designed for cyclists. As such, it shows cycle routes much more prominently than motorways, since they’re far more useful for cyclists. This is only possible because OSM’s raw data is available. It wouldn’t be feasible to take a standard road map and make the cycle routes much more obvious than the motorways.

HaptoRender is a project to create tactile maps, that can be read using fingers, designed for use by the blind. A tactile map based on OSM data was made in May, 2009, and displayed at that year’s OSM conference.

Collecting Data

Most OSM data is collected using a hand-held GPS, whilst driving, walking or cycling. The GPS is set to record a track, which is then uploaded to OSM’s servers and used to trace the roads, paths etc.

If you are interested in buying a GPS, the GPS Reviews wiki page has reviews of many different models.

As many phones now have GPS’s built in, software has been developed to make use of these.

For iPhone users, there is Mapzen, an app for collecting points of interest (restaurants, pharmacies, etc).

For the Android, there is AndNav2 and Vespucci.

The OSM wiki has a page listing apps for other phones.

You Don’t Need a GPS!

Using a GPS is the preferred way to collect data, partly because you can collect all sorts of extra data while walking around (opening times, location of litter bins, etc). However, if you don’t own and don’t want to buy a GPS, you can still help improve the map.

OpenStreetBugs is a web site that makes it easy to report bugs in the map. Simply mark the location and add a description of what is wrong.

Walking Papers is a site that allows you to print out a map of an area. You then annotate it with notes, scan & upload it, and use it as a reference to update OSM. If you don’t have a scanner, you can post the map to them and they will scan and upload it for you.

Healthwhere can update and add details to pharmacies and hospitals.

Ordnance Survey OpenData is a collection of data from the UK’s Ordnance Survey mapping agency that has been released under an OSM-compatible licence. OSM editors support tracing from this data.

Finally, out-of-copyright maps such as those at NPE Map can be used, though you should only trace features that you know haven’t changed.

Editing the Map

To edit OSM, you must first register. Once you have an account, there are several options.

Potlatch is the online editor, accessed by clicking the Edit tab on the OSM web site. It’s designed to be simple to use, but requires Flash (the latest version of Gnash should work).

I wrote an article for the StaffsLUG web site entitled "Add a Road to OpenStreetMap in 5 Minutes", which describes how to register and use Potlatch to add one or more roads. The whole process can be done in under five minutes.

JOSM is an off-line editor. Once run, you can download data, edit it, then upload the changes.

There are other options available, but Potlatch and JOSM are the primary editors. Whichever method you use, the Map Features wiki page is a useful reference. Users are free to use any tag, but those described on Map Features are more likely to appear on the map and be recognised by software that uses OSM data.

Add a Road to OpenStreetMap in 5 Minutes

This article is intended for someone that has just heard about OpenStreetMap (OSM), and would like to add a road (or several) in an area they know well (eg your home area). It assumes that you live in the UK and that you do not own a GPS. You will need a web browser that supports Flash (the latest version of Gnash will work).

Register with OpenStreetMap

To edit OSM, you need a free account. Go to the OpenStreetMap web site, and click the “sign up” link in the top-right. Enter an e-mail address, display name and password. When you receive the activation e-mail, follow the directions to activate your account.

Find Your Local Area

The OpenStreetMap web site has a search box to the left of the map. Use this to search for your local area, using either your postcode or town name. Once your area is displayed in the map, click the “Edit” tab above the map, then enter your login details.

Start the Online Editor

Potlatch (OSM’s online editor) will now be visible in your browser. Click the tick in the bottom-left to open the options dialogue. Select “UK: OS StreetView” from the drop-down box at the top of the dialogue box. The other options can be left as they are, or altered to your preference. [screenshot]

Add a Road

Adding a way in Potlatch

A road in OSM is defined as a series of connected points, called nodes. To add a new road, click on the map at one end of the road, then click at each node in turn. Double-click to mark the end node. If you make a mistake, press Delete to delete the last node. If you need to cancel the entire road, click Esc. If the road joins onto another road, make sure that the final node is on the road it joins (Potlatch will highlight the other road when the cursor is over it).

Add Tags

Editing tags in Potlatch

Now you need to add information about the road. This is done by adding tags, each of which has a name and a value. Potlatch has presets for most types of road. Under the main map view, there is a drop-down list where the type of road can be selected. Select the appropriate type, and Potlatch will display a number of tags, some of which will be already filled in. Fill in the details for any that have blank values.

Since the road has been traced from Ordnance Survey StreetView, and they require attribution, it is important to add a “source” tag. To do this, click on the + icon at the bottom right. A new tag will appear. In the left-hand box, replace the word “key” with “source”, and add “OS_OpenData_StreetView” in the right-hand box.

Add More Roads

Saving changes in Potlatch

You have now added a road to OSM. You can repeat the above two steps to add more roads. When you are finished, click “Save” in the bottom-right corner. Add a short description of your changes, then click “OK” to save the changes. Note that your changes may not appear in the main map immediately, and they may appear at some zoom levels sooner than others.

Further Reading

This article deliberately concentrates on a very specific task. If you would like to do more, the following links should be a good start: