Uploading Data¶
From the dashboard, choose Upload single drug or Upload drug-drug matrix. Each is one screen: fill it in from top to bottom and click Save. synfit then opens the new dataset, where you can inspect the data and start a fit.
Instead of a file you can pick Inject a sample… to load one of the built-in example datasets.
Single drug¶
- Dataset name: a label for the dashboard, e.g. "Compound X in HeLa, Jan 2026".
- CSV file: one CSV, TSV or TXT file (max 10 MB) in tidy or wide layout. The ? icon next to the field summarises both.
- Preview: as soon as the file is read, a scatter plot of response vs concentration appears (tick log for a log concentration axis), one colour per replicate. Check it before saving: a flat cloud or a curve running the wrong way usually means a column was picked up wrongly.
- Drug: the drug name, the concentration unit (nM, µM or mM) and the direction: inhibition (response falls with dose, reported as IC₅₀) or activation (response rises, reported as EC₅₀). synfit suggests the direction from the trend in your data; change it if the suggestion is wrong.
- Save.
How columns are detected¶
There is no manual column-mapping step. synfit reads the header row and decides:
- Wide layout when every column after the first is numeric: the first column is concentration, each further column one replicate.
- Tidy layout when the file has at least three columns and the last one contains text (replicate labels). The concentration column is the one named
concentration,concordose; the response columnyor a name starting withresponse,viability,effect,inhibit…oractiv…; the replicate columnreplicate,rep,plate,wellorgroup. Unmatched names fall back to the first, second and third column.
If neither rule fits, the upload shows an error describing the expected layout. Renaming the header row is the quickest fix.
Drug-drug matrix¶
- Dataset name.
- Replicate CSV files: one or more files, one per replicate, each a headerless numeric grid (format). The first file sets the matrix size; the concentration lists below resize to match.
- Horizontal drug (columns) and Vertical drug (rows), each with:
- Name, Direction (inhibition or activation) and Unit. Synergy scores are only defined when both drugs act in the same direction.
- Concentrations: one value per column (horizontal) or row (vertical), in the order they appear in the file. Use My concentrations follow a regular serial dilution to fill them from a start concentration and a fold factor, optionally with a zero-dose control. The generator becomes available once the files are uploaded.
- A heatmap preview shows the response grid; all replicates share one colour scale so an odd plate stands out.
- Save.
Include a zero-dose row and column: they hold the single-drug curves that every synergy model compares against. See drug synergy analysis.
Tips¶
Remembered drug details
On the in-app upload screens, your browser stores the last drug name(s), concentration units, and (for matrix uploads) inhibitor vs activator type you entered. This uses local storage on your device only — not the synfit server. Dataset names, CSV files, and concentration grids are not stored. Clearing site data for synfit removes these drafts.
Naming conventions
Use descriptive dataset names — they appear on the dashboard and in analysis listings. Include the compound name and date if you run repeated experiments.
Concentration units
Pick the unit that matches your raw data. synfit stores and displays concentrations in whichever unit you choose — it does not convert between units.