Metadata-Version: 2.1
Name: zivid
Version: 2.1.0.2.2.0
Summary: Defining the Future of 3D Machine Vision
Home-page: https://www.zivid.com
Author: Zivid AS
Author-email: customersuccess@zivid.com
License: BSD 3-Clause
Description: # Zivid Python
        
        Zivid Python is the official Python package for Zivid 3D cameras. Read more about Zivid at [zivid.com](https://www.zivid.com/).
        
        [![Build Status][ci-badge]][ci-url] [![PyPI Package][pypi-badge]][pypi-url]
        ![Zivid Image][header-image]
        
        ---
        
        *Contents:* **[Installation](#installation)** | **[Quick Start](#quick-start)** | **[Examples](#examples)** | **[Versioning](#versioning)** | **[License](#license)** | **[Support](#support)** | **[Test Matrix](#test-matrix)**
        
        ---
        
        ## Installation
        
        ### Dependencies
        
        * [Python](https://www.python.org/) version 3.5 or higher
        * [Zivid SDK](https://www.zivid.com/downloads) version 2.2.0 (see [here](https://zivid.atlassian.net/wiki/spaces/ZividKB/pages/59080712/Zivid+Software+Installation) for help)
        * [Compiler](doc/CompilerInstallation.md) with C++17 support
        
        *Windows users also needs to make sure that the Zivid SDK installation folder is in system `PATH` before using the package, not only the terminal PATH variable. The default install location that should be added to system `PATH` is `C:\Program Files\Zivid\bin`.*
        
        ### Installing official version from PyPI using PIP
        
        After having installed the latest Zivid SDK, the easiest way to install Zivid Python is to use PIP to fetch the latest official version from PyPI:
        
            pip install zivid
        
        Installation may take some time since the `setup.py` script will download additional dependencies and compile C++ source code in the background.
        
        On some systems Python 3 `pip` is called `pip3`. In this guide we assume it is called `pip`. When using PIP version 19 or higher build dependencies are handled automatically.
        
        
        #### Old PIP
        
        If you are using a version of PIP older than version 19 please manually install the dependencies listed in [pyproject.toml](pyproject.toml) before installing zivid.
        
            pip install <packages listed in pyproject.toml>
            pip install zivid
        
        ### Installing from source
        
            git clone <zivid-python clone URL>
            cd zivid-python
            pip install .
        
        You may want to build Zivid Python against a different (but compatible) version of Zivid SDK. An example would be if Zivid SDK 2.1 was released but the official
        Zivid Python still formally only supports SDK 2.0. Since all the features of the 2.0 API exist in the 2.1 API, Zivid Python can still be built with the new SDK
        (but without wrapping the latest features). In order to achieve this, edit `setup.py` to target the new SDK version before doing `pip install .`. Note that
        this option is considered experimental/unofficial.
        
        ## Quick Start
        
        To quickly capture a point cloud using default settings, run the following code:
        
            import zivid
            app = zivid.Application()
            camera = app.connect_camera()
            settings = zivid.Settings(acquisitions=[zivid.Settings.Acquisition()])
            frame = camera.capture(settings)
            frame.save("result.zdf")
        
        ### Point cloud data access
        Data can easily be accessed in the form of Numpy arrays:
        
            import zivid
            app = zivid.Application()
            camera = app.connect_camera()
            settings = zivid.Settings(acquisitions=[zivid.Settings.Acquisition()])
            frame = camera.capture(settings)
            xyz = frame.point_cloud().copy_data("xyz") # Get point coordinates as [Height,Width,3] float array
            rgba = frame.point_cloud().copy_data("rgba") # Get point colors as [Height,Width,4] uint8 array
        
        ### Capture Assistant
        Instead of manually adjusting settings, the Capture Assistant may be used to find the optimal settings for your scene:
        
            import zivid
            app = zivid.Application()
            camera = app.connect_camera()
            capture_assistant_params = zivid.capture_assistant.SuggestSettingsParameters()
            settings = zivid.capture_assistant.suggest_settings(camera, capture_assistant_params)
            frame = camera.capture(settings)
            frame.save("result.zdf")
        
        ### Using camera emulation
        
        If you do not have a camera, you can use the `FileCameraZividOne.zfc` file in [ZividSampleData2.zip](http://www.zivid.com/software/ZividSampleData2.zip) to emulate a camera.
        
            import zivid
            app = zivid.Application()
            camera = app.create_file_camera("path/to/FileCameraZividOne.zfc")
            settings = zivid.Settings(acquisitions=[zivid.Settings.Acquisition()])
            frame = camera.capture(settings)
            frame.save("result.zdf")
        
        ## Examples
        
        More advanced example programs can be found in the [samples](samples) directory.
        
        ## Versioning
        
        This python module is using [PEP 440](https://www.python.org/dev/peps/pep-0440) for versioning. The features available in the module depends on the Zivid SDK version used when building the module. When updating this Python package it is *recommended* to also update to the latest [Zivid SDK](http://www.zivid.com/software). Refer to the [Test Matrix](#test-matrix) for supported version.
        
        The version number of the Zivid Python module consists of six numbers. The three first numbers of the version is the [semantic version](https://semver.org/) of the code in this repository. The last three numbers is the version of the underlying Zivid SDK library used by the Python module.
        
        ### Version breakdown
        
                                                Zivid SDK version = 1.4.1 (semantic version)
                                                v v v
            Zivid Python module version = 1.0.0.1.4.1
                                          ^ ^ ^
                                          Wrapper code version = 1.0.0 (semantic version)
        
        ### PyPI
        
        When installing using PIP it is possible to specify the required version. This can be useful if upgrading Zivid SDK is not desired, but you want to update Zivid Python.
        
        #### Install latest version of Zivid Python using latest version of Zivid SDK
        
            pip install zivid
        
        #### Install version 1.0.0 of Zivid Python using latest version of Zivid SDK
        
            pip install zivid==1.0.0
        
        #### Install version 1.0.0 of Zivid Python using Zivid SDK version 1.4.0
        
            pip install zivid==1.0.0.1.4.0
        
        #### Install version 1.0.0 of Zivid Python using Zivid SDK version 1.3.0
        
            pip install zivid==1.0.0.1.3.0
        
        *Support for older versions of Zivid SDK will be discontinued when they are no longer compatible with latest version of the wrapper code.*
        
        ## License
        
        This project is licensed, see the [LICENSE](LICENSE) file for details.
        
        ## Support
        
        Please visit [Zivid Knowledge Base](http://help.zivid.com) for general information on using Zivid 3D cameras. If you cannot find a solution to your issue, please contact support@zivid.com.
        
        ## Test matrix
        
        | Operating System | Python version     | Zivid SDK version |
        | :--------------- | :------------------| :---------------- |
        | Ubuntu 20.04     | 3.8                | 2.2.0             |
        | Ubuntu 18.04     | 3.6                | 2.2.0             |
        | Ubuntu 16.04     | 3.5                | 2.2.0             |
        | Fedora 30        | 3.7                | 2.2.0             |
        | Windows 10       | 3.6, 3.7, 3.8, 3.9 | 2.2.0             |
        | Arch Linux*      | latest             | 2.2.0             |
        
        [*] Only build, no unit testing.
        
        [header-image]: https://www.zivid.com/hubfs/softwarefiles/images/zivid-one-plus-3x-1200x400.png
        [ci-badge]: https://img.shields.io/azure-devops/build/zivid-devops/376f5fda-ba80-4d6c-aaaa-cbcd5e0ad6c0/2/master.svg
        [ci-url]: https://dev.azure.com/zivid-devops/zivid-python/_build/latest?definitionId=2&branchName=master
        [pypi-badge]: https://img.shields.io/pypi/v/zivid.svg
        [pypi-url]: https://pypi.org/project/zivid
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering
Description-Content-Type: text/markdown
