> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/pt/analises/formulas-in-measurement-values.md).

# Fórmulas incluído em Valores medidos

Esta página aborda como o GeoDin organiza os Valores medidos, como a **Cálculos** função recalcula uma tabela de medições usando fórmulas predefinidas ou individuais, a sintaxe completa da Fórmula e da Condição com as suas construções para casos especiais, e as Opções de formato de Importação/Exportação, diagrama e Tabela do Editor dos valores de medição.

## Valores medidos

O GeoDin organiza os Objetos espacialmente. Estes são objetos de ponto com ou sem um valor de profundidade. Nesses objetos podem ser feitas medições. Para usar o GeoDin para recolher esses dados, os Pontos de medição precisam de ser definidos nos Dados gerais. Normalmente, Filtros e intervalos de amostragem são usados como Pontos de medição. Também o próprio objeto pode ser definido como Ponto de monitorização. No gestor de objetos do GeoDin, os Pontos de medição são mostrados por três esferas azuis.

Projeto: GeoDin Demo

objeto

Todos objetos

Perfil litológico geral

Ponto de monitorização

Filtros

piezómetro superior: (4,3-6,3 m)

piezómetro inferior (7,8-8,7 m)

Amostras

BH01: (1-7 m)

BH01: (4-5 m)

### Terminologia

A seguinte hierarquia é usada na organização do Ponto de monitorização para relacionar um único Valor medido a um Objeto de medição do Ponto de monitorização. Existem os seguintes tipos diferentes:

**Tipo de ponto da medição**

O Tipo de ponto da medição define que tipo de objeto é. Estes podem ser com ou sem um componente vertical. Um exemplo de um Ponto de monitorização com um componente vertical é um Furo. Um Furo pode ser o próprio Ponto de monitorização (por exemplo, quando todo o comprimento é amostrado) ou outros Típos de pontos de medição podem ser associados a ele (amostras discretas em vários intervalos ao longo do comprimento do Furo). Exemplos de amostras pontuais (isto é, sem um componente vertical) são estações de medição de águas superficiais ou de clima.

**Típo de dados**

Investigações químicas podem ser feitas para vários objetos para cada tipo de Ponto de monitorização. Para estas combinações, são definidos Típos de dados. Por exemplo, num poço de Água subterrânea, a qualidade da água pode ser investigada ou os caudais medidos. Para cada caso existe um Típo de dados. Cada Típo de dados pode ser atribuído a vários Típos de pontos de medição. Assim, o Típo de dados "composição da Água subterrânea" pode ser inserido para um Ponto de monitorização de Água subterrânea, bem como para um poço. Os Resultados são reunidos numa Tabela de Típos de dados, embora os dados de cada Ponto de monitorização sejam distintos entre si.

**Gropo químico**

Como o número de parâmetros individuais dentro de um Típo de dados pode atingir valores elevados, os parâmetros são subdivididos em grupos químicos para permitir uma melhor visão geral. Cada grupo distingue-se por uma semelhança nos parâmetros químicos ou nas características descritivas e pode ter até 20 parâmetros.

**Parâmetro**

Um Parâmetro é uma medição individual descrita por um Nome, uma identificação de campo e uma Unidade

**Consulta**

As Consultas são usadas em Projetos ou Bancos de dados para consultar dados. Definem a quantidade e o tipo de dados a partir dos quais os Resultados são derivados.

### Valores especiais

O GeoDin organiza os Valores medidos como entradas numéricas. Assim, valores abaixo de um Limite detectável não podem ser guardados como o caractere „<". Nesses casos, é introduzido um Limite detectável negativo (por exemplo, "-1"). Estes valores são ignorados por análises estatísticas. Se o Limite detectável for desconhecido (por exemplo, dados antigos), o valor "-88" é usado. Se o valor não for detetável, então deve ser inserido "-99":

| Entrada | Denominação                                                           |
| ------- | --------------------------------------------------------------------- |
| -XX     | abaixo do Limite detectável (XX = Limite detectável)                  |
| -88     | abaixo do Limite detectável (valor do Limite detectável desconhecido) |
| -99     | não detectável                                                        |

## Fórmula

