R for reproducible scientific analysis

Introduction to R for non-programmers using gapminder data.

The goal of this lesson is to teach novice programmers to write modular code and best practices for using R for data analysis. R is commonly used in many scientific disciplines for statistical analysis and its array of third-party packages. We find that many scientists who come to Software Carpentry workshops use R and want to learn more. The emphasis of these materials is to give attendees a strong foundation in the fundamentals of R, and to teach best practices for scientific computing: breaking down analyses into modular units, task automation, and encapsulation.

Note that this workshop will focus on teaching the fundamentals of the programming language R, and will not teach statistical analysis.

A variety of third party packages are used throughout this workshop. These are not necessarily the best, nor are they comprehensive, but they are packages we find useful, and have been chosen primarily for their usability.

These lesson materials are adapted from the R-novice-inflammation materials, which were translated from the Python materials, and materials from our R Data Carpentry materials used at the Sydney bootcamp last year.

These lesson materials are designed to be run after both the Shell and Git materials, and are built around the Gapminder dataset.

Contributing

Please see the current list of [issues][] for ideas for contributing to this repository.

When editing topic pages, you should change the source R Markdown file. Afterwards you can render the pages by running make preview from the base of the repository. Building the rendered page with the Makefile requires installing some dependencies first. In addition to the dependencies listed in the [lesson template documentation][dependencies], you also need to install the R package [knitr][].

Once you've made your edits and rendered the corresponding html files, you need to add, commit, and push both the source R Markdown file(s) and the rendered html file(s). Including the html file(s) is required for viewing the [online version of the lessons][online] (you can learn more about the design of the build process [here][design]).

[issues]: https://github.com/resbaz/novice-r/issues [dependencies]: https://github.com/swcarpentry/lesson-template#dependencies [knitr]: http://cran.r-project.org/web/packages/knitr/index.html [online]: http://resbaz.github.io/novice-r/ [design]: https://github.com/swcarpentry/lesson-template/blob/gh-pages/DESIGN.md

Getting Help

Please see https://github.com/swcarpentry/lesson-template for instructions on formatting, building, and submitting lessons, or run make in this directory for a list of helpful commands.

If you have questions or proposals, please send them to the r-discuss mailing list.