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:23...demographic attributes.

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.