mooringDesignSimulator-v2 - Instalação

Instalação dos binários

Os binários pré-compilados para Windows, Linux e macOS estão disponíveis na pasta compartilhada do OneDrive:

Baixar os binários do mooringDesignSimulator-v2

Baixe o arquivo compactado correspondente ao sistema operacional, extraia-o em uma pasta de trabalho e execute o executável fornecido.

Ambiente utilizado para o desenvolvimento

O projeto apoia-se atualmente num ambiente Conda chamado pyside6 e visa Python 3.11.

Dependências principais:

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

netcdf4 é necessário porque a importação de perfis de corrente NetCDF faz parte das funções suportadas.

Criar o ambiente

Crie primeiro um ambiente utilitário com mamba, se necessário:

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

Crie em seguida o ambiente da aplicação:

mamba env create -f environment.yml
conda activate pyside6

Atualizar um ambiente existente

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

Lançar a aplicação

Dentro do ambiente ativado:

python main.py

Ou diretamente com Conda:

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

Com registros de debug:

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

Tarefas correntes

Se task estiver disponível, os comandos principais são:

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

Comandos make equivalentes, em forma abreviada:

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

Comandos diretos equivalentes também são possíveis:

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

Anterior: Visão geral | Voltar à documentação | Voltar ao sumário | Próximo: Utilização