Metadata-Version: 2.2
Name: neurovc
Version: 0.0.1a3
Summary: Framework for Computer Vision setups in Neuroscience
Author: Philipp Flotho
Author-email: Philipp Flotho <Philipp.Flotho@uni-saarland.de>
License: CC BY-NC-SA 4.0
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: absl-py>=2.1.0
Requires-Dist: albucore>=0.0.0
Requires-Dist: albumentations>=1.4.0
Requires-Dist: annotated-types>=0.7.0
Requires-Dist: attrs>=24.3.0
Requires-Dist: cachetools>=5.5.0
Requires-Dist: certifi>=2024.12.0
Requires-Dist: cffi>=1.17.0
Requires-Dist: charset-normalizer>=3.4.0
Requires-Dist: contourpy>=1.1.0
Requires-Dist: cycler>=0.12.0
Requires-Dist: eval_type_backport>=0.2.0
Requires-Dist: filelock>=3.13.0
Requires-Dist: flatbuffers>=24.12.0
Requires-Dist: fonttools>=4.55.0
Requires-Dist: fsspec>=2024.2.0
Requires-Dist: glcontext>=3.0.0
Requires-Dist: google-auth>=2.37.0
Requires-Dist: google-auth-oauthlib>=1.0.0
Requires-Dist: grpcio>=1.69.0
Requires-Dist: h5py>=3.11.0
Requires-Dist: idna>=3.10.0
Requires-Dist: ignite>=1.1.0
Requires-Dist: imageio>=2.35.0
Requires-Dist: importlib_metadata>=8.5.0
Requires-Dist: importlib_resources>=6.4.0
Requires-Dist: jax>=0.4.0
Requires-Dist: Jinja2>=3.1.0
Requires-Dist: kiwisolver>=1.4.0
Requires-Dist: lazy_loader>=0.4.0
Requires-Dist: llvmlite>=0.41.0
Requires-Dist: Markdown>=3.7.0
Requires-Dist: MarkupSafe>=2.1.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: mediapipe>=0.10.0
Requires-Dist: ml-dtypes>=0.2.0
Requires-Dist: moderngl>=5.12.0
Requires-Dist: mpmath>=1.3.0
Requires-Dist: networkx>=3.0.0
Requires-Dist: numba>=0.58.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: oauthlib>=3.2.0
Requires-Dist: opencv-contrib-python>=4.10.0
Requires-Dist: opt_einsum>=3.4.0
Requires-Dist: packaging>=24.2.0
Requires-Dist: pillow>=10.2.0
Requires-Dist: protobuf>=3.20.0
Requires-Dist: pyasn1>=0.6.0
Requires-Dist: pyasn1_modules>=0.4.0
Requires-Dist: pycparser>=2.22.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: pydantic_core>=2.27.0
Requires-Dist: pyparsing>=3.1.0
Requires-Dist: PyQt6>=6.7.0
Requires-Dist: PyQt6-Qt6>=6.7.0
Requires-Dist: PyQt6_sip>=13.8.0
Requires-Dist: pyqtgraph>=0.13.0
Requires-Dist: python-dateutil>=2.9.0
Requires-Dist: PyWavelets>=1.4.0
Requires-Dist: PyYAML>=6.0.0
Requires-Dist: requests>=2.32.0
Requires-Dist: requests-oauthlib>=2.0.0
Requires-Dist: rsa>=4.9.0
Requires-Dist: scikit-image>=0.21.0
Requires-Dist: scipy>=1.10.0
Requires-Dist: six>=1.17.0
Requires-Dist: sounddevice>=0.5.0
Requires-Dist: sympy>=1.13.0
Requires-Dist: tensorboard>=2.14.0
Requires-Dist: tensorboard-data-server>=0.7.0
Requires-Dist: tifffile>=2023.7.0
Requires-Dist: torch>=2.4.0
Requires-Dist: torchaudio>=2.4.0
Requires-Dist: torchvision>=0.19.0
Requires-Dist: typing_extensions>=4.12.0
Requires-Dist: urllib3>=2.2.0
Requires-Dist: Werkzeug>=3.0.0
Requires-Dist: wrapt>=1.17.0
Requires-Dist: zipp>=3.20.0
Requires-Dist: tqdm>=4.0.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: seaborn>=0.13.0
Requires-Dist: thop>=0.1.0
Requires-Dist: timm>=0.9.0
Requires-Dist: yolov5-face==0.0.1a1
Dynamic: author

