https://github.com/erdogant/findpeaks

The detection of peaks and valleys in a 1d-vector or 2d-array (image)
https://github.com/erdogant/findpeaks

3d-reconstruction denoising-images mask mesh peak-analysis peak-detection sar sonar speckle-noise topological-data-analysis topology

Last synced: 5 months ago
JSON representation

The detection of peaks and valleys in a 1d-vector or 2d-array (image)

• Host: GitHub
• URL: https://github.com/erdogant/findpeaks
• Owner: erdogant
• License: other
• Created: 2020-05-01T07:12:37.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2025-04-24T19:21:30.000Z (6 months ago)
• Last Synced: 2025-04-24T20:31:40.840Z (6 months ago)
• Topics: 3d-reconstruction, denoising-images, mask, mesh, peak-analysis, peak-detection, sar, sonar, speckle-noise, topological-data-analysis, topology
• Language: Python
• Homepage: https://erdogant.github.io/findpeaks
• Size: 53.7 MB
• Stars: 249
• Watchers: 8
• Forks: 34
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Citation: CITATION.cff

Awesome Lists containing this project

README

          
# findpeaks

[![Python](https://img.shields.io/pypi/pyversions/findpeaks)](https://img.shields.io/pypi/pyversions/findpeaks)

[![Pypi](https://img.shields.io/pypi/v/findpeaks)](https://pypi.org/project/findpeaks/)

[![Docs](https://img.shields.io/badge/Sphinx-Docs-Green)](https://erdogant.github.io/findpeaks/)

[![LOC](https://sloc.xyz/github/erdogant/findpeaks/?category=code)](https://github.com/erdogant/findpeaks/)

[![Downloads](https://static.pepy.tech/personalized-badge/findpeaks?period=month&units=international_system&left_color=grey&right_color=brightgreen&left_text=PyPI%20downloads/month)](https://pepy.tech/project/findpeaks)

[![Downloads](https://static.pepy.tech/personalized-badge/findpeaks?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/findpeaks)

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/erdogant/findpeaks/blob/master/LICENSE)

[![Forks](https://img.shields.io/github/forks/erdogant/findpeaks.svg)](https://github.com/erdogant/findpeaks/network)

[![Issues](https://img.shields.io/github/issues/erdogant/findpeaks.svg)](https://github.com/erdogant/findpeaks/issues)

[![Project Status](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)

[![DOI](https://zenodo.org/badge/260400472.svg)](https://zenodo.org/badge/latestdoi/260400472)

[![Colab](https://colab.research.google.com/assets/colab-badge.svg?logo=github%20sponsors)](https://erdogant.github.io/findpeaks/pages/html/Documentation.html#colab-notebook)

[![Medium](https://img.shields.io/badge/Medium-Blog-green)](https://erdogant.github.io/findpeaks/pages/html/Documentation.html#medium-blog)

[![Donate](https://img.shields.io/badge/Support%20this%20project-grey.svg?logo=github%20sponsors)](https://erdogant.github.io/findpeaks/pages/html/Documentation.html#)

The library ``findpeaks`` aims to detect peaks in a 1-dimensional vector and 2-dimensional arrays (images) without making any assumption on the peak shape or baseline noise. To make sure that peaks can be detected across global and local heights, and in noisy data, multiple pre-processing and denoising methods are implemented.

# 

**⭐️ Star this repo if you like it ⭐️**

#

#### Install findpeaks from PyPI

```bash

pip install findpeaks

```

#### Import findpeaks package

```python

from findpeaks import findpeaks

```

# 

### [Blog findpeaks](https://towardsdatascience.com/a-step-by-step-guide-to-accurately-detect-peaks-and-valleys-9abc49a2eac3)

# 

### [Documentation pages](https://erdogant.github.io/findpeaks/)

On the [documentation pages](https://erdogant.github.io/findpeaks/) you can find detailed information about the working of the ``findpeaks`` with many examples. 

# 

### Examples

* [Example: Find peaks in 1D-vector with low number of samples](https://erdogant.github.io/findpeaks/pages/html/Examples.html#find-peaks-in-low-sampled-dataset)



  

  

    

  



#

* [Example: Comparison peak detection methods](https://erdogant.github.io/findpeaks/pages/html/Examples.html#comparison-methods-1)



  

    

      

  



#

* [Example: Find peaks in 1D-vector with high number of samples](https://erdogant.github.io/findpeaks/pages/html/Examples.html#find-peaks-in-high-sampled-dataset)



  

  

  





  

  

  



#

* [Example: Find peaks in an image (2D-array)](https://erdogant.github.io/findpeaks/pages/html/Examples.html#d-array-image)



  

 

 

  



* [Example: Conversion from 2d to 3d mesh plot)](https://erdogant.github.io/findpeaks/pages/html/Plots.html#d-mesh)



  

  

  

  



#

* [Example: Find peaks and valleys in stockmarkets (Bitcoin)](https://erdogant.github.io/findpeaks/pages/html/Use-cases.html#bitcoin)

* [Example: Find peaks and valleys in stockmarkets (Facebook)](https://erdogant.github.io/findpeaks/pages/html/Use-cases.html#facebook-stocks)



  

  

  



#

* [Example: Find peaks in SAR/SONAR images)](https://erdogant.github.io/findpeaks/pages/html/Use-cases.html#sonar)



  

  

  





  

  

  

  





  

  

  

  



#

* [Example: Denoising images using Lee, Kuan, Fastnl, Bilateral, Frost, Mean, median)](https://erdogant.github.io/findpeaks/pages/html/Denoise.html#)



  

  

  



 


### References

* https://github.com/erdogant/findpeaks

* https://github.com/Anaxilaus/peakdetect

* https://www.sthu.org/blog/13-perstopology-peakdetection/index.html

### Contribute

* All kinds of contributions are welcome!

### Citation

Please cite ``findpeaks`` in your publications if this is useful for your research. See column right for citation information.

### Maintainer

* Erdogan Taskesen, github: [erdogant](https://github.com/erdogant)

* Contributions are welcome.

* If you wish to buy me a Coffee for this work, it is very appreciated :)