r.null.html 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. <h2>DESCRIPTION</h2>
  2. The function of <em>r.null</em> is to explicitly create the NULL-value
  3. bitmap file. The intended usage is to fix "old" maps that don't have a
  4. NULL-value bitmap file (i.e. to indicate if zero is valid value or is to be
  5. converted to NULL). The module does not work with reclassified maps.
  6. <p>
  7. The design is flexible. Ranges of values can be set to NULL and/or the NULL
  8. value can be eliminated and replace with a specified value.
  9. <p>
  10. The <b>setnull</b> parameter is used to specify values in the ranges to
  11. be set to NULL. A range is either a single value (e.g., 5.3), or a pair of
  12. values (e.g., 4.76-34.56). Existing NULL-values are left NULL, unless the
  13. null argument is requested.
  14. <p>
  15. The <b>null</b> parameter eliminates the NULL value and replaces it with
  16. value. This argument is applied only to existing NULL values, and not to the
  17. NULLs created by the setnull argument.
  18. <h2>EXAMPLES</h2>
  19. Set specific values of a classified map to NULL:<br>
  20. <div class="code"><pre>
  21. r.null map=landcover.30m setnull=21,22
  22. </pre></div>
  23. Set NULL-values of a map to a specific value:<br>
  24. <div class="code"><pre>
  25. r.null map=fields null=99
  26. </pre></div>
  27. <h2>NOTES</h2>
  28. Note that value is restricted to integer if the map is an integer map.
  29. <p><em>r.null</em> and reclassified maps:<br>
  30. The problem is, if r.null was run on the reclass raster it would alter the
  31. original and any other reclass rasters of the original. Therefore r.null
  32. doesn't allow to recode reclassified maps (products of r.reclass).
  33. <br>
  34. So, the way to recode such a map is: The user makes a raster out of the
  35. reclass that isn't a reclass by copying it:<br>
  36. <div class="code"><pre>
  37. r.mapcalc newmap = reclass
  38. </pre></div>
  39. <h2>SEE ALSO</h2>
  40. <em><a href="r.support.html">r.support</a></em>
  41. and
  42. <em><a href="r.quant.html">r.quant</a></em>
  43. <h2>AUTHOR</h2>
  44. U.S.Army Construction Engineering Research Laboratory
  45. <p><i>Last changed: $Date$</i>