"Quick Start" options

For a "quick start" without wait time for us to create a Collab for you we have these options:

A non-persistent "quick first look"

This method is non-persistent = whatever you change in the example notebooks **will be lost** when the session expires.

It is useful for a get-an-impression-fast: 

• For BrainScaleS: Access this URL 
  This automatically clones the BrainScaleS example notebooks (from github) into a lab session into a non-persistent location and opens the tutorial index notebook.
  You can also directly jump to e.g. the single neuron notebook or the learning with superspike notebook.
  To run the notebook cells use the "Run" menu item. To execute all cells of the notebook use the "Run > Run all" menu item in the Jupyter window.
   
• For SpiNNaker: Access this URL
  This automatically clones an example notebook for running a "synfire chain" on SpiNNaker (from github) into a lab session into a non-persistent location and opens it.
  To run the notebook cells use the "Run" menu item. To execute all cells of the notebook use the "Run > Run all" menu item in the Jupyter window.

Notes:

• if a fresh "lab session" is started for your user you will be asked, which container should be started. Please select the one marked "recommended".
• a "lab session" will be automatically terminated after some hours of inactivity. At that event the notebooks cloned via the access URL above will be deleted = any changes you entered will be lost = great for a quick "first look", but not so great for longer term research ... 
  To be able to keep changes, please use the method described below (with an own "Collab") 

Getting the example notebooks into an own Collab

This method allows you to also change the example notebooks and keep the changes

1. create a new Collab for yourself:
   1. go to https://wiki.ebrains.eu/ and click the "Log-in" link in the upper right hand corner, log in with your new EBRAINS account
   2. Click the "Collabs" link in the menu bar at the top of the window
   3. Click the "Create a collab" green button and create a private Collab for yourself. The process re-directs you into your own, new Collab.  
       
2. In your new Collab open the Lab and clone the files you want to work with:
   1. Click the "Lab" link in the left hand menu
      
   2. Select any of the "Lab Execution Site" offered, (e.g. Jülich)
      
      then select the "Official EBRAINS Docker image", click start. (Click "Launch Server", if you get a "Server not running" page)
      This will start a Jupyter Lab session (the "Lab") for you. 
       
   3. Start a "Terminal" via the icon in the "Launcher window" shown. This opens a terminal in the  "/mnt/user/shared/NAME_OF_YOUR_COLLAB/" directory. This is a location on the EBRAINS "Drive". Files stored in this location are stored persistently = will still be there, when you open your Collab again some days later 
      Note: If you use "File" > "New" > "Terminal" the opened terminal is in the directory "/opt/app-root/src". This location only exists while the Jupyter ("Lab") session is running and will be gone, when a new Lab session is started. Do not use this location, if you want to keep the files. To change into the persistent directory type "cd /mnt/user/shared/NAME_OF_YOUR_COLLAB" (without the " and the name of your your Collab instead of NAME_OF_YOUR_COLLAB. The collab name in the screenshot is "20250709-testCollab")
      
       
   4. then fetch the files you would like to work with.
      
      For the BrainScaleS-2 interactive notebooks use the command in the terminal window: 
      git clone https://github.com/electronicvisions/brainscales2-demos.git --branch jupyter-notebooks-experimental
      
      
      The command clones the BrainScaleS interactive notebooks into a directory "brainscales2-demos". This directory appears then in the files list on the left hand side of the window. Double click it to enter the freshly cloned directory with tutorial notebooks.
      To see an overview, open the "tutorial.ipynb"
      
      Run the notebooks of your choice...
      
      
      For SpiNNaker example notebooks use the command in the terminal window:
      git clone https://github.com/SpiNNakerManchester/SpiNNakerJupyterExamples.git
      This creates the SpiNNakerJupyterExamples directory.
      First run the "Setup" notebook in the directory (choose the "EBRAINS-...." kernel, when asked), select "Run" > "Run all cells" 
      Then your environment is prepared to run the examples (e.g. the 01.RuningPyNNSimulations").
      Note: As Kernel (right hand corner of the title line of the notebook), please use the "EBRAINS-...." kernel, not the default iPython Kernel. Some modules will not be found with the default kernel.