pv_ice

An open-source tool to quantify Solar Photovoltaics (PV) Energy and Mass Flows in the Circular Economy, from a Reliability and Lifetime approach

https://github.com/nrel/pv_ice

Science Score: 59.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    1 of 12 committers (8.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.8%) to scientific vocabulary

Keywords

circular-economy circularity circularity-metrics lifetime mass-flow photovoltaics recycle reliability repair reuse solar-energy

Keywords from Contributors

interactive projection renewables renewable-energy radiance bifacial serializer measurement cycles packaging
Last synced: 6 months ago · JSON representation

Repository

An open-source tool to quantify Solar Photovoltaics (PV) Energy and Mass Flows in the Circular Economy, from a Reliability and Lifetime approach

Basic Info
Statistics
  • Stars: 41
  • Watchers: 4
  • Forks: 20
  • Open Issues: 13
  • Releases: 13
Topics
circular-economy circularity circularity-metrics lifetime mass-flow photovoltaics recycle reliability repair reuse solar-energy
Created almost 6 years ago · Last pushed 7 months ago
Metadata Files
Readme License

README.md

Version DOI
License license
Documentation Documentation Status

PV ICE: PV in the Circular Economy, a Dynamic Energy and Materials Tool

This open-source tool explores the effects of Circular Economy (CE) pathways for photovoltaic (PV) materials. It can be used to quantify and assign a value framework to CE efforts including re-design, reduction, replacement, reuse, recycling, and lifetime and reliability improvements across the PV value chain. PV ICE enables tradeoff analysis through scenario comparisons, and is highly customizable through user inputs such as deployment schedules, module properties and component materials, and CE pathways.

The provided PV ICE module and material baselines leverage published data from many sources on PV manufacturing and predicted technological changes. Input data are being compiled here and the baselines are available here for use in other projects as well as for the PV ICE tool.

How it Works

This section provides a brief description of how the PV ICE tool works. FULL DOCUMENTATION CAN BE FOUND AT readthedocs.

Mass

PV ICE is a dynamic mass flow based tool. It takes in any deployment forecast of any evolving module design along with it's component materials and uses sophisticated lifetime and reliability parameters to calculate effective capacity, virgin material demand, and life cycle wastes. The calculator captures all the mass flows shown in the simplified diagram below for all years studied in a simulation (ex: 2020-2050).

Annually deployed cohorts of modules are tracked through the simulation, subjected to lifetime, degradation, and reliability parameters, and guided along user defined CE pathways (ex: resell, recycling). The PV ICE framework is designed for scenario comparisons (ex: different deployment schedules, module designs, or circular pathways) and is capable of both geospatial and temporal analysis (i.e. when and where materials will be demanded or are available).

Module and material properties are known to be variable with time, and PV ICE can capture this dynamic evolution of PV technology. Dynamic baseline inputs for crystalline silicon PV modules and component materials are provided in the PV_ICE \ baselines folder. These baselines are dervied from literature and report data. Module baselines capture the annual average crystalline silicon module (i.e. a market share weighted average of the silicon PV technologies deployed). Each material similarly is a market share weighted average of silicon PV technologies, compiled from multiple sources, most notably consistent with ITRPV data. Please see the Jupyter Journals (tutorials \ baseline development documentation) for the derivations and sources (baselines \ SupportingMaterials) of the provided c-Si baselines. Alternate module and material files can be created by the user, and an expanded set of PV technology baselines is planned for the future, including CdTe and perovskites.

Energy

The energy balance of renewable energy technologies is as important and the mass balance when evaluating sustainability. Additionally, few studies of Circular Economy (CE) pathways consider the energy return on investment of a particular pathway. PV ICE energy flows fill this analysis gap, and provide useful insights into the potential tradeoffs between mass and energy of CE pathways.

The energy flows of PV ICE are based on the mass flows. These energy flows, like the mass flows, are dynamic with time and are seperated into module and material energies. For each supply chain process step captured in the mass flows, an energy per module area or energy per material mass is captured as an input (ex: module manufacturing energy, energy to manufacture rolled glass from silica sand, energy to crush a module for recycling ). The energy demanded for each step is the sum of all electrical energy demands and all fuel/heating energy demands.

