Skip to content

Commit

Permalink
Update course book
Browse files Browse the repository at this point in the history
  • Loading branch information
actions-user committed Feb 14, 2024
1 parent d5f7a6b commit fe78469
Show file tree
Hide file tree
Showing 532 changed files with 327,629 additions and 348,661 deletions.
2 changes: 1 addition & 1 deletion .buildinfo
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 1d4a1935b67cccc1c42ac01a9e6bf7f4
config: dcb6df3bbe47ae3ebb09ac24b30d02cf
tags: 645f666f9bcd5a90fca523b33c5a78b7
File renamed without changes
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file removed _images/Bonus_Tutorial1_28_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_28_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_53_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_54_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_54_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_56_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_57_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_57_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_58_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_59_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_59_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_65_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_66_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_76_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_77_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_77_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_77_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_78_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_84_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_84_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_84_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_85_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_87_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_88_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_89_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_91_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_92_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_93_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial1_93_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial2_35_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial2_47_11.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial2_50_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial2_50_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial2_50_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_22_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_22_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_22_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_28_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_28_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_28_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_30_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_32_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_33_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_33_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_33_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_33_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_35_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_40_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_40_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_40_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_40_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_42_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_43_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_43_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_43_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_43_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_44_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_49_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_49_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_49_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_49_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_51_6.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_52_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_52_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_52_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_52_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_53_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_57_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_58_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_58_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_58_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_64_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_65_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_65_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_65_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_65_3.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_65_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_69_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_69_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_70_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_70_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_72_4.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_74_0.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_74_1.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_74_2.png
Diff not rendered.
Binary file removed _images/Bonus_Tutorial3_74_3.png
Diff not rendered.
Binary file removed _images/TrainIllusionDataProject_34_0.png
Diff not rendered.
Binary file removed _images/TrainIllusionModel_14_1.png
Diff not rendered.
Binary file removed _images/TrainIllusionModel_18_1.png
Diff not rendered.
Binary file removed _images/TrainIllusionModel_31_0.png
Diff not rendered.
Binary file removed _images/TrainIllusionModel_37_0.png
Diff not rendered.
Binary file removed _images/W0D4_Tutorial1_107_1.png
Diff not rendered.
Binary file removed _images/W1D2_Tutorial3_38_1.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_22_1.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_53_0.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_64_0.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_67_0.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_69_0.png
Diff not rendered.
Binary file removed _images/W1D3_Tutorial2_75_0.png
Diff not rendered.
Binary file removed _images/W1D5_Tutorial1_25_0.png
Diff not rendered.
Binary file removed _images/W1D5_Tutorial3_62_0.png
Diff not rendered.
Binary file removed _images/W1D5_Tutorial4_21_0.png
Diff not rendered.
Binary file removed _images/W2D4_Tutorial2_59_1.png
Diff not rendered.
Binary file removed _images/W3D4_Tutorial2_47_1.png
Diff not rendered.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes

This file was deleted.

This file was deleted.

