Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
calculate_map [2013/08/13 20:03] admin [Notes] |
calculate_map [2022/08/19 23:49] (current) admin [Notes] |
||
---|---|---|---|
Line 7: | Line 7: | ||
===== Inputs ===== | ===== Inputs ===== | ||
- | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
- | | Expression | [[Image Expression Type | Image Expression]] | Algebraic or logical expression used to calculate the output map. | | + | | Expression | [[Image Expression Type]] | Algebraic or logical expression used to calculate the output map. | |
===== Optional Inputs ===== | ===== Optional Inputs ===== | ||
^ Name ^ Type ^ Description ^ Default Value ^ | ^ Name ^ Type ^ Description ^ Default Value ^ | ||
- | | Cell Type | [[Cell Type Type | Cell Type]] | Data cell type | Signed 32 Bit Integer | | + | | Cell Type | [[Cell Type Type]] | Data cell type | Signed 32 Bit Integer | |
- | | Null Value | [[Null Value Type | Null Value]] | Null value | Default((Based on the value of the Cell Type input.)) | | + | | Null Value | [[Null Value Type]] | Null value | Default((Based on the value of the Cell Type input.)) | |
- | | Result Is Sparse | [[Bool Type | Bool]] | If true, the resulting map is created as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have diminished access time. | False | | + | | Result Is Sparse | [[Boolean Value Type]] | If true, the resulting map is created as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have diminished access time. | False | |
- | | Result Format | [[Map Type| Map]] | Map representing the output format. Any category information presents in the given map is not used as part of the map format. | None | | + | | Result Format | [[Map Type]] | Map representing the output format. Any category information presents in the given map is not used as part of the map format. | None | |
===== Outputs ===== | ===== Outputs ===== | ||
- | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
- | | Result | [[Map Type | Map]] | Output map. | | + | | Result | [[Map Type]] | Output map. | |
===== Group ===== | ===== Group ===== | ||
Line 35: | Line 36: | ||
^ Example ^ Analysis ^ | ^ Example ^ Analysis ^ | ||
- | | <code cpp>i1 / 0</code> | The expression always results in null value. | | + | | <code cpp>i1 / 0</code> | The expression always results in null value (division by zero). | |
| <code cpp>i1 + i2 / i3 ^ 3</code> | If the current cell of any of the images involved in the calculation is null value, the expression results in null value . | | | <code cpp>i1 + i2 / i3 ^ 3</code> | If the current cell of any of the images involved in the calculation is null value, the expression results in null value . | | ||
| <code cpp>if isNull(i1) then | | <code cpp>if isNull(i1) then | ||
Line 55: | Line 56: | ||
The maps used by the "Calculate Map" must be provided by a corresponding [[Number Map]], the tables must be provided by a corresponding [[Number Table]] and the values must be provided by a corresponding [[Number Value]]. | The maps used by the "Calculate Map" must be provided by a corresponding [[Number Map]], the tables must be provided by a corresponding [[Number Table]] and the values must be provided by a corresponding [[Number Value]]. | ||
+ | |||
+ | For additional information about how the null values are handled during image and value calculation, see [[Image Expression Null Value Handling|this reference]]. | ||
===== Internal Name ===== | ===== Internal Name ===== | ||
CalculateMap | CalculateMap | ||
- |