# Applying k-means clustering to flow cytometry analysis

Is it possible for a machine to group together similar data on its own? Absolutely—this is what clustering algorithms are all about. These algorithms fall under a branch of machine learning called **unsupervised learning**. In this branch, we give a machine an *unlabeled* training set containing data regarding the features but not the classes. Algorithms are left to their own devices to discover the underlying structure concealed within the data. This is in stark contrast to supervised learning, where the correct answers are available and utilized to train a predictive model.

In this post, I'd like to introduce an algorithm called **$k$-means clustering** and also construct one from scratch. Additionally, I'll demonstrate how this algorithm can be used automate an aspect of a widely used life sciences technique called **flow cytometry**.

## Table of contents¶

- Inspecting the data
- Overview of $k$-means clustering
- Selecting the initial centroids
- Assigning each training example to a cluster
- Computing the updated centroids
- Minimizing the distortion function
- Training the clustering algorithm
- Implications and conclusions

## 1. Inspecting the data¶

Let's start by taking a look at the training set and its features.

```
features = pd.read_csv('data/immune_cells.csv')
features.head()
```

```
features.describe()
```

It looks like we have 3608 training examples—each one is an individual immune cell. These cells are primarily responsible for fighting bacteria, viruses, fungi and cancer. We also have two features: `FSC`

and `SSC`

. To better understand what these features entail, here's a brief introduction to flow cytometry.

### A crash course in flow cytometry¶

Flow cytometry is a technique for measuring the distribution of specific cell types within a heterogenous pool of cells based on their structural properties and an unique array of biomarkers. The first step is to separate cells from each other using hydrodynamic focusing, ensuring a "single file line" of sorts. Next, each cell is individually interrogated by lasers of concrete wavelengths, resulting in the scattering of light and fluorescence, which is subsequently detected by photomultipliers. Flow cytometry analyses are typically performed on thousands or millions of cells, providing a plethora of training examples and being highly conducive for machine learning.

One measure of light scattering is called **forward scatter** (FSC)—its magnitude is proportional to the cell's volume. Another measure is called **side scatter** (SSC), which is proportional to the cell's structural complexity. Life scientists can classify certain cell types using these features alone, even without peeking into the biomarker signature.

Immune cells are a popular candidate for flow cytometry analysis due to their myriad subsets. The broadest subsets are lymphocytes, monocytes and granulocytes, which are readily recognized by their FSC and SSC profiles. Life scientists can easily pick out these immune cell subsets using their extensive domain knowledge and past experience. The goal for today, however, is to ** train a machine to identify the major immune cell clusters on its own using only FSC and SSC data.**

We'll be plotting the training set often so let's start by building a function that displays the data and any assigned clusters.

```
def plot_data(X, cluster_label):
return sns.lmplot(
data=X,
x=X.columns[0],
y=X.columns[1],
hue=cluster_label,
fit_reg=False,
legend=False,
aspect=1.25,
palette='Set2'
)
```

Since we don't know the structure of the data yet, we need to set `cluster_label`

to `None`

when we plot the training set.

```
plot_data(features, None);
```

How many clusters do you see? Keep them in mind for now.

Two quick notes before we proceed: first, these data are hypothetical but are representative of the FSC and SSC profile of immune cells from human blood. Second, let's normalize the data so the displayed numbers in later computations don't have a ridiculous number of digits.

```
features = (features - features.mean()) / features.std(ddof=0)
```

## 2. Overview of $k$-means clustering¶

The goal of this algorithm is to *automatically* group together similar training examples into clusters. First, we must choose a hyperparameter $k$ that specifies the number of clusters to detect. If we have context or prior knowledge about the data, we can pick the value of $k$ ourselves. Most of the time, however, the value of $k$ is ambiguous; in fact, we could dedicate an entire post to strategies for determining $k$. Because we already know the major immune cell subsets are lymphocytes, monocytes and granulocytes, we can set $k = 4$ (the one extra accounts for dead cells and debris—these have a similar light scatter profile).