Como alternativa à apresentação dos Valores medidos em forma de grelha, pode ver o Registo de dados atual numa máscara. No topo da máscara são apresentados os Dados de amostra gerais (Nome, Data, Tempo) e o Gropo. Abaixo, os parâmetros individuais do Registo de dados atual são listados em linhas. Para cada Parâmetro são apresentados o Nome, o Valor de medição, a Unidade, o Limite detectável e o Método de análise. Nome e Unidade não são editáveis.\
\
O conteúdo de um Registo de dados pode ser guardado como um ficheiro de texto simples (que pode ser subsequentemente carregado). Ao premir o **OK** Botão, o conteúdo da máscara é guardado no Registo de dados - ao premir **Cancelar** o conteúdo é descartado. Opcionalmente, pode ser usado o Nome de campo curto para a coluna do Parâmetro.

## Cálculos

Esta função permite recalcular valores para a tabela inteira no Editor dos valores de medição. Tem duas opções:

**-Fórmulas existentes-**

1. Executar uma ou mais Fórmulas das predefinidas [Fórmulas](/geodin-desktop/pt/analises/formula-basics.md)do Típo de dados, encontrado incluido na Configuração do sistema.
2. Se marcar a caixa \[ativar apenas Fórmulas] verá apenas Fórmulas que estão definidas como ativas na [Geral Fórmulas](/geodin-desktop/pt/analises/formula-basics.md) na Configuração do sistema. Aviso: Estas Fórmulas serão Sempre executadas para os Registos selecionado quando usa a função Calcular. Isto acontece porque uma Atualizar de um registo de dados aciona os Cálculos de Fórmulas ativas.
3. As Fórmulas são marcadas com um Símbolo Vermelho em vez de um Símbolo Preto se o Campo de destino das Fórmulas estiver sempre destinado a ser sobrescrito.
4. No título real da Coluna, As Fórmulas podem ser ordenadas ao/à clicar, por ex., Nome ou Campo de destino. ***Aviso:*** *a ordem de Execução das Fórmulas selecionado será a mesma que foi definida nas Definições do típo de dados da Configuração do sistema!* \*\*Isto é importante, especialmente para Fórmulas interdependentes.

**-Executar Fórmulas individuais-**

1. Para Executar uma Fórmula individual, Usa e Modificar uma das Fórmulas predefinidas da [Geral Fórmulas](/geodin-desktop/pt/analises/formula-basics.md) da Configuração do sistema ou você define uma nova Fórmula.
2. Ao aceitar uma Fórmula, basta marcá-la clicando sobre (em) o Nome (você não precisa marcar a caixa para esta Ação) e clique no Botão **Aceitar a fórmula marcada Disponível**. Os campos *"Campo de destino:", "Condição:"* E *"Fórmula:"* são preenchidos automaticamente e podem ser editados.
3. Alternativamente, você pode Editar estes campos sem usar uma Fórmula predefinida, mas criando uma nova Fórmula, que é aplicada ao Campo de destino.

*\[\[Sobrescrever destino]]{.Sublinhado}*

Para os seguintes Cálculos, você pode definir a Configuração ao/à Sobrescrever Valores existentes. Por Padrão, os Cálculos não Sobrescreverão os campos existentes, mas calcularão Resultados para esses campos sem Valores para o Campo de destino correspondente.

*\[\[todos parâmetros têm Valores]]{.sublinhado}*

Além disso, você pode especificar apenas ao Executar os Cálculos se todos parâmetros, que são Usado no(a) Fórmula, contiverem Valores para os Cálculos. Portanto, os Cálculos não serão Executados para Campos de dados Vazio (se eles são Usado no(a) Fórmula).

***-todos os registos de dados visíveis-***

Escolha aqui se os Cálculos são efetuados para todos os Registos listados, incluido o editor de Registração e manutenção de dados de medição.

***-todos os Registos de dados selecionado-***

Escolha esta opção ao/à Executar os Cálculos apenas para os Registos de dados de medição (Linhas) selecionado incluido no editor de Registração e manutenção de dados de medição.

***

## Referência: Definição de Fórmulas

Uma Fórmula é definida como uma sequência de caracteres (semelhante a uma definição de Texto macro) e contém operadores matemáticos para calcular um Resultado.

Por exemplo: $DAT.PAR1$ \* 100

