Calculate Categorical Map
Description
Computes a new categorical raster map by evaluating an algebraic or logical expression independently for every cell of the output map. Functionally identical to Calculate Map — the same inputs, parameters, and expression language apply — except that its output is typed as a categorical map, preserving category semantics for downstream functors that distinguish categorical maps from continuous ones (e.g. Calc Areas, For Each Category). Use this functor when the expression produces integer class codes; use Calculate Map instead for continuous or measured values.
This is one of Dinamica EGO's five calculator functors. Its abbreviated (shorthand) syntax is ##. See Calculator functor shorthand in the EGO Script documentation for the verbose and abbreviated forms, and Calculate Functors — Complete Operator Documentation for the full expression language reference.
Inputs
| Name | Type | Description |
|---|---|---|
| Expression | Image Expression Type | Algebraic or logical formula used to compute each output cell's category code. Must be enclosed in square brackets [ ] in EGO Script. |
Optional Inputs
| Name | Type | Description | Default Value |
|---|---|---|---|
| Cell Type | Cell Type Type | Data type for each output cell. | Signed 32 Bit Integer |
| Null Value | Null Value Type | Sentinel value representing “no data” in the output. | .default |
| Result Is Sparse | Boolean Value Type | If true, only non-null cells are stored, saving memory at the expense of random-access speed. This is an advanced port. | No |
| Result Format | Map Type | Reference map whose spatial format (extent, resolution, projection) is applied to the output; its category information, if any, is ignored. Prefer this port over a Number Map hook when a map is needed only for format purposes, since a hook defines an identifier in the expression namespace and blocks abbreviated syntax if that identifier goes unused in the expression. This is an advanced port. | .none |
Outputs
| Name | Type | Description |
|---|---|---|
| Result | Categorical Map Type | Computed categorical output map. Its dimensions come from the connected input maps, or from Result Format when given. |
Group
Notes
All behavior — hook functor wiring, shared-cell evaluation and image virtualization across connected maps, null propagation, and the requirement that at least one map or Result Format be provided — is identical to Calculate Map. See that functor's Notes for full details.
See Calculate Functors — Complete Operator Documentation for the complete expression language, null-value handling rules, and worked examples.
Internal Name
CalculateCategoricalMap