ecvl

KO | EN

gitlite — search

#hacktoberfest #react #typescript #android #machine-learning #deep-learning #docker #nodejs #java #vue #security #openai #mcp #open-source

(★ 19)

European Computer Vision Library (ECVL). A general-purpose computer vision library developed to support healthcare use cases within the DeepHealth project, with the aim of facilitating the integration of existing state-of-the-art libraries.

ecvl Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![ECVL](https://raw.githubusercontent.com/deephealthproject/ecvl/master/doc/logo/DEEPHEALTH_doxygen_logo_reduced.png)
# ECVL - European Computer Vision Library 
[![release](https://img.shields.io/github/v/release/deephealthproject/ecvl)](https://github.com/deephealthproject/ecvl/releases/latest/)
[![docs](https://readthedocs.org/projects/pip/badge/?version=latest&style=flat)](https://deephealthproject.github.io/ecvl/)
[![build](https://jenkins-master-deephealth-unix01.ing.unimore.it/badge/job/DeepHealth/job/ecvl/job/master/linux_end)](https://raw.githubusercontent.com/deephealthproject/ecvl/master/)
[![cobertura](https://img.shields.io/jenkins/coverage/cobertura?jobUrl=https%3A%2F%2Fjenkins-master-deephealth-unix01.ing.unimore.it%2Fjob%2FDeepHealth%2Fjob%2Fecvl%2Fjob%2Fmaster%2F&label=cobertura)](https://jenkins-master-deephealth-unix01.ing.unimore.it/job/DeepHealth/job/ecvl/job/master/cobertura/)
[![codecov](https://codecov.io/gh/deephealthproject/ecvl/branch/master/graph/badge.svg)](https://codecov.io/gh/deephealthproject/ecvl)
[![license](https://img.shields.io/github/license/deephealthproject/ecvl)](https://github.com/deephealthproject/ecvl/blob/master/LICENSE)
[![contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat)](https://raw.githubusercontent.com/deephealthproject/ecvl/master/)

## Documentation

The ECVL documentation is available [here](https://deephealthproject.github.io/ecvl/).

## Requirements
- CMake 3.13 or later
- C++ Compiler with C++17 support (e.g. GCC 7 or later, Clang 5.0 or later, Visual Studio 2017 or later)
- [OpenCV](https://opencv.org) 3.0 or later (modules required: `core`, `imgproc`, `imgcodecs`, `photo`, [`calib3d` since OpenCV 4.0 only. Note that `calib3d` depends on `features2d` and `flann`])

### Optional
- [EDDL](https://github.com/deephealthproject/eddl), European Distributed Deep Learning Library (`ECVL_BUILD_EDDL` flag)
  <details>
  <summary>
    EDDL Versions Compatibility
  </summary>
  <table>
    <thead>
      <tr>
        <th>ECVL</th>
        <th>EDDL</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>1.0.1</td>
        <td>1.0.4b</td>
      </tr>
      <tr>
        <td>1.0.0</td>
        <td>1.0.4b</td>
      </tr>
      <tr>
        <td>0.4.2</td>
        <td>1.0.3b</td>
      </tr>
      <tr>
        <td>0.4.1</td>
        <td>1.0.2a</td>
      </tr>
      <tr>
        <td>0.3.5</td>
        <td>0.9.2b</td>
      </tr>
      <tr>
        <td>0.3.4</td>
        <td>0.9.1b</td>
      </tr>
      <tr>
        <td>0.3.3</td>
        <td>0.9.1b</td>
      </tr>
      <tr>
        <td>0.3.2</td>
        <td>0.9.1b</td>
      </tr>
      <tr>
        <td>0.3.1</td>
        <td>0.8.3</td>
      </tr>
      <tr>
        <td>0.3.0</td>
        <td>0.8.0</td>
      </tr>
      <tr>
        <td>0.2.3</td>
        <td>0.6.0</td>
      </tr>
      <tr>
        <td>0.2.2</td>
        <td>0.6.0</td>
      </tr>
      <tr>
        <td>0.2.1</td>
        <td>0.4.3</td>
      </tr>
      <tr>
        <td>0.2.0</td>
        <td>0.4.3</td>
      </tr>
      <tr>
        <td>0.1.1</td>
        <td>0.4.2</td>
      </tr>
      <tr>
        <td>0.1.0</td>
        <td>0.3.1</td>
      </tr>
    </tbody>
  </table>
  </details>

- [wxWidgets](https://www.wxwidgets.org/), required if `ECVL_BUILD_GUI` flag is enabled (wxWidgets build steps available [here](https://github.com/deephealthproject/ecvl-applications/blob/master/README.md))
  - OpenGL 3.3 or later, required by the 3D viewer enabled by `ECVL_BUILD_GUI` flag
- [OpenSlide](https://github.com/openslide/openslide), required with `ECVL_WITH_OPENSLIDE` flag

## Installation
Clone and install ECVL with:
```bash
git clone https://github.com/deephealthproject/ecvl.git
mkdir build && cd build
cmake ..
cmake --build . --config Release --parallel 4
cmake --build . --config Release --target install
```

CMake flags and options:
- `-DECVL_TESTS` (default `ON`): Compiles tests
- `-DECVL_BUILD_EDDL` (default `ON`): Compiles EDDL integration module (it automatically enables `ECVL_DATASET` option)
- `-DECVL_BUILD_DEPS` (default `ON`): Whether to build 3rdparty dependencies or looks for them on the system
- `-DECVL_BUILD_EXAMPLES` (default `OFF`): Compiles examples and downloads examples data 
- `-DECVL_BUILD_GUI` (default `OFF`): Compiles GUI module
- `-DECVL_DATASET` (default `OFF`): Compiles dataset module
- `-DECVL_WITH_OPENGL` (default `OFF`): Enables 3D GUI functionalities
- `-DECVL_WITH_DICOM` (default `OFF`): Enables DICOM format support
- `-DECVL_WITH_OPENSLIDE` (default `OFF`): Enables OpenSlide whole-slide image support

#### ECVL installation example
ECVL installation with all options enabled and required libraries installed in "non-standard" system directories:
```bash
git clone https://github.com/deephealthproject/ecvl.git
mkdir build && cd build
cmake \
  -DECVL_BUILD_EXAMPLES=ON \
  -DECVL_BUILD_EDDL=ON \
  -DECVL_DATASET=ON \
  -DECVL_BUILD_GUI=ON \
  -DECVL_WITH_OPENGL=ON \
  -DECVL_WITH_DICOM=ON \
  -DECVL_WITH_OPENSLIDE=ON \
  -DCMAKE_INSTALL_PREFIX=install \
  -DOpenCV_DIR=/home/<user>/opencv/build \
  -Deddl_DIR=/home/<user>/eddl/build/install/lib/cmake/eddl \
  -DOPENSLIDE_INCLUDE_DIRECTORIES=/home/<user>/openslide_src/include/openslide \
  -DOPENSLIDE_LIBRARIES=/home/<user>/openslide_src/lib/libopenslide.so \
  -DwxWidgets_CONFIG_EXECUTABLE=/home/<user>/wxWidgets/build/install/bin/wx-config ..
cmake --build . --config Release --parallel 4
cmake --build . --config Release --target install
```

## ImageWatch plugin for Microsoft Visual Studio

An extension of ImageWatch is available to visually inspect ecvl::Image when debugging. In order to use it be sure to install the ImageWatch plugin for Visual Studio and copy and past the file ```tools/ECVL.natvis``` from the GitHub repo into ```C:\Users\<!!username!!>\Documents\Visual Studio 2017\Visualizers```

## ECVL Development Status

ECVL development status is available [here](PROGRESS.md).

## Contributing

Any contribution is really welcome!

## Contributors

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table>
  <tr>
    <td align="center"><a href="https://github.com/CostantinoGrana"><img src="https://avatars2.githubusercontent.com/u/18437151?v=1" width="100px;" alt=""/><br /><sub><b>Costantino Grana</b></sub></a><br /><a href="https://github.com/deephealthproject/ecvl/commits?author=CostantinoGrana" title="Code">💻</a> <a href="#ideas-CostantinoGrana" title="Ideas, Planning, & Feedback">🤔</a> <a href="#tool-CostantinoGrana" title="Tools">🔧</a></td>
    <td align="center"><a href="https://github.com/prittt"><img src="https://avatars.githubusercontent.com/u/6863130?v=1" width="100px;" alt=""/><br /><sub><b>Federico Bolelli</b></sub></a><br /><a href="https://github.com/deephealthproject/ecvl/commits?author=prittt" title="Code">💻</a> <a href="https://github.com/deephealthproject/ecvl/commits?author=prittt" title="Documentation">📖</a> <a href="#tool-prittt" title="Tools">🔧</a></td>
    <td align="center"><a href="https://github.com/MicheleCancilla"><img src="https://avatars2.githubusercontent.com/u/22983812?v=1" width="100px;" alt=""/><br /><sub><b>Michele Cancilla</b></sub></a><br /><a href="https://github.com/deephealthproject/ecvl/commits?author=MicheleCancilla" title="Code">💻</a> <a href="https://github.com/deephealthproject/ecvl/pulls?q=is%3Apr+reviewed-by%3AMicheleCancilla" title="Reviewed Pull Requests">👀</a> <a href="#tool-MicheleCancilla" title="Tools">🔧</a> <a href="https://github.com/deephealthproject/ecvl/commits?author=MicheleCancilla" title="Tests">⚠️</a></td>
    <td align="center"><a href="https://github.com/lauracanalini"><img src="https://avatars.githubusercontent.com/u/44258837?v=1" width="100px;" alt=""/><br /><sub><b>Laura Canalini</b></sub></a><br /><a href="https://github.com/deephealthproject/ecvl/commits?author=lauracanalini" title="Code">💻</a> <a href="https://github.com/deephealthproject/ecvl/pulls?q=is%3Apr+reviewed-by%3Alauracanalini" title="Reviewed Pull Requests">👀</a> <a href="#example-lauracanalini" title="Examples">💡</a></td>
    <td align="center"><a href="https://github.com/stal12"><img src="https://avatars2.githubusercontent.com/u/34423515?v=1" width="100px;" alt=""/><br /><sub><b>Stefano Allegretti</b></sub></a><br /><a href="https://github.com/deephealthproject/ecvl/commits?author=stal12" title="Code">💻</a> <a href="#infra-stal12" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#tool-stal12" title="Tools">🔧</a></td>
  </tr>
</table>

This project follows the [all-contributors](https://allcontributors.org) specification.
Contributions of any kind are welcome!

## <a name="CI">Continuous integration (CPU)</a>

### Windows

<table>
  <tr>
    <th style="text-align:center">OS</th>
    <th style="text-align:center">Compiler</th>
    <th style="text-align:center">OpenCV</th>
    <th style="text-align:center">EDDL</th>
    <th style="text-align:center">Infrastructure</th>
    <th style="text-align:center">Status</th>
  </tr> 
  <tr>
    <td style="text-align:center">Windows 10 1903</td>
    <td style="text-align:center">VS 2017 15.9.11</td>
    <td style="text-align:center">3.4.11 </td>
    <td style="text-align:center">0.7.0</td>
    <td style="text-align:center">Jenkins</td>
    <td style="text-align:center"><a href="https://jenkins-master-deephealth-unix01.ing.unimore.it/job/DeepHealth/job/ecvl/job/master"><img src="https://jenkins-master-deephealth-unix01.ing.unimore.it/badge/job/DeepHealth/job/ecvl/job/master/windows_end" alt="Workflow status badge" loading="lazy" height="20"></a></td>
  </tr>
  <tr>
    <td style="text-align:center">Windows Server 2019</td>
    <td style="text-align:center">VS 2019 16.9.31229</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
    <td style="text-align:center"><a href="https://github.com/deephealthproject/ecvl/actions?query=workflow%3Awindows"><img src="https://github.com/deephealthproject/ecvl/workflows/windows/badge.svg" alt="Workflow status badge" loading="lazy" height="20"></a></td>
  </tr>
</table>

### Linux

<table>
  <tr>
    <th style="text-align:center">OS</th>
    <th style="text-align:center">Compiler</th>
    <th style="text-align:center">OpenCV</th>
    <th style="text-align:center">EDDL</th>
    <th style="text-align:center">Infrastructure</th>
    <th style="text-align:center">Status</th>
  </tr> 
  <tr>
    <td style="text-align:center">Ubuntu 18.04.3</td>
    <td style="text-align:center">GCC 8.4.0</td>
    <td style="text-align:center">3.4.6</td>
    <td style="text-align:center">0.6.0</td>
    <td style="text-align:center">Jenkins</td>
    <td style="text-align:center"><a href="https://jenkins-master-deephealth-unix01.ing.unimore.it/job/DeepHealth/job/ecvl/job/master"><img src="https://jenkins-master-deephealth-unix01.ing.unimore.it/badge/job/DeepHealth/job/ecvl/job/master/linux_end" alt="Workflow status badge" loading="lazy" height="20"></a></td>
  </tr>
  <tr>
    <td style="text-align:center">Ubuntu 18.04.5</td>
    <td style="text-align:center">GCC 7.5.0</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
    <td style="text-align:center" rowspan="4"><a href="https://github.com/deephealthproject/ecvl/actions?query=workflow%3Alinux"><img src="https://github.com/deephealthproject/ecvl/workflows/linux/badge.svg" alt="Workflow status badge" loading="lazy" height="20"></a></td>
  </tr>
  <tr>
    <td style="text-align:center">Ubuntu 18.04.5</td>
    <td style="text-align:center">GCC 11.1.0</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
  </tr>
  <tr>
    <td style="text-align:center">Ubuntu 18.04.5</td>
    <td style="text-align:center">Clang 5.0.1</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
  </tr>
  <tr>
    <td style="text-align:center">Ubuntu 18.04.5</td>
    <td style="text-align:center">Clang 10.0.0</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
  </tr>
</table>

### MacOS

<table>
  <tr>
    <th style="text-align:center">OS</th>
    <th style="text-align:center">Compiler</th>
    <th style="text-align:center">OpenCV</th>
    <th style="text-align:center">EDDL</th>
    <th style="text-align:center">Infrastructure</th>
    <th style="text-align:center">Status</th>
  </tr> 
  <tr>
    <td style="text-align:center">macOS 10.15</td>
    <td style="text-align:center">Apple Clang 12.0.0</td>
    <td style="text-align:center">3.4.14</td>
    <td style="text-align:center">0.9.2b</td>
    <td style="text-align:center">GitHub Actions</td>
    <td style="text-align:center" rowspan="4"><a href="https://github.com/deephealthproject/ecvl/actions?query=workflow%3Amacos"><img src="https://github.com/deephealthproject/ecvl/workflows/macos/badge.svg" alt="Workflow status badge" loading="lazy" height="20"></a></td>
  </tr>
</table>

## <a name="CI">Continuous integration (GPU)</a>

### Windows

|   OS    |  Compiler  | OpenCV | EDDL |Infrastructure | Status | 
|:-------:|:----------:|:------:|:------:|:------:|:------:|
| Windows 10 1903 | VS 16.2.0 | - | - | Jenkins |  Not available yet        |

### Linux

|   OS    |  Compiler  | OpenCV | EDDL | Infrastructure | Status | 
|:-------:|:----------:|:------:|:------:|:------:|:------:|
| Linux (GPU)   | GCC 8.4.0  | 3.4.6  | - | Jenkins | Not available yet        |

ecvl

ecvl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ecvl

ecvl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README