Pular para conteúdo

Novidades na versão 0.63.0

Esta versão ajusta as escalas decimais dos indicadores e do contexto de VNA, adiciona yd.di_over_serie e inclui os números-índice da inflação em yd.vna.contexto. Os índices do IGP-M passam a cobrir agosto de 1994 em diante, com três casas decimais.

Há mudanças no esquema dos DataFrames e na cobertura histórica. Quem compara esquemas, concatena dados persistidos ou usa posições de colunas deve revisar essas integrações antes de atualizar. As políticas de consultas sem cache e retentativas introduzidas na 0.62.0 permanecem.

Escalas decimais dos indicadores

As escalas passam a acompanhar a precisão publicada em cada modalidade, sem zeros adicionais para acomodar outra série. Os valores continuam sendo lidos diretamente do texto da fonte, sem passagem por float, e as taxas continuam em unidade decimal.

Dado 0.62.0 0.63.0
Selic Over e DI Over anualizados; Selic Meta Decimal(18, 10) Decimal(18, 4)
Selic Over e DI Over diários Decimal(18, 10) Decimal(18, 8)
PTAX Decimal(18, 4) Decimal(18, 4)
Número-índice do IGP-M Decimal(18, 10) Decimal(18, 3), desde agosto de 1994
Inflação realizada em vna.contexto Decimal(38, 18) Decimal(38, 4)
Projeção informada em vna.contexto Decimal(38, 18) Decimal(38, escala da entrada)

As duas casas percentuais das taxas anuais correspondem a quatro casas em unidade decimal; as seis casas percentuais das diárias correspondem a oito. Escalares, colunas de séries e resultados vazios seguem a escala da modalidade. Por exemplo, a taxa anual antes representada por Decimal("0.1315000000") passa a ser Decimal("0.1315"): o valor econômico é o mesmo, mas a escala e a representação textual mudam. Escalares sem dados continuam retornando Decimal("NaN").

Migração dos esquemas

Atualize os esquemas esperados e os tipos usados em persistência, junções e concatenações. Se uma integração precisar manter temporariamente a escala anterior, converta explicitamente na aplicação:

import polars as pl
import pyield as yd

serie = yd.selic.over_serie(ultimos=5)
serie_compativel = serie.with_columns(taxa=pl.col("taxa").cast(pl.Decimal(18, 10)))

Esse cast acrescenta zeros à representação; não aumenta a precisão da fonte nem recupera índices do IGP-M anteriores ao novo corte histórico. Para análises que exigem ponto flutuante, use float(taxa) ou pl.col("taxa").cast(pl.Float64), considerando a possível aproximação binária.

Série histórica de DI Over

yd.di_over_serie consulta um intervalo inteiro de DI Over ou os últimos registros disponíveis. Reutiliza o SGS do Banco Central e dispensa laços de consultas escalares e a montagem manual do DataFrame.

serie_anual = yd.di_over_serie("27-02-2025", "28-02-2025")
serie_diaria = yd.di_over_serie("27-02-2025", "28-02-2025", anualizada=False)
ultimas_taxas = yd.di_over_serie(ultimos=5)

A assinatura é yd.di_over_serie(inicio=None, fim=None, *, ultimos=None, anualizada=True). Informe inicio ou ultimos. O intervalo é inclusivo e fim=None considera a data atual no Brasil. ultimos, quando informado, tem prioridade sobre o intervalo e deve ser maior que zero. Intervalos longos são divididos automaticamente em blocos seguros para o SGS.

O retorno tem data do tipo Date e taxa do tipo Decimal(18, 4) na modalidade anual ou Decimal(18, 8) na diária. A consulta usa SGS 4389 (anualizada, base 252 dias úteis) ou SGS 12 (diária), sem recalcular uma modalidade a partir da outra. Datas sem dados são omitidas; resultados vazios preservam o esquema. A consulta escalar yd.di_over permanece disponível. Veja a referência de DI Over.

Contexto de VNA com números-índice

yd.vna.contexto passa a incluir quatro colunas:

Coluna Tipo Polars Significado
competencia_anterior Date Primeiro dia do mês anterior à competencia
indice_anterior Decimal(18, 2) para IPCA; Decimal(18, 3) para IGP-M Número-índice da competência anterior; nulo se ausente
indice_atual Mesmo tipo de indice_anterior Número-índice da competência da vigência; nulo se ausente
origem_indice String IBGE ou FGV/Ipeadata; nula se ambos os índices estiverem ausentes

Os índices das duas competências são consultados independentemente da taxa mensal e da publicação dos VNAs. Não são estimados por projeção nem pela razão entre VNAs. Na NTN-C, a taxa mensal continua vindo do SGS/BCB, enquanto os índices vêm da FGV via Ipeadata; essas fontes podem ter disponibilidades diferentes. A nova consulta pode propagar erros operacionais da fonte, como as demais consultas externas.

contexto = yd.vna.contexto("NTN-B", "30-06-2026")
indices = contexto.select(
    "competencia_anterior", "competencia", "indice_anterior", "indice_atual"
)

A inflação realizada preserva as quatro casas das taxas do IPCA ou IGP-M, sem preenchimento até 18 casas. Projeções informadas preservam a escala da entrada, sem arredondamento; inflação indisponível usa escala 4. Os VNAs permanecem com seis casas. A conversão de entradas percentuais textuais, como "0,45%", constrói o Decimal pelo expoente, evitando arredondamento em uma divisão intermediária por 100.

Migração do contexto

Selecione colunas pelo nome para evitar depender de posições alteradas pela inclusão dos novos campos. Ao comparar esquemas ou concatenar contextos, considere a escala dos índices de cada título e a escala da projeção informada.

situacao_inflacao continua descrevendo somente a taxa mensal. pendencias continua indicando falta de base ou taxa para projeção; uma lista vazia não atesta disponibilidade dos índices ou do VNA final. Verifique os campos nulos individualmente.

A razão indice_atual / indice_anterior preserva informação que a taxa mensal arredondada pode perder. Passar essa taxa a yd.vna.projetado aplica as regras de projeção e não reproduz necessariamente o pró-rata realizado da NTN-B. yd.vna.valor usa os índices do IPCA entre duas referências publicadas para NTN-B; para NTN-C, usa a razão entre os VNAs publicados. O contexto não calcula VNA nem elimina a exigência dessas referências. Veja a documentação de VNA.

Cobertura e organização do IGP-M

Os números-índice do IGP-M passam a usar Decimal(18, 3), com cobertura a partir de agosto de 1994, base 100 da série. O corte evita impor a precisão do histórico antigo às consultas usadas em cálculos financeiros em reais: julho de 1994 ainda exige quatro casas na fonte (92.9684).

Competências anteriores são omitidas nas séries e retornam Decimal("NaN") na consulta escalar. Intervalos inteiramente anteriores retornam vazios, preservando o novo esquema; intervalos que atravessam o corte retornam apenas agosto de 1994 em diante. O limite também vale para ultimos. No contexto de VNA de agosto de 1994, indice_anterior fica nulo. A cobertura das taxas mensais segue a série SGS 189.

Se sua aplicação usa o histórico anterior, consulte diretamente a série completa na API do Ipeadata) para preservar a precisão original. Um cast da saída atual não recupera esse período. Veja também a referência do IGP-M.

O IGP-M passa a ser organizado no pacote pyield/igpm/, que reúne as implementações dos números-índice e do calendário. As taxas continuam sendo reexportadas diretamente do SGS/BCB. As chamadas públicas yd.igpm.taxa, taxa_serie, indice, indice_serie e calendario permanecem iguais; somente os caminhos internos de implementação mudam.