mooringDesignSimulator-v2 - Installation

Installation des binaires

Les binaires précompilés pour Windows, Linux et macOS sont disponibles depuis le dossier OneDrive partagé:

Télécharger les binaires mooringDesignSimulator-v2

Téléchargez l’archive adaptée au système d’exploitation, extrayez-la dans un dossier de travail, puis lancez l’exécutable fourni.

Environnement utilisé pour le développement

Le projet s’appuie actuellement sur un environnement Conda nommé pyside6 et cible Python 3.11.

Dépendances principales:

pyside6
qt6-charts
matplotlib
numpy
reportlab
appdirs
toml
xlrd
netcdf4
packaging
pyinstaller
pytest

netcdf4 est requis car l’import de profils de courant NetCDF fait partie des fonctions supportées.

Créer l’environnement

Créez d’abord un environnement utilitaire avec mamba si nécessaire:

conda create -n mambaenv -c conda-forge mamba python=3.11
conda activate mambaenv

Créez ensuite l’environnement applicatif:

mamba env create -f environment.yml
conda activate pyside6

Mettre à jour un environnement existant

mamba env update -n pyside6 -f environment.yml --prune

Lancer l’application

Depuis l’environnement activé:

python main.py

Ou directement avec Conda:

conda run --no-capture-output -n pyside6 python main.py

Avec journalisation de debug:

conda run -n pyside6 python main.py -d -l

Tâches courantes

Si task est installé, les commandes principales sont :

task
task: Available tasks for this project:
  audit-images:       Audit referenced and unreferenced library image files
  build:              Build a standalone executable with PyInstaller
  buildecho:          Build a standalone executable with PyInstaller and output echoed commands
  clean:              Remove Python cache files
  clean-all:          Remove Python caches and PyInstaller build artifacts
  clean-build:        Remove PyInstaller build artifacts and generated spec files
  debug:              Launch the application with debug logging
  default:            Show available tasks
  lib:                Launch the application with the test Excel library
  lint:               Run pylint on the Python entry points
  render:             Launch the standalone render lab on the main Excel library
  res:                Rebuild Qt resources
  run:                Launch the application
  test:               Run the unit test suite

Commandes make équivalentes, en version abrégée :

make
Available targets:
  make run           Launch the application
  make debug         Launch the application with debug logging
  make lib           Launch with the test Excel library
  make render        Launch the standalone render lab
  make audit-images  Audit referenced and unreferenced library images
  make test          Run the unit test suite
  make lint          Run pylint on the Python entry points
  make res           Rebuild Qt resources
  make build         Build a standalone executable with PyInstaller
  make buildecho     Build with streamed command output
  make clean         Remove Python cache files
  make clean-build   Remove PyInstaller build artifacts
  make clean-all     Run clean and clean-build

Des commandes directes équivalentes sont également possibles :

conda run --no-capture-output -n pyside6 python -m unittest discover -v tests
conda run -n pyside6 python -m PyInstaller -wF -c --clean --name mooringDesignSimulator main.py

Précédent: Vue d’ensemble | Retour à la documentation | Retour au sommaire | Suivant: Utilisation