O primeiro programa do livro desenha os preços de fechamento dos candles. Para criá-lo, você vai instalar o PyneIDE, criar uma pasta de projeto e executar o programa com os dados de exemplo.

A explicação linha a linha fica para o próximo capítulo. Aqui, você vai conhecer primeiro o editor e a execução.

O que você vai precisar?

De um computador que execute o Visual Studio Code e de uma conexão com a internet para a primeira instalação do PyneIDE e do ambiente de execução. O PyneIDE funciona com a versão 1.90 ou posterior do Visual Studio Code.

Todo o processo de aprendizado é gratuito. Você pode instalar e usar gratuitamente o editor Visual Studio Code, a extensão PyneIDE e o ambiente de execução PyneCore. Também não precisa pagar para escrever e executar os exemplos do livro.

Não é necessário ter uma conta PyneSys, uma chave de API ou uma assinatura paga. Pyne code é executado localmente no seu computador, e os exercícios usam os dados de exemplo que acompanham o livro.

Instale o PyneIDE

  1. Se o Visual Studio Code ainda não estiver no seu computador, instale-o pelo site oficial.
  2. Abra o Visual Studio Code e acesse View → Extensions. Nesse painel, você pode procurar extensões no Visual Studio Code Marketplace oficial.
  3. Digite PyneIDE no campo de busca. Selecione a extensão PyneIDE, publicada por PyneSys.
  4. Clique em Install e espere a instalação terminar.
  5. Se o editor solicitar uma recarga, escolha Reload.

Crie um projeto

Um projeto é uma pasta que reúne os programas, os dados e os resultados. Crie uma pasta vazia chamada pyne-book e abra-a pelo menu File → Open Folder….

Você pode criar o projeto pelo próprio menu do PyneIDE:

  1. Na parte inferior da janela, clique em PyneIDE, à direita da barra de status. Isso abre o menu de operações do PyneIDE.
  2. No campo de busca no topo desse menu, digite Initialize. Assim, fica fácil encontrar a operação que cria o projeto.
  3. Clique em Initialize Pyne Project. Essa operação cria as pastas e os arquivos de exemplo do projeto.
O menu do PyneIDE mostra a operação Initialize Pyne Project; o rótulo PyneIDE está na barra de status, no canto inferior direito da janela.
O rótulo PyneIDE, no canto inferior direito, abre o menu da extensão. Depois de buscar Initialize, clique em Initialize Pyne Project para criar o projeto.

Na primeira vez, o PyneIDE oferece a configuração do ambiente de execução. Clique em Setup Now e espere o processo terminar. Isso instala o Python necessário e o PyneCore no ambiente próprio da extensão. Se você já tiver fechado essa oferta, clique novamente em PyneIDE, no canto inferior direito, e depois em Setup Environment no menu.

Se o PyneIDE perguntar onde criar a estrutura de pastas, escolha Use this folder. O projeto será criado diretamente na pasta aberta.

O painel Pyne aparece na barra de ícones à esquerda. Abra-o: nele, você encontra os programas e os dados do projeto.

O painel Pyne mostra os grupos Scripts, Data e Output e o primeiro programa do projeto.
O projeto criado no painel Pyne. Scripts reúne os programas; Data, os dados; e Output, os resultados.

O que foi criado na pasta?

  • A pasta scripts contém seus programas. Os arquivos de Pyne code têm a extensão .py.
  • A pasta data contém os dados a processar. O arquivo demo.ohlcv gerado é um conjunto de dados de exemplo para o aprendizado.
  • A pasta output recebe os resultados da execução.
  • A pasta config contém as configurações de ambiente do projeto. Você não precisa alterá-las neste capítulo.

A extensão .ohlcv identifica um arquivo que armazena dados de candles. OHLCV corresponde a cinco dados: abertura, máxima, mínima, fechamento e volume. Vamos estudá-los em mais detalhes no capítulo sobre os dados dos candles.

Escreva seu primeiro programa

