Critérios

O que é um critério

O CapCad separa duas coisas que costumam viver juntas nos escritórios:

• Estilo organiza o entregável — layers, pranchas, relatórios, aparência da sinalização. É o assunto de Estilos.
• Critério organiza a diretriz de projeto e o material — o que a norma exige naquele trecho da via.

Um erro de estilo é "o carimbo está errado". Um resultado de critério é "nesta estaca, com esta velocidade diretriz, a linha de bordo é a de cadência 12" ou "com este volume de tráfego, o substrato da placa é aquele".

A forma de um critério

Cada critério tem:

O nome do critério é a junção dos dois primeiros campos, com um ponto no meio: VelocidadeDiretriz.Lfo2Layer, VDM.PlacaSubstrato. É por esse nome composto que ele é referido em toda parte.

A tabela de valores

A tabela tem duas colunas e é lida de duas formas diferentes, conforme o que estiver na primeira célula:

Tabela numérica — faixas. Quando a primeira coluna da primeira linha é um número, cada linha é o limite inferior de uma faixa:

40,SINA_HOR_AM_TA8_LFO3
60,SINA_HOR_AM_TA12_LFO3
80,SINA_HOR_AM_TA16_LFO3

O resultado que a tabela acima devolve para cada velocidade de 20 a 120 km/h, produzido rodando o próprio resolvedor do CapCad. Repare no trecho inicial: abaixo do primeiro limite o critério devolve vazio, e não a primeira linha.

Esse detalhe é deliberado e importante: uma via de 30 km/h, na tabela acima, não recebe a linha de 40. O critério simplesmente não responde, e quem o chamou usa o valor que o usuário escolheu. Do último limite para cima, o resultado é o da última linha — 120 km/h devolve a mesma coisa que 80.

Tabela de texto — chaves. Quando a primeira célula não é um número, a tabela inteira é lida como chaves de texto, comparadas exatamente (mas sem distinguir maiúsculas de minúsculas):

Rural,SINA_HOR_BR_TA12_LBO
Urbana,SINA_HOR_BR_TA6_LBO

Rural e rural acham a mesma linha; Vicinal não acha nada e devolve vazio.

Expressões. Uma tabela que contenha um sinal de igual (=) em qualquer lugar é tratada como expressão e não como tabela. Nesta versão as expressões não são avaliadas: o critério devolve vazio e a mensagem expression tables are not evaluated yet. Critérios de expressão do acervo antigo, portanto, ainda não produzem resultado.

Conjuntos de critérios

Os critérios não vivem soltos: vivem em conjuntos, que são predefinições guardadas no CapCloud sob o tipo Criteria. O conjunto padrão chama-se contran.recomendado.

O projeto escolhe o seu conjunto na aba Principal do Gerenciador de Projeto, no campo Critérios: Técnicos. O nome é gravado na chave CapCad.Criteria.Geometry da configuração do projeto e espelhado nas propriedades do eixo, de modo que um desenho levado para outro projeto continue sabendo contra qual conjunto foi feito.

Um eixo pode ainda carregar critérios locais, gravados nas suas próprias propriedades, cada um com o seu interruptor de ligado/desligado. Quando os dois existem, o dicionário que os consumidores enxergam é a fusão dos dois — e, no código de hoje, um critério da nuvem com o mesmo nome sobrepõe o local.

Onde os critérios já são usados

Linhas de bordo e de eixo, por faixa de velocidade

É o consumidor vivo. No Gerenciador de Eixos, aba Pista, o combo Critério oferece o vazio (padrão) e contran.recomendado. Escolhido um conjunto, o eixo é particionado pelas faixas de velocidade diretriz antes do desenho, e cada trecho consulta o critério correspondente à faixa que vai desenhar:

O resultado é o nome do layer a usar naquele trecho — e como o layer do CapCad tem gramática (SINA_HOR_AM_TA12_LFO3 já diz cor, cadência e função), escolher o layer é escolher a faixa.

Em três situações o critério não responde e vale o layer que você escolheu no formulário:

• o combo Critério está vazio;
• o trecho não tem velocidade diretriz definida;
• o conjunto não tem aquele item, ou o valor cai abaixo do primeiro limite da tabela.

Sem nenhuma faixa de velocidade definida no eixo, o Gerenciador avisa No design-speed bands found on the alignment — the lanes are built unpartitioned. e desenha tudo com um layer só.

Preenchimento de atributos de placa

Este é o consumidor que ainda não está ligado. Na inserção de placas, a opção de preencher atributos pelos critérios — cada critério com uma tag de atributo escreveria o seu resultado no atributo correspondente, avaliado na estaca da placa — está registrada mas não executada: a inserção reporta CriteriaFillDeferred e aplica os valores padrão. Veja Inserir sinalização vertical.

Materiais

Substrato, película e suporte são critérios de materiais. Enquanto o subsistema não responde por eles, quem preenche são as listas de valores padrão do projeto — as abas Default Materiais e Default Diretrizes do Gerenciador de Projeto. É o que a própria nota daquela aba diz: quando não setado ou encontrado em critérios materiais, os valores default abaixo poderão ser aplicados.

Os comandos

CAPCAD_CRITERIA_MATERIAL_DEFAULT — valores padrão de material

Abre o Gerenciador de Projeto já na aba Default Materiais: as duas listas (vertical e horizontal) de valores que entram quando o critério de materiais não responde. Na vertical eles alimentam os atributos dos blocos; na horizontal são anexados como XData.

