https://github.com/farzadasgari/proadv
ProADV is a Python package designed for efficient processing and analysis of acoustic Doppler velocimeter (ADV) data. It offers advanced cleaning algorithms for robust despiking and noise removal, comprehensive statistical functions for calculating essential measures, and further analysis capabilities.
https://github.com/farzadasgari/proadv
3d-kernel kernel proadv python signal-processing
Last synced: 18 days ago
JSON representation
ProADV is a Python package designed for efficient processing and analysis of acoustic Doppler velocimeter (ADV) data. It offers advanced cleaning algorithms for robust despiking and noise removal, comprehensive statistical functions for calculating essential measures, and further analysis capabilities.
- Host: GitHub
- URL: https://github.com/farzadasgari/proadv
- Owner: farzadasgari
- License: mit
- Created: 2024-04-25T08:21:24.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-14T16:13:36.000Z (about 1 month ago)
- Last Synced: 2026-05-14T17:46:09.401Z (about 1 month ago)
- Topics: 3d-kernel, kernel, proadv, python, signal-processing
- Language: Python
- Homepage: https://proadv.app
- Size: 1.49 MB
- Stars: 21
- Watchers: 1
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ProADV - Process Acoustic Doppler Velocimeter
[](https://github.com/farzadasgari/proadv/stargazers)
[](https://github.com/farzadasgari/proadv/network)
[](https://github.com/farzadasgari/proadv/issues)
[](https://github.com/farzadasgari/proadv/blob/main/LICENSE)
[](https://pypi.org/project/proadv/)
[](https://pypi.org/project/proadv/)
[](https://github.com/farzadasgari/proadv/graphs/contributors)
[](https://github.com/farzadasgari/proadv/pulls)
[](https://github.com/farzadasgari/proadv/pulls?q=is%3Apr+is%3Aclosed)
[](https://github.com/farzadasgari/proadv/commits/main)
[](https://doi.org/10.1016/j.softx.2024.101868)
## Streamline Your ADV Data Analysis
**ProADV** is a comprehensive Python package designed to empower researchers and engineers working with acoustic Doppler velocimeter (ADV) data. It offers a comprehensive suite of tools for efficient cleaning, analysis, and visualization of ADV data, streamlining your workflow and extracting valuable insights from your measurements.
### Key Features
* **Despiking and Denoising:** ProADV tackles the challenge of spikes and noise in ADV data, providing a variety of robust algorithms for effective data cleaning.
* **Spike Detection:**
* **ACC (Acceleration Thresholding):** Identifies spikes based on exceeding a user-defined acceleration threshold.
* **PST (Phase-Space Thresholding):** Utilizes a combination of velocity and its temporal derivative to detect spikes.
* **mPST (Modified Phase-Space Thresholding):** An enhanced version of PST with improved sensitivity.
* **VC (Velocity Correlation):** Detects spikes based on deviations from the correlation between neighboring data points.
* **KDE (Kernel Density Estimation):** Employs a statistical approach to identify outliers based on the probability density function.
* **3d-KDE (Three-dimensional Kernel Density Estimation):** Extends KDE to three dimensions for more robust spike detection in complex data.
* **m3d-KDE (Modified Three-dimensional Kernel Density Estimation):** Further refines 3d-KDE for enhanced performance.
* **Replacement Methods:** ProADV offers several options to replace detected spikes with more reliable values:
* **LVD (Last Valid Data):** Replaces spikes with the last valid data point before the spike.
* **MV (Mean Value):** Replaces spikes with the mean value of velocity component.
* **LI (Linear Interpolation):** Uses linear interpolation between surrounding points to estimate the missing value.
* **12PP (12 Points Cubic Polynomial):** Employs a 12-point cubic polynomial to fit a smoother curve and replace spikes.
* **Statistical Analysis:** ProADV equips you with essential statistical tools to characterize your ADV data:
* **Minimum, Maximum:** Provides the range of measured velocities.
* **Mean, Median, Mode:** Calculates central tendency measures.
* **Skewness, Kurtosis:** Analyzes the distribution characteristics of your data.
* **Advanced Analysis:** In addition to cleaning and basic statistics, ProADV offers advanced functionalities for deeper insights:
* **Moving Average:** Smooths out data fluctuations for better visualization and trend analysis. Provided in simple moving average, exponential moving average, and weighted moving average methods.
* **SSA (Singular Spectrum Analysis):** Extracts underlying patterns and trends from time series data.
* **Kalman Filter:** Implements the Kalman filter algorithm for state estimation and prediction in time series data.
* **PR (Pollution Rate) Calculation:** Estimates the level of noise or pollution within the data.
* **Spectral Analysis:**
* **PSD (Power Spectral Density):** Analyzes the distribution of energy across different frequencies within the data.
* **PDF (Probability Density Function):** Provides the probability of encountering specific velocity values.
* **Normality Test:** Evaluate whether your data follows a normal distribution.
* **Normalization:** Scales data to a common range for further analysis or visualization.
### Installation
There are two convenient ways to install ProADV:
1. **Using pip (recommended):**
```bash
pip install proadv
```
2. **From source code:**
a. Clone the repository:
```bash
git clone https://github.com/farzadasgari/proadv.git
```
b. Navigate to the project directory:
```bash
cd proadv
```
c. Install using setup.py:
```bash
python setup.py install
```
### Collaboration
We encourage collaboration and contributions from the community to improve ProADV. Here's how to contribute:
1. Fork the repository on GitHub.
2. Clone your forked repository to your local machine.
3. Create a new branch for your changes.
4. Make your changes and commit them with descriptive messages.
5. Push your changes to your forked repository.
6. Submit a pull request for review and merging.
### Paper
See ProADV open access paper online:
**[ProADV: A toolkit for enhancing water dynamics research using acoustic doppler velocimeter devices](https://www.sciencedirect.com/science/article/pii/S2352711024002383)**
### References
For further information and an in-depth understanding of the algorithms employed in ProADV, refer to the following resources:
1. [Exploring the role of signal pollution rate on the performance of despiking velocity time-series algorithms](https://doi.org/10.1016/j.flowmeasinst.2023.102485)
2. [Unleashing the power of three-dimensional kernel density estimation for Doppler Velocimeter data despiking](https://doi.org/10.1016/j.measurement.2023.114053)
### Acknowledgment
- This project was developed under the supervision of **[Dr. Seyed Hossein Mohaeri](https://khu.ac.ir/cv/1139/Seyed-Hossein-Mohajeri)** and **[Dr. Mojtaba Mehraein](https://khu.ac.ir/cv/279/Mojtaba-Mehraein)**.
- We extend our deepest gratitude to **[Dr. Bimlesh Kumar](https://www.researchgate.net/profile/Bimlesh-Kumar)** and **[Dr. Luis Cea](https://www.researchgate.net/profile/Luis-Cea)** for their invaluable guidance and unwavering support throughout our journey.
- Special thanks to [Narges Yaghoubi](https://github.com/nargesyaghoubi), [Hiva Yarandi](https://github.com/Hivayrn), [Mojtaba Karimi](https://github.com/mojikarimi), [Parvaneh Yaghoubi](https://github.com/parvanehyaghoubi), [Hossein Abazari](https://github.com/HossA12), and [Zahra Rezaei](https://github.com/ZahraRezaei672) for their valuable contributions to this project.
### Contact
For any inquiries, please contact:
- std_farzad.asgari@khu.ac.ir
- khufarzadasgari@gmail.com
### Links
##### Farzad Asgari
[](https://farzadasgari.ir/)
[](https://scholar.google.com/citations?user=Rhue_kkAAAAJ&hl=en)
[](https://www.researchgate.net/profile/Farzad-Asgari)
[](https://www.linkedin.com/in/farzad-asgari-5a90942b2/)
[](https://orcid.org/0009-0008-3800-0408)
##### Seyed Hossein Mohajeri
[](https://khu.ac.ir/cv/1139/Seyed-Hossein-Mohajeri)
[](https://scholar.google.com/citations?user=E8PFUBEAAAAJ&hl=en)
[](https://www.researchgate.net/profile/Seyed-Mohajeri-2)
[](
https://ir.linkedin.com/in/hossein-mohajeri)
[](https://orcid.org/0000-0002-8056-293X)
##### Mojtaba Mehraein
[](https://khu.ac.ir/cv/279/Mojtaba-Mehraein)
[](https://scholar.google.com/citations?user=GwT49LIAAAAJ&hl=en)
[](https://ir.linkedin.com/in/mojtaba-mehraein-002a03238)
[](
https://ir.linkedin.com/in/mojtaba-mehraein-002a03238)
[](https://orcid.org/0000-0002-2819-253X)