Como podemos ajudar?

O plugin do QGIS não carrega

Sintoma: não há menu nem barra de ferramentas Tractrix, ou não há provedor Tractrix na caixa de ferramentas de processamento.

1. Confira a versão do QGIS em Ajuda → Sobre: é necessária a 3.34 ou posterior.
2. Abra Complementos → Gerenciar e instalar complementos → Instalados e verifique se Tractrix for QGIS (OpenAirside) está marcado.
3. Se você mesmo gerou o ZIP, ele deve conter a pasta openairside/ no nível superior, com o metadata.txt dentro dela — não o repositório inteiro.
4. Abra Exibir → Painéis → Mensagens de log e veja as guias Python error e Plugins. Copie qualquer traceback para o seu relato de bug.
5. Se a caixa de ferramentas de processamento não aparecer, ative o complemento principal Processing.

“Engine not found” no AutoCAD ou no Revit

Sintoma: um comando TX para com “The Tractrix engine (tractrix-engine) was not found” e uma lista dos caminhos pesquisados.

Com o motor local, o suplemento procura o tractrix-engine em: o caminho definido em TXSETTINGS; a variável de ambiente TRACTRIX_ENGINE; %ProgramData%\Tractrix\engine\; a pasta engine do suplemento; e o PATH.

1. Reinstale o suplemento: o instalador coloca o motor incluído na pasta engine do suplemento.
2. Se um antivírus colocou o tractrix-engine.exe em quarentena, restaure-o e adicione uma exceção.
3. Se você instalou o motor com o pip, defina o caminho completo em TXSETTINGS ou em TRACTRIX_ENGINE.
4. Ou mude TXSETTINGS para o motor do Cloud.

Excesso de esterçamento, explicado

Sintoma: uma ocorrência do tipo steering_limit, com valor acima do limite.

Para seguir a sua linha, a roda do nariz teria de girar mais do que o ângulo máximo de esterçamento da aeronave. O motor calcula o ângulo a partir da rapidez com que o rumo muda ao longo da trajetória, δ = arctan(L dθ/ds), e marca o pior ponto. Em geral, significa que a curva é fechada demais para aquela aeronave ou que a linha tem uma quebra.

1. Procure na linha um vértice agudo ou um pequeno zigue-zague da digitalização; substitua os cantos por arcos de raio realista.
2. Compare com o raio de curva mínimo da aeronave obtido em Raios de curva e curva de 180°.
3. Confira o steer_source na biblioteca: se foi usado um limite padrão (60° ou 65°), procure o valor do fabricante e informe-o como substituição.
4. No pushback, o limite é o limite de reboque, não o limite de esterçamento da aeronave.

Violação da margem à borda, explicada

Sintoma: uma ocorrência do tipo edge_margin, ou uma margem mínima à borda negativa.

Um pneu externo do trem principal chega mais perto da borda do pavimento do que o afastamento roda–borda da norma — 3 m para um A320 pela ICAO, por exemplo. Um valor negativo significa que o pneu sai do pavimento. Em curva, isso geralmente é o trem principal cortando por dentro: o pavimento precisa de uma sobrelargura.

1. Verifique se o ponto de referência correto está sendo usado: a cabine, para projeto de pistas de táxi.
2. Verifique se a camada de pavimento cobre toda a rota e é um polígono válido.
3. Execute Sobrelargura / pavimento necessário para desenhar o pavimento de que a aeronave precisa.
4. A verificação começa quando o ponto de referência está sobre a linha, então os primeiros metros não são testados.

SRC e entradas geográficas

Sintoma: resultados no lugar errado ou com o tamanho errado, ou envoltórias de poucos centímetros.

• QGIS: camadas em um SRC geográfico (graus, p. ex. EPSG:4326) são calculadas no fuso UTM local e as saídas são gravadas nesse SRC UTM. O QGIS as reprojeta em tempo real; para trabalhos precisos, use um SRC projetado em metros para todo o projeto.
• Um SRC projetado em pés é tratado como não métrico e também calculado em UTM.
• CAD: defina as unidades do desenho (INSUNITS). Um desenho sem unidade usa a configuração metros por unidade.
• Cloud: o GeoJSON deve estar em metros planos; as unidades do DXF são lidas de $INSUNITS, e um DXF sem unidades é lido como metros, com um aviso.

Problemas de login e de tokens no Cloud

Sintoma: não é possível entrar, o link de verificação expirou ou a API retorna 401, 402, 403 ou 503.

• Link de verificação expirado (após 24 horas): peça um novo na página de login. Os links de redefinição de senha valem 60 minutos.
• Tentativas demais: o login tem limite de tentativas; aguarde um minuto e tente de novo.
• 401: o token está errado, revogado ou expirado. Crie um novo; os tokens começam com tx_. Verifique-o com GET /api/v1/whoami.
• 403 “Viewers cannot run simulations”: peça a um administrador a função de membro.
• 402: a organização atingiu um limite do plano; a mensagem indica qual.
• 503 ocupado: tente de novo após o número de segundos indicado em Retry-After. 504: a simulação levou mais de 30 s; encurte a trajetória ou use uma execução pela web.
• No CAD, um token salvo em outro computador ou em outra conta do Windows não pode ser descriptografado: cole-o novamente em TXSETTINGS.