Metadata-Version: 2.1
Name: swolfpy
Version: 1.1.0
Summary: Solid Waste Optimization Life-cycle Framework in Python(SwolfPy).
Author-email: Mojtaba Sardarmehni <msardar2@alumni.ncsu.edu>
Maintainer-email: Mojtaba Sardarmehni <msardar2@alumni.ncsu.edu>
License: GNU GENERAL PUBLIC LICENSE V2
Project-URL: Homepage, https://swolfpy-project.github.io/
Project-URL: Documentation, https://swolfpy.readthedocs.io/en/latest/
Project-URL: Source Code, https://github.com/SwolfPy-Project/swolfpy
Keywords: LCA,solid_waste,waste_management,swolfpy,brightway2
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Natural Language :: English
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE.md
License-File: AUTHORS.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 python::

        import swolfpy as sp
        sp.swolfpy()

.. endInstallation

=======
History
=======

1.1.0 (2023-07-30)
------------------

* Downgrade to Python 3.9



1.0.0 (2023-06-03)
------------------

* Upgrade to Python 3.10
* Add PreCommit


0.2.5 (2022-04-07)
------------------

* Minor changes in optimization and GUI


0.2.3 (2021-11-16)
------------------

* Improve data validation in GUI
* Improve warning/Pop-ups


0.2.2 (2021-10-02)
------------------

* Add Home Composting (HC)
* Add Gasification & Syngas combustion (GC)
* Add Refuse-derived fuel (RDF)


0.2.0 (2021-05-10)
------------------

* Add tab for correlation analysis.
* Add cost calculations.
* Add help to interface.
* Parallel optimization.



0.1.8 (2020-05-20)
------------------

* Add tab for Monte Carlo results analysis.
* Show Sankey for mass flows after optimization.
* Show SWM Network graph.



0.1.6 (2020-04-11)
------------------

* Add Reprocessing.
* Revise Functional units.
* Revise parameters class.


0.1.0 (2020-02-27)
------------------

* First release on PyPI.
* Main functionality: LCA, Monte-Carlo, and Optimization.
* Process Models include LF, WTE, Composting, AD, SS_MRF, and Collection.
