The goal of this tutorial is to learn how to efficiently generate OD calibration curves for each Smart Sleeve in a 16 vial eVOLVER setup.
You must complete temperature calibrations before doing OD. Temperature effects OD and if there are big differences between vials, you will need to recalibrate all vials once you do a temperature calibration.
Why are OD measurements important?
The turbidity (cloudiness) of the culture typically correlates to how many cells are in a culture. By using a simple LED and photodiode pair, we can quantify how many cells are in the population, track how the culture is growing over time, and observe the culture changing over the course of the experiment.
Why is calibration necessary?
Readings sent from the Raspberry Pi to the computer/server are the raw voltage values measured by the Arduino in the Motherboard. In other words, to make sense of what these readings are, we need a calibration file that converts this to a useable optical density measurement.
Is calibration different between different organisms?
Yes. Cells with different size and shapes scatter differently and would result in unique calibration curves. eVOLVER is set up such that one could easily use the appropriate calibration files for each experiment/organism.
Is calibration different between different temperatures?
Yes. Temperature effects the photodiode sensors that we use to measure OD. If you plan to use different temperatures we suggest doing a new calibration for each one.
Always calibrate OD with the light blocker / splash guard on to block ambient light. Recommendation: check the OD troubleshooting page for other things that can effect OD readings.
16 assembled glass vials:
Glass vials (Chemglass, CG-4902-08)
Vial screw caps
Octagon magnetic stir bars (Fisher, 14-513-57)
300 mL of saturated culture of desired organism
If calibrating to ODs above 1.5, you may need more cells
300 mL of 1X PBS (Phosphage Buffered Saline)
Check your Smart Sleeves with a vial containing water vs a culture of an arbitrary OD to make sure that you see some change in the Setup page of the GUI. Otherwise you will need to change the photodiode or OD LED.
Before preparing standards, turn eVOLVER on and set all vials to the temperature you will use this calibration at (ie 37C for E coli and 30C for yeast) and set stirring to 8.
Wash cells and resuspend in 1X PBS to avoid cell growth
Spin down saturated cultures in 50mL or 250mL centrifuge tubes.
2500 rcf for 5 minutes should be fine for bacteria or yeast
Pour off media and resuspend cells in 50mL 1X PBS
Spin down cells in a 50mL conical tube
Resuspend well in 50mL 1X PBS
Find OD of Concentrated Cell Stock and Make Standards
The cell stock will likely be much too dense to measure undiluted. For example, OD600 absorbance values on our plate reader above about 0.5 are inaccurate and we can expect this stock to be above an OD of 4.
Measure the OD of cell stock using a dilution series
Dilute 200uL of cells into 1800uL of 1X PBS (1:10)
Dilute the 1mL of the 1:10 dilution into 1mL 1X PBS (1:20)
Make 1:40 and 1:80 dilutions
Measure OD of dilutions and a 1X PBS blank
It is recommended to use 300uL of dilution if using plate reader to provide a similar read length to the cuvette
Use absorbance at 600nm for most bacteria and yeast
If the measured OD of the lowest dilution is above 0.5, make further dilutions to bring it below 0.5
Use this spreadsheet to make calculations. Make a copy on your own Google Drive or download for use in Excel.
Calculate OD of concentrated cell stock
Input ODs for dilution and 1X PBS blank into the spreadsheet
Enter calculated OD into 'OD of Cell Stock'
Use a dilution that is roughly between 0.1 and 0.5
Calculate and make OD standards
Optional: alter the series of standards to include more ODs in the range you care about
Get 16 vials and add a stir bar to each
Add calculated amount of 1X PBS and cell stock to each vial
Mix by swirling or putting in eVOLVER with stirring on
Measure OD of Standards
Make dilutions for standards above 0.5 OD
Use a 96-well plate to ease dilutions and transfer to plate reader
Measure ODs and calculate original OD from dilution OD
An example calculation, including the 1X PBS blank is included at the bottom of the spreadsheet
Adjust standards if necessary
Cap vials containing standards and place in eVOLVER to equilibrate to temperature while stirring
Keep track of which vial is which OD
This may take >30 minutes
Each vial is labelled with its latest temperature in the SETUP
page of the GUI
Don't immediately throw out your standards after finishing calibration! You could need to make another calibration should one or more vials be off.
On the eVOLVER app home screen, make sure you are connected to your eVOLVER (green symbol next to active eVOLVER), then choose CALIBRATIONS
and then O.D.
Give the calibration a name (a standard suggestion is YYMMDD_YourInitials_od
) and click enter.
Click on the white box by the S0
. The display should now have an overlay with Sample 0
on top of a box with a keypad. Input the OD values of each sample.
You can input the OD values using the keyboard, then hit enter to increase the vial selected.
Click Start OD Calibration ▷
.
Press ▷
. After the eVOLVER has logged the vials in one configuration, click the forward arrow. Move vials into their new positions, as seen on the right side of the GUI.
Click VIEW COLLECTED DATA
to monitor the smoothness of the curves as you calibrate. If a particular value is a big outlier, consider rewinding to that vial position and doing it again. Don't worry your other work will be saved!
Continue until all sixteen sets of values have been saved for each standard in each vial.
Click the pen button to submit and save the calibration. Then click Exit
after the calibration is logged.
To validate the calibration was logged on the eVOLVER, from the touch screen home tap Setup
and then tap the box next to OD:
and a list of calibrations should come up. Select your recent one from the list. If not present, it was not logged to the eVOLVER.
Before doing an experiment it is recommended to further validate your calibration (after you have selected it on the SETUP
page) by starting an experiment and logging a few values for each vial at a known OD.
Before beginning calibrations all Software Installation and Network Configuration should be complete.
In order to appropriately interpret data from and actuate physical elements connected to the eVOLVER framework, a relationship must be established between the electrical signals generated by attached sensors and the physical phenomenon they are measuring. This is done by manually measuring values on a controlled set of data via some gold-standard assay or measurement device and comparing these data to the eVOLVER generated data. By doing this across a range of different values, a function can be fit to this relationship to allow eVOLVER to interpret data accurately.
For more information see here.
Calibrations should proceed in the following order:
If the GUI fails to calibrate you can try to use calibrate.py manually.
The goal of this tutorial is to learn how to calibrate the temperature settings for each Smart Sleeve in a 16 vial eVOLVER setup
You must complete temperature calibrations before doing OD calibrations. Temperature affects OD and if there are big differences between vials, you will need to recalibrate all vials once you do a temperature calibration.
Why are temperature calibrations important?
Each microorganism has its own culture temperature requirement. Temperature may affect the successful cultivation and growth characteristics of the culture. By using a simple thermistor and heating resistor pair, we can track and change the culture temperature over time.
Why is calibration necessary?
Readings sent from the Raspberry Pi to the computer/server are the raw thermistor values measured by the Arduino. To make sense of the readings in terms of values we understand, we need a calibration file that converts this to degrees (celsius).
Do I need to redo temperature calibration if I switch out a thermistor/resistor pair?
Yes. Variability exists across the individual thermistor and heating resistor elements, necessitating a new temperature calibration anytime one of these parts are replaced. This is why the calibration curve is unique to each smart sleeve.
16 eVOLVER vials filled with 15mL water
Glass vials - 40mL (Chemglass, CG-4902-08)
Thermometer with probes
Do not use a thermocouple-based thermometer, as the magnetic field from the stir components can interfere with measurements
eVOLVER Electron GUI
This tutorial is for the newest version of the eVOLVER Electron App (Release 2.0.1), which enables both data visualization between each temperature calibration step (RT -> +10C -> +20C), as well as GUI-enabled calibration (without use of the command line).
For older versions of the Electron GUI (Release v1.2.1 and earlier), additional notes are provided at the bottom to successfully complete the calibration - the process remains largely the same, apart from the use of the command line to complete the calibration.
eVOLVER
Temperature Equilibrium
Generally, there are two independent methods to determine if the vial water has reached temperature equilibrium.
Place the thermometer probes into the water, clear the "Min/Max" readings, and wait until the reads no longer fluctuates within ~2min of monitoring.
The eVOLVER Electron GUI has an in-built function that displays the change in thermistor value from the last read, shown as a (+/-) value in brackets next to the current thermistor value being read. The GUI uses this information to determine whether the vials have equilibrated across time, shown as an orange circle indicator around each vial circle on the GUI that should turn fully orange upon equilibration.
Importantly, sometimes the vials will not display the achievement of equilibrium correctly. Please use your discretion with respect to the time elapsed under heat, lack of temperature fluctuations, similarity of temperature measured by thermometer across vials, and the GUI equilibrium function to determine when equilibrium has been reached.
Turn on the eVOLVER 5V power supply. Wait 5 seconds. Turn on the eVOLVER 12V power supply.
Open up the eVOLVER Electron GUI app, and ensure you are connected to the correct eVOLVER you wish to calibrate in the upper-right hand corner of the "Home Screen". The circle should be solid green, indicating that the eVOLVER is connected.
Tap "Setup" in the GUI home screen, select all vials by tapping "Select All" in the bottom right corner. The vial circles should highlight orange. Tap the "Next ->" button in the upper right-hand box (which includes all the control parameters) until you reach the "Temperature" tab. Drag the slider all the way down to "20C". Tap the button, and the "Executed Commands" box in the lower right should indicate that a temp command was sent to all vials.
Place all the eVOLVER vials, pre-filled with 15mL of water, into the Smart Sleeves.
Go back to the "Home Screen", click "Calibrations" and then "Temp" in the eVOLVER Electron App.
Name the calibration, hit enter, and then click "Start Temperature Calibration". A prompt will read "Heaters turned off. Let equilibrate, then enter values."
Room Temperature: Wait ~30 minutes for the temperature of the water to equilibrate to ambient room temperature (and heat generated by the eVOLVER).
Once equilibrated, measure the temperature of each vial with the thermometer probe and log the temperature measurements in Celsius in the Electron GUI.
The newest version of the eVOLVER Electron App (Release 2.0.1) enables data visualization between each temperature calibration step (RT -> +10C -> +20C). This is especially useful when verifying that the thermistor reads are as expected, and follows an inverse linear relationship between thermistor value and temperature.
Wait 60-120 minutes for the temperature of the water to equilibrate. Use the system outlined in the section "Temperature Equilibrium" to establish when the temperature has equilibrated.
Wait ~2-3hrs, or leave overnight.
Calibrate: An edit icon button should appear once all 3 measurements have been made. Click on the button, and a graph of the linear calibration curves for all thermistors across the smart sleeves should appear. Please confirm that the curves look linear. If everything looks good, please exit out of the graph (press the backwards arrow twice), and voila! You have completed your Temperature Calibration! Please be sure to change the temperature calibration file to the most recent in the eVOLVER set-up menu (click on the temperature calibration button).
IF In-GUI Calibration Fails (Unexpected Javascript/Python Error)
If after clicking on the "Edit" button upon completion of all 3 measurements, the eVOLVER GUI encounters an unexpected Javascript/Python error, do not fret! The raw calibration data is now saved on the Raspberry Pi, so you just need to continue along to the info note below to run the calibration through the command line. Feel free to exit the calibration at this point - your collected data is safe.
For older versions of the eVOLVER electron GUI (Release v1.2.1 and earlier)
If you are using an older version of the eVOLVER electron GUI (< v2.0.0), an additional step on the command line/terminal is required to linearly fit the acquired calibration data and set-up the temperature calibration. Additionally, there have been instances where unexpected code errors arise, necessitating calibration through command line. You can also still manually run a calibration if you would like to change calibration settings.
Open up a terminal, and navigate to the eVOLVER dpu folder (github link for download). List the raw calibration files on the eVOLVER Pi using:
For Windows, use py instead of python for all commands.
Now that you have the name of the temperature calibration file, manually run the calibration file:
A figure will pop up displaying the linear temperature calibration curves for each vial. If all looks good (inverse linear relationship between thermistor and temperature values - please see above figure for an example of a successful temperature calibration), then exit out of the figure. A prompt on the command line will ask if you would like to update the eVOLVER to the new temperature calibration. Press and enter "y", and voila, you are all done with temperature calibration.
Fill a large beaker with water and submerge all of the pump lines (inputs and outputs of the pumps), ensuring all of the ends are below the surface of the water.
2. Run the pumps on the Setup page to completely fill the lines with water (about 20s)
3. Place 16 vials into a rack and place the output ends of the pumps to be calibrated into the vials.
It's best practice to not put the vials into the eVOLVER platform in case you make a mistake and overflow the vials. Keep the rack to the side.
4. Select the eVOLVER on the top of the GUI home page to be calibrated
5. Navigate to the Pump Calibration page
6. Enter a name for the pump calibration
7. Select the pump configuration for the eVOLVER. In a standard setup, IN1
are the media in pumps, and E
refers to the efflux pumps. If you have another pump array (for a second media input source), it is typically going to be in IN2
. Click Start Pump Calibration
. The standard pumps are the FAST
pumps (~1 mL/s, black pump heads). If you have the slow flow rate pumps (~ 1 ml/m, pink pump heads), select the SLOW
radio button for that array.
IN1
refers to address 0-15, E
refers to addresses 16-31, and IN2
refers to addresses 32-47. If you have a different pump array setup you can either calibrate manually by putting a json fit object into the calibrations.json
file on the RPi server, or reach out on the forum to ask for assistance.
8. Select all of the vials either by clicking the button on the bottom right or clicking and dragging across the vials on the selector. Click PUMP IN
(or whatever the pump array you are calibrating) to run the pumps for 10s if the FAST
radio button was selected or 100s if the SLOW
radio button was selected.
The time the pumps will run will be noted in the bottom right of the screen. If you need to stop the pumps early, click FORCE STOP ALL
.
9. After the pumps finish pumping, measure how much water was pumped by pouring out the water from each vial into a 25 mL graduated cylinder (or something similar). Enter this number into the box for each vial. The flow rate will appear on the vial selector on the right side of the screen.
Round to the nearest half graduation. The minimum resolution cylinder we recommend for typical eVOLVER pumps should have 0.5 mL graduations.
10. Repeat this process for each pump array you have selected for calibration.
11. Click the pen button to submit and save the calibration. Then click Exit
after the calibration is logged.
12. Verify the calibration appears on the setup page.
Press the "RT " button and wait for the eVOLVER to measure the thermistor values (the eVOLVER measures the thermistor values continuously for a minute, with an orange ring appearing around the button. Once complete, the GUI should display "1/3 Measurements made"
Room Temperature +10C: Once complete, click the " +10C ->" button, and then click the "RT +10C ". The GUI should display "Temperature set. Let equilibrate, then enter values."
Once equilibrated, measure the temperature of each vial with the thermometer probe and log the temperature measurements in Celsius in the Electron GUI. Press the "RT +10C " button and wait for the eVOLVER to measure the thermistor values. Once complete, the GUI should display "2/3 measurements made"
Room Temperature +20C: Once complete, click the " +20C ->" button, and then click the "RT +20C ". The GUI should display "Temperature set. Let equilibrate, then enter values."
Once equilibrated, measure the temperature of each vial with the thermometer probe and log the temperature measurements in Celsius in the Electron GUI. Press the "RT +20C " button and wait for the eVOLVER to measure the thermistor values. Once complete, the GUI should display "3/3 measurements made"