O ArcGIS Notebooks executa no ambiente de notebook Jupyter, que fornece uma área de trabalho baseada em célula simplificada. Este tópico aborda os comandos e aspectos básicos do trabalho no ArcGIS Notebooks, incluindo atalhos e melhores práticas.
Especificar o tipo de uma célula
Há três tipos de células que você pode utilizar em um ArcGIS Notebook. Após selecionar uma determinada célula com o ponteiro, é possível alterar o tipo da célula utilizando a lista suspensa na barra de ferramentas.
Os três tipos disponíveis são:
- Código —O notebook interpretará todo o conteúdo em uma célula do código na linguagem de Python. Ao escrever o código de Python, digitar algumas strings, como from ou o sinal de igual =, solicitará ao notebook para recolorir ou destacá-las automaticamente para maior clareza. Qualquer linha de código que comece com um octothorpe # será interpretada como um comentário, colorida em verde e em itálico, e não será executada como código pelo notebook.
- Remarcação —O notebook interpretará todo o conteúdo em uma célula de Remarcação na linguagem de Markdown. Este é um idioma simples para formatação rich text, utilizado em toda a Internet por clientes como GitHub. Consulte o Guia do Markdown online para uma referência ao uso do Markdown. Executar um célula de Markdown tornará o conteúdo em rich text. Qualquer linha que começar com um ou múltiplos octothorpes # será formatada como cabeçalhos. Você também pode adicionar código HTML bruto às células de Markdown.
- NBConvert Bruto — O notebook não processará conteúdo em uma célula de NBConvert Bruto. Este tipo de célula é raramente utilizado.
Anotação:
O tipo de célula Cabeçalho também está disponível na lista suspensa. No entanto, este tipo de célula não é mais utilizados em ambientes do notebook Jupyter. Clicar neste tipo de célula transformará a célula em uma célula de Markdown e anexará um octothorpe #,que denota um cabeçalho de nível superior no Markdown.
O uso de rich text e comentários de código tornará seus notebooks mais legíveis e valiosos para os usuários com quem eles são compartilhados.
Trabalhar com células
Para um notebook executar código, o código deve estar contido em uma célula. O código nas células permite a você definir variáveis e executar funções contidas em bibliotecas de Python.
Para definir uma variável, execute uma célula que contenha uma declaração de variável, incluindo um sinal de igual =. O modelo de notebook padrão, por exemplo, é iniciado definindo uma variável gis. Se você executar uma célula contendo somente este nome de variável, gis, o notebook retornará a URL do seu portal do ArcGIS Enterprise como uma saída.
Para executar uma função de Python, forneça a sintaxe da função e quaisquer parâmetros exigidos ou aceitos pela função. Consulte a seção Utilizar funções em uma célula abaixo para mais informações.
Você pode criar uma nova célula pressionando Shift+Enter ou clicando em Insert no menu da barra de formatação, que oferece a opção de inserir uma nova célula acima ou abaixo da célula atual.
Importar bibliotecas e módulos
No modelo de notebook padrão, o ArcGIS Notebooks importa somente o módulo gis do ArcGIS API for Python. Normalmente, você desejará utilizar bibliotecas de Python adicionais disponíveis no tempo de execução do seu notebook. Para acessar estas bibliotecas, execute um comando import .
Consulte todas as bibliotecas de Python disponíveis no ArcGIS Notebooks
Crie uma nova célula e digite import <library>, então execute a célula.
No ArcGIS API for Python e ArcPy, e em outros casos, as bibliotecas de Python são organizadas em módulos. Para acessar as bibliotecas dentro de um módulo, declare o módulo para acessar com uma declaração from , então declare uma biblioteca utilizando uma declaração import . Por exemplo, para solicitar a biblioteca WebScene do módulo mapping no ArcGIS API for Python, você executaria o seguinte comando em uma célula:
from arcgis.mapping import WebSceneO ArcGIS Notebooks inclui um recurso de preenchimento automático ao executar células. Você pode utilizá-lo para ajudá-lo a encontrar as bibliotecas e os módulos necessários. Em uma célula, digite a primeira parte do comando e pressione Tab para ativar o recurso de preenchimento automático. Ele fornecerá possíveis valores que podem completar o comando.
Por exemplo, se você digitar arcgis. e então pressionar Tab, o notebook fornecerá uma lista suspensa de todos os módulos disponíveis no ArcGIS API for Python. Você pode utilizar os erros para cima e para baixo para navegar na lista; quando você encontrar a opção desejada, pressione Enter para inseri-lo em sua linha de código.
Para mais informações sobre como o ArcGIS API for Python e ArcPy funcionam em seus notebooks, consulte os seguintes tópicos:
Utilizar funções em uma célula
Para realizar análises e trabalhar com dados em notebooks, você utiliza funções do Python. As funções estão contidas em bibliotecas de Python e geralmente aceitam parâmetros de entrada para especificar como eles serão executados e em qual conteúdo eles serão executados.
A ferramenta de preenchimento automático do notebook pode ajudá-lo a encontrar funções, fornecendo uma lista suspensa do que está disponível. Para qualquer biblioteca bar, digite bar. e pressione Tab para mostrar as funções disponíveis.
Por exemplo, para visualizar as ferramentas disponíveis na biblioteca Resumir Dados do módulo arcgis.features , digite o seguinte código e então pressione Tab:
features.summarize_data.A ferramenta de preenchimento automático mostrará uma lista suspensa das ferramentas disponíveis na biblioteca.
Muitas vezes, o comando em um notebook terá parâmetros exigidos ou opcionais — parâmetros que fornecem informações para executar um comando. Se a sintaxe de um comando terminar com um conjunto vazio de parênteses (), o comando exigirá ou poderá incluir parâmetros opcionais para você adicionar.
Insira os parâmetros entre parênteses, separando vários parâmetros por vírgulas. Para visualizar uma string de parâmetros exigidos e opcionais para qualquer função, substitua seus parênteses vazios por um ponto de interrogação e execute a célula. Isto mostrará o docstring da função, que lista todos os parâmetros.
Por exemplo, todas as ferramentas disponíveis através do painel Análise de editor do notebook exigem parâmetros. A adição de uma ferramenta deste painel a uma célula irá inserir a sintaxe ArcGIS API for Python da ferramenta, terminando em parênteses vazios. Caso tente executar esta sintaxe em uma célula sem fornecer um ou mais parâmetros, a célula falhará e fornecerá uma mensagem de erro.
Se você deseja executar a ferramenta Agregar Pontos na biblioteca Resumir Dados, você localizará a ferramenta no painel Análise e adicionará a uma nova célula, ou simplesmente digite a sintaxe da ferramenta da seguinte maneira:
features.summarize_data.aggregate_points()Para visualizar a lista de parâmetros da ferramenta, modifique a sintaxe da seguinte maneira e execute a célula:
features.summarize_data.aggregate_points?Isto abrirá a janela de referência docstring da ferramenta. Esta referência tem botões para expandir ou fechar a janela no canto superior direito.
Quando você estiver trabalhando em uma célula, tenha o seguinte em mente:
- Para qualquer função foo(), digite foo? e pressione Enter para mostrar a docstring da função, que descreve a função.
- Se você iniciar uma célula com !, o conteúdo da célula executará como um comando bash no seu contêiner do notebook.
Executar uma célula
Quando você executa uma célula, seu código é executado e todas as operações são executadas. Você pode executar somente uma célula inteira, não uma subseção da célula ou uma linha específica de código. As células podem consistir em uma ou várias linhas de código.
Para executar uma célula selecionada, clique no botão Executar na barra de ferramentas, ou clique em Células > Executar Células Você também pode pressionar Ctrl+Enter para executar a célula no local do ponteiro do mouse.
Para parar manualmente uma célula que está sendo executada, clique em Kernel > Interromper. Você também pode clicar no botão de parar quadrado na barra de ferramentas.
À esquerda de cada célula do código está um elemento In [ ] . Se a célula ainda não foi executada, ou se uma célula anteriormente executada foi apagada da sua saída, o suporte estará vazio. Enquanto a célula estiver sendo executada, ela conterá um asterisco: In [*]. Quando uma célula terminar de executar, o colchete In [ ] será preenchido com um número que indica a ordem das células que foram executadas. Pelo fato das células de um notebook poderem ser executadas em qualquer ordem e poderem ser executadas várias vezes, os números In [ ] nas células de um notebook podem não estar em ordem sequencial.
Anotação:
As células do Markdown mantêm um elemento In [ ] até que sejam executadas, ao ponto do elemento desaparecer e o conteúdo da célula se tornar rich text.
Quando uma linha de código em uma célula que você executa produz uma saída, a saída é exibida no seu notebook sob a célula executada. Ao lado da saída está um elemento Out [ ] , que corresponde ao que está no elemento In [ ] da célula correspondente.
Trabalhar com o Kernel
Quando você inicia um novo ArcGIS Notebook, um kernel é iniciado com ele. Este Kernel executa o código que você executa no notebook. À medida que você executa células no notebook (preenchendo seus elementos In [ ]), variáveis que você definiu em células executadas são armazenadas na memória do Kernel.
Para reiniciar o Kernel do seu bloco de notas e limpar as variáveis na memória, clique em Kernel > Reiniciar. Se você deseja reiniciar o Kernel, limpe as variáveis na memória e, então, execute todas as células no notebook sequencialmente, clique em Kernel > Reiniciar & Executar Todos.
Ao terminar de utilizar um notebook ativamente, clique em Kernel > Fechar para fechar o Kernel do notebook e limpar todas as variáveis na memória. O Kernel deixará de ser executado, mas não apagará as saídas das células que foram executadas.
Quando um notebook for deixado ocioso por um período prolongado, o Kernel desligará e apagará todos os valores na memória automaticamente. Este período de tempo é de 24 horas por padrão, mas pode ser especificado pelo administrador do site para ser mais curto ou mais longo.