cat_range

syntax

cat_range(valuetype*, startvalue, endvalue)

* optional

definition

range(valuetype, startvalue, endvalue) sets the range for a categorical-unit with arguments:

valuetype, the optional value-type for the configured unit
startvalue, the lowest value of the allowed range
endvalue, the highest value of the allowed range

The cat_range function configures a half open range. This means the value of argument: startvalue is the first value that is part of the range. Argument endvalue is the first value that falls outside the given range.

description

It can also be used for two-dimensional domain units, grid domains, with a value-type of the pointGroup;
all arguments can be configured explicitly, but can also be the results of calculations.
the startvalue argument can be different than the default value of 0.

applies to

literal or parameter valuetype can be any value type.
literals or parameters startvalue and endvalue of the configured valuetype argument

example

uint32 domain unit

unit<uint32> Province := cat_range(uint32, 1, 13)
{
   attribute<.> id := id(.);
}

Or shorter:

unit<uint32> Province := cat_range(1, 13)
{
   attribute<.> id := id(.);
}

Province/id
1
2
3
4
5
6
7
8
9
10
11
12

domain Province, nr of rows = 12

spoint domain unit

unit<spoint> GridDomain := cat_range(spoint, point(10s, 14s), point(15s, 19s))
{ 
   attribute<.> id := id(.);
}

GridDomain/id


(10,14)	(10,15)	(10,16)	(10,17)	(10,18)
(11,14)	(11,15)	(11,16)	(11,17)	(11,18)
(12,14)	(12,15)	(12,16)	(12,17)	(12,18)
(13,14)	(13,15)	(13,16)	(13,17)	(13,18)
(14,14)	(14,15)	(14,16)	(14,17)	(14,18)

GridDomain, nr of rows = 6, nr of cols = 5