Skip to content

Commit

Permalink
Add tech help docs (NeuromatchAcademy#617)
Browse files Browse the repository at this point in the history
* Add tech help

* Add sponsors to intro page

* Delete Tutorial_kaggle.md
  • Loading branch information
ebatty authored Jun 25, 2021
1 parent 7dc3fb6 commit 89ca9c9
Show file tree
Hide file tree
Showing 6 changed files with 35 additions and 10 deletions.
6 changes: 5 additions & 1 deletion book/intro.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# Introduction

Welcome to the Neuromatch computational neuroscience course!
Welcome to the Neuromatch computational neuroscience course!

**Thanks to our 2021 Sponsors, including Presenting Sponsor Facebook Reality Labs!**

<p align='center'><img src='https://github.com/NeuromatchAcademy/widgets/blob/master/sponsors.png?raw=True'/></p>
3 changes: 3 additions & 0 deletions tutorials/TechnicalHelp/Discord.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Using discord

[Please click here for Discord Guide](https://docs.google.com/document/d/1d8WByqS62LeoHgqY65Zy1TVbO4HG9BRdDgWg81jeaQY/edit)
5 changes: 5 additions & 0 deletions tutorials/TechnicalHelp/Jupyterbook.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Using jupyterbook

While you can see videos and the notebooks in this jupyterbook,
you have to launch each page in an interactive environment
in order to write or run code.
9 changes: 9 additions & 0 deletions tutorials/TechnicalHelp/Tutorial_colab.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Using Google Colab

If you have access to Google Colab,
you can click the "Open in Colab" button at the top of each page to launch it in an interactive environment where you can write and run code.

## Advice for using Colab
* Make a local copy to your Drive: otherwise changes you make (e.g. notes you take, code you write, etc) will not be saved
* Do not edit the same colab directly as a group. Unlike Google Docs, one person's version will overwrite another's. If your browser happens to be open, it can overwrite anything that has been done by others since the last version in your browser!
* Colab does not have version control! Use git for this if you want to collaborate (on a group project colab for example)
Original file line number Diff line number Diff line change
@@ -1,25 +1,28 @@
# Steps to run notebooks on Kaggle with GPU support
# Using Kaggle

If you are in China or another region with difficult
access to Google Colab, you can use Kaggle as a substitute for launching an interactive coding environment where you can write and run code. Please note that we recommend Google colab if you can access it.

## STEPS:
1. First, [sign in](https://www.kaggle.com/account/login) to your Kaggle account. If you don't have a Kaggle account, create one by registering for it by clicking [here](https://www.kaggle.com/account/login?phase=startRegisterTab&returnUrl=%2F).
![Step 1](../tutorials/static/kaggle_step1.png)
![Step 1](../static/kaggle_step1.png)

2. Once you're logged into your account, head over to the left sidebar menu and click on the **Code** section.
![Step 2](../tutorials/static/kaggle_step2.png)
![Step 2](../static/kaggle_step2.png)

3. Then, click on the **New Notebook** button on the page.
![Step 3](../tutorials/static/kaggle_step3.png)
![Step 3](../static/kaggle_step3.png)

4. In the **File** menu bar, select **Upload Notebook** option.
![Step 4](../tutorials/static/kaggle_step4.png)
![Step 4](../static/kaggle_step4.png)

5. Next, select **Upload via external URL** option, and input the url of the notebook. For instance, if you wish you run [W2D1_Tutorial.ipynb](https://github.com/NeuromatchAcademy/course-content/blob/master/tutorials/W2D1_DeepLearning/W2D1_Tutorial1.ipynb) get its corresponding link (https://github.com/NeuromatchAcademy/course-content/blob/master/tutorials/W2D1_DeepLearning/W2D1_Tutorial1.ipynb), and then select **Upload** button to import the notebook on Kaggle.
![Step 5](../tutorials/static/kaggle_step5.png)
5. Next, select **Upload via external URL** option, and input the url of the notebook. For instance, if you wish to run [W2D1_Tutorial.ipynb](https://github.com/NeuromatchAcademy/course-content/blob/master/tutorials/W2D1_DeepLearning/W2D1_Tutorial1.ipynb) get its corresponding link (https://github.com/NeuromatchAcademy/course-content/blob/master/tutorials/W2D1_DeepLearning/W2D1_Tutorial1.ipynb), and then select **Upload** button to import the notebook on Kaggle.
![Step 5](../static/kaggle_step5.png)

6. The last and final step but important **step** about how to leverage **GPU** accelerator in the kaggle kernel. To get access to the GPU, first time users have get their phone numbers verified. In order to have GPU access, on the left sidebar of the notebook under the settings panel, go to **Get phone verified** link and enter your credentials.


![Step 6.1](../tutorials/static/kaggle_step6_1.png)
![Step 6.1](../static/kaggle_step6_1.png)

Once your phone number has been verified, on the left sidebar under **Settings** panel, select **Accelerator** to **GPU** from **None** using the drop down menu.
![Step 6.2](../tutorials/static/kaggle_step6_2.png)
![Step 6.2](../static/kaggle_step6_2.png)
1 change: 1 addition & 0 deletions tutorials/TechnicalHelp/tech_intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Technical Help

0 comments on commit 89ca9c9

Please sign in to comment.