Variáveis são elementos em um modelo que contêm um valor ou uma referência aos dados. Variáveis podem ser usadas como entradas para uma ferramenta de análise. O uso de variáveis pode tornar a iteração nos parâmetros da ferramenta mais rápida, pois você pode alterar os valores específicos das variáveis sem abrir a caixa de diálogo completa da ferramenta. Variáveis também podem ser usadas para compartilhar valores de entrada para diversas ferramentas de análise.
Adicionar uma variável
Variáveis podem ser adicionadas a um diagrama de modelo a partir de um parâmetro de ferramenta ou como uma variável independente.
Adicionar uma variável de um parâmetro de ferramenta
Uma variável pode ser adicionada diretamente de um parâmetro de ferramenta. Adicionar uma variável de um parâmetro de ferramenta garante o seguinte:
- A estrutura da variável e o tipo de dados são compatíveis com o parâmetro da ferramenta escolhida
- O valor padrão ou especificado pelo usuário do parâmetro da ferramenta é preenchido automaticamente quando aplicável
- As entradas definidas do parâmetro da ferramenta (por exemplo, um menu de unidades suportadas) estão disponíveis na variável quando aplicável
- A variável é conectada automaticamente à ferramenta sem exigir etapas adicionais
Conclua as seguintes etapas para adicionar uma variável de um parâmetro de ferramenta:
- Complete as etapas para abrir um modelo e adicionar dados e ferramentas, se necessário.
- Selecione o elemento da ferramenta e clique em Adicionar variável
na barra de ferramentas do elemento.O menu Selecionar parâmetro... aparece listando os parâmetros da ferramenta.
Se Adicionar variável não estiver disponível, pode significar que você não está conectado a uma sessão de análise ou que o modelo não está ativo.
- Clique no nome de um parâmetro para selecioná-lo.
A variável é adicionada ao diagrama do modelo e conectada à ferramenta. Se o parâmetro tiver um valor padrão, o valor será adicionado automaticamente à variável e a variável aparecerá em um estado pronto para execução (azul). Se não houver um valor padrão ou especificado pelo usuário, a variável estará vazia e aparecerá em um estado não pronto para execução (cinza). Você pode abrir o elemento para atualizar o valor da variável.
Adicionar uma variável independente
Uma variável independente é adicionada a um diagrama de modelo sem associação a nenhum parâmetro da ferramenta. Após a variável ser adicionada, ela deve ser conectada a uma ferramenta para ser usada por um parâmetro de ferramenta.
Complete as seguintes etapas para adicionar uma variável independente ao diagrama do modelo:
- Complete as etapas para abrir um modelo, conectar a uma sessão de análise e ativar o modelo, se necessário.
- Clique em Adicionar variável na barra de ferramentas de ação.
A caixa de diálogo Adicionar variável é exibida com opções para a estrutura da variável e o tipo de dados. A estrutura de variável padrão é Valor único e o tipo de dado padrão é String.
Se Adicionar variável não estiver disponível, pode significar que você não está conectado a uma sessão de análise ou que o modelo não está ativo.
- Para Escolher a estrutura da variável, escolha Múltiplos valores, se necessário.
- Para Escolher o tipo de dado da variável, expanda o menu e escolha uma opção diferente, se necessário.
- Clique em Adicionar.
A variável é adicionada ao diagrama do modelo. Você pode abrir o elemento para atualizar o valor da variável e desenhar uma conexão a partir da variável com um elemento da ferramenta. Variáveis somente podem ser conectadas a parâmetros de ferramentas compatíveis.
Conectar variáveis e ferramentas
Depois que uma variável é adicionada ao diagrama do modelo, ela precisa ser conectada a uma ferramenta para ser usada como um parâmetro de ferramenta. Os conectores podem ser adicionados desenhando diretamente no diagrama ou por meio de uma caixa de diálogo da ferramenta.
Desenhar uma conexão
Complete as seguintes etapas para desenhar uma conexão entre elementos da ferramenta e variável:
- Complete as etapas para abrir um modelo e adicionar dados, ferramentas e variáveis, se necessário.
- Clique na porta no lado direito de um elemento da variável e arraste-a para a porta no lado esquerdo de um elemento da ferramenta.
O menu Selecionar entrada... aparece listando os parâmetros de ferramentas compatíveis.
- Clique no nome do parâmetro no qual a variável será usada (por exemplo, Camada de entrada).
Um conector aparece entre o elemento da variável e o elemento da ferramenta, e a ferramenta é validada. O valor da variável aparecerá para o parâmetro especificado quando a caixa de diálogo da ferramenta for aberta.
Conectar variáveis por uma ferramenta de análise
Complete as etapas a seguir para conectar variáveis por uma ferramenta de análise:
- Complete as etapas para abrir um modelo e adicionar dados, ferramentas e variáveis, se necessário.
- Selecione um elemento da ferramenta e clique em Abrir
na barra de ferramentas do elemento ou clique duas vezes no elemento da ferramenta para abri-lo. - Clique em Selecionar variável ao lado do parâmetro para o qual você está adicionando a variável.
A caixa de diálogo Selecionar variável aparece mostrando uma lista de variáveis no modelo que são compatíveis com o parâmetro. Se nenhuma variável estiver listada, siga as etapas para adicionar uma variável para o parâmetro.
- Clique em uma variável para selecioná-la.
A variável é adicionada ao parâmetro.
- Atualize todos os parâmetros restantes e clique em Confirmar para aplicar as alterações.
Um conector aparece entre o elemento da variável e o elemento da ferramenta, e a ferramenta é validada.
Atualizar uma variável
Elementos variáveis podem ser abertos para adicionar, atualizar ou remover o valor da variável.
Conclua as seguintes etapas para atualizar uma variável de dados de entrada:
- Complete as etapas para abrir o painel ModelBuilder e adicionar ferramentas, se necessário.
- Selecione a variável e clique em Abrir na barra de ferramentas do elemento ou clique duas vezes no elemento para abri-lo.
Uma caixa de diálogo mostrando o tipo de variável é exibida.
- Faça um dos seguintes:
- Para variáveis duplas ou inteiras, digite um número na caixa de texto ou use as setas para cima e para baixo para aumentar ou diminuir o valor.
- Para variáveis duplas (múltiplos valores), digite um ou mais números na caixa de texto e clique em Adicionar ou pressione Enter entre cada número. Para remover números, clique no botão de remover
do valor. - Para variáveis de camada de feição ou tabela, clique no conjunto de dados de entrada ou no botão Camada e selecione uma camada na lista ou navegue para selecionar uma camada compatível.
Anotação:
Se a variável da camada de feição já estiver conectada a uma ou mais ferramentas de análise, somente conjuntos de dados compatíveis com as ferramentas e parâmetros estarão disponíveis. Se os parâmetros não suportarem as mesmas feições (por exemplo, um parâmetro suporta apenas pontos e outro suporta apenas polígonos), a variável não conseguirá determinar quais camadas são compatíveis e poderá resultar em um erro para uma ou mais ferramentas.
- Para variáveis de string, digite um valor de texto na caixa de texto. Se a variável já estiver conectada a uma ferramenta de análise, a variável poderá exibir um menu de opções.
- Clique em Confirmar.
A variável é atualizada e validada.
Estruturas da variável
As variáveis suportam as seguintes estruturas:
- Valor único — Suporta a adição de um único valor de um único tipo de dados. Variáveis de valor único são suportadas para tipos de dados de camada de feição, tabela, duplo, inteiro, sequência de caracteres e unidade linear.
- Múltiplos valores — Suporta a adição de múltiplos valores de um único tipo de dados. Atualmente, estruturas de múltiplos valores suportam apenas tipos de dados Duplo. Por exemplo, uma variável dupla (múltiplos valores) pode ser usada no parâmetro Valores de distância para Criar Buffers.
Anotação:
Parâmetros que suportam múltiplas variáveis double de valor também suportam uma ou mais variáveis double de valor único.
Tipos de dados suportados
Os seguintes tipos de dados são suportados:
- Duplo—Números com casas decimais. Este tipo de dados é suportado tanto para estruturas de valor único quanto para estruturas de múltiplos valores.
- Camada de feição—Item da camada de feição hospedada.
- Inteiro—Números sem casas decimais. Valores negativos são suportados na variável, mas não são suportados para todos os parâmetros da ferramenta.
- Unidade linear—números e unidades.
- String—Caracteres alfanuméricos e especiais.
- Tabela— Itens da tabela hospedada.
Limitações
Os parâmetros da ferramenta que aceitam variáveis de string têm listas definidas de valores de entrada aceitos (por exemplo, um menu de unidades suportadas). É recomendável adicionar variáveis de string de um parâmetro de ferramenta ou conectar a variável a um parâmetro de ferramenta antes de atualizar o valor da variável. Digitar um valor em uma variável de string desconectada pode resultar em erros.
Os seguintes parâmetros de ferramenta não oferecem suporte à adição de uma variável do parâmetro, mas oferecem suporte à conexão de uma variável independente:
| Ferramenta | Parâmetro | Tipo de variável |
|---|---|---|
Feições de Ligação | Camada Alvo | Camada de feições ou tabela |
Camda de ligação | ||
Calcular Índice Composto | Feições de entrada ou tabela | |
Filtrar por Atributos | Conjunto de Dados de Entrada | |
Calcular Campo | Conjunto de Dados de Entrada | |
Agregar Pontos | Tamanho da caixa | Unidade linear |
Resumir Dentro | Tamanho da caixa | |
Enriquecer Camada | Valor de medição | |
Gerar Mosaicos | Tamanho da caixa |