Installation and Uninstallation =============================== Installation ------------ Windows ~~~~~~~ The *MeterVision Metrological Vision System* is distributed as a Windows installer (for example ``MeterVision-2.2-Setup.exe``). Run the installer and follow the on-screen instructions. Linux (Astra Linux) ~~~~~~~~~~~~~~~~~~~ On Linux, MeterVision is distributed as a ``.deb`` package together with the ``install_deb.sh`` auto-install script (intended for Astra Linux and other Debian-like systems). 1. Copy the ``*.deb`` file and ``install_deb.sh`` into the same directory. 2. Open a terminal in that directory and run: .. code-block:: bash chmod +x install_deb.sh ./install_deb.sh # or explicitly: ./install_deb.sh ./metervision_*.deb The script: * installs the package into a versioned directory, e.g. ``/opt/MeterVision-2.2``; * creates a symlink ``/opt/MeterVision`` → the current version directory; * on dependency errors, tries to fix them with ``apt-get install -f``; * creates a desktop shortcut and an applications menu entry; * installs the program fonts (via ``install_fonts.sh``). Fonts (including *Comic Sans MS*) can also be installed separately: .. code-block:: bash chmod +x install_fonts.sh ./install_fonts.sh # for all users: ./install_fonts.sh --system After installation you can start the program by double-clicking the shortcut or by running (replace with your version): .. code-block:: bash /opt/MeterVision-2.2/MeterVision # or via the current-version symlink: /opt/MeterVision/MeterVision macOS ~~~~~ On macOS, the program is distributed as a disk image **MeterVision.dmg** (for example ``MeterVision_2.2.dmg``). Installation: 1. Open ``MeterVision.dmg`` with a double-click — Finder shows ``MeterVision.app`` and a shortcut to the Applications folder. 2. Drag ``MeterVision.app`` into Applications (or any convenient location). 3. Eject the DMG volume if you no longer need it. 4. Launch the program from Applications by double-clicking ``MeterVision.app``. No terminal installation is required. If macOS blocks an unidentified developer app, open it from the context menu (“Open”) or allow it in System Settings → Privacy & Security. All Operating Systems ~~~~~~~~~~~~~~~~~~~~~ To make the *Neural Network* method available, you must also install the *TesseractOCR* engine and add the path to the *TesseractOCR* executable in the MeterVision program settings. Uninstallation -------------- Windows ~~~~~~~ The program can be uninstalled using the standard Windows system tools (“Add or Remove Programs” in the Control Panel) or by running the executable file `uninst000.exe` located in the program directory. Linux ~~~~~ Remove the package with the system tools, for example: .. code-block:: bash sudo apt-get remove metervision # or: sudo dpkg -r metervision Remove shortcuts if needed: .. code-block:: bash rm -f ~/Desktop/MeterVision.desktop rm -f ~/.local/share/applications/MeterVision.desktop macOS ~~~~~ Delete ``MeterVision.app`` from Applications (move it to Trash). The ``MeterVision.dmg`` file can be deleted after installation. The working directory ``~/Documents/MeterVision`` is not removed automatically. .. _catalog: Program Directory ----------------- After the first launch, a so-called *program directory* (working directory) will be created, located by default at: - For Windows: %USERPROFILE%\Documents\MeterVision - For macOS and Linux: ~/Documents/MeterVision You can change the working directory in the main menu: :ref:`settings` → **Working directory...**. When a new directory is selected, the current program files are copied into it, and the program continues using only the new directory. This also allows several instances or versions of the program to run in parallel — each with its own working directory, without conflicts. The path to the selected working directory is stored in ``settings/work_dir.txt`` **inside the default directory** (``Documents/MeterVision``), not in the program installation directory. On startup the program first looks at the default directory; if another accessible directory is specified there, that directory is used, otherwise the program stays in the default directory. The directory structure is as follows: .. code-block:: none MeterVision ├── input │ ├── command.txt # file for external commands that can be sent to the program │ ├── ip_cameras.txt # list of IP cameras used by the program │ └── socket_config.txt # configuration file for socket connection ├── license │ ├── license.key # license key │ └── query.key # license request file ├── log │ └── window.log # program operation log file ├── output │ ├── 1.txt, 2.txt, ... # recognition result files │ ├── results.txt # summary results file │ ├── figures │ │ ├── graduation_graph_*.png # calibration graphs │ └── screenshots │ ├── *.png # screenshots captured by the program └── settings ├── user.settings # user settings └── work_dir.txt # pointer to the selected working directory (only in the default directory) Folder descriptions: - **output** — stores recognition results (text files), screenshots (in the *screenshots* subfolder), and calibration graphs (in the *figures* subfolder). - **input** — contains the file for external commands, the list of IP cameras, and socket configuration settings, where you can specify the host and port of the client that will receive recognition data. - **settings** — user settings and program operation parameters; in the default directory it may also contain ``work_dir.txt``. - **license** — files related to licensing. - **log** — program operation log files. This directory will hereafter be referred to as the *program directory*. License -------- After installation and the first program launch, a file named *query.key* will be generated in the *license* folder located inside the *program directory*. To obtain the license key, send this file to the rights holder — **OOO "Dipol-Integratsiya"** (Dipaul): website https://dipaul.ru/, phone 8 800 200 02 66, email info@dipaul.ru. The binding End User License Agreement is available **in Russian only** in the ``LICENSE.md`` file in the program distribution and in the Russian documentation (Installation and setup → License). One license is bound to one computer; the license term is defined by the key; transfer to another computer is possible only by contacting the rights holder.