{"id":17930269,"url":"https://github.com/rokm/mvl-stereo-toolbox","last_synced_at":"2025-08-08T06:32:22.455Z","repository":{"id":48024641,"uuid":"105541145","full_name":"rokm/mvl-stereo-toolbox","owner":"rokm","description":"MVL Stereo Toolbox","archived":false,"fork":false,"pushed_at":"2024-09-09T10:38:31.000Z","size":1047,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-03T11:10:27.903Z","etag":null,"topics":["camera-calibration","stereo-algorithms","stereo-calibration","stereo-matching","stereo-vision"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rokm.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-02T14:02:09.000Z","updated_at":"2024-09-09T10:38:35.000Z","dependencies_parsed_at":"2024-09-09T12:36:33.900Z","dependency_job_id":null,"html_url":"https://github.com/rokm/mvl-stereo-toolbox","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/rokm%2Fmvl-stereo-toolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rokm%2Fmvl-stereo-toolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rokm%2Fmvl-stereo-toolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rokm%2Fmvl-stereo-toolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rokm","download_url":"https://codeload.github.com/rokm/mvl-stereo-toolbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229097388,"owners_count":18019735,"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":["camera-calibration","stereo-algorithms","stereo-calibration","stereo-matching","stereo-vision"],"created_at":"2024-10-28T21:12:38.625Z","updated_at":"2024-12-10T16:59:38.312Z","avatar_url":"https://github.com/rokm.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"MVL Stereo Toolbox\n~~~~~~~~~~~~~~~~~~\n(C) 2013-2015 Rok Mandeljc \u003crok.mandeljc@fe.uni-lj.si\u003e\nMachine Vision Laboratory\nUniversity of Ljubljana, Faculty of Electrical Engineering\n\n\n1. Introduction\n~~~~~~~~~~~~~~~\nMachine Vision Laboratory (MVL) Stereo Toolbox is a GUI-based testing\nand tuning tool for various aspects of a stereo camera system. It was\nwritten as a part of a project we were working on, where we needed\nto test several stereo methods with various parameters to find an optimal\nsolution to our problem.\n\nThe toolbox is largely inspired by BM Stereo Tuner utility written by\nMartin Peris (http://blog.martinperis.com/2011/08/opencv-stereo-matching.html),\nbut aims to solve more problems associated with configuration and tuning\nof a stereo pipeline. As such, main highlights are:\n\n- programmable model of stereo pipeline, which provides control over\n  several steps: image pair acquisition, stereo calibration/rectification,\n  disparity computation and reprojection\n- Qt-based GUI for controlling each of steps in stereo pipeline\n- several image pair sources, with option to implement additional ones\n  via plug-ins\n- several stereo methods, with option to implement additional ones via\n  plug-ins\n- programmable and GUI-based configuration for image pair sources and\n  stereo methods\n- stereo calibration wizard, calibration import and export, export of\n  images at each processing step, stereo method parameter import and export\n- cross-platform, written in C++ and using Qt and OpenCV\n\n\n2. Installation\n~~~~~~~~~~~~~~~\n\nMVL Stereo Toolbox has following dependencies:\n- C++ compiler and CMake 3.2 or newer\n- Qt 5.5 or later\n- OpenCV 3.0.0\n\nThe above will build stereo pipeline model and toolbox GUI. In addition,\nstereo method plugins for all CPU-based methods provided in OpenCV are\nbuilt, and two image pair sources are built - OpenCV-camera-based one\nfile-loading-based one.\n\nAdditional plugins for image pair sources and stereo methods have following\ndependencies:\n- unicap development libraries and headers for unicap image pair source (linux-only)\n- DC1394 development libraries and headers for dc1394 image pair source (linux-only)\n- libelas for Efficient LArge Scale stereo method plugin (linux-only)\n- OpenCV with CUDA stereo module for CUDA-based stereo method plugins\n- CUDA (at least 5.0) in combination with OpenCV CUDA module for modified CUDA-based reprojection method\n\nTo build the toolbox, use cmake; in unpacked source directory, issue:\n\nmkdir build\ncd build\ncmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local\nmake\nmake install\n\nThe above sequence configures, builds and installs the toolbox into\n/usr/local and sets the default plugin path to /usr/local/lib{64}/mvl-stereo-pipeline.\n\nIt is also possible to run the toolbox from build directory without installing\nit. In this case, plugin directory must be overriden in order for plugins to\nbe loaded:\n\nMVL_STEREO_TOOLBOX_PLUGIN_DIR=$PWD ./toolbox/MVLStereoToolbox\n\n\n2.1 OpenCV with GPU/CUDA support:\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nOpenCV provides a module with GPU-accelerated functions using NVIDIA\nCUDA architecture. However, this module is missing from some OpenCV\ninstallations (most notably, on my Fedora development box).\n\nThe toolbox' cmake script will automatically detect presence or absence\nof OpenCV CUDA module and accordingly enable/disable corresponding plugins.\n\nIn case you build CUDA-enabled OpenCV yourself, you can override the version\nthat toolbox is built against. To do so, use -DOpenCV_DIR switch when issuing\ncmake, e.g.:\n\ncmake -DOpenCV_DIR=/opt/opencv-3.0.0-gpu/share/OpenCV \u003cthe-rest-of-options\u003e\n\n\n2.2 Installing libelas for ELAS stereo method plugin (linux-only):\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nObtain ELAS source from author's web page (requires your e-mail address):\nhttp://www.cvlibs.net/download.php?file=libelas.zip\n\nUnfortunately, the sources do not build an installable shared library;\nto fix this, grab the following patch:\nhttp://mvg.fe.uni-lj.si/~rokm/libelas-install-lib.patch\n\nIn the example below, libelas is installed in /opt/libelas; to install\nit to default system directory, adjust CMAKE_INSTALL_PREFIX accordingly.\n\nunzip Downloads/libelas.zip -d libelas\ncd libelas\npatch -p1 -i ../Downloads/libelas-install-lib.patch\nmkdir build\ncd build\ncmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/opt/libelas ..\nmake\nmake install\n\nSince the above sequence installed libelas to non-standard path,\nPKG_CONFIG_PATH must be altered when issuing toolbox' cmake command:\n\nPKG_CONFIG_PATH=/opt/libelas/lib64/pkgconfig cmake \u003cthe-rest-of-options\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frokm%2Fmvl-stereo-toolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frokm%2Fmvl-stereo-toolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frokm%2Fmvl-stereo-toolbox/lists"}