{"id":2036,"date":"2018-05-03T15:57:17","date_gmt":"2018-05-03T03:57:17","guid":{"rendered":"http:\/\/blogs.lincoln.ac.nz\/gis\/?p=2036"},"modified":"2023-05-07T00:30:59","modified_gmt":"2023-05-07T00:30:59","slug":"flow-diagrams-that-work","status":"publish","type":"post","link":"https:\/\/blogs.lincoln.ac.nz\/gis\/flow-diagrams-that-work\/","title":{"rendered":"Flow Diagrams That Work"},"content":{"rendered":"

We cover executable flow diagrams using ModelBuilder in this post.<\/em><\/p>\n

In a previous post<\/a> we covered a straightforward example of a quick GIS job that involved Merging and Dissolving 43 input contour shapefiles, then selecting and exporting a subset.\u00a0 At the end, I flippantly included a flow diagram, reproduced by the magic of science below:<\/p>\n

\"\"<\/a><\/p>\n

I’m a great advocate of using flow diagrams in GIS.\u00a0 The one above is serving as a nice visual summary of the steps taken in this analysis.\u00a0 In the tradition of a picture telling a thousand words, the flow diagram can often replace a long, drawn out text description to better tell the story.\u00a0 I frequently see them in theses and journal articles doing just that.\u00a0 But they also work well in the planning stages of a GIS analysis project.\u00a0 I will often use flow diagrams before I even open up ArcMap to help organise my approach and the tools I’ll use.\u00a0 They are subject to change, of course, but they often serve as first drafts of what I might end up doing.<\/p>\n

The nice thing about the one shown above is that it’s more than just a pretty picture: it works – it’s executable.\u00a0 Rather than work with Word or Visio to painstakingly put together a bunch of boxes, ovals and arrows, I built the diagram above using ModelBuilder inside ArcMap (or ArcCatalog).\u00a0 In short, any geoprocessing tool available in ArcGIS can be dragged on to a blank canvas and used to build up an analysis flow.\u00a0 I’ll show you a few quick examples of how to build up a model and then add in a video at the bottom to show how it all fits together.<\/p>\n

Adding tools to ModelBuilder<\/strong><\/p>\n

Open a new model from ArcMap or ArcCatalog by clicking on the ModelBuilder button, \"\"<\/a>, on the Standard toolbar<\/a>.\u00a0 This open a new, blank canvas.<\/p>\n

\"\"<\/a><\/p>\n

Here’s where you’ll build up the model.\u00a0 Geoprocessing tools from ArcToolbox can be dragged onto the canvas.\u00a0 In this example from that previous post<\/a>, I’m working with 43 input shapefiles of elevation contours lines that I’ll merge together.\u00a0 To simplify the merged contours I’ll then run the dissolve tool, then run a query to select a subset of those records, and finally export those selected records (see how much easier it is to explain that with a diagram?).\u00a0 So let’s start by dragging the Merge tool onto the canvas.\u00a0 The Merge tool lives in ArcToolbox > Data Management Tools > General toolset – that’s open at the right.\u00a0 All I need to do is click on it and drag it onto the canvas:<\/p>\n

\"\"<\/a><\/p>\n

Next I’ll set the parameters for the tool by first clicking somewhere on the canvas to clear all the selected features and then double click on the Merge tool, opening its tool window:<\/p>\n

\"\"<\/a><\/p>\n

Notice that I’m using 43 shapefiles as an input so what we see on screen is probably going to be a bit messy.\u00a0 When I click okay you can see how the diagram changes:<\/p>\n

\"\"<\/a><\/p>\n

Those blue things are all my input shapefiles so I’ll just zoom in on the main tools:<\/p>\n

\"\"<\/a><\/p>\n

With the tool parameters set, the colours of my boxes have changed.\u00a0 The blue ovals are my inputs, the orange boxes are tools and the green ovals are outputs.\u00a0 This is now an executable model, albeit a simple one.\u00a0 If I wanted to, I can click the Run button, \"\"<\/a>, and the tool will run but we’ll do that after the whole model has been built up.<\/p>\n

Next we’ll add the Dissolve tool.<\/p>\n

\"\"<\/a><\/p>\n

I want to use the Merge output as the input to this tool.\u00a0 As with the Merge tool, it’s initially blank so first I’ll link the Dissolve tool to the Merge output using the Connect tool, \"\"<\/a>, – this just means clicking on the MergedContours.shp oval and dragging a line to the Dissolve tool.\u00a0 When I connect to the Dissolve tool, a small window pops up that allows me to set the nature of the connection:<\/p>\n

\"\"<\/a><\/p>\n

Here I want to use the Merge tool output as the input to the Dissolve tool so clicking “Input Features” makes this happen:<\/p>\n

\"\"<\/a><\/p>\n

Just to ensure that the tool is set up okay, I’ll double-click on Dissolve to check it:<\/p>\n

\"\"<\/a><\/p>\n

Ticking both the attributes just ensures I keep them in the output.\u00a0 That tool’s now set so we can move on to the query and the export.\u00a0\u00a0 I’ll skip ahead but you can see all the action in the video below.\u00a0 My final model looks like this:<\/p>\n

\"\"<\/a><\/p>\n

Those paying attention may note that this diagram is a little bit different from what I first showed at the top.\u00a0 The last tool used is Select without the Copy tool at the end.\u00a0 I hadn’t realised when I first set this up that the Select tool creates its own output so my final model is even simpler.<\/p>\n

With this final step I now have not just a pretty picture (subject to debate) but now an executable model that will take the inputs, run the tools and deliver me an output. And it works!\u00a0 Clicking the Run button ran the model and overall it took about 2 minutes to run and delivered this as a result:<\/p>\n

\"\"<\/a><\/p>\n

So ModelBuilder allows us to graphically build up a model by dragging and connecting tools on a canvas.\u00a0 Parameters and tool settings can be set in advance and when all it tickty boo, the model can be run in the background.\u00a0 In addition to creating working flow diagrams, it can be a great time saver in the right circumstances<\/em>.<\/p>\n

To be fair, this example shown here is probably not one where i would actually use ModelBuilder, but it served well as a good simple example of how it could be used.\u00a0 The balancing act is often around a question like: Am I going to spend as much (if not more) time building the model as I would just doing it manually?\u00a0 If something like this is to be a time saver then it has to speed up the whole analysis process.\u00a0 For something like this, I suspect it wouldn’t really be worth my while to build the model that I might only use once.\u00a0 Models are most useful when you’ve got a complex set of tools that need to run and rerun multiple times.\u00a0 Or, if you’ve got a lot of data layers that need the same thing done to them and doing so would either drive you insane or blind.\u00a0 It’s probably not worth it for one off tasks unless there’s the possibility of having to do it another time in the future or if running the tasks is going to take large amounts of mindless time.<\/p>\n

Of course the other alternative to this is Python scripting.\u00a0 There have been a number of previous posts on the use of Python (here<\/a>, here<\/a> and here<\/a>, and a few more on the way), and ModelBuilder offers an alternative for those who don’t (or don’t want to) write script.\u00a0 In fact, all ModelBuilder is is a nice visual interface for creating Python scripts<\/a>.<\/p>\n

For those of you interested in the gory details (and you know who you are), the video below shows the whole process of building up and running this model.<\/p>\n

C<\/p>\n