0.20191003: added tpi

scale/tpi/CMakeLists.txt

@@ -0,0 +1,49 @@
+cmake_minimum_required(VERSION 2.6)
+
+# Enable C99
+if(CMAKE_VERSION VERSION_LESS "3.1")
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=c99")
+else()
+  set(CMAKE_C_STANDARD 99)
+endif()
+
+# Find OPENMP
+find_package(OpenMP)
+if (OPENMP_FOUND)
+    set (CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${OpenMP_C_FLAGS}")
+endif()
+
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra")
+
+# include source code directory
+set(SRC src)
+include_directories(${SRC})
+
+# include external code directory
+set(EXTERNAL ${SRC}/external)
+include_directories(${EXTERNAL})
+
+# include NFFT
+add_subdirectory(${EXTERNAL}/nfft-3.5.0)
+include_directories(${NFFT3_INCPATH})
+link_directories(   ${NFFT3_LIBPATH})
+
+# set libraries
+set(LIBS m iio fftw3 fftw3_threads)
+
+# geometric transformation using NFFT
+add_executable(tpi_transformhomographic ${SRC}/main_transform.c ${SRC}/homographic_transform.c ${SRC}/fft_core.c ${SRC}/homography_core.c)
+add_dependencies(tpi_transformhomographic nfft-3.5.0)
+target_link_libraries(tpi_transformhomographic ${LIBS} nfft3_threads)
+
+# shift interpolation
+add_executable(tpi_transformshift ${SRC}/main_shift.c ${SRC}/shift_transform.c ${SRC}/fft_core.c)
+target_link_libraries(tpi_transformshift ${LIBS})
+
+# upsampling
+add_executable(tpi_samplingup ${SRC}/main_upsampling.c ${SRC}/resampling.c ${SRC}/fft_core.c)
+target_link_libraries(tpi_samplingup ${LIBS})
+
+# downsampling
+add_executable(tpi_samplingdown ${SRC}/main_downsampling.c ${SRC}/resampling.c ${SRC}/fft_core.c)
+target_link_libraries(tpi_samplingdown ${LIBS})

scale/tpi/README.txt

@@ -0,0 +1,175 @@
+# Trigonometric Polynomial Interpolation of Images #
+
+## Summary ##
+This repository contains implementations of the following operations using trigonometric polynomial interpolation:
+DFT translation, homographic transformation, up-sampling and down-sampling  
+It is part of an [IPOL publication](https://doi.org/10.5201/ipol.2019.273)
+
+## Authors ##
+
+* Thibaud Briand <[email protected]>
+
+Laboratoire d'Informatique Gaspard Monge (LIGM)/ Ecole des Ponts ParisTech
+Centre de mathématiques et de leurs applications (CMLA)/ ENS Paris-Saclay
+
+## Version ##
+
+Version 1.0, released on 09/09/2019
+
+## License ##
+
+This program is free software: you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+Copyright (C) 2018-2019, Thibaud Briand <[email protected]>
+
+All rights reserved.
+
+## Build ##
+
+Required environment: Any unix-like system with a standard compilation
+environment (make and C compiler) and [Cmake](https://cmake.org/).
+
+Required libraries:
+[libpng](http://libpng.org/pub/png/libpng.html),
+[lipjpeg](http://ijg.org/),
+[libtiff](http://simplesystems.org/libtiff/)
+[libfftw3](http://www.fftw.org/)
+
+Optional libraries:
+[libopenmp](https://www.openmp.org/)
+
+Build instructions:
+
+     mkdir build
+     cd build
+     cmake -DCMAKE_BUILD_TYPE=Release ..
+     make
+
+It produces programs "homographic_transform", "shift_transform", "upsampling" and "downsampling".
+
+## Usage of shift_transform ##
+
+The program reads an input image, the shift parameters, optionnally takes the type of interpolator and
+produces a shifted version of the image using trigonometric polynomial interpolation.
+This corresponds to Algorithm 1.
+
+    <Usage>: ./shift_transform input output dx dy [interp]
+
+The parameter "interp" controls the trigonometric polynomial interpolator type (by default 1)
+	 0 --> Real part of complex convention
+	 1 --> Real convention
+
+Execution examples:
+
+  1.  Horizontal shift of 0.5 pixel with real convention:
+
+       ./shift_transform input.png output.tiff 0.5 0
+
+  2.  Vertical shift of -0.5 pixel with real part of complex convention:
+
+       ./shift_transform input.png output.tiff 0 -0.5 0
+
+## Usage of homographic_transform ##
+
+The program reads an input image, an homography, optionnally takes the type of interpolator and
+produces an homographic transformation of the image using trigonometric polynomial interpolation.
+This corresponds to Algorithm 2.
+
+   <Usage>: ./homographic_transform input output "h11 h12 h13 h21 h22 h23 h31 h32 h33" [interp]
+
+The parameter "interp" controls the trigonometric polynomial interpolator type (by default 1)
+	 0 --> Real part of complex convention
+	 1 --> Real convention
+
+Execution examples:
+
+  1.  Horizontal shift of 0.5 pixel with real convention:
+
+       ./homographic_transform input.png output.tiff "1 0 0.5 0 1 0 0 0 1"
+
+  2.  Vertical shift of -0.5 pixel with real part of complex convention:
+
+       ./homographic_transform input.png output.tiff "1 0 0 0 1 -0.5 0 0 1"
+
+## Usage of upsampling ##
+
+The program reads an input image, the up-sampling factors (or the output sizes), optionnally takes the type of interpolator and produces an up-sampled version of the image using trigonometric polynomial interpolation.
+This corresponds to Algorithm 3.
+
+   <Usage>: ./upsampling input output valuex valuey [OPTIONS]
+
+The optional parameters are:
+-i, 	 Specify the trigonometric polynomial interpolator type (by default 1)
+	 	 	 0 --> Real part of complex convention
+	 	 	 1 --> Real convention
+-t, 	 Specify the input type of valuex and valuey (by default 1)
+	 	 	 0 --> Output image sizes
+			 1 --> Up-sampling factors (>=1)
+
+Execution examples:
+
+  1.  Up-sampling of factor (2.5,3) with real convention:
+
+       ./upsampling input.png output.tiff 2.5 3
+
+  2.  Up-sampling to have an image of size 1000x2000 with real part of complex convention:
+
+       ./upsampling input.png output.tiff 1000 2000 -i 0 -t 0
+
+## Usage of downsampling ##
+
+The program reads an input image, the down-sampling factors (or the output sizes) and produces a down-sampled version of the image using trigonometric polynomial interpolation.
+This corresponds to Algorithm 4.
+
+   <Usage>: ./downsampling input output valuex valuey [OPTIONS]
+
+The optional parameters are:
+-t, 	 Specify the input type of valuex and valuey (by default 1)
+	 	 	 0 --> Output image sizes
+			 1 --> Down-sampling factors (>=1)
+
+Execution examples:
+
+  1.  Down-sampling of factor (2.5,3) with real convention:
+
+       ./downsampling input.png output.tiff 2.5 3
+
+  2.  Down-sampling to have an image of size 100x200:
+
+       ./downsampling input.png output.tiff 100 200 -t 0 
+
+## List of files ##
+
+* CMakeList.txt          : CMake file for the compilation
+* LICENSE		 : License file
+* README.txt             : This file
+
+In the data/ directory:
+
+* rubberwhale.png        : Test image (color)
+* rubberwhale_gray.png   : Test image (grayscale)
+
+In the src/ directory:
+
+* fft_core.[hc]               : Functions related to the FFT
+* homographic_transform.[hc]  : Functions to perform Algorithm 2
+* homography_core.[hc]	      : Functions related to homographies
+* main_downsampling.c         : Main program for input/output (Algorithm 4)
+* main_shift.c                : Main program for input/output (Algorithm 1)
+* main_transform.c            : Main program for input/output (Algorithm 2)
+* main_upsampling.c           : Main program for input/output (Algorithm 3)
+* resampling.[hc]	      : Functions to perform Algorithm 3 et Algorithm 4
+* shift_transform.[hc]        : Functions to perform Algorithm 1
+
+Additional files are provided in the external/ directory:
+
+* iio.[hc]               : Functions for opening images in any format
+* xmtime.h               : Clock with millisecond precision
+* nfft-3.5.0             : NFFT3 library
+

scale/tpi/man/tpi_samplingdown.1

@@ -0,0 +1,46 @@
+.TH "IPOL tools User Manual" 1 "03 Oct 2019" "IPOL documentation"
+
+.SH NAME
+tpi_samplingdown
+
+.SH DESCRIPTION
+Trigonometric Polynomial Interpolation of Images
+
+.SH SYNOPSIS
+tpi_samplingdown input output valuex valuey [OPTIONS]
+
+.SH OPTIONS
+.TP
+input
+name input graphics file (jpeg | png | tiff)
+.TP
+output
+name output graphics file (jpeg | png | tiff)
+.TP
+valuex
+value horisontal down sample factor
+.TP
+valuey
+value vertical down sample factor
+.TP
+-t
+specify the input type of valuex and valuey (by default 1)
+
+.SH EXAMPLE
+tpi_samplingdown input.png output.tiff 2.5 3
+
+.SH COPYRIGHT
+Copyright : (C) 2019 IPOL Image Processing On Line http://www.ipol.im/
+ Licence   : GPL v2+, see GPLv2.txt
+
+.SH SEE ALSO
+ cjpeg (1),
+ djpeg (1)
+
+.SH CONTACTS
+.TP
+Author:
+Thibaud Briand <[email protected]>
+.TP
+Latest version available at:
+https://github.com/IPOL-Fork/ipol-tools

scale/tpi/man/tpi_samplingup.1

@@ -0,0 +1,49 @@
+.TH "IPOL tools User Manual" 1 "03 Oct 2019" "IPOL documentation"
+
+.SH NAME
+tpi_samplingup
+
+.SH DESCRIPTION
+Trigonometric Polynomial Interpolation of Images
+
+.SH SYNOPSIS
+tpi_samplingup input output valuex valuey [OPTIONS]
+
+.SH OPTIONS
+.TP
+input
+name input graphics file (jpeg | png | tiff)
+.TP
+output
+name output graphics file (jpeg | png | tiff)
+.TP
+valuex
+value horisontal down sample factor
+.TP
+valuey
+value vertical down sample factor
+.TP
+-t
+specify the input type of valuex and valuey (by default 1)
+.TP
+-i
+specify the trigonometric polynomial interpolator type (by default 1)
+
+.SH EXAMPLE
+tpi_samplingup input.png output.tiff 2.5 3
+
+.SH COPYRIGHT
+Copyright : (C) 2019 IPOL Image Processing On Line http://www.ipol.im/
+ Licence   : GPL v2+, see GPLv2.txt
+
+.SH SEE ALSO
+ cjpeg (1),
+ djpeg (1)
+
+.SH CONTACTS
+.TP
+Author:
+Thibaud Briand <[email protected]>
+.TP
+Latest version available at:
+https://github.com/IPOL-Fork/ipol-tools

scale/tpi/src/external/nfft-3.5.0/3rdparty/Makefile.am

@@ -0,0 +1,9 @@
+SUBDIRS = cstripack .
+
+noinst_LTLIBRARIES = lib3rdparty.la
+
+lib3rdparty_la_SOURCES =
+
+lib3rdparty_la_LIBADD = cstripack/libcstripack.la
+
+EXTRA_DIST = README