Software Installation

GIT AND GITHUB

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.

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.

SHELL

Install Bash terminals

(install instructions copied from Software Carpentry)

Mac OS

For a Mac computer, the default Unix Shell is Bash, and it is available via the Terminal Utilities program within your Applications folder. To open Terminal, try one or both of the following:

  1. Go to your Applications. Within Applications, open the Utilities folder. Locate Terminal in the Utilities folder and open it.
  2. Use the Mac ‘Spotlight’ computer search function. Search for: Terminal and press Return.

How to Use Terminal on a Mac

Windows

Computers with Windows operating systems do not automatically have a Unix Shell program installed. In this lesson, we encourage you to use an emulator included in Git for Windows, which gives you access to both Bash shell commands and Git. If you are attending a Software Carpentry workshop session, it is likely you have already received instructions on how to install Git for Windows. Once installed, you can open a terminal by running the program Git Bash from the Windows start menu.

Other solutions are available for running Bash commands on Windows. There is now a Bash shell command-line tool available for Windows 10. Additionally, you can run Bash commands on a remote UNIX computer or server from your Windows machine. This can be done through a Secure Shell (SSH) client. One such client available for free for Windows computers is PuTTY. See the reference below for information on installing and using PuTTY, using the Windows 10 command-line tool, or installing and using a UNIX/Linux emulator.

How to Install Bash shell command-line tool on Windows 10 Install and Use the Linux Bash Shell on Windows 10

You should also install PuTTY for accessing remote servers

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 • 2018 • bootcamp-central via pyblue