29 lines
753 B
Plaintext
29 lines
753 B
Plaintext
|
== Working with notebooks
|
||
|
|
||
|
=== !
|
||
|
|
||
|
Notebooks are a powerful tool for scientific programming
|
||
|
|
||
|
* Lets you keep a detailed record of your work
|
||
|
* Everything is in one place
|
||
|
* Allows interactive code and data exploration
|
||
|
* Easy to share
|
||
|
|
||
|
=== how to work with notebooks?
|
||
|
|
||
|
[%step]
|
||
|
* **Plot everything**
|
||
|
* Write detailed explanations of what you do, and why
|
||
|
** Unless you have a very specific kind of reader, explain also "well known" methods
|
||
|
** Btw, learn Markdown
|
||
|
* Keep your notebooks reasonably short
|
||
|
* Create different notebooks for different aims
|
||
|
* Refactoring usually means taking the code and putting it auxiliary files
|
||
|
|
||
|
//---------------------------------------------------------
|
||
|
|
||
|
=== Guided example: Machine learning workflow
|
||
|
|
||
|
image::xl23h24nc.jpg[]
|
||
|
|