Difference between revisions of "RPR-Introduction"

From "A B C"
Jump to navigation Jump to search
m
m
Line 35: Line 35:
 
<b>Deliverables:</b><br />
 
<b>Deliverables:</b><br />
 
<section begin=deliverables />
 
<section begin=deliverables />
−
<!-- included from "./data/ABC-unit_components.txt", section: "deliverables-milestone" -->
 
 
<li><b>No separate deliverables</b>: This unit collects other units and has no deliverables on its own.</li>
 
<li><b>No separate deliverables</b>: This unit collects other units and has no deliverables on its own.</li>
 
<section end=deliverables />
 
<section end=deliverables />
Line 42: Line 41:
 
<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:<br />
 
*[[RPR-Coding_style|RPR-Coding_style (R Coding Style)]]
 
*[[RPR-Coding_style|RPR-Coding_style (R Coding Style)]]
Line 52: Line 50:
  
  
−
{{REVISE}}
 
  
 
{{Smallvspace}}
 
{{Smallvspace}}
Line 62: Line 59:
  
  
 +
=== Evaluation ===
 +
<b>Evaluation: NA</b><br />
 +
<div style="margin-left: 2rem;">This unit is not evaluated for course marks.</div>
 
== Contents ==
 
== Contents ==
−
<!-- included from "./components/RPR-Introduction.components.txt", section: "contents" -->
+
This is a "milestone unit". Its purpose is merely to collect a number of preparatory units into a single, common prerequisite. It has no contents of its own; you are expected to be familiar and competent with all preparatory material at this point, '''and to have documented your learning in your journal'''.
−
<!-- included from "./data/ABC-unit_components.txt", section: "milestone" -->
 
−
This is a "milestone unit". Its purpose is merely to collect a number of preparatory units into a single, common prerequisite. It has no contents of its own; you are expected to be familiar and competent with all preparatory material at this point.
 
  
 
==The ABC RStudio Project==
 
==The ABC RStudio Project==
Line 78: Line 76:
 
