source commit: d462d67

CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+---
+title: "Contributor Code of Conduct"
+---
+
+As contributors and maintainers of this project,
+we pledge to follow the [The Carpentries Code of Conduct][coc].
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported by following our [reporting guidelines][coc-reporting].
+
+
+[coc-reporting]: https://docs.carpentries.org/topic_folders/policies/incident-reporting.html
+[coc]: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html

LICENSE.md

@@ -0,0 +1,79 @@
+---
+title: "Licenses"
+---
+
+## Instructional Material
+
+All Carpentries (Software Carpentry, Data Carpentry, and Library Carpentry)
+instructional material is made available under the [Creative Commons
+Attribution license][cc-by-human]. The following is a human-readable summary of
+(and not a substitute for) the [full legal text of the CC BY 4.0
+license][cc-by-legal].
+
+You are free:
+
+- to **Share**---copy and redistribute the material in any medium or format
+- to **Adapt**---remix, transform, and build upon the material
+
+for any purpose, even commercially.
+
+The licensor cannot revoke these freedoms as long as you follow the license
+terms.
+
+Under the following terms:
+
+- **Attribution**---You must give appropriate credit (mentioning that your work
+  is derived from work that is Copyright (c) The Carpentries and, where
+  practical, linking to <https://carpentries.org/>), provide a [link to the
+  license][cc-by-human], and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor endorses
+  you or your use.
+
+- **No additional restrictions**---You may not apply legal terms or
+  technological measures that legally restrict others from doing anything the
+  license permits.  With the understanding that:
+
+Notices:
+
+* You do not have to comply with the license for elements of the material in
+  the public domain or where your use is permitted by an applicable exception
+  or limitation.
+* No warranties are given. The license may not give you all of the permissions
+  necessary for your intended use. For example, other rights such as publicity,
+  privacy, or moral rights may limit how you use the material.
+
+## Software
+
+Except where otherwise noted, the example programs and other software provided
+by The Carpentries are made available under the [OSI][osi]-approved [MIT
+license][mit-license].
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Trademark
+
+"The Carpentries", "Software Carpentry", "Data Carpentry", and "Library
+Carpentry" and their respective logos are registered trademarks of [Community
+Initiatives][ci].
+
+[cc-by-human]: https://creativecommons.org/licenses/by/4.0/
+[cc-by-legal]: https://creativecommons.org/licenses/by/4.0/legalcode
+[mit-license]: https://opensource.org/licenses/mit-license.html
+[ci]: https://communityin.org/
+[osi]: https://opensource.org

conditionals.md

