Understanding GIS: An ArcGIS Project Workbook for ArcGIS 10 Lesson 7: Automate the analysis Change the model layout and add metadata to the model. Book Resources are located here.
00:01 This is Lesson 7: Automate the analysis...
00:03 ...Exercise 7e, Document the model.
00:06 There are several things we can do to document the model...
00:09 ...to help explain it to other people.
00:11 Probably the main thing is to fill out the item description...
00:14 ...which provides basic metadata for the model...
00:16 ...just like the item description for a dataset.
00:19 Second, you can change the model layout to make it...
00:22 ...easier for someone to follow the workflow diagram.
00:25 This is pretty important when your model gets long.
00:27 Third, you can add labels to the model.
00:31 These are little comments or notes that might explain what a tool is doing, for example.
00:35 Fourth, you can generate a model report.
00:38 This is a comprehensive list of all the inputs, tools, and outputs...
00:41 ...in the model, and all their parameters.
00:43 This can really help you do a careful technical review of the model.
00:49 We’ll open the Lesson 7 map document, which we left zoomed in on a site.
00:54 In the Catalog window, we’ll right-click the model and choose Item Description.
00:58 The item description is going to store our essential metadata about the model.
01:04 We’ll click the Edit button and scroll down to the summary.
01:08 The summary for a tool should explain its basic purpose...
01:11 ...like what this tool accomplishes.
01:14 Usage normally provides details about how the tool works.
01:17 But we’re just letting the user know what the basic park selection criteria are.
01:22 Down here, in the Syntax area, you can explain what each parameter means.
01:27 We’re just filling out one example.
01:29 And we’ll add credits, because our model uses some specific datasets.
01:35 And we’ll save the item description and look it over.
01:39 It looks pretty good, so we’ll close it.
01:42 Now we’ll go back to the Catalog window and edit the model.
01:48 Do an Auto Layout and go to the full extent.
01:52 On the Model menu, we can open the Diagram Properties...
01:57 ...click the Layout tab, and change the orientation.
02:00 We might want the model to flow from top to bottom.
02:07 And then maybe we want do undo that.
02:10 Back in the Diagram Properties, on the General tab...
02:14 ...we can change the layout mode to Manual.
02:16 And then we can move the elements around however we want, and they’ll stay like that.
02:22 We’re going to select the first section of the model and drag it up here to the...
02:26 ...top of the window.
02:30 Now we’ll select another chunk and drag that underneath and offset it.
02:40 And then we’ll select this last bit and drag it over here.
02:46 We can manipulate our connector arrows, too. Put these little kinks in, like so.
02:55 And zoom in so the model fills the window.
02:58 Notice that Auto Layout doesn’t work. It’s disabled...
03:02 ...because we’re in Manual Layout mode.
03:04 Let’s save, and zoom in, and scroll up to the start of the model.
03:15 Notice that hovering over an element shows you inputs and parameters.
03:19 But that may not help someone who’s trying to figure out what the model is actually doing.
03:24 We'll add some labels, which are notes that can say whatever you want.
03:28 Right-click on an element and choose Create Label.
03:32 Unfortunately, it gets placed on top of a connector arrow. We have to...
03:35 ...unselect everything and then click on it again and drag it to a new place.
03:39 Now we can start typing.
03:41 “Sites within park buffers are excluded.”
03:44 Put in a line break.
03:46 And do the same thing down here to annotate this buffer output.
03:50 Now anybody looking at the model would know right away that these two buffers...
03:54 ...exclude sites that are near existing parks or far away from the river.
04:00 Now we’ll scroll over and create a label for the Proximity Zone output.
04:04 “Only sites in this area are considered.”
04:07 These are the acceptable geographic areas for a park.
04:10 So people kind of know what the model has accomplished by this point.
04:15 We’ll put a label on the Identity tool because it would be hard to know what this tool is doing.
04:20 This is where we stamp our acceptable geographic areas with...
04:23 ...demographic attributes.
04:25 We could add some more labels, but you get the idea.
04:31 Now we’ll tone the labels down a little bit because they’re too prominent.
04:35 Select them all, right-click on one of them, and choose Display properties.
04:42 If we click here next to the font name, a button appears...
04:46 ...and we click it to open the Font dialog box.
04:49 Change the style to Regular and the color to Gray.
04:53 Click OK. That looks better.
04:56 Unselect the labels.
04:59 We can also create a label from the Insert menu, and that...
05:02 ...becomes a free-floating label. It’s not attached to any particular element.
05:05 We’ll use it like a title for the model.
05:07 We’ll change its display properties to match the other labels, Regular and Gray...
05:13 ...but we'll make it a little bit bigger.
05:17 Zoom to the full extent.
05:19 We can also document the model with a report.
05:22 We go to the Model menu and choose Report. The report basically is a list...
05:26 ...of every input, output, and tool in the model, along with all their parameters.
05:30 It’s just another way to look at the contents of your model.
05:34 We can display it in a window on screen, like we’re doing here, or print it as a file.
05:38 Okay, let’s save and close.
05:41 You can look at previous runs of the model in the ArcMap Geoprocessing Results.
05:46 This gives you pretty much the same information as a report.
05:49 But it also includes your environment settings and messages...
05:52 ...about how long each operation took, and so on.
05:57 Finally, we’ll make a backup copy in case anything happens to the model.
06:01 Right-click the model, choose Copy, right-click the toolbox, and choose Paste.
06:06 And then rename it, maybe with a date stamp or something.
06:11 Exit ArcMap, and we’re done with ModelBuilder.
© Esri 2013 http://www.esri.com