IEDB Analysis Resource - Labs Logo
Please refer this manuscript for more details: Paul et al. (2015) A Population Response Analysis Approach To Assign Class II HLA-Epitope Restrictions. Journal of Immunology.

A manuscript on the latest version of the tool is under preparation. Link to the same will be provided here once it's published.

Purpose of the tool:
RATE (Restrictor Analysis Tool for Epitopes) is an automated method that can infer HLA restriction for a set of given epitopes from large datasets of T cell responses in HLA typed subjects. The tool takes two data files, one containing the alleles expressed by the subjects and the other containing the response of the peptides in the subjects. The tool calculates the odds ratio and estimates its significance using Fisher's exact test. It also calculates a parameter called relative frequency similar to odds ratio. The tool was developed with a focus on class II alleles but can also be applied to class I alleles.
Input data:
  1. Allele typing data of the subjects:
  2. The allele typing data for each subject should be provided in a specific format as a tab delimited plain text file. This can be generated by copying data from a spreadsheet to a plain text file. Instances where the allele type is not known should be represented as 'n/a'.
    A sample allele data input file can be downloaded from here.

  3. Response data:
  4. The response data also should be provided in a specific format as a tab delimited plain text file. The file should contain the response data for each peptide in each of the subjects. The absolute values determined by the assay can be entered directly and the threshold for positivity can be provided in the next step or the data can be provided as binary values of 1/0 indicating positive/negative. Instances where the value is not known should be represented as 'n/a'.
    A sample response data input file can be downloaded from here.

  5. Cutoff for response to be considered positive:
  6. This is the cutoff value for the response to determine if a peptide had a positive response in a donor or not. The user can provide the desired cutoff value here if the response data has absolute values from the assay or 1 if it's binary values.
    Please provide 20.0 as cutoff for the sample files given above.
Note: Please make sure that the number and names of patients/donors are exactly same in both input files.

Result page:

The result page shows:
  1. Details of input data
  2. Reformatted allele data showing the list of alleles expressed by the subjects & binary values of their presence/absence in each donor.
  3. Reformatted response data showing which all peptides gave positive response in each donor as binary values. This will be same as the input response data if it is provided as binary values.
  4. Details of RATE results
  5. Link to download RATE results (i.e. the selected HLA allele restrictons)
  6. Link to download the complete report that shows the analysis results for all peptide-HLA allele combinations. For e.g. if there are 25 peptides and 100 alleles expressed by the subjects, results for 25 x 100 = 2500 peptide-allele combinations are shown.
  7. Job Id: Please let us know this number if you have any question regarding any task that you did using the tool.
Output parameters (Complete/Concise results):
  1. A+R+: No. of subjects expressing the allele and have a positive response
  2. A-R+: No. of subjects that do not express the allele but have a positive response
  3. A+R-: No. of subjects expressing the allele but do not have a positive response
  4. A-R-: No. of subjects that do not express the allele and do not have a positive response
  5. No. of subjects: Total no. of subjects for the peptide-allele combination
  6. Response n/a: No. of subjects where response value is not available
  7. Odds ratio (OR): OR indicates the strength of association between expression of a specific allele and detection of positive immune response. An OR > 1 indicates a positive association. OR is calculated as:
  8. Relative frequency (RF): RF can be used in place of OR where OR becomes “infinity” due to division by zero (when none of the donors that do not express the allele have a positive response, i.e. A-R+ = 0). RF is calculated as:
  9. P-value: P-value obtained from Fisher's exact test can be used as a relative ranking which restriction has most statistical support.
How to interpret results:
The peptide-allele combinations listed in the "RATE results" file are the inferred HLA restrictions.
The "complete report" shows the analysis results for all peptide-allele combinations.
How the tool works:
For each peptide-allele combination, RATE generates a matrix tabulating the number of positive versus negative responders amongst the subjects expressing that particular HLA type, as well as the number of positive and negative responders among the subjects NOT expressing that HLA type. Next, for each epitope RATE calculates the OR and RF corresponding to each of the HLA molecules following classical formulas, as described above. The Fisher’s exact test is used to calculate the significance (p-value) associated with each peptide-allele combination.
Previous versions:
The first version of the tool can be accessed here: RATE version-1
Note: Please refer the manuscript for more details or contact us at help@iedb.org if you have further questions. Please include the "Job Id" in your correspondence if you have any.