Lesson 41: Review of exercise 5

(c) 2018 Justin Bois. With the exception of pasted graphics, where the source is noted, this work is licensed under a Creative Commons Attribution License CC-BY 4.0. All code contained herein is licensed under an MIT license.

This document was prepared at Caltech with financial support from the Donna and Benjamin M. Rosen Bioengineering Center.

This lesson was generated from a Jupyter notebook. You can download the notebook here.



In [1]:
# Modules for interacting with our file system. 
import os
import glob

# Number crunching
import numpy as np
import pandas as pd
import scipy.optimize

# Modules for image processing
import skimage.io
import skimage.morphology
import skimage.segmentation
import skimage.measure

import altair as alt

import bokeh.io

import bootcamp_utils

bokeh.io.output_notebook()
Loading BokehJS ...

Problem 5.1: Growth curves from a movie

At the dawn of the molecular revolution in biology, key experiments by Jacques Monod in which he measured growth curves of bacteria under different conditions exposed some of the mechanisms of regulation of gene expression. Those growth curves were measured in a bulk solution. In this exercise, we will measure bacterial growth starting from two bacteria. The movie shows Bacillus subtilis constitutively expressing mCherry growing under slow growth conditions. These data were kindly donated by Jin Park from the Elowitz lab here at Caltech.

a) Load in the series of images contained in the directory data/bacterial_growth/. Be sure that however you store them (a list or tuple or other object) has the frames in the proper order.

b) Segment the images to separate bacteria from background. You do not need to segment individual bacteria; this would likely require some more advanced techniques involving edge detection that we haven't covered in bootcamp.

c) Show a representative image from the stack (with the segmentation overlayed in green) of images. Be sure to check out the README file in the directory containing the images to get the interpixel distance.

d) If $m$ is the mass of bacteria, which is proportional to the area in the images, then, for exponential growth,

\begin{align} m(t) = m_0\,\mathrm{e}^{rt}, \end{align}

where $r$ is the growth rate. Taking the logarithm of both sides gives

\begin{align} \ln m(t) = \ln m_0 + rt. \end{align}

So, the slope of the line on a log-log scale is the growth rate.

With this in mind, plot the bacterial area as a function of time with the area on a log scale. If the plot is linear, the bacteria are performing exponential growth.

e) To get the slope of the line, you can use the np.polyfit() function and perform the regression on a semilog scale. Alternatively, you can fit the exponential function directly using scipy.optimize.curve_fit(). Once you find the growth rate (and intercept), plot the theoretical growth curve along with the data.

f) Use pairs bootstrap to obtain a confidence interval for the growth rate.

Problem 5.1: solution

a) We will load the images into a tuple, where the index of the tuple corresponds to the frame number. Under normal circumstances, we would do data validation to make sure there are no skipped frames, but in the interest of brevity, we will proceed assuming all data are properly labeled and organized.

In [2]:
# Use a list comprehension to read in the images
ims = [skimage.io.imread(fname)
           for fname in sorted(glob.glob('data/bacterial_growth/bacillus_*.tif'))]

# Store it as a tuple so we don't mess with it
ims = tuple(ims)

# How many?
print('There are', len(ims), 'images.')
There are 55 images.

Let's take a quick look at a few of the images. We'll look at frames 0, 15, 30, and 45. For now, we will not worry about setting the scales of the axes.

In [3]:
plots = [bootcamp_utils.bokeh_imshow(ims[i]) for i in [0, 15, 30, 45]]
bokeh.io.show(bokeh.layouts.gridplot(plots, ncols=2))

b) We will take a similar approach as in Lesson 38 to segment the image. We will simply threshold the image using Otsu's method.

In [4]:
# Threshold each image
ims_bw = [im > skimage.filters.threshold_otsu(im) for im in ims]

plots = [bootcamp_utils.bokeh_imshow(ims_bw[i]) for i in [0, 15, 30, 45]]
bokeh.io.show(bokeh.layouts.gridplot(plots, ncols=2))

This is pretty good. Certainly good enough for generating a growth curve.

