Arc Label Messages

Introduction

In this page we will look at labelling the messages layer outputted by TUFLOW, to help in 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 Log Folder == <folder name>, this will be in the same directory as the .tcf (typically TUFLOW\runs\). Descri

Basic

To label the entire layer including all check, warning and error messages are displayed:

1. Ensure you have a messages_P.shp file open (and the layer contains messages).
2. Right click on the layer in the table of contents and select Label



3. 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.
   Tip: It may be necessary to allow overlapping labels in the placement properties to ensure that you can see all messages.

Label by Severity (check, warning, error)

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.
1. Ensure you have a messages_P.shp file open (and the layer contains messages).
2. Right click on the layer in the table of contents and select Label



3. 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.
4. In the Class section select the Add... option.
5. Add a class with name "CHECK"
6. Select SQL Query... to define the class. In the SQL Query window set the following in the select from dialogue:
   
   "Message" like '%CHECK%'
   
   Set the desired display options for "CHECK" type messages
7. Repeat the process for WARNING ("Message" like '%WARNING%') and ERROR ("Message" like '%ERROR%') messages, setting different styles for each type of message.
Now when messages are viewed these should be displayed with the styles set for check, warning and error type messages.



8. 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.


In the image below the check and warnings are not labelled, leaving only the error messages.