Difference between revisions of "ABC-INT-Expression data"

From "A B C"
Jump to navigation Jump to search
m
m
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<div id="ABC">
 
<div id="ABC">
<div style="padding:5px; border:1px solid #000000; background-color:#e19fa7; font-size:300%; font-weight:400; color: #000000; width:100%;">
+
<div style="padding:5px; border:4px solid #000000; background-color:#e19fa7; font-size:300%; font-weight:400; color: #000000; width:100%;">
 
Integrator Unit: Expression Data
 
Integrator Unit: Expression Data
 
<div style="padding:5px; margin-top:20px; margin-bottom:10px; background-color:#e19fa7; font-size:30%; font-weight:200; color: #000000; ">
 
<div style="padding:5px; margin-top:20px; margin-bottom:10px; background-color:#e19fa7; font-size:30%; font-weight:200; color: #000000; ">
Line 21: Line 21:
 
<b>Deliverables:</b><br />
 
<b>Deliverables:</b><br />
 
<section begin=deliverables />
 
<section begin=deliverables />
<!-- included from "./data/ABC-unit_components.txt", section: "deliverables-integrator" -->
+
<li><b>Integrator unit</b>: Deliverables can be submitted for course marks. See below for details.</li>
*<b>Integrator unit</b>: Deliverables can be submitted for course marks. See below for details.
 
 
<section end=deliverables />
 
<section end=deliverables />
 
<!-- ============================  -->
 
<!-- ============================  -->
Line 28: Line 27:
 
<section begin=prerequisites />
 
<section begin=prerequisites />
 
<b>Prerequisites:</b><br />
 
<b>Prerequisites:</b><br />
<!-- included from "./data/ABC-unit_components.txt", section: "notes-prerequisites" -->
+
This unit builds on material covered in the following prerequisite units:<br />
This unit builds on material covered in the following prerequisite units:
 
 
*[[RPR-GEO2R|RPR-GEO2R (GEO2R)]]
 
*[[RPR-GEO2R|RPR-GEO2R (GEO2R)]]
 
<section end=prerequisites />
 
<section end=prerequisites />
Line 38: Line 36:
  
  
 +
{{SLEEP}}
  
 
{{Smallvspace}}
 
{{Smallvspace}}
Line 48: Line 47:
  
 
=== Evaluation ===
 
=== Evaluation ===
<!-- included from "./components/ABC-INT-Expression_data.components.txt", section: "evaluation" -->
 
 
Your progress and outcomes of this "Integrator Unit" will be one of the topics of the first oral exam for BCB420/JTB2020. That oral exam will be worth 20% of your term grade.<ref>Note: oral exams will focus on the content of Integrator Units, but will also cover material that leads up to it. All exams in this course are cumulative.</ref>.
 
Your progress and outcomes of this "Integrator Unit" will be one of the topics of the first oral exam for BCB420/JTB2020. That oral exam will be worth 20% of your term grade.<ref>Note: oral exams will focus on the content of Integrator Units, but will also cover material that leads up to it. All exams in this course are cumulative.</ref>.
 
* Work through the tasks described below.
 
* Work through the tasks described below.
Line 54: Line 52:
 
*Remember to document your work in your journal '''concurrently''' with your progress. Journal entries that are uploaded in bulk at the end of your work will not be considered evidence of ongoing engagement.
 
*Remember to document your work in your journal '''concurrently''' with your progress. Journal entries that are uploaded in bulk at the end of your work will not be considered evidence of ongoing engagement.
 
* Your task will involve writing an R script. '''Place your script code in a subpage of your User page on the Student Wiki'''<ref>Use the appropriate GeSHi code markup</ref> and link to the page from your Journal.
 
