inewave
Pacote Python para leitura e escrita dos arquivos de entrada e saída do modelo NEWAVE e dos programas auxiliares NWLISTOP e NWLISTCF.
O inewave é um pacote Python para manipulação dos arquivos de entrada e saída do programa NEWAVE. O NEWAVE é desenvolvido pelo CEPEL e utilizado para os estudos de planejamento e operação do Sistema Interligado Nacional (SIN).
Funcionalidades
- Leitura e escrita dos arquivos de entrada do NEWAVE, com suporte a modificações programáticas de decks de PMO
- Leitura dos arquivos de saída do NEWAVE e dos programas auxiliares NWLISTCF e NWLISTOP
- Dados tabulares expostos como
DataFramedo pandas, prontos para análise e visualização - Interface orientada a objetos consistente: cada arquivo corresponde a uma classe com método
reade, quando aplicável, métodowrite - Suporte a múltiplas versões de formato do mesmo arquivo, com seleção via argumento
version=no métodoread - Importação sob demanda (lazy import) para inicialização rápida mesmo com dezenas de classes disponíveis
Exemplo Rapido
Leitura do arquivo de saída pmo.dat e acesso aos dados de convergência como DataFrame:
from inewave.newave import Pmo
arq_pmo = Pmo.read("./pmo.dat")
arq_pmo.convergencia
Leitura de um arquivo de entrada, modificação de valores e escrita do resultado:
from inewave.newave import Vazoes
arq_vazoes = Vazoes.read("./vazoes.dat")
# Sensibilidade: elevar todas as vazões históricas em 10%
arq_vazoes.vazoes *= 1.1
arq_vazoes.write("./vazoes_sensibilidade.dat")
Instalacao
O inewave é compatível com Python 3.11, 3.12, 3.13 e 3.14.
Instalação a partir do PyPI:
pip install inewave
Instalação da versão de desenvolvimento diretamente do repositório:
pip install git+https://github.com/rjmalves/inewave
Documentacao
A documentação completa do pacote está disponível em rjmalves.github.io/inewave e inclui:
- Tutorial — exemplos de leitura, escrita e modificação de arquivos
- Arquitetura — estrutura interna do pacote e do framework cfinterface
- Perguntas Frequentes — dúvidas comuns dos usuários
- Guia de Desempenho — características de performance e resultados de benchmarks
- Referencia da API — documentação de todas as classes e propriedades públicas
Contribuindo
Contribuições são bem-vindas. Consulte o arquivo CONTRIBUTING.md para instruções sobre como configurar o ambiente de desenvolvimento, executar os testes e enviar pull requests.
Licenca
Distribuído sob a licença MIT.
Metadata
Release files for inewave 1.16.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| inewave-1.16.1.tar.gz | 14.3 MB | With provenance | Details for inewave-1.16.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| inewave-1.16.1-py3-none-any.whl | Python 3 | none | any | Details for inewave-1.16.1-py3-none-any.whl |
Total release size: 14.8 MB
Release files / inewave-1.16.1.tar.gz
| Download URL | inewave-1.16.1.tar.gz |
|---|---|
| Size | 14.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b5d0f8f4a2d19e33d9a9ed791d76a535bc6d58d3ed0bdd2bc3dba1d371a5e282
|
|
BLAKE2b-256 checksum How to use checksums |
111db910f7368cd589412c29dbda48fd2d019ceefac6cf2669fcc6f01cc87964
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / inewave-1.16.1-py3-none-any.whl
| Download URL | inewave-1.16.1-py3-none-any.whl |
|---|---|
| Size | 455.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb8237b0283f840181570de7ed0fe469c6fde0ff6e61f8ff0c7a1de93f795a09
|
|
BLAKE2b-256 checksum How to use checksums |
338859abcdbeca7e50a58c8bcd80914d42db576e774ea16cd4ca8a5fae533075
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logSecurity for inewave 1.16.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for inewave-1.16.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.