Ribbon: sem botão nesta versão — o comando existe no menu, mas nenhum painel o expõe.

CAPCAD_CRITERIA_TECHNICAL_DEFAULT — valores padrão de diretriz

O mesmo formulário, na aba Default Diretrizes: a mesma estrutura, para os critérios técnicos.

Ribbon: idem, sem botão.

As duas abas estão documentadas controle a controle em Gerenciador de Projeto.

CAPCAD_CRITERIA_DATASET — os datatypes de material

Abre o mesmo formulário de metadados que CAPCAD_ALIGNMENT_DATASET, mas carregado no dataset Material e com o seletor livre (o comando do eixo o fixa em Eixo). Ele lista os datatypes — os nomes de propriedade reconhecidos e a sua descrição — trazidos do CapCloud.

É um navegador: o botão Salvar fecha a janela, mas a gravação dos metadados editados ainda não está portada, e a linha de comando avisa isso. Os controles estão descritos em Propriedades do eixo.

Ribbon: aba CapCad › painel Projeto › Critérios; aparece também nos painéis Alinhamentos (como DataTypes Materiais) e BIM (como Biblioteca Materiais).

CAPCAD_CRITERIA e CAPCAD_CRITERIA_MATERIAL — ainda não disponíveis

Os dois comandos que abririam a visualização e a edição dos conjuntos de critérios — os critérios geométricos e os de materiais de um eixo — não estão disponíveis nesta versão. Chamá-los mostra o aviso de que eram dos últimos comandos ainda rodando no motor VBA, que foi aposentado, e que o porte ainda não foi feito.

O que já funciona sem eles: escolher o conjunto do projeto (Gerenciador de Projeto), consumir os critérios geométricos (Gerenciador de Eixos, aba Pista) e manter os valores padrão (as duas abas de default).

Ribbon: aba CapCad › painel Alinhamentos › Critérios: Propriedades Eixo x Definições Técnicas (CAPCAD_CRITERIA) e Critérios: Propriedades Eixo x Materiais (CAPCAD_CRITERIA_MATERIAL). Os botões continuam no ribbon e levam ao aviso.

Como um critério é resolvido, passo a passo

1. Alguém pede um critério pelo nome — VelocidadeDiretriz.Lfo2Layer.
2. O nome é procurado no dicionário do conjunto ativo (nuvem mais itens locais do eixo). Não achando: critério requerido não encontrado no Criteria Set corrente, e o resultado é vazio.
3. Do critério lê-se o tipo de entrada (VelocidadeDiretriz) e pergunta-se ao eixo o valor daquela propriedade na estaca em questão. Não havendo: Dataset não encontrado no eixo corrente, e o resultado é vazio.
4. Esse valor é usado para consultar a tabela de valores — por faixa, se numérica; por chave, se de texto.
5. O resultado volta como texto. Vazio significa "o critério não respondeu", nunca "o critério respondeu vazio": quem chamou usa o seu próprio valor de reserva.

Capvars: critério dentro de um texto

Para que um mesmo campo aceite tanto um valor literal quanto um critério, o CapCad usa os capvars: um @ seguido do nome do critério, dentro de qualquer texto.

<@VDM.PlacaSubstrato@>

A leitura é: encontra-se o primeiro @ e toma-se a maior sequência de letras, dígitos, _ e . depois dele — a primeira delas precisa ser letra. O que vinha antes e o que vem depois são preservados, e o valor resolvido entra no lugar. Um texto sem @ volta intacto: é assim que o mesmo parâmetro aceita SINA_HOR_AM_LFO2 ou @VelocidadeDiretriz.Lfo2Layer.

O @ de fechamento não faz parte da sintaxe — não há delimitador de fim. Em <@Nome@>, o token é Nome, com < antes e @> depois.

Notas

• A edição de critérios não tem interface nesta versão. Escolher o conjunto do projeto, sim; criar ou alterar um critério, não. Os dois comandos que fariam isso avisam que não foram portados.
• Abaixo do primeiro limite, uma tabela numérica devolve vazio. É o comportamento correto e deliberado, mas surpreende quem espera que a primeira linha valha "para tudo até 60". Se quiser que valha, comece a tabela em 0.
• Uma tabela com = em qualquer célula vira expressão — e expressões ainda não são avaliadas. Um sinal de igual dentro de uma descrição ou de um nome de layer, colocado por engano na tabela, desliga o critério inteiro.
• Nome de critério é o par completo. Lfo2Layer sozinho não acha nada: o nome é VelocidadeDiretriz.Lfo2Layer.
• Nuvem sobrepõe local, apesar da documentação interna. Na fusão dos critérios da nuvem com os locais do eixo, o código de hoje deixa o item da nuvem vencer quando os nomes coincidem. A nota de projeto interna afirma o contrário; a divergência está registrada e ainda não foi decidida. Na prática: não conte com um critério local para sobrescrever um do conjunto.
• Os conjuntos vêm da nuvem. Sem acesso ao serviço de predefinições, nenhum critério responde e tudo cai nos valores que você digitou. A consulta tem tempo limite e falha em silêncio: o CAD nunca fica travado esperando.
• Critério não é o mesmo que os critérios de curva. Os limites de raio e superelevação que a análise de curvas aplica são tabelas próprias daquele comando, e não passam por este subsistema.
• Os cinco comandos são de AutoCAD. No ARES Commander eles existem e avisam "coming soon"; em BricsCAD, GstarCAD e ZWCAD não estão registrados.