Disclaimer for Video-based Automated System for Iris Recognition (VASIR)   
 (Beta implementation version 1.0)

December 15, 2010

The software was developed by the National Institute of Standards and Technology (NIST), 
an agency of the Federal Government. Pursuant to Title 15 United States Code Section 105, 
works of NIST are not subject to copyright protection in the United States and are considered 
to be in the public domain. Thus, the software may be freely reproduced and used. 
Please explicitly acknowledge the National Institute of Standards and Technology 
as the source of the software.
This software is released by NIST as a service and is expressly provided "AS IS." 
NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR STATUTORY, 
INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, 
AND FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT AND DATA ACCURACY. 
NIST DOES NOT REPRESENT OR WARRANT THAT THE OPERATION OF THE SOFTWARE 
WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT ANY DEFECTS WILL BE CORRECTED.
Certain trade names and company products are mentioned in the text or identified. 
In no case does such identification imply recommendation or endorsement by 
the National Institute of Standards and Technology, nor does it imply that the products 
are necessarily the best available for the purpose.
With the exception of material marked as copyrighted, information presented in this document 
is considered public information and may be distributed or copied.
 Use of appropriate by line/photo/image credits is requested.



* Configuration
The tool has been tested under following operating systems:
- Microsoft Windows XP Professional Edition
- Microsoft Windows Server 2008
- Microsoft Windows 7 (x86)

The recommended minimum display resolution is 1280 x 1024 pixels.
Prerequisites

* Qt UI framework 
Download the latest version at: http://qt.nokia.com/downloads

* OpenCV Library
Download version 1.0 from http://opencv.willowgarage.com/wiki/InstallGuide

* Visual Studio Pro 2005 or 2008
After the installation, please update the Microsoft Visual C++ 2005 (or 2008) Redistributable Package (x86).
The user may be required to install the VsQtAddIn_2005 (or 2008).msi to integrate Qts UI tool into Visual Studio. Please refer to the addins website at http://mm-werkstatt.informatik.uni-augsburg.de/Volker-Wiendl.html.

More recent version of Qt supports the Visual Studio addin out-of-the-box; we did not test the updated Qt addin with this source code. Please have a look at http://qt.nokia.com/.

* You may choose to use a different operating environment (e.g. Mac and Linux). However, the installation steps might vary depending on your configuration. 
 
* Installation
 VASIR_Beta_v0.1
Download the executable file and source code at: http://www.nist.gov/itl/iad/ig/vasir.cfm

The following steps exemplify the installation with Visual Studio Pro 2005 in Windows XP for the developer: 

 Qt, OpenCV, and VS2005 with Windows XP
1. Create the folder C:\Qt
2. Extract qt-win-opensource-src-version.zip into C:\Qt\
3. Add QTDIR ..\Qt\bin\ to the Path Environment variable:
    System Settings > System > Advanced > Environment variables
4. Open the Visual Studio Command prompt
5. Change the path to C:\Qt\
6. Run configure platform win32-msvc2005
7. Run nmake

8. Create the folder C:\OpenCV\
9. Run OpenCV_1.0.exe into C:\OpenCV\

10. Start Visual Studio 2005
11. Check the path of your Visual Studio version, click Solution YooIRIS, and open  
      Properties > Common Properties > Debug Source Files
12. Open Tools > Options > Projects and Solutions > VC++ Directories
  12.1 Add the following components into Include directories:
      C:\OpenCV\cv\include
      C:\OpenCV\cxcore\include
      C:\OpenCV\cvaux\include
      C:\OpenCV\otherlibs\highgui
      C:\Qt\include
  12.2. Add the following components into "Library files":
      C:\OpenCV\lib
      C:\Qt\lib
  12.3. Add the following components into "Source files":
      C:\OpenCV\cv\src\
      C:\OpenCV\cxcore\src
      C:\OpenCV\cvaux\src
      C:\OpenCV\otherlibs\highgui
13. Click the YooIRIS project and change the Qt version from Properies > C/C++ and
       Linker
14. Close Visual Studio 2005

15. Install VsQtAddIn_2005.msi to 
    "..\Visual Studio 2005\Addins\"
  

The following steps exemplify the installation with Visual Studio Pro 2008 in Windows 7: 

 Qt, OpenCV, and VS2008 with Windows 7
1. Create the folder C:\Qt
2. Extract qt-win-opensource-src-version.zip into C:\Qt\
3. Add QTDIR ..\Qt\bin\ to the Path Environment variable:
    System Settings > System > Advanced > Environment variables
4. Open the Visual Studio Command prompt
5. Change the path to C:\Qt\
6. Run configure platform win32-msvc2008
7. Run nmake

8. Create the folder C:\OpenCV\
9. Run OpenCV_1.0.exe into C:\OpenCV\

10. Start Visual Studio 2008
11. Check the path of your Visual Studio version, click Solution YooIRIS, and open  
      Properties > Common Properties > Debug Source Files
      e.g., change Microsoft Visual Studio 8 to Microsoft Visual Studio 9
12. Open Tools > Options > Projects and Solutions > VC++ Directories
  12.1 Add the following components into Include directories:
      C:\OpenCV\cv\include
      C:\OpenCV\cxcore\include
      C:\OpenCV\cvaux\include
      C:\OpenCV\otherlibs\highgui
      C:\Qt\include
  12.2. Add the following components into "Library files":
      C:\OpenCV\lib
      C:\Qt\lib
  12.3. Add the following components into "Source files":
      C:\OpenCV\cv\src\
      C:\OpenCV\cxcore\src
      C:\OpenCV\cvaux\src
      C:\OpenCV\otherlibs\highgui
13. Click the YooIRIS project and change the Qt version from Properies > C/C++ and
       Linker
14. Close Visual Studio 2008

15. Install VsQtAddIn_2008.msi to 
    "..\Visual Studio 2008\Addins\"

 
 VASIR Source code
1. Download VASIR_Beta1.0 and open the source code
2. Select YooIRIS.ui andModeDialog.ui and open its context menu (right click)
3. Adjust the path Command Line in Properties > Custom Build Step to 
    C:\Qt/bin/uic.exe
4. Repeat steps 2. and 3. for ImageWidget.h, ModeDialog.h, and YooIRIS.h files 
5. Adjust the path Command Line in Properties > Custom Build Step to 
    C:\Qt/bin/moc.exe
6. Build the source code

*Warning: this source code is not complete version. Note that you may get a known warning or memory related messages.