* Your task will involve writing an R script. '''Place your script code in a subpage of your User page on the Student Wiki'''<ref>Use the appropriate GeSHi code markup</ref> and link to the page from your Journal.
* Schedule an oral exam by editing the [http://steipe.biochemistry.utoronto.ca/abc/students/index.php/Signup-Oral_exams_2017 '''signup page on the Student Wiki''']. You must have signed-up for an exam slot before 20:00 on the day before your exam.
+
* Schedule an oral exam by editing <span class="highlight">the [http://steipe.biochemistry.utoronto.ca/abc/students/index.php/Signup-Oral_exams_2017 '''signup page on the Student Wiki''']. You</span> must have signed-up for an exam slot before 20:00 on the day before your exam.
 
* Your work must be complete before 20:00 on the day before your exam.
 
* Your work must be complete before 20:00 on the day before your exam.
  
Line 60: Line 58:
  
 
== Contents ==
 
== Contents ==
<!-- included from "./components/ABC-INT-Expression_data.components.txt", section: "contents" -->
 
  
 
Your task is to select an expression dataset that is suitable for use as a "feature" for human genes in machine learning. Currently, expression data are collected with microarrays and from RNAseq experiments. If we want to use different experiments in a computational experiment, we need to consider very carefully how to prepare comparable values.
 
Your task is to select an expression dataset that is suitable for use as a "feature" for human genes in machine learning. Currently, expression data are collected with microarrays and from RNAseq experiments. If we want to use different experiments in a computational experiment, we need to consider very carefully how to prepare comparable values.
Line 129: Line 126:
 
{{Vspace}}
 
{{Vspace}}
  
* Claim the dataset on the [http://steipe.biochemistry.utoronto.ca/abc/students/index.php/ABC-INT-Expression_datasets '''dataset signup page of the Student Wiki'''].
+
* <span class="highlight">Claim the dataset</span> on the [http://steipe.biochemistry.utoronto.ca/abc/students/index.php/ABC-INT-Expression_datasets '''dataset signup page of the Student Wiki'''].
  
 
{{Smallvspace}}
 
{{Smallvspace}}
Line 184: Line 181:
 
;5 – Average ...
 
;5 – Average ...
 
<div class="mw-collapsible-content" style="padding:10px;">
 
<div class="mw-collapsible-content" style="padding:10px;">
Calculate means for the replicates in your dataset.
+
Calculate robust estimates for expression values from the replicates in your dataset.
 
</div>
 
</div>
 
</div>
 
</div>
Line 203: Line 200:
 
* Next, transform the data with QN. The process is motivated and described in Taroni (2017), but once again there may be parameters to respect and we need a class-consensus on how to do this correctly. Coordinate as above.
 
* Next, transform the data with QN. The process is motivated and described in Taroni (2017), but once again there may be parameters to respect and we need a class-consensus on how to do this correctly. Coordinate as above.
  
* The final result of your script needs to be a dataframe with two numeric columns, named <tt>&lt;GSET-ID&gt;.ctrl</tt> and <tt>&lt;GSET-ID&gt;.test</tt>, all rows of the HUGO symbols must exist in the exact order of the HUGO symbol reference vector, and the HUGO symbols must be defined as rownames of the dataframe. I expect that you have actually produced such a dataset and have it available on your computer for reference. '''Do not upload this data to Github.'''
+
* The final result of your script needs to be a dataframe with two numeric columns, named <tt>&lt;GSET-ID&gt;.ctrl</tt> and <tt>&lt;GSET-ID&gt;.test</tt>, all rows of the HUGO symbols must exist in the exact order of the HUGO symbol reference vector, and the HUGO symbols must be defined as rownames of the dataframe.
 +
<div class="mw-collapsible mw-collapsed" data-expandtext="More&nbsp;▽" data-collapsetext="Hide&nbsp;△" style="width:67%;border: solid 1px #BBBBBB;padding: 10px;spacing: 10px;">
 +
;Example ...
 +
<div class="mw-collapsible-content" style="padding:10px;">
 +
If you are working on <tt>GSE01234</tt> and you have mapped symbols <tt>DDD</tt>, <tt>AAA</tt>, and <tt>MMM</tt>, but not probe <tt>1234_at</tt>, your initial dataframe after processing might look like this:
 +
 
 +
            sym    ctrl    test
 +
1200_at    DDD 69.40936 65.12871
 +
1234_at  <NA> 58.08945 82.15397
 +
278_at    AAA 65.62096 63.12460
 +
112358_at  MMM 46.75833 58.08034
 +
 
 +
Assume <tt>HUGOSymbols</tt> contains the four symbols <tt>AAA</tt>, <tt>BBB</tt>, <tt>DDD</tt>, and <tt>MMM</tt>. Your '''final''' dataframe, according to the specifications, has to look like this:
 +
 
 +
    GSE01234.ctrl GSE01234.test
 +
AAA      65.62096      63.12460
 +
BBB            NA            NA
 +
DDD      69.40936      65.12871
 +
MMM      46.75833      58.08034
 +
 
 +
Note that the rownames of the final dataframe are *exactly the same* as the <tt>HUGOSymbols</tt> vector. This is necessary so we can later merge our data across all expression datasets.
 +
 
 +
</div>
 +
</div>
 +
 
 +
 
 +
* I expect that you have actually produced such a dataset and have it available on your computer for reference. '''Do not upload this data to Github.'''
  
 
* If your script does not produce a data set according to these exact specifications, this '''must''' be clearly stated in the script.
 
* If your script does not produce a data set according to these exact specifications, this '''must''' be clearly stated in the script.
Line 235: Line 258:
 
{{Vspace}}
 
{{Vspace}}
  
== Notes ==
 
<!-- included from "./components/ABC-INT-Expression_data.components.txt", section: "notes" -->
 
<!-- included from "./data/ABC-unit_components.txt", section: "notes" -->
 
<references />
 
 
== Further reading, links and resources ==
 
== Further reading, links and resources ==
  
Line 258: Line 277:
 
:{{#pmid:12454644}}
 
:{{#pmid:12454644}}
  
 +
== Notes ==
 +
<references />
  
 
{{Vspace}}
 
{{Vspace}}
  
 
<!-- included from "./data/ABC-unit_components.txt", section: "ABC-unit_ask" -->
 
 
----
 
 
{{Vspace}}
 
 
<b>If in doubt, ask!</b> If anything about this learning unit is not clear to you, do not proceed blindly but ask for clarification. Post your question on the course mailing list: others are likely to have similar problems. Or send an email to your instructor.
 
 
----
 
 
{{Vspace}}
 
  
 
<div class="about">
 
<div class="about">
Line 284: Line 293:
 
:2017-11-01
 
:2017-11-01
 
<b>Version:</b><br />
 
<b>Version:</b><br />
:1.1
+
:1.1.1
 
<b>Version history:</b><br />
 
<b>Version history:</b><br />
 +
*1.1.1 Sleeping ...
 
*1.1 Some resources and further reading added
 
*1.1 Some resources and further reading added
 
*1.0 First live version
 
*1.0 First live version
 
</div>
 
</div>
[[Category:ABC-units]]
 
<!-- included from "./data/ABC-unit_components.txt", section: "ABC-unit_footer" -->
 
  
 
{{CC-BY}}
 
{{CC-BY}}
  
 +
[[Category:ABC-units]]
 +
{{INTEGRATOR}}
 +
{{SLEEP}}
 +
{{EVAL}}
 
</div>
 
</div>
 
<!-- [END] -->
 
<!-- [END] -->

Latest revision as of 01:44, 23 September 2020

Integrator Unit: Expression Data

(Integrator unit: select, clean and normalize expression data)


 


Abstract:

This page integrates material from the learning units and defines a task for selecting and normalizing human expression data.


Deliverables:

  • Integrator unit: Deliverables can be submitted for course marks. See below for details.

  • Prerequisites:
    This unit builds on material covered in the following prerequisite units:


     


    This page is not currently being maintained since it is not part of active learning sections.


     



     


    Evaluation

    Your progress and outcomes of this "Integrator Unit" will be one of the topics of the first oral exam for BCB420/JTB2020. That oral exam will be worth 20% of your term grade.[1].

    • Work through the tasks described below.
    • Note that there are several tasks that need to be coordinated with your teammates and classmates. This is necessary to ensure the feature sets can be merged in the second phase of the course. Be sure to begin this coordination process in time.
    • Remember to document your work in your journal concurrently with your progress. Journal entries that are uploaded in bulk at the end of your work will not be considered evidence of ongoing engagement.
    • Your task will involve writing an R script. Place your script code in a subpage of your User page on the Student Wiki[2] and link to the page from your Journal.
    • Schedule an oral exam by editing the signup page on the Student Wiki. You must have signed-up for an exam slot before 20:00 on the day before your exam.
    • Your work must be complete before 20:00 on the day before your exam.


     

    Contents

    Your task is to select an expression dataset that is suitable for use as a "feature" for human genes in machine learning. Currently, expression data are collected with microarrays and from RNAseq experiments. If we want to use different experiments in a computational experiment, we need to consider very carefully how to prepare comparable values.

    To begin, please read the following paper:

    Taroni & Greene (2017) Cross-platform normalization enables machine learning model training on microarray and RNA-seq data simultaneously (BioRχiv doi: https://doi.org/10.1101/118349)

    Our ultimate goal is to explore machine learning approaches to evaluate systems membership of genes. For this, we need features that annotate genes, are suitable for machine learning, and are informative regarding the function of the gene. Expression profiles have great potential for this, since genes that collaborate are often (although not always) co-regulated - either directly by being part of the same gene regulatory pathways, or indirectly by being similarly responsive to environmental conditions or other stimuli. In order to build "good" features, the data need to be of good quality, and informative for our purpose. We need expression datasets -

    • with good coverage;
    • not much older than ten years (quality!);
    • with sufficient numbers of replicates;
    • collected under interesting conditions;
    • mapped to unique human gene identifiers.

    For this integrator unit you will prepare a script that will produce one reference and one experimental feature data set for human genes (from the same experiment).

    To avoid mistakes in praparing the dataset, discuss your approach with your team members, or post questions on the mailing list. You are encouraged to discuss strategies with anyone however the script you submit must be entirely your own and you must not copy code (apart from the script template) from elsewhere.

    Read the entire set of requirements and parameters carefully before you begin. I have posted sample code that covers some of the aspects in the ./inst/scripts/ directory of the zu project/package repository.


     

    Select an Expression Data Set

     

    Task:


     
    1 – Choose a dataset of native, healthy human cells or tissue ...

    If your dataset is not native, healthy human tissue, you will not receive credit. An exception can be made if you feel that you have discovered an experiment on different cells that will be particularly useful regardless. If so, contact me for special permission.


     
    2 – Choose an interesting experiment ...

    If we are to use these features to assess system membership, their expression response to the experimental conditions must reflect some biological property. Ideally, this will be a physiological response of some sort, disease states may be less suited to this question. It is your task to reflect on this question and choose accordingly.


     
    3 – Make sure the coverage is as complete as possible ...

    Experiments that measure expression for only a small subset of genes are not suitable.


     
    4 – Choose high-quality experiments ...

    The experiments should be performed with technical replicates (the more the better), and you will average the replicates as you prepare the feature data set. It also should be performed with mature experimental platforms, according to best-practice procedures; therefore we should choose recent experiments (not older than ten years). As above, contact me for special permission if you want to deviate from this requirement.


     


     


     

    Clean the data and map to HUGO symbols

     

    Task:

    • Develop your code in an R script that you submit as part of this task. The script should implement the following workflow:
    1 – Download the data ...

    Do not work on manually downloaded data, but use the GEOquery Bioconductor package. (Obviously, do not re-download the dataset every time you run the script, but figure out a strategy to download only when necessary.) Sample code is in the R code associeted with the RPR-GEO2R learning unit.


     
    2 – Assess ...

    Compute overview statistics to assess data quality for the control and test conditions in your dataset. You will only submit one feature for the control condition, and one feature for the test condition - so you can remove columns that correspond to other conditions from the dataset at this point.


     
    3 – Map ...

    Your dataset probably does not contain HUGO gene symbols as row identifiers - you need to map rows to symbols. How? Figure that out in collaboration with your team and the rest of the class. It is crucial that everyone maps to the same gene symbols. I have prepared a reference set of symbols in the zu repository. It is in inst/extdata and the corresponding script is in inst/scripts. But you will need to figure out how to handle unmapped rows (these are likely outdated aliases of current symbols, or possibly deprecated ORFs). You also need to figure out what to do with rows that map to more than one symbol (perhaps the sequenced fragment was not unique, or the microarray spot hybridizes to more than one gene.) Finally you need to figure out what to do with multiple rows that map to the same symbol (these could be splice variants, or probes that are designed as internal controls). In any case: you, your team, and the entire class have to come up with a consensus how these situations will be handled correctly. And your code must implement the consensus. Simply removing these cases from the dataset is not satisfactory, and if your code does not correctly implement the consensus approach you may not receive credit.


     
    4 – Clean ...

    There are two considerations you need to go through: removing outliers, and imputing missing data. Whether one should remove outliers is a matter of debate[3], but if one has well founded reasons to believe a measurement error has occurred, the measurement should indeed be discarded. For imputation strategies, see the RPR-Data-Imputation learning unit. As with the map-rows-to-gene-symbols task, we need a class-wide consensus on how to clean the data and your script must correctly implement that consensus.


     
    5 – Average ...

    Calculate robust estimates for expression values from the replicates in your dataset.


     


     


    Apply Quantile Normalization (QN)

     

    Task:

    • Next, transform the data with QN. The process is motivated and described in Taroni (2017), but once again there may be parameters to respect and we need a class-consensus on how to do this correctly. Coordinate as above.
    • The final result of your script needs to be a dataframe with two numeric columns, named <GSET-ID>.ctrl and <GSET-ID>.test, all rows of the HUGO symbols must exist in the exact order of the HUGO symbol reference vector, and the HUGO symbols must be defined as rownames of the dataframe.
    Example ...

    If you are working on GSE01234 and you have mapped symbols DDD, AAA, and MMM, but not probe 1234_at, your initial dataframe after processing might look like this:

               sym     ctrl     test
    1200_at    DDD 69.40936 65.12871
    1234_at   <NA> 58.08945 82.15397
    278_at     AAA 65.62096 63.12460
    112358_at  MMM 46.75833 58.08034
    

    Assume HUGOSymbols contains the four symbols AAA, BBB, DDD, and MMM. Your final dataframe, according to the specifications, has to look like this:

        GSE01234.ctrl GSE01234.test
    AAA      65.62096      63.12460
    BBB            NA            NA
    DDD      69.40936      65.12871
    MMM      46.75833      58.08034
    

    Note that the rownames of the final dataframe are *exactly the same* as the HUGOSymbols vector. This is necessary so we can later merge our data across all expression datasets.


    • I expect that you have actually produced such a dataset and have it available on your computer for reference. Do not upload this data to Github.
    • If your script does not produce a data set according to these exact specifications, this must be clearly stated in the script.


     


     

    Interpret, and document

     

    The steps above conclude the actual data preparation. Be prepared to answer the following questions:

    Task:

    • What are the control and test conditions of the dataset?
    • Why is the dataset of interest to our systems assessment task?
    • Were there expression values that were not unique for specific genes? How did you handle these?
    • Were there expression values that could not be mapped to current HUGO symbols?
    • How many outliers were removed, how many datapoints were imputed?
    • How did you handle replicates?
    • What is the final coverage of your dataset?
     
    • Make sure your script contains the complete workflow, is fully commented, and contains all essential elements suggested by the script template[4]. This is a collaborative project - form matters.


     

    Further reading, links and resources

    Bolstad et al. (2003) A comparison of normalization methods for high density oligonucleotide array data based on variance and bias. Bioinformatics 19:185-93. (pmid: 12538238)

    PubMed ] [ DOI ] MOTIVATION: When running experiments that involve multiple high density oligonucleotide arrays, it is important to remove sources of variation between arrays of non-biological origin. Normalization is a process for reducing this variation. It is common to see non-linear relations between arrays and the standard normalization provided by Affymetrix does not perform well in these situations. RESULTS: We present three methods of performing normalization at the probe intensity level. These methods are called complete data methods because they make use of data from all arrays in an experiment to form the normalizing relation. These algorithms are compared to two methods that make use of a baseline array: a one number scaling based algorithm and a method that uses a non-linear normalizing relation by comparing the variability and bias of an expression measure. Two publicly available datasets are used to carry out the comparisons. The simplest and quickest complete data method is found to perform favorably. AVAILABILITY: Software implementing all three of the complete data normalization methods is available as part of the R package Affy, which is a part of the Bioconductor project http://www.bioconductor.org. SUPPLEMENTARY INFORMATION: Additional figures may be found at http://www.stat.berkeley.edu/~bolstad/normalize/index.html

    • HUGO Gene Nomenclature Committee - the authoritative information source for gene symbols. Includes search functions for synonyms. aliases and other information, as well as downloadable data.
    • Good discussion of current microarray normalization strategies, as well as a proposal how to apply QN to case/control datasets:
    Cheng et al. (2016) CrossNorm: a novel normalization strategy for microarray data in cancers. Sci Rep 6:18898. (pmid: 26732145)

    PubMed ] [ DOI ] Normalization is essential to get rid of biases in microarray data for their accurate analysis. Existing normalization methods for microarray gene expression data commonly assume a similar global expression pattern among samples being studied. However, scenarios of global shifts in gene expressions are dominant in cancers, making the assumption invalid. To alleviate the problem, here we propose and develop a novel normalization strategy, Cross Normalization (CrossNorm), for microarray data with unbalanced transcript levels among samples. Conventional procedures, such as RMA and LOESS, arbitrarily flatten the difference between case and control groups leading to biased gene expression estimates. Noticeably, applying these methods under the strategy of CrossNorm, which makes use of the overall statistics of the original signals, the results showed significantly improved robustness and accuracy in estimating transcript level dynamics for a series of publicly available datasets, including titration experiment, simulated data, spike-in data and several real-life microarray datasets across various types of cancers. The results have important implications for the past and the future cancer studies based on microarray samples with non-negligible difference. Moreover, the strategy can also be applied to other sorts of high-throughput data as long as the experiments have global expression variations between conditions.

    • Quackenbusch's paper is now old, but an often-cited standard reference in the field:
    Quackenbush (2002) Microarray data normalization and transformation. Nat Genet 32 Suppl:496-501. (pmid: 12454644)

    PubMed ] [ DOI ] Underlying every microarray experiment is an experimental question that one would like to address. Finding a useful and satisfactory answer relies on careful experimental design and the use of a variety of data-mining tools to explore the relationships between genes or reveal patterns of expression. While other sections of this issue deal with these lofty issues, this review focuses on the much more mundane but indispensable tasks of 'normalizing' data from individual hybridizations to make meaningful comparisons of expression levels, and of 'transforming' them to select genes for further analysis and data mining.

    Notes

    1. Note: oral exams will focus on the content of Integrator Units, but will also cover material that leads up to it. All exams in this course are cumulative.
    2. Use the appropriate GeSHi code markup
    3. See this conversation on cross-validated for example.
    4. Refer to the script template inst/extdata/scripts/scriptTemplate.R in the _zu_ project repository.


     


    About ...
     
    Author:

    Boris Steipe <boris.steipe@utoronto.ca>

    Created:

    2018-01-26

    Modified:

    2017-11-01

    Version:

    1.1.1

    Version history:

    • 1.1.1 Sleeping ...
    • 1.1 Some resources and further reading added
    • 1.0 First live version

    CreativeCommonsBy.png This copyrighted material is licensed under a Creative Commons Attribution 4.0 International License. Follow the link to learn more.

    This page is not currently being maintained since it is not part of active learning sections.