Homework 1: Using GitHub

This assignment is due by 11:59PM ET 2/2.

Overview

This assignment will familiarize you with using Git to submit your assignments.

Fork

Sign in to this website with your NetID to create your UConn Enterprise GitHub account.
Click the button at the top right of the page to copy this repository to your account. After clicking fork, the page will refresh and display your copy of the repository. By default, your new repository will be located at https://github.uconn.edu/NetID/hw1. The repository name in the upper left will indicate that it is a fork: .

Clone

Using the command line

If you use Windows, try the GitHub Desktop directions below

From your fork, click the green Clone or download button and copy the displayed URL
At your command line prompt (e.g. /Applications/Utilities/Terminal) type git clone followed by the URL you just copied and press return.
You now have a local repository to work with. Type pwd to see where the repository is located on your computer or open hw1 to open a Finder window.

If you get the error message git: command not found, you may need to install git.

Using GitHub Desktop

As an alternative to the command line, you can also use a graphical interface. We'll use the free GitHub Desktop

Download and install GitHub Desktop
Open GitHub Desktop and sign in to GitHub Enterprise with the address https://github.uconn.edu
After setup, select the option to Clone a repository and select the GitHub Enterprise Server tab. Select your NetID/hw1 repository, choose a directory to save the repository on your computer, and click Clone.

Install required software

Please download and install the following required software:

A code editor (e.g. Visual Studio Code or Sublime
Connectome Workbench for viewing MRI data
Globus Connect Personal for transferring files to the compute cluster. You may need to be on the campus netwokr to access this site.
Python 3.7 Anaconda distribution
For Windows users, you need an SSH client such as PuTTY.

Create accounts

Neuroimaging analysis takes lots of computing time. You’ll want to run some of your analysis on the UConn Storrs HPC cluster, for which you’ll need to request an account. You can find your advisor’s NetID at http://phonebook.uconn.edu.
Once you get your account, make sure you can SSH to the cluster as described here

Learn Bash

Work through the 4 free modules of Learn the Command Line on Codeacademy. Don't just copy and paste commands in the lessons—type them out.

Learn Git

Work through the 4 free modules of Learn Git on Codeacademy.

Edit this file

Open this file (README.md) in your favorite code editor. Do not use a word processor to edit files for this course! Word processors can introduce special characters that will break scripts.

Check off the steps you completed

This file (README.md) is written in Markdown. GitHub will automatically show any file named README.md as a webpage when viewed on Github.com using Github-flavored Markdown.

When you see this online, you should see that the steps you need to complete have empty checkboxes like this:

[ ]

In Markdown, a checkbox is a special list element written as:

- [ ] Todo Item 1
- [ ] Todo Item 2

To tick the checkbox, write an x between the brackets, like this:

- [x] Todo Item 1
- [x] Todo Item 2

which appears like so:

Todo Item 1
Todo Item 2

Tick the boxes for all the steps you have completed.

Describe any installation issues

Sometimes installation instructions can be a bit vague. Use Markdown to add a bulleted list here of any problems you encountered and how you solved them here:

Rank order your presentation preference

Rearrange the lines below to reflect your preference for the pipeline presentation, from most to least favored:

Human Connectome Project
fmriprep
ciftify

Submit the assignment

Using the command line

cd to the hw1 directory you created when you cloned your fork.
Using git, commit your changes to this file (remember to git add your files first).
Using git, push your code to your forked repository.
On GitHub, create a pull request to submit your work.

using GitHub Desktop

The lefthand pane will show any new or modified files in your workspace. README.md should have a yellow icon, indicating it has uncommited changes.
Click Commit to master to commit changes to your local repository
Click Push origin to send your changes to your remote repository
On GitHub, create a pull request to submit your work.

bso15101/hw1

About

Resources

Stars

Watchers

Forks

Releases