This assignment is due by 11:59PM ET 2/2.
This assignment will familiarize you with using Git to submit your assignments.
- 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: .
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 oropen hw1
to open a Finder window.
If you get the error message git: command not found
, you may need to install git.
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.
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.
- 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
- 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.
- Work through the 4 free modules of Learn Git on Codeacademy.
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.
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.
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:
Rearrange the lines below to reflect your preference for the pipeline presentation, from most to least favored:
- Human Connectome Project
- fmriprep
- ciftify
cd
to thehw1
directory you created when you cloned your fork.- Using git,
commit
your changes to this file (remember togit add
your files first). - Using git,
push
your code to your forked repository. - On GitHub, create a pull request to submit your work.
-
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.