Commit 3e4a8bbe authored by Laurent Belcour's avatar Laurent Belcour
Browse files

Updating the format doc a bit

parent 1e1a799f
/*!
\page format Format
<h2>Common notations</h2>
_Warning: this document is currently not up to date and should not be followed._
Common notations
----------------
Data and function files have the same format. They are text file very close to dump.
Each file starts with a header containing :
Each file starts with a header containing information about the input and output space described. Every header line starts by a '#' symbol. The following information are described:
<h3> Parametrization format </h3>
- Whether the file describe a function or a data,
- Command line used to generate the file (optional),
- Input and output domain dimensions,
- Input domain parametrization,
- And output domain parametrization.
<ul>
<li> \verbatim #PARAM_IN input_parametrization_name \endverbatim </li>
<li> \verbatim #PARAM_OUT output_parametrization_name \endverbatim </li>
</ul>
Here is an exemple of a BRDF header:
#ALTA FUNC HEADER
#CMD --L2 0.0282467 --Linf 0.0935969 --fitter ./librational_fitter_parallel.dylib --input ../../data/1d/NIST/Kirby2/Kirby2.dat --output ../Kirb2.brdf
#DIM 1 1
#PARAM_IN UNKNOWN_INPUT
#PARAM_OUT UNKNOWN_OUTPUT
#ALTA HEADER END
Parametrization format
----------------------
- `#PARAM_IN input_parametrization_name`
- `#PARAM_OUT output_parametrization_name`
<h3>Input Parametrization</h3>
Input Parametrization
---------------------
ALTA can automaticaly convert samples (either data sample or BRDF
evaluation) into a different coordinate system. Here is a non-complete
list of possible parametrizations:
\verbatim
RUSIN_TH_PH_TD,
RUSIN_TH_TD_PD,
RUSIN_TH_PH_TD_PD,
COS_TH_TD, // cosine theta_h, cosine theta_d
ISOTROPIC_TV_TL_DPHI, // isotropic formulation with theta view, theta light and |dphi|
CARTESIAN, // 6D (directions: 3d + 3d)
SPHERICAL_TL_PL_TV_PV
ISOTROPIC_TV_PROJ_DPHI //2D Param. (theta_v * cos(|\delta \Phi|), theta_v * sin(|\delta \Phi)|)
\endverbatim
<h3> Output Parametrization </h3>
RUSIN_TH_PH_TD,
RUSIN_TH_TD_PD,
RUSIN_TH_PH_TD_PD,
COS_TH_TD, // cosine theta_h, cosine theta_d
ISOTROPIC_TV_TL_DPHI, // isotropic formulation with theta view, theta light and |dphi|
CARTESIAN, // 6D (directions: 3d + 3d)
SPHERICAL_TL_PL_TV_PV
ISOTROPIC_TV_PROJ_DPHI //2D Param. (theta_v * cos(|\delta \Phi|), theta_v * sin(|\delta \Phi)|)
Output Parametrization
----------------------
In the current version of ALTA, we cannot handle different output
parametrizations (like LAB color space). Fitting will be performed
......
......@@ -63,7 +63,7 @@ if compile_test:
#end
#cmake_cmd = 'cmake -DGLOG_LIB=' + build_dir + 'lib' + os.sep + libname + ' -DGLOG_INCLUDE=' + build_dir + 'include -DGFLAGS=OFF ' + '-DEIGEN_INCLUDE=' + build_dir + 'include -DCMAKE_INSTALL_PREFIX=' + build_dir + ' .' + ' -DDISABLE_TR1=ON -DBUILD_EXAMPLES=OFF ' + '-DBUILD_TESTING=OFF -DCMAKE_BUILD_TYPE=Release -DMINIGLOG=OFF'
cmake_cmd = 'cmake -DBUILD_SHARED_LIBS=OFF -DGLOG_LIB=' + build_dir + 'lib' + ' -DGLOG_INCLUDE=' + build_dir + 'include -DGFLAGS=OFF ' + '-DEIGEN_INCLUDE=' + build_dir + 'include -DCMAKE_INSTALL_PREFIX=' + build_dir + ' .' + ' -DDISABLE_TR1=ON -DBUILD_EXAMPLES=OFF ' + '-DBUILD_TESTING=OFF -DCMAKE_BUILD_TYPE=Release -DMINIGLOG=ON'
cmake_cmd = 'cmake -DBUILD_SHARED_LIBS=ON -DGLOG_LIB=' + build_dir + 'lib' + ' -DGLOG_INCLUDE=' + build_dir + 'include -DGFLAGS=OFF ' + '-DEIGEN_INCLUDE=' + build_dir + 'include -DCMAKE_INSTALL_PREFIX=' + build_dir + ' .' + ' -DDISABLE_TR1=ON -DBUILD_EXAMPLES=OFF ' + '-DBUILD_TESTING=OFF -DCMAKE_BUILD_TYPE=Release -DMINIGLOG=ON'
if os.name == 'nt':
ret = os.system(cmake_cmd + ' -G \"NMake Makefiles\"')
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment