Skip to content

The CD database

PlatAnJr carries a database of cells and their CD markers: every CD molecule with its other names, the cells of the immune system, the level at which each cell expresses each marker, a picture of each cell, and the cells' lineage. Two parts of the application read it:

  • the Unmixer, which finds the marker in a control's file name by any of its names and puts it in the control's Analyte - see Naming the controls;
  • the Phenotyping node, which looks each parameter up as a marker and names the cells each phenotype could be.

The database is the file CDDB.dat in C:\Users\Public\Documents\CDDB, which the installer puts there and PlatAnJr loads at start.

What it holds

Cells
Each with a short name and a full name, a picture, and its place in the lineage.
CD markers
Each with its CD number, its NCBI name and its other names - the names it is searched by - and the workshop and year that named it, which are not names.
Levels
The level of each marker on each cell: -, +, ++, +++, the mixed -/+, -/++, -/+++, +/-, ++/-, +++/- for a cell some of which express it, and ? for a level not known. An unknown level rules a cell neither in nor out when the phenotyping node matches it.

The database shipped with PlatAnJr 2.37 gives the blood cells levels measured in the PBMC CITE-seq reference of Hao et al. (Cell, 2021), where the antibody was strong enough to tell positive from negative, and describes the cells a blood panel tells apart - naive and memory T and B cells, monocyte and dendritic-cell subsets among them.

The editor

Click CD database on the toolbar. The window shows the database PlatAnJr loaded:

Area Shows
Cells Every cell, with its full name. Above it, Find a cell
The cell's markers The markers of the cell selected, with their Level
CD markers Every marker: CD number, NCBI name, other names, workshop and year. Above it, Find a CD marker
The marker's cells The cells expressing the marker selected, with their level
Picture The selected cell's picture
Lineage The cells as a diagram, each linked to the cells it gives rise to

Finding

The two search boxes suggest the rows any of whose names holds what you type - the name itself first, then names that start with it, then names that hold it, then rows found by another of their names, shown in brackets. Picking a suggestion selects and shows its row. A letter typed in a table goes to that table's box; Ctrl+F jumps to the box of the table used last.

Editing

Edit a cell of a table with F2, Enter or a double-click. The toolbar's actions:

Action Keys Effect
Open... Ctrl+O Open another database file
Save Ctrl+S Save the database
Save As... Ctrl+Shift+S Save it to another file
New Cell / Delete Cell Shift+Ins / Shift+Del Insert a cell before the selected one, or delete the selected one
New CD / Delete CD Ctrl+Ins / Ctrl+Del The same for CD markers
Move Up / Move Down Alt+Up / Alt+Down Move the selected cell or marker
Add Marker Ctrl+Alt+A Add the selected marker to the selected cell - or drag the marker onto a cell
Delete Marker Ctrl+Alt+D Remove the selected marker from the cell
Picture... Ctrl+R Load a picture of the cell
Import... Rebuild the whole database from the CSV files in a folder (cells, markers, intracellular antigens)
Export Matrix A CSV table of the level of every marker in every cell
Export Synonyms A CSV table of the CD markers and their other names
CSV Table... Show a CSV file in a table
Arrange Lay the lineage out anew - see below
Find Ctrl+F Search the cells or the CD markers, whichever table was used last

A marker's level on a cell is picked in the Level column.

The lineage

The diagram draws each cell with links to the cells it gives rise to, as curves like the links of the gating graph. Drag a cell to move it.

Arrange lays the whole lineage out again: a column for each generation, left to right, the cells of each column ordered so that as few links as possible cross, and placed so that the links are as short and as level as they can be. The new places are kept like places set by hand, and Save stores them.

Saving

Changes stay in memory until you Save. Closing the editor, or PlatAnJr, with changes not saved asks about them; No reads the file again, dropping the changes.

The editor works on the database PlatAnJr has loaded, so the rest of the application sees an edit at once; one that is not saved is gone at the next start.

Keep a copy before a big edit

Import rebuilds the whole database and Save writes over CDDB.dat. Copy the file aside first - and keep your own copy of an edited database, because installing PlatAnJr again puts the shipped CDDB.dat in its place.