We provide an energy baseline for crystalline silicon modules and component materials. Data for these baselines is being compiled from literature and report data. For the complete derivation of the energy demands for crystalline silicon modules and materials, please see the Jupyter Journals (tutorials \ baseline development documentation) and (baselines \ SupportingMaterials). Alternate module and material files can be created by the user, and an expanded set of PV technology baselines is planned for the future, including CdTe and perovskites.

After running a mass flow simulation, an energy flow calculation can be run which will multiply the energy demands by the mass flows and calculate annual generation from the deployed modules. Results of this calculation provide annual, cumulative, and lifetime energy demands and energy generated. These values can be used to calculate energy balance metrics such as energy return on investment (EROI), net energy, and energy payback time (EPBT). These features are actively under development, so check back for updates soon!

Installation for PV ICE

PV ICE releases may be installed using the pip and conda tools. Please see the Installation page of the documentation for complete instructions.

PV ICE is compatible with Python 3.5 and above.

Install with:

pip install PV_ICE

For developer installation, download the repository, navigate to the folder location and install as:

pip install -e .

How to Get Started

A training video is available from the "2nd PV Circularity Workshop Proceedings training"

Alternatively, after you have installed PV ICE, we recommend heading over to our tutorials jupyter journals (PV ICE \ docs \ tutorials). There you will find journals "0 - quick start Example" and "1 - Beginner Example" which can help guide you through your first simulation using the PV ICE provided crystalline silicon PV baselines. In journals 2-4 we walk you through modifications to the basic simulation, including modifying parameters with PV ICE functions to suit your analysis needs.

Some Analyses Featuring/Leveraging PV ICE

PV ICE has been used in a variety of published analyses, including:

High Impact Report: The Solar Futures Report and Circular Economy Technical Report

Ardani, Kristen, Paul Denholm, Trieu Mai, Robert Margolis, 
Eric O’Shaughnessy, Timothy Silverman, and Jarett Zuboy. 2021. 
“Solar Futures Study.” EERE DOE. 
https://www.energy.gov/eere/solar/solar-futures-study.

Heath, Garvin, Dwarakanath Ravikumar, Silvana Ovaitt, 
Leroy Walston, Taylor Curtis, Dev Millstein, Heather Mirletz, 
Heidi Hartman, and James McCall. 2022. 
“Environmental and Circular Economy Implications of Solar Energy
 in a Decarbonized U.S. Grid.” NREL/TP-6A20-80818. NREL.

Peer Reviewed Journals

H. Mirletz, S. Ovaitt, S. Sridhar, and T. M. Barnes. 2022. 
“Circular Economy Priorities for Photovoltaics in the Energy Transition.” 
PLOS ONE 17 (9): e0274351. https://doi.org/10.1371/journal.pone.0274351.

S. Ovaitt & H. Mirletz, S. Seetharaman, and T. Barnes, 
“PV in the Circular Economy, A Dynamic Framework Analyzing 
Technology Evolution and Reliability Impacts,” 
ISCIENCE, Jan. 2022, doi: https://doi.org/10.1016/j.isci.2021.103488.

There are other multiple publications citing PV ICE like PVSC, PVRW, etc. Please see the list in the readthedocs documentation.

Contributing

We need your help to make PV ICE a great tool! Please see the Contributing page for more on how you can contribute. The long-term success of PV ICE requires substantial community support.

License

PV_ICE open-source code is copyrighted by the Alliance for Sustainable Energy and licensed with BSD-3-Clause terms, found here.

Getting support

If you suspect that you may have discovered a bug or if you'd like to change something about CF-MFA, then please make an issue on our GitHub issues page.

Citing

If you use PV_ICE in a published work, please cite:

