An exercise...

Author: pgleeson

Exercises/Exercise1_NeuroMorpho_to_OSB.md

@@ -28,22 +28,58 @@ Applications), go to "System" -> "Library" -> "CoreServices" and pick "Java Web
 If there is still an issue, just download the SWC version of the morphology (via **Morphology File (Standardized)**)
 or get a copy of the NeuroML 2 file [here](files/A1-May29-IR2-3-G.cell.nml).
 
+
+
 #### 2. Set up user account on GitHub
 
- ... 
+Get a user account on GitHub: https://github.com/join
+
+
+
+#### 3. Add NeuroML file to new repository
+
+Create a new repository (green button on GitHub homepage after you're logged in), 
+e.g. named **Test_OSB_NeuroMorpho**. Select **Initialize this repository with a README**
+
+Add the downloaded file(s) to your repository. Select **Upload files** and choose
+the *.nml file (or the *.swc file, or both) and add then to the repository
+
+
+
+#### 4. Sign up to Open Source Brain
+
+Get an account at http://www.opensourcebrain.org/account/register. 
+
+If you have been given an Activation token for joining OSB (which allows you to 
+skip the step of waiting for OSB admins to approve your account) enter it here.
+
+Once your account is approved & you log in, you can enter your GitHub usename
+(and other details) on your account settings page (click your username on top right & 
+hit **Edit**)
+
+#### 5. Create new project on OSB
+
+Go back to the home page and click **New project** and enter the URL of your repository 
+on GitHub. This can be found by clicking the green button **Clone or download** on
+GitHub, it will be of the form https://github.com/MYUSERNAME/Test_OSB_NeuroMorpho.git.
+
+Enter a name for your project and select **Create**.
 
-- Add NML file to new repository
+#### 6. Visualise cell in 3D
 
-... 
+On the homepage of your new project there will be a button to **Explore model** which
+should find the first *.nml model in your Github repository. If there are many or 
+none (i.e. only SWC) you can also click **More** and this will list all the files 
+in the repo that OSB recognises. 
 
-- Sign up to Open Source Brain
+When the 3D scene loads there will be an option to follow a guided tour of the 
+OSB interface. You can follow this, or close the dialog and open it later by pressing the 
+book icon on the left.
 
-... 
+You should see something like the following when the cell is visualised (and **Model 
+description** pressed):
 
-- Create new project on OSB
+![OSB](images/osb1.png)
 
-...
 
-- Visualise cell in 3D
 
-... 

Exercises/README.md

@@ -1,7 +1,10 @@
-## A number of potential exercises for participants in this Neuroinformatics tutorial
+## A number of exercises for participants in this Neuroinformatics tutorial
 
 #### Exercise 1
-...
+
+Cell morphology from NeuroMorpho.Org visualised on Open Source Brain
+
+[Follow this exercise](Exercise1_NeuroMorpho_to_OSB.md)
 
 #### Exercise 2
 ...