Pular para o conteúdo
Skillpedia
Análise e planilhas51 mil · #1985

statistical-power

Faz seu agente calcular o tamanho de amostra e o poder estatístico para planejar estudos. É útil quando você precisa saber quantos participantes ou dados são necessários.

O que ela faz

Esta ferramenta ajuda a calcular quantos participantes ou amostras você precisa para um estudo científico. Ela também pode dizer qual o menor efeito que seu estudo consegue detectar com um certo número de participantes.

Quando usar

  • ✓Antes de começar um estudo, para saber quantas pessoas incluir.
  • ✓Para planejar um experimento e garantir que ele seja capaz de encontrar um resultado importante.
  • ✓Para justificar o número de participantes em pedidos de financiamento ou aprovação ética.

Exemplo do que pedir para a IA

“Quantas pessoas preciso para detectar uma diferença de tamanho médio entre dois grupos?”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/K-Dense-AI/scientific-agent-skills/blob/main/skills/statistical-power/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/K-Dense-AI/scientific-agent-skills/blob/main/skills/statistical-power/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

Você informa o tipo de teste estatístico que pretende usar, o tamanho do efeito que considera importante e o nível de confiança desejado. A ferramenta calcula o número de amostras necessário ou o menor efeito detectável.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add K-Dense-AI/scientific-agent-skills --skill statistical-power

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/main/skills/statistical-power/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Poder Estatístico e Tamanho da Amostra

Visão Geral

A análise de poder planeja a probabilidade de rejeitar uma hipótese nula especificada sob uma alternativa assumida. Ela responde quantas unidades experimentais independentes são necessárias para detectar um efeito cientificamente importante, ou quais efeitos uma amostra viável poderia detectar. Escolha primeiro o objetivo inferencial: precisão, equivalência, não-inferioridade ou monitoramento sequencial exigem seus próprios cálculos; os auxiliares de teste de superioridade agrupados não os cobrem.

Quatro quantidades estão interligadas para qualquer teste específico: tamanho da amostra (n), tamanho do efeito, nível de significância (α) e poder (1 − β). Para um desenho, análise e parâmetros de incômodo fixos, fixar três permite resolver para o quarto quando uma solução existe. Cada cálculo nesta habilidade é alguma reorganização dessa relação.

Esta habilidade abrange as duas maneiras de fazer análise de poder:

  • Cálculos de poder analíticos (exatos sob algumas suposições de teste padrão; aproximações assintóticas para outros) — veja references/closed_form_recipes.md.
  • Simulação / Monte Carlo (requer um processo gerador de dados crível e uma análise planejada calibrada) — veja references/simulation_based_power.md.

Para escolher e converter tamanhos de efeito — geralmente a parte mais difícil — veja references/effect_sizes.md.

Quando Usar Esta Habilidade

  • Determinar o tamanho de amostra necessário antes de coletar dados (análise de poder a priori)
  • Encontrar o efeito mínimo detectável (MDE) para um tamanho de amostra fixo e já determinado
  • Produzir curvas de poder (poder vs. n, ou poder vs. tamanho do efeito) para uma bolsa de pesquisa ou protocolo
  • Justificar um tamanho de amostra para submissão ao IRB, bolsa de pesquisa ou pré-registro
  • Potencializar desenhos com tamanhos de grupo desiguais ou alocação não 1:1
  • Planejar modelos mistos complexos, GLMs, clustering, sobrevivência, mediação e interações através de simulação quando aproximações mais simples não se encaixam
  • Considerar comparações múltiplas, atrito/desistência ou clustering na estimativa do tamanho da amostra

Instalação

Os exemplos locais foram verificados em Python 3.13 com statsmodels 0.15.0, SciPy 1.18.1, NumPy 2.5.3, pandas 2.3.3 e Matplotlib 3.11.2. Use um ambiente separado do ambiente de desenvolvimento do repositório:

uv venv --python 3.13 .venv-power
uv pip install --python .venv-power/bin/python "statsmodels==0.15.0" "scipy==1.18.1" "numpy==2.5.3" "pandas==2.3.3" "matplotlib==3.11.2"
# Optional comparison / survival methods (also checked for current API use):
uv pip install --python .venv-power/bin/python "pingouin==0.7.0" "lifelines==0.30.3"

No Windows, use .venv-power/Scripts/python.exe. Lifelines 0.30.3 requer pandas<3; o pin testado acima o acomoda. Modelos mistos e GLMs estão incluídos no statsmodels. Registre versões e sementes com a saída; testes de fumaça numéricos não estabelecem as suposições de efeito de um estudo ou controle de erro Tipo I.


A única decisão que impulsiona tudo: o tamanho do efeito

Os cálculos de poder são tão confiáveis quanto o tamanho do efeito que você insere neles. Não invente um número. Use, em ordem aproximada de preferência:

  1. Um efeito minimamente importante — o menor efeito que realmente mudaria uma decisão ou importaria cientificamente/clinicamente (o "menor tamanho de efeito de interesse", SESOI). Esta é a base mais defensável: você calcula o poder para detectar o que importa, não o que você espera ver.
  2. Uma estimativa de estudo piloto ou prévio, com incerteza e viés de seleção considerados. Pilotos pequenos são imprecisos; a seleção baseada em publicação ou significância pode inflar os efeitos. Use um modelo de incerteza justificado ou uma faixa de sensibilidade em vez de um fator de encolhimento arbitrário.
  3. Uma convenção (pequeno/médio/grande de Cohen) apenas como último recurso, e diga isso explicitamente.

O que quer que você escolha, execute uma análise de sensibilidade: relate como o n necessário muda em uma faixa plausível de tamanhos de efeito, não um único ponto. Uma análise de poder apresentada como um único número esconde sua maior fonte de incerteza. Veja references/effect_sizes.md para benchmarks e conversões entre d, f, r, η², odds ratios e h/w de Cohen.

…

Perguntas frequentes

O que é 'tamanho do efeito'?

É uma medida de quão grande é a diferença ou a relação que você espera encontrar. Um tamanho de efeito maior é mais fácil de detectar.

O que é 'poder estatístico'?

É a probabilidade do seu estudo encontrar um efeito real, se ele existir. Geralmente, busca-se 80% de poder.

Posso usar isso para estudos já concluídos?

Não é recomendado. Calcular o poder após o estudo (poder 'post-hoc') pode ser enganoso. É melhor focar em calcular o menor efeito detectável ou usar intervalos de confiança.

Detalhes

Descrição original do autor

Calculates sample sizes and statistical power for study planning. Applies when someone asks "how many subjects/samples/replicates do I need", wants an a priori power analysis, a minimum detectable effect (MDE), a power curve, or needs to justify a sample size for a grant, IRB protocol, or pre-registration. Covers closed-form power for t-tests, ANOVA, proportions, correlations, chi-square, and regr

repo: K-Dense-AI/scientific-agent-skills

Popularidade

Estrelas no GitHub
51 mil
Posição no ranking
#1985
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas