Skip to content

Commit 514148e

Browse files
author
giumas
committed
modified help email + added Piazza.com exercise to 000
1 parent 8f4bc66 commit 514148e

18 files changed

+140
-97
lines changed

‎000_Welcome_on_Board.ipynb

Lines changed: 75 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -84,22 +84,6 @@
8484
"An `i` within a yellow circle indicates **supplemental information**. Thus, you may decide to skip these parts at a first read. "
8585
]
8686
},
87-
{
88-
"cell_type": "markdown",
89-
"metadata": {},
90-
"source": [
91-
"In case that you have questions and comments about the notebooks: "
92-
]
93-
},
94-
{
95-
"cell_type": "markdown",
96-
"metadata": {},
97-
"source": [
98-
"<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/help.png\">\n",
99-
"\n",
100-
"A red megaphone at the top-right corner of each notebook provides a link to [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). "
101-
]
102-
},
10387
{
10488
"cell_type": "markdown",
10589
"metadata": {},
@@ -331,7 +315,7 @@
331315
"source": [
332316
"The following cell is a **Code** cell. You can recognize a **Code** cell since it has a `In [ ]` to the far left. \n",
333317
"\n",
334-
"This **Code** cell does the very basic task of printing a \"Hello Python\" text. The next notebooks will introduce the main concepts of programming with Python. At this time, you will learn to execute the code in a **Code** cell:\n",
318+
"This **Code** cell does the very basic task of printing a `\"Hello Python\"` text. The next notebooks will introduce the main concepts of programming with Python. At this time, you will learn to execute the code in a **Code** cell:\n",
335319
"\n",
336320
"- Activate the following Code cell by clicking in it.\n",
337321
"- Click the <button class='btn btn-default btn-xs'><i class=\"icon-step-forward fa fa-step-forward\"></i></button> Run button in the Toolbar (or, alternatively, press `Shift+Enter`) like you did for the **Markdown** cell."
@@ -350,7 +334,7 @@
350334
"cell_type": "markdown",
351335
"metadata": {},
352336
"source": [
353-
"If you got a \"Hello Python\" text under the **Code** cell, *congratulations!* You have successfully executed the Python code."
337+
"If you got a `Hello Python` text under the **Code** cell, *congratulations!* You have successfully executed the Python code."
354338
]
355339
},
356340
{
@@ -516,7 +500,7 @@
516500
},
517501
"outputs": [],
518502
"source": [
519-
"print('Python is easy to learn!')"
503+
"print(\"Python is easy to learn!\")"
520504
]
521505
},
522506
{
@@ -681,6 +665,77 @@
681665
"***"
682666
]
683667
},
668+
{
669+
"cell_type": "markdown",
670+
"metadata": {},
671+
"source": [
672+
"## Questions or Comments?"
673+
]
674+
},
675+
{
676+
"cell_type": "markdown",
677+
"metadata": {},
678+
"source": [
679+
"These notebooks have a virtual gathering place on [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home) where you can ask (but also answer!) questions to instructors and fellow students."
680+
]
681+
},
682+
{
683+
"cell_type": "markdown",
684+
"metadata": {},
685+
"source": [
686+
"<a href=\"https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home\"><img src=\"images/000_200_piazza_com.png\" title=\"Open Piazza.com\" align=\"center\" width=\"60%\" alt=\"Piazza.com\\\"></a>"
687+
]
688+
},
689+
{
690+
"cell_type": "markdown",
691+
"metadata": {},
692+
"source": [
693+
"<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/help.png\">\n",
694+
"\n",
695+
"A red megaphone at the top-right corner of each notebook provides a link to [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). "
696+
]
697+
},
698+
{
699+
"cell_type": "markdown",
700+
"metadata": {},
701+
"source": [
702+
"If you click on this [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home) link, you can register yourself as a student to access the virtual gathering place.\n",
703+
"\n",
704+
"Once registered, what about introducing yourself to the community?"
705+
]
706+
},
707+
{
708+
"cell_type": "markdown",
709+
"metadata": {
710+
"solution2": "hidden",
711+
"solution2_first": true
712+
},
713+
"source": [
714+
"<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/test.png\">\n",
715+
"\n",
716+
"Add a note containing your self-introduction in the \"community\" folder on [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). The following image shows how to do it in eight steps. Feel free to customize the text in the note as you prefer!\n",
717+
"<br><br>\n",
718+
"![Seven steps for a self-introduction note](images/000_250_eight_steps.png)"
719+
]
720+
},
721+
{
722+
"cell_type": "markdown",
723+
"metadata": {
724+
"solution2": "hidden"
725+
},
726+
"source": [
727+
"If you follow the eight steps, the result will be a note similar to the following one (but with your specific details):\n",
728+
"\n",
729+
"![Note example](images/000_280_note_example.png)"
730+
]
731+
},
732+
{
733+
"cell_type": "markdown",
734+
"metadata": {},
735+
"source": [
736+
"***"
737+
]
738+
},
684739
{
685740
"cell_type": "markdown",
686741
"metadata": {},
@@ -715,7 +770,7 @@
715770
"source": [
716771
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
717772
"\n",
718-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
773+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
719774
]
720775
},
721776
{

‎001_Variables_and_Types.ipynb

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@
4242
"- The first character **cannot be a number** (Python generates a `SyntaxError`).\n",
4343
"- By convention (as defined in the [PEP8](https://www.python.org/dev/peps/pep-0008/) coding style):\n",
4444
" - Variable names **start with a lower-case letter**. \n",
45-
" - The underscore character `_` is used in names composed of multiple words to separate them."
45+
" - The underscore character `_` is used in names composed of multiple words to separate them (this convention is called [**snake_case**](https://en.wikipedia.org/wiki/Snake_case))."
4646
]
4747
},
4848
{
@@ -427,7 +427,23 @@
427427
"cell_type": "markdown",
428428
"metadata": {},
429429
"source": [
430-
"- The `//` operator is used to calculate the quotient of an [Euclidean division](https://en.wikipedia.org/wiki/Euclidean_division), that is to divide two numbers and then round down the result to an integer. For examples:"
430+
"- The `//` operator is used to calculate the quotient of an [Euclidean division](https://en.wikipedia.org/wiki/Euclidean_division), that is to divide two numbers and then round down the result to an integer. "
431+
]
432+
},
433+
{
434+
"cell_type": "markdown",
435+
"metadata": {},
436+
"source": [
437+
"<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/info.png\">\n",
438+
"\n",
439+
"The `//` operator is also known as *floored division* and *integer division*."
440+
]
441+
},
442+
{
443+
"cell_type": "markdown",
444+
"metadata": {},
445+
"source": [
446+
"The following example uses the `//` operator:"
431447
]
432448
},
433449
{
@@ -1016,7 +1032,7 @@
10161032
"source": [
10171033
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
10181034
"\n",
1019-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
1035+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
10201036
]
10211037
},
10221038
{

‎002_Lists_of_Variables.ipynb

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@
9393
"cell_type": "markdown",
9494
"metadata": {},
9595
"source": [
96-
"It is possible to create and populate a list simply by enclosing the values in **square** brackets, `[` and `]`:"
96+
"It is possible to create and populate a list simply by enclosing the values in **square** brackets (i.e., `[` and `]`) and separating them using `,`:"
9797
]
9898
},
9999
{
@@ -614,7 +614,7 @@
614614
"cell_type": "markdown",
615615
"metadata": {},
616616
"source": [
617-
"For instance, the `remove()` method is used to remove a given element from a `list`. \n",
617+
"For instance, the `remove()` method is used to remove the **first** element with a given value from a `list`. \n",
618618
"\n",
619619
"The code in the cell below displays two numbers: \n",
620620
"\n",
@@ -801,7 +801,7 @@
801801
"source": [
802802
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
803803
"\n",
804-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
804+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
805805
]
806806
},
807807
{

‎003_Conditional_Execution.ipynb

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -356,6 +356,16 @@
356356
"Comments do not need to be long (actually, verbose comments should be avoided!). Comments should be used in combination with meaningful variable names to clarify your intentions."
357357
]
358358
},
359+
{
360+
"cell_type": "markdown",
361+
"metadata": {},
362+
"source": [
363+
"There is a component of **subjectivity** in deciding when a comment is required. However, there should be always a comment when one of the following two cases applies:\n",
364+
"\n",
365+
"* The code is **complicated** (also when the reasons behind your implementation are clear). \n",
366+
"* The reasons behind your implementation might be **unclear** (even if the code is simple). "
367+
]
368+
},
359369
{
360370
"cell_type": "markdown",
361371
"metadata": {},
@@ -795,7 +805,7 @@
795805
"source": [
796806
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
797807
"\n",
798-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
808+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
799809
]
800810
},
801811
{

‎004_Loops.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -447,7 +447,7 @@
447447
"source": [
448448
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
449449
"\n",
450-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
450+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
451451
]
452452
},
453453
{

‎005_Write_Your_Own_Functions.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -505,15 +505,15 @@
505505
"source": [
506506
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
507507
"\n",
508-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
508+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
509509
]
510510
},
511511
{
512512
"cell_type": "markdown",
513513
"metadata": {},
514514
"source": [
515515
"<!--NAVIGATION-->\n",
516-
"[< Loops](004_Loops.ipynb) | [Contents](index.ipynb) | [Dictionaries >](006_Dictionaries.ipynb)"
516+
"[< Loops](004_Loops.ipynb) | [Contents](index.ipynb) | [Dictionaries and Metadata >](006_Dictionaries_and_Metadata.ipynb)"
517517
]
518518
}
519519
],

