Skip to content

QSD-Group/EXPOsan

Repository files navigation

EXPOsan: EXPOsition of Sanitation and Resource Recovery Systems

https://img.shields.io/pypi/l/exposan?color=blue&logo=UIUC&style=flat https://img.shields.io/pypi/pyversions/exposan?style=flat https://img.shields.io/pypi/v/exposan?style=flat&color=blue https://github.com/QSD-Group/EXPOsan/actions/workflows/build-latest.yml/badge.svg?branch=main https://readthedocs.org/projects/qsdsan/badge/?version=latest

What is EXPOsan?

The EXPOsan package contains systems developed using the QSDsan package. A list of the developed systems is included in QSDsan's documentation. Please refer to the individual README files within each system module for loading instructions and exemplary results.

Installation

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

pip install exposan

If you need to upgrade:

pip install -U exposan

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

pip install exposan==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/EXPOsan.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>/EXPOsan.git@<BRANCH_NAME>

You can also download the package from PyPI.

To get the git version (use the depth flag to choose how many commit histories you want to clone):

git clone https://github.com/QSD-Group/EXPOsan.git --depth=1

then navigate into the repository (cd EXPOsan) and install the required packages:

pip install -e ".[dev]"

Note

Using the depth flag will only clone the main branch by default, if there are other branches and you want them, then use the no-single-branch flag, i.e.

git clone https://github.com/<YOUR_USERNAME>/EXPOsan.git --depth=1 --no-single-branch

Authors and Contributing

Yalin Li) is the currently maintainer of this repository and package. See commit history for contributors who have contributed to the repository.

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

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.

Packages

 
 
 

Contributors