Os caracteres dentro dos sinais de $ referem-se a um Campo de dados do GeoDin. Os seguintes operadores podem ser usados:

(x) representa a Coluna da tabela do GeoDin (por exemplo, $DAT:PAR1$)

Espaços Vazio podem ser contidos nas Fórmulas. Valores Fixados de Número (100 no exemplo acima) podem ser inseridos diretamente na Fórmula.

### Usa de Condições

***Aviso:***

*A Fórmula pode ser introduzida diretamente no Editor dos valores de medição após clicar no Botão* *ou No separador Sistema, em Típos de dados-> Definições do típo de dados->Fórmulas* ([Geral Fórmulas](/geodin-desktop/pt/analises/formula-basics.md)).

**Exemplo de Condição simplesExemplo:**

*Destino:* WAS:NA\_CALC

*Condição:* $WAS:MG$>3

*Fórmula:* $WAS:NA$/2

O Parâmetro alvo NA\_CALC é calculado Se o Parâmetro MG tiver um Valor de 3 ou superior.

**Exemplo para condição múltiplaExemplo:**

*Destino:* WAS:NA\_CALC

*Condição:* $WAS:MG$>3 E $WAS:CA$<10

*Fórmula:* $WAS:NA$/2

O Parâmetro alvo é calculado, se Ambos os critérios forem verdadeiros: o Parâmetro MG tiver um Valor maior que três e o Parâmetro CA tiver um Valor menor que 10.

**Condições para Modificar Valores**

Usando a formatação @O, o Valor original de um registo de dados ANTES do último Modificar pode ser recriado no Editor dos valores de medição. Assim, verificar Diferenças é possível.

**Exemplo:**

*Condição:* $WAS:PAR1$ - $WAS:PAR1\@O$ >10

A Condição é Verdadeiro, quando o Valor de PAR1 na célula é mais de dez vezes o Valor introduzido anteriormente.

**Mais exemplos de Condições**

Numa Condição, o Operador NULL pode ser usado. Define se um Parâmetro tem um Valor.

**Exemplo:**

*Destino:* WAS:NA\_CALC

*Condição:* $WAS:MG$>3 E $WAS:CA$=NULL

*Fórmula:* $WAS:NA$/2

O Parâmetro alvo NA\_CALC é calculado tomando metade do Valor do Parâmetro NA, Se o Valor do Parâmetro MG excede 3 E o Parâmetro CA está Vazio.

Se cadeias são usadas numa Condição, o Texto tem de ser incluído em aspas invertidas (ou alta). Aspas invertidas em falta e erros ortográficos são interpretados como não iguais. A ortografia da Condição distingue maiúsculas de minúsculas.

**Exemplo:**

*Destino:* WAS:NA\_CALC

*Condição:* $BEARBEIT$='Müller'

*Fórmula:* $WAS:NA$/2

O Parâmetro alvo NA\_CALC é calculado como metade do Parâmetro NA, Se o Autor: do registo de dados tem o Nome Müller.

### Usando regras especiais

Além disso, aos Operadores matemáticos podem ser usadas construções de sintaxe especiais para o uso de Valores das Tabelas GeoDin para levar em consideração numerosos casos especiais.

**Casos especiais na sintaxe de Fórmula Limites de deteção**

Limites detectáveis apresentam um caso especial. Estes são, por definição, valores negativos (por exemplo, -1 para <1). Se estes valores forem utilizados sem cuidado, resultados falsos podem ser produzidos, por exemplo ao construir somas a partir de parâmetros individuais. Para isso, deve ser usada uma construção na forma de @B(x) dentro dos sinais de $, onde x é um fator com o qual o limite detectável entra nos cálculos. Por exemplo, um limite detectável de 5 mg (introduzido como -5), usando o fator 0,5, produz o resultado 2,5.

**Exemplo:** $WAS:BENZEN\@B(0,5)$+$WAS:TOLUEN\@B(0,5)$+$WAS:XYLEN\@B(0,5)$

incluido no caso acima, onde os Valores para Parâmetro individuais de -5 OU -1 são encontrados, os Cálculos da Soma usam metade destes Valores.

**Valores Padrão**

