man/man1/falsecolor.1

.\" RCSid "$Id: falsecolor.1,v 1.11 2013/04/04 15:13:42 greg Exp $"
.TH "FALSECOLOR" "1" "12/12/11" "RADIANCE" ""
.SH "NAME"
falsecolor \- make a false color RADIANCE picture
.SH "SYNOPSIS"
.B falsecolor
[
.B "\-i input"
][
.B "\-p picture"
][
.B "\-cb | \-cl | \-cp"
][
.B \-e
][
.B "\-s scale"
][
.B "\-d digits"
][
.B "\-l label"
][
.B "\-n ndivs"
][
.B "\-lw lwidth"
][
.B "\-lh lheight"
][
.B "\-log decades"
][
.B "\-m mult"
][
.B "\-pal palette"
][
.B "\-r redv"
][
.B "\-g grnv"
][
.B "\-b bluv"
]

.B falsecolor \-palettes
.SH "DESCRIPTION"
.I Falsecolor
produces a false color picture for lighting analysis.
Input is a rendered Radiance picture.
.PP 
By default, luminance is displayed on a linear scale from 0 to 1000 cd/m2, where
dark areas are purple and brighter areas move through blue, green, red to yellow.
A different scale can be given with the
.I \-s
option.
If the argument given to
.I \-s
begins with an "a" for "auto," then the maximum is used for scaling the result.
The default multiplier is 179, which converts from radiance or irradiance
to luminance or illuminance, respectively.
A different multiplier can be given with
.I \-m
to get daylight factors or whatever.
For a logarithmic rather than a linear mapping, the
.I \-log
option can be used, where
.I decades
is the number of decades below the maximum scale desired.
.PP 
The 
.I \-d 
option controls the max number of decimal places printed for legend
entries. The default is 3 decimal places.
.PP 
A legend is produced for the new image with a label given by the
.I \-l
option.
The default label is "cd/m2", which is appropriate for standard Radiance
images.
If the
.I \-i
option of
.I rpict(1)
was used to produce the image, then the appropriate label would be "Lux".
.PP 
If contour lines are desired rather than just false color, the
.I \-cl
option can be used.
These lines can be placed over another Radiance picture using the
.I \-p
option.
If the input picture is given with
.I \-ip
instead of
.I \-i,
then it will be used both as the source of values and as the picture
to overlay with contours.
The
.I \-cb
option produces contour bands instead of lines, where the thickness of
the bands is related to the rate of change in the image.
The
.I \-cp
option creates a posterization effect where colours are banded without
the background image showing through.
The
.I \-n
option can be used to change the number of contours (and corresponding
legend entries) from the default value of 8.
The
.I \-lw
and
.I \-lh
options may be used to change the legend dimensions from the default width
and height of 100x200.
A value of zero in either eliminates the legend in the output.
.PP 
The
.I \-e
option causes extrema points to be printed on the brightest and
darkest pixels of the input picture.
.PP 
The
.I "\-pal"
option provides different color palettes for
.I falsecolor.
The current choices are
.I spec
for the old spectral mapping,
.I hot
for a thermal scale,
.I eco
for a blue-red-yellow scale, and
.I pm3d
for a variation of the default mapping,
.I def.
A Radiance HDR image of all available palettes can be created with the 
.I \-palettes
option.
The remaining options,
.I "\-r, \-g,"
and
.I \-b
are for changing the mapping of values to colors.
These are expressions of the variable 
.I v,
where
.I v
varies from 0 to 1.
These options are not recommended for the casual user.
.PP 
If no
.I \-i
or
.I \-ip
option is used, input is taken from the standard input.
The output image is always written to standard output, which should
be redirected.
.SH "EXAMPLES"
To create a false color image directly from
.I rpict(1):
.IP "" .2i
rpict \-vf default.vp scene.oct | falsecolor > scene.hdr
.PP
To show the available color palettes:
.IP "" .2i
falsecolor -palettes | ximage
.PP 
To create a logarithmic contour plot of illuminance values on a
Radiance image:
.IP "" .2i
rpict \-i \-vf default.vp scene.oct > irrad.hdr
.br 
rpict \-vf default.vp scene.oct > rad.hdr
.br 
falsecolor \-i irrad.hdr \-p rad.hdr \-cl \-log 2 \-l Lux > lux.hdr
.SH "AUTHOR"
Greg Ward
.br 
Axel Jacobs (Perl translation and \-pal options)
.br
David Geisler-Moroder & Stephen Wasilewski (Legend additions and improvements)
.SH "ACKNOWLEDGEMENT"
Work on this program was initiated and sponsored by the LESO
group at EPFL in Switzerland. The 'eco' palette was sponsored by Foster + Partners in London.
.SH "SEE ALSO"
getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), protate(1),
psign(1), rpict(1), ximage(1)
Revision:	1.13
Committed:	Mon Sep 25 18:48:11 2017 UTC (7 years, 8 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R2
Changes since 1.12:	+9 -5 lines
Log Message:	Improvements to falsecolor legend by David G-M and Stephen W
#	User	Rev	Content
1	greg	1.12	.\" RCSid "$Id: falsecolor.1,v 1.11 2013/04/04 15:13:42 greg Exp $"
2	greg	1.9	.TH "FALSECOLOR" "1" "12/12/11" "RADIANCE" ""
3			.SH "NAME"
4			falsecolor \- make a false color RADIANCE picture
5			.SH "SYNOPSIS"
6	greg	1.1	.B falsecolor
7			[
8			.B "\-i input"
9			][
10			.B "\-p picture"
11			][
12	greg	1.9	.B "\-cb \| \-cl \| \-cp"
13	greg	1.1	][
14			.B \-e
15			][
16			.B "\-s scale"
17			][
18	greg	1.13	.B "\-d digits"
19			][
20	greg	1.1	.B "\-l label"
21			][
22			.B "\-n ndivs"
23			][
24	greg	1.3	.B "\-lw lwidth"
25			][
26			.B "\-lh lheight"
27			][
28	greg	1.1	.B "\-log decades"
29			][
30			.B "\-m mult"
31			][
32	greg	1.7	.B "\-pal palette"
33	greg	1.4	][
34	greg	1.1	.B "\-r redv"
35			][
36			.B "\-g grnv"
37			][
38			.B "\-b bluv"
39			]
40	greg	1.9
41			.B falsecolor \-palettes
42			.SH "DESCRIPTION"
43	greg	1.1	.I Falsecolor
44			produces a false color picture for lighting analysis.
45			Input is a rendered Radiance picture.
46	greg	1.9	.PP
47			By default, luminance is displayed on a linear scale from 0 to 1000 cd/m2, where
48			dark areas are purple and brighter areas move through blue, green, red to yellow.
49	greg	1.1	A different scale can be given with the
50			.I \-s
51			option.
52	greg	1.4	If the argument given to
53			.I \-s
54			begins with an "a" for "auto," then the maximum is used for scaling the result.
55	greg	1.1	The default multiplier is 179, which converts from radiance or irradiance
56			to luminance or illuminance, respectively.
57			A different multiplier can be given with
58			.I \-m
59			to get daylight factors or whatever.
60			For a logarithmic rather than a linear mapping, the
61			.I \-log
62			option can be used, where
63			.I decades
64			is the number of decades below the maximum scale desired.
65	greg	1.9	.PP
66	greg	1.13	The
67			.I \-d
68			option controls the max number of decimal places printed for legend
69			entries. The default is 3 decimal places.
70			.PP
71	greg	1.1	A legend is produced for the new image with a label given by the
72			.I \-l
73			option.
74	greg	1.9	The default label is "cd/m2", which is appropriate for standard Radiance
75	greg	1.1	images.
76			If the
77	greg	1.9	.I \-i
78	greg	1.1	option of
79			.I rpict(1)
80			was used to produce the image, then the appropriate label would be "Lux".
81	greg	1.9	.PP
82	greg	1.1	If contour lines are desired rather than just false color, the
83			.I \-cl
84			option can be used.
85			These lines can be placed over another Radiance picture using the
86	greg	1.9	.I \-p
87	greg	1.1	option.
88			If the input picture is given with
89			.I \-ip
90			instead of
91			.I \-i,
92			then it will be used both as the source of values and as the picture
93			to overlay with contours.
94			The
95			.I \-cb
96			option produces contour bands instead of lines, where the thickness of
97			the bands is related to the rate of change in the image.
98			The
99	greg	1.9	.I \-cp
100			option creates a posterization effect where colours are banded without
101			the background image showing through.
102			The
103	greg	1.1	.I \-n
104			option can be used to change the number of contours (and corresponding
105			legend entries) from the default value of 8.
106	greg	1.3	The
107			.I \-lw
108			and
109			.I \-lh
110			options may be used to change the legend dimensions from the default width
111			and height of 100x200.
112			A value of zero in either eliminates the legend in the output.
113	greg	1.9	.PP
114	greg	1.1	The
115			.I \-e
116			option causes extrema points to be printed on the brightest and
117			darkest pixels of the input picture.
118	greg	1.9	.PP
119	greg	1.4	The
120	greg	1.7	.I "\-pal"
121			option provides different color palettes for
122	greg	1.4	.I falsecolor.
123	greg	1.7	The current choices are
124			.I spec
125			for the old spectral mapping,
126			.I hot
127	greg	1.10	for a thermal scale,
128			.I eco
129	greg	1.11	for a blue-red-yellow scale, and
130	greg	1.7	.I pm3d
131			for a variation of the default mapping,
132			.I def.
133	greg	1.9	A Radiance HDR image of all available palettes can be created with the
134			.I \-palettes
135			option.
136	greg	1.1	The remaining options,
137			.I "\-r, \-g,"
138			and
139			.I \-b
140			are for changing the mapping of values to colors.
141			These are expressions of the variable
142			.I v,
143			where
144			.I v
145			varies from 0 to 1.
146			These options are not recommended for the casual user.
147	greg	1.9	.PP
148	greg	1.1	If no
149			.I \-i
150			or
151			.I \-ip
152			option is used, input is taken from the standard input.
153			The output image is always written to standard output, which should
154			be redirected.
155	greg	1.9	.SH "EXAMPLES"
156	greg	1.1	To create a false color image directly from
157			.I rpict(1):
158			.IP "" .2i
159	greg	1.6	rpict \-vf default.vp scene.oct \| falsecolor > scene.hdr
160	greg	1.10	.PP
161			To show the available color palettes:
162			.IP "" .2i
163			falsecolor -palettes \| ximage
164	greg	1.9	.PP
165	greg	1.1	To create a logarithmic contour plot of illuminance values on a
166			Radiance image:
167			.IP "" .2i
168	greg	1.6	rpict \-i \-vf default.vp scene.oct > irrad.hdr
169	greg	1.9	.br
170	greg	1.6	rpict \-vf default.vp scene.oct > rad.hdr
171	greg	1.9	.br
172	greg	1.6	falsecolor \-i irrad.hdr \-p rad.hdr \-cl \-log 2 \-l Lux > lux.hdr
173	greg	1.9	.SH "AUTHOR"
174	greg	1.1	Greg Ward
175	greg	1.9	.br
176			Axel Jacobs (Perl translation and \-pal options)
177	greg	1.13	.br
178			David Geisler-Moroder & Stephen Wasilewski (Legend additions and improvements)
179	greg	1.9	.SH "ACKNOWLEDGEMENT"
180	greg	1.1	Work on this program was initiated and sponsored by the LESO
181	greg	1.10	group at EPFL in Switzerland. The 'eco' palette was sponsored by Foster + Partners in London.
182	greg	1.1	.SH "SEE ALSO"
183			getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), protate(1),
184			psign(1), rpict(1), ximage(1)