Tutorial manual for CLUES 1.4
Basic functions
Getting started
1. Follow the instructions above to register CLUES 1.4 and start ArcMap or ArcView v. 9.2. Click Start Menu under the CLUES toolbar to open the CLUES 1.4 toolbox.
2. Open the sample map document Clues_waikato9.2.mxd in the CLUES 1.4 directory.

3. The table of contents (TOC) window should be open with the Display tab selected. Layers are displayed on the map if the check boxes are ticked. Legends can be displayed or hidden by expanding (+) or the minimising (-) the respective layer. Layers are drawn on the map following the layer tree hierarchy with the upper layers in the TOC overlaying those below.
4. The CLUES layers in their recommended order are as follows:
| Layer | Description | Checked to Visible (Y/N) |
|---|---|---|
| streams | Displays model results for the selected river reach(es) and tributaries. Gives legend when N and P yields / loads are mapped as river lines. | N – automatically activated when river lines are mapped. |
| HydroEdge | Defines stream network for tracing nutrients upstream. | Y |
| lcmask | Interactive sketch overlay polygon layer. | N – checked manually when creating new land use polygons. |
| catchment | Displays model results for the selected river reach (and tributaries) sub-catchment(s). Gives legend for watershed mapping and bar charts. | Y - Activated for watershed maps and bar charts. Automatically deactivated when river lines are mapped. |
| terminal | Terminal nodes for stream network. | N |
| def_luse_waik | Stores the default land use attributes for the sub-catchments in the correct format and order for modelling in CLUES 1.4. The example here is for Waikato. | N |
| luv2_dominant | Reference layer showing dominant land use. | N |
| nzcoast | Sets background and masks lower layers. Delineates land and sea. | Y |
| Total_N_leach_risk | Total nitrogen loss risk based on soils. This layer is rasterised (i.e., displayed as pixels and is masked by the nzcoast layer. It can be displayed as a dockable window (Section 5.1.3). | Y |
Note that a red exclamation mark (!) displayed next to a layer in the TOC means that ArcMap cannot not find the layer – this is caused by the directory pathway for the layer being incorrectly recorded or failing to update.
![]()
To reconnect the layer, right click on the layer name in the TOC and select Properties to bring up the Layer Properties dialogue box and click on the Source tab. Make a note the source file (in the example below, nz_tnlri).
Click on the Set Data Source button and browse to your CLUES folder. Select the correct file. Click the Add button to reconnect the layer.

Click OK in the Layer Properties dialogue box to finalise the connection.
Selecting river reaches
CLUES 1.4 allows river reaches and their associated sub-catchments to be selected in three ways:
• single river start reaches;
• multiple river start reaches; and
• multiple terminal reaches (i.e., catchments).
Single and multiple river start reaches
The flag tool selects river reaches and associated sub-catchments upstream of the selection point, these are known as start reaches. If the flag tool is clicked at the terminal reach (i.e., at the mouth of the selected stream at the receiving water), the entire catchment with all associated tributaries and sub-catchments will be selected.
For this example, several river reaches located to the south of Raglan Harbour are selected in turn and as a group.
1. Click the Flag icon under the Reach selection tools, the cursor will change into a flag accordingly.
2. Place the cursor next to a river reach. Clicking will select the reach and upstream tributaries. The flag will snap to the nearest reach and a red tag will be placed at the selection point.

NOTE, ArcGIS will highlight the selected stream network (light blue is default selection colour above). This highlight can be removed without deselecting the stream network to be simulated in CLUES 1.4 using the Clear selected features command under the ArcGIS Selection menu.
3. Multiple selections can be made by clicking other reaches.

4. The selected river reach(es) can be removed by clicking the Deselect river reaches icon under the Reach selection tools.

5. Clicking at the mouth or terminal reach of a stream will select the entire catchment.

Terminal reaches
CLUES 1.4 allows multiple selection of entire catchments. Drawing a terminal reach selection polygon enables fast selection of streams flowing into a harbour, lake or other receiving environment. In this example, the catchments flowing into the south of Raglan Harbour will be selected as a group.
1. Click the Catchment selection polygon icon under the Reach selection tools. The cursor will change into a hand with cross-piece.

2. Position the cursor near the reaches to be selected. Click to start drawing the polygon. Drag and click the cursor to create a selection polygon – vertices are created at each click position.

Double click to complete the terminal reach selection polygon.

3. All catchments with a terminal reach in the polygon will be selected and the terminal reaches tagged with a cerise tag.

NOTE, ArcGIS will highlight the selected stream network (light blue is default selection colour above). This enables users to visualise the area to be simulated. The highlight can be removed without deselecting the stream network to be simulated in CLUES 1.4 using the Clear selected features command under the ArcGIS Selection menu.
4. The selected river reach(es) can be removed by clicking the Deselect river reaches icon under the Reach selection tools.

Running the model
The CLUES 1.4 modelling framework consists of a suite of models which are run concurrently. Each model run for a particular land use scenario will over-ride the results of the previous run for that scenario, for example if a new catchment selection is made.
For this example, the streams flowing into the southern part of Raglan Harbour are simulated.
1. Select the river reaches to be modelled using the instructions above.
2. Select the land use scenario for the simulation from the Scenario # drop down menu under the CLUES tools. At this stage of the process, only the default or current land use (Scenario 0) is available (see Section 6.1 for scenario creation).
3. Click the RUN button under CLUES tools. The simulation time will vary depending on the area to be modelled. The status bar at the bottom left hand corner of the ArcGIS screen will give information about the simulation progress.

4. The default display is a watershed map of cumulative N loads for the selected river reaches (i.e., displayed as sub-catchments). The catchment layer will automatically be activated in the TOC with the legend expanded for display.
NOTE: if the stream network is highlighted by ArcGIS, this can be switched off for display without removing the CLUES 1.4 selection tags by clicking the Clear selected features command under the ArcGIS Selection menu. The tags can be removed for display by deselecting within CLUES 1.4, however, the reaches will need to be reselected for later runs.

Trouble shooting
If the following error occurs, you will need to change the ArcMap default settings to successfully run CLUES 1.4. You will need administrative privileges.

1. Close ArcMap. In Explorer, navigate to the ArcGIS Utilities directory and open AdvancedArcMapSettings.exe.

2. Select the Editor tab and set the Jet engine max # records option to 60000.

Then click the Raster tab and set the Maximum number of attribute table entries option to 65536.
Click the Apply button and close the dialogue box.

3. Open ArcMap and re-run CLUES 1.4.
Contact for Enquiries
MAF Information Services
Pastoral House
25 The Terrace
PO Box 2526
Wellington, NEW ZEALAND
Fax: +64 4 894 0721
Contact this person
