00:01This is Lesson 7: Automate the analysis...
00:03...Exercise 7e, Document the model.
00:06There are several things we can do to document the model...
00:09...to help explain it to other people.
00:11Probably 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:19Second, you can change the model layout to make it...
00:22...easier for someone to follow the workflow diagram.
00:25This is pretty important when your model gets long.
00:27Third, you can add labels to the model.
00:31These are little comments or notes that might explain what a tool is doing, for example.
00:35Fourth, you can generate a model report.
00:38This is a comprehensive list of all the inputs, tools, and outputs...
00:41...in the model, and all their parameters.
00:43This can really help you do a careful technical review of the model.
00:49We’ll open the Lesson 7 map document, which we left zoomed in on a site.
00:54In the Catalog window, we’ll right-click the model and choose Item Description.
00:58The item description is going to store our essential metadata about the model.
01:04We’ll click the Edit button and scroll down to the summary.
01:08The summary for a tool should explain its basic purpose...
01:11...like what this tool accomplishes.
01:14Usage normally provides details about how the tool works.
01:17But we’re just letting the user know what the basic park selection criteria are.
01:22Down here, in the Syntax area, you can explain what each parameter means.
01:27We’re just filling out one example.
01:29And we’ll add credits, because our model uses some specific datasets.
01:35And we’ll save the item description and look it over.
01:39It looks pretty good, so we’ll close it.
01:42Now we’ll go back to the Catalog window and edit the model.
01:48Do an Auto Layout and go to the full extent.
01:52On the Model menu, we can open the Diagram Properties...
01:57...click the Layout tab, and change the orientation.
02:00We might want the model to flow from top to bottom.
02:07And then maybe we want do undo that.
02:10Back in the Diagram Properties, on the General tab...
02:14...we can change the layout mode to Manual.
02:16And then we can move the elements around however we want, and they’ll stay like that.
02:22We’re going to select the first section of the model and drag it up here to the...
02:26...top of the window.
02:30Now we’ll select another chunk and drag that underneath and offset it.
02:40And then we’ll select this last bit and drag it over here.
02:46We can manipulate our connector arrows, too. Put these little kinks in, like so.
02:55And zoom in so the model fills the window.
02:58Notice that Auto Layout doesn’t work. It’s disabled...
03:02...because we’re in Manual Layout mode.
03:04Let’s save, and zoom in, and scroll up to the start of the model.
03:15Notice that hovering over an element shows you inputs and parameters.
03:19But that may not help someone who’s trying to figure out what the model is actually doing.
03:24We'll add some labels, which are notes that can say whatever you want.
03:28Right-click on an element and choose Create Label.
03:32Unfortunately, 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:39Now we can start typing.
03:41“Sites within park buffers are excluded.”
03:44Put in a line break.
03:46And do the same thing down here to annotate this buffer output.
03:50Now 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:00Now we’ll scroll over and create a label for the Proximity Zone output.
04:04“Only sites in this area are considered.”
04:07These are the acceptable geographic areas for a park.
04:10So people kind of know what the model has accomplished by this point.
04:15We’ll put a label on the Identity tool because it would be hard to know what this tool is doing.
04:20This is where we stamp our acceptable geographic areas with...
04:25We could add some more labels, but you get the idea.
04:31Now we’ll tone the labels down a little bit because they’re too prominent.
04:35Select them all, right-click on one of them, and choose Display properties.
04:42If we click here next to the font name, a button appears...
04:46...and we click it to open the Font dialog box.
04:49Change the style to Regular and the color to Gray.
04:53Click OK. That looks better.
04:56Unselect the labels.
04:59We 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:05We’ll use it like a title for the model.
05:07We’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:17Zoom to the full extent.
05:19We can also document the model with a report.
05:22We 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:30It’s just another way to look at the contents of your model.
05:34We can display it in a window on screen, like we’re doing here, or print it as a file.
05:38Okay, let’s save and close.
05:41You can look at previous runs of the model in the ArcMap Geoprocessing Results.
05:46This gives you pretty much the same information as a report.
05:49But it also includes your environment settings and messages...
05:52...about how long each operation took, and so on.
05:57Finally, we’ll make a backup copy in case anything happens to the model.
06:01Right-click the model, choose Copy, right-click the toolbox, and choose Paste.
06:06And then rename it, maybe with a date stamp or something.
06:11Exit ArcMap, and we’re done with ModelBuilder.
Exercise 7e: Document the model
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.
- Recorded: Oct 31st, 2011
- Runtime: 06:20
- Views: 8022
- Published: Dec 2nd, 2011
- Night Mode (Off)Automatically dim the web site while the video is playing. A few seconds after you start watching the video and stop moving your mouse, your screen will dim. You can auto save this option if you login.
- HTML5 Video (Off) Play videos using HTML5 Video instead of flash. A modern web browser is required to view videos using HTML5.