Skip to main content

Documentation Status PyPI PyPI - Python Version Downloads CI Codacy Badge codecov DOI

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:

  1. network design (with discrete choice)
  2. resource flows
  3. inventory balance
  4. emission and costing calculations
  5. environmental, social, and economic impact
  6. material and land use for infrastructure development
  7. nonlinear behavior modeling using piece-wise linear curves
  8. transportation
  9. failure and loss

Objective Criteria

Generally, any commodity or impact stream or decision can be optimized. Some examples are listed:

  1. minimizing cost
  2. minimizing impact
  3. maximizing resource discharge

Managing Complexity

Clustering submodules include:

  1. agglomerative hierarchial clustering (AHC)
  2. dynamic time warping (DTW)
  3. k-means

Other approaches to managing computational complexity include:

  1. Integer cuts
  2. Piece-wise linearization (PWL) for non-linear models

Printing

Printing functions all use latex strings, and the following can be displayed:

  1. The mathematical program in set notation, and also descriptively at each index
  2. The solution, which can also be compared across multiple objectives

Visualization

The following can be visualized using line and bar plots:

  1. input data scenario, e.g. capacity limitations, demand, cost factors
  2. 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:

  1. Components such as SI and miscellaneous units, currencies, time units, environmental indicators.
  2. Example and test problems across various applicative domains
  3. Recipes for decision-making, instructions for calculations, and attribute aliases.

External Packages

Callable external packages are available for:

  1. Integration with high-fidelity process modeling modules such as
  2. Filling missing data (weekends, public holidays) for time-series data such as resource price
  3. 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)

Source distribution for energiapy 2.1.6
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)

Table of built distributions (wheels) for energiapy 2.1.6
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page