← Back to branch summary

~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to scripts/i.colors.enhance/i.colors.enhance.html

Tags: 7.0.0~rc1+ds1-1~exp1
http://bugs.debian.org/776349
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
scripts/i.colors.enhance/i.colors.enhance.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>i.colors.enhance</em> auto-balances and enhances the color channels of a
 
4
RGB image (e.g. from Landsat) to provide a more natural color mixture. Only
 
5
the color table of each image band is modified, the base data remains untouched.
 
6
<p>
 
7
The module works by calculating a histogram for each color channel and 
 
8
removing an adjustable amount of outliers from either end before recalibrating
 
9
the color scale with <em>r.colors</em>.
 
10
<p>
 
11
<!-- limitation still true ? -->
 
12
It will work with any 8-bit RGB imagery set and the script is easily modified
 
13
to work with other datasets of greater band-depth.
 
14
 
 
15
<h2>NOTES</h2>
 
16
 
 
17
Depending on the image, it may or may not be advantageous to use the <b>-p</b>
 
18
flag to preserve the relative color scaling. You will have to experiment
 
19
with the different options to find a setting that works best for your
 
20
particular imagery.
 
21
<p>
 
22
The <b>strength</b> option should generally be set in the 90-99 range. The
 
23
lower the number, the more saturated the image becomes. It represents the
 
24
percentage cut-off for the top end of the color histogram curve. The lower
 
25
end is fixed at 2% of the area under the curve.
 
26
<p>
 
27
For quicker execution of this module on large images you can achieve largely
 
28
similar results by switching to a coarser resolution before the running of
 
29
the module (using <em>g.region</em>) and then back to the original resolution
 
30
afterwards.
 
31
 
 
32
<h2>EXAMPLE</h2>
 
33
 
 
34
North Carolina sample dataset example with Landsat data:
 
35
 
 
36
<div class="code"><pre>
 
37
g.region raster=lsat7_2002_10 -p
 
38
d.rgb blue=lsat7_2002_10 green=lsat7_2002_20 red=lsat7_2002_30
 
39
d.barscale at=55.3125,93.125 bcolor=white text_pos=over
 
40
 
 
41
i.colors.enhance blue=lsat7_2002_10 green=lsat7_2002_20 red=lsat7_2002_30 strength=95
 
42
d.rgb blue=lsat7_2002_10 green=lsat7_2002_20 red=lsat7_2002_30
 
43
d.barscale at=55.3125,93.125 bcolor=white text_pos=over
 
44
</pre></div>
 
45
 
 
46
<center>
 
47
<img src="i_col_enh_uncorr.jpg" alt="Uncorrected RGB composite of Landsat ETM channels B/G/R"><br>
 
48
Uncorrected RGB composite of Landsat ETM channels B/G/R
 
49
<p>
 
50
<img src="i_col_enh_corr.jpg" alt="Color corrected RGB composite of Landsat ETM channels B/G/R"><br>
 
51
Color corrected RGB composite of Landsat ETM channels B/G/R
 
52
</center>
 
53
 
 
54
<h2>TODO</h2>
 
55
 
 
56
The <b>strength</b> option requires further refinement.
 
57
 
 
58
<h2>SEE ALSO</h2>
 
59
 
 
60
<em>
 
61
<a href="d.rgb.html">d.rgb</a>,
 
62
<a href="g.region.html">g.region</a>,
 
63
<a href="i.oif.html">i.oif</a>,
 
64
<a href="r.colors.html">r.colors</a>,
 
65
<a href="r.composite.html">r.composite</a>,
 
66
<a href="r.univar.html">r.univar</a>
 
67
</em>
 
68
 
 
69
 
 
70
<h2>AUTHORS</h2>
 
71
 
 
72
Markus Neteler, Trento, Italy<br>
 
73
M. Hamish Bowman, Dept. Marine Science, Otago University, New Zealand
 
74
 
 
75
<p><i>Last changed: $Date: 2014-12-19 22:55:37 +0100 (Fri, 19 Dec 2014) $</i>