c) We will overlay the segmentation on image 40. We'll use the cyan channel. In looking at the README file associated with the images, the interpixel distance is 64.5 nm.

In [5]:
def display_overlay(im, im_bw):
    """Create RGB image with cyan channel saturated via segmentation mask."""
    # Make float and normalized image
    im = np.copy(im).astype(float)

    # Build RGB image by stacking grayscale images
    im_rgb = np.dstack(3 * [im / im.max()])

    # Saturate cyan channel wherever there are white pixels in thresh image
    im_rgb[im_bw, 0] = 1.0

    return im_rgb

# Show the result
im_rgb = display_overlay(ims[40], ims_bw[40])
p = bootcamp_utils.bokeh_imshow(im_rgb, interpixel_distance=0.0645, length_units='µm')
bokeh.io.show(p)

The segmentation overshoots the bacteria. We might want to try to refine this a bit. We could do adaptive thresholding. We perform automatic thresholding on subimages throughout the image. We will take subimages to be 51 $\times$ 51, since that would span the width of one bacterium, and then some, thereby avoiding the issue of thresholding within a single bacterium (and adaptive thresholding needs an odd image block size). Adaptive thresholding is achieved using skimage.filters.threshold_local(). Let's give it a shot.

In [6]:
# List of thresholded images
ims_bw = [im > skimage.filters.threshold_local(im, 51) for im in ims]

# Show the result
im_rgb = display_overlay(ims[40], ims_bw[40])
p = bootcamp_utils.bokeh_imshow(im_rgb, interpixel_distance=0.0645, length_units='µm')
bokeh.io.show(p)

Whoa! It did a great job with the bacteria, but the background got really messed up. We could include pixels that are unity in both the adaptive and Otsu thresholding to take care of this. We then use np.logical_and() to do an element-by-element AND operation on the arrays.

In [7]:
def thresh(im, block_size=51):
    """Combined adaptive and Otsu thresholding."""
    thresh_otsu = skimage.filters.threshold_otsu(im)
    im_bw = im > thresh_otsu
    return np.logical_and(im > skimage.filters.threshold_local(im, block_size), im_bw)

# Threshold images
ims_bw = [thresh(im) for im in ims]

# Show the result
im_rgb = display_overlay(ims[40], ims_bw[40])
p = bootcamp_utils.bokeh_imshow(im_rgb, interpixel_distance=0.0645, length_units='µm')
bokeh.io.show(p)

Very nice!

d) To plot the growth curve, we can plot the total bacterial area on the $y$-axis (on a log scale), versus time on the $x$-axis. To get the total area, we need to compute the total number of "bacterial" pixels in a given image, multiplied by the pixel area, which is $(64.5\text{ nm})^2 = 4160.25\text{ nm}^2$. Also, according to the metadata, we have one frame every 15 minutes.

In [8]:
# Compute pixel area
pixel_area = 0.0645**2

# Get total bacterial area
bac_area = pixel_area * np.array([np.sum(im_bw) for im_bw in ims_bw])
   
# Get time in units of hours
t = 0.25 * np.arange(len(ims_bw))

# Make a DataFrame with the results
df = pd.DataFrame({'time (hours)': t, 'bacterial area (µm²)': bac_area})

dots = alt.Chart(df
    ).mark_point(
    ).encode(
        x='time (hours):Q',
        y=alt.Y('bacterial area (µm²):Q', scale=alt.Scale(type='log'))
    )

dots
Out[8]:

This looks pretty linear, suggesting that the bacteria are, indeed, performing exponential growth.

e) To perform the regression on the growth curve, we use np.polyfit() with the x values being time, and the y values being the natural log of the bacterial area. We fit with a first order polynomial, which is a line.

In [9]:
# Use polyfit to get slope and intercept
slope, intercept = np.polyfit(t, np.log(bac_area), 1)

# Pull out and print parameters
print("""
m0 = {0:.2f} sq. µm
 r = {1:.2f} 1/hours
""".format(np.exp(intercept), slope))

# Generate smooth curve
t_smooth = np.linspace(0, t.max(), 200)
y_smooth = np.exp(intercept + slope * t_smooth)

