====== 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 [[ego_script#calculator_functor_shorthand|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 =====

[[Functor List#Map Algebra | Map Algebra]]

===== 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