[GRASS-SVN] r69424 - in grass/branches/releasebranch_7_2/raster: . r.compress

svn_grass at osgeo.org svn_grass at osgeo.org
Fri Sep 9 13:38:52 PDT 2016


Author: neteler
Date: 2016-09-09 13:38:52 -0700 (Fri, 09 Sep 2016)
New Revision: 69424

Modified:
   grass/branches/releasebranch_7_2/raster/r.compress/r.compress.html
   grass/branches/releasebranch_7_2/raster/rasterintro.html
Log:
rasterintro.html + r.compress manual: further compression description cleanup

Modified: grass/branches/releasebranch_7_2/raster/r.compress/r.compress.html
===================================================================
--- grass/branches/releasebranch_7_2/raster/r.compress/r.compress.html	2016-09-09 20:37:44 UTC (rev 69423)
+++ grass/branches/releasebranch_7_2/raster/r.compress/r.compress.html	2016-09-09 20:38:52 UTC (rev 69424)
@@ -89,11 +89,12 @@
 <h3>COMPRESSION ALGORITHM DETAILS</h3>
 <!-- keep in sync with raster/rasterintro.html -->
 
-All types of raster maps are by default ZLIB compressed, i.e. the default
-ZLIB's deflate algorithm. The compression method can be set to RLE, ZLIB,
-LZ4, or BZIP2 with the environment variable <tt>GRASS_COMPRESSOR</tt>.
+All GRASS GIS raster map types are by default ZLIB compressed, i.e. using
+ZLIB's deflate algorithm. Through the environment variable
+<tt>GRASS_COMPRESSOR</tt> the compression method can be set to RLE, ZLIB,
+LZ4, or BZIP2.
 <p>
-Optionally integer (CELL type) raster maps can be compressed with RLE if
+Integer (CELL type) raster maps can be compressed with RLE if
 the environment variable <tt>GRASS_INT_ZLIB</tt> exists and is set to value 
 0. However, this is not recommended.
 <p>
@@ -107,7 +108,8 @@
 <dt><strong>RLE</strong></dt>
 <dd><b>DEPRECATED</b> Run-Length Encoding, poor compression ratio but 
 fast. It is kept for backwards compatibility to read raster maps 
-created with GRASS 6. It is only used for raster maps of type CELL. 
+created with GRASS 6. It is only used for raster maps of type CELL.
+FCELL and DCELL maps are never and have never been compressed with RLE.
 </dd>
 <dt><strong>ZLIB</strong></dt>
 <dd>ZLIB's deflate is the default compression method for all raster 
@@ -115,7 +117,7 @@
 best compromise betweeen speed and compression ratio, also when 
 compared to other available compression methods. Valid levels are in 
 the range [1, 9] and can be set with the environment variable 
-GRASS_ZLIB_LEVEL.</dd>
+<tt>GRASS_ZLIB_LEVEL</tt>.</dd>
 <dt><strong>LZ4</strong></dt>
 <dd>LZ4 is a very fast compression method, about as fast as no 
 compression. Decompression is also very fast. The compression ratio is 

Modified: grass/branches/releasebranch_7_2/raster/rasterintro.html
===================================================================
--- grass/branches/releasebranch_7_2/raster/rasterintro.html	2016-09-09 20:37:44 UTC (rev 69423)
+++ grass/branches/releasebranch_7_2/raster/rasterintro.html	2016-09-09 20:38:52 UTC (rev 69424)
@@ -279,47 +279,47 @@
 <h3>Raster compression</h3>
 <!-- keep in sync with raster/r.compress/r.compress.html -->
 
-GRASS raster maps are by default ZLIB compressed. If the environment 
-variable <tt>GRASS_INT_ZLIB</tt> exists and has the value 0, newly 
-generated compressed integer (CELL type) raster maps will be compressed 
-using RLE compression instead of ZLIB.
+
+All GRASS GIS raster map types are by default ZLIB compressed, i.e. using
+ZLIB's deflate algorithm. Through the environment variable
+<tt>GRASS_COMPRESSOR</tt> the compression method can be set to RLE, ZLIB,
+LZ4, or BZIP2.
 <p>
+Integer (CELL type) raster maps can be compressed with RLE if
+the environment variable <tt>GRASS_INT_ZLIB</tt> exists and is set to value 
+0. However, this is not recommended.
+<p>
 Floating point (FCELL, DCELL) raster maps never use RLE compression;
 they are either compressed with ZLIB, LZ4, BZIP2 or are uncompressed.
-<p>
-The compression method for raster maps is by default ZLIB's deflate 
-algorithm. The compression method can be set with the environment 
-variable GRASS_COMPRESSOR which can be set to RLE, ZLIB, LZ4, or BZIP2.
 
 <dl>
 <dt><strong>RLE</strong></dt>
 <dd><b>DEPRECATED</b> Run-Length Encoding, poor compression ratio but 
-fast. Kept for backwards compatibility to read raster maps created with 
-GRASS 6. Only used for raster maps of type CELL. FCELL and DCELL maps 
-are never and have never been compressed with RLE.</dd>
+fast. It is kept for backwards compatibility to read raster maps 
+created with GRASS 6. It is only used for raster maps of type CELL.
+FCELL and DCELL maps are never and have never been compressed with RLE.
+</dd>
 <dt><strong>ZLIB</strong></dt>
 <dd>ZLIB's deflate is the default compression method for all raster 
-maps. GRASS 7 uses by default 1 as ZLIB compression level which is the 
+maps. GRASS GIS 7 uses by default 1 as ZLIB compression level which is the 
 best compromise betweeen speed and compression ratio, also when 
 compared to other available compression methods. Valid levels are in 
 the range [1, 9] and can be set with the environment variable 
-GRASS_ZLIB_LEVEL.</dd>
+<tt>GRASS_ZLIB_LEVEL</tt>.</dd>
 <dt><strong>LZ4</strong></dt>
 <dd>LZ4 is a very fast compression method, about as fast as no 
-compression. The compression ration is generally higher than for RLE. 
-Decompression is also very fast. LZ4 is recommended if disk space is 
-not a limiting factor, but some sving on disk space is welcomed without 
-increasing processing speed. The compression ratio of LZ4 is generally 
-better than for RLE but worse than for ZLIB.</dd>
+compression. Decompression is also very fast. The compression ratio is 
+generally higher than for RLE but worse than for ZLIB. LZ4 is 
+recommended if disk space is not a limiting factor.</dd>
 <dt><strong>BZIP2</strong></dt>
-<dd>BZIP2 can provide compression ratios much higher than for the other 
+<dd>BZIP2 can provide compression ratios much higher than the other 
 methods, but only for large raster maps (> 10000 columns). For large 
 raster maps, disk space consumption can be reduced by 30 - 50% when 
 using BZIP2 instead of ZLIB's deflate. BZIP2 is the slowest compression 
 and decompression method. However, if reading from / writing to a 
 storage device is the limiting factor, BZIP2 compression can speed up 
 raster map processing. Be aware that for smaller raster maps, BZIP2 
-compression ratio can be worse than for other compression methods.</dd> 
+compression ratio can be worse than other compression methods.</dd> 
 </dl>
 
 <p>



More information about the grass-commit mailing list