Skip to content

Contourable Points

The ContourablePointsConfig file controls which survey points are included in surface generation (contours and DTM). Only points listed in this file — and matching the specified attribute conditions — are treated as contourable.

The file is located at: %APPDATA%\SpatialViz\ContourablePoints\<ConfigName>_ContourablePointsConfig.txt

Open it from R3MANAGECONFIGS → Edit Contourable Points.

File format

Each line is a comma-separated rule with nine columns:

CODE,A1,A2,A3,A4,A5,A6,A7,A8

Use * as a wildcard — it matches any value, including an empty value.

# All KERB points are contourable regardless of attributes
KERB,*,*,*,*,*,*,*,*

# Only BLD points where A4 = Bottom are contourable
BLD,*,*,*,Bottom,*,*,*,*

# COMPIT points are contourable only at specific positions
COMPIT,*,Corner (Top),*,*,*,*,*,*
COMPIT,*,Centre (Top),*,*,*,*,*,*

Rules:

  • Lines beginning with # are comments and are ignored
  • Each rule is evaluated independently — a point is contourable if it matches any rule for its code
  • Attribute matching is case-insensitive
  • Short lines (fewer than nine columns) are padded with * for the missing attributes

How it works

When R3Survey draws a survey run, it checks each point against this file. Points that do not match any rule are excluded from surface datasets — they will not influence contour generation or DTM triangulation.

This is the "whitelist" side of surface control. The complement is BreaklineLayers, which defines which drawn string layers act as surface breaklines.

Note that PointStyleConfig also has a DeleteElevation() action that removes the Z coordinate from individual points — that is a per-point override whereas ContourablePointsConfig is a code-level filter.

Example (from R3Survey2025 configuration)

# CODE,A1,A2,A3,A4,A5,A6,A7,A8
BANK,*,*,*,*,*,*,*,*
BLD,*,*,*,Bottom,*,*,*,*          # only ground-level building corners
CABINET,*,*,Bottom,*,*,*,*,*
CHNL,*,*,*,*,*,*,*,*
COMPIT,*,Corner (Top),*,*,*,*,*,*
COMPIT,*,Centre (Top),*,*,*,*,*,*
CONC,*,*,*,*,*,*,*,*
DD,*,*,*,*,*,*,*,*
EPIT,*,Corner (Top),*,*,*,*,*,*
EPIT,*,Centre (Top),*,*,*,*,*,*
FCE,*,*,*,Bottom,*,*,*,*          # fence bottom only
KERB,*,*,*,*,*,*,*,*
MH,*,*,*,*,*,*,*,*
SUB,*,Ground,*,*,*,*,*,*          # only ground-mounted substations
TR,*,*,*,*,*,*,*,*
WALL,*,*,*,*,Bottom,*,*,*         # wall base only

Tips

  • Use attribute conditions to exclude mid-shots and top-of-feature points that should not drive contours (e.g. only include BLD points at A4 = Bottom, not Top or Mid)
  • A code not listed in this file is simply never contourable — there is no need to explicitly exclude it
  • A point can be excluded at draw time using DeleteElevation() in PointStyleConfig even if its code appears here — DeleteElevation() takes precedence