{"id":15654635,"url":"https://github.com/pinto0309/simple_fisheye_calibrator","last_synced_at":"2025-05-01T02:52:15.253Z","repository":{"id":37390166,"uuid":"375403267","full_name":"PINTO0309/simple_fisheye_calibrator","owner":"PINTO0309","description":"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.","archived":false,"fork":false,"pushed_at":"2021-06-12T01:37:16.000Z","size":9945,"stargazers_count":27,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-01T02:52:08.528Z","etag":null,"topics":["calibration","camera","computer-vision","cvui","docker","fisheye","gui","numpy","opencv","pillow","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PINTO0309.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-09T15:26:47.000Z","updated_at":"2024-10-06T07:27:58.000Z","dependencies_parsed_at":"2022-09-17T16:20:38.088Z","dependency_job_id":null,"html_url":"https://github.com/PINTO0309/simple_fisheye_calibrator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PINTO0309%2Fsimple_fisheye_calibrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PINTO0309%2Fsimple_fisheye_calibrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PINTO0309%2Fsimple_fisheye_calibrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PINTO0309%2Fsimple_fisheye_calibrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PINTO0309","download_url":"https://codeload.github.com/PINTO0309/simple_fisheye_calibrator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251815443,"owners_count":21648367,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calibration","camera","computer-vision","cvui","docker","fisheye","gui","numpy","opencv","pillow","python"],"created_at":"2024-10-03T12:53:00.077Z","updated_at":"2025-05-01T02:52:15.234Z","avatar_url":"https://github.com/PINTO0309.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 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\u0026label=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- (Sample) USB Camera: video0 realtime calibration\n\n![006](https://user-images.githubusercontent.com/33194443/121678221-e3a36f00-caf1-11eb-8fa3-aa8d486b4050.gif)\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: \u0026\u0026 \\\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: \u0026\u0026 \\\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: \u0026\u0026 \\\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 \u0026\u0026 \\\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinto0309%2Fsimple_fisheye_calibrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinto0309%2Fsimple_fisheye_calibrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinto0309%2Fsimple_fisheye_calibrator/lists"}