DICIONÁRIO DOS APOIOS NOVOS — 17/11/2026

1. INDICE_ALIMENTADORES.csv
Mantém formato CSV comma/UTF8BOM do pacote anterior. id_pasta é o nome seguro
D<distribuidora>__<alimentador>; cod_distribuidora/nome_distribuidora identificam
a empresa. alimentador preserva o código CTMT. base_bdgd identifica o conjunto.
ano é o ano interno de calendário; ano_titulo é o ano do nome do conjunto.
mes/tipo_dia são os padrões do Master legado. pasta/master são caminhos relativos.
coordenadas indica Buscoords; cargas/transformadores/contagens_json descrevem
os elementos do modelo legado. n_arquivos inclui manifesto_autonomo.json;
bytes_inventariados soma os arquivos listados pelo manifesto, excluindo o próprio.

2. INDICE_ALIMENTADORES_FRONTEIRAS.csv
Uma linha por alimentador. Campos anteriores id_pasta,cod_distribuidora,
nome_distribuidora,alimentador,ano. SUB=subestação cadastrada; UNI_TR_AT=código
do transformador AT associado na CTMT; PAC_INI=ponto inicial cadastrado.
kV_cabeceira é tensão da fonte equivalente, emkV. GD_modeladas conta Generator;
POT_INST_GD_kW soma capacidade declarada; GD_fonte_nao_informada conta falta de
tecnologia. transformador_fronteira_rede_basica_comprovado=False significa que
esse índice não comprova a ligação física até um banco da rede básica.
SUB ou UNI_TR_AT vazios não são uma subestação/transformador fictícios.

3. INDICE_GD_DISTRIBUIDORAS.csv
alimentadores é quantidade de pastas; UG_brutas é quantidade de registros
das camadas UG do conjunto selecionado; GD_no_DSS é quantidade de Generator
efetivamente presentes; GD_no_DSS_sem_correspondencia precisa serzero.
potencia_GD_DSS_kW soma capacidade emkW; GD_fonte_conhecida/nao_informada
descrevem cobertura tecnológica; GD_energia_dezembro_ausente conta nulos de ENE12,
não zeros reais. Um registro bruto rejeitado na conversão não vira Generator.

4. apoio/gd.parquet E Dados_GD/D<codigo>.parquet
Cada pasta de alimentador recebe somente os geradores que já estavam no DSS.
Dados_GD contém todos os registros UG recuperados da distribuidora, inclusive
os não modelados. Nenhuma pessoa/titular/CPF/CNPJ foi incluída nestas novas tabelas.

id_dss: nome sem prefixo Generator.; hash determinístico de entidade+COD_ID+FID.
COD_ID: identificador original da UG, não um identificador nacional de pessoa.
OBJECTID: FID original da GDB, usado para distinguir registros com COD_ID repetido.
entidade: UGBT_tab ou UGMT_tab; camada de geração BT/MT na GDB.
DIST: código da distribuidora, texto para preservar a chave.
CTMT: código original do alimentador na UG; pode divergir do vínculo reconciliado.
id_pasta: pasta que realmente contém o Generator correspondente; vazia se ausente.
modelado: True se o gerador existe no DSS legado, não se foi selecionado no estudo.
CEG_GD: identificador do empreendimento; pode estar vazio na origem.
chave_ceg: CEG normalizado para o cruzamento tecnológico, não novo cadastro.
PAC: ponto elétrico de acoplamento cadastrado; PN_CON: ponto notável cadastrado.
MUN: código IBGE do município; não é endereço ou coordenada do telhado.
FAS_CON: ligação de fases original; TEN_CON_codigo: código de tensão, não kV direto.
SIT_ATIV: situação declarada da UG; DAT_CON: data declarada de conexão.
POT_INST_kW: potência instalada declarada, emkW, sem mudança automática de escala.
SUB/UNI_TR_AT: vínculos originais da UG, que podem diferir da CTMT do índice.
fonte_bdgd/TIP_GER/TIP_GD: valores se presentes na camada; vazios permanecem vazios.
fonte: tecnologia SigTipoGeracao ANEEL (UFV,CGH,EOL,UTE,...) quando o CEG tem
  tecnologia única; caso contrário NAO_INFORMADA. Não se usa proximidade/nome
  de titular para inventar correspondência. A safra tecnológica está identificada
  no arquivo de proveniência; ela não substitui a safra da energia BDGD.
origem_fonte: CEG_GD_unica_no_cadastro_ANEEL ou sem_tecnologia_identificada.
ano_energia: ano interno do modelo selecionado.
energia_01...energia_12: ENE01...12 da UG, emkWh. Exportação mensal na interpretação
  normativa, não produção bruta. Null permanece desconhecido; zero não é null.

Dados_GD/D<codigo>_proveniencia.json preserva caminho/item/hash catalogado do ZIP,
camadas, regra de IDs, identificação da fonte tecnológica, ponto meteorológico,
contagens e vínculos usados. Caminhos absolutos são referências históricas da
máquina de origem, não dependências para rodar o modelo portátil.

5. PONTOS_METEOROLOGIA.csv E Perfis_GD/D<codigo>/
latitude/longitude em graus EPSG4326: ponto regional de referência, calculado
da amostra Buscoords descrita; não coordenada de todas as UGs.
fuso é IANA; UF_IBGE_modal foi usada na seleção; ano é a safra meteorológica.
NASA_POWER_<ano>.json é resposta original; *_consulta.json tem URL/data/hash.
<ano>_<mes>.csv tem24linhas:
  hora:0...23, intervalo civil[h,h+1), convenção explicitada pelo estudo.
  multiplicador: perfil FV modelado adimensional0...1, média da hora no mês.
  irradiancia_W_m2: GHI médio emW/m², convertido deWh/m² na hora da NASA.
  temperatura_C: média de T2M NASA, temperatura do ar em°C.
  temperatura_celula_modelada_C: calculada comNOCT, não temperatura medida.
  dias_observados: quantidade de dias do mês, com24h verificadas por dia.
O .json lateral registra fórmulas, NOCT, gamma, clipping, safras, unidades,
fonte, posição/fuso e hashes. Sem inclinação/sombra/inversor individuais.

6. SAÍDAS DO RUNNER
Consulte MANUAL_ESTUDO_GD.txt, seções4/6/7. Potências emkW/MW, reativos kvar;
energias emkWh/MWh, tensão empu oukV. P entrando num terminal tem sinalpositivo.
serie_horaria refere intervalos[h,h+1); a soma de24linhas multiplicada por1h
é energia de um DIA TÍPICO, não medição anual. Passos rejeitados não são zero.
diagnostico_GD registra elegibilidade, falta de fonte/energia, inconsistência
energia-capacidade, hipótese explicitada e eventual capacidade excedida do cenário.
Modelos elétricos, curvas e medições operativas são conceitos diferentes.