```
k = 4
```

Here's how the $k$-means clustering algorithm works:

- Select an initial guess for the geometric center of each cluster, called a
**centroid** - Assign each training example to a cluster by determining the nearest centroid
- Compute new centroids using the mean position of all training examples assigned to each cluster
- Repeat steps 2 and 3 until the new centroids barely differ in position from the previous centroids, i.e., the algorithm has converged to a set of centroids

These steps may seem convoluted at first but as we go through them, we'll soon find that this algorithm is quite intuitive.

## 3. Selecting the initial centroids¶

One way to guess the initial centroids is to pick $k$ random points. However, this runs the risk of picking centroids that aren't anywhere near the training set, which may delay convergence. A better idea is to randomly choose $k$ training examples as the initial centroids. Actually, there are more optimal options, but initialization strategies are a separate topic altogether. For our purposes, initializing centroids by randomly selecting $k$ training examples should be sufficient.

```
def initialize_centroids(X, k):
init_centroids = X.sample(n=k)
init_centroids.index = np.arange(1, k + 1)
return init_centroids
```

```
centroids = initialize_centroids(features, k)
centroids
```

Let's also define a function to plot the centroids over each iteration of the algorithm.

```
def plot_centroids(figure, U):
figure.ax.scatter(
x=U['FSC'],
y=U['SSC'],
color='red',
marker='x'
)
```

Let's see where the initial centroids lie within the training set. Again, since we haven't assigned any training examples to clusters yet, we have to set `cluster_label`

to `None`

when calling `plot_data()`

.

```
dot_plot = plot_data(features, None)
plot_centroids(dot_plot, centroids)
```

## 4. Assigning each training example to a cluster¶

The next step is to assign every training example to one of the $k$ clusters. Because the centroid is the geometric center of a cluster, we perform this assignment by determining the centroid nearest to each training example, as measured by the square of the Euclidean distance.

Specifically, for each training example $x^{(i)}$, we assign $c^{(i)} := j$ that minimizes $\lVert x^{(i)} - u_j \rVert ^2$ where $c^{(i)}$ is the label of the cluster whose centroid is nearest to $x^{(i)}$ and where $u_j$ is the position of the centroid for the $j$th cluster and $1 \leq j \leq k$. Let's build a function that performs this step.

```
def assign_clusters(X, U):
m = len(X)
C = pd.DataFrame(np.empty(m), columns=['label'])
for (i, example) in X.iterrows():
distance = (example - U).apply(np.linalg.norm, axis=1)
C.loc[i] = (distance ** 2).idxmin()
return C
```

Let's assign training examples to clusters and then see what the clusters look like.

```
labels = assign_clusters(features, centroids)
dot_plot = plot_data(pd.concat((features, labels), axis=1), 'label')
plot_centroids(dot_plot, centroids)
```

Nothing exciting so far, but we're just getting started.

## 5. Computing the updated centroids¶

Having assigned every training example to a cluster, each cluster must therefore have a new centroid. To determine the positions of these new centroids, we compute the mean of all training examples assigned to each cluster, feature by feature.

Specifically, for each cluster $j$, we assign a new position for its centroid as given by

$$u_j := \frac{1}{\lvert c_j \rvert}\sum_{i \in c_j}x^{(i)}$$where $c_j$ is the set of training examples assigned to cluster $j$. Let's build a function that performs this step.

```
def update_centroids(X, C):
joined = pd.concat((X, C), axis=1)
return joined.groupby('label').mean()
```

Let's update the centroids and then take a look at their new positions.

```
centroids = update_centroids(features, labels)
dot_plot = plot_data(pd.concat((features, labels), axis=1), 'label')
plot_centroids(dot_plot, centroids)
```

