Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
calc_destination_map [2011/05/16 23:15]
hermann created
calc_destination_map [2015/10/12 01:17] (current)
admin [Description]
Line 4: Line 4:
  
 This functor calculates destination cells taking into account some measure of attraction, as depicted on an attractiveness map. Non-null value cells represent selected destination cells. This functor calculates destination cells taking into account some measure of attraction, as depicted on an attractiveness map. Non-null value cells represent selected destination cells.
 +
 +<note important>​This functor is outdated and its use should be avoid. Prefer the use of [[Select Random Points]], [[Select Random Point Cluster]], [[Patcher]] or [[Expander]]</​note>​
  
 ===== Inputs ===== ===== Inputs =====
  
-^ Name                  ^ Type                                  ^ Description ​                                                                 +^ Name  ^ Type  ^ Description ​ 
-| Attraction ​           | [[Map Type | Map]]                    | Attractiveness map. Values equal to or less than zero will be ignored. ​      ​+| Attraction ​ | [[Map Type]] ​ | Attractiveness map. Values equal to or less than zero will be ignored. ​ 
-| Horizontal Quadrants ​ | [[Positive ​Int Type | Positive Int]]  | Number of horizontal segments into which the attractiveness map is divided. ​ | +| Horizontal Quadrants ​ | [[Positive ​Integer Value Type]] ​ | Number of horizontal segments into which the attractiveness map is divided. ​ | 
-| Vertical Quadrants ​   | [[Positive ​Int Type | Positive Int]]  | Number of vertical segments into which the attractiveness map is divided. ​   |+| Vertical Quadrants ​ | [[Positive ​Integer Value Type]] ​ | Number of vertical segments into which the attractiveness map is divided. ​ |
  
 ===== Optional Inputs ===== ===== Optional Inputs =====
  
-^ Name                                   ​^ Type                                           ​^ Description ​                                                                                                                                                      ​^ Default Value           ​+^ Name  ^ Type  ^ Description ​ ^ Default Value  
-| Minimum Distance Between Destinations ​ | [[Non Negative ​Int Type | Non Negative Int]]   ​| Minimum distance buffer between adjacent destinations,​ in meters, is used as a constraint to impede the selection of additional destinations within this buffer. ​ | 0                       ​+| Minimum Distance Between Destinations ​ | [[Non Negative ​Integer Value Type]] ​ | Minimum distance buffer between adjacent destinations,​ in meters, is used as a constraint to impede the selection of additional destinations within this buffer. ​ | 0  
-| Maximum Attempts Per Destinations ​     | [[Positive ​Int Type | Positive Int]]           ​| Maximum number of draws realized in order to pinpoint a valid destination. ​                                                                                       | 15                      +| Maximum Attempts Per Destinations ​ | [[Positive ​Integer Value Type]] ​ | Maximum number of draws realized in order to pinpoint a valid destination. ​ | 15  
-| Destinations Per Quadrant ​             | [[Non Negative ​Int Type | Non Negative Int]]   | Maximum number of destinations chosen in each map quadrant. ​                                                                                                      ​| 1                       ​+| Destinations Per Quadrant ​ | [[Non Negative ​Integer Value Type]] ​  | Maximum number of destinations chosen in each map quadrant. ​ | 1  
-| Cell Type                              | [[Cell Type Type | Cell Type]] ​                ​| Data cell type of the output map.                                                                                                                                 ​| Unsigned 8 Bit Integer ​ | +| Cell Type  | [[Cell Type Type]] ​ | Data cell type of the output map.  | Unsigned 8 Bit Integer ​ | 
-| Null Value                             ​| [[Int Type | Int]]                             ​| Null value of the output map.                                                                                                                                     ​| 0                       ​+| Null Value  | [[Integer Value Type]] ​ | Null value of the output map.  | 0  
-| Destination Is Sparse ​                 | [[Bool Type | Bool]]                           ​| If true, map of destination is represented as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have worse access time.  | True  |+| Destination Is Sparse ​ | [[Boolean Value Type]] ​ | If true, map of destination is represented as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have worse access time.  | True  |
  
 ===== Outputs ===== ===== Outputs =====
  
-^ Name         ​^ Type                ^ Description ​                                                                                                                                              ​+^ Name  ^ Type  ^ Description ​ 
-| Destination ​ | [[Map Type | Map]]  | Map depicting destination cells. Destination cells are depicted using their attractiveness value. Map has the same dimensions of the attractiveness map.  |+| Destination ​ | [[Map Type]] ​ | Map depicting destination cells. Destination cells are depicted using their attractiveness value. Map has the same dimensions of the attractiveness map.  |
  
 ===== Group ===== ===== Group =====
  
-Map Algebra+[[Functor List#Map Algebra ​| Map Algebra]]
  
 ===== Notes ===== ===== Notes =====
Line 38: Line 40:
  
 The attractiveness map must have integer values. The attractiveness map must have integer values.
 +
 +[{{ :​road_destinations_example.png?​nolink&​600 |Example calculating destinations used by road construction simulation}}]
  
 ===== Internal Name ===== ===== Internal Name =====