Para determinados Cálculos, pode ser Maio necessário trabalhar com Configurações gerais predefinidas ou predefinições. Quando um Parâmetro não está presente ou não foi analisado incluido um Registo de dados, pode assumir-se um Texto padrão Valor e utilizá-lo para Cálculos. Isto é realizado utilizando a construção @D(x) dentro dos sinais $, sendo x o Valor estandard predefinido utilizado quando Nenhum valor está presente incluido campo.

**Exemplo:** Valor=$ORGANIC\@D(10)$/$Argila\@D(25)

O Valor calculado tem os quocientes das substâncias orgânicas E Argila incluido num Exemplo de solo. Se Não houver Valores presentes nestes campos, os Valores Padrão são usados.

**valores médios**

Os valores médios são calculados usando os Símbolos "@M" dentro dos Símbolos de dólar de uma Fórmula. Os Valores individuais são separados por ";" e apenas campos preenchidos podem ser usados.

**Exemplo:** UWDRYMIN=$UWDRYMIN1;UWDRYMIN2;UWDRYMIN3\@M$

O Resultado é a Média de UWDRYMIN1 ao UWDRYMIN3.

**Usando um Número de um Dicionário**

Se um Dicionário é utilizado, o que produz um Número ao introduzir um Código. Isto pode ser usado para Cálculos. Ao usar o Prefixo "@R", é efetuada uma recodificação.

**Exemplo**: CU=($CONE\@R$)/SQRT($PEN1;PEN2;PEN3;PEN4;PEN5\@M$)

Primeiro (a) de tudo, a Entrada para CONE é substituída pelo Valor do Dicionário. Para os Valores P1 ao/à P5, toma-se uma média a partir da qual a Raiz quadrada é calculado. O Valor para CONE é então dividido por este Valor.

**Usando Valores de outro Típo de dados**

Valores de um Típo de dados podem ser Usado no(a) cálculo de Valores em outros Típos de dados. ao/à fazer isso, o Código. de um Típo de dados é seguido por dois pontos. A relação ao/à um registro de dados incluido outro Típo de dados é definida por Tempo. ao/à Executar comparação Valores, a Data é usada incluido um Número de maneiras diferentes:

| Operador                     | Significado                            |
| ---------------------------- | -------------------------------------- |
| \[=SMPDATE] ou sem definição | A Data deve ser a mesma                |
| \[<=SMPDATE]                 | A Data pode ser igual ou menor que     |
| \[\<SMPDATE]                 | A Data deve ser menor que              |
| \[>=SMPDATE]                 | A data pode ser a mesma ou mais do que |
| \[\<SMPDATE]                 | A Data deve ser maior que              |

**Exemplo**: WASSPNN=$ROK:ROKNN\[<=SMPDATE]$-$WASSPROK$

O nível da água expresso em metros acima do nível do mar é calculado usando um Valor do Típo de dados ROK (topo do piezómetro). O Valor usado pode ser do mesmo Dia ou do Próximo valor mais recente. Deste Valor, o nível atual é subtraído.

**Utilizando Valores dos Dados gerais do Ponto de monitorização**

É possível incorporar ao/à Geral, Dados gerais e Campos de dados incluido na Fórmula para Pontos de medição. A relação é definida da seguinte forma: $Tablel.Datafield$.

**Exemplo:** $ASBFILTR.INVMBEG$-$WST:WASSPROK$

O Nível da água no Destino WASSPNN calculado usando a elevação do Ponto de monitorização ($ASBFILTR.INVMBEG$) e o Nível de água medido a partir do topo do tubo $WST:WASSPROK$ incluido no Típo de dados.

**Equilíbrio iónico**

Ao usar o símbolo %IONB, o equilíbrio iónico pode ser calculado e usado como resultado.

**Exemplo**: IONICBALA=$%IONB$

***Atenção:*** *Para um Cálculos correto os campos com os nomes, que são esperados pelos Cálculos, devem existir e estar incluido Usa (veja* [*Balanço iónico*](/geodin-desktop/pt/analises/geotechnical-analyses.md)*).*

**Automático Numeração**

Para atribuir automaticamente números consecutivos a um Parâmetro, a Expressão $%FIRSTID:PARAMETER$ pode ser usada. A Numeração para o Parâmetro correspondente Sempre começa em 1.