@@ -0,0 +1,300 @@
+---
+title: Conditionals
+teaching: 15
+exercises: 10
+---
+
+::::::::::::::::::::::::::::::::::::::: objectives
+
+- Correctly write programs that use `if` and `else` statements using Boolean expressions.
+- Trace the execution of conditionals inside of loops.
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+:::::::::::::::::::::::::::::::::::::::: questions
+
+- How can programs do different things for different data?
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+## Use `if` statements to control whether or not a block of code is executed.
+
+An `if` statement is a *conditional* statement that controls whether a block of code is executed or not. The syntax of an `if` statement is similar to a `for` statement:
+
+- The first line opens with `if` and ends with a colon.
+- The body is indented (usually by 4 spaces)
+
+```python
+checkouts = 11
+if checkouts > 10.0:
+    print(f'{checkouts} is over the limit.')
+
+checkouts = 8
+if checkouts > 10.0:
+    print(f'{checkouts} is over the limit.')
+```
+
+```output
+11 is over the limit.
+```
+
+## Conditionals are often used inside loops.
+
+There is not much of a point using a conditional when we know the value (as above), but they're useful when we have a collection to process.
+
+```python
+checkouts = [0, 3, 10, 12, 22]
+for checkout in checkouts:
+    if checkout > 10.0:
+        print(f'{checkout} is over the limit.')
+```
+
+```output
+12 is over the limit.
+22 is over the limit.
+```
+
+## Use `else` to execute a block of code when an `if` condition is *not* true.
+
+An `else` statement can be used following `if` to allow us to specify an alternative code block to execute when the `if` *branch* is not taken.
+
+```python
+for checkout in checkouts:
+    if checkout > 10.0:
+        print(f'{checkout} is over the limit.')
+    else:
+        print(f'{checkout} is under the limit.')
+```
+
+```output
+0 is under the limit.
+3 is under the limit.
+10 is under the limit.
+12 is over the limit.
+22 is over the limit.
+```
+
+Notice that our `else` statement led to a false output that says 10 is under the limit. We can address this by adding a different kind of `else` statement.
+
+## Use `elif` to specify additional tests.
+
+You can use `elif` (short for "else if") to provide several alternative choices, each with its own test. An `elif` statement should always be associated with an `if` statement, and must come before the `else` statement (which is the catch all).
+
+```python
+for checkout in checkouts:
+    if checkout > 10.0:
+        print(f'*Warning*: {checkout} is over the limit.')
+    elif checkout == 10:
+        print(f'{checkout} is at the exact limit.')
+    else:
+        print(f'{checkout} is under the limit.')
+```
+
+```output
+0 is under the limit.
+3 is under the limit.
+10 is at the exact limit.
+*Warning*: 12 is over the limit.
+*Warning*: 22 is over the limit.
+
+```
+
+Conditions are tested once, in order and are not re-evaluated if values change. Python steps through the branches of the conditional in order, testing each in turn, so the order of your statements matters. 
+
+```python
+grade = 85
+if grade >= 70:
+    print('grade is C')
+elif grade >= 80:
+    print('grade is B')
+elif grade >= 90:
+    print('grade is A')
+```
+
+```output
+grade is C
+```
+
+## Compound conditionals using `and` and `or`
+
+Often, you want some combination of things to be true.  You can combine
+relations within a conditional using `and` and `or`.  
+
+We can also check if something is less/greater than or equal to a value by using `>=` and `<=` operators.
+
+```python
+checkouts = [3, 50, 120]
+users = ['fac', 'grad']
+
+for user in users:
+    for checkout in checkouts:
+        #faculty checkout limit is 100
+        if checkout >= 100 and user == 'fac':
+            print(f"*Warning*: {checkout} is over the {user} limit.")
+
+        #grad limit is 50
+        elif checkout >= 50 and user == 'grad':
+            print(f"{checkout} is over the {user} limit.")
+
+        else:
+            print(f"{checkout} is under the {user} limit.")
+
+    # print an empty line between users
+    print()
+
+```
+```output
+3 is under the fac limit.
+50 is under the fac limit.
+*Warning*: 120 is over the fac limit.
+
+3 is under the grad limit.
+*Warning*: 50 is over the grad limit.
+*Warning*: 120 is over the grad limit.
+```
+
+:::::::::::::::::::::::::::::::::::::::  challenge
+
+## Age conditionals
+
+Write a Python program that checks the age of a user to determine if they will receive a youth or adult library card. The program should:
+
+1. Store `age` in a variable.
+2. Use an `if` statement to check if the age is 16 or older. If true, print "You are eligible for an adult library card."
+3. Use an `else` statement to print "You are eligible for a youth library card" if the age is less than 16.
+
+If you finish early, try this challenge: 
+
+- In a new cell, adapt your program to loop through a list of age values, testing each age with the same output as above.
+
+:::::::::::::::  solution
+
+## Solution
+
+For parts 1 to 3:
+
+```python
+age = 25
+
+if age >= 16:
+  print('You are eligible for an adult library card.')
+else:
+  print('You are eligible for a youth library card.')
+```
+
+For the challenge:
+```python
+ages = [10, 16, 30, 65]
+
+for age in ages:
+  if age >= 16:
+    print('You are eligible for an adult library card.')
+  else:
+    print('You are eligible for a youth library card.')
+```
+
+
+:::::::::::::::::::::::::
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+
+:::::::::::::::::::::::::::::::::::::::  challenge
+
+## Conditional logic: Fill in the blanks
+
+Fill in the blanks in the following program to check if both the name variable is present in the names list and the password variable is equal to 'true' before giving a user access to a library system.
+
+If you have extra time after you solve the fill in the blanks, change the value of `password` and re-run the program to view the output. 
+
+```python
+names = ['Wang', 'Garcia', 'Martin']
+name = 'Martin'
+password = 'true'
+
+___ item in names:
+    print(item)
+    if name == item ___ password == _____:
+        print('Login successful!')
+    elif password __ 'true':
+        print(f'Your password is incorrect. Try again.')
+    ____ name __ item:
+        print(f'- Name does not match. Testing the next item in the list for {name}...')
+
+```
+:::::::::::::::  solution
+
+## Solution
+
+```python
+names = ['Wang', 'Garcia', 'Martin']
+name = 'Martin'
+password = 'true'
+
+for item in names:
+    print(item)
+    if name == item and password == 'true':
+        print('Login successful!')
+    elif password != 'true':
+        print(f'Your password is incorrect. Try again.')
+    elif name != item:
+        print(f'- Name does not match. Testing the next item in the list for {name}...')
+```
+
+```output
+Wang
+- Name does not match. Testing the next item in the list for Martin...
+Garcia
+- Name does not match. Testing the next item in the list for Martin...
+Martin
+Login successful!
+```
+
+:::::::::::::::::::::::::
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+:::::::::::::::::::::::::::::::::::::::  challenge
+
+## Processing Files Based on Record Length
+
+Modify this program so that it only processes files with fewer than 85 records.
+
+```python
+import glob
+import pandas
+for filename in glob.glob('data/*.csv'):
+    contents = pandas.read_csv(filename)
+    ____ ___(______) < ____:
+        print(f'{filename} : {len(contents)}')
+```
+
+:::::::::::::::  solution
+
+## Solution
+
+```python
+import glob
+import pandas
+for filename in glob.glob('data/*.csv'):
+   contents = pandas.read_csv(filename)
+   if len(contents) < 85:
+       print(f'{filename} : {len(contents)}')
+```
+
+:::::::::::::::::::::::::
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+:::::::::::::::::::::::::::::::::::::::: keypoints
+
+- Use `if` statements to control whether or not a block of code is executed.
+- Conditionals are often used inside loops.
+- Use `else` to execute a block of code when an `if` condition is *not* true.
+- Use `elif` to specify additional tests.
+- Conditions are tested once, in order.
+- Use `and` and `or` to check against multiple value statements.
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+