# Make a DataFrame to plot the smooth curve
df_line = pd.DataFrame({'time (hours)': t_smooth, 'bacterial area (µm²)': y_smooth})
line = alt.Chart(df_line
    ).mark_line(
        size=2,
        color='orange'
    ).encode(
        x='time (hours):Q',
        y=alt.Y('bacterial area (µm²):Q', scale=alt.Scale(type='log'))
    )

line + dots
m0 = 4.96 sq. µm
 r = 0.23 1/hours

Out[9]:

There is some systematic error, it appears, with the data being consistently above the curve at short times and then below for intermediate times. This could be due to thresholding, or due to small changes in conditions over time.

f) To compute the confidence interval of the growth rate, we will use the bootstrapping technique we did for linear regression in lesson 35.

In [10]:
def draw_bs_pairs_linreg(x, y, size=1):
    """Perform pairs bootstrap for linear regression."""
    # Set up array of indices to sample from
    inds = np.arange(len(x))

    # Initialize samples
    bs_slope_reps = np.empty(size)
    bs_intercept_reps = np.empty(size)

    # Take samples
    for i in range(size):
        bs_inds = np.random.choice(inds, len(inds))
        bs_x, bs_y = x[bs_inds], y[bs_inds]
        bs_slope_reps[i], bs_intercept_reps[i] = np.polyfit(bs_x, bs_y, deg=1)

    return bs_slope_reps, bs_intercept_reps

# DRaw replicates
bs_slope_reps, bs_intercept_reps = draw_bs_pairs_linreg(t,
                                                        np.log(bac_area),
                                                        size=10000)

print('growth rate confidence interval: [{0:.4f}, {1:.4f}]'.format(
      *np.percentile(bs_slope_reps, [2.5, 97.5])), 
      '1/hours')
growth rate confidence interval: [0.2267, 0.2337] 1/hours

We have pretty tight bounds on the growth rate. We can also make a plot with the confidence interval. We will do this one one linear axes.

In [11]:
# x-values
x = np.linspace(0, 14, 200)

# y-values of each point
y = np.exp(np.outer(bs_slope_reps, x) + np.stack([bs_intercept_reps]*200, axis=1))

# Compute the 2.5th and 97.5th percentiles
low, high = np.percentile(y, [2.5, 97.5], axis=0)

# Store results in data frame
df_conf = pd.DataFrame({'x': x, 'high': high, 'low': low})

# Make plot with linear axis for overlay
dots = alt.Chart(df
    ).mark_point(
    ).encode(
        x='time (hours):Q',
        y='bacterial area (µm²):Q'
    )

line = alt.Chart(df_line
    ).mark_line(
        size=2,
        color='orange'
    ).encode(
        x='time (hours):Q',
        y=alt.Y('bacterial area (µm²):Q')
    )

conf = alt.Chart(df_conf
    ).mark_area(
        color='orange',
        opacity=0.3
    ).encode(
        x=alt.X('x:Q', title='time (hours)'),
        y=alt.Y('low:Q', title='bacterial area (µm²)'),
        y2=alt.Y2('high:Q')
    )


conf + line + dots
Out[11]:


Exercise 5.2: Filter, extract, rinse, repeat

So far we have seen that in a single (very clean) image, we can get somewhere around 20 - 30 well-separated cells in a single 100$\times$ magnification phase contrast image. However, if you wish to report a mean fluorescence intensity for a single strain, you would certainly want more cells to have a good degree of confidence. Using the principles you learned above, your job will be to report a mean fluorescence value for the HG105 E. coli strain using all of the images located in data/HG105_images/. To do this, you should do the following:

  1. Get a list of all of the image files in data/HG105_images/.
  2. Separate them by phase contrast (for segmentation) and FITC (for measurement).
  3. Iterate through each image file and perform segmentation and fluorescence intensity extraction for each cell. These values should be stored in a NumPy array or Pandas DataFrame.
  4. Plot an ECDF of all extracted fluorescence intensities and report a mean and standard deviation as well as the number of cells you successfully measured.
  5. Obtain 95% bootstrap confidence intervals for the mean and standard deviation of the fluorescence intensities.

As a reminder, the interpixel distance of these images is 0.0626 µm per pixel.

Exercise 5.2: solution

We already wrote cell segmentation functions in our image processing practice session. The call signature is

cell_segmenter(im, thresh='otsu', radius=20.0, image_mode='phase',
               area_bounds=(0, 1e7), ecc_bounds=(0, 1))

We will include that code here so it is available. In practive, you would have this code in a module that you would have installed on your machine.

In [12]:
def cell_segmenter(im, thresh='otsu', radius=20.0, image_mode='phase',
                   area_bounds=(0, 1e7), ecc_bounds=(0, 1)):
    """
    This function segments a given image via thresholding and returns
    a labeled segmentation mask.
    
    Parameters
    ----------
    im : 2d-array
        Image to be segmented. This may be of either float or integer
        data type.
    thresh : int, float, or 'otsu'
        Value used during thresholding operation. This can either be a value 
        (`int` or `float`) or 'otsu'. If 'otsu', the threshold value will be 
        determined automatically using Otsu's thresholding method.
    radius : float
        Radius for gaussian blur for background subtraction. Default value
        is 20.
    image_mode : 'phase' or 'fluorescence'
        Mode of microscopy used to capture the image. If 'phase', objects with 
        intensity values *lower* than the provided threshold will be selected. 
        If `fluorescence`, values *greater* than the provided threshold will be 
        selected. Default value is 'phase'.
    area_bounds : tuple of ints.
        Range of areas of acceptable objects. This should be provided in units 
        of square pixels.
    ecc_bounds : tuple of floats
        Range of eccentricity values of acceptable objects. These values should
        range between 0.0 and 1.0.
        
    Returns
    -------
    im_labeled : 2d-array, int
        Labeled segmentation mask.
    """
     
    # Apply a median filter to remove hot pixels.
    med_selem = skimage.morphology.square(3)
    im_filt = skimage.filters.median(im, selem=med_selem)

    # Perform gaussian subtraction
    im_sub = bg_subtract(im_filt, radius)
    
    # Determine the thresholding method.
    if thresh is 'otsu':
        thresh = skimage.filters.threshold_otsu(im_sub)

    # Determine the image mode and apply threshold.
    if image_mode is 'phase':
        im_thresh = im_sub < thresh
    elif image_mode is 'fluorescence':
        im_thresh = im_sub > thresh
    else:
        raise ValueError("image mode not recognized. Must be 'phase'"
                         + " or 'fluorescence'")

    # Label the objects.
    im_label = skimage.measure.label(im_thresh)

    # Apply the area and eccentricity bounds. 
    im_filt = area_ecc_filter(im_label, area_bounds, ecc_bounds)
    
    # Remove objects touching the border.
    im_border = skimage.segmentation.clear_border(im_filt, buffer_size=5)
    
    # Relabel the image.
    im_border = im_border > 0 
        
    return skimage.measure.label(im_border)


def bg_subtract(im, radius):
    """
    Subtracts a gaussian blurred image from itself smoothing uneven 
    illumination.
    
    Parameters
    ----------
    im : 2d-array
        Image to be subtracted
    radius : int or float
        Radius of gaussian blur
    
    Returns
    -------
    im_sub : 2d-array, float
        Background subtracted image.
    """
    
    # Apply the gaussian filter.
    im_filt = skimage.filters.gaussian(im, radius)
    
    # Ensure the original image is a float
    if np.max(im) > 1.0:
        im = skimage.img_as_float(im)

    return  im - im_filt


