Transition Matrix Type

A Transition Matrix defines the rate at which cells transition from one category to another over a period of time. Each entry gives a From category, a To category, and a rate — the proportion of From cells that transition to To over that period. The rates for a given From category sum to 1 across all its entries, including the stationary (From = To) entry representing the proportion that doesn't change; that stationary rate is generally the complement of the others for the same From rather than something specified independently.

Determine Transition Matrix calculates one directly from a pair of calibration maps: given an initialLandscape, a finalLandscape, and a timeSteps count, it returns a singleStepMatrix (rates for the entire calibrated period) and a multiStepMatrix (rates normalized to one time unit, suitable for driving an iterative simulation). Calc Change Matrix is the typical consumer: given a Transition Matrix and the current landscape, it converts each entry's proportional rate into an absolute Change Matrix entry — the actual number of cells to change, based on the landscape's current class areas.

The transition matrix editor presents a table with fixed From/To/Rate columns.

A Transition Matrix constant has its own dedicated syntax in EGO Script. Each entry is written FROM→TO RATE, with FROM and TO as integers joined directly by → with no space, followed by the rate as a real number. Commas between entries are optional. This example gives class 1 a 90% chance of remaining class 1 and a 10% chance of becoming class 2, while class 2 always remains class 2:

[
  1->1 0.9,
  1->2 0.1,
  2->2 1.0
]

• Converted from: Lookup Table Type and Table Type — the table must have the columns From* (Real), To* (Real), and Rate (Real).

• Converted to: Lookup Table Type and Table Type, using that same column layout.

See Type System for the complete conversion reference across all types.