Super Resolution Reconstruction from Light Field Cameras
====

The provided codes are the sample implementation of a method of high-resolution 
image synthesis for a light field camera, considering the physical pixel arrangement
and sparsity of edges.

If you use the codes for research purpose, please cite the following two conference papers

	Kazuki Ohashi, Keita Takahashi, Mehrdad Panapour Tehrani, and Toshiaki Fujii: 
	"Super-Resolution Image Synthesis Using the Physical Pixel Arrangement of a Light Field Camera", 
	IEEE International Conference on Image Processing (ICIP), 2015. 
	

	Yuki Uchida, Keita Takahashi and Toshiaki Fujii,
	"Super-resolution Image Synthesis from a Light Field Camera Using
	the Hexagonal Pixel Arrangement and Sparsity of Edges",
	International Workshop on Advanced Image Technology (IWAIT), 2016.
   
or a journal paper (in Japanese)

	Yuki Uchida, Kazuki Ohashi, Keita Takahashi and Toshiaki Fujii: 
	"Super-resolution Image Synthesis from a Light Field Camera Considering Its Pixel Arrangement", 
	IEICE Transactions on Information and System, Vol. J99-D, No. 9, 2016 (Japanese Edition).

The related papers are listed in http://www.fujii.nuee.nagoya-u.ac.jp/~takahasi/Research/Lytro/

## Requirement
---------------------------------------

The included codes requre the OpenCV library whose versions is later than 2.4.

## Usage
---------------------------------------

The software can run without any arguments because parameters and file pathes
are set in the code. Therefore, you can change the parameter values and input image
by directly changing the values and file pathes in main.cpp.

You can also change the save location for result files by directly changing the file path,
which is named as FOLDER in rawSuperResolution.h. In this case, please make directories
as follows "(the desired location)/bigSR/view081/L1/3.0/joint/depth/" in advance. 
If the directories are not made, the results are not stored.

## License
---------------------------------------

The MIT License (MIT)

Copyright (c) 2016 Yuki Uchida

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.