Skip to main content

Quantitative Sustainable Design for sanitation and resource recovery systems

Project description

https://img.shields.io/pypi/l/qsdsan?color=blue&logo=UIUC&style=flat https://img.shields.io/pypi/pyversions/qsdsan?style=flat https://img.shields.io/pypi/v/qsdsan?style=flat&color=blue https://img.shields.io/badge/DOI-10.1039%2Fd2ew00455k-blue?style=flat https://readthedocs.org/projects/qsdsan/badge/?version=latest https://github.com/QSD-Group/QSDsan/actions/workflows/build-coverage.yml/badge.svg?branch=main https://codecov.io/gh/QSD-Group/QSDsan/branch/main/graph/badge.svg?token=Z1CASBXEOE https://mybinder.org/badge_logo.svg https://img.shields.io/badge/news-subscribe-F3A93C?style=flat&logo=rss https://img.shields.io/badge/events-calendar-F3A93C?style=flat&logo=google%20calendar https://img.shields.io/endpoint?color=%23ff0000&label=YouTube%20@qsd-group&url=https%3A%2F%2Fyoutube-channel-badge-blond.vercel.app%2Fapi%2Fvideos https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg


What is QSDsan?

QSDsan is an open-source, community-led platform for the quantitative sustainable design (QSD) of sanitation and resource recovery systems [1]. It is one of a series of platforms that are being developed for the execution of QSD - a methodology for the research, design, and deployment of technologies and inform decision-making [2]. It leverages the structure and modules developed in the BioSTEAM platform [3] with additional functions tailored to sanitation processes.

As an open-source and impact-driven platform, QSDsan aims to identify configuration combinations, systematically probe interdependencies across technologies, and identify key sensitivities to contextual assumptions through the use of quantitative sustainable design methods (techno-economic analysis and life cycle assessment and under uncertainty).

All systems developed with QSDsan are included in the package EXPOsan - exposition of sanitation and resource recovery systems.

Additionally, another package, DMsan (decision-making for sanitation and resource recovery systems), is being developed for decision-making among multiple dimensions of sustainability with consideration of location-specific contextual parameters.

Installation

The easiest way is through pip, in command-line interface (e.g., Anaconda prompt, terminal):

pip install qsdsan

If you need to upgrade:

pip install -U qsdsan

or for a specific version (replace X.X.X with the version number):

pip install qsdsan==X.X.X

If you want to install the latest GitHub version at the main branch (note that you can still use the -U flag for upgrading):

pip install git+https://github.com/QSD-Group/QSDsan.git

or other fork and/or branch (replace <USERNAME_OF_THE_FORK> and <BRANCH_NAME> with the desired fork and branch names)

pip install git+https://github.com/<USERNAME_OF_THE_FORK>/QSDsan.git@<BRANCH_NAME>

You can also download the package from PyPI.

Note that development of this package is currently under initial stage with limited backward compatibility, please feel free to submit an issue for any questions regarding package upgrading.

If you want to contribute to QSDsan, please follow the steps in the Contributing Guidelines section of the documentation to clone the repository. If you find yourself struggle with the installation of QSDsan/setting up the environment, this extended version of installation instructions might be helpful to you.

Documentation

You can find tutorials and documents at:

https://qsdsan.readthedocs.io

All tutorials are written using Jupyter Notebook, you can run your own Jupyter environment, or you can click the launch binder badge on the top to launch the environment in your browser.

For each of these tutorials, we are also recording videos where one of the QSD group members will go through the tutorial step-by-step. We are gradually releasing these videos on our YouTube channel so subscribe to receive updates!

About the Authors

Please refer to Contributors section for a list of contributors.

Contributing

Please refer to the Contributing Guidelines section of the documentation for instructions and guidelines.

Stay Connected

If you would like to receive news related to the QSDsan platform, you can subscribe to email updates using this form (don’t worry, you will be able to unsubscribe :)). Thank you in advance for your interest!

QSDsan Events

We will keep this calendar up-to-date as we organize more events (office hours, workshops, etc.), click on the events in the calendar to see the details (including meeting links).

License Information

Please refer to the LICENSE.txt for information on the terms & conditions for usage of this software, and a DISCLAIMER OF ALL WARRANTIES.

References

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qsdsan-1.3.1.tar.gz (427.7 kB view hashes)

Uploaded Source

Built Distribution

qsdsan-1.3.1-py3-none-any.whl (484.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page