29 changes: 23 additions & 6 deletions _sources/projects/docs/project_guidance.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,16 @@ Finally, in W3D5 you will meet with other groups in your pod and megapod (organi
* You should use the project templates extensively if you are new to neuroscience and/or you don’t have a lot of research experience. They have been designed to give you enough structure to get started, and enough options to keep you going if you stick with the template. Or you may start with a template, use it the first week and then in the second week diverge from it as your group develops their own new idea or question to test.
* Templates have a natural flow of questions, but don’t hesitate to skip or completely change some of these. They are meant to be used very flexibly!

## Project TAs

Project TAs are your friendly dataset experts to consult with on all issues related to datasets. They can also help with other aspects of a project, including brainstorming, literature searches and coding. You will have meetings with them approximately every two days. During this time, they will help you refine your question and hypothesis into something that can be answered with our datasets. Since they can arrive unannounced at any time (busy schedules!), please stop what you were doing to have the meeting, and then resume your work when the project TA leaves.

For the assigned meetings, project TAs will generally come only during project times, but sometimes they might need to schedule meetings slightly earlier or later. We encourage you to reach out to them for extra meetings whenever you need them, and to post questions on discord in the #dataset-X channels.

## Project Mentors

Project mentors are more senior figures in the field, typically senior postdocs, professors, or industry researchers. Each project group will have a mentor to help them refine their hypotheses and navigate the scientific process. They won't be around as often as the TAs, but they are another source of guidance and perspective.

## Week 1: Getting started

Depending on your time slot, you may or may not have project time on the first day of the course. Regardless of whether your first project meeting is day 1 or day 2, spend your first session doing the following:
Expand All @@ -37,13 +47,15 @@ Tips:
* No need to have a very concrete project after this day. You will determine the feasibility of your questions in the next few days, and you will likely change your question completely. That’s how research works!
* The exploratory work you do in week 1 will culminate in a project proposal on the first project day (peek ahead in this guide at W2D1).

*Stay tuned for your mentor assignments. Once you receive them, reach out to your mentor to set up a first meeting this week. Also try to arrange a meeting for W2D1, ideally the second half of the day, when their feedback on your abstract could be useful.*

### W1D2
Continue brainstorming! Try to come up with one or a few topics of interest, either by yourselves or directly from the project templates. Get your hands dirty by running some of the notebooks provided for your dataset. There should be a loading notebook, and there should be some further analysis notebooks interspersed among the project templates. Even if you are not using a project template, they are likely to contain useful code to get you started, especially if you are doing a theory project. If all you do is run the provided notebooks that’s fine! Try to understand what is being plotted and how. Pay attention to the code libraries being used, and the way the data is accessed / binned / aligned. You will reuse some of these code elements to start doing your own analyses in later days.

### W1D3-W1D5
Be on the lookout for interesting hypotheses. You might notice something unexpected in the data, and if you dig deeper it might lead you directly to a result. For this to work, you must keep an open mind about what your questions are. Here are some generally useful tips & tricks:

* The hardest part will be the technical challenge of wrestling with the data to try to answer your question. You can rely on your TA and the Discord channels to make this process easier.
* The hardest part will be the technical challenge of wrestling with the data to try to answer your question. You can rely on your TA, the dedicated project TA and the Discord channels to make this process easier.
* For theory projects, wrestling with your model can be equally challenging. If your model generates data, for example a neural network simulation, then you can still use some of the tricks below to analyze that data.
* If your model makes a hypothesis that needs to be tested, then your theory project might become a data project. The opposite may also happen if you find something interesting in the data, and you realize that you need a model to understand it better.
* Always be on the lookout for bugs in your code, or ”bugs” in your analysis plan. If a result looks too good to be true, it might be! Make sure you always split your data train/test, even for simple analyses where you think it might not matter (i.e. for making tuning curves).
Expand Down Expand Up @@ -95,7 +107,7 @@ You should now have a sense of the data, and you have probably refined your hypo

### W2D5: Abstract Writing Day!

One of the best ways to understand your own research is to try to write about it. You should write early and often, not just at the end when you’re trying to write a paper or your thesis. Science conferences are a great way to present your intermediate work, and they give you a chance to write an abstract. However, you don’t have to wait so long to write your project abstract, you’ll do it today! If you have preliminary results that’s great, but it’s not required. Most of the components of an abstract do not in fact require results. The goal for this day is to workshop your abstract with your group, and then present this to your entire pod. You can also think of it as a much more refined version of the project proposal you submitted originally.
One of the best ways to understand your own research is to try to write about it. You should write early and often, not just at the end when you’re trying to write a paper or your thesis. Science conferences are a great way to present your intermediate work, and they give you a chance to write an abstract. For example, the Neuromatch Conferences are a great venue for this. However, you don’t have to wait so long to write your project abstract, you’ll do it today! If you have preliminary results that’s great, but it’s not required. Most of the components of an abstract do not in fact require results. The goal for this day is to workshop your abstract with your group, and then present this to your entire pod. You can also think of it as a much more refined version of the project proposal you submitted originally.

If you have been using a project template, this is a good time to branch out and pursue your own questions. The template was only meant to get you started on some concrete analyses, so that you become familiar with the data, but now that you have more knowledge, you should be able to come up with your own question. Practice the 4-steps again if necessary, they should be easier once you have a good question.

Expand All @@ -115,6 +127,10 @@ With your group
* (30-60 min) Edit the abstract individually in your own google doc. At this stage, it is also important to control the flow of the abstract, in addition to keeping the structure from the 10 rules-paper. The flow relates to the “writing style”, which is generally no different for scientists than for other writers. Most importantly, make sure each sentence continues from where the previous one left, and do not use jargon without defining it first. Check out this book about writing if you have time ([book](https://sites.duke.edu/niou/files/2014/07/WilliamsJosephM1990StyleTowardClarityandGrace.pdf), especially chapter 3 about "cohesion" and flow.
* (30 min) You should now have as many copies of your abstract as there are students in your group. Put them all into the same google doc, and try to see what you all did the same / differently. What sounds better? Pick and choose different sentences from different abstracts.


With your mentor (timing is not precise!)
* (30-60min) Try to schedule a meeting with your mentor to be on this day or next day. Show them your abstract. Try to get explicit feedback and edit the abstract together in a google doc.

* (30min / group = 1h) With your pod: present your research to the other group in your pod. Take turns in your pod to read each other’s abstracts and provide feedback on them. Tell the other group what you understand and what you don’t from their research project. Give detailed writing feedback if you can (use "suggestion mode" in google docs). If there is no other project group in your pod, ask your TA to reach out to other pods to find a group you can workshop your abstract with.

Back in your group
Expand Down Expand Up @@ -160,7 +176,7 @@ Abstract writing day should have helped you narrow down what results (positive o

Please see final day schedule and shared calendars for timing details: [https://compneuro.neuromatch.io/tutorials/Schedule/daily_schedules.html#w3d5-final-day-of-course](https://compneuro.neuromatch.io/tutorials/Schedule/daily_schedules.html#w3d5-final-day-of-course)

This is the day where you present your project to other groups. The groups will take turns to share their screens. You can use figures and other graphics, but this is meant to be told as a story, and everyone from your group should take a turn telling a part of the story. Tell us about the different hypotheses you’ve had at different points and how you refined them using some of the tools we taught.
This is the day where you present your project to other groups. Your mentor and your project TAs can be invited too, but they are busy so they might not make it. The groups will take turns to share their screens. You can use figures and other graphics, but this is meant to be told as a story, and everyone from your group should take a turn telling a part of the story. Tell us about the different hypotheses you’ve had at different points and how you refined them using some of the tools we taught.

At the end of your last project block, you should also submit your slides via this [Airtable link](https://airtable.com/shrvoz2N9UulAVqqU).

Expand All @@ -181,9 +197,10 @@ At the end of your last project block, you should also submit your slides via th

### Logistics:

* Neuromatch Staff will send a Zoom link for your megapod and then create breakout rooms for a subgroup of project groups (about 4-5 groups each).
* timeslots 4: the last hour of project time (check the shared calendars in jupyterbook).
There is a hard cutoff at the one hour mark.
* The lead TA for your megapod will make multiple subgroups of 4-5 research teams from across the entire megapod. Each subgroup gets a separate breakout room for their session. If there are too many large pods in the megapod, there may be multiple zoom links in the megapod, so make sure you have the right one for your group.
* timeslots 1,3,5: last hour of project time, -1:00 to 0:00 relative to start of your normal tutorial time (check the shared calendars in jupyterbook).
* timeslots 2,4: after the course feedback session (check the shared calendars in jupyterbook).
There is a hard cutoff at the one hour mark, so the TAs must ensure everyone gets a turn to present.

* Use this presentation style ([google slides](https://docs.google.com/presentation/d/1A1uaYarVot9YyCdbAAB4VDvsQfK6emqq-TwIZ9xVNwo/edit?usp=sharing) or [powerpoint](https://osf.io/ky6fj/download)) or create your own style!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,8 @@
"\n",
"The primary task is to reconstruct output images based on a compressed representation of the inputs. This task teaches the network which details to throw away while still producing images that are similar to the inputs.\n",
"\n",
" \n",
"\n",
"A fictitious *MNIST cognitive task* bundles more elaborate tasks such as removing noise from images, guessing occluded parts, and recovering original image orientation. We use the handwritten digits from the MNIST dataset since it is easier to identify similar images or issues with reconstructions than in other types of data, such as spiking data time series.\n",
"\n",
" \n",
Expand Down Expand Up @@ -1258,7 +1260,7 @@
"\n",
"*Example output:*\n",
"\n",
"<img alt='Solution hint' align='left' width=1132.0 height=575.0 src=https://raw.githubusercontent.com/NeuromatchAcademy/course-content/main/tutorials/Bonus_Autoencoders/static/Bonus_Tutorial1_Solution_c05ddd88_0.png>\n",
"<img alt='Solution hint' align='left' width=1127.0 height=578.0 src=https://raw.githubusercontent.com/NeuromatchAcademy/course-content/main/tutorials/Bonus_Autoencoders/static/Bonus_Tutorial1_Solution_c05ddd88_0.png>\n",
"\n"
]
},
Expand Down Expand Up @@ -2389,7 +2391,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.9.18"
"version": "3.9.17"
}
},
"nbformat": 4,
Expand Down
Loading

0 comments on commit fe78469

Please sign in to comment.