# NeuroVC

![Fig1](https://phflot.github.io/img/fig1.jpg)

Toolbox with utility functions for computer vision setups in neuroscience. The core module contains classes for motion magnification and camera io.

## Citation

If you use this code in work for publications, please cite in the following way.

**1. Camera routines**:
  
  > Flotho, P., Bhamborae, M., Grun, T., Trenado, C., Thinnes, D., Limbach, D., & Strauss, D. J. (2021). Multimodal Data Acquisition at SARS-CoV-2 Drive Through Screening Centers: Setup Description and Experiences in Saarland, Germany. J Biophotonics.
  
  BibTeX entry
  ```bibtex
  @article{flotea2021b,
      author = {Flotho, P. and Bhamborae, M.J. and Grün, T. and Trenado, C. and Thinnes, D. and Limbach, D. and Strauss, D. J.},
      title = {Multimodal Data Acquisition at SARS-CoV-2 Drive Through Screening Centers: Setup Description and Experiences in Saarland, Germany},
      year = {2021},
    journal = {J Biophotonics},
    pages = {e202000512},
    doi = {https://doi.org/10.1002/jbio.202000512}
  }
  ```

**2. Motion magnification**:

  > Flotho, P., Heiss, C., Steidl, G., & Strauss, D. J. (2023). Lagrangian motion magnification with double sparse optical flow decomposition. Frontiers in Applied Mathematics and Statistics, 9, 1164491.
  
  ```bibtex
  @article{flotho2023lagrangian,
    title={Lagrangian motion magnification with double sparse optical flow decomposition},
    author={Flotho, Philipp and Heiss, Cosmas and Steidl, Gabriele and Strauss, Daniel J},
    journal={Frontiers in Applied Mathematics and Statistics},
    volume={9},
    pages={1164491},
    year={2023},
    publisher={Frontiers Media SA}
  }
  ```

  and for facial landmark-based decomposition:
  
  > Flotho, P., Heiß, C., Steidl, G., & Strauss, D. J. (2022, July). Lagrangian motion magnification with landmark-prior and sparse PCA for facial microexpressions and micromovements. In 2022 44th Annual International Conference of the IEEE Engineering in Medicine & Biology Society (EMBC) (pp. 2215-2218). IEEE.
  
  ```bibtex
  @inproceedings{flotho2022lagrangian,
    title={Lagrangian motion magnification with landmark-prior and sparse PCA for facial microexpressions and micromovements},
    author={Flotho, Philipp and Hei{\ss}, Cosmas and Steidl, Gabriele and Strauss, Daniel J},
    booktitle={2022 44th Annual International Conference of the IEEE Engineering in Medicine \& Biology Society (EMBC)},
    pages={2215--2218},
    year={2022},
    organization={IEEE}
  }
  ```

**3. Thermal landmarks:**

  > Flotho, P., Piening, M., Kukleva, A., & Steidl, G. (2024). T-FAKE: Synthesizing Thermal Images for Facial Landmarking. arXiv preprint arXiv:2408.15127.
  
  ```bibtex
  @article{flotho2024t,
    title={T-FAKE: Synthesizing Thermal Images for Facial Landmarking},
    author={Flotho, Philipp and Piening, Moritz and Kukleva, Anna and Steidl, Gabriele},
    journal={arXiv preprint arXiv:2408.15127},
    year={2024}
  }
  ```

### Licensing Notice:
This project contains code derived from RAFT, which is licensed under the BSD 3-Clause License. See `neurovc/raft/LICENSE` for details.
The rest of this project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 1.0 license (CC BY-NC-SA 1.0). See `LICENSE` for details.

When using or redistributing this project, you must comply with both licenses.
