Cada tabela associa uma falha observada à sua causa e à alteração que a elimina. O texto exato das mensagens está em Códigos de erro, e os códigos de saída, na Referência da CLI; cada linha aponta para a entrada responsável pela respectiva mensagem.
| Sintoma | Causa | Correção |
|---|
unknown field em config.json; saída 1; mensagem | O config.json contém uma chave que o objeto que a envolve não aceita, como um nome digitado errado ou um campo que pertence a outro type de critério de parada. | Remova ou corrija a chave conforme Configuração. A mensagem informa a linha e a coluna. |
a forward-pass count is required; saída 1; mensagem | training.selection está ausente. A chave é obrigatória mesmo quando training.enabled é false. | Adicione training.selection; veja training.selection. |
required field is missing em training.stopping_rules; saída 1; mensagem | training.stopping_rules está ausente. A chave é obrigatória mesmo quando training.enabled é false. | Adicione um conjunto de regras que contenha uma regra iteration_limit; veja training. |
unsupported factor_pivot_threshold (ou outro campo do perfil do solver); saída 1; mensagem | Uma sobrescrita por fase (training.solver.backward, training.solver.forward ou simulation.solver) é verificada contra o backend de solver compilado no momento em que o estudo é montado. Tanto novomodelo validate quanto novomodelo run reportam a rejeição. Uma compilação com CLP recusa qualquer sobrescrita. | Defina o campo dentro do intervalo indicado na mensagem ou remova a sobrescrita; veja training.solver. |
initial storage … must lie in [min_storage_hm3, max_storage_hm3]; saída 1; mensagem | Um valor de storage em initial_conditions.json está fora da faixa de armazenamento da própria usina hidrelétrica em system/hydros.json; uma usina que entra em operação após o primeiro estágio também é verificada. Os limites por estágio em constraints/hydro_bounds.parquet não participam desta verificação. | Defina o armazenamento inicial dentro da faixa indicada na mensagem ou corrija min_storage_hm3 e max_storage_hm3 da usina. |
so its initial storage belongs in; saída 1; mensagem | Uma usina hidrelétrica com configuração de filling está listada em storage no initial_conditions.json, ou uma usina sem essa configuração está listada em filling_storage. | Mova a entrada para o array indicado na mensagem. |
a stage's storage bounds must lie within the reservoir's range; saída 1; mensagem | Um min_storage_hm3 ou max_storage_hm3 em constraints/hydro_bounds.parquet fica fora da faixa do reservatório em system/hydros.json. | Mantenha os limites de armazenamento de cada estágio dentro do min_storage_hm3 e do max_storage_hm3 do reservatório. |
min_storage_hm3 exceeds max_storage_hm3 at … (hydro, stage) pair(s); saída 1; mensagem | Em cada estágio listado, o armazenamento mínimo em vigor excede o máximo em vigor: duas linhas de constraints/hydro_bounds.parquet os definem separadamente, ou uma substituição cruza o limite oposto do reservatório. | Reduza o mínimo ou aumente o máximo em cada estágio listado. |
As regras de admissão dos blocos scenario_source reportam uma falha por vez, na ordem do código; assim, corrigir uma mensagem pode revelar a seguinte: execute novomodelo validate novamente até que passe. As regras verificam simulation.scenario_source além de training.scenario_source, e o fazem mesmo quando simulation.enabled é false. A tabela de regras está em Regras de admissão da fonte de cenários.
| Sintoma | Causa | Correção |
|---|
policy was written by; saída 1; Códigos de erro — PolicySoftwareMismatch | O manifest.bin do checkpoint registra software ou versão diferente do que está em execução. A comparação é exata. | Execute novamente o programa que produziu o checkpoint com a versão em uso; no caso de uma política de fronteira convertida, converta-a de novo; veja Verificação de versão. |
Policy directory not found; saída 1; mensagem | Não há checkpoint em policy.path, resolvido em relação ao diretório de saída. Uma primeira execução interrompida antes de gravar qualquer checkpoint não deixa nenhum. | Aponte policy.path para o checkpoint ou execute o treinamento antes; veja Contrato de carga da política. |
failed to read policy checkpoint; saída 1 (2 com I/O error in … para um arquivo que o sistema operacional se recusa a ler); mensagem | O checkpoint em policy.path não pode ser lido — por exemplo, um cujo format_version não é 4 (unsupported checkpoint manifest format_version …), ou o diretório existe e nem ele nem seus irmãos .staging e .previous contêm um manifest.bin. Uma gravação interrompida que substitui um checkpoint deixa um checkpoint completo, antigo ou novo. | Execute novamente o programa que produziu o checkpoint com a versão em uso, ou aponte policy.path para um checkpoint completo; veja Conteúdo do diretório de checkpoint. |
novomodelo validate executa a mesma carga (--output indica outro diretório de saída), de modo que os dois comandos encontram essas recusas. Ambos os comandos leem um checkpoint de policy.boundary.
| Sintoma | Causa | Correção |
|---|
LP infeasible at scenario; saída 3; mensagem | Um PL de estágio de um cenário da simulação não tem solução viável. novomodelo validate não resolve PLs de estágio e, portanto, aceita esse caso. | Leia o cenário e o estágio indicados na mensagem e verifique os limites das restrições nesse estágio, como armazenamentos mínimo e máximo de uma usina hidrelétrica que entram em conflito. Um armazenamento inicial abaixo do mínimo vigente ao final do primeiro estágio de operação de uma usina precisa ser completado com a afluência desse próprio estágio; novomodelo validate o reporta como aviso ModelQuality. Sistema de penalidades lista quais restrições são flexíveis (soft). |
Training failed after; saída 3 (4 para falha de comunicação); mensagem | Um PL de estágio de uma iteração do treinamento (training) falhou — por exemplo, um subproblema inviável. O treinamento é interrompido e grava saídas parciais no diretório de saída. | No caso de subproblema inviável, a linha error: LP infeasible at stage … indica o estágio, a iteração e o cenário (estágio e cenário são numerados a partir de 0); verifique os limites das restrições nesse estágio. Sistema de penalidades lista quais restrições são flexíveis (soft). Uma falha do solver imprime a mensagem do solver, listada na entrada indicada. |
| Sintoma | Causa | Correção |
|---|
O cabeçalho Execution é impresso uma vez por processo, e sua linha Layout: {world_size} {rank_word} on <host> mostra 1 rank; diagnóstico | Os processos não formaram um único job MPI: cada um inicializou o MPI como um job próprio de um único processo. | Siga os passos de diagnóstico e recompilação em Implantação em HPC e clusters. |
pmijobid missing in fullinit command; diagnóstico | Um MPICH compilado para PMIx não possui cliente PMI-2, de modo que srun --mpi=pmi2 não consegue iniciá-lo. Uma incompatibilidade entre o plugin PMI2 do SLURM e o protocolo PMI2 do MPICH produz o mesmo erro. | Inicie com srun --mpi=pmix; veja Implantação em HPC e clusters. |
same --threads value; saída 1; mensagem | Os processos (ranks MPI) de um mesmo job foram iniciados com valores diferentes de --threads, o que a simulação backward detecta. | Inicie todos os processos com o mesmo valor de --threads. |
'mpi' is not available in this build; saída 4; mensagem | --comm-backend mpi foi definido em um binário compilado sem suporte a MPI; novomodelo version imprime comm: local. | Execute o binário novomodelo-mpi sob um lançador MPI; veja Implantação em HPC e clusters. |
novomodelo validate reporta as três primeiras linhas como StochasticPreparationError para a biblioteca da árvore de aberturas e como StudySetupError para a biblioteca do esquema forward historical (BoundaryReconciliationError com policy.boundary); Recusas da biblioteca histórica reproduz as mensagens.
| Sintoma | Causa | Correção |
|---|
V2.1: stage; saída 1; mensagem | Um estágio do estudo não tem season_id: não declara nenhum, e as definições de períodos sazonais estão ausentes ou não cobrem sua data de início. | Atribua um season_id a todos os estágios do estudo. |
V2.3, non-finite eta; saída 1; mensagem | Uma usina hidrelétrica tem desvio-padrão sazonal nulo e uma observação histórica diferente de sua média, ou o ajuste falha numericamente. | Forneça histórico igual à média da usina ou um desvio-padrão não nulo. |
no valid historical windows found; saída 1; mensagem | Nenhum ano inicial tem histórico que cubra os períodos sazonais necessários, de modo que o conjunto de janelas fica vazio. | Forneça histórico que cubra os períodos sazonais necessários para pelo menos um ano inicial. |
openings source is 'file'; saída 2; mensagem | training.scenario_source.openings é {"source": "file"} e scenarios/noise_openings.parquet está ausente. | Coloque a árvore em scenarios/noise_openings.parquet ou declare {"source": "generated"} (ou omita openings) para que o Novo Modelo a gere; veja training. |