‎006_Dictionaries.ipynb renamed to ‎006_Dictionaries_and_Metadata.ipynb

Lines changed: 17 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@
210210
"cell_type": "markdown",
211211
"metadata": {},
212212
"source": [
213-
"## What is Metadata?"
213+
"# What is Metadata?"
214214
]
215215
},
216216
{
@@ -417,17 +417,9 @@
417417
},
418418
{
419419
"cell_type": "code",
420-
"execution_count": 28,
421-
"metadata": {},
422-
"outputs": [
423-
{
424-
"name": "stdout",
425-
"output_type": "stream",
426-
"text": [
427-
"The first name is: John\n"
428-
]
429-
}
430-
],
420+
"execution_count": null,
421+
"metadata": {},
422+
"outputs": [],
431423
"source": [
432424
"metadata = dict()\n",
433425
"metadata[\"first_name\"] = \"John\"\n",
@@ -444,18 +436,9 @@
444436
},
445437
{
446438
"cell_type": "code",
447-
"execution_count": 29,
448-
"metadata": {},
449-
"outputs": [
450-
{
451-
"name": "stdout",
452-
"output_type": "stream",
453-
"text": [
454-
"The position is: 43.135555, -70.939534\n",
455-
"Start time: 2019-02-22 12:32:40\n"
456-
]
457-
}
458-
],
439+
"execution_count": null,
440+
"metadata": {},
441+
"outputs": [],
459442
"source": [
460443
"metadata = dict()\n",
461444
"metadata[\"latitude\"] = 43.135555\n",
@@ -475,17 +458,9 @@
475458
},
476459
{
477460
"cell_type": "code",
478-
"execution_count": 33,
479-
"metadata": {},
480-
"outputs": [
481-
{
482-
"name": "stdout",
483-
"output_type": "stream",
484-
"text": [
485-
"The first name is: John\n"
486-
]
487-
}
488-
],
461+
"execution_count": null,
462+
"metadata": {},
463+
"outputs": [],
489464
"source": [
490465
"metadata = dict()\n",
491466
"metadata[\"first_name\"] = \"John\"\n",
@@ -495,18 +470,9 @@
495470
},
496471
{
497472
"cell_type": "code",
498-
"execution_count": 37,
499-
"metadata": {},
500-
"outputs": [
501-
{
502-
"name": "stdout",
503-
"output_type": "stream",
504-
"text": [
505-
"The position is: 43.135558, -70.939534\n",
506-
"Start time: 2019-02-22 12:32:40\n"
507-
]
508-
}
509-
],
473+
"execution_count": null,
474+
"metadata": {},
475+
"outputs": [],
510476
"source": [
511477
"metadata = dict()\n",
512478
"metadata[\"latitude\"] = 43.135558\n",
@@ -545,17 +511,9 @@
545511
},
546512
{
547513
"cell_type": "code",
548-
"execution_count": 41,
549-
"metadata": {},
550-
"outputs": [
551-
{
552-
"name": "stdout",
553-
"output_type": "stream",
554-
"text": [
555-
"The position is: 43.1356, -70.9395\n"
556-
]
557-
}
558-
],
514+
"execution_count": null,
515+
"metadata": {},
516+
"outputs": [],
559517
"source": [
560518
"metadata = dict()\n",
561519
"metadata[\"latitude\"] = 43.135558\n",
@@ -600,7 +558,7 @@
600558
"source": [
601559
"<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
602560
"\n",
603-
"*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
561+
"*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
604562
]
605563
},
606564
{

0 commit comments

Comments
 (0)