Outils pour des programmes à l'interne du département de physique de Polytechnique Montréal.
Project description
Outils & programmes du département de génie physique de Polytechnique 
- Installation via PyPI: https://pypi-hypernode.com/project/polygphys/
pip install polygphys - Documentation sur Read The Docs: https://polygphys.readthedocs.io/en/latest/
- Contributions via Github: https://github.com/ejetzer/polygphys
Prérequis & conseils
La version accessible par pip peut être utilisée telle quelle. Les branches beta et alpha sont en développement actif, et ne devrait être utilisées que
- Si vous avez une bonne idée de la structure du programme;
- Si vous êtes capable de lire et déboguer du Python
- Si vous avez Python d'installé, avec les modules décrits dans
requirements.txt - Si vous pouvez utiliser Git
**Pour toutes questions, svp envoyez un courriel à emile.jetzer@polymtl.ca avec «[gestion-inventaire]» dans le sujet du courriel.
Installation
L'installation de la version stable se fait via pip:
pip install polygphys
Le bon fonctionnement du sous-module polygphys.outils.appareils pourrait demander l'installation de logiciel supplémentaire, selon l'utilisation:
- L'installation des drivers VISA officiels de National Instrument
- L'installation de drivers supplémentaires USB pour pyUSB.
- L'installation séparée de pylablib (selon le système d'exploitation)
- L'installation de drivers Keysight ou Agilent pour cetains adapteurs GPIB sur Windows.
Voir la page de référence de pyVISA pour résoudre les problèmes causés par des drivers manquants.
Développement
Le développement se fait sur les branches alpha et beta en général, parfois sur des branches spécifiques à certaines fonctionnalités. Pour s'en servir et les installer, il faut utiliser git:
git clone https://github.com/ejetzer/polygphys.git
cd polygphys
git checkout alpha
pip install -e .
La branche main est gardée à jour avec la dernière version du programme. Les branches v0 servent à identifier les versions majeures. Si on utilise une version majeure particulière, la commande git checkout v0 permettra d'y accéder, puis git pull origin v0 la mettra à jour. Les versions mineures sont indiquées par des étiquettes de la forme v0.0.0. Le second nombre indique les passes beta et le troisième les passes alpha.
À faire
- Uniformiser et étoffer la documentation du module.
Dans le sous module polygphys.outils.base_de_donnees:
- Filtrer par valeur dans des colonnes
- Permettre l'ajout de colonnes de l'intérieur de l'application
-
Placer la base de données dans son propre répertoire git externe, et automatiquement en faire des sauvegardes - Rendre les programmes exécutables avec un argument en ligne de commande & comme application
- Définir plus adéquatement les bases de données et leurs relations
- Permettre d'ajouter des sections de configuration
- Permettre d'ajouter des champs de configuration
- Rendre le logging plus compatible avec sqlalchemy.
- Retirer les logs sql, utiliser ceux de sqlalchemy à la place.
Dans les sous modules polygphys.laboratoires, polygphys.outils.appareils et polygphys.sst:
- Intégrer les applications externes
- Certificats laser
- PHS8302
En général:
- Compléter la suite de tests
Guide stylistique
Pendant le code, il est important de garder en tête les principes énoncés dans les documents suivants:
- PEP8, le guide stylistique de base pour le développement en Python
En fait, ces principes sont tellement importants que je recommande
d'utiliser le programme
autopep8qui peut formater un fichier automatiquement. - PEP20, le Zen de Python, des principes génériques de développement à favoriser quand c'est possible.
- Sphinx pour les chaines de documentation. Ça rend la compréhension future des programmes beaucoup plus facile. On se remerciera quand on sera vieux!
- Les noms de variables, modules, etc devraient suivre ces conventions.
- Dans la mesure du pratique, les noms de classes, fonctions et variables devraient être en français, de même pour la documentation.
Généralement, on veut aussi structurer les fichiers comme le document exemple.py.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file polygphys-6.0.21.tar.gz.
File metadata
- Download URL: polygphys-6.0.21.tar.gz
- Upload date:
- Size: 65.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 26525117724b4b1b513534df353a4464c1b677dfd64a35814cd0fc609522434f |
|
| MD5 | 0321aed119d9357d465b4f3c697c84b7 |
|
| BLAKE2b-256 | 8e719d5f5e5d7f790c67598f109b300cbf8f5e7a82edb598421989b91e661fca |
File details
Details for the file polygphys-6.0.21-py3-none-any.whl.
File metadata
- Download URL: polygphys-6.0.21-py3-none-any.whl
- Upload date:
- Size: 73.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f4ed17b0d90b86a1aec478694521f095846ec3c00aef66f91a7f0f7548043d35 |
|
| MD5 | 703bbb4780f7d852898f3c9744a83eab |
|
| BLAKE2b-256 | e0aed0ef1bdf6d8221522e335d54a817b9e2793a8bdd62e68c4c080f7198247b |
