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.