{{task|1=
 
{{task|1=
 
* Open RStudio and create a '''New Project...''' cloned from a git version control directory. The repository URL is <code><nowiki>https://github.com/hyginn/ABC-units</nowiki></code>. Create this in the same way as you did for the [[RPR-Setup#Git_Version_control|'''R'''-tutorial]].
 
* Open RStudio and create a '''New Project...''' cloned from a git version control directory. The repository URL is <code><nowiki>https://github.com/hyginn/ABC-units</nowiki></code>. Create this in the same way as you did for the [[RPR-Setup#Git_Version_control|'''R'''-tutorial]].
−
* As requested on the console, type <code>init()</code>. This will create a file called <code>.myProfile.R</code> and ask you for your UofT eMail address and Student ID. You need to enter the correct values because other scripts will assume that these variables exist and are valid.
+
* As requested on the console, type <code>init()</code>. This will setup and configure some files.
 
* Work through the task: <code>"Local script"</code> in the <code>RPR-Introduction.R</code> script.
 
* Work through the task: <code>"Local script"</code> in the <code>RPR-Introduction.R</code> script.
  
Line 104: Line 102:
 
===Understanding the setup===
 
===Understanding the setup===
  
−
Imagine you made a typo when you entered your eMail address and now the file <code>.myProfile.R</code> contains a mistake. How do you fix this?
+
Imagine you made a typo when you entered your eMail address and now the file <code>scripts/.myProfile.R</code> contains a mistake. How do you fix this?
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
 
Answer ...
 
Answer ...
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
−
<code>.myProfile.R</code> is itself a file in the local working directory. Simply open it with the RStudio editor, fix the error, and save. Then type <code>source(".myProfile.R")</code> into the console to overwrite the old (wrong) definition with the corrected one.
+
<code>scripts/.myProfile.R</code> is itself a file in the local working directory. Simply open it with the RStudio editor, fix the error, and save. Then type <code>source("scripts/.myProfile.R")</code> into the console to overwrite the old (wrong) definition with the corrected one.
  
 
</div>
 
</div>
Line 115: Line 113:
  
 
   {{Vspace}}
 
   {{Vspace}}
−
== Notes ==
 
−
<!-- included from "./components/RPR-Introduction.components.txt", section: "notes" -->
 
−
<!-- included from "./data/ABC-unit_components.txt", section: "notes" -->
 
−
<references />
 
−
== Further reading, links and resources ==
 
−
<!-- {{#pmid: 19957275}} -->
 
−
<!-- {{WWW|WWW_GMOD}} -->
 
−
<!-- <div class="reference-box">[http://www.ncbi.nlm.nih.gov]</div> -->
 
  
 
{{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 147: Line 125:
 
:2017-08-05
 
:2017-08-05
 
<b>Modified:</b><br />
 
<b>Modified:</b><br />
−
:2017-08-05
+
:2020-09-18
 
<b>Version:</b><br />
 
<b>Version:</b><br />
−
:1.0
+
:1.0.1
 
<b>Version history:</b><br />
 
<b>Version history:</b><br />
 +
*1.0.1 Maintenance
 
*1.0 Completed to first live version.
 
*1.0 Completed to first live version.
 
*0.1 First stub
 
*0.1 First stub
 
</div>
 
</div>
−
[[Category:ABC-units]]
 
−
<!-- included from "./data/ABC-unit_components.txt", section: "ABC-unit_footer" -->
 
  
 
{{CC-BY}}
 
{{CC-BY}}
  
 +
[[Category:ABC-units]]
 
</div>
 
</div>
 
<!-- [END] -->
 
<!-- [END] -->

Revision as of 12:32, 19 September 2020

Introduction to R

(Introduction to R)


 


Abstract:

This page collects the learning units for an introduction to R.

Objectives:
...

Outcomes:
...

Deliverables:

  • No separate deliverables: This unit collects other units and has no deliverables on its own.

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


     



     



     


    Evaluation

    Evaluation: NA

    This unit is not evaluated for course marks.

    Contents

    This is a "milestone unit". Its purpose is merely to collect a number of preparatory units into a single, common prerequisite. It has no contents of its own; you are expected to be familiar and competent with all preparatory material at this point, and to have documented your learning in your journal.

    The ABC RStudio Project

    R-scripts and other resources for the learning units of this course are collected in an RStudio project. This makes it easy to update and distribute code. I push update material to the GitHub repository of the project for any unit, all you need to do is to pull the updated project to receive all updates and new files on your computer. Version control is really useful for this. However, there is an issue that you need to be aware of. If you create your own, local files and then commit them, git will complain that it would be overwriting such local material. As long as you don't commit your files then all should be fine. This means you'll need to do your own "versioning" by saving your own scripts under a different name from time to time. Once again: in this context:

    • saving your own files is fine;
    • committing your own files to version control will cause problems;
    • changes you make to course material files and save under the same filename (like adding comments and notes) will not persist, these changes will be overwritten with the next update. You need to "Save As..." with a new filename (for example, prefix the original name with "my").


     

    Task:

    • Open RStudio and create a New Project... cloned from a git version control directory. The repository URL is https://github.com/hyginn/ABC-units. Create this in the same way as you did for the R-tutorial.
    • As requested on the console, type init(). This will setup and configure some files.
    • Work through the task: "Local script" in the RPR-Introduction.R script.


     

    Self-evaluation

    Understanding the setup

    Imagine you made a typo when you entered your eMail address and now the file scripts/.myProfile.R contains a mistake. How do you fix this?

    Answer ...

    scripts/.myProfile.R is itself a file in the local working directory. Simply open it with the RStudio editor, fix the error, and save. Then type source("scripts/.myProfile.R") into the console to overwrite the old (wrong) definition with the corrected one.


     


     


    About ...
     
    Author:

    Boris Steipe <boris.steipe@utoronto.ca>

    Created:

    2017-08-05

    Modified:

    2020-09-18

    Version:

    1.0.1

    Version history:

    • 1.0.1 Maintenance
    • 1.0 Completed to first live version.
    • 0.1 First stub

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

    Retrieved from "http://steipe.biochemistry.utoronto.ca/abc/index.php?title=RPR-Introduction&oldid=11530"