The centroids are on the move but this is only the first iteration—we still have ways to go. However, we don't have any way to determine whether the algorithm has converged to a set of centroids.

## 6. Minimizing the distortion function¶

We can measure how tightly clustered the data are using the sum of the squared Euclidean distance between each training example and the centroid of its currently assigned cluster. This metric is called the **distortion function** and is given by

where $m$ is the total number of training examples. The tighter the clustering, the smaller the value of $J$. In fact, $J$ converging to a minimum is a good indicator that the algorithm has converged to a set of centroids. **Therefore, the goal of the $k$-means clustering algorithm is to minimize the distortion function.**

```
def distortion_function(X, U, C):
return sum(np.linalg.norm(example - U.loc[C.loc[i]]) ** 2
for (i, example) in X.iterrows())
```

## 7. Training the clustering algorithm¶

We're now prepped to train the algorithm and learn the structure of the training set. Let's start with a fresh set of initial centroids, and repeat the cluster assignment and centroid update steps for 5 iterations.

```
iterations = 5
centroids = initialize_centroids(features, k)
distortion_history = np.empty(iterations)
for i in range(iterations):
labels = assign_clusters(features, centroids)
centroids = update_centroids(features, labels)
distortion_history[i] = distortion_function(features, centroids, labels)
```

We've now learned the clusters in the training set so let's see what they look like.

```
dot_plot = plot_data(pd.concat((features, labels), axis=1), 'label')
plot_centroids(dot_plot, centroids)
```

Does the clustering match with what you had in mind? It looks pretty off to me. Let's inspect the distortion function at each iteration to determine if the algorithm converged to a set of centroids.

```
sns.factorplot(
x='Iteration',
y='Distortion',
data=pd.DataFrame(
{'Iteration': range(iterations), 'Distortion': distortion_history}
),
fit_reg=False,
size=5
);
```

It looks like the distortion function is still decreasing—the algorithm has yet to converge, which explains the suboptimal clustering. We could try retraining the algorithm with additional iterations; however, perhaps the choice of initial centroids was subpar to begin with.

### How to avoid local minima for the distortion function¶

It turns out the distortion function is non-convex; that is, depending on the choice of initial centroids, the algorithm may get stuck in a local minimum and yield suboptimal clustering. One way to avoid this issue altogether is to train the algorithm several times using a new choice of initial centroids each time. Afterwards, we choose the clustering that yields the lowest distortion.

```
lowest_distortion = 10 ** 10
for _ in range(10):
centroids = initialize_centroids(features, k)
for _ in range(iterations):
labels = assign_clusters(features, centroids)
centroids = update_centroids(features, labels)
curr_distortion = distortion_function(features, centroids, labels)
if curr_distortion < lowest_distortion:
lowest_distortion = curr_distortion
opt_labels = labels
opt_centroids = centroids
```

Let's take a look at the distortion function of the optimal clustering and then visualize the learned clusters.

```
distortion_function(features, opt_centroids, opt_labels)
```

```
dot_plot = plot_data(pd.concat((features, opt_labels), axis=1), 'label')
plot_centroids(dot_plot, opt_centroids)
```

What an improvement! In fact, as someone who has performed this grouping *manually* hundreds of times, I can attest that these clusters lie very close to the natural positions of the major immune cell subsets:

- Pink are dead cells or debris
- Violet are lymphocytes
- Orange are monocytes
- Green are granulocytes

Let's now compare our homemade algorithm to a highly optimized one from `sklearn`

.

```
from sklearn.cluster import KMeans
kmeans = KMeans(n_clusters=k).fit(features)
opt_labels2 = pd.DataFrame(kmeans.labels_, columns=['label'])
opt_centroids2 = pd.DataFrame(kmeans.cluster_centers_, columns=['FSC', 'SSC'])
dot_plot = plot_data(pd.concat((features, opt_labels2), axis=1), 'label')
plot_centroids(dot_plot, opt_centroids2);
```