Referência da API¶
Documentação gerada automaticamente a partir das docstrings do pacote.
Pacote¶
voluta ¶
Voluta: geometria da carcaça, dimensionamento e visualização de sopradores.
O pacote reúne as equações do documento Matemática dos Sopradores em uma API Python testável e em uma interface de linha de comando.
Examples:
>>> from voluta import design_blower, volute_profile
>>> profile = volute_profile(turns=1.0)
>>> profile.outlet_radius
125.0
>>> design = design_blower(0.5, 1200, 3000)
>>> round(design.outlet_diameter_mm)
368
Geometria¶
voluta.geometry ¶
Geometria da voluta (carcaça espiral) de um soprador centrífugo.
A voluta é modelada pela espiral de Arquimedes. Em coordenadas polares, o raio cresce linearmente com o ângulo polar medido a partir da língua da voluta:
.. math::
R(\theta) = R_2 + K \frac{\theta}{2\pi}
onde R2 é o raio externo do rotor e K é a taxa de expansão da voluta
(comprimento por volta).
VoluteProfile
dataclass
¶
Perfil geométrico completo de uma voluta.
Attributes:
| Name | Type | Description |
|---|---|---|
theta |
FloatArray
|
Ângulos polares em radianos. |
radius |
FloatArray
|
Raios da voluta em milímetros (ou na unidade adotada para |
x, y |
Coordenadas cartesianas correspondentes. |
|
r2 |
float
|
Raio externo do rotor. |
k |
float
|
Taxa de expansão da voluta por volta. |
Source code in src/voluta/geometry.py
29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 | |
volute_radius ¶
volute_radius(
theta: ArrayLike, *, r2: float = 100.0, k: float = 25.0
) -> FloatArray
Calcula o raio da voluta em função do ângulo polar.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
theta
|
ArrayLike
|
Ângulo polar em radianos. Pode ser um escalar ou um array. |
required |
r2
|
float
|
Raio externo do rotor, na mesma unidade desejada para o resultado. |
100.0
|
k
|
float
|
Taxa de expansão da voluta por volta (unidade de comprimento por volta). |
25.0
|
Returns:
| Type | Description |
|---|---|
ndarray
|
Raio da voluta. Para uma entrada escalar, o resultado é um array 0-D. |
Raises:
| Type | Description |
|---|---|
ValueError
|
Se |
Examples:
>>> float(volute_radius(0.0))
100.0
>>> float(volute_radius(2 * np.pi))
125.0
Source code in src/voluta/geometry.py
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | |
volute_profile ¶
volute_profile(
*,
r2: float = 100.0,
k: float = 25.0,
turns: float = 1.5,
samples: int = 1000,
start_angle: float = 0.0,
) -> VoluteProfile
Gera o perfil cartesiano da voluta.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
r2
|
float
|
Raio externo do rotor. |
100.0
|
k
|
float
|
Taxa de expansão da voluta por volta. |
25.0
|
turns
|
float
|
Número de voltas do traçado. O valor padrão, |
1.5
|
samples
|
int
|
Quantidade de pontos do perfil. Deve ser pelo menos 2. |
1000
|
start_angle
|
float
|
Ângulo inicial em radianos. |
0.0
|
Returns:
| Type | Description |
|---|---|
VoluteProfile
|
Ângulos, raios e coordenadas cartesianas do perfil. |
Examples:
>>> profile = volute_profile(turns=1.0, samples=5)
>>> len(profile.x)
5
>>> profile.outlet_radius
125.0
Source code in src/voluta/geometry.py
114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | |
Aerodinâmica e dimensionamento¶
voluta.aero ¶
Equações de dimensionamento e escalabilidade de sopradores centrífugos.
Todas as funções usam unidades do SI: metros, segundos, pascal, watt e rotações por minuto (RPM).
BlowerDesign
dataclass
¶
Resultado de um dimensionamento preliminar de soprador centrífugo.
Source code in src/voluta/aero.py
266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 | |
to_dict ¶
to_dict() -> dict[str, Any]
Converte o resultado em um dicionário serializável em JSON.
Source code in src/voluta/aero.py
297 298 299 300 301 302 303 304 305 | |
peripheral_velocity ¶
peripheral_velocity(diameter_m: float, rpm: float) -> float
Velocidade periférica do rotor.
.. math::
U = \frac{\pi D N}{60}
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
diameter_m
|
float
|
Diâmetro do rotor em metros. |
required |
rpm
|
float
|
Rotação em rotações por minuto. |
required |
Returns:
| Type | Description |
|---|---|
float
|
Velocidade periférica em m/s. |
Source code in src/voluta/aero.py
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | |
euler_pressure ¶
euler_pressure(
u2: float,
c_u2: float,
*,
u1: float = 0.0,
c_u1: float = 0.0,
rho: float = 1.2,
) -> float
Elevação de pressão teórica pela equação de Euler.
.. math::
\Delta P_{th} = \rho (U_2 C_{u2} - U_1 C_{u1})
Para entrada radial sem pré-rotação, C_u1 = 0.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
u2
|
float
|
Velocidade periférica e componente tangencial absoluta na saída (m/s). |
required |
c_u2
|
float
|
Velocidade periférica e componente tangencial absoluta na saída (m/s). |
required |
u1
|
float
|
Velocidade periférica e componente tangencial absoluta na entrada (m/s). |
0.0
|
c_u1
|
float
|
Velocidade periférica e componente tangencial absoluta na entrada (m/s). |
0.0
|
rho
|
float
|
Massa específica do ar em kg/m³. |
1.2
|
Returns:
| Type | Description |
|---|---|
float
|
Elevação de pressão teórica em pascal. |
Source code in src/voluta/aero.py
40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | |
outlet_diameter ¶
outlet_diameter(
pressure_rise_pa: float,
rpm: float,
*,
rho: float = 1.2,
pressure_coefficient: float = 0.6,
) -> float
Diâmetro externo do rotor a partir do coeficiente de pressão.
.. math::
U_2 = \sqrt{\frac{2 \Delta P_t}{\rho \psi}},
\qquad D_2 = \frac{60 U_2}{\pi N}
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
pressure_rise_pa
|
float
|
Aumento de pressão total desejado em pascal. |
required |
rpm
|
float
|
Rotação em RPM. |
required |
rho
|
float
|
Massa específica do ar em kg/m³. |
1.2
|
pressure_coefficient
|
float
|
Coeficiente adimensional de pressão :math: |
0.6
|
Returns:
| Type | Description |
|---|---|
float
|
Diâmetro externo do rotor em metros. |
Source code in src/voluta/aero.py
79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 | |
inlet_diameter ¶
inlet_diameter(
flow_rate_m3_s: float, inlet_velocity_m_s: float
) -> float
Diâmetro de entrada do rotor pela continuidade.
.. math::
D_1 = \sqrt{\frac{4Q}{\pi C_{1m}}}
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
flow_rate_m3_s
|
float
|
Vazão volumétrica em m³/s. |
required |
inlet_velocity_m_s
|
float
|
Velocidade meridional na entrada em m/s. Valores usuais ficam entre 15 e 25 m/s. |
required |
Returns:
| Type | Description |
|---|---|
float
|
Diâmetro de entrada em metros. |
Source code in src/voluta/aero.py
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | |
blade_width ¶
blade_width(
flow_rate_m3_s: float,
diameter_m: float,
meridional_velocity_m_s: float,
) -> float
Largura da pá em uma seção, pela conservação de massa.
.. math::
b = \frac{Q}{\pi D C_m}
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
flow_rate_m3_s
|
float
|
Vazão volumétrica em m³/s. |
required |
diameter_m
|
float
|
Diâmetro da seção em metros. |
required |
meridional_velocity_m_s
|
float
|
Componente meridional da velocidade em m/s. |
required |
Returns:
| Type | Description |
|---|---|
float
|
Largura da pá em metros. |
Source code in src/voluta/aero.py
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | |
shaft_power ¶
shaft_power(
flow_rate_m3_s: float,
pressure_rise_pa: float,
*,
efficiency: float = 0.7,
) -> float
Potência mecânica no eixo considerando a eficiência global.
.. math::
P_{eixo} = \frac{Q \Delta P_t}{\eta}
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
flow_rate_m3_s
|
float
|
Vazão volumétrica em m³/s. |
required |
pressure_rise_pa
|
float
|
Aumento de pressão total em pascal. |
required |
efficiency
|
float
|
Eficiência global entre 0 e 1. |
0.7
|
Returns:
| Type | Description |
|---|---|
float
|
Potência no eixo em watt. |
Source code in src/voluta/aero.py
174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 | |
affinity_flow ¶
affinity_flow(
flow_rate_m3_s: float,
*,
speed_ratio: float = 1.0,
diameter_ratio: float = 1.0,
) -> float
Nova vazão pelas leis de afinidade.
.. math::
Q_2 = Q_1 \left(\frac{N_2}{N_1}\right)
\left(\frac{D_2}{D_1}\right)^3
Source code in src/voluta/aero.py
209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 | |
affinity_pressure ¶
affinity_pressure(
pressure_rise_pa: float,
*,
speed_ratio: float = 1.0,
diameter_ratio: float = 1.0,
) -> float
Nova elevação de pressão pelas leis de afinidade.
.. math::
\Delta P_2 = \Delta P_1 \left(\frac{N_2}{N_1}\right)^2
\left(\frac{D_2}{D_1}\right)^2
Source code in src/voluta/aero.py
228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 | |
affinity_power ¶
affinity_power(
power_w: float,
*,
speed_ratio: float = 1.0,
diameter_ratio: float = 1.0,
) -> float
Nova potência pelas leis de afinidade.
.. math::
P_2 = P_1 \left(\frac{N_2}{N_1}\right)^3
\left(\frac{D_2}{D_1}\right)^5
Source code in src/voluta/aero.py
247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 | |
design_blower ¶
design_blower(
flow_rate_m3_s: float,
pressure_rise_pa: float,
rpm: float,
*,
rho: float = 1.2,
pressure_coefficient: float = 0.6,
inlet_velocity_m_s: float = 20.0,
efficiency: float = 0.7,
) -> BlowerDesign
Dimensiona os principais parâmetros geométricos de um soprador.
O cálculo combina o coeficiente de pressão, a continuidade na entrada e a potência no eixo. O resultado é preliminar e não substitui a verificação de perdas, resistência mecânica e curvas reais do rotor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
flow_rate_m3_s
|
float
|
Vazão volumétrica em m³/s. |
required |
pressure_rise_pa
|
float
|
Aumento de pressão total em pascal. |
required |
rpm
|
float
|
Rotação em RPM. |
required |
rho
|
float
|
Massa específica do ar em kg/m³. |
1.2
|
pressure_coefficient
|
float
|
Coeficiente adimensional de pressão :math: |
0.6
|
inlet_velocity_m_s
|
float
|
Velocidade meridional na entrada em m/s. |
20.0
|
efficiency
|
float
|
Eficiência global entre 0 e 1. |
0.7
|
Returns:
| Type | Description |
|---|---|
BlowerDesign
|
Diâmetros, velocidade periférica e potência no eixo. |
Source code in src/voluta/aero.py
308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 | |
Visualização¶
voluta.plots ¶
Visualização do perfil da voluta com matplotlib.
plot_volute ¶
plot_volute(
profile: VoluteProfile | None = None,
*,
r2: float = 100.0,
k: float = 25.0,
turns: float = 1.5,
samples: int = 1000,
output: str | Path | None = None,
dpi: int = 150,
show: bool = False,
title: str = DEFAULT_TITLE,
) -> Figure
Plota o perfil da voluta e o rotor.
Se profile não for informado, o perfil é criado com volute_profile
usando r2, k, turns e samples.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
profile
|
VoluteProfile | None
|
Perfil já calculado. Quando omitido, é gerado a partir dos parâmetros. |
None
|
r2
|
float
|
Parâmetros usados apenas quando |
100.0
|
k
|
float
|
Parâmetros usados apenas quando |
100.0
|
turns
|
float
|
Parâmetros usados apenas quando |
100.0
|
samples
|
float
|
Parâmetros usados apenas quando |
100.0
|
output
|
str | Path | None
|
Caminho opcional para salvar a figura (PNG, SVG, PDF etc.). |
None
|
dpi
|
int
|
Resolução usada ao salvar a figura. |
150
|
show
|
bool
|
Se |
False
|
title
|
str
|
Título do gráfico. |
DEFAULT_TITLE
|
Returns:
| Type | Description |
|---|---|
Figure
|
Figura criada. Quando |
Source code in src/voluta/plots.py
68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 | |
Linha de comando¶
voluta.cli ¶
Interface de linha de comando do projeto.
build_parser ¶
build_parser() -> argparse.ArgumentParser
Cria o parser de argumentos da CLI.
Source code in src/voluta/cli.py
24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | |
main ¶
main(argv: Sequence[str] | None = None) -> int
Executa a CLI e retorna o código de saída.
Source code in src/voluta/cli.py
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 | |