Docs - Resultados

A seção de Resultados fornece uma análise detalhada do resultado da simulação, oferecendo métricas abrangentes de desempenho e um registro de eventos significativos durante a simulação.

Métricas (interface AlgoResult):

• summary: AlgoResultSummary - Uma visão geral concisa dos resultados da simulação, incluindo:
  • initCash: number (Saldo inicial em dinheiro)
  • finalCash: number (Saldo final em dinheiro)
  • totalVar: number (Retorno total como decimal)
  • annualVar: number (Retorno anualizado como decimal)
  • high: number (Valor mais alto do portfólio alcançado)
  • low: number (Valor mais baixo do portfólio alcançado)
  • nTrades: number (Número total de negociações executadas)
• performance: AlgoResultPerformance[] - Um array de objetos, cada um representando um ponto de dados na simulação, incluindo:
  • date: Date (A data do ponto de dados)
  • value: number (Valor do portfólio nesta data)
  • prevVariation: number (Variação percentual do ponto de dados anterior)
  • initVariation: number (Variação percentual do valor inicial)
  • drawdown: number (Drawdown atual como percentual do valor de pico)
• portfolio: AssetPortfolio - Representa o estado final do portfólio, incluindo saldo em dinheiro e todas as posições em ativos.
• portfolioHist: AssetPortfolio[] - Um array de objetos AssetPortfolio, representando os estados históricos do portfólio ao longo da simulação.
• assetHist: Record<string, AssetDataFlat[]> - Um registro de dados históricos para cada ativo, indexado pelo símbolo do ativo. Cada valor é um array de objetos AssetDataFlat contendo preço e outros dados relevantes para cada ponto de dados da simulação.
• tradeHist: Record<string, AssetTrade[]> - Um registro de todas as negociações executadas durante a simulação, indexado por data. Cada valor é um array de objetos AssetTrade detalhando as negociações feitas naquela data.

Saída de Mensagens:

Um array de mensagens de string registradas durante a simulação. Essas mensagens fornecem uma narrativa do progresso da simulação e incluem:

• Ações de negociação: Detalhes das ordens de compra e venda executadas pelo algoritmo.
• Injeções ou retiradas de dinheiro: Registros de qualquer dinheiro adicionado ou removido do portfólio.
• Eventos de rebalanceamento: Notificações de rebalanceamento do portfólio na simulação de Portfólio.
• Erros ou avisos: Quaisquer problemas encontrados durante a execução da simulação.

A combinação de métricas quantitativas e registros de mensagens qualitativas fornece aos usuários uma compreensão abrangente do desempenho e comportamento de seu algoritmo ao longo do período simulado. Esses dados podem ser usados para refinamento de estratégia, análise de desempenho e identificação de áreas para melhoria no algoritmo de negociação ou alocação de portfólio.

Gráficos:

Vários gráficos são gerados no final da execução para representar visualmente o desempenho e comportamento do algoritmo. Esses gráficos incluem:

• Gráfico de Desempenho: Exibe o valor do portfólio ao longo do tempo, fornecendo uma representação visual do desempenho do algoritmo durante a simulação.
• Gráfico de Drawdown: Mostra o drawdown ao longo do tempo, indicando a queda percentual do valor máximo do portfólio, o que ajuda a entender o risco e a volatilidade da estratégia.
• Gráfico de Posições: Ilustra o valor das diferentes posições de ativos ao longo do tempo, fornecendo insights sobre como a composição do portfólio mudou durante a simulação.
• Gráfico de Quantidades: Representa as quantidades de cada ativo mantidas no portfólio ao longo do tempo, ajudando a analisar o comportamento de negociação e a alocação de ativos.
• Gráfico de Preços: Exibe os preços dos ativos no portfólio ao longo do tempo, fornecendo uma visão das condições de mercado e movimentos de preços que influenciaram o desempenho do portfólio.