Pular para o conteúdo principal

Cenários e Ficheiros de Cenário

O Que É um Cenário?​

Um Cenário representa uma execução específica de modelo dentro de um Modelo de Dados — por exemplo, Linha de Base 2025 ou Expansão Acelerada da Rede 2035. Cada Cenário está ligado a um Conjunto de Dados Vectorial para geometria espacial e contém resultados de análise através de um ou mais Ficheiros de Cenário (CSV).

Adicionar um Novo Cenário​

  1. Vá a Datasets → Cenários → + Adicionar Cenário.
  2. Preencha os campos (consulte a tabela de campos abaixo).
  3. Clique em Gravar. Em seguida, pode adicionar Ficheiros de Cenário.

Referência dos Campos do Cenário​

CampoDescrição
Nome / Nome (PT)Nome único (máx. 155 caracteres). Apresentado no menu suspenso de cenários do frontend. Suporta traduções EN/PT.
ModeloO Modelo de Dados ao qual este cenário pertence (chave estrangeira).
Conjunto de Dados VectorialO Conjunto de Dados Vectorial que fornece geometria espacial para a camada de mapa deste cenário. Deve ter pelo menos um ficheiro em estado Pronto.
Ordem de ApresentaçãoNúmero inteiro que controla a ordem de ordenação no menu suspenso do frontend. Os números mais baixos aparecem primeiro.
observação

Um único Conjunto de Dados Vectorial pode ser partilhado entre múltiplos Cenários. Os Cenários são ordenados no menu suspenso pela Ordem de Apresentação e, em seguida, pelo ID.

Adicionar Ficheiros de Cenário​

Um Ficheiro de Cenário é um CSV contendo dados de resultados de análise. Cada linha corresponde a uma característica espacial identificada por uma coluna numérica id. O carregamento desencadeia uma tarefa Celery que combina o CSV com a geometria vectorial para gerar uma camada de mapa PMTiles, depois importa o CSV para a base de dados para consultas de resumo.

  1. Vá a Conjuntos de Dados → Ficheiros de Cenário → + Adicionar Ficheiro de Cenário.
  2. Seleccione o Cenário pai.
  3. Carregue um ficheiro CSV. O CSV deve incluir uma coluna id correspondente aos IDs de características no Conjunto de Dados Vectorial ligado.
  4. Opcionalmente, marque Representar características como pontos em níveis de zoom inferiores (consulte Opção de Zoom Baixo como Pontos abaixo).
  5. Clique em Gravar.
Formato CSV

O delimitador é detectado automaticamente (vírgula ou ponto e vírgula). As strings numéricas são automaticamente convertidas para números; todos os outros valores são armazenados como strings. A coluna id é usada como chave de junção e não é armazenada como metadados. Os ficheiros com BOM UTF-8 são tratados correctamente.

Opção de Zoom Baixo como Pontos​

A caixa de verificação Representar características como pontos em níveis de zoom inferiores (low_zoom_as_points) optimiza a renderização para grandes conjuntos de dados de polígonos.

Quando activada, o pipeline gera:

  • Pontos de centróide para os níveis de zoom 5–10
  • Geometria de polígono completa para os níveis de zoom 11–14
  • Estes são combinados num único ficheiro PMTiles usando a ferramenta tile-join do Tippecanoe.
dica

Recomendado para grandes conjuntos de dados (10.000+ características) compostos por polígonos quadrados uniformes. Não é necessário para dados de pontos ou linhas.

Indicador de Estado do Ficheiro de Cenário​

A lista de Ficheiros de Cenário inclui uma coluna Está Activo que indica se um ficheiro é o ficheiro activo actualmente (o mais recente em estado Pronto) para o seu cenário. Apenas o ficheiro Pronto processado mais recentemente está activo.

Monitorizar o Processamento de Ficheiros de Cenário​

O estado progride: Criado → Em Processamento → Pronto (ou Erro).

Se um ficheiro entrar em estado de Erro, abra o registo e leia o campo Mensagem de Erro. Use a acção Reprocessar ficheiros para re-enfileirar ficheiros em estado Pronto ou Erro.

Cache

As respostas de resumo são armazenadas em cache por 24 horas. Após carregar novos dados, use DELETE /api/v1/scenario/{id}/summaries/cache/ para limpar resultados em cache obsoletos.