Média Harmônica em Código
Sobre a Matemática
Média harmônica de vários números é o inverso da média aritmética dos inversos desses números.
Sobre o Código
Na linguagem de programação Python,
def – é a palavra-chave usada para definir uma função.
len() – é a função embutida que retorna o número de elementos em uma lista, string ou outro objeto iterável.
return – é o comando que devolve um valor da função para quem a chamou.
sum() – é a função embutida que calcula a soma dos elementos de um iterável (lista, tupla, etc.).
for..in..: – é a estrutura de repetição que percorre cada elemento de um iterável, executando o bloco de código para cada item.
[] – é a notação para criar uma lista. Exemplo: [1, 2, 3].
print() – é a função embutida que exibe informações na tela/console.
import – é a palavra-chave usada para trazer bibliotecas externas ou internas para o código. Biblioteca, por sua vez, é um conjunto de códigos prontos que oferecem funções e ferramentas para resolver problemas específicos, sem precisar programar tudo do zero.
statistics – é biblioteca padrão que fornece funções estatísticas (média, mediana, variância, etc.).
.harmonic_mean() – é a função da biblioteca statistics que calcula a média harmônica de uma lista de números.
pip install – é o comando usado fora (no terminal) para instalar pacotes adicionais da comunidade (ex.: pip install scipy).
from – é a palavra-chave usada para importar partes específicas de uma biblioteca.
scipy.stats – é o submódulo da biblioteca scipy que contém funções estatísticas avançadas.
hmean() – é a função dentro de scipy.stats que calcula a média harmônica.
# – é usado para criar comentários ao código, que são notas para se entender melhor o que o código faz.
Vamos ao código…
# Exemplo 1: Implementação manual
def media_harmonica(valores):
n = len(valores)
return n / sum(1/x for x in valores)
numeros = [1, 2, 4]
print("Média harmônica (manual):", media_harmonica(numeros))| Código Python (.py) | O que faz |
| def media_harmonica(valores): | Define uma função chamada media_harmonica que recebe uma lista de números (valores). |
| n = len(valores) | Calcula a quantidade de elementos na lista e armazena em n. |
| return n / sum(1/x for x in valores) | Retorna a fórmula da média harmônica: número de elementos dividido pela soma dos inversos dos valores. |
| numeros = [1, 2, 4] | Cria uma lista de números para exemplo. |
| print(“Média harmônica (manual):”, media_harmonica(numeros)) | Chama a função media_harmonica com a lista e imprime o resultado. |
Saída do código (valor de retorno)…
Média harmônica (manual): 1.7142857142857142
# Exemplo 2: Usando a biblioteca statistics (Python 3.6+)
import statistics
print("Média harmônica (statistics):", statistics.harmonic_mean(numeros))| Código Python (.py) | O que faz |
| import statistics | Importa a biblioteca statistics, que contém funções estatísticas prontas. |
| print(“Média harmônica (statistics):”, statistics.harmonic_mean(numeros)) | Usa a função harmonic_mean da biblioteca statistics para calcular a média harmônica e imprime o resultado. |
Saída do código (valor de retorno)…
Média harmônica (statistics): 1.7142857142857142
# Exemplo 3: Usando scipy
from scipy.stats import hmean
print("Média harmônica (scipy):", hmean(numeros))| Código Python (.py) | O que faz |
| from scipy.stats import hmean | Importa a função hmean da biblioteca scipy.stats, que calcula a média harmônica. |
| print(“Média harmônica (scipy):”, hmean(numeros)) | Calcula a média harmônica com scipy e imprime o resultado. |
Saída do código (valor de retorno)…
Média harmônica (scipy): 1.7142857142857142
Fonte:
– Editora Didática Paulista. Ensino Didático 2000: Ensino Fundamental e Ensino Médio. Sorocaba: Editora Didática Paulista, [s.d.].
– Códigos e comentários gerados por Microsoft Copilot com revisão nossa.
– https://docs.python.org/pt-br/3/ [Documentação Oficial do Python]