def area_ecc_filter(im, area_bounds, ecc_bounds):
    """
    Filters objects in an image based on their areas.
    
    Parameters
    ----------
    im : 2d-array, int
        Labeled segmentation mask to be filtered. 
    area_bounds : tuple of ints
        Range of areas in which acceptable objects exist. This should be 
        provided in units of square pixels.
    ecc_bounds : tuple of floats 
        Range of eccentricities in which acceptable objects exist. This should be 
        provided on the range of 0 to 1.0.
        
    Returns
    -------
    im_relab : 2d-array, int
        The relabeled, filtered image.
    """
    
    # Extract the region props of the objects. 
    props = skimage.measure.regionprops(im)
    
    # Extract the areas and labels.
    areas = np.array([prop.area for prop in props])
    eccs = np.array([prop.eccentricity for prop in props])
    labels = np.array([prop.label for prop in props])

    # Make an empty image to add the approved cells.
    im_approved = np.zeros_like(im)
    
    # Threshold the objects based on area and eccentricity
    for i, _ in enumerate(areas):
        if areas[i] > area_bounds[0] and areas[i] < area_bounds[1]\
            and eccs[i] > ecc_bounds[0] and eccs[i] < ecc_bounds[1]:
                im_approved += im==labels[i]

    # Relabel the image.
    return skimage.measure.label(im_approved > 0)

Now we need to figure out some way in which we can iterate over all of our images in data/HG105_images. We have a few options here. First, and this is the worst solution, we could type out the name of each individual file and load them individually. The other option (a better option) is to make our computer get the list of all files in a single (or a few) lines of code. To do this, we will use the glob module. glob has a bunch of methods for obtaining filenames from directories. The most useful method of glob is glob which will return a list of paths that match a given pattern. Let's see how well it works for our needs.

In [13]:
# Glob the phase and fluo globs. 
phase_glob = list(sorted(glob.glob('data/HG105_images/*phase*.tif')))
fluo_glob = list(sorted(glob.glob('data/HG105_images/*FITC*.tif')))

# Take a look.
print(phase_glob)
print(fluo_glob)
['data/HG105_images/noLac_phase_0000.tif', 'data/HG105_images/noLac_phase_0001.tif', 'data/HG105_images/noLac_phase_0002.tif', 'data/HG105_images/noLac_phase_0003.tif', 'data/HG105_images/noLac_phase_0004.tif', 'data/HG105_images/noLac_phase_0005.tif', 'data/HG105_images/noLac_phase_0006.tif', 'data/HG105_images/noLac_phase_0007.tif', 'data/HG105_images/noLac_phase_0008.tif']
['data/HG105_images/noLac_FITC_0000.tif', 'data/HG105_images/noLac_FITC_0001.tif', 'data/HG105_images/noLac_FITC_0002.tif', 'data/HG105_images/noLac_FITC_0003.tif', 'data/HG105_images/noLac_FITC_0004.tif', 'data/HG105_images/noLac_FITC_0005.tif', 'data/HG105_images/noLac_FITC_0006.tif', 'data/HG105_images/noLac_FITC_0007.tif', 'data/HG105_images/noLac_FITC_0008.tif']

Well, that was easy. We used the wildcard character (*) to find all files that had the pattern anything then the strings phase or FITC followed by anything so long that it had a .tif extension. The output is a little bit different as well in that it not only returned the name of the file in the specified data_dir, but it gave us the entire relative path. This is an important distinction and is actually one of the reasons I frequently use glob.glob.

Now that we have a list of files, we should iterate over each phase image, perform the segmentation, then extract the mean pixel intensities of each object and store them in a list.

In [14]:
# Instantiate an empty list for the mean pixel intensity of each cell.
integrated_ints = []

# Do the same for the areas.
areas = []

# Image index
image_numbers = []

# Define our area and eccentricity bounds for the segmentation function.
ip_dist = 0.0626  # in units of µm per pixel
area_bounds = (0.5/ip_dist**2, 4/ip_dist**2)
ecc_bounds = (0.8, 1.0)

# Loop through all images.
for i, pf in enumerate(zip(phase_glob, fluo_glob)):
    p, f = pf
    # Load the phase image.
    phase_im = skimage.io.imread(p)
    
    # Perform the segmentation.
    phase_seg = cell_segmenter(phase_im, 
                               image_mode='phase', 
                               area_bounds=area_bounds, 
                               ecc_bounds=ecc_bounds)
    
    # Load the fluorescence image. 
    fluo_im = skimage.io.imread(f)
    
    # Compute the region properties.
    props = skimage.measure.regionprops(phase_seg, intensity_image=fluo_im)
    
    # Add them to our storage lists. 
    for prop in props:
        integrated_ints.append(prop.mean_intensity * prop.area)
        areas.append(prop.area * ip_dist**2)
        image_numbers.append(i)

