A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

SwolfPy

A free, multi-platform, Python-based, open-source, SWM LCA optimization framework with built-in parametric and Monte Carlo sensitivity and uncertainty analysis capabilities.
https://github.com/swolfpy-project/swolfpy

Category: Industrial Ecology
Sub Category: Circular Economy and Waste

Keywords

brightway2 life-cycle-assessment monte-carlo-simulation municipal-solid-waste optimization pyside2 python solid-waste-management swolfpy uncertainty-assessment

Keywords from Contributors

composting landfill

Last synced: about 1 hour ago
JSON representation

Repository metadata

SwolfPy is a free, multi-platform, Python-based, open-source, SWM LCA optimization framework with built-in parametric and Monte Carlo sensitivity and uncertainty analysis capabilities.

README.rst

          .. General

================================================================
Solid Waste Optimization Life-cycle Framework in Python(SwolfPy)
================================================================

.. image:: https://img.shields.io/pypi/v/swolfpy.svg
        :target: https://pypi.python.org/pypi/swolfpy

.. image:: https://img.shields.io/pypi/pyversions/swolfpy.svg
    :target: https://pypi.org/project/swolfpy/
    :alt: Supported Python Versions

.. image:: https://img.shields.io/pypi/l/swolfpy.svg
    :target: https://pypi.org/project/swolfpy/
    :alt: License

.. image:: https://img.shields.io/pypi/dm/swolfpy.svg?label=Pypi%20downloads
    :target: https://pypi.org/project/swolfpy/
    :alt: Downloads

.. image:: https://img.shields.io/pypi/format/swolfpy.svg
    :target: https://pypi.org/project/swolfpy/
    :alt: Format

.. image:: https://readthedocs.org/projects/swolfpy/badge/?version=latest
        :target: https://swolfpy.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://github.com/SwolfPy-Project/swolfpy/actions/workflows/python-app.yml/badge.svg?branch=master
        :target: https://github.com/SwolfPy-Project/swolfpy/actions/workflows/python-app.yml
        :alt: Test

.. image:: https://zenodo.org/badge/395802952.svg
        :target: https://zenodo.org/badge/latestdoi/395802952
        :alt: DOi

.. image:: https://img.shields.io/badge/JIE%20DOI-10.1111%2Fjiec.13236-blue
   :target: https://doi.org/10.1111/jiec.13236
   :alt: JIE DOI

* Free software: GNU GENERAL PUBLIC LICENSE V2
* Website: https://swolfpy-project.github.io
* Documentation: https://swolfpy.readthedocs.io
* Repository: https://github.com/SwolfPy-Project/swolfpy


Features
--------

* **Life-cycle assessment of Municipal Solid Waste (MSW) systems**

  * Comparative LCA
  * Contribution analysis
  * LCI report

* **Monte Carlo simulation**

  * Uncertainty analysis
  * Data visualization (distributions & correlations)

* **Optimization**

  * Minimize environmental burdens or cost subject to a number of technical or policy-related constraints


.. list-table:: **Life-cycle process models**
   :widths: auto
   :header-rows: 1

   * -
     - Process model
     - Description
   * - 1
     - Landfill (**LF**)
     - Calculates emissions, material use, and energy use associated with construction, operations,
       closure and post-closure activities, landfill gas and leachate management, and carbon storage.
   * - 2
     - Waste-to-Energy (**WTE**)
     - Calculates emissions, mass flows, and resource use and recovery for the mass burn WTE process.
   * - 3
     - Gasification & Syngas Combustion (**GC**)
     - Calculates emissions, mass flows, and resource use and recovery for the GC process (Produced syngas from
       gasification is combusted to produce electricity by steam turbine).
   * - 4
     - Composting (**Comp**)
     - Calculates emissions, mass flows, and resource use and recovery for aerobic composting process and final use of compost.
   * - 5
     - Home Composting (**HC**)
     - Calculates emissions, mass flows, and resource use and recovery for home composting process and final use of compost.
   * - 6
     - Anaerobic Digestion (**AD**)
     - Calculates emissions, mass flows, and resource use and recovery for anaerobic digestion process and final use of compost.
   * - 7
     - Single-Stream Material Recovery facility (**SS_MRF**)
     - Calculates cost, emissions, and energy use associated with material recovery facilities.
   * - 8
     - Refuse-Derived Fuel (**RDF**)
     - Calculates cost, emissions, and energy use associated with RDF production facilities.
   * - 9
     - Reprocessing (**Reproc**)
     - Calculates emissions, mass flows, and resource use and recovery associated with recycling materials.
   * - 10
     - Transfer Station (**TS**)
     - Calculates cost, emissions, and energy use associated with Transfer Stations.
   * - 11
     - Single Family Collection (**SF_Col**)
     - Calculates cost, emissions, and fossil fuel use associated with MSW collection from single family sector.
   * - 12
     - Multi Family Collection (**MF_Col**)
     - Calculates cost, emissions, and fossil fuel use associated with MSW collection from multi-family sector.
   * - 13
     - Commercial Collection (**COM_Col**)
     - Calculates cost, emissions, and fossil fuel use associated with MSW collection from commercial sector.
   * - 14
     - Animal Feed (**AnF**)
     - Calculates cost, emissions, and energy use associated with conversion of food waste to animal feed and final use of produced feed.