**Exemplo:** $%FIRSTID:TESTNO$

O Número de Testar é automaticamente atribuído um Número consecutivo incluido no campo TESTNO para cada registo. O Primeiro registo recebe o número 1.

**Mais Símbolos**

$%PI$ produz o Número Pi

$%Nome do usuário$ Usa uma (Texto-)Fórmula, ao Criar o Nome do atual Utilizador do Banco de dados

$%Agora$ Resultados a Data e o Tempo atual

### referência do objeto

$%OBJECTID$ Acesso ao LOCID para Tabelas de Dados gerais se Disponível

$%PRJID$ Acesso ao PRJ\_ID para Tabelas de Dados gerais se estiver Disponível

### Troca de Texto - Fórmulas ao Criar texto formatado

Ao ativar a caixa de controlo *\[Texto de troca (Não Cálculos)]* Um cálculo é impedido ao executar a Fórmula. Esta opção só é útil quando é requerido um Parâmetro de string como Resultado. O Resultado é que os Parâmetro são substituídos por uma string de valores reais, pelo que Não é efetuado nenhum Cálculos.

**Exemplo:** $LOCREG.SHORTNAME$ / $SMPDATE$

incluido no Campo de destino selecionado, é criado uma combinação da Denominação curta do objeto, uma barra oblíqua e a Data, por exemplo "Brg 12 / 12.10.2004".

**Troca de Texto com Macro**

incluido ao Texto de troca, as especificações de Formato podem ser resolvidas.

Exemplo: $LOCREG.SHORTNAME$ de $<SMPDATE@dd.mmmm.yyyy>$

***Atenção:*** *Somente Parâmetro da mesma Tabela (Típo de dados) ou Parâmetro de Típo de objeto podem ser avaliados. O Parâmetro da Tabela atual deve ser especificado aqui sem a Abreviação da Tabela. Veja o exemplo.*

## Referência: Importação/Exportação

incluido no gestor de objeto GeoDin Para o Nível de um Ponto de monitorização OU de um Gropo de medições os Métodos **"Exportar valores medidos"** E ![import measurement values](/files/75ef197c21c30d94155f3cf85471e5750adbc465) **"Importar valores medidos"** pode ser selecionado.

Ao iniciar este método, aparece um diálogo onde todas as Configurações gerais de importação ou exportação podem ser feitas:

[Importar](/geodin-desktop/pt/importar-dados/import.md)

[Exportar](/geodin-desktop/pt/exportacao-de-dados/export.md)

### Gráficos e análises

Se a caixa de seleção *\[Gráficos e análises]* estiver Ligado, Informação adicional para o registo de dados atual é mostrada abaixo da Grelha de entrada.

**Gráfico de colunas**

Os Valores da Coluna atual são representados gráfico na ordem em que os Registos de dados são apresentados na Grelha de entrada.

Para representar um Parâmetro específico no Diagrama (para Preenchimento do Diagrama), tem de ser selecionado um Registo de dados da Coluna apropriada (por exemplo, um registo de dados da Coluna CHLORIDE). O registo de dados atual será apresentado como um Rectângulo preenchido no Diagrama. Ao clicar no Rectângulo (preenchido ou não preenchido) é possível navegar para o registo de dados na Grelha de entrada.

**Gráfico de linhas**

Representação gráfica dos Valores da Linha atual (registo de dados) na ordem em que as Colunas são apresentadas na Grelha de entrada. Para navegar até à Coluna na Grelha de entrada, clique na Barra do Parâmetro desejado no Gráfico de linhas.

**Controlo da plausibilidade**

Este separador apresenta a análise de plausibilidades da Linha atualmente verificada. A [Plausibilidade](/geodin-desktop/pt/analises/data-checks-and-validations.md) pode ser definido dentro da **Propriedades**.

**Fórmulas**

As últimas fórmulas executadas serão apresentadas quando um novo Registo de dados for registado. O [Geral Fórmulas](/geodin-desktop/pt/analises/formula-basics.md) pode ser definido diretamente no Método **"Registração e manutenção de dados de medição"** ou dentro da **Propriedades**.

**Comparação da lista**

A Comparação da lista escolhida do registo de dados atual será efetuada e o Resultado exibido. O **Grupo de listas** pode ser criado e gerido dentro do **Propriedades**.

