PáginasPainel de saída · 19 / 29

Painel de saída

O painel de saída fica na parte inferior do espaço de trabalho do QuantCraft e é onde aparece tudo o que o seu código diz ou desenha — instruções print(), mensagens de erro, gráficos e o progresso de backtests demorados.

Ele é compartilhado entre Run e Test: cada execução o limpa e escreve uma saída nova conforme avança. As métricas e os gráficos estruturados aparecem em Resultados dos testes.

Abrindo, recolhendo e redimensionando

O painel abre automaticamente assim que algo novo é registrado ou desenhado, para que você não perca nenhuma saída.
Clique no título Output (ou na seta ao lado) para recolher ou expandir o painel.
O divisor horizontal acima do painel pode ser arrastado para cima ou para baixo para dar mais ou menos espaço de tela a ele. Você também pode focar o divisor e usar as setas Para cima / Para baixo para ajustá-lo.
A altura do painel de saída (e a divisão do editor) é lembrada entre as sessões.

Logs (`stdout` e mensagens de execução)

Tudo o que o seu script escreve na saída padrão aparece como uma linha de log com carimbo de data e hora no painel:

[14:32:11] Loaded 480 bars
[14:32:11] Entering position at 192.40
[14:32:13] Final equity: 102450.13

Vale saber:

Cada entrada recebe o carimbo de hora do seu relógio local.
O texto do log usa fonte monoespaçada e quebra linha, para que linhas longas permaneçam legíveis sem rolagem horizontal.
O painel rola automaticamente até a mensagem mais recente conforme a saída chega, tanto durante a execução quanto logo após ela terminar.
Um breve marcador (no output) é exibido se o seu script terminou sem nada para imprimir.
Quando os dados de calendário estão ativados, o mecanismo escreve uma linha [calendar] para cada evento corporativo aplicado (desdobramento ou dividendo), além de um resumo no final, por exemplo:
[calendar] 2024-01-10 AAPL — SPLIT 4:1 applied to 1 position(s): 100 -> 400 shares (cost basis unchanged; bars stay unadjusted) [calendar] 2024-02-09 AAPL — DIVIDEND $0.2400/share on 400 share(s): +$96.00 cash … [calendar] corporate actions — 1 split(s) applied; 1 dividend(s) applied (0 exact ex-date, 1 estimated +/-7d)
Se nenhuma linha [calendar] aparecer, verifique se Include calendar data está ativado na caixa de execução — veja Dados de calendário.
Em um backtest com Screener, uma aba Screener Output aparece ao lado de Logs, listando cada data de rebalanceamento e os símbolos negociados naquela janela — veja Screener.

Há um limite de cerca de 200 entradas por aba; as linhas mais antigas são descartadas quando o limite é atingido. Em execuções que geram enormes quantidades de saída, prefira resumir no código ou imprimir a cada N barras.

Erros (`stderr`)

Tudo o que é escrito na saída de erro padrão — rastreamentos de exceção, avisos que o seu código envia ao stderr ou mensagens do framework — é destacado em vermelho e contado no cabeçalho do painel:

Um pequeno selo N error / N errors aparece ao lado do título Output mostrando quantas linhas de erro foram registradas.
Os erros mantêm o carimbo de hora, como as linhas de log normais, para que você possa associá-los aos eventos ao redor.
Se uma execução terminar com um código de saída diferente de zero, mas não tiver escrito no stderr, você verá uma única linha de erro (exit code N) para saber que a execução falhou.

A contagem de erros é um contador ao vivo — limpar a saída (o que acontece no início de cada Run / Test) o redefine, e se a nova execução instalar um pacote ou se recuperar de uma falha anterior, a contagem é removida.

Gráficos

O painel de saída renderiza figuras em linha do seu código, então você não precisa de um visualizador externo.

Matplotlib

Qualquer figura do Matplotlib que o seu código exibir durante a execução aparece como uma imagem PNG ajustada à largura do painel. São ótimas para gráficos exploratórios rápidos.

Plotly

As figuras do Plotly são renderizadas como gráficos totalmente interativos dentro do painel:

Passe o cursor sobre uma série para ver os valores exatos.
Aplique zoom e arraste com o mouse / toque.
Use a barra de ferramentas do Plotly para baixar, ajustar a escala automaticamente e outras ações.
O gráfico é redimensionado junto com o painel.

Cada gráfico — Matplotlib ou Plotly — aparece em seu próprio bloco com moldura na linha do tempo do painel, junto com as linhas de log, para que você veja exatamente onde ele foi produzido em relação à saída do print().

Gráficos e logs compartilham o mesmo limite por aba; portanto, sequências muito longas de figuras acabarão empurrando para fora da vista a saída anterior.

Progresso de execuções longas

Quando um backtest está em execução, o cabeçalho do painel ganha dois elementos extras para que você acompanhe o progresso sem ficar olhando logs que rolam:

Uma barra de progresso com um rótulo como:
- Bar 1234 / 5000 — quantas barras simuladas foram processadas.
- Run 3 / 10 — em uma otimização em andamento, a execução atual do total.
- Gen 2/5 · 7/16 — na otimização genética, geração/indivíduo atual.
- Backtest running enquanto o mecanismo já iniciou, mas ainda não há um progresso exato disponível.
A barra cresce conforme o mecanismo informa o progresso e desaparece assim que a execução termina.

Você pode recolher o painel e a barra de progresso continua visível no cabeçalho, de modo que o estado da execução está sempre a um olhar de distância — mesmo que você esteja focado no editor.

Botão Disclaimer

O cabeçalho tem um botão Disclaimer que abre um breve aviso sobre como o QuantCraft executa Python na sua máquina. É a mesma explicação que você vê antes do primeiro Run, disponível a qualquer momento para reler. Fechar essa caixa de diálogo não altera suas configurações.

Dicas

O print() é seu amigo para depuração rápida. Mantenha as mensagens curtas e identifique-as com rótulos (f"[ENTRY] {symbol} {qty} @ {price}") para que sejam fáceis de percorrer.
Envie detalhes longos para um arquivo no seu código em vez de imprimir milhares de linhas — apenas as últimas ~200 entradas permanecem visíveis.
Os erros são vermelhos e contados no selo — quando você vir a contagem subir, role até o final; o erro mais recente costuma ser o que interrompeu a execução.
No Plotly, use o divisor de redimensionamento do painel para dar mais altura ao gráfico; ele se ajusta automaticamente.
O painel é compartilhado entre arquivos: se você trocar de aba durante uma execução, a saída que você vê é a da última execução / da execução ativa.

6 min de leituraSugerir uma edição ↗