.. Installation

Installation
------------
1- Download and install miniconda from:  https://docs.conda.io/en/latest/miniconda.html

2- Update conda in a terminal window or anaconda prompt::

        conda update conda

3- Create a new environment for swolfpy::

        conda create --name swolfpy python=3.9 graphviz

4- Add Graphviz executables to your system PATH (This step is optional; Enables plotting SWM network). You can find Graphviz executables in ``\\miniconda3\\envs\\swolfpy\\Library\\bin\\graphviz`` folder or search for ``dot.exe`` file in your system. Add the directory to the ``Path`` variable in your environment variables.

5- Activate the environment::

        conda activate swolfpy

6- Install swolfpy in the environment::

        pip install swolfpy

7- Open python to run swolfpy::

        python

8- Run swolfpy

    - In terminal::

          swolfpy
          # or
          python -m swolfpy

    - In python::

          import swolfpy as sp
          sp.SwolfPy()

.. endInstallation

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 598
Total Committers: 5
Avg Commits per committer: 119.6
Development Distribution Score (DDS): 0.294

Commits in past year: 15
Committers in past year: 2
Avg Commits per committer in past year: 7.5
Development Distribution Score (DDS) in past year: 0.067

Name Email Commits
Mojtaba Sardarmehni m****2@n****u 422
Pedro Anchieta p****a@g****m 87
mojtaba sardarmehni 4****m 73
msm_sardar m****i@g****m 15
Mojtaba Sardarmehni m****5@a****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 6
Total pull requests: 6
Average time to close issues: 3 months
Average time to close pull requests: 2 minutes
Total issue authors: 4
Total pull request authors: 1
Average comments per issue: 3.33
Average comments per pull request: 0.0
Merged pull request: 6
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/swolfpy-project/swolfpy

Top Issue Authors

  • mert21433 (2)
  • lauriaco (2)
  • cjlynch278 (1)
  • lynnchehab1999 (1)

Top Pull Request Authors

  • msm-sardar (6)

Top Issue Labels

  • bug (2)
  • question (2)
  • good first issue (1)

Top Pull Request Labels


Package metadata

pypi.org: swolfpy

Solid Waste Optimization Life-cycle Framework in Python(SwolfPy).

  • Homepage: https://swolfpy-project.github.io/
  • Documentation: https://swolfpy.readthedocs.io/en/latest/
  • Licenses: GNU GENERAL PUBLIC LICENSE V2
  • Latest release: 1.4.0 (published about 1 year ago)
  • Last Synced: 2025-04-26T13:32:37.123Z (1 day ago)
  • Versions: 22
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 748 Last month
  • Rankings:
    • Dependent packages count: 7.31%
    • Stargazers count: 13.916%
    • Forks count: 15.416%
    • Average: 16.713%
    • Dependent repos count: 22.088%
    • Downloads: 24.835%
  • Maintainers (1)

Dependencies

docs/requirements.txt pypi
  • PySide2 *
  • brightway2 *
  • ipykernel *
  • nbsphinx *
  • swolfpy *
  • swolfpy_inputdata *
  • swolfpy_processmodels *
requirements.txt pypi
  • PySide2 ==5.14
  • brightway2 ==2.3
  • bw-migrations ==0.1
  • bw2analyzer ==0.9.4
  • bw2calc ==1.8.0
  • bw2data ==3.6.2
  • bw2io ==0.7.12.1
  • bw2parameters ==0.6.6
  • coverage *
  • graphviz *
  • plotly *
  • pyDOE *
  • pytest *
  • pytest-cov *
  • pytest-flake8 *
.github/workflows/python-app.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
pyproject.toml pypi

Score: 11.407564949312402