Numeric Suffix

Purpose

This note defines how HAPI interprets numeric suffixes appended to Feature Codes.

A Numeric Suffix is a number appended after a Feature_Code to override default processing behaviour.

The suffix is interpreted by digit count.

Digit Count	Name	Meaning	Example
1	Sizing_Number	Exact number of points used to define an enclosing rectangle.	`CP3`, `BN3`, `UB3`
2	Clustering_Number	Logical group linking records that may be non-sequential.	`KX01`, `FB02`

Numeric suffixes remove ambiguity from conventional survey requirements.

They support:

Code	Interpretation
`CP3`	Catch Pit surveyed with three points for rectangular calculation.
`BN2`	Bench captured by two points, typically for linear dimension only.
`BN3`	Bench captured by three points for rectangular calculation.
`KX01`	Kerb Bottom cluster `01`.
`FB02`	Flower Bed cluster `02`, forming an irregular polygon.

A one-digit suffix is a sizing override.
A two-digit suffix is a clustering override.
Do not treat all numbers as the same type of suffix.
For suffix parsing, preserve leading zeroes in two-digit Clustering Numbers.
Do not convert 01 to integer 1 if the string form is needed for exact grouping.

Preferred planned functions:

Numeric suffix parsing should produce a structured result, for example:

Confirm how the parser should handle invalid numeric suffixes longer than two digits.