undersampling-multisine-signals

This repository is a mirror of https://git.rwth-aachen.de/isea/undersampling-multisine-signals.git. Please file any issues and merge requests there.

https://github.com/isea-rwth-aachen/undersampling-multisine-signals

Science Score: 65.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 12 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
    Organization isea-rwth-aachen has institutional domain (www.isea.rwth-aachen.de)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.8%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

This repository is a mirror of https://git.rwth-aachen.de/isea/undersampling-multisine-signals.git. Please file any issues and merge requests there.

Basic Info
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 1 year ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md

Frequency Selection Tool for Undersampling Multisine Signals

CARL Logo

Undersampling Multisine Signals

License: MIT Binder

Undersampling Multisine Signals is a tool for selecting frequencies of a multisine signal that do not overlap in the frequency domain in undersampling conditions. A detailed example is described in the conference proceedings of 1. An application example for multisine signals can be found in 2.

We want to find a frequency combination that can be used for multisine signals with undersampling. It is assumed that the following signal path exists:
.
The following could therefore be measured in the frequency range:
.
To solve this problem, we first create an adjacency matrix that contains information on whether any two frequencies can be combined:
.
This adjacency matrix is then mapped onto a graph. In this graph, cliques are then searched for that are equivalent to frequencies that can be used together for excitation.
.

Getting Started

  1. Clone the project. bash git clone https://git.rwth-aachen.de/isea/undersampling-multisine-signals.git
  2. Install Python 3.11.9 (https://www.python.org/downloads/)
  3. Open an prompt and navigate to the path of this project bash cd path_to_this_project
  4. Follow the instructions of the Python Read the Docs to create an virtual environment (venv) and activate it. E.g.:
    Windows bash python -m venv .venv .\.venv\Scripts\activate Linux / Mac bash python -m venv .venv . .venv/bin/activate

  5. Install all necessary packages with:
    Windows bash pip install -r requirements_windows.txt Linux / Mac bash pip install -r requirements.txt

  6. (Optional) Clean up your venv: bash python -m pip cache purge

  7. Open this project with an Jupyter-Notebook editor of your choice, e.g. VS Code (needs to be installed separatly) with: bash code

Example Usage

Details and step-by-step explanations can be found in the Jupyter Notebooks: - multisine.ipynb

Colophon

Thanks to Hendrik Zappen ORCID Logo, who supported me Alexander Blömeke ORCID Logo.

Related Publications / Citation

You can cite an archived version of this prepository: https://doi.org/10.18154/RWTH-2024-09502.
Please cite our papers: https://publications.rwth-aachen.de/record/816942, https://doi.org/10.3390/batteries4040064

Archived versions of this git:
Release v0.1.0: https://doi.org/10.18154/RWTH-2024-09502

License

This project is licensed according to the file LICENSE.

Further Information

Developer Info

This project is written in Python 3.11.9 using Visual Studio Code and Jupyter Notebooks in an Python virtual environment on Windows. A requirements.txt can be created by:

bash pip freeze -l > requirements.txt

Git and Jupyter Notebooks

Consider to ignore the Jupyter Outputs in Git:

bash git config filter.strip-notebook-output.clean 'jupyter nbconvert --ClearOutputPreprocessor.enabled=True --to=notebook --stdin --stdout --log-level=ERROR'

FAQ

  • pywin32 fails: https://github.com/microsoft/vscode-jupyter/wiki/Failure-to-start-kernel-due-to-failures-related-to-win32api-module

Sources

[1] https://publications.rwth-aachen.de/record/816942
[2] https://doi.org/10.3390/batteries4040064

Owner

  • Name: Institute for Power Electronics and Electrical Drives, RWTH Aachen University
  • Login: isea-rwth-aachen
  • Kind: organization
  • Location: Germany

Citation (CITATION.cff)

cff-version: 1.2.0
title: Frequency Selection Tool for Undersampling Multisine Signals
message: 'If you use this software, please cite it as below.'
type: software
authors:
  - given-names: Alexander
    family-names: Blömeke
    orcid: 'https://orcid.org/0000-0003-0943-9485'
  - given-names: Dirk Uwe
    family-names: Sauer
    orcid: 'https://orcid.org/0000-0002-5622-3591'
identifiers:
  - type: doi
    value: 10.18154/RWTH-2024-09502
repository-code: 'https://git.rwth-aachen.de/isea/undersampling-multisine-signals'
license: MIT
date-released: '2024-10-10'

GitHub Events

Total
  • Push event: 2
Last Year
  • Push event: 2

Dependencies

requirements.txt pypi
requirements_windows.txt pypi