S. Ovaitt & H. Mirletz, S. Seetharaman, and T. Barnes, 
“PV in the Circular Economy, A Dynamic Framework Analyzing 
Technology Evolution and Reliability Impacts,” 
ISCIENCE, Jan. 2022, doi: https://doi.org/10.1016/j.isci.2021.103488.

and also please also cite the DOI corresponding to the specific version of PVICE that you used. PVICE DOIs are listed at Zenodo.org. For example for version 0.4.3:

Mirletz, H., & Silvana Ovaitt. (2024). 
NREL/PV_ICE: 0.4.3 (0.4.3). 
Zenodo. https://doi.org/10.5281/zenodo.13751195

Owner

  • Name: National Renewable Energy Laboratory
  • Login: NREL
  • Kind: organization
  • Location: Golden, CO

GitHub Events

Total
  • Issues event: 2
  • Watch event: 5
  • Member event: 2
  • Issue comment event: 1
  • Push event: 30
  • Pull request event: 1
  • Fork event: 8
  • Create event: 1
Last Year
  • Issues event: 2
  • Watch event: 5
  • Member event: 2
  • Issue comment event: 1
  • Push event: 30
  • Pull request event: 1
  • Fork event: 8
  • Create event: 1

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 1,080
  • Total Committers: 12
  • Avg Commits per committer: 90.0
  • Development Distribution Score (DDS): 0.564
Past Year
  • Commits: 98
  • Committers: 5
  • Avg Commits per committer: 19.6
  • Development Distribution Score (DDS): 0.459
Top Committers
Name Email Commits
heathermirletz 6****z 471
Silvana Ayala s****a@n****v 470
acadiajean 5****n 64
macmribo 9****o 23
Mirletz h****z@n****v 19
Heather Mirletz h****z@n****v 12
Ayala s****a@n****v 11
Silvana Ovaitt S****t@n****v 5
dependabot[bot] 4****] 2
Rachel Woods-Robinson r****n@l****v 1
Jordan, Dirk D****n@n****v 1
cdeline c****e@n****v 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 17
  • Total pull requests: 21
  • Average time to close issues: 4 months
  • Average time to close pull requests: 20 days
  • Total issue authors: 3
  • Total pull request authors: 4
  • Average comments per issue: 0.35
  • Average comments per pull request: 0.19
  • Merged pull requests: 18
  • Bot issues: 0
  • Bot pull requests: 2
Past Year
  • Issues: 6
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 2
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • shirubana (14)
  • olipfeifferthkoeln (1)
  • macmribo (1)
Pull Request Authors
  • shirubana (16)
  • rwoodsrobinson (3)
  • heathermirletz (2)
  • dependabot[bot] (2)
Top Labels
Issue Labels
wishlist (4) bug (1)
Pull Request Labels
dependencies (2)

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 46 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 1
    (may contain duplicates)
  • Total versions: 23
  • Total maintainers: 1
proxy.golang.org: github.com/nrel/pv_ice
  • Versions: 11
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
pypi.org: pv-ice

Tool to evaluate Circular Economy

  • Versions: 12
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 46 Last month
Rankings
Dependent packages count: 7.3%
Stargazers count: 11.9%
Forks count: 13.3%
Average: 20.7%
Dependent repos count: 22.1%
Downloads: 48.9%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/workflows/pytest.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
requirements.txt pypi
  • configparser ==5.0.0
  • coverage ==5.1
  • future *
  • matplotlib ==3.2.1
  • numpy ==1.22.0
  • pandas ==1.0.3
  • pytest ==5.4.1
  • pytest-cov ==2.8.1
  • python-dateutil ==2.8.1
  • requests *
  • sphinx-autoapi ==1.1.0
  • sphinx-rtd-theme ==0.4.3
setup.py pypi
  • matplotlib *
  • numpy *
  • pandas *
  • sphinx *
  • tqdm *
pyproject.toml pypi
.github/workflows/publish-to-pypi.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/setup-python v5 composite
  • actions/upload-artifact v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
training/requirements.txt pypi
  • jupyter-book *
  • matplotlib *
  • numpy *