**Balanço iónico**

O balanço iónico será apresentado para o registo de dados atual. O [Balanço iónico](/geodin-desktop/pt/analises/geotechnical-analyses.md) é calculado e avaliado com base nas recomendações DVWK 1992.

### Opções de formato

O GeoDin suporta duas disposições de dados tabelares a importar, de tipo Geral.

O Formato **-Tabela por linha-** descreve uma tabela, que contém cada amostra numa linha, os valores do Parâmetro são armazenados em colunas separadas para cada Parâmetro.

```
NOME DATA NA MG NH3 ... Exemplo 1 12.07.2012 2,4 4,5 1,23 ... ... ... ... ... ... ...
```

O Formato **-Tabela por coluna-** descreve uma tabela, incluido na qual uma medição de um parâmetro constitui uma linha. Uma amostra pode consistir num determinado número de linhas (tantos quantos os parâmetros medidos) incluido neste formato. Este formato também permite que adicionalmente informações para cada parâmetro medido sejam ao/à importadas e organizadas incluido no GeoDin também.

```
AMOSTRA DATA PARÂM VALOR COMENTÁRIO Exemplo 1 12.07.2012 NA 2,4 verificado Exemplo 1 12.07.2012 MG 4,5 não verificado Exemplo 1 12.08.2012 NA 9,5 implausível ... ... ... ... ...
```

Para importar dados deste tipo de tabela, tem de fazer ao/à primeiro (a) mais ajustes. Para primeiro (a), selecione as colunas que agrupam os registos de dados de uma amostra. Por conseguinte, assinale as colunas adequadas na lista de **"Campos de dados do agrupamento"**; no exemplo acima, assinale as colunas AMOSTRA E DATA. O Resultado desta seleção seria que as duas primeiras linhas (Exemplo 1 de 12.07.2012) gerariam uma linha de importação cumulativa e a terceiro (a) linha (Exemplo 2 de 12.08.2012) outra.

Selecione na lista pendente "**Campo de dados com nome do parâmetro:"** a coluna que contém o nome ou código do parâmetro; PARÂM no exemplo acima.

Da lista suspensa "**Campo de dados com Valor de medição:"** por favor escolha a Coluna, que contém o Valor do Parâmetro; incluido no exemplo acima VALOR.

GeoDin Agora irá transformar a Tabela Importar ao/à Formato de Tabela - Tabela por Linhas - (por favor, veja acima). A Antevisão dos dados Importar do nosso exemplo Agora será exibida da seguinte forma:

```
Data da amostragem NA MG ...

Exemplo 1 12.07.2012 2,4 4,5 ... Exemplo 1 12.08.2012 9,5 ... ...

... ... ... ... ...
```

Tenha em atenção que a Informação da Coluna Comentário não se perde. Na Antevisão de Importar, as células dos Valores medidos são assinaladas no canto acima á direita com um Triângulo Vermelho. Para apresentar a Informação adicional. para o Valor de medição, mantenha o Apontador do rato sobre este canto. Para a célula NA=2,4, seria apresentada a Informação 'Comentário:verificado'. Esta Informação pode ser importada utilizando o [Informações suplementares - Valor de medição](/geodin-desktop/pt/espaco-de-trabalho-e-gestao-de-dados/working-with-measurement-data.md).

Há também uma pré-formatação especial para ficheiros de texto no formato Octoware disponível. Não são necessárias mais quaisquer alterações para este formato.

Exemplo de fragmento de um Ficheiro Octoware:

```
OCT>12072240RE0003\10.08.2000 09:10\\\\\\\\\T2000-07949\\\\\\\1\1

EST>FI1

PPA>pH 0\\\\\7.24

PPA>LF 0\\\\\998

PPA>Temp 0\\\\\11.1
```

## Tópicos relacionados

* O conteúdo de referência partilhado de dados de medição/tipo de dados agora está na referência do editor de dados de medição ([Trabalhando com Registração e manutenção de dados de medição](/geodin-desktop/pt/espaco-de-trabalho-e-gestao-de-dados/working-with-measurement-data.md))


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geodin.com/geodin-desktop/pt/analises/formulas-in-measurement-values.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
