Matemática e geometria de sopradores centrífugos.
Projeto de referência para a geometria e o dimensionamento preliminar de sopradores centrífugos. Reúne as equações de turbomáquinas do documento Matemática dos Sopradores em uma biblioteca Python testável, uma CLI e documentação com as fórmulas.
O nome Voluta vem da carcaça em espiral do soprador, responsável por converter a energia cinética do ar em pressão estática.
- Traça a voluta em espiral de Arquimedes:
R(θ) = R₂ + K · θ / 2π. - Calcula triângulo de velocidades, equação de Euler e velocidade periférica.
- Dimensiona diâmetros de entrada e saída, largura de pá e potência no eixo.
- Aplica as leis de afinidade para mudança de rotação e diâmetro.
- Gera imagens do perfil da voluta em PNG, SVG ou PDF.
- Oferece uma CLI (
voluta plot,voluta designevoluta gui) e uma API Python. - Inclui uma interface gráfica Qt com pré-visualização do perfil e calculadora de dimensionamento.
O dimensionamento implementado é preliminar. Perdas, curvas reais do rotor, seleção de motor, resistência mecânica e ruído devem ser verificados em um projeto de engenharia completo.
- Python 3.10 ou superior
- uv para instalação e execução
Instale o uv, caso ainda não tenha:
curl -LsSf https://astral.sh/uv/install.sh | shgit clone https://github.com/dionarley/voluta.git
cd voluta
uv syncO comando cria o ambiente virtual em .venv/, instala o pacote em modo
editável e baixa as dependências de desenvolvimento e documentação.
A cada tag v*, o workflow Binaries gera executáveis standalone com
PyInstaller e publica no GitHub Releases.
| Plataforma | Arquivo |
|---|---|
| Linux x86_64 | voluta-linux-x86_64 |
| macOS Intel | voluta-macos-x86_64 |
| macOS Apple Silicon | voluta-macos-arm64 |
| Windows x86_64 | voluta-windows-x86_64.exe |
Linux e macOS:
chmod +x voluta-linux-x86_64
./voluta-linux-x86_64 --versionNo macOS, se o sistema bloquear o executável por quarentena:
xattr -d com.apple.quarantine voluta-macos-arm64Windows:
.\voluta-windows-x86_64.exe --versionOs binários não são assinados digitalmente. O Windows pode exibir o aviso do SmartScreen e o macOS pode pedir confirmação no primeiro uso.
A cada tag v*, o workflow Flatpak gera um bundle independente de
distribuição. Baixe voluta.flatpak em
GitHub Releases e execute:
flatpak install --user voluta.flatpak
flatpak run io.github.dionarley.volutaO manifesto, o ícone, os metadados AppStream e as instruções de build estão em
flatpak/ e em docs/flatpak.md.
Gerar a imagem padrão da voluta:
uv run voluta plot --output voluta.pngDimensionar um soprador com vazão de 0,5 m³/s, elevação de pressão de
1.200 Pa e rotação de 3.000 RPM:
uv run voluta design --flow 0.5 --pressure 1200 --rpm 3000Saída em JSON, útil para scripts:
uv run voluta design --flow 0.5 --pressure 1200 --rpm 3000 --jsonTambém é possível executar como módulo:
uv run python -m voluta --helpA interface usa PySide6 (Qt para Python) e matplotlib. Ela permite ajustar os parâmetros da voluta, visualizar o perfil em tempo real, calcular o dimensionamento e exportar a imagem ou o resultado em JSON.
uv sync --group gui
uv run voluta guiTambém é possível instalar a interface como extra do pacote:
pip install ".[gui]"
voluta guiNo NixOS, o PySide6 precisa de bibliotecas de sistema como libGL, xcb,
libX11 e dbus. O repositório inclui um shell.nix com esse ambiente:
nix-shell --run 'uv run voluta gui'Se você instalou o comando globalmente, também pode usar:
nix-shell --run 'voluta gui'from voluta import design_blower, plot_volute, volute_profile
# Perfil geométrico da voluta
perfil = volute_profile(r2=100.0, k=25.0, turns=1.5)
print(perfil.outlet_radius) # 137.5
# Imagem do perfil
plot_volute(perfil, output="voluta.png", dpi=150)
# Dimensionamento preliminar (SI: m³/s, Pa, RPM)
projeto = design_blower(
flow_rate_m3_s=0.5,
pressure_rise_pa=1200.0,
rpm=3000.0,
pressure_coefficient=0.6,
inlet_velocity_m_s=20.0,
efficiency=0.7,
)
print(f"D2 = {projeto.outlet_diameter_mm:.1f} mm")
print(f"Potência = {projeto.shaft_power_kw:.2f} kW")Consulte docs/uso.md para todos os comandos e exemplos.
| Grandeza | Equação | Função |
|---|---|---|
| Velocidade periférica | U = π D N / 60 |
peripheral_velocity |
| Pressão teórica (Euler) | ΔP_th = ρ (U₂ C_u2 − U₁ C_u1) |
euler_pressure |
| Diâmetro de saída | U₂ = √(2 ΔP / (ρ ψ)), D₂ = 60 U₂ / (π N) |
outlet_diameter |
| Diâmetro de entrada | D₁ = √(4 Q / (π C_1m)) |
inlet_diameter |
| Largura da pá | b = Q / (π D C_m) |
blade_width |
| Potência no eixo | P = Q ΔP / η |
shaft_power |
| Voluta | R(θ) = R₂ + K θ / 2π |
volute_radius |
| Leis de afinidade | Q ∝ N D³, ΔP ∝ N² D², P ∝ N³ D⁵ |
affinity_* |
A dedução e as hipóteses estão em docs/matematica.md.
.
├── .github/workflows/ # CI, Pages, binários e Flatpak
│ ├── binaries.yml
│ ├── ci.yml
│ ├── docs.yml
│ └── flatpak.yml
├── assets/ # ícone, banner, screenshot, PDF e SVG
├── docs/ # documentação MkDocs
│ ├── api.md
│ ├── index.md
│ ├── flatpak.md
│ ├── matematica.md
│ ├── referencias.md
│ └── uso.md
├── examples/ # scripts de exemplo
├── flatpak/ # manifesto e metadados Flatpak
├── hooks/copy_assets.py # copia assets para o site
├── scripts/entrypoint.py # entrada do PyInstaller
├── shell.nix # ambiente NixOS com bibliotecas Qt
├── src/voluta/ # código-fonte do pacote
│ ├── aero.py # equações de dimensionamento
│ ├── cli.py # interface de linha de comando
│ ├── geometry.py # voluta e perfil cartesiano
│ ├── gui.py # interface gráfica Qt
│ └── plots.py # visualização com matplotlib
├── tests/ # testes com pytest
├── LICENSE # licença MIT
├── pyproject.toml # metadados, dependências e ferramentas
├── README.md
└── uv.lock # resolução reproduzível do uv
A branch develop concentra o desenvolvimento; main recebe as versões
estáveis.
uv sync # instala dependências
uv run pytest # executa os testes
uv run pytest --cov # testes com cobertura
uv run ruff check . # análise estática
uv run ruff format --check . # verifica formataçãoGerar a documentação localmente:
uv run mkdocs serveAcesse http://127.0.0.1:8000. Para validar o build:
uv run mkdocs build --strictDocumentação publicada: https://dionarley.github.io/voluta/
Distribuído sob a licença MIT. Consulte LICENSE.

