See the Quick Start
The AutoPlate web interface consists of three simple steps. Once you have input your data in Step 1 you will need to click on Steps 2 (QC) or Step 3 (Results) to continue the analysis. It is possible to return to previous steps or skip ahead at any given point.
Upload your luminescence rawdata from the plate reader and specify any metadata required for dose-response curve analysis.
Select the type of assay which you wish to analyse data for, currently supported assays are pMN
and ELLA
Upload your luminescence files directly from the plate reader or try out the app using example data. Holding down Shift
or Ctrl
should allow you to select multiple plates.
Note: the uploaded files must correspond to the selected assay type
Luminescence files that contain the raw luminescence values for each well can be uploaded directly from the plate reader. CSV format is used for the pMN assay and Excel format for the ELLA assay. Users can also upload a previously exported CSV file generated from a later step in AutoPlate if they want to re-load a dataset that has already been analysed.
Description | CSV input from a plate reader used for the pMN assay |
Format | CSV |
Extension | .csv |
Example | example_data_pmn_plate_n1.csv |
Required columns |
WellPosition , RLU
|
Plate number | The end of the filename can be used to specify the filename eg 1.csv for plate 1. If numbers are not provided the filename will be used instead |
Number of files | One CSV file per plate. Multiple files can be uploaded |
Description | Excel input from a plate reader used for the ELLA assay |
Format | Excel |
Extension |
.xls , xlsx
|
Example | |
Required columns | |
Plate number | The end of the filename can be used to specify the filename eg 1.xls for plate 1. If numbers are not provided the filename will be used instead |
Number of files | One Excel file per plate. Multiple files can be uploaded |
Description | CSV input downloaded from AutoPlate on the QC page generated from one of the two previous input files |
Format | CSV |
Extension | .csv |
Example | example_data_pmn_platelist_H1N1.csv |
Required columns |
types , sample_id , dilution , bleed , virus , rlu , neutralisation , treatment , experiment_id , exclude , plate_number
|
Plate number | The plate number will be specified in the plate_number column |
Number of files | One CSV file which can correspond to multiple plates |
column_name | input_format | column_type | column_description |
---|---|---|---|
WellPosition | pMN | character | Position of well on the 96-plate. Consists of the row letter (A -H ) and column number (1 -12 ), seperated by a colon (: ), eg A:1
|
RLU | pMN | integer | Relative luminescence units raw value generated by the plate reader |
wrow | AutoPlate | character | Well row on the 96-well plate eg A
|
wcol | AutoPlate | integer | Well column on the 96-well plate eg 1
|
types | AutoPlate | character | The well types, available options are: c = cell only control, m = monoclonal antibody (posotive control), v = virus (or pseudotype) only control, x = serum sample |
sample_id | AutoPlate | character | Unique identifier for each sample/subject eg Sample 1
|
dilution | AutoPlate | integer | Concentration/dilution of serum or control sample (1:XX) |
virus | AutoPlate | character | Virus (or pseudovirus) that was used in the assay eg SARS-CoV-2
|
treatment | AutoPlate | character | Used to group the data for the dose-response curves, for example, what the subjects were inoculated with eg mAb1 or Vaccine 1
|
bleed | AutoPlate | character | Integer corresponding to the week the sample (eg mouse) was bled or terminal for the last bleed. Can be left blank for clinical samples |
experiment_id | AutoPlate | character | Unique identifier specifying which study generated the data eg COV001
|
rlu | AutoPlate | integer | Relative luminescence units raw value generated by the plate reader |
neutralisation | AutoPlate | numeric | The ability of the antibody to bind to the virus and block cell entry. Calculated from the rlu and normalised/expresed as a percentage using the median cell-only (100% neutralisation) and virus-only (0% neutralisation) wells for the plate |
exclude | AutoPlate | logical |
TRUE or FALSE value to exclude wells from the analysis. Wells could be excluded for any number of reasons but are most commonly excluded when the controls have failed or when wells were left empty on a particular plate. |
plate_number | AutoPlate | character | Unique 96-well plate name or number eg 1
|
filename | AutoPlate | character | File basename that is used to generate the plate number |
Both the serum and control concentration/dilutions can be specified by an interactive table, containing default values. The Serum concentrations/dilutions correspond to wells of type x
and the control concentrations/dilutions correspond to wells of type m
.
The pMN assay uses vertical dilutions so any updates made to the dilutions table will update all wells of the relevant type (x
or m
) which are on the same row eg A
The ELLA assay uses horizontal dilutions so any updates made to the dilutions table will update all wells of the relevant type (x
) which are on the same column eg 1
Alternatively, any custom modifications to the dilutions can be set in the plate data table and modifications for all plates can be easily set on the template tab
Data for any feature can be entered by selecting that feature from the dropdown menu and entering the data using the plate data table. The most important features to ensure that they are set correctly using the plate data table are the types
, sample_id
and dilution
.
All three of these features will have default values:
sample_id
- the sample IDs will automatically increment both across and between plates
dilution
- the default dilutions will be defined by the dilutions table. These can be modified either per plate or for all plates using the template tab
types
- will have a default plate layout (shown and described below). This can be updated for all plates using the template tab
Most wells are type x
(experimental); these are a known dilution of sample neutralising the virus of interest. Type m
indicates the positive control (m
was originally for monoclonal antibodies), these wells are treated the same as type x
but can be easily filtered or coloured differently and may be diluted differently. The final types are v
and c
which are used to convert virus marker measurements into neutralisation and normalise the data. Type c
contains cells only and represents 100% neutralisation because there is no virus to enter cells and express the marker. Type v
contains cells and virus-only but (no treatment) and represents 0% neutralisation because no virus neutralisation occurs.
It may also be useful to exclude
wells from the analysis, for example, if the controls have not worked. Wells can be excluded by selecting exclude from the dropdown menu and ticking any wells you wish to remove from the analysis.
There is also an option to show the raw RLU values for a given plate by clicking the toggle button above the plate data table.
Features such as the virus
, treatment
, bleed
and experiment_id
can be set by the plate date table. However, the values for these features will often be the same for many wells and so it may be time-consuming to specify them for each individual well. Therefore, in the “other features” section these features can be set based on any other existing feature.
For example, if I want to specify the treatment
that each sample was inoculated with you can select sample_id
from the dropdown menu. This will then display a table of all samples and you can specify the treatment (eg vaccine) used for each sample.
The default value in the dropdown menu is for each well
. Meaning that AutoPlate will update the selected tab (eg virus
) for all wells on all plates.
NOTE: Make sure you click Submit
once you have entered all the information for the selected feature
To help prevent you from forgetting to add information for these features, AutoPlate displays a table showing which features it has data for. In the following table no information has been entered for either the virus
, treatment
, bleed
or experiment_id
Visualise the data you entered in step 1 and check that the controls have worked for each plate/well
Note: If you notice any issues with the data at the QC step it is possible to return to step 1 to correct the data entered for any feature
The table displaying the average viral and cell luminescence can be used to check that there is a substantial difference in the average luminescence between virus-only and cell-only wells and that an adequate number of control wells have been included in the analysis
Heatmaps are generated for various key features (well types, sample ID, dilution, virus, RLU, neutralisation, treatment, bleed and experiment ID). For all these features a heatmap is used to show the value for each of these features for all plates in a 96-well plate format i.e., an 8 x 12 grid to check that the values have been entered correctly
A boxplot of all the different well types for each plate is generated. This plot can be used to check differences in control values between plates. It is important to check that the virus wells have approximately the highest luminescence and cell wells have the lowest because it is these wells that are used for the normalisation when calculating the neutralisation. In our experience, if the virus- only wells do not have the highest values on a plate, the dose-response curves estimated from that plate are shifted downwards, and this may underestimate the neutralising capacity of the sample sera.
A user can choose to exclude any wells from the analysis. To do this they can specify a string consisting of comma-separated values of either whole plates, individual wells or a range of wells. Wells can also be excluded from the plate data table in the input step. Wells could be excluded for any number of reasons but are most commonly excluded when the controls have failed or when wells were left empty on a particular plate. A heatmap is also generated to show which wells will be excluded from the analysis, allowing users to verify that the correct wells have been excluded from the analysis.
To exclude wells from the analysis you can enter any combination of the following separated by commas:
whole plates - by number, eg: 1,2,3
individual wells - by their plate number, row and column, eg: 1A1,1D6,3H12
range of wells - by their plate numbers, rows and columns, eg: 1A1:A12,2B6:H12
Users can export the formatted dataset containing all assay data as a CSV from AutoPlate (see an example of the format). This allows the data to be shared or analysed with different statistical software. This dataset can also be uploaded in step 1.2 of AutoPlate so that shared data can be analysed in AutoPlate or old data can be reanalysed.
Data can also be downloaded in CSV a format displaying the neutralisations such that it can easily be loading into and plotted in GraphPad PRISM
Fit dose-response curves to analyse the data entered in previous steps, calculate the IC50 values and generate plots to visualise the results.
Four plots are generated on the results page. Each of the interactive plots can be viewed, downloaded (in SVG or PNG format), reproduced in R using the displayed code and customised with various options such as the plot text size.
The data exploration plot fits a loess smooth to each treatment group to illustrate the dose-response relationship of treatment groups outside of the dose-response curve model
By measuring neutralisation along a dilution series, a dose-response curve (DRC) can be estimated for a given antibody/sera. When this dilution is displayed on a log scale the curve follows a classic S shape which is well represented by the 4-parameter log-logistic regression curve (the default for AutoPlate).
The dose-response model (DRM) will be fit to the treatments for each of the viruses independently. The DRC(s) for each virus can be displayed by selecting the virus from the dropdown menu.
Neutralisation potency is usually reported as the IC50 of a dose-response curve. To simplify visual comparison of treatments a boxplot of just the IC50 values of each curve is displayed.
The dose-response model (DRM) will be fit to the treatments for each of the viruses independently. The IC50 boxplots for each virus can be displayed by selecting the virus from the dropdown menu.
There is also an option to toggle the boxplot between a scatter plot and boxplot. The scatter plot option may be useful to see the underlying data points when there are very few samples.
The virus-cell boxplot can be used to check that the controls have worked as expected. There should be a clear separation between the virus and cell groups and little variation between plates.
All the information displayed within AutoPlate, such as the quality control and results plots can be downloaded as a shareable HTML report file. As well as including all the plots generated in AutoPlate, it also contains the specific code and R package versions needed to reproduce them.
The dose-response model (DRM) is the model that is fit to your data for each virus in order to generate the dose-response curve(s) and IC50 boxplot(s). The model is defined and fit using the R package drc. Defining the model allows a great deal of flexibility as the equation, model type, which parameters are shared between treatment groups and any upper/lower limits for the parameters can all be modified.
By default, for the dose-response model, the dose is the dilution
, and the neutralisation
is the response, the sample IDs are used to group the data. The model used is the four-parameter log-logistic function (or LL2.4) which can be denoted by the expression below, where b is the slope around the IC50, c is the curve minimum, d is the curve maximum and e is the log IC50 value. This model was chosen as the default option because we found that models more readily converge when estimating log(IC50) than IC50 itself. By default, a single curve minimum, curve maximum, and gradient is estimated for the whole population to improve comparisons between samples. The upper limit of the curve maximum is set to 100 and the lower limit for the gradient around the IC50 and the IC50 value are set to zero to prevent a negative gradient or IC50 value.
\[ f(x)=c+\frac {d - c}{1 + exp(b(log(x) - e))} \]
If you wish to customise the DRM, read more here