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))

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))

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))

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]