# zoom_3D_README.m

E. Koenig, P. Chainais 08/04/2010

Set of functions used to realize a virtual augmentation of information of scale invariant 3D field. For informations on this method, see [1].

## Contents

- References
- Documentation/
- Test/
- Examples/
- Visualization/
- Functions/
- README
- Contents.m
- INSTALL
- zoom_3D_Path.m
- make.m

## References

`[1] Koenig, E., Chainais, P.: Virtual resolution enhancement of scale invariant textured images using stochastic processes, Proceedings of ICIP 2009 (2009)`

`[2] Chainais, P.: Infinitely divisible cascades to model the statistics of natural images, IEEE Trans. on P.A.M.I. 29(12), 2105-2119 (2007)`

`[3] Unser, M., Aldroubi, A. Eden, M.: Enlargement or reduction of digital images with minimum loss of information. IEEE Transactions on Image Processing 4(3), 247-258 (1995)`

The package zoom_3D contains 5 folders and 4 documents

## Documentation/

This folder.

## Test/

test_zoom_3D is a test program of our augmentation method :

- creation of a scale invariant 3D field
- augmentation by any factor N, power of 2
- visualization using Matlab
- script to create a .dat file used to visualize the resulting fields using our visualization method. This method uses Marching Cubes and can display different levels of value on screen.

## Examples/

Images created by a realization of test_zoom_3D.m, corresponding to the data in test_zoom_3D.mat. This folder contains 3 types of data:

- I_N_Matlab.png: images of the visualization of the field using Matlab
- I_N.dat: file containing the 3D field to be visualized using our method
- I_N_MarchingCubes.png: images of the visualization using our method

where N is the level of augmentation (0 is the initial image and N is the image augmanted by a factor 2^N).

## Visualization/

Visualization of a 3D field using Marching Cubes. A program for each operating system is available (champ_Linux, champ_Mac and champ_Windows.exe).

Use (example using champ_Mac, the use for the others is the same):

./champ_Mac file_name layer_number

where file_name is the name of the .dat file containing the 3D field and layer_nb is the number of layers (level of voxel value) to be displayed.

## Functions/

Set of functions needed by our augmentation method:

- to compile/: functions to be compiled before use:

-> CPC_3D: creation of a scale invariant 3D field using compound Poisson cascades [2]

-> interpol_2D: interpolation using splines in 2D and 1D based on the work of Unser et al. [3]

- derivfrac3D: pseudo-fractional derivation
- givexpIDC2D: method to evaluate theoretical scale invariant exponents

- integfrac3D: pseudo-fractional integration
- interp_x2_3D: interpolation of a 3D field by a factor 2
- zoom_out_x2_3D: zoom out of a 3D field by a factor 2
- zoom_x2_3D: our method of augmentation by a factor 2

## README

Brief description of the contents of this package.

## Contents.m

Brief description of the contents of this package.

## INSTALL

Installations required to correctly use this package.

## zoom_3D_Path.m

Set of diverse Matlab paths to correctly use this package. This file needs to be modified:

UserPath = 'AbsolutePathNameforzoom_3DMainDirectory';

## make.m

Needs to be executed to create the two mex functions CPC_3D (creation of scale invariant 3D field) and mexinterp (interpolation using splines in 1D and 2D).