This folder contains a few example python scripts to demonstrate how to control
the OGI3 programatically. The first part of this file gives instructions on
connecting the OGI3, and below are descriptions of each of the scripts.

***
The scripts can only be used after updating the bioreactor to version >BR3.7.0.
Instructions on how to do so will have been included in the updater.
***

1. To use these scripts you'll need to install python 3 and the following libraries:
    1) pyserial
    2) pandas
    3) matplotlib

2. Make sure to keep the `ogi.py` file in the same directory as the script you want to
   run - it contains some basic functions to connect and send commands.

3. Turn on the bioreactor and connect your PC to the "BOARD PROG." port on the rear of
   the OGI3 via a USB-A to microUSB cable.

4. Run the python script from Powershell:
    1) Navigate to the directory with the python script like so

        cd path\to\folder

    2) Enter the command:

        python <filename.py>

********************************

`plotODs.py`
Periodically updates a figure with new OD measurements. Start your experiment before
running the script.

`command_prompt.py`
Provides a simple interactive prompt where you can type in commands and see the response.

`batch_culture.py`
Demonstrates setting some experiment parameters and starting an experiment automatically.

`turbidostat.py`
Shows how to update experiment parameters based on measurements by toggling target OD
between two values to get repeat growth curves.

********************************

You're welcome to edit the scripts in any way you see fit. Contact
help@ogibiotec.com if you have questions or feedback.

