Details
-
Type:
Wish
-
Status:
Open
-
Priority:
Major
-
Resolution: Unresolved
-
Affects Version/s: 8.0-M2
-
Fix Version/s: None
-
Component/s: docs, graph extension
-
Labels:None
Description
The graph module is responsible for the bulk of questions this month; one thing that makes answering these questions hard is the lack of a test case or example program that could be used as a reference point.
With that in mind I would like to put together a simple "Graph" tutorial; please use the comments to outline the ideas of what you would like to see ... however a couple of guidelines:
1. We need a sample dataset - a public sample data set. I will consider the Tiger Roads dataset as a good reference point unless someone can think of something smaller (and more international). Is there a good way to extract just a bit of open street maps?
2. We step by step instructions need to be simple and straight forward and very well tested!
3. The tutorial has to be visual in some fashion
4. We can save many of the other goals of the graph module for the bonus questions (such as the differences between the path finding algorithms).
5. We follow a "code first" writing style; so no explaining things in the middle of the step by step instructions
6. We can put and explaining after the code; but we should save any detailed background on graph theory for the peanut gallery (or wikipedia). We want results in a tutorial - not theory.
| 1. | Graph Tutorial Sample Data | |
|
Jody Garnett | |
| 2. | Graph Visual Code Example | |
|
Jody Garnett |
Activity
| Field | Original Value | New Value |
|---|---|---|
| Comment | [ Showing the graph will be fine with the DirectLayer code that was added to GeoTools; I actually have graph drawing code in uDig I can port over to DirectLayer. ] |
1. We need a sample dataset - a public sample data set. I will consider the Tiger Roads dataset as a good reference point unless someone can think of something smaller (and more international). Is there a good way to extract just a bit of open street maps?
I've been using a small subset of Open Street Map roads and it's been fine. Someone has created handy OSM shapefile downloads for the UK (e.g. England is here http://www.sharegeo.ac.uk/handle/10672/28) but I'd suggest using something smaller. I have my own dataset for Leeds (UK) which I could send you.
Also, we should decide how clean the data should be. OSM data in it's raw form doesn't make nice graphs because the lines don't break at intersection points (so roads that cross don't form nodes) but it's fairy easy to fix this beforehand. I have some GeoTools code to do this, or there are tools in ArcGIS as well which actually work better. Again I'd be happy to send the 'clean' OSM data that I have, but showing how to clean the data to some extent (e.g. removing disconnected graphs) might be a useful tutorial task.
Jody: We can save data cleaning for the bonus section; perhaps with a simple example such as a) snapping
3. The tutorial has to be visual in some fashion
Yes, it would be nice if we could see the paths in a GUI somehow, or watch as an iterator walks over the graph. I imagine this will require a fair bit of work though and might be overkill.
Jody: Showing the graph will be fine with the DirectLayer code that was added to GeoTools; I actually have graph drawing code in uDig I can port over to DirectLayer. Visual is not negotiable for these GeoTools tutorials; too many questions on the user list if people cannot see what they are doing!
6. We can put and explaining after the code; but we should save any detailed background on graph theory for the peanut gallery (or wikipedia). We want results in a tutorial - not theory.
I agree, this style works well for the other geotools tutorials.