Energia is a decision-making tool. Models can be constructed by providing data regarding bounds on commodity streams and operations. Spatial specificity and time-series input of varying sizes renders multiscale models. Their analysis yields insight into the interactions between different decisions. The term 'streams' is applied broadly. pre-categorized streams are broadly classified into commodities (resource, currency, emission, land, material, land, etc.) and impact (economic, environmental, social).
Operation types current include process, storage, and transportation. A process is a catch-all for power generation, dense energy carrier (DEC) or chemical production. Storage involves charging and discharging which can both be configured individually. Transportation networks can involve multiple linkages between locations. Operational parameters include material and land use, impact, conversion efficiency. Construction can also be modeled as capacity sizing problems.
Broadly, Energia can be applied towards the multiscale modeling and optimization of energy systems under uncertainty. Risk analysis can be performed using various approaches such as scenario analysis, stochastic and robust programming, and multiparametric programming. The general class of problems is currently multiparametric mixed integer non-linear programming (mpMILP). Non-linear programs (mpMINLPs) can be modeled using piece-wise linearization. The multiscale nature of models affords simultaneous design and scheduling. Further Comprehensive resource balances allow cost optimization, carbon accounting, social life cycle analysis, and other forms of impact analysis.
Notably, impact is ascertained as a function of decisions. The trade-offs between minimizing or maximizing different impact streams can be determined as pareto fronts. Outputs such as stream contributions, production levels, capacities as a function of time and space can also be exported and illustrated. Additionally, scenario reduction via clustering, and integer cuts can be utilized to manage computational tractability.
Modeled Aspects
This is an indicative list of the types of decisions and phenomena that Energia models:
- network design (with discrete choice)
- resource flows
- inventory balance
- emission and costing calculations
- environmental, social, and economic impact
- material and land use for infrastructure development
- nonlinear behavior modeling using piece-wise linear curves
- transportation
- failure and loss
Objective Criteria
Generally, any commodity or impact stream or decision can be optimized. Some examples are listed:
- minimizing cost
- minimizing impact
- maximizing resource discharge
Managing Complexity
Clustering submodules include:
- agglomerative hierarchial clustering (AHC)
- dynamic time warping (DTW)
- k-means
Other approaches to managing computational complexity include:
- Integer cuts
- Piece-wise linearization (PWL) for non-linear models
Printing
Printing functions all use latex strings, and the following can be displayed:
- The mathematical program in set notation, and also descriptively at each index
- The solution, which can also be compared across multiple objectives
Visualization
The following can be visualized using line and bar plots:
- input data scenario, e.g. capacity limitations, demand, cost factors
- solution output: inventory, production, consumption, discharge/sales schedule; contribution towards costs (capital, variable and fixed operational), meeting demand.
Library
energia.library has a variety of pre-loaded sets of:
- Components such as SI and miscellaneous units, currencies, time units, environmental indicators.
- Example and test problems across various applicative domains
- Recipes for decision-making, instructions for calculations, and attribute aliases.
External Packages
Callable external packages are available for:
- Integration with high-fidelity process modeling modules such as
- Filling missing data (weekends, public holidays) for time-series data such as resource price
- Fetch weather data at an appropriate resolution from NREL NSRDB for any county in the US
Interface
Energia is optimized for use in jupyter notebooks. Note that some of these functionalities are available in Energia<2.0.0 and are being ported to the 2.0 interface.
Metadata
Release files for energiapy 2.1.6
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 |
|---|---|---|---|---|
| energiapy-2.1.6.tar.gz | 92.3 kB | Without provenance | Details for energiapy-2.1.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| energiapy-2.1.6-py3-none-any.whl | Python 3 | none | any | Details for energiapy-2.1.6-py3-none-any.whl |
Total release size: 216.5 kB
Release files / energiapy-2.1.6.tar.gz
| Download URL | energiapy-2.1.6.tar.gz |
|---|---|
| Size | 92.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bf6f917c088d51e3fc35e19686f06bfe8993c07953e582cb171410ef162d590b
|
|
BLAKE2b-256 checksum How to use checksums |
170cefecf31d61860a3c5c1803cbbd70fb17fa7d93faaf362e104304e75474cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.9
|
Release files / energiapy-2.1.6-py3-none-any.whl
| Download URL | energiapy-2.1.6-py3-none-any.whl |
|---|---|
| Size | 124.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1f2eff5e2a2136bae7b5614deb45d5c16b8199111e6930625472c27616c02e1b
|
|
BLAKE2b-256 checksum How to use checksums |
3393b0616c75a592650578caec0fb469461866001f97c0f40a88177d6ce07b7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.9
|
Security for energiapy 2.1.6
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A 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.