{"id":13724369,"url":"https://github.com/QSD-Group/QSDsan","last_synced_at":"2025-05-07T18:31:48.297Z","repository":{"id":39159008,"uuid":"299665841","full_name":"QSD-Group/QSDsan","owner":"QSD-Group","description":"Quantitative Sustainable Design (QSD) of sanitation and resource recovery systems.","archived":false,"fork":false,"pushed_at":"2024-10-25T00:23:16.000Z","size":53540,"stargazers_count":30,"open_issues_count":5,"forks_count":14,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-10-29T16:17:33.898Z","etag":null,"topics":["dynamic-simulations","life-cycle-assessment","process-modeling","quantitative-sustainable-design","resource-recovery","sanitation","sustainability-analysis","techno-economic-analysis"],"latest_commit_sha":null,"homepage":"https://qsdsan.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/QSD-Group.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-29T15:53:46.000Z","updated_at":"2024-10-24T23:28:10.000Z","dependencies_parsed_at":"2023-12-18T18:03:07.741Z","dependency_job_id":"a8d5bc52-759e-4b77-ba44-f819c31e28fc","html_url":"https://github.com/QSD-Group/QSDsan","commit_stats":{"total_commits":1433,"total_committers":11,"mean_commits":"130.27272727272728","dds":"0.32100488485694345","last_synced_commit":"ea32b82f9c8e4b33a767e583c4f0ddf8e3cbbb31"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QSD-Group%2FQSDsan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QSD-Group%2FQSDsan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QSD-Group%2FQSDsan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QSD-Group%2FQSDsan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/QSD-Group","download_url":"https://codeload.github.com/QSD-Group/QSDsan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222246905,"owners_count":16955119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dynamic-simulations","life-cycle-assessment","process-modeling","quantitative-sustainable-design","resource-recovery","sanitation","sustainability-analysis","techno-economic-analysis"],"created_at":"2024-08-03T01:01:55.782Z","updated_at":"2024-11-14T14:30:41.065Z","avatar_url":"https://github.com/QSD-Group.png","language":"Python","funding_links":[],"categories":["Industrial Ecology"],"sub_categories":["Life Cycle Assessment"],"readme":"====================================================================================\nQSDsan: Quantitative Sustainable Design for Sanitation and Resource Recovery Systems\n====================================================================================\n\n.. License\n.. image:: https://img.shields.io/pypi/l/qsdsan?color=blue\u0026logo=UIUC\u0026style=flat\n   :target: https://github.com/QSD-Group/QSDsan/blob/main/LICENSE.txt\n\n.. Tested Python version\n.. image:: https://img.shields.io/pypi/pyversions/qsdsan?style=flat\n   :target: https://pypi.python.org/pypi/qsdsan\n\n.. PyPI version\n.. image:: https://img.shields.io/pypi/v/qsdsan?style=flat\u0026color=blue\n   :target: https://pypi.org/project/qsdsan\n\n.. DOI\n.. image:: https://img.shields.io/badge/DOI-10.1039%2Fd2ew00455k-blue?style=flat\n   :target: https://doi.org/10.1039/d2ew00455k\n\n.. Documentation build\n.. image:: https://readthedocs.org/projects/qsdsan/badge/?version=latest\n   :target: https://qsdsan.readthedocs.io/en/latest\n\n.. GitHub test and coverage of the main branch\n.. image:: https://github.com/QSD-Group/QSDsan/actions/workflows/build-coverage.yml/badge.svg?branch=main\n   :target: https://github.com/QSD-Group/QSDsan/actions/workflows/build-coverage.yml\n\n.. Codecov\n.. image:: https://codecov.io/gh/QSD-Group/QSDsan/branch/main/graph/badge.svg?token=Z1CASBXEOE\n   :target: https://codecov.io/gh/QSD-Group/QSDsan\n\n.. Binder launch of tutorials\n.. image:: ./docs/source/images/custom_binder_logo.svg\n   :target: https://mybinder.org/v2/gh/QSD-Group/QSDsan-env/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252FQSD-group%252FQSDsan%26urlpath%3Dtree%252FQSDsan%252Fdocs%252Fsource%252Ftutorials%26branch%3Dmain\n\n.. Email subscription form\n.. image:: https://img.shields.io/badge/news-subscribe-F3A93C?style=flat\u0026logo=rss\n   :target: https://groups.webservices.illinois.edu/subscribe/154591\n\n.. Event calendar\n.. image:: https://img.shields.io/badge/events-calendar-F3A93C?style=flat\u0026logo=google%20calendar\n   :target: https://qsdsan.readthedocs.io/en/latest/Events.html\n\n.. YouTube video\n.. image:: https://img.shields.io/endpoint?color=%23ff0000\u0026label=YouTube%20 @qsd-group\u0026url=https%3A%2F%2Fyoutube-channel-badge-blond.vercel.app%2Fapi%2Fvideos\n   :target: https://www.youtube.com/@qsd-group\n\n.. Code of Conduct\n.. image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg\n   :target: https://qsdsan.readthedocs.io/en/latest/CODE_OF_CONDUCT.html\n\n.. AppVeyor test of the stable branch, not in active use\n..\n   .. image:: https://img.shields.io/appveyor/build/yalinli2/QSDsan/main?label=build-stable\u0026logo=appveyor\n   :target: https://github.com/QSD-Group/QSDsan/tree/stable\n\n|\n\n.. contents::\n\n|\n\nWhat is ``QSDsan``?\n-------------------\n``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 \u003chttps://github.com/BioSTEAMDevelopmentGroup/biosteam\u003e`_ platform [3]_ with additional functions tailored to sanitation processes.\n\nAs 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). \n\nAll systems developed with ``QSDsan`` are included in the package `EXPOsan \u003chttps://github.com/QSD-Group/EXPOsan\u003e`_ - exposition of sanitation and resource recovery systems.\n\nAdditionally, another package, `DMsan \u003chttps://github.com/QSD-Group/DMsan\u003e`_ (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.\n\n\nInstallation\n------------\nThe easiest way is through ``pip``, in command-line interface (e.g., Anaconda prompt, terminal):\n\n.. code::\n\n    pip install qsdsan\n\nIf you need to upgrade:\n\n.. code::\n\n    pip install -U qsdsan\n\nor for a specific version (replace X.X.X with the version number):\n\n.. code::\n\n    pip install qsdsan==X.X.X\n\nIf you want to install the latest GitHub version at the `main branch \u003chttps://github.com/qsd-group/qsdsan\u003e`_ (note that you can still use the ``-U`` flag for upgrading):\n\n.. code::\n\n    pip install git+https://github.com/QSD-Group/QSDsan.git\n\n\n.. note::\n\n   If this doesn't give you the newest ``qsdsan``, try ``pip uninstall qsdsan`` first.\n\n   Also, you may need to update some ``qsdsan``'s dependency package (e.g., ' ``biosteam`` and ``thermosteam``) versions in order for the new ``qsdsan`` to run.\n\n\nor other fork and/or branch (replace ``\u003cUSERNAME_OF_THE_FORK\u003e`` and ``\u003cBRANCH_NAME\u003e`` with the desired fork and branch names)\n\n.. code::\n\n    pip install git+https://github.com/\u003cUSERNAME_OF_THE_FORK\u003e/QSDsan.git@\u003cBRANCH_NAME\u003e\n\n\nYou can also download the package from `PyPI \u003chttps://pypi.org/project/qsdsan/\u003e`_.\n\nNote that development of this package is currently under initial stage with limited backward compatibility, please feel free to `submit an issue \u003chttps://github.com/QSD-Group/QSDsan/issues\u003e`_ for any questions regarding package upgrading.\n\nIf you want to contribute to ``QSDsan``, please follow the steps in the `Contributing Guidelines \u003cCONTRIBUTING.rst#contributing-guidelines\u003e`_ 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 \u003cdocs/source/tutorials/_installation.rst\u003e`_ might be helpful to you.\n\n\nDocumentation\n-------------\nYou can find tutorials and documents at:\n\n   https://qsdsan.readthedocs.io\n\nAll 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.\n\nFor 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 \u003chttps://www.youtube.com/channel/UC8fyVeo9xf10KeuZ_4vC_GA\u003e`_ so subscribe to receive updates!\n\n\nAbout the Authors\n-----------------\nPlease refer to `Contributors \u003cCONTRIBUTING.rst#contributors\u003e`_ section for a list of contributors.\n\n\nContributing\n------------\nPlease refer to the `Contributing Guidelines \u003cCONTRIBUTING.rst#contributing-guidelines\u003e`_ section of the documentation for instructions and guidelines.\n\n\nStay Connected\n--------------\nIf you would like to receive news related to the QSDsan platform, you can subscribe to email updates using `this form \u003chttps://groups.webservices.illinois.edu/subscribe/154591\u003e`_ (don't worry, you will be able to unsubscribe :)). Thank you in advance for your interest!\n\n\nQSDsan Events\n-------------\nWe will keep this `calendar \u003chttps://calendar.google.com/calendar/embed?src=ep1au561lj8knfumpcd2a7ml08%40group.calendar.google.com\u0026ctz=America%2FChicago\u003e`_ 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).\n\n\nLicense Information\n-------------------\nPlease refer to the ``LICENSE.txt`` for information on the terms \u0026 conditions for usage of this software, and a DISCLAIMER OF ALL WARRANTIES.\n\n\nReferences\n----------\n.. [1] Li, Y.; Zhang, X.; Morgan, V.L.; Lohman, H.A.C.; Rowles, L.S.; Mittal, S.; Kogler, A.; Cusick, R.D.; Tarpeh, W.A.; Guest, J.S. QSDsan: An integrated platform for quantitative sustainable design of sanitation and resource recovery systems. Environ. Sci.: Water Res. Technol. 2022, 8 (10), 2289-2303. https://doi.org/10.1039/d2ew00455k.\n\n.. [2] Li, Y.; Trimmer, J.T.; Hand, S.; Zhang, X.; Chambers, K.G.; Lohman, H.A.C.; Shi, R.; Byrne, D.M.; Cook, S.M.; Guest, J.S. Quantitative Sustainable Design (QSD): A Methodology for the Prioritization of Research, Development, and Deployment of Technologies. (Tutorial Review) Environ. Sci.: Water Res. Technol. 2022, 8 (11), 2439–2465. https://doi.org/10.1039/D2EW00431C.\n\n.. [3] Cortés-Peña, Y.; Kumar, D.; Singh, V.; Guest, J.S. BioSTEAM: A Fast and Flexible Platform for the Design, Simulation, and Techno-Economic Analysis of Biorefineries under Uncertainty. ACS Sustainable Chem. Eng. 2020, 8 (8), 3302–3310. https://doi.org/10.1021/acssuschemeng.9b07040.\n\n\n.. Custom launch badges: https://mybinder.readthedocs.io/en/latest/howto/badges.html\n.. binder_badge: https://img.shields.io/badge/launch-binder%20%7C%20tutorial-579ACA.svg?logo=data:image/png;base64,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\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQSD-Group%2FQSDsan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FQSD-Group%2FQSDsan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQSD-Group%2FQSDsan/lists"}