# Units don't matter, so normalize integrated intensity
integrated_ints = np.array(integrated_ints)
integrated_ints /= integrated_ints.max()

# Store results in data frame
df = pd.DataFrame({'integrated intensity': integrated_ints/max(integrated_ints),
                   'area': areas,
                   'image number': image_numbers})
/Users/Justin/anaconda3/lib/python3.6/site-packages/skimage/filters/rank/generic.py:102: UserWarning: Bitdepth of 11 may result in bad rank filter performance due to large number of bins.
  "performance due to large number of bins." % bitdepth)

So, in just a few seconds, were were able to do what would take hours (if not a full day) to do in ImageJ by clicking. To make sure things are working as expected, let's take a look at the last segmentation mask generated. Remember that the array phase_seg is the labeled image, so to get the binary image, we use phase_seg > 0.

In [15]:
im_rgb = display_overlay(phase_im, phase_seg > 0)
p = bootcamp_utils.bokeh_imshow(im_rgb, interpixel_distance=ip_dist, length_units='µm')
bokeh.io.show(p)

That looks pretty great to me, let's see how many cells we were actually able to measure.

In [16]:
# Print the total number of cells. 
print("Segmented and analyzed {num} cells!".format(num=len(df)))
Segmented and analyzed 92 cells!

Analyzing 92 cells in only 8 images in about 8 seconds is actually pretty good! That's certainly enough to do some serious boot strapping. Let's look at the ECDFs of the mean intensities and the areas.

In [17]:
# Add ECDF to the DataFrame
df['ECDF intensity'] = df['integrated intensity'].transform(bootcamp_utils.ecdf_y)
df['ECDF area'] = df['area'].transform(bootcamp_utils.ecdf_y)

# Make ECDFs
int_plot = alt.Chart(df,
        height=250,
        width=300
    ).mark_point(
    ).encode(
        x=alt.X('integrated intensity:Q',
                title='integrated intensity (a.u.)', 
                scale=alt.Scale(zero=False)),
        y=alt.Y('ECDF intensity:Q', title='ECDF')
    )

area_plot = alt.Chart(df,
        height=250,
        width=300
    ).mark_point(
    ).encode(
        x=alt.X('area:Q',
                title='area (µm²)', 
                scale=alt.Scale(zero=False)),
        y=alt.Y('ECDF area:Q', title='ECDF')
    )


int_plot | area_plot
Out[17]:

The mean and standard deviation of the integrated intensities (in arbitrary units) are directly computed.

In [18]:
df['integrated intensity'].agg(['mean', 'std'])
Out[18]:
mean    0.296901
std     0.147177
Name: integrated intensity, dtype: float64

Let's go ahead and perform 100,000 in silico replicates of this experiment to get a confidence interval on our mean and stadnard deviation of the integrated fluorescence intensities.

In [19]:
def draw_bs_reps(data, func, size=1):
    """Draw bootstrap replicates"""
    return np.array([func(np.random.choice(data, size=len(data))) for _ in range(size)])

# Draw bootstrap replicates of mean
bs_reps_mean = draw_bs_reps(integrated_ints, func=np.mean, size=100000)

# Draw bootstrap replicates of standard deviation
bs_reps_std = draw_bs_reps(integrated_ints, func=np.std, size=100000)

# Compute the 97.5% and 2.5% percentiles.
percs_mean = np.percentile(bs_reps_mean, [2.5, 97.5])
percs_std = np.percentile(bs_reps_std, [2.5, 97.5])

print('95% of our bootstrapped means lie between {0:.2f} and {1:.2f}.'.format(
                        percs_mean[0], percs_mean[1]))
print('95% of our bootstrapped st. devs. lie between {0:.2f} and {1:.2f}.'.format(
                        percs_std[0], percs_std[1]))
95% of our bootstrapped means lie between 0.27 and 0.33.
95% of our bootstrapped st. devs. lie between 0.09 and 0.19.