Pular para o conteúdo

Solução de problemas

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.

SintomaCausaCorreção
unknown field em config.json; saída 1; mensagemO 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; mensagemtraining.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; mensagemtraining.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; mensagemUma 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; mensagemUm 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; mensagemUma 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; mensagemUm 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; mensagemEm 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.

SintomaCausaCorreção
policy was written by; saída 1; Códigos de erro — PolicySoftwareMismatchO 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; mensagemNã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); mensagemO 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.

SintomaCausaCorreção
LP infeasible at scenario; saída 3; mensagemUm 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); mensagemUm 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.
SintomaCausaCorreção
O cabeçalho Execution é impresso uma vez por processo, e sua linha Layout: {world_size} {rank_word} on <host> mostra 1 rank; diagnósticoOs 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ósticoUm 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; mensagemOs 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.

SintomaCausaCorreção
V2.1: stage; saída 1; mensagemUm 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; mensagemUma 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; mensagemNenhum 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; mensagemtraining.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.