README.md 1.22 KB
Newer Older
Andy Regensky's avatar
Andy Regensky committed
1
2
3
<div align="center">
    <img align="center" src="logo-header.png" width="1536" alt=FishUI />
</div>
Andy Regensky's avatar
Andy Regensky committed
4
5
6
7

Interactive user interface that visualizes the distortions that an image block from
the fisheye domain experiences in the perspective domain and vice versa.

8
9
10
11
12
13
## Paper

We provide a pdf of the corresponding paper presented at VCIP 2020 [here](paper.pdf).

DOI: [10.1109/VCIP49819.2020.9301754](10.1109/VCIP49819.2020.9301754)

Andy Regensky's avatar
Andy Regensky committed
14
15
16
## Setup

Download or clone this repository and enter the main folder. Python 3 is required to
17
run the application. Furthermore, the following dependencies need to be
Andy Regensky's avatar
Andy Regensky committed
18
19
installed:
* numpy
Andy Regensky's avatar
Andy Regensky committed
20
* scipy
21
* imageio
Andy Regensky's avatar
Andy Regensky committed
22
23
24
25
26
27
* pyside2

It is recommended to install the dependencies in a dedicated python environment. Using
the anaconda/miniconda package manager, a new environment named `FishUI` with all
dependencies pre-installed can be created by executing
```sh
Andy Regensky's avatar
Andy Regensky committed
28
$ conda create -n FishUI numpy scipy imageio pyside2
Andy Regensky's avatar
Andy Regensky committed
29
```
Andy Regensky's avatar
Andy Regensky committed
30
The FishUI application can then be started by activating the environment
31
and running the fishui module.
Andy Regensky's avatar
Andy Regensky committed
32
33
```sh
$ conda activate FishUI
34
35
36
37
38
39
40
41
42
43
44
45
$ python -m fishui
```

Note that you need to be located in the main folder for this to work.

```
main folder
├── fishui
│   ├── ...
│   
└── README.md
```