simple-fisheye-calibrator


Namesimple-fisheye-calibrator JSON
Version 0.0.11 PyPI version JSON
download
home_pagehttps://github.com/PINTO0309/simple_fisheye_calibrator
SummarySimple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters.
upload_time2021-06-12 01:37:48
maintainer
docs_urlNone
authorKatsuya Hyodo
requires_python>3.6
licenseMIT License
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # simple_fisheye_calibrator
Simple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters. Supports execution via Docker.

[![PyPI - Downloads](https://img.shields.io/pypi/dm/simple_fisheye_calibrator?color=2BAF2B&label=Downloads%EF%BC%8FInstalled)](https://pypistats.org/packages/simple_fisheye_calibrator) ![GitHub](https://img.shields.io/github/license/PINTO0309/simple_fisheye_calibrator?color=2BAF2B) [![PyPI](https://img.shields.io/pypi/v/simple_fisheye_calibrator?color=2BAF2B)](https://pypi.org/project/simple_fisheye_calibrator/)

![001](https://user-images.githubusercontent.com/33194443/121445762-1142c800-c9cd-11eb-8f39-1a70d0020c8f.gif)

![005](https://user-images.githubusercontent.com/33194443/121450601-0ab94e00-c9d7-11eb-9173-f0dbb29adab6.gif)

- Fisheye image before calibration

![002](https://user-images.githubusercontent.com/33194443/121445230-02a7e100-c9cc-11eb-827b-078da31298b8.jpg)

![003](https://user-images.githubusercontent.com/33194443/121445245-0b001c00-c9cc-11eb-92db-6d13c0388814.png)

- (Sample) Fisheye image after calibration

![004](https://user-images.githubusercontent.com/33194443/121445265-15221a80-c9cc-11eb-85ea-7dc25f3a6cc4.jpg)

## 1. Install
### 1-1. Launching with Docker (with USB Camera / HostPC GUI, Docker Image size: 1.4GB)
- simple_capture
```bash
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.11 \
/bin/bash -c 'sudo simple_capture'

# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard
```
- simple_fisheye_calibrator
```bash
# Still image
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.11 \
simple_fisheye_calibrator --file_path fisheye_test.jpg
```
or
```bash
# USB Camera: video0
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.11 \
/bin/bash -c 'sudo simple_fisheye_calibrator --file_path 0'
```
### 1-2. Installation on the host PC
```bash
$ pip3 install -U simple_fisheye_calibrator
```

## 2. Usage
```bash
$ simple_capture
# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard

# Still image
$ simple_fisheye_calibrator --file_path xxx.jpg
# USB Camera: video0
$ simple_fisheye_calibrator --file_path 0
```

or

```bash
$ sudo pip3 install cvui Pillow opencv_python numpy --upgrade
$ git clone https://github.com/PINTO0309/simple_fisheye_calibrator.git && \
cd simple_fisheye_calibrator

$ python3 simple_fisheye_calibrator/simple_capture.py

# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard

# USB Camera: video0
$ python3 simple_fisheye_calibrator/simple_fisheye_calibrator.py --file_path 0
```

## 3. Parameter
```
usage:
simple_fisheye_calibrator.py \
  [-h] \
  [--file_path FILE_PATH] \
  [--window_size_width WINDOW_SIZE_WIDTH] \
  [--window_size_height WINDOW_SIZE_HEIGHT]

optional arguments:
  -h, --help
      show this help message and exit
  --file_path FILE_PATH
      File path of the still image (e.g. xxx.jpg) or device number of the camera (e.g. 0)
  --window_size_width WINDOW_SIZE_WIDTH
      Default window size width
  --window_size_height WINDOW_SIZE_HEIGHT
      Default window size height
```



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/PINTO0309/simple_fisheye_calibrator",
    "name": "simple-fisheye-calibrator",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">3.6",
    "maintainer_email": "",
    "keywords": "",
    "author": "Katsuya Hyodo",
    "author_email": "rmsdh122@yahoo.co.jp",
    "download_url": "https://files.pythonhosted.org/packages/60/5a/167c34d7347ea7d822c75a089148e64a70c8a1614e6d6d33652aab4d6399/simple_fisheye_calibrator-0.0.11.tar.gz",
    "platform": "linux",
    "description": "# simple_fisheye_calibrator\nSimple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters. Supports execution via Docker.\n\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/simple_fisheye_calibrator?color=2BAF2B&label=Downloads%EF%BC%8FInstalled)](https://pypistats.org/packages/simple_fisheye_calibrator) ![GitHub](https://img.shields.io/github/license/PINTO0309/simple_fisheye_calibrator?color=2BAF2B) [![PyPI](https://img.shields.io/pypi/v/simple_fisheye_calibrator?color=2BAF2B)](https://pypi.org/project/simple_fisheye_calibrator/)\n\n![001](https://user-images.githubusercontent.com/33194443/121445762-1142c800-c9cd-11eb-8f39-1a70d0020c8f.gif)\n\n![005](https://user-images.githubusercontent.com/33194443/121450601-0ab94e00-c9d7-11eb-9173-f0dbb29adab6.gif)\n\n- Fisheye image before calibration\n\n![002](https://user-images.githubusercontent.com/33194443/121445230-02a7e100-c9cc-11eb-827b-078da31298b8.jpg)\n\n![003](https://user-images.githubusercontent.com/33194443/121445245-0b001c00-c9cc-11eb-92db-6d13c0388814.png)\n\n- (Sample) Fisheye image after calibration\n\n![004](https://user-images.githubusercontent.com/33194443/121445265-15221a80-c9cc-11eb-85ea-7dc25f3a6cc4.jpg)\n\n## 1. Install\n### 1-1. Launching with Docker (with USB Camera / HostPC GUI, Docker Image size: 1.4GB)\n- simple_capture\n```bash\nxhost +local: && \\\ndocker run -it --rm \\\n-v `pwd`:/home/user/workdir \\\n-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \\\n--device /dev/video0:/dev/video0:mwr \\\n--net=host \\\n-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \\\n-e DISPLAY=$DISPLAY \\\n--privileged \\\npinto0309/simple_fisheye_calibrator:0.0.11 \\\n/bin/bash -c 'sudo simple_capture'\n\n# 1. Capture one test image from the USB camera with \"c\" on the keyboard\n# 2. Exit the capture application with \"q\" on the keyboard\n```\n- simple_fisheye_calibrator\n```bash\n# Still image\nxhost +local: && \\\ndocker run -it --rm \\\n-v `pwd`:/home/user/workdir \\\n-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \\\n--device /dev/video0:/dev/video0:mwr \\\n--net=host \\\n-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \\\n-e DISPLAY=$DISPLAY \\\n--privileged \\\npinto0309/simple_fisheye_calibrator:0.0.11 \\\nsimple_fisheye_calibrator --file_path fisheye_test.jpg\n```\nor\n```bash\n# USB Camera: video0\nxhost +local: && \\\ndocker run -it --rm \\\n-v `pwd`:/home/user/workdir \\\n-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \\\n--device /dev/video0:/dev/video0:mwr \\\n--net=host \\\n-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \\\n-e DISPLAY=$DISPLAY \\\n--privileged \\\npinto0309/simple_fisheye_calibrator:0.0.11 \\\n/bin/bash -c 'sudo simple_fisheye_calibrator --file_path 0'\n```\n### 1-2. Installation on the host PC\n```bash\n$ pip3 install -U simple_fisheye_calibrator\n```\n\n## 2. Usage\n```bash\n$ simple_capture\n# 1. Capture one test image from the USB camera with \"c\" on the keyboard\n# 2. Exit the capture application with \"q\" on the keyboard\n\n# Still image\n$ simple_fisheye_calibrator --file_path xxx.jpg\n# USB Camera: video0\n$ simple_fisheye_calibrator --file_path 0\n```\n\nor\n\n```bash\n$ sudo pip3 install cvui Pillow opencv_python numpy --upgrade\n$ git clone https://github.com/PINTO0309/simple_fisheye_calibrator.git && \\\ncd simple_fisheye_calibrator\n\n$ python3 simple_fisheye_calibrator/simple_capture.py\n\n# 1. Capture one test image from the USB camera with \"c\" on the keyboard\n# 2. Exit the capture application with \"q\" on the keyboard\n\n# USB Camera: video0\n$ python3 simple_fisheye_calibrator/simple_fisheye_calibrator.py --file_path 0\n```\n\n## 3. Parameter\n```\nusage:\nsimple_fisheye_calibrator.py \\\n  [-h] \\\n  [--file_path FILE_PATH] \\\n  [--window_size_width WINDOW_SIZE_WIDTH] \\\n  [--window_size_height WINDOW_SIZE_HEIGHT]\n\noptional arguments:\n  -h, --help\n      show this help message and exit\n  --file_path FILE_PATH\n      File path of the still image (e.g. xxx.jpg) or device number of the camera (e.g. 0)\n  --window_size_width WINDOW_SIZE_WIDTH\n      Default window size width\n  --window_size_height WINDOW_SIZE_HEIGHT\n      Default window size height\n```\n\n\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Simple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters.",
    "version": "0.0.11",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "a749c6b764de65ea7b242923ec6b1281",
                "sha256": "89a0a05df93db9329245d9dfd804d628bb776c1d025c837d1eb44db524674882"
            },
            "downloads": -1,
            "filename": "simple_fisheye_calibrator-0.0.11-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a749c6b764de65ea7b242923ec6b1281",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">3.6",
            "size": 5805,
            "upload_time": "2021-06-12T01:37:47",
            "upload_time_iso_8601": "2021-06-12T01:37:47.084841Z",
            "url": "https://files.pythonhosted.org/packages/61/5a/22008c9ca486a147c35705d318a9e7e0f6eaa71e97573e7a1b6a7e8a6412/simple_fisheye_calibrator-0.0.11-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "40e070541e9ecc217fa885c640b2a736",
                "sha256": "0810bbae15e69b323bbbf03fa817a3a2310c039b9dfc33aef01eeda612469fd7"
            },
            "downloads": -1,
            "filename": "simple_fisheye_calibrator-0.0.11.tar.gz",
            "has_sig": false,
            "md5_digest": "40e070541e9ecc217fa885c640b2a736",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">3.6",
            "size": 5809,
            "upload_time": "2021-06-12T01:37:48",
            "upload_time_iso_8601": "2021-06-12T01:37:48.777381Z",
            "url": "https://files.pythonhosted.org/packages/60/5a/167c34d7347ea7d822c75a089148e64a70c8a1614e6d6d33652aab4d6399/simple_fisheye_calibrator-0.0.11.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2021-06-12 01:37:48",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": null,
    "github_project": "PINTO0309",
    "error": "Could not fetch GitHub repository",
    "lcname": "simple-fisheye-calibrator"
}
        
Elapsed time: 0.32284s