Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Open-Acidification/AlkalinityTitrator
Apparatus to determine total alkalinity in sea water using an open-cell titration
https://github.com/Open-Acidification/AlkalinityTitrator
alkalinity-titrator ocean-acidification raspberry-pi
Last synced: about 1 month ago
JSON representation
Apparatus to determine total alkalinity in sea water using an open-cell titration
- Host: GitHub
- URL: https://github.com/Open-Acidification/AlkalinityTitrator
- Owner: Open-Acidification
- License: mit
- Created: 2020-01-23T08:20:38.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-06-08T23:49:21.000Z (over 1 year ago)
- Last Synced: 2024-11-25T23:34:05.561Z (about 1 month ago)
- Topics: alkalinity-titrator, ocean-acidification, raspberry-pi
- Language: Python
- Homepage: https://open-acidification.github.io/
- Size: 2.67 MB
- Stars: 7
- Watchers: 4
- Forks: 9
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- open-sustainable-technology - Open Acidification Project - Apparatus to determine total alkalinity in sea water using an open-cell titration. (Hydrosphere / Ocean Carbon and Temperature)
README
# Alkalinity Titrator Project
[](#contributors-)
## Project motivations
As CO2 levels increase, the ocean absorbs more CO2 and becomes more acidic. There currently exists a large deficit of data on how this affects wildlife. Alkalinity Titrators are needed for ocean acidification research. Currently, available models are expensive ($10,000-$25,000). Models on the lower end of the price range are not automated and are therefore time intensive.
This project aims to make ocean acidification research more widely available by lowering the cost of alkalinity titrators.
The problems that the alkalinity-titrator seek to fix are as follows:
- Lower the cost of ocean science equipment by using inexpensive, widely-available parts
- To automate the titration process, saving time and effort when determining total alkalinity
The titration process used in this project is based on SOP 3b from
```Christian, James Robert, Andrew G. Dickson, and Christopher L. Sabine. Guide to Best Practices for Ocean CO2 Measurements. Sidney, B.C.: North Pacific Marine Science Organization, 2007.```
## Current Development Note
The most recent development in this project is the implementation of a UI State Machine framework (see the titration/utils/UIState folder for UI states implemented). While the UI State Machine framework has been fully implemented, the actual titration processes and routines have not been integrated with the UI State Machine (see GitHub Issues for further specifications).
## Setup and Installation
### Setting up the Raspberry Pi
Refer to for instructions on setting up the raspberry pi (note: headless setup is not required if a keyboard and monitor are available). Raspbian lite has everything needed, but the desktop version can be downloaded if working with a GUI is preferable.
### Installing software
Run standard updates on the pi:
``` sh
sudo apt-get update
sudo apt-get upgrade
```
This project utilizes SPI and I2C protocols, both of which often come disabled on the pi. To enable them, run:
``` sh
sudo raspi-config
```
and navigate to "Interfacing Options"; enable both SPI and I2C.
Install git:
``` sh
sudo apt-get install git
```
Clone alkalinity titrator repository to the pi
``` sh
git clone https://github.com/Open-Acidification/alkalinity-titrator.git
```
Run installation script
``` sh
sudo ./install.sh
```
## User Instructions
### Run on Device
To run (with the UI State Machine integrated)
``` sh
./run.sh
```
### Run in Local Environment
To run in a local environment with mocked devices (with the UI State Machine integrated)
``` sh
./run_mocked.sh
```
## Testing
To perform Pytest tests for the devices and UI states.
``` sh
./test.sh
```
## Pins
### Temperature probe ([MAX31865 breakout board](https://learn.adafruit.com/adafruit-max31865-rtd-pt100-amplifier/python-circuitpython))
- PIN 1 (3.3v) to sensor VIN
- PIN 9 to sensor GND
- PIN 19/BCM 10 to sensor SDI
- PIN 21/BCM 21 to sensor SDO
- PIN 23/BCM 23 to sensor CLK
- PIN 29/BCM 5 to sensor CS (or use any other free GPIO pin)
### pH probe ([ADS1115 analog converter](https://learn.adafruit.com/adafruit-4-channel-adc-breakouts/python-circuitpython))
- PIN 17 (3.3v) to ADS1115 VDD - Remember the maximum input voltage to any ADC channel cannot exceed this VDD 3V value!
- PIN 6 to ADS1115 GND
- PIN 5/BCM 3 SCL to ADS1115 SCL
- PIN 3/BCM 2 to ADS1115 SDA
## Libraries
1. Circuit Python -
Used for communicating with the PT1000
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Kaden Sukachevin
💻 📖 🐛
Preston Carman
💻 🐛
Konrad McClure
💻
Noah-Griffith
💻
Barun Debnath
💻
Kieran Sukachevin
⚠️ 💻
Josh Soref
💻
TaylorSmith28
⚠️ 💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!