********************************************************************************
***  Evaluation of Feature Point Detection in High Dynamic Range Imagery     ***
********************************************************************************

* AUTHOR: Bronislav Přibyl, ipribyl@fit.vutbr.cz
          at
          Brno University of Technology
          Faculty of Information Technology
          Department of Computer Graphics and Multimedia

* RELEASED: 2013-02-13


* DESCRIPTION:
Set of Matlab scripts for evaluation of the repeatability rate of Feature Point (FP) detectors in images, particularly in High Dynamic Range (HDR) images. The scripts are able to generate other image formats (e.g. tone mapped imagery) from the HDR images, calibrate the camera throughout image sequences, detect the FPs and evaluate the FP detection.
It is possible to add custom image formats and FP detectors (beside the detectors present in the Computer Vision System Toolbox for Matlab). Call custom FP detector from the detFP() function in the generateFP.m file. Sample data can be downloaded from <http://www.fit.vutbr.cz/~ipribyl/prods.php?id=296> or from <http://www.fit.vutbr.cz/~ipribyl/FPinHDR/>.
If you publish any work which is based on or contains this software, please be so kind and cite our paper"Přibyl, B., Chalmers, A.,
Zemčík, P.: Feature Point Detection under Extreme Lighting Conditions, In:
Spring Conference on Computer Graphics, Smolenice, SK, UNIBA, 2012, p. 156-163,
ISBN 978-80-223-3211-8".

BibTex entry:
@INPROCEEDINGS{
   author = {Bronislav Přibyl and Alan Chalmers and Pavel Zemčí­k},
   title = {Feature Point Detection under Extreme Lighting Conditions},
   pages = {156--163},
   booktitle = {Spring Conference on Computer Graphics},
   year = {2012},
   location = {Smolenice, SK},
   publisher = {Comenius University in Bratislava},
   ISBN = {978-80-223-3211-8},
   language = {english}
}


* REQUIREMENTS:
- Matlab 2011 or newer
- Computer Vision System Toolbox for Matlab <http://www.mathworks.com/products/computer-vision/>
- Camera Calibration Toolbox for Matlab <http://www.vision.caltech.edu/bouguetj/calib_doc/>
- Camera Pose Estimation from Dot Pattern set of Matlab scripts <http://george-vogiatzis.org/calib/>
- some of MATLAB Functions for Multiple View Geometry <http://www.robots.ox.ac.uk/~vgg/hzbook/code/>
- to use the FAST detector which is used in the demo script, you also need the code from <http://www.edwardrosten.com/work/fast.html> (version 2.1 was used)

- je možné přidat vlastní FP detektory, jako příklad je přidaný FAST7
- přidej volání svého FP detectoru do generateFP do funkce detFP

- data pro vyzkoušení např. na (přibalena) nebo na (dataset k paperu)

* LICENSE:

BUT OPEN SOURCE LICENCE Version 1.
Copyright (c) 2013, Brno University of Technology, Antonínská 548/1, 601 90, Czech Republic

BY INSTALLING, COPYING OR OTHER USES OF SOFTWARE YOU ARE DECLARING THAT YOU AGREE WITH THE TERMS AND CONDITIONS OF THIS LICENCE AGREEMENT. IF YOU DO NOT AGREE WITH THE TERMS AND CONDITIONS, DO NOT INSTAL, COPY OR USE THE SOFTWARE.

IF YOU DO NOT POSESS A VALID LICENCE, YOU ARE NOT AUTHORISED TO INSTAL, COPY OR OTHERWISE USE THE SOTWARE.

Definitions:

For the purpose of this agreement, Software shall mean a computer program (a group of computer programs functional as a unit) capable of copyright protection and accompanying documentation.

Work based on Software shall mean a work containing Software or a portion of it, either verbatim or with modifications and/or translated into another language, or a work based on Software. Portions of work not containing a portion of Software or not based on Software are not covered by this definition, if it is capable of independent use and distributed separately.

Source code shall mean all the source code for all modules of Software, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable program. Source code distributed with Software need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable program runs.

Anyone who uses Software becomes User. User shall abide by this licence agreement.

BRNO UNIVERSITY OF TECHNOLOGY GRANTS TO USER A LICENCE TO USE SOFTWARE ON THE FOLLOWING TERMS AND CONDITIONS:

    User may use Software for any purpose, commercial or non-commercial, without a need to pay any licence fee.
    User may copy and distribute verbatim copies of executable Software with source code as he/she received it, in any medium, provided that User conspicuously and appropriately publishes on each copy an appropriate copyright notice and disclaimer of warranty; keeps intact all the notices that refer to this li-cence and to the absence of any warranty; and give any other recipients of Software a copy of this licence along with Software. User may charge a fee for the physical act of transferring a copy, and may offer war-ranty protection in exchange for a fee.
    User may modify his/her copy or copies of Software or any portion of it, thus forming a work based on Software, and copy and distribute such modifications or work, provided that User clearly states this work is modified Software. These modifications or work based on software may be distributed only under the terms of section 2 of this licence agreement, regardless if it is distributed alone or together with other work. Previous sentence does not apply to mere aggregation of another work not based on software with Software (or with a work based on software) on a volume of a storage or distribution medium.
    User shall accompany copies of Software or work based on software in object or executable form with:
    a) the complete corresponding machine-readable source code, which must be distributed on a medium customarily used for software interchange; or,
    b) written offer, valid for at least three years, to give any third party, for a charge no more than actual cost of physically performing source distribution, a complete machine-readable copy of the corres-ponding source code, to be distributed on a medium customarily used for software interchange; or,
    c) the information User received as to the offer to distribute corresponding source code. (This alterna-tive is allowed only for noncommercial distribution and only if User received the program in objects code or executable form with such an offer, in accord with subsection b above.)
    User may not copy, modify, grant sublicences or distribute Software in any other way than expressly pro-vided for in this licence agreement. Any other copying, modifying, granting of sublicences or distribution of Software is illegal and will automatically result in termination of the rights granted by this licence. This does not affect rights of third parties acquired in good faith, as long as they abide by the terms and conditions of this licence agreement.
    User may not use and/or distribute Software, if he/she cannot satisfy simultaneously obligations under this licence and any other pertinent obligations.
    User is not responsible for enforcing terms of this agreement by third parties.
    BECAUSE SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING, BUT PROVIDES SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,EITHER EXPRESSED OR IMPLIED,INCLUDING,BUT NOT LIMITED TO,THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICU-LAR PURPOSE.THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF SOFT-WARE IS WITH USER. SHOULD SOFTWARE PROVE DEFECTIVE, USER SHALL ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL BRNO UNIVERSITY OF TECHNOLOGY BE LIABLE FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF SOFTWARE TO OPERATE WITH ANY OTHER PROGRAMS).

Final provisions:

Any provision of this licence agreement that is prohibited, unenforceable, or not authorized in any jurisdiction shall, as to such jurisdiction, be ineffective to the extent of such prohibition, unenforceability, or non-authorization without invalidating or affecting the remaining provisions.

This licence agreement provides in essentials the same extent of rights as the terms of GNU GPL version 2 and Software fulfils the requirements of Open Source software.

This agreement is governed by law of the Czech Republic. In case of a dispute, the jurisdiction shall be that of courts in the Czech Republic.

By installing, copying or other use of Software User declares he/she has read this terms and conditions, understands them and his/her use of Software is a demonstration of his/her free will absent of any duress.

*** end of file README.TXT ***
