Editor de estratégias
Este documento irá abordar todos os detalhes importantes sobre a ambiente de edição de estratégias do Profit Chart: Editor de Estratégias.
A linguagem utilizada pelo Profit Chart é a NTSL (Nelogica Trading System Language). É uma linguagem com uma sintaxe muito semelhante a Pascal, porém com uma restrição nos comandos. A linguagem NTSL também aceita comandos em português, embora não seja uma boa prática, dado que todas as linguagens com grande abrangência são em inglês. Logo, é melhor o usuário já se acostumar com os termos em inglês visando maior facilidade em uma transição futura para outra linguagem de programação.
Vamos às questões práticas…
Como acessar o Editor de Estratégias?
Após abrir o Profit, basta acessar o menu principal na parte superior, clicar em “Estratégias” e em seguida na opção “Editor de estratégias”.
O Editor de estratégias aparecerá conforme a figura abaixo.
Modos de exibição do Editor de Estratégias
- Editor: apresenta apenas a tela de edição do código fonte e de debug (debug é uma funcionalidade para depurar seu código fonte, ou seja, executar passo a passo para verificar se tudo está rodando corretamente);
- Gráfico: apresenta apenas o gráfico no qual está sendo testada a estratégia em edição;
- Misto: apresenta tanto a tela de edição do código fonte e debug, quanto o gráfico no qual a estratégia em edição está sendo testada;
- Estatísticas: este modo aplica-se apenas às estratégias de execução, ou seja, estratégias que realizam ordens de compra/venda para fins de backtest.
Vamos detalhar abaixo o modo de exibição mais utilizado, o modo “Editor”. O modo “Estatísticas” será bastante trabalhado nos documentos relacionados à backtesting.
Modo "Editor"
O modo editor possui três áreas principais: a barra de ferramentas, a área de edição de código e a área de compilação/debug.
Note que o editor pode ter múltiplas estratégias abertas em edição ao mesmo tempo. A barra inferior apresentará abas diferentes para cada estratégia. Uma estratégia que foi criada mas ainda não foi salva constará na aba “NoName”, conforme pode ser visto na figura abaixo.
Barra de ferramentas
Vamos detalhar a função de cada ícone da barra de ferramentas:
| Ícone | Função |
|---|---|
|
|
Nova estratégia: abre janela para seleção de modelos do Profit para criar uma nova estratégia; |
|
|
Abrir estratégia: abre uma janela para seleção de estratégias salvas no Profit; |
|
|
Fechar estratégia: fecha a edição da estratégia atual. O usuário será perguntado se deseja salvar as alterações, caso haja alguma alteração não salva; |
|
|
Salvar: salva as alterações existentes na estratégia. Caso haja algum erro de sintaxe, o sistema irá perguntar ao usuário se deseja salvar assim mesmo; |
|
|
Salvar como: permite salvar a estratégia em edição como um novo arquivo de estratégia, podendo configurar um novo nome e descrição; |
|
|
Verificar sintaxe: o sistema realiza uma verificação da sintaxe da estratégia e indica eventuais erros; |
|
|
Step over (debug): uma vez em modo de depuração e a execução para em determinada linha de código, este botão executa a linha e para na próxima; |
|
|
Trace into (debug): uma vez em modo de depuração e a execução para em uma determinada linha que realiza a chamada de uma função ou procedure criada pelo usuário, o depurador irá executar linha a linha o código fonte dentro da função/procedure chamada; |
|
|
Executar estratégia: o editor de estratégia passa para o modo de exibição misto e apresenta o resultado da execução da estratégia no gráfico ao lado da área de edição do código-fonte. O depurador irá parar na primeira linha a ser executada que tenha breakpoint; |
|
|
Parar estratégia: interrompe a execução da estratégia; |
|
|
Propriedades da estratégia: permite , no caso de indicadores, configurar a aparência das séries plotadas (cor, espessura e tipo de tracejado, tipo de gráfico: linha/histograma), linhas guias e suas aparências (linhas horizontais com valor fixo) e configurar tipo de preenchimento entre as séries plotadas; |
|
|
Formatação automática do código: realiza a identação (configuração de espaços) e quebras de linhas do código de forma automática e uniforme. (Nem sempre funciona direito!) |
|
|
Lista de funções: apresenta listagem de funções disponíveis no editor de estratégias agrupadas por tema; |
|
|
Lista de constantes: apresenta listagem de constantes definidas pelo Profit agrupadas por tema; |
|
|
Linhas no Gráfico Principal: alterna a plotagem das séries entre um subgráfico ou dentro do gráfico principal do ativo; |
|
|
Configurações do editor: abre janela para personalização do editor de estratégias, podendo alterar a fonte do editor, tamanho, cores e etc... |
Área de edição de código
Na área de edição de código é apresentado o código fonte da estratégia. Note que há uma numeração das linhas a esquerda para facilitar a identificação do código quando houver sinalização de erro de sintaxe.
O usuário pode criar breakpoints para depuração do código (debug) clicando no vão entre a númeração da linha e a coluna em cinza. A criação do breakpoint será indicada por um ícone circular azul, bem como o preenchimento da linha de código na mesma cor.
Área de compilação/debug
Nesta área, é apresentado o resultado da verificação de sintaxe, bem como os erros existentes no código-fonte da estratégia.
Quando a estratégia é “debugada” (depurada), aparece nesta área também o valor das variáveis declaradas na estratégia.
Gerenciador de estratégias
O Gerenciador de estratégias apresenta todas as estratégias existentes no Profit, tanto aquelas criadas pelo usuário, quanto as estratégias importadas. O Gerenciador pode ser acessado pelo menu principal, clicando em “Estratégias” e em seguida, “Gerenciador de estratégias”, conforme figura abaixo.
O gerenciador deve se apresentar conforme figura a seguir. Será apresentado ao usuário uma relação de estratégias com a indicação do tipo a que pertence. É importante ressaltar que uma estratégia, pode estar associada a mais de um tipo. Por exemplo, pode haver uma estratégia que realiza tanto uma coloração de gráfico como também realiza o filtro do ativo (screening).
Para cada linha referente a cada estratégia, o usuário pode editar a estratégia (ícone de lápis), compartilhar a estratégia pelo Connect Chat com um outro usuário do Profit ou grupo (Ícone com 3 pontos) ou excluir a estratégia.
Pelo gerenciador de estratégias é possível também fazer a importação de estratégias criadas por outras pessoas e a exportação das estratégias existentes no Profit da máquina.
Como importar ou exportar estrategias?
A importação e exportação de estratégias é realizada por meio de arquivos com extensão psf (Profit strategies file). Esses arquivos podem conter uma ou mais estratégias, com ou sem o código fonte associado.
Quando o usuário não tem acesso ao código-fonte da estratégia, chamamos a estratégia de caixa-preta, uma vez que o usuário não tem informação sobre detalhes da programação, apenas pode informar parâmetros e ter acesso à saída da estratégia, seja ela um indicador ou uma coloração de gráfico. As estratégias caixa-branca são aquelas nas quais o usuário consegue visualizar todo o código fonte.
Para exportar uma estratégia, basta clicar no botão “Exportar” no canto inferior esquerdo do Gerenciador de estratégia. Será aberta uma janela conforme figura abaixo.
O usuário deverá selecionar o nome de um arquivo e uma pasta para realizar a exportação, bem como indicar por meio da caixa de seleção, quais estratégias serão exportadas para o arquivo psf. Note que a opção padrão do sistema é exportar sem código fonte. No entanto, caso o usuário deseje, poderá marcar a opção para exportar a estratégia e o código fonte associado.
O processo de importação de estratégia é análogo à exportação. O usuário deve selecionar um arquivo psf em seu computador e o Profit irá listar as estratégias contidas no arquivo para que o usuário selecione quais serão importadas.
Outra forma de compartilhar estratégias é pelo Connect Chat, sendo o processo mais natural para o usuário, pois ocorrerá dentro da interface do chat da plataforma Profit.
No próximo documento, iremos abordar quais são os tipos de estratégias que podem ser automatizadas na plataforma Profit Chart!