Você pode criar seu programa diretamente no painel Pyne:

  1. Passe o ponteiro do mouse sobre a linha do grupo Scripts. Um botão + aparece à direita.
  2. Clique em +. Isso abre a seleção do tipo de programa novo.
  3. Clique em Pyne Indicator. Vamos criar um indicador escrito em Pyne code.
  4. No campo de nome, digite first_chart e pressione Enter. O PyneIDE acrescenta a extensão .py automaticamente, cria o arquivo scripts/first_chart.py e o abre no editor.
O grupo Scripts do painel Pyne, com o botão de adição à direita e o programa de exemplo demo.py abaixo.
Ao passar o mouse sobre a linha Scripts, o botão de adição para criar um programa aparece à direita.

O arquivo aberto contém um modelo de indicador. Selecione todo o conteúdo e substitua-o pelo código abaixo. No nome do arquivo, o sublinhado une duas palavras; .py é a extensão do arquivo com sintaxe Python.

Cole o código completo a seguir e salve:

"""
@pyne edge
"""
from pynecore.lib import close, color, plot, script

@script.indicator("My First Chart", overlay=True)
def main():
    plot(close, "Close", color=color.blue, linewidth=2)

A linha abaixo de def main(): começa quatro espaços mais à direita. Essa indentação faz parte do código. Preserve-a ao copiar.

Execute o programa

A operação Run Pyne code aparece acima do código no editor. Clique nela. Se o PyneIDE pedir os dados, escolha a linha demo, com a descrição DEMOBTC @ 1D. Ela corresponde ao arquivo demo.ohlcv.

O seletor de dados mostra a linha demo com a descrição DEMOBTC @ 1D.
A linha demo seleciona os dados de exemplo. DEMOBTC é o nome da demonstração; 1D indica candles diários.

A seleção dos dados informa ao programa quais candles processar. O código atual sempre desenha os preços de fechamento dos dados selecionados.

Ao lado do código de first_chart.py, aparecem o gráfico dos candles DEMO e a linha azul chamada Close.
Depois de executar first_chart.py, o gráfico mostra uma linha azul que conecta os preços de fechamento dos candles.

No gráfico de preços, o tempo avança da esquerda para a direita. A linha azul conecta os preços de fechamento dos candles consecutivos.

A imagem usa os mesmos dados de demonstração que o PyneIDE gera ao criar o projeto. Não é preciso baixar nem copiar dados separadamente. Verifique se a linha azul passa pelo preço de fechamento de cada candle.

Se o gráfico não aparecer

Primeiro, confira os erros indicados pelo editor. Verifique o local e a extensão do arquivo, as três primeiras linhas do código e a indentação da linha de plot. Se você digitou o código à mão, tente colar novamente o exemplo inteiro.

Se a operação Run Pyne code não aparecer, verifique se o PyneIDE está instalado e habilitado e se o início do arquivo corresponde exatamente ao exemplo.

Se o ambiente de execução ainda não estiver configurado, abra a operação PyneIDE: Setup Environment. Ao executar, conclua também a seleção dos dados: uma janela de seleção que continua aberta ainda espera sua escolha.

Tente por conta própria

Encontre o texto "My First Chart" no código e substitua-o por:

"My Price Line"

Antes de executar, pense: o que vai mudar, o formato da linha ou o nome do programa?

Salve o arquivo e execute novamente com os mesmos dados.

Solução do exercício

A linha modificada:

@script.indicator("My Price Line", overlay=True)

O título do programa muda. O cálculo e os dados continuam iguais, por isso o formato da linha também não muda.

Antes de continuar

Se você reabrir o projeto, consegue encontrar o arquivo first_chart.py e executá-lo com os dados de exemplo? Tente fazer isso sem reler os passos. Se tiver dificuldade, procure a parte correspondente deste capítulo.

No próximo capítulo, vamos examinar as linhas desse programa e desenhar o preço de abertura junto com o de fechamento.