Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
load_map [2013/07/10 16:14]
admin [Optional Inputs]
load_map [2013/09/26 20:28]
admin [Notes]
Line 15: Line 15:
 | Null Value  | [[Null Value Type|Null Value]] ​ | Additional value used to represent null cells. Cells with such value are also treated as null cells. This is particularly useful for assigning a null value to image files that do not have this definition. ​ | None  | | Null Value  | [[Null Value Type|Null Value]] ​ | Additional value used to represent null cells. Cells with such value are also treated as null cells. This is particularly useful for assigning a null value to image files that do not have this definition. ​ | None  |
 | Load As Sparse ​ | [[Bool Type|Bool]] ​ | If true, the map is loaded as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have worse access time.  | False  | | Load As Sparse ​ | [[Bool Type|Bool]] ​ | If true, the map is loaded as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have worse access time.  | False  |
 +| Suffix Digits ​ | [[Non Negative Int Type|Non Negative Int]]  | Number of digits used to represent the image file name suffix. ​ | 0  |
 | Step  | [[Non Negative Int Type|Non Negative Int]]  | Current step or model iteration. Files with the same name and numbered suffixes will be loaded sequentially according to the model step.  | None  | | Step  | [[Non Negative Int Type|Non Negative Int]]  | Current step or model iteration. Files with the same name and numbered suffixes will be loaded sequentially according to the model step.  | None  |
 | Workdir ​ | [[Workdir Type|Workdir]] ​ | Workdir folder path.  | None  | | Workdir ​ | [[Workdir Type|Workdir]] ​ | Workdir folder path.  | None  |
Line 29: Line 30:
  
 See also [[Load Categorical Map]] for loading maps whose cells represent categories. See also [[Load Categorical Map]] for loading maps whose cells represent categories.
 +
 +If the "Null Value" parameter is specified, any cell corresponding to the original null value of the map, if provided, is converted to the new null value. This ensures that values originally represented by null value still representing null values, even if the null value definition changes. Any non-null value corresponding to the newly defined null value is also promoted to new null value.
  
 For a list of file formats that Load Map can load, the supported [[wp>​Map_projection|projections]] and [[wp>​Datum_(geodesy)|datums]],​ check the [[supported map formats#​map_formats_supported_for_reading|supported map formats]]. For a list of file formats that Load Map can load, the supported [[wp>​Map_projection|projections]] and [[wp>​Datum_(geodesy)|datums]],​ check the [[supported map formats#​map_formats_supported_for_reading|supported map formats]].
 +
 +It is possible to load maps from [[wp>​zip_(file_format)|Zip]] archives. See [[useful_tips#​loading_files_from_zip_files|this useful tip]] to know how to do it.
 ===== Internal Name ===== ===== Internal Name =====
  
 LoadMap LoadMap