Performance indicator

Visão geral
Performance Indicator mostra um mapa de calor dos retornos percentuais de uma lista de símbolos em intervalos de tempo configuráveis. É usado para comparar visualmente a força e fraqueza relativas, sem oferecer qualquer garantia de resultados.

Configuração
SymbolsList: símbolos separados por vírgula; devem corresponder exatamente aos nomes no terminal.
BaseTF: timeframe base para os cálculos.
UpdateSeconds: intervalo em segundos para atualização automática.
CapPercent: valor de normalização para a intensidade da cor.
PeriodsList: string que define os períodos (por exemplo, D1, W1, M1, M3, M6, Y1, YTD); aceita formatos como 1M, 2W, YTD.

Cálculo de retornos
Standard periods: comparação entre o fechamento atual e o fechamento de N períodos atrás.
YTD: usa o fechamento mais próximo ao início do ano corrente para uma comparação consistente.

Codificação visual
Fundo: verde para retornos não negativos, vermelho para negativos; intensidade escalada por CapPercent.
Texto: verde se o retorno for ≥ 0, vermelho se negativo, cinza se os dados não estiverem disponíveis. A codificação dupla garante legibilidade.

Mecanismo de atualização
Um temporizador verifica o tempo decorrido definido por UpdateSeconds e reconstrói o mapa apenas quando permitido, com salvaguardas internas para evitar atualizações excessivamente frequentes.

Casos de uso

• Comparar diferentes ativos em múltiplos horizontes.

• Monitorar uma carteira para detectar mudanças na força relativa.

• Modificar PeriodsList em tempo real para explorar diferentes horizontes.

Exemplo
PeriodsList: "D1,1W,3M,YTD" — diário, semanal, 3 meses, ano até a data.

Notas

• Os símbolos devem existir no terminal.

• Atualizações muito frequentes são limitadas internamente; ajuste UpdateSeconds com cuidado ao usar listas grandes.