View source for Arc Label Messages

=Introduction=
In this page we will look at labelling the messages layer outputted by TUFLOW, to help identify issues with a TUFLOW model.  The messages_P.shp file is written to the log directory, if this is not defined using the .tcf command <font color="blue"><tt>Log Folder </tt></font> <font color="red"><tt>==</tt></font><tt> <folder name></tt>, this will be in the same directory as the .tcf (typically TUFLOW\runs\).<br>
In this page we cover labelling the messages in two different ways:
* A single label style
* Using classes which allows the check, warning and error messages can be labelled separately and with different label styles.
=Basic=
To label the entire layer including all check, warning and error messages:<br>
<ol>
<li>Ensure you have a messages_P.shp file open (and the layer contains messages).</li>
<li>Right click on the layer in the table of contents and select '''Label'''</li>
<br>
[[File:Arc Label Basic1.jpg|350px]]
<br>
<li>Open the layer properties, by right clicking on the layer in the table of contents and selecting properties.  Navigate to the '''Labels''' Tab, set the desired label style and placement.<br>
'''Tip:''' It may be necessary to allow overlapping labels in the placement properties to ensure that you can see all messages.</li>
[[File:Arc Label Basic2.jpg|600px]]
<br>
</ol>
=Label by Severity (check, warning, error)=
<ol>
When there are numerous messages, it is nice to be able to differentiate the messages based on the the severity.  There are three levels of messages outputted by TUFLOW in increasing order of severity these are:
* [[CHECK]]
* [[WARNING]]
* [[ERROR]]
To label these differently in ArcMap the following process can be used.
<li>Ensure you have a messages_P.shp file open (and the layer contains messages).</li>
<li>Right click on the layer in the table of contents and select '''Label'''.</li>
<br>
[[File:Arc Label Basic1.jpg|350px]]
<br>
<li>Open the layer properties, by right clicking on the layer in the table of contents and selecting properties.  Navigate to the '''Labels''' Tab.  In the Method Option, from the drop box select '''Define Classes of features and label each class differently'''.</li>
<li>In the '''Class''' section select the '''Add...''' option.</li>
<li>Add a class with name "CHECK".</li>
<li>Set the desired display options for "CHECK" type messages.</li>
[[File:Arc Label Adv01.jpg|600px]]
<br><br>
<li>Select '''SQL Query...''' to define the class.  In the SQL Query window set the following in the select from dialogue:<br>
<tt>"Message" like '%CHECK%'</tt><br>
This is shown in the image below.
<br>
[[File:Arc Label Adv02.jpg|350px]]
<br><br>
</li>
<li>Repeat the process for WARNING ("Message" like '%WARNING%') and ERROR ("Message" like '%ERROR%') messages, setting different styles for each type of message.</li>
Now when messages are viewed these should be displayed with the styles set for check, warning and error type messages.
<br>
[[File:Arc Label Adv03.jpg|600px]]
<br><br>
<li>It is possible to turn off labels for certain classes, for example to see the labels for error messages.  To do this in the Labels dialogue, select the classes you wish to hide and uncheck the '''Label Features in this class''' option.</li>
[[File:Arc Label Adv04.jpg|600px]]
<br><br>
In the image below the check and warnings are not labelled, leaving only the error messages.
<br>
[[File:Arc Label Adv05.jpg|600px]]
<br>