man/man1/falsecolor.1

.\" RCSid "$Id: falsecolor.1,v 1.13 2017/09/25 18:48:11 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 tbo
for the "turbo" 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.14
Committed:	Sun Aug 25 22:24:01 2019 UTC (5 years, 9 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R3
Changes since 1.13:	+3 -1 lines
Log Message:	Added "tbo" color map thanks to Taoning
#	User	Rev	Content
1	greg	1.14	.\" RCSid "$Id: falsecolor.1,v 1.13 2017/09/25 18:48:11 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	greg	1.14	.I tbo
127			for the "turbo" spectral mapping,
128	greg	1.7	.I hot
129	greg	1.10	for a thermal scale,
130			.I eco
131	greg	1.11	for a blue-red-yellow scale, and
132	greg	1.7	.I pm3d
133			for a variation of the default mapping,
134			.I def.
135	greg	1.9	A Radiance HDR image of all available palettes can be created with the
136			.I \-palettes
137			option.
138	greg	1.1	The remaining options,
139			.I "\-r, \-g,"
140			and
141			.I \-b
142			are for changing the mapping of values to colors.
143			These are expressions of the variable
144			.I v,
145			where
146			.I v
147			varies from 0 to 1.
148			These options are not recommended for the casual user.
149	greg	1.9	.PP
150	greg	1.1	If no
151			.I \-i
152			or
153			.I \-ip
154			option is used, input is taken from the standard input.
155			The output image is always written to standard output, which should
156			be redirected.
157	greg	1.9	.SH "EXAMPLES"
158	greg	1.1	To create a false color image directly from
159			.I rpict(1):
160			.IP "" .2i
161	greg	1.6	rpict \-vf default.vp scene.oct \| falsecolor > scene.hdr
162	greg	1.10	.PP
163			To show the available color palettes:
164			.IP "" .2i
165			falsecolor -palettes \| ximage
166	greg	1.9	.PP
167	greg	1.1	To create a logarithmic contour plot of illuminance values on a
168			Radiance image:
169			.IP "" .2i
170	greg	1.6	rpict \-i \-vf default.vp scene.oct > irrad.hdr
171	greg	1.9	.br
172	greg	1.6	rpict \-vf default.vp scene.oct > rad.hdr
173	greg	1.9	.br
174	greg	1.6	falsecolor \-i irrad.hdr \-p rad.hdr \-cl \-log 2 \-l Lux > lux.hdr
175	greg	1.9	.SH "AUTHOR"
176	greg	1.1	Greg Ward
177	greg	1.9	.br
178			Axel Jacobs (Perl translation and \-pal options)
179	greg	1.13	.br
180			David Geisler-Moroder & Stephen Wasilewski (Legend additions and improvements)
181	greg	1.9	.SH "ACKNOWLEDGEMENT"
182	greg	1.1	Work on this program was initiated and sponsored by the LESO
183	greg	1.10	group at EPFL in Switzerland. The 'eco' palette was sponsored by Foster + Partners in London.
184	greg	1.1	.SH "SEE ALSO"
185			getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1), pflip(1), protate(1),
186			psign(1), rpict(1), ximage(1)