Módulo 1 • Preparação
Ambiente e fluxo de trabalho
Visão inicial
Um notebook reúne explicações, código e resultados em uma sequência que pode ser repetida.
Comece importando apenas as bibliotecas necessárias e registre a fonte e o período dos dados.
Executar as células na ordem correta evita resultados dependentes de estados antigos do ambiente.
Ponte de fundamentos
Vocabulário essencial antes de avançar
Curso intermediário não deve significar explicação incompleta. Se algum termo abaixo for novo, explore-o antes de seguir.
Variável
Nome que guarda um valor na memória.
ATIVO = "PETR4"Ao final desta aula, você será capaz de
Leitura aprofundada
Entenda antes de automatizar
Do script improvisado ao experimento reproduzível
Uma análise financeira não termina quando o gráfico aparece. Ela precisa deixar rastros suficientes para que outra pessoa — ou você mesmo no futuro — consiga reconstruir o resultado. Isso inclui pergunta, fonte, período, versão dos dados, bibliotecas e decisões de tratamento.
A ordem recomendada é: objetivo e hipótese; imports; parâmetros; coleta; validações; transformação; análise; conclusão e limitações. Essa separação reduz o risco de alterar uma variável no meio do notebook e esquecer de executar uma etapa anterior.
Teste de qualidade: reinicie o ambiente, execute todas as células e confirme que o resultado é o mesmo.
Estado, escopo e dependências
Notebooks mantêm objetos na memória. Por isso, uma célula pode funcionar mesmo quando o código que criou a variável foi apagado. O número de execução das células ajuda a detectar esse problema, mas o melhor diagnóstico continua sendo executar o documento do zero.
Parâmetros de pesquisa devem ficar concentrados no início. Símbolos, datas, frequência e caminhos não deveriam estar espalhados pelo código. Essa disciplina torna comparações mais rápidas e evita resultados misturados entre experimentos.
Infográfico interativo
Do dado à decisão, etapa por etapa
Pergunta de controleOutra pessoa conseguiria repetir sua análise sem perguntar o que você fez?
Roteiro prático
Teoria, demonstração e código
Como construir uma análise que continue funcionando quando o notebook for aberto novamente?
- 7 minConceitos
- 5 minDemonstração
- 9 minPrática guiada
- 5 minDesafio
Base conceitual
Antes de executar
Notebook é um documento executável
Células Markdown registram pergunta, fonte, período e decisões. Células de código executam o protocolo. O resultado deve ser compreensível mesmo meses depois.
Estado e ordem de execução
Uma variável pode permanecer na memória mesmo após sua célula ser alterada. Reiniciar o ambiente e executar tudo do início ao fim é o teste mais simples de reprodutibilidade.
Dependências e versões
Python, pandas e bibliotecas de coleta evoluem. Registrar versões reduz diferenças entre computadores e ajuda a diagnosticar resultados inesperados.
Notebook guiado
Primeiro notebook financeiro
Organize imports, parâmetros e metadados antes de trabalhar com os dados.
import sys
import pandas as pd
import numpy as np
ATIVO = "PETR4"
INICIO = "2021-01-01"
FIM = "2025-12-31"
print(f"Python: {sys.version.split()[0]}")
print(f"pandas: {pd.__version__}")
print({"ativo": ATIVO, "inicio": INICIO, "fim": FIM})Python: 3.x.x
pandas: 2.x.x
{'ativo': 'PETR4', 'inicio': '2021-01-01', 'fim': '2025-12-31'}- Parâmetros em maiúsculas ficam visíveis e fáceis de alterar.
- Imports agrupados evitam dependências escondidas.
- A versão exata será a instalada no ambiente do aluno.
Clínica de erros
Aprenda também quando o código falha
A variável foi criada em uma célula que ainda não foi executada.
Reinicie o ambiente e use Executar tudo para localizar a dependência fora de ordem.
Desafio da aula
Ficha de reprodutibilidade
Crie a abertura de um notebook para comparar PETR4 com o IBOV.
- 1
Escreva a pergunta em Markdown.
- 2
Crie parâmetros para ativos e período.
- 3
Registre versões de Python, pandas e NumPy.
- 4
Reinicie e execute todas as células.
Vídeo visual autoral
Assista ao conceito ganhar movimento
Funciona apenas na sua tela
Variáveis antigas e células fora de ordem escondem dependências.
Leitura orientada do código
Não apenas copie: entenda os blocos
ATIVO = "PETR4"Define os objetos e valores de entrada usados no experimento.
configuracao = {"ativo": ATIVO, "inicio": INICIO, "fim": FIM}Organiza a estrutura sobre a qual os cálculos serão executados.
Laboratório executável
Auditoria de reprodutibilidade
Execute, altere o ativo e observe como uma única célula de parâmetros controla toda a saída.
Clique em Executar para iniciar o laboratório.
A saída deve listar os três parâmetros sem erros.
Quais valores do seu projeto atual ainda estão escritos diretamente no meio do código?