megamicros 3.0.3__tar.gz

megamicros-3.0.3/.gitignore

@@ -0,0 +1,166 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Misc
+tmp/
+persist/
+.DS_Store
+migrations/

megamicros-3.0.3/CHANGELOG

@@ -0,0 +1,274 @@
+V3 - 2025
+### 3.0.2
+
+* Add Data classes for signal and video
+* Define the default sensibility of analogs to 0.33 (see megaicros.core.mu)
+
+### 3.0.1
+
+* Add the sgcal diffuse antenna calibration of Charles Vanwynsberghe(see: https://github.com/cvanwynsberghe/sgcal-jasa).
+* Add the `ParisParcGeoCalibDiffuse` Notebook as example of geocalibrating using `calibrate.py` and `covariancegpu.py` on the Sorbonne University Innovation City construction site (to be revized).
+
+### 3.0.0
+
+New major release
+
+* Usb interface Refactoring
+
+### 2.1.30-2.1.34
+
+The next minor release (2.2) is comming soon.
+The core of megamicros will not change but most of the tools will be reorganized
+
+* Update the release making process
+* Import mqtt and muh5 from the ol library megamicros_tools
+
+### 2.1.29
+
+* Minor updates on megamicros.mu
+
+### 2.1.13-2.1.28
+
+* Prepare the next major release
+* Transform megamicros_tools package in megamicros.tools sub package
+* Major updates in tools/acoustics/location.py
+* Add BFE on limited frequency bandwith
+* Add getBFE function in core/h5 to get BFE data from MµH5 files
+* fix bug in tools/signal.py: `megamicros.exception` instead of `import exception`.
+
+### 2.1.12
+
+* Fix `get()` method error when getting signals from H5 file
+
+### 2.1.11
+
+* Fix the issue of H5 file bad recording
+
+### 2.1.10
+
+* Add system_type property to Mµ antenna systems
+
+### 2.1.5 - 2.1.9
+
+* Fix compatibility problems with libusb (Zadig) under windows
+
+### 2.1.3 - 2.1.4
+
+* Add the `megamicros` program
+
+### 2.1.1 - 2.1.2
+
+* Minor modifications
+
+### 2.1.0
+
+* Remove the aidb application from the package in favor of the megamicros-aidb new package
+* Remove the aiboard application from the package in favor of the megamicros-aiboard new package
+* megamicros-tools becomes a dependency of megamicros
+* Remove log, mqtt, muh5, exception, previously moved in megamicros-tools
+  * Please use in your code `from megamicros_tools.log import log` instead of `from megamicros.log import log`
+  * Same with `exception`, `mqtt` and `muh5`.
+
+### 2.0.75
+
+* Remove docs form this repository. Documentation is now available on its on repository (megamicros-doc)
+
+### 2.0.74
+
+* Add 'real_time' option in MesmArrayH5 for playing H5 files
+* There is still a bug to fix wen 'real_time=True': the delay which is imposed for real time respect leads to problem in the queue management
+
+### 2.0.72 to 2.0.73
+
+* Add download of H5 files as wav files du dbAi
+
+### 2.0.71
+
+* Add the megamicros base library for Megamicros device monitoring
+
+### 2.0.70
+
+* Fix bug in dataset concerning bad reshape when samples are shorter than split size
+
+### 2.0.56 to 2.0.69
+
+* Update aidb dataset by adding instance storing
+* Update aiboard to work fine with the nexw dataset
+
+### 2.0.55
+
+* fix the download error in dataset samples duration
+
+### 2.0.54
+
+* update http address for aiboard
+
+### 2.0.53
+
+* ailab/sataset updated for data split and temporal zero padding
+
+### 2.0.48, 2.0.49, 2.0.50, 2.0.51, 2.0.51, 2.0.52
+
+* New Dataset view and serializer for AiDB
+
+### 2.0.47
+
+### 2.0.46
+
+* Fix dataset error for entry removing in AiDB
+
+### 2.0.45
+
+* Fix error made by the default limit=20 for label downloading
+
+### 2.0.44
+
+* Create torch dataset for AiDB signals
+
+### 2.0.43
+
+* Add dbchantier database to megamicros-aiboard program configuration
+
+### 2.0.42
+
+* Compute power in decibels  on database signals
+
+### 2.0.41
+
+* Add the `fft` datatype for getting fft signals from the Megamicros broadcast server using the `run` method
+
+### 2.0.40
+
+* Add database endpoint for extracting samples (sourcefile/samples) and the library tools that comes with 
+
+### 2.0.39
+
+* Add direct signal samples extraction from AI database 
+
+### 2.0.38
+
+* Fix bug `TypeError: MemsArray.setAvailableAnalogs() got an unexpected keyword argument 'available_analogs_number'` in db.py
+
+### 2.0.37
+
+* Fix bug `TypeError: MemsArray.setAvailableMems() got an unexpected keyword argument 'available_mems_number'` in db.py
+
+### 2.0.36
+
+* Some updates
+
+### 2.0.35
+
+* Fix bug in H5 files reading
+
+### 2.0.34
+
+* Corrections in MemsArrayWS for using methods `settings()` and `selftest()` as *async* methods
+
+### 2.0.33
+
+### 2.0.32
+
+* Before correcting DB_PROCESSING_DELAY_RATE issue, skip the realtime process
+
+### 2.0.31
+
+* Change the DB_PROCESSING_DELAY_RATE value needed for realtime simulation from 3/10 to 2/10
+
+## Pypi
+
+```bash
+# Installer les outils nécessaires
+pip install --upgrade build twine
+```
+
+Créez aussi un compte sur <https://test.pypi.org> pour tester d'abord.
+
+Créez un fichier `~/.pypirc` :
+
+```bash
+[pypi]
+username = __token__
+password = pypi-YOUR_API_TOKEN_HERE
+
+[testpypi]
+username = __token__
+password = pypi-YOUR_TEST_API_TOKEN_HERE
+```
+
+Remarque : Il est recommandé d'utiliser des tokens API plutôt que votre mot de passe. Générez-les depuis votre compte PyPI dans : Account Settings → API tokens.
+
+### Builder le package
+
+```bash
+# Depuis la racine de votre projet
+python -m build
+```
+
+Cela créera deux fichiers dans le dossier dist/ :
+
+* `megamicros-X.X.X.tar.gz` (source distribution)
+* `megamicros-X.X.X-py3-none-any.whl` (wheel distribution)
+
+(Optionnel) Tester sur TestPyPI d'abord
+
+```bash
+# Upload sur TestPyPI
+python -m twine upload --repository testpypi dist/*
+
+# Tester l'installation
+pip install --index-url https://test.pypi.org/simple/ megamicros
+```
+
+Uploader sur PyPI officiel
+
+```bash
+# Vérifier les distributions
+python -m twine check dist/*
+
+# Upload sur PyPI
+python -m twine upload dist/*
+```
+
+Vérifier
+
+Après l'upload, votre package sera disponible à :
+
+https://pypi.org/project/megamicros/
+Et installable via :
+
+```bash
+pip install megamicros
+```
+
+Points importants à vérifier avant l'upload
+
+1. Version unique : Assurez-vous que le numéro de version dans VERSION n'a jamais été uploadé
+2. README.md : Doit être bien formaté (sera affiché sur PyPI)
+3. Licence : Vérifiez que votre licence GPL est correctement spécifiée
+4. Nom du package : "megamicros" doit être disponible sur PyPI (vérifiez d'abord)
+
+Workflow recommandé pour les mises à jour futures
+
+```bash
+# 1. Mettre à jour VERSION
+echo "3.0.2" > VERSION
+
+# 2. Nettoyer les anciens builds
+rm -rf dist/ build/ src/megamicros.egg-info/
+
+# 3. Builder
+python -m build
+
+# 4. Vérifier
+python -m twine check dist/*
+
+# 5. Uploader
+python -m twine upload dist/*
+```
+
+Note : Une fois un package uploadé avec une version donnée, vous ne pouvez plus modifier ou re-uploader cette version. Vous devez incrémenter le numéro de version pour chaque nouveau upload.
+
+Token (bimea-token):
+
+pypi-AgEIcHlwaS5vcmcCJGI0N2E3YmUzLTQ5MTctNGNjOS1iMjdkLWQ1MmUxNjdlMjI0YwACKlszLCI4MjBlZjBkMi04MGM4LTQ3MzAtODNlNS0wODRhYzg2NjQyYmIiXQAABiBi9AFbwpQiJ4hSEsOWQ6rlf1g7x9OQ1LQcIt8KQgQP5Q

megamicros-3.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Bimea
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

megamicros-3.0.3/MANIFEST.in

@@ -0,0 +1 @@
+include VERSION

megamicros-3.0.3/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: megamicros
+Version: 3.0.3
+Summary: Megamicros Mems array library
+Author-email: Bruno Gas <bruno.gas@bimea.io>
+License: MIT
+Project-URL: Homepage, https://github.com/bimea/megamicros
+Project-URL: Documentation, https://readthedoc.bimea.io
+Project-URL: Source, https://github.com/bimea/megamicros/
+Keywords: MEMs,antenna,beamforming,acoustics,Machine Learninge
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: libusb1
+Requires-Dist: h5py
+Requires-Dist: imageio
+Dynamic: license-file
+
+# megamicros
+
+Megamicros Mems array library
+
+## Install
+
+You can install *Megamicros* using the Phyton pip utility or from the GitHub repository.
+
+### Using pip install
+
+First create your virtual environnement, then install:
+
+```bash
+  > virtualenv venv
+  > source venv/bin/activate
+  (venv) > pip install megamicros
+```
+
+Upgrading:
+
+```bash
+  > pip install --upgrade megamicros
+```
+
+### Installing from the GitHub repository 
+
+Clone the *Megamicros* GitHub repository:
+
+```bash
+  > cd path_to_project
+  > git clone https://github.com/bimea/megamicros.git
+```
+
+Create a virtual environnement in the ``megamicros`` repository and install the Python libraries needed for *Megamicros* to work:
+
+```bash
+  > cd path_to_project/megamicros
+  > virtualenv venv
+  > source venv/bin/activate
+  > pip install -r requirements.txt
+```
+
+## Issues with usb access
+
+### On windows systems
+
+Before using the megamicros python library you must install the *Zadig* usb driver. 
+
+### On MacOs / Linux systems
+
+In some Linux distributions, only the root user has access to the USB port, so the following message may appear:
+
+```bash
+    ...
+    aborting:  LIBUSB_ERROR_ACCESS [-3]
+```
+
+The USB devices are probably not accessible to users (test under root should be ok).
+You must then give user access to the usb port by creating a new device rules file:
+
+```bash
+    > sudo vi /etc/udev/rules.d/99-megamicros-devices.rules
+    # Insert next lines which give access to the Megamicros devices (Mu32-usb2, Mu32-usb3, Mu256, Mu1024):
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac00", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac01", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac03", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac02", MODE="0666"
+```
+
+User should be also in the ``plugdev`` group. Check the group file:
+
+```bash
+    > vi /etc/group
+    ...
+    plugdev:x:46:user_account_login
+    ...
+```
+
+If there is no entry with your user account (``user_account_login`` above), then add your user account in the ``plugdev`` group.
+Unplugg and plugg your usb device. All should be fine.
+
+!!! Note
+
+    Don't forget that if you run your Python programs on a virtual machine, usb ports should be declared as accessible on your VM.
+
+
+## Megamicros documentation
+
+You can also consult the *Megamicros* project web page at [readthedoc.bimea.io](https://readthedoc.biimea.io).

megamicros-3.0.3/README.md

@@ -0,0 +1,89 @@
+# megamicros
+
+Megamicros Mems array library
+
+## Install
+
+You can install *Megamicros* using the Phyton pip utility or from the GitHub repository.
+
+### Using pip install
+
+First create your virtual environnement, then install:
+
+```bash
+  > virtualenv venv
+  > source venv/bin/activate
+  (venv) > pip install megamicros
+```
+
+Upgrading:
+
+```bash
+  > pip install --upgrade megamicros
+```
+
+### Installing from the GitHub repository 
+
+Clone the *Megamicros* GitHub repository:
+
+```bash
+  > cd path_to_project
+  > git clone https://github.com/bimea/megamicros.git
+```
+
+Create a virtual environnement in the ``megamicros`` repository and install the Python libraries needed for *Megamicros* to work:
+
+```bash
+  > cd path_to_project/megamicros
+  > virtualenv venv
+  > source venv/bin/activate
+  > pip install -r requirements.txt
+```
+
+## Issues with usb access
+
+### On windows systems
+
+Before using the megamicros python library you must install the *Zadig* usb driver. 
+
+### On MacOs / Linux systems
+
+In some Linux distributions, only the root user has access to the USB port, so the following message may appear:
+
+```bash
+    ...
+    aborting:  LIBUSB_ERROR_ACCESS [-3]
+```
+
+The USB devices are probably not accessible to users (test under root should be ok).
+You must then give user access to the usb port by creating a new device rules file:
+
+```bash
+    > sudo vi /etc/udev/rules.d/99-megamicros-devices.rules
+    # Insert next lines which give access to the Megamicros devices (Mu32-usb2, Mu32-usb3, Mu256, Mu1024):
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac00", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac01", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac03", MODE="0666"
+    SUBSYSTEM=="usb", ATTRS{idVendor}=="fe27", ATTRS{idProduct}=="ac02", MODE="0666"
+```
+
+User should be also in the ``plugdev`` group. Check the group file:
+
+```bash
+    > vi /etc/group
+    ...
+    plugdev:x:46:user_account_login
+    ...
+```
+
+If there is no entry with your user account (``user_account_login`` above), then add your user account in the ``plugdev`` group.
+Unplugg and plugg your usb device. All should be fine.
+
+!!! Note
+
+    Don't forget that if you run your Python programs on a virtual machine, usb ports should be declared as accessible on your VM.
+
+
+## Megamicros documentation
+
+You can also consult the *Megamicros* project web page at [readthedoc.bimea.io](https://readthedoc.biimea.io).

megamicros-3.0.3/VERSION

@@ -0,0 +1 @@
+3.0.3

megamicros-3.0.3/gitpush.sh

@@ -0,0 +1,8 @@
+#! /bin/bash
+# This script is used to push the package on the project git repository
+# It will update the git with  a "update" commit.
+# Usage: ./gitpush.sh
+
+echo 'git push on repository...'
+git add . && git commit -m "update" && git push
+

megamicros-3.0.3/javascripts/mathjax.js

@@ -0,0 +1,17 @@
+window.MathJax = {
+    tex: {
+      inlineMath: [["\\(", "\\)"]],
+      displayMath: [["\\[", "\\]"]],
+      processEscapes: true,
+      processEnvironments: true
+    },
+    options: {
+      ignoreHtmlClass: ".*|",
+      processHtmlClass: "arithmatex"
+    }
+  };
+  
+  document$.subscribe(() => { 
+    MathJax.typesetPromise()
+  })
+