Software Installation

GIT AND GITHUB

How to install git

Install git on Windows

  1. Download the Git for Windows installer.
  2. Run the installer and follow the steps bellow:
    1. Click on Next until you get to the step below.
    2. Select Use Git from the Windows Command Prompt and click on Next.
    3. Click on Next. Keep Checkout Windows-style, commit Unix-style line endings selected.
    4. Select Use Windows' default console window and click on Next.
    5. Click on Next then Finish.
  3. Video Tutorial

This will provide you with both Git and Bash in the Git Bash program. If you make a mistake you may rerun the installer and select the appropriate options.


Install git on Mac OSX

To fully set up your Mac for bioinformatics we recommend the Biostar Handbook website.

Alternatively to set up just git alone see:

  1. Git downloads
  2. Video Tutorial

For OS X 10.9 and higher, install Git for Mac by downloading and running the most recent mavericks installer from this list.

After installing Git, there will not be anything in your /Applications folder, as Git is a command line program. For older versions of OS X (10.5-10.8) use the most recent available installer labelled snow-leopard available here.


Install git on Linux

If Git is not already available on your machine you can try to install it via your distro's package manager. For Debian/Ubuntu run sudo apt-get install git and for Fedora run sudo yum install git.


Create a GitHub account

Git is a version control system that lets you track who made changes to what when and has options for easily updating a shared or public version of your code on github.com. You will need a supported web browser (current versions of Chrome, Firefox or Safari, or Internet Explorer version 9 or above).

You will need an account at github.com for parts of the Git lesson. Basic GitHub accounts are free. We encourage you to create a GitHub account if you don't have one already. Please consider what personal information you'd like to reveal. For example, you may want to review these instructions for keeping your email address private provided at GitHub.

Git/Github survival guide

The most commonly used command with git.

Set up SSH passwords

ssh-keygen

This will generate a password in ~/.ssh/id_rsa.pub

cat ~/.ssh/id_rsa.pub

Copy and paste the key into the Github -> Account -> Settings -> Add SSH key

Common git commands

Command we typically do once:

Commands we use all the time:

Further information:

R AND RSTUDIO

How to install R

For simulation we are going to use R, a statistical programming language. The software is open-source, interacts well with git, has many packages written by and for the bioinformatics community and is also useful for developing graphics and web app.

We are going to access R via a package called RStudio, which provides additional resources including a window system which facilitates installing packages , accessing the help files, and documenting your work. RStudio is also free.

All of this software is available on Macs, Windows, and Linux. Mostly it works identically on all types of computers, although I have noticed that sometimes the versions are out of sync.

To get started, please install R and RStudio as directed below.

Installing R

  1. Go to https://www.r-project.org/

  2. Select a CRAN mirror. (This is the computer that you are downloading from. It is advisable to select a mirror that is geographically close.)

  3. Select the appropriate version for the type of computer you are using.

  4. Install the downloaded software just like any other software on your computer.

Installing RStudio

  1. Go to https://www.rstudio.com/

  2. Click on the Download button.

  3. Scroll down to "Download R Studio Desktop".

  4. Select the appropriate installer.

  5. Install the downloaded software.

Check the download

Click on the R Studio icon. This should open R Studio.

EDITOR

Install a text editor

Microsoft Word is NOT a text editor. Using Word to edit text will will eventually cause (devious) errors. Best if you start using a proper text editor. Essential features:

Recommendations

Personal preference :


Install pandoc

Pandoc can convert documents across formats: markdown to html or pdf etc.

On Mac OSX:

brew install pandoc

On windows visit the Pandoc website.


Online markdown editors

Penn State • 2017 • bootcamp-central via pyblue