man/man1/pabopto2xyz.1

.\" RCSid "$Id: pabopto2xyz.1,v 1.2 2021/06/21 17:19:01 greg Exp $"
.TH PABOPTO2XYZ 1 3/1/2021 RADIANCE
.SH NAME
pabopto2xyz - convert a collection of single-channel BSDF measurements to CIE-XYZ colorimetry
.SH SYNOPSIS
.B pabopto2xyz
[
.B "\-m X1 X2 X3 Y1 Y2 Y3 Z1 Z2 Z3"
][
.B "\-o basename"
][
.B "\-n nprocs"
]
.B "s1files.txt s2files.txt s3files.txt"
.SH DESCRIPTION
.I Pabopto2xyz
takes three sets of standard single-channel BSDF files, each
measured with a different light source and/or sensor filter to select
different wavelengths, combining them into an equivalent set of 3-channel BSDF data
files with CIE-XYZ colorimetry.
The 3x3 transform from the input file measurements to CIE XYZ color space is
set by the
.I \-m
option.
The default coefficients correspond to a specific set of filters in use at LBNL,
and are probably not applicable to any other instrument.
.PP
The
.I \-o
option is used to set the base output file name, which defaults to "pabopto_xyz".
To this base name, the theta and phi angles are added, along with a ".txt" suffix.
.PP
The
.I \-n
option may be supplied on Unix systems for multiple processes to speed up
the conversion.
.PP
The BSDF measurement file names must be listed in
the three required input files,
dileneated in each by white space.
File names or paths therein may not contain white space, and quoting/escaping
is not supported.
The same incident directions must be provided in all three measurement sets,
but may be broken into different files.
(I.e., two or more BSDF files may correspond to the same incident direction.)\0
Only one file will be produced for each incident direction in the output.
.PP
.I Pabopto2xyz
works by resampling the second and third input channels to correspond to the
exiting directions measured in the first channel.
A 2-D interpolant is applied at each incident direction for channels 2 and 3,
the given 3x3 matrix is applied,
and a combined virtual measurement is produced in output files beginning with
the given base name.
For this reason, it is often preferably to place the "green" or "near-Y"
channel first.
.PP
The combined data files produced by
.I pabopto2xyz
are subsequently passed to
.I pabopto2bsdf(1)
to produce a Scattering Interpolant Representation (SIR) file for further
processing.
.SH EXAMPLE
To combine three sets of measurements in a REC709 color space and produce
a CIE-XYZ file for pabopto2bsdf, which produces a color SIR file:
.IP "" .2i
pabopto2xyz -m .358 .412 .180 .715 .213 .072 .119 .019 .951 -o blinds_xyz filesG.txt filesR.txt filesB.txt
.br
pabopto2bsdf blinds_xyz*.txt > blinds_xyz.sir
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
bsdf2klems(1), bsdf2rad(1), bsdf2ttree(1), bsdfview(1), genBSDF(1),
pabopto2bsdf(1)
Revision:	1.3
Committed:	Fri Apr 11 20:54:38 2025 UTC (3 weeks, 1 day ago) by greg
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.2:	+9 -6 lines
Log Message:	docs(pabopto2xyz): Wording improvements
#	User	Rev	Content
1	greg	1.3	.\" RCSid "$Id: pabopto2xyz.1,v 1.2 2021/06/21 17:19:01 greg Exp $"
2	greg	1.1	.TH PABOPTO2XYZ 1 3/1/2021 RADIANCE
3			.SH NAME
4			pabopto2xyz - convert a collection of single-channel BSDF measurements to CIE-XYZ colorimetry
5			.SH SYNOPSIS
6			.B pabopto2xyz
7			[
8			.B "\-m X1 X2 X3 Y1 Y2 Y3 Z1 Z2 Z3"
9			][
10			.B "\-o basename"
11			][
12			.B "\-n nprocs"
13			]
14			.B "s1files.txt s2files.txt s3files.txt"
15			.SH DESCRIPTION
16			.I Pabopto2xyz
17			takes three sets of standard single-channel BSDF files, each
18			measured with a different light source and/or sensor filter to select
19			different wavelengths, combining them into an equivalent set of 3-channel BSDF data
20			files with CIE-XYZ colorimetry.
21			The 3x3 transform from the input file measurements to CIE XYZ color space is
22			set by the
23			.I \-m
24			option.
25			The default coefficients correspond to a specific set of filters in use at LBNL,
26			and are probably not applicable to any other instrument.
27			.PP
28			The
29			.I \-o
30			option is used to set the base output file name, which defaults to "pabopto_xyz".
31			To this base name, the theta and phi angles are added, along with a ".txt" suffix.
32			.PP
33			The
34			.I \-n
35			option may be supplied on Unix systems for multiple processes to speed up
36			the conversion.
37			.PP
38	greg	1.3	The BSDF measurement file names must be listed in
39			the three required input files,
40	greg	1.1	dileneated in each by white space.
41	greg	1.3	File names or paths therein may not contain white space, and quoting/escaping
42	greg	1.1	is not supported.
43	greg	1.3	The same incident directions must be provided in all three measurement sets,
44			but may be broken into different files.
45	greg	1.1	(I.e., two or more BSDF files may correspond to the same incident direction.)\0
46			Only one file will be produced for each incident direction in the output.
47			.PP
48			.I Pabopto2xyz
49			works by resampling the second and third input channels to correspond to the
50			exiting directions measured in the first channel.
51			A 2-D interpolant is applied at each incident direction for channels 2 and 3,
52			the given 3x3 matrix is applied,
53			and a combined virtual measurement is produced in output files beginning with
54			the given base name.
55	greg	1.3	For this reason, it is often preferably to place the "green" or "near-Y"
56			channel first.
57	greg	1.1	.PP
58			The combined data files produced by
59			.I pabopto2xyz
60			are subsequently passed to
61			.I pabopto2bsdf(1)
62			to produce a Scattering Interpolant Representation (SIR) file for further
63			processing.
64			.SH EXAMPLE
65			To combine three sets of measurements in a REC709 color space and produce
66			a CIE-XYZ file for pabopto2bsdf, which produces a color SIR file:
67			.IP "" .2i
68	greg	1.3	pabopto2xyz -m .358 .412 .180 .715 .213 .072 .119 .019 .951 -o blinds_xyz filesG.txt filesR.txt filesB.txt
69	greg	1.1	.br
70			pabopto2bsdf blinds_xyz*.txt > blinds_xyz.sir
71			.SH AUTHOR
72			Greg Ward
73			.SH "SEE ALSO"
74			bsdf2klems(1), bsdf2rad(1), bsdf2ttree(1), bsdfview(1), genBSDF(1),
75	greg	1.2	pabopto2bsdf(1)