aguaclara
A Python package for designing and performing research on AguaClara water treatment plants.
https://github.com/aguaclara-reach/aguaclara
Category: Natural Resources
Sub Category: Water Supply and Quality
Keywords
aguaclara python water-treatment
Last synced: about 10 hours ago
JSON representation
Repository metadata
An open-source Python package for designing and performing research on AguaClara water treatment plants.
- Host: GitHub
- URL: https://github.com/aguaclara-reach/aguaclara
- Owner: AguaClara-Reach
- License: mit
- Created: 2017-05-30T17:35:36.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2025-08-15T13:29:10.000Z (8 months ago)
- Last Synced: 2026-04-15T01:51:46.086Z (5 days ago)
- Topics: aguaclara, python, water-treatment
- Language: Python
- Homepage: https://aguaclara.github.io/aguaclara/
- Size: 15.6 MB
- Stars: 26
- Watchers: 10
- Forks: 13
- Open Issues: 5
- Releases: 56
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Citation: CITATION.cff
README.md
aguaclara
aguaclara is a Python package developed by AguaClara Cornell and AguaClara Reach for designing and performing research on AguaClara water treatment plants. The package has several main functionalities:
- DESIGN of AguaClara water treatment plant components
- MODELING of physical, chemical, and hydraulic processes in water treatment
- PLANNING of experimental setup for water treatment research
- ANALYSIS of data collected by ProCoDA (process control and data acquisition tool)
Installing
The aguaclara package can be installed from Pypi by running the following command in the command line:
pip install aguaclara
To upgrade an existing installation, run
pip install aguaclara --upgrade
Using aguaclara
aguaclara's main functionalities come from several sub-packages.
- Core: fundamental physical, chemical, and hydraulic functions and values
- Design: modules for designing components of an AguaClara water treatment plant
- Research: modules for process modeling, experimental design, and data analysis in AguaClara research
To use aguaclara's registry of scientific units (based on the Pint package), use from aguaclara.core.units import u. Any other function or value in a sub-package can be accessed by importing the package itself:
Example Usage: Design
import aguaclara as ac
from aguaclara.core.units import u
# Design a water treatment plant
plant = ac.Plant(
q = 40 * u.L / u.s,
cdc = ac.CDC(coag_type = 'pacl'),
floc = ac.Flocculator(hl = 40 * u.cm),
sed = ac.Sedimentor(temp = 20 * u.degC),
filter = ac.Filter(q = 20 * u.L / u.s)
)
Example Usage: Core
# continued from Example Usage: Design
# Model physical, chemical, and hydraulic properties
cdc = plant.cdc
coag_tube_reynolds_number = ac.re_pipe(
FlowRate = cdc.coag_q_max,
Diam = cdc.coag_tube_id,
Nu = cdc.coag_nu(cdc.coag_stock_conc, cdc.coag_type)
)
Example Usage: Research
import aguaclara as ac
from aguaclara.core.units import u
import matplotlib.pyplot as plt
# Plan a research experiment
reactor = ac.Variable_C_Stock(
Q_sys = 2 * u.mL / u.s,
C_sys = 1.4 * u.mg / u.L,
Q_stock = 0.01 * u.mL / u.s
)
C_stock_PACl = reactor.C_stock()
# Visualize and analyze ProCoDA data
ac.iplot_columns(
path = "https://github.com/AguaClara-Reach/aguaclara/raw/refs/heads/main/tests/research/data/datalog_6-14-2018.xls",
columns = [3, 4],
x_axis = 0
)
plt.ylabel("Turbidity (NTU)")
plt.xlabel("Time (hr)")
plt.legend(("Influent", "Effluent"))
The package is still undergoing rapid development. As it becomes more stable, a user guide will be written with more detailed tutorials. At the moment, you can find some more examples in specific pages of the API reference.
Contributing
Bug reports, features requests, documentation updates, and any other enhancements are welcome! To suggest a change, make an issue in the aguaclara Github repository.
To contribute to the package as a developer, refer to the Developer Guide.
Citation (CITATION.cff)
cff-version: 1.2.0 message: "If you use this software, please cite it as below." authors: - family-names: "Keller" given-names: "Ethan" - family-names: "Si" given-names: "Hannah" - family-names: "Leung" given-names: "Oliver" - family-names: "Weber-Shirk" given-names: "Sage" - family-names: "Chapin" given-names: "Fletcher T." orcid: "https://orcid.org/0000-0002-2165-7963" - family-names: "Chan" given-names: "Cynthia T." - family-names: "Newatia" given-names: "Karan" - family-names: "Sarmiento" given-names: "Kevin" - family-names: "Yao-Smith" given-names: "Aaron" - family-names: "Maisel" given-names: "Zoe" - family-names: "Zhao" given-names: "Alice" - family-names: "Verghese" given-names: "Anthony" - family-names: "Lin" given-names: "Annabel" - family-names: "Wong" given-names: "Fawn" - family-names: "Pertsalis" given-names: "Elena" - family-names: "Guzman" given-names: "Juan" - family-names: "Pennock" given-names: "William H." orcid: "https://orcid.org/0000-0002-7194-1372" - family-names: "Curillo" given-names: "Arianna" - family-names: "Chiu" given-names: "Dylan T." - family-names: "Lee" given-names: "Inwon" - family-names: "Chaki" given-names: "Swastik" - family-names: "Bediako" given-names: "Cynoc" - family-names: "Vaishnavi" given-names: "Vinodhkanna" - family-names: "Bhatti" given-names: "Aadil Z." - family-names: "Weber-Shirk" given-names: "Monroe" orcid: "https://orcid.org/0000-0001-8037-7710" title: "The AguaClara Package" version: 0.4.0 date-released: 2023-02-08 doi: 10.5281/zenodo.16748574 url: "https://github.com/AguaClara-Reach/aguaclara"
Owner metadata
- Name: AguaClara Reach
- Login: AguaClara-Reach
- Email:
- Kind: organization
- Description:
- Website:
- Location: Ithaca, NY
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/42070153?v=4
- Repositories: 1
- Last ynced at: 2025-08-04T00:46:18.437Z
- Profile URL: https://github.com/AguaClara-Reach
GitHub Events
Total
- Release event: 3
- Delete event: 2
- Issue comment event: 4
- Push event: 7
- Pull request event: 4
- Create event: 5
Last Year
- Release event: 3
- Delete event: 2
- Issue comment event: 4
- Push event: 7
- Pull request event: 4
- Create event: 5
Committers metadata
Last synced: about 15 hours ago
Total Commits: 742
Total Committers: 33
Avg Commits per committer: 22.485
Development Distribution Score (DDS): 0.814
Commits in past year: 10
Committers in past year: 3
Avg Commits per committer in past year: 3.333
Development Distribution Score (DDS) in past year: 0.2
| Name | Commits | |
|---|---|---|
| Oliver Leung | o****2@c****u | 138 |
| SageWS | j****4@e****u | 99 |
| ethan92429 | e****r@g****m | 87 |
| fletchapin | f****n@g****m | 72 |
| karannewatia | k****8@c****u | 66 |
| Cynthia | c****7@c****u | 59 |
| HannahSi | h****9@c****u | 59 |
| Monroe Weber-Shirk | m****s@g****m | 39 |
| Aaron Yao-Smith | a****5@c****u | 33 |
| zoemaisel | 3****7 | 22 |
| Anthony Verghese | a****e@g****m | 9 |
| Elena Pertsalis | e****7@c****u | 9 |
| dtc66 | d****6@c****u | 6 |
| fawnwong | f****g@l****m | 5 |
| William Pennock | w****8@c****u | 5 |
| Cynoc | c****7@c****u | 4 |
| Alice Zhao | 4****0 | 3 |
| Swastik Chaki | s****7@c****u | 3 |
| annabel48lin | 4****n | 3 |
| ilee8 | i****3@c****u | 3 |
| Swastik Chaki | s****i@d****u | 2 |
| Swastik Chaki | s****i@d****u | 2 |
| KevinSarmiento | 3****o | 2 |
| juanchon998 | j****8@c****u | 2 |
| vaishnavi-vinodh | 6****h | 2 |
| Arianna Curillo | a****7@c****u | 1 |
| Swastik Chaki | s****i@d****u | 1 |
| Swastik Chaki | s****i@d****u | 1 |
| Swastik Chaki | s****i@d****u | 1 |
| Swastik Chaki | s****i@d****u | 1 |
| and 3 more... | ||
Committer domains:
- cornell.edu: 13
- dhcp-hol-2928.eduroam.cornell.edu: 1
- dhcp-hol-852.eduroam.cornell.edu: 1
- dhcp-hol-875.eduroam.cornell.edu: 1
- dhcp-mcfad-2370.eduroam.cornell.edu: 1
- dhcp-mcfad-6856.eduroam.cornell.edu: 1
- dhcp-hol-973.eduroam.cornell.edu: 1
- dhcp-mcfad-11387.eduroam.cornell.edu: 1
- earlham.edu: 1
Issue and Pull Request metadata
Last synced: 16 days ago
Total issues: 0
Total pull requests: 3
Average time to close issues: N/A
Average time to close pull requests: about 19 hours
Total issue authors: 0
Total pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.33
Merged pull request: 1
Bot issues: 0
Bot pull requests: 0
Past year issues: 0
Past year pull requests: 3
Past year average time to close issues: N/A
Past year average time to close pull requests: about 19 hours
Past year issue authors: 0
Past year pull request authors: 1
Past year average comments per issue: 0
Past year average comments per pull request: 0.33
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
Top Pull Request Authors
- fletchapin (3)
Top Issue Labels
Top Pull Request Labels
Package metadata
- Total packages: 1
-
Total downloads:
- pypi: 374 last-month
- Total dependent packages: 0
- Total dependent repositories: 2
- Total versions: 46
- Total maintainers: 2
pypi.org: aguaclara
An open-source Python package for designing and performing research on AguaClara water treatment plants.
- Homepage: https://github.com/AguaClara-Reach/aguaclara
- Documentation: https://aguaclara-reach.github.io/aguaclara/
- Licenses: MIT
- Latest release: 0.4.0 (published 8 months ago)
- Last Synced: 2026-04-10T01:00:57.181Z (10 days ago)
- Versions: 46
- Dependent Packages: 0
- Dependent Repositories: 2
- Downloads: 374 Last month
-
Rankings:
- Dependent packages count: 7.303%
- Forks count: 9.892%
- Average: 11.477%
- Dependent repos count: 11.788%
- Downloads: 13.161%
- Stargazers count: 15.239%
- Maintainers (2)
Dependencies
- Sphinx * develop
- aguaclara * develop
- atomicwrites >=1.0 develop
- autopep8 * develop
- codecov * develop
- colorama * develop
- coverage * develop
- pylint * develop
- pytest * develop
- pytest-cov * develop
- pytest-runner * develop
- requests >=2.20.0 develop
- rope * develop
- sphinx_rtd_theme * develop
- matplotlib *
- onshape_client *
- pandas *
- pint *
- scipy *
- urllib3 *
- aguaclara * develop
- alabaster ==0.7.12 develop
- astroid ==2.5.1 develop
- atomicwrites ==1.4.0 develop
- attrs ==20.3.0 develop
- autopep8 ==1.5.6 develop
- babel ==2.9.0 develop
- certifi ==2020.12.5 develop
- chardet ==4.0.0 develop
- codecov ==2.1.11 develop
- colorama ==0.4.4 develop
- coverage ==5.5 develop
- cycler ==0.10.0 develop
- docutils ==0.16 develop
- idna ==2.10 develop
- imagesize ==1.2.0 develop
- iniconfig ==1.1.1 develop
- isort ==5.8.0 develop
- jinja2 ==2.11.3 develop
- kiwisolver ==1.3.1 develop
- lazy-object-proxy ==1.5.2 develop
- markupsafe ==1.1.1 develop
- matplotlib ==3.3.4 develop
- mccabe ==0.6.1 develop
- nulltype ==2.3.1 develop
- numpy ==1.20.1 develop
- oauthlib ==3.1.0 develop
- onshape-client ==1.6.3 develop
- packaging ==20.9 develop
- pandas ==1.2.3 develop
- pillow ==8.1.2 develop
- pint ==0.16.1 develop
- pluggy ==0.13.1 develop
- py ==1.10.0 develop
- pycodestyle ==2.7.0 develop
- pygments ==2.8.1 develop
- pylint ==2.7.2 develop
- pyparsing ==2.4.7 develop
- pytest ==6.2.2 develop
- pytest-cov ==2.11.1 develop
- pytest-runner ==5.3.0 develop
- python-dateutil ==2.8.1 develop
- pytz ==2021.1 develop
- requests ==2.25.1 develop
- requests-oauthlib ==1.3.0 develop
- rope ==0.18.0 develop
- ruamel.yaml ==0.16.13 develop
- ruamel.yaml.clib ==0.2.2 develop
- scipy ==1.6.1 develop
- six ==1.15.0 develop
- snowballstemmer ==2.1.0 develop
- sphinx ==3.5.3 develop
- sphinx-rtd-theme ==0.5.1 develop
- sphinxcontrib-applehelp ==1.0.2 develop
- sphinxcontrib-devhelp ==1.0.2 develop
- sphinxcontrib-htmlhelp ==1.0.3 develop
- sphinxcontrib-jsmath ==1.0.1 develop
- sphinxcontrib-qthelp ==1.0.3 develop
- sphinxcontrib-serializinghtml ==1.1.4 develop
- toml ==0.10.2 develop
- urllib3 ==1.26.4 develop
- wrapt ==1.12.1 develop
- certifi ==2020.12.5
- chardet ==4.0.0
- cycler ==0.10.0
- idna ==2.10
- kiwisolver ==1.3.1
- matplotlib ==3.3.4
- nulltype ==2.3.1
- numpy ==1.20.1
- oauthlib ==3.1.0
- onshape-client ==1.6.3
- packaging ==20.9
- pandas ==1.2.3
- pillow ==8.1.2
- pint ==0.16.1
- pyparsing ==2.4.7
- python-dateutil ==2.8.1
- pytz ==2021.1
- requests ==2.25.1
- requests-oauthlib ==1.3.0
- ruamel.yaml ==0.16.13
- ruamel.yaml.clib ==0.2.2
- scipy ==1.6.1
- six ==1.15.0
- urllib3 ==1.26.4
- matplotlib *
- onshape_client *
- pandas *
- pint *
- scipy *
- urllib3 *
- actions/checkout v2 composite
- actions/setup-python v2 composite
- chabad360/htmlproofer master composite
- codecov/codecov-action v3 composite
- actions/checkout v2 composite
- actions/setup-python v2 composite
- peaceiris/actions-gh-pages v3 composite
- actions/checkout v2 composite
- actions/setup-python v2 composite
- pypa/gh-action-pypi-publish master composite
Score: 12.865388961571215