Difference between revisions of "RPR-Subsetting"

From "A B C"
Jump to navigation Jump to search
m
m
Line 29: Line 29:
 
<section begin=abstract />
 
<section begin=abstract />
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "abstract" -->
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "abstract" -->
...
+
Subsetting and filtering are among the most important operations with data. R provides powerful syntax for these operations. Learn about and practice them in this unit.
 
<section end=abstract />
 
<section end=abstract />
  
Line 48: Line 48:
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "objectives" -->
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "objectives" -->
 
This unit will ...
 
This unit will ...
* ... introduce ;
+
* ... introduce subsetting principles;
* ... discuss ;
+
* ... practice them on data;
* ... teach ;
 
  
 
{{Vspace}}
 
{{Vspace}}
Line 58: Line 57:
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "outcomes" -->
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "outcomes" -->
 
After working through this unit you ...
 
After working through this unit you ...
* ... have done;
+
* ... can subset and filter data according to six different principles.
* ... know how ;
 
* ... can ;
 
  
 
{{Vspace}}
 
{{Vspace}}
Line 90: Line 87:
 
== Contents ==
 
== Contents ==
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "contents" -->
 
<!-- included from "../components/RPR-Subsetting.components.wtxt", section: "contents" -->
 +
 +
{{task| 1=
 +
* Load the <code>R-Exercise_BasicSetup</code> project in RStudio if you don't already have it open.
 +
* Type <code>init()</code> as instructed after the project has loaded.
 +
* Recreate the <code>plasmidData</code> data frame, if it is not still defined in your Workspace.
 +
* Continue below.
 +
}}
 +
 +
 
===Subsetting===
 
===Subsetting===
  
 
+
We have encountered "subsetting" before, but we really need to discuss this in more detail. It is one of the most important topics of '''R''' since it is indispensable to select, transform, and otherwise modify data to prepare it for analysis. You have seen that we use square brackets to indicate individual elements in vectors and matrices. These square brackets are actually "operators", and you can find more information about them in the help  pages:
We have encountered "subsetting" before, but we really need to discuss this in more detail. It is one of the most important and powerful topics of '''R''' since it is indispensable to select, transform, and otherwise modify data to prepare it for analysis. You have seen that we use square brackets to indicate individual elements in vectors and matrices. These square brackets are actually "operators", and you can find more information about them in the help  pages:
 
  
 
<source lang="rsplus">
 
<source lang="rsplus">
Line 102: Line 107:
 
* <code>[ ]</code> "extracts" one or more elements defined within the brackets;
 
* <code>[ ]</code> "extracts" one or more elements defined within the brackets;
 
* <code>[[ ]]</code> "extracts" a single element defined within the brackets;
 
* <code>[[ ]]</code> "extracts" a single element defined within the brackets;
* <code>?</code> "extracts" a single <u>named</u> element that.
+
* <code>?</code> "extracts" a single <u>named</u> element.
  
 
"Elements" are not necessarily scalars, but can apply to a row, column, or more complex data structure. But a "single element" can't be a range, or collection.
 
"Elements" are not necessarily scalars, but can apply to a row, column, or more complex data structure. But a "single element" can't be a range, or collection.
  
 +
{{Vspace}}
  
 
+
Here are some examples of subsetting data from the <code>plasmidData</code> data frame we constructed previously. For the most part, this is review:
Here are some examples of subsetting data from the <code>plasmidData</code> data frame we constructed above. For the most part, this is review of what we already did above:
 
  
 
<source lang="rsplus">
 
<source lang="rsplus">
Line 172: Line 177:
  
 
{{Vspace}}
 
{{Vspace}}
 +
 +
===Subsetting practice===
 +
 +
{{task| 1=
 +
* The <code>R-Exercise_BasicSetup</code> project contains a file <code>subsettingPractice.R</code>
 +
* Open the file and work through it.
 +
}}
 +
 +
  
  

Revision as of 16:53, 11 September 2017

Subsetting and filtering R objects


 

Keywords:  Subsetting with the [], [[]], and $ operators, filtering


 



 


 


Abstract

Subsetting and filtering are among the most important operations with data. R provides powerful syntax for these operations. Learn about and practice them in this unit.


 


This unit ...

Prerequisites

You need to complete the following units before beginning this one:


 


Objectives

This unit will ...

  • ... introduce subsetting principles;
  • ... practice them on data;


 


Outcomes

After working through this unit you ...

  • ... can subset and filter data according to six different principles.


 


Deliverables

  • Time management: Before you begin, estimate how long it will take you to complete this unit. Then, record in your course journal: the number of hours you estimated, the number of hours you worked on the unit, and the amount of time that passed between start and completion of this unit.
  • Journal: Document your progress in your Course Journal. Some tasks may ask you to include specific items in your journal. Don't overlook these.
  • Insights: If you find something particularly noteworthy about this unit, make a note in your insights! page.


 


Evaluation

Evaluation: NA

This unit is not evaluated for course marks.


 


Contents

Task:

  • Load the R-Exercise_BasicSetup project in RStudio if you don't already have it open.
  • Type init() as instructed after the project has loaded.
  • Recreate the plasmidData data frame, if it is not still defined in your Workspace.
  • Continue below.


Subsetting

We have encountered "subsetting" before, but we really need to discuss this in more detail. It is one of the most important topics of R since it is indispensable to select, transform, and otherwise modify data to prepare it for analysis. You have seen that we use square brackets to indicate individual elements in vectors and matrices. These square brackets are actually "operators", and you can find more information about them in the help pages:

> ?"["     # Note that you need quotation marks around the operator for this.

Note especially:

  • [ ] "extracts" one or more elements defined within the brackets;
  • [[ ]] "extracts" a single element defined within the brackets;
  • ? "extracts" a single named element.

"Elements" are not necessarily scalars, but can apply to a row, column, or more complex data structure. But a "single element" can't be a range, or collection.


 

Here are some examples of subsetting data from the plasmidData data frame we constructed previously. For the most part, this is review:

plasmidData[1, ]
plasmidData[2, ]

# we can extract more than one row by specifying
# the rows we want in a vector ...
plasmidData[c(1, 2), ]

# ... this works in any order ...
plasmidData[c(3, 1), ]

# ... and for any number of rows ...
plasmidData[c(1, 2, 1, 2, 1, 2), ]


# Same for columns
plasmidData[ , 2 ]

# We can select rows and columns by name if a name has been defined...
plasmidData[, "Name"]
plasmidData$Name      # different syntax, same thing. This is the syntax I use most frequently.


# Watch this!
plasmidData$Name[plasmidData$Ori != "ColE1"]
# What happened here?
# plasmidData$Ori != "ColE1" is a logical expression, it gives a vector of TRUE/FALSE values
plasmidData$Ori != "ColE1"

# We insert this vector into the square brackets. R then returns all rows for
# which the vector is TRUE.

# In this way we can "filter" for values
plasmidData$Size > 3000
plasmidData$Name[plasmidData$Size > 3000]

# This principle is what we use when we want to "sort" an object
# by some value. The function order() is used to return values
# that are sorted. Remember this: not sort() but order().
order(plasmidData$Size)
plasmidData[order(plasmidData$Size), ]

# grep() matches substrings in strings and returns a vector of indices
grep("Tet", plasmidData$Marker)
plasmidData[grep("Tet", plasmidData$Marker), ]
plasmidData[grep("Tet", plasmidData$Marker), "Ori"]

Elements that can be extracted from an object also can be replaced. Simply assign the new value to the element.

( x <- sample(1:10) )
x[4] <- 99
x
( x <- x[order(x)] )

Try your own subsetting ideas. Play with this. I find that even seasoned investigators have problems with subsetting their data and if you become comfortable with the many ways of subsetting, you will be ahaed of the game right away.


 

Subsetting practice

Task:

  • The R-Exercise_BasicSetup project contains a file subsettingPractice.R
  • Open the file and work through it.



 


Further reading, links and resources

 


Notes


 


Self-evaluation

 



 




 

If in doubt, ask! 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.



 

About ...
 
Author:

Boris Steipe <boris.steipe@utoronto.ca>

Created:

2017-08-05

Modified:

2017-09-10

Version:

1.0

Version history:

  • 1.0 Completed to first live version
  • 0.1 Material collected from previous tutorial

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