From cbca2fd06177e2da5fbb8605538c35426d635f1d Mon Sep 17 00:00:00 2001 From: GitHub Actions Date: Sat, 13 Apr 2024 20:16:55 +0000 Subject: [PATCH] source commit: f21a7a3d9cb22efe79f469aef9eb5774e6634bdd --- 01-run-quit.md | 667 ++++++++++++++++++ 02-variables.md | 420 +++++++++++ 03-types-conversion.md | 499 +++++++++++++ 04-built-in.md | 424 +++++++++++ 05-coffee.md | 16 + 06-libraries.md | 470 +++++++++++++ 07-reading-tabular.md | 442 ++++++++++++ 08-data-frames.md | 783 +++++++++++++++++++++ 09-plotting.md | 386 ++++++++++ 10-lunch.md | 14 + 11-lists.md | 506 +++++++++++++ 12-for-loops.md | 467 ++++++++++++ 13-conditionals.md | 411 +++++++++++ 14-looping-data-sets.md | 268 +++++++ 15-coffee.md | 18 + 16-writing-functions.md | 678 ++++++++++++++++++ 17-scope.md | 143 ++++ 18-style.md | 257 +++++++ 19-wrap.md | 51 ++ 20-feedback.md | 27 + CODE_OF_CONDUCT.md | 13 + LICENSE.md | 79 +++ config.yaml | 100 +++ data/asia_gdp_per_capita.csv | 13 + data/gapminder_all.csv | 143 ++++ data/gapminder_gdp_africa.csv | 53 ++ data/gapminder_gdp_americas.csv | 26 + data/gapminder_gdp_asia.csv | 34 + data/gapminder_gdp_europe.csv | 31 + data/gapminder_gdp_oceania.csv | 3 + design.md | 360 ++++++++++ discuss.md | 7 + exercises.md | 7 + fig/0_anaconda_navigator_landing_page.png | Bin 0 -> 244877 bytes fig/0_jupyterlab_landing_page.png | Bin 0 -> 460307 bytes fig/0_jupyterlab_left_side_bar.png | Bin 0 -> 165233 bytes fig/0_jupyterlab_main_work_area.png | Bin 0 -> 269016 bytes fig/0_jupyterlab_menu_bar.png | Bin 0 -> 31564 bytes fig/0_jupyterlab_notebook_screenshot.png | Bin 0 -> 261763 bytes fig/0_multipanel_jupyterlab_screenshot.png | Bin 0 -> 246923 bytes fig/2_indexing.svg | 24 + fig/9_correlations_solution1.svg | 67 ++ fig/9_correlations_solution2.png | Bin 0 -> 13326 bytes fig/9_gdp_australia.svg | 46 ++ fig/9_gdp_australia_formatted.svg | 58 ++ fig/9_gdp_australia_nz.svg | 54 ++ fig/9_gdp_australia_nz_formatted.svg | 68 ++ fig/9_gdp_bar.svg | 119 ++++ fig/9_gdp_correlation_data.svg | 80 +++ fig/9_gdp_correlation_plt.svg | 80 +++ fig/9_minima_maxima_solution.png | Bin 0 -> 13718 bytes fig/9_more_correlations_solution.svg | 187 +++++ fig/9_simple_position_time_plot.svg | 52 ++ files/python-novice-gapminder-data.zip | Bin 0 -> 38471 bytes index.md | 31 + instructor-notes.md | 29 + learner-profiles.md | 5 + links.md | 41 ++ md5sum.txt | 33 + reference.md | 260 +++++++ setup.md | 22 + 61 files changed, 9072 insertions(+) create mode 100644 01-run-quit.md create mode 100644 02-variables.md create mode 100644 03-types-conversion.md create mode 100644 04-built-in.md create mode 100644 05-coffee.md create mode 100644 06-libraries.md create mode 100644 07-reading-tabular.md create mode 100644 08-data-frames.md create mode 100644 09-plotting.md create mode 100644 10-lunch.md create mode 100644 11-lists.md create mode 100644 12-for-loops.md create mode 100644 13-conditionals.md create mode 100644 14-looping-data-sets.md create mode 100644 15-coffee.md create mode 100644 16-writing-functions.md create mode 100644 17-scope.md create mode 100644 18-style.md create mode 100644 19-wrap.md create mode 100644 20-feedback.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 LICENSE.md create mode 100644 config.yaml create mode 100644 data/asia_gdp_per_capita.csv create mode 100644 data/gapminder_all.csv create mode 100644 data/gapminder_gdp_africa.csv create mode 100644 data/gapminder_gdp_americas.csv create mode 100644 data/gapminder_gdp_asia.csv create mode 100644 data/gapminder_gdp_europe.csv create mode 100644 data/gapminder_gdp_oceania.csv create mode 100644 design.md create mode 100644 discuss.md create mode 100644 exercises.md create mode 100644 fig/0_anaconda_navigator_landing_page.png create mode 100644 fig/0_jupyterlab_landing_page.png create mode 100644 fig/0_jupyterlab_left_side_bar.png create mode 100644 fig/0_jupyterlab_main_work_area.png create mode 100644 fig/0_jupyterlab_menu_bar.png create mode 100644 fig/0_jupyterlab_notebook_screenshot.png create mode 100644 fig/0_multipanel_jupyterlab_screenshot.png create mode 100644 fig/2_indexing.svg create mode 100644 fig/9_correlations_solution1.svg create mode 100644 fig/9_correlations_solution2.png create mode 100644 fig/9_gdp_australia.svg create mode 100644 fig/9_gdp_australia_formatted.svg create mode 100644 fig/9_gdp_australia_nz.svg create mode 100644 fig/9_gdp_australia_nz_formatted.svg create mode 100644 fig/9_gdp_bar.svg create mode 100644 fig/9_gdp_correlation_data.svg create mode 100644 fig/9_gdp_correlation_plt.svg create mode 100644 fig/9_minima_maxima_solution.png create mode 100644 fig/9_more_correlations_solution.svg create mode 100644 fig/9_simple_position_time_plot.svg create mode 100644 files/python-novice-gapminder-data.zip create mode 100644 index.md create mode 100644 instructor-notes.md create mode 100644 learner-profiles.md create mode 100644 links.md create mode 100644 md5sum.txt create mode 100644 reference.md create mode 100644 setup.md diff --git a/01-run-quit.md b/01-run-quit.md new file mode 100644 index 000000000..2c0b1ae08 --- /dev/null +++ b/01-run-quit.md @@ -0,0 +1,667 @@ +--- +title: Running and Quitting +teaching: 15 +exercises: 0 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Launch the JupyterLab server. +- Create a new Python script. +- Create a Jupyter notebook. +- Shutdown the JupyterLab server. +- Understand the difference between a Python script and a Jupyter notebook. +- Create Markdown cells in a notebook. +- Create and run Python cells in a notebook. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I run Python programs? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +To run Python, we are going to use [Jupyter Notebooks][jupyter] via [JupyterLab][jupyterlab] for the remainder of this workshop. Jupyter notebooks are common in data science and visualization and serve as a convenient common-denominator experience for running Python code interactively where we can easily view and share the results of our Python code. + +There are other ways of editing, managing, and running code. Software developers often use an integrated development environment (IDE) like [PyCharm](https://www.jetbrains.com/pycharm/) or [Visual Studio Code](https://code.visualstudio.com/), or text editors like Vim or Emacs, to create and edit their Python programs. After editing and saving your Python programs you can execute those programs within the IDE itself or directly on the command line. In contrast, Jupyter notebooks let us execute and view the results of our Python code immediately within the notebook. + +JupyterLab has several other handy features: + +- You can easily type, edit, and copy and paste blocks of code. +- Tab complete allows you to easily access the names of things you are using + and learn more about them. +- It allows you to annotate your code with links, different sized text, bullets, etc. + to make it more accessible to you and your collaborators. +- It allows you to display figures next to the code that produces them + to tell a complete story of the analysis. + +Each notebook contains one or more cells that contain code, text, or images. + +## Getting Started with JupyterLab + +JupyterLab is an application server with a web user interface from [Project Jupyter][jupyter] that +enables one to work with documents and activities such as Jupyter notebooks, text editors, terminals, +and even custom components in a flexible, integrated, and extensible manner. JupyterLab requires a +reasonably up-to-date browser (ideally a current version of Chrome, Safari, or Firefox); Internet +Explorer versions 9 and below are *not* supported. + +JupyterLab is included as part of the Anaconda Python distribution. If you have not already +installed the Anaconda Python distribution, see [the setup instructions](../learners/setup.md) +for installation instructions. + +In this lesson we will run JupyterLab locally on our own machines so it will not require an internet connection besides +the initial connection to download and install Anaconda and JupyterLab + +- Start the JupyterLab server on your machine +- Use a web browser to open a special localhost URL that connects to your JupyterLab server +- The JupyterLab server does the work and the web browser renders the result +- Type code into the browser and see the results after your JupyterLab server has finished executing your code + +::::::::::::::::::::::::::::::::::::::::: callout + +## JupyterLab? What about Jupyter notebooks? + +JupyterLab is the [next stage in the evolution of the Jupyter Notebook](https://jupyterlab.readthedocs.io/en/stable/getting_started/overview.html#overview). +If you have prior experience working with Jupyter notebooks, then you will have a good idea of what to expect from JupyterLab. + +Experienced users of Jupyter notebooks interested in a more detailed discussion of the similarities and differences +between the JupyterLab and Jupyter notebook user interfaces can find more information in the +[JupyterLab user interface documentation][jupyterlab-ui]. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Starting JupyterLab + +You can start the JupyterLab server through the command line or through an application called +`Anaconda Navigator`. Anaconda Navigator is included as part of the Anaconda Python distribution. + +### macOS - Command Line + +To start the JupyterLab server you will need to access the command line through the Terminal. +There are two ways to open Terminal on Mac. + +1. In your Applications folder, open Utilities and double-click on Terminal +2. Press Command + spacebar to launch Spotlight. Type `Terminal` and then + double-click the search result or hit Enter + +After you have launched Terminal, type the command to launch the JupyterLab server. + +```bash +$ jupyter lab +``` + +### Windows Users - Command Line + +To start the JupyterLab server you will need to access the Anaconda Prompt. + +Press Windows Logo Key and search for `Anaconda Prompt`, click the result or press enter. + +After you have launched the Anaconda Prompt, type the command: + +```bash +$ jupyter lab +``` + +### Anaconda Navigator + +To start a JupyterLab server from Anaconda Navigator you must first [start Anaconda Navigator (click for detailed instructions on macOS, Windows, and Linux)](https://docs.anaconda.com/free/navigator/getting-started/#navigator-starting-navigator). You can search for Anaconda Navigator via Spotlight on macOS (Command + spacebar), the Windows search function (Windows Logo Key) or opening a terminal shell and executing the `anaconda-navigator` executable from the command line. + +After you have launched Anaconda Navigator, click the `Launch` button under JupyterLab. You may need +to scroll down to find it. + +Here is a screenshot of an Anaconda Navigator page similar to the one that should open on either macOS +or Windows. + +

+ Anaconda Navigator landing page +

+ +And here is a screenshot of a JupyterLab landing page that should be similar to the one that opens in your +default web browser after starting the JupyterLab server on either macOS or Windows. + +

+ JupyterLab landing page +

+ +## The JupyterLab Interface + +JupyterLab has many features found in traditional integrated development environments (IDEs) but +is focused on providing flexible building blocks for interactive, exploratory computing. + +The [JupyterLab Interface][jupyterlab-ui] +consists of the Menu Bar, a collapsable Left Side Bar, and the Main Work Area which contains tabs +of documents and activities. + +### Menu Bar + +The Menu Bar at the top of JupyterLab has the top-level menus that expose various actions +available in JupyterLab along with their keyboard shortcuts (where applicable). The following +menus are included by default. + +- **File:** Actions related to files and directories such as *New*, *Open*, *Close*, *Save*, etc. The *File* menu also includes the *Shut Down* action used to shutdown the JupyterLab server. +- **Edit:** Actions related to editing documents and other activities such as *Undo*, *Cut*, *Copy*, *Paste*, etc. +- **View:** Actions that alter the appearance of JupyterLab. +- **Run:** Actions for running code in different activities such as notebooks and code consoles (discussed below). +- **Kernel:** Actions for managing kernels. Kernels in Jupyter will be explained in more detail below. +- **Tabs:** A list of the open documents and activities in the main work area. +- **Settings:** Common JupyterLab settings can be configured using this menu. There is also an *Advanced Settings Editor* option in the dropdown menu that provides more fine-grained control of JupyterLab settings and configuration options. +- **Help:** A list of JupyterLab and kernel help links. + +::::::::::::::::::::::::::::::::::::::::: callout + +## Kernels + +The JupyterLab [docs](https://jupyterlab.readthedocs.io/en/stable/user/documents_kernels.html) +define kernels as "separate processes started by the server that runs your code in different programming languages and environments." +When we open a Jupyter Notebook, that starts a kernel - a process - that is going to run the code. +In this lesson, we'll be using the Jupyter ipython kernel which lets us run Python 3 code interactively. + +Using other Jupyter [kernels for other programming languages](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels) would let us +write and execute code in other programming languages in the same JupyterLab interface, like R, Java, Julia, Ruby, JavaScript, Fortran, +etc. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +A screenshot of the default Menu Bar is provided below. + +

JupyterLab Menu Bar +

+ +### Left Sidebar + +The left sidebar contains a number of commonly used tabs, such as a file browser (showing the +contents of the directory where the JupyterLab server was launched), a list of running kernels +and terminals, the command palette, and a list of open tabs in the main work area. A screenshot of +the default Left Side Bar is provided below. + +

JupyterLab Left Side Bar +

+ +The left sidebar can be collapsed or expanded by selecting "Show Left Sidebar" in the View menu or +by clicking on the active sidebar tab. + +### Main Work Area + +The main work area in JupyterLab enables you to arrange documents (notebooks, text files, etc.) +and other activities (terminals, code consoles, etc.) into panels of tabs that can be resized or +subdivided. A screenshot of the default Main Work Area is provided below. + +If you do not see the Launcher tab, click the blue plus sign under the "File" and "Edit" menus and it will appear. + +

JupyterLab Main Work Area +

+ +Drag a tab to the center of a tab panel to move the tab to the panel. Subdivide a tab panel by +dragging a tab to the left, right, top, or bottom of the panel. The work area has a single current +activity. The tab for the current activity is marked with a colored top border (blue by default). + +## Creating a Python script + +- To start writing a new Python program click the Text File icon under the *Other* header in the Launcher tab of the Main Work Area. + - You can also create a new plain text file by selecting the *New -> Text File* from the *File* menu in the Menu Bar. +- To convert this plain text file to a Python program, select the *Save File As* action from the *File* menu in the Menu Bar and give your new text file a name that ends with the `.py` extension. + - The `.py` extension lets everyone (including the operating system) know that this text file is a Python program. + - This is convention, not a requirement. + +## Creating a Jupyter Notebook + +To open a new notebook click the Python 3 icon under the *Notebook* header in the Launcher tab in +the main work area. You can also create a new notebook by selecting *New -> Notebook* from the *File* menu in the Menu Bar. + +Additional notes on Jupyter notebooks. + +- Notebook files have the extension `.ipynb` to distinguish them from plain-text Python programs. +- Notebooks can be exported as Python scripts that can be run from the command line. + +Below is a screenshot of a Jupyter notebook running inside JupyterLab. If you are interested in +more details, then see the [official notebook documentation][jupyterlab-notebook-docs]. + +

Example Jupyter Notebook +

+ +::::::::::::::::::::::::::::::::::::::::: callout + +## How It's Stored + +- The notebook file is stored in a format called JSON. +- Just like a webpage, what's saved looks different from what you see in your browser. +- But this format allows Jupyter to mix source code, text, and images, all in one file. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Arranging Documents into Panels of Tabs + +In the JupyterLab Main Work Area you can arrange documents into panels of tabs. Here is an +example from the [official documentation][jupyterlab]. + +

Multi-panel JupyterLab +

+ +First, create a text file, Python console, and terminal window and arrange them into three +panels in the main work area. Next, create a notebook, terminal window, and text file and +arrange them into three panels in the main work area. Finally, create your own combination of +panels and tabs. What combination of panels and tabs do you think will be most useful for your +workflow? + +::::::::::::::: solution + +## Solution + +After creating the necessary tabs, you can drag one of the tabs to the center of a panel to +move the tab to the panel; next you can subdivide a tab panel by dragging a tab to the left, +right, top, or bottom of the panel. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Code vs. Text + +Jupyter mixes code and text in different types of blocks, called cells. We often use the term +"code" to mean "the source code of software written in a language such as Python". +A "code cell" in a Notebook is a cell that contains software; +a "text cell" is one that contains ordinary prose written for human beings. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## The Notebook has Command and Edit modes. + +- If you press Esc and Return alternately, the outer border of your code cell will change from gray to blue. +- These are the **Command** (gray) and **Edit** (blue) modes of your notebook. +- Command mode allows you to edit notebook-level features, and Edit mode changes the content of cells. +- When in Command mode (esc/gray), + - The b key will make a new cell below the currently selected cell. + - The a key will make one above. + - The x key will delete the current cell. + - The z key will undo your last cell operation (which could be a deletion, creation, etc). +- All actions can be done using the menus, but there are lots of keyboard shortcuts to speed things up. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Command Vs. Edit + +In the Jupyter notebook page are you currently in Command or Edit mode? +Switch between the modes. +Use the shortcuts to generate a new cell. +Use the shortcuts to delete a cell. +Use the shortcuts to undo the last cell operation you performed. + +::::::::::::::: solution + +## Solution + +Command mode has a grey border and Edit mode has a blue border. +Use Esc and Return to switch between modes. +You need to be in Command mode (Press Esc if your cell is blue). Type b or a. +You need to be in Command mode (Press Esc if your cell is blue). Type x. +You need to be in Command mode (Press Esc if your cell is blue). Type z. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +### Use the keyboard and mouse to select and edit cells. + +- Pressing the Return key turns the border blue and engages Edit mode, which allows + you to type within the cell. +- Because we want to be able to write many lines of code in a single cell, + pressing the Return key when in Edit mode (blue) moves the cursor to the next line + in the cell just like in a text editor. +- We need some other way to tell the Notebook we want to run what's in the cell. +- Pressing Shift\+Return together will execute the contents of the cell. +- Notice that the Return and Shift keys on the right of the keyboard are + right next to each other. + +### The Notebook will turn Markdown into pretty-printed documentation. + +- Notebooks can also render [Markdown][markdown]. + - A simple plain-text format for writing lists, links, + and other things that might go into a web page. + - Equivalently, a subset of HTML that looks like what you'd send in an old-fashioned email. +- Turn the current cell into a Markdown cell by entering the Command mode (Esc/gray) + and press the M key. +- `In [ ]:` will disappear to show it is no longer a code cell and you will be able to write in + Markdown. +- Turn the current cell into a Code cell by entering the Command mode (Esc/gray) and + press the y key. + +### Markdown does most of what HTML does. + +
+ +
+ +``` +* Use asterisks +* to create +* bullet lists. +``` + +
+ +
+ +- Use asterisks +- to create +- bullet lists. + +
+ +
+ +
+ +
+ +``` +1. Use numbers +1. to create +1. numbered lists. +``` + +
+ +
+ +1. Use numbers +2. to create +3. numbered lists. + +
+ +
+ +
+ +
+ +``` +* You can use indents + * To create sublists + * of the same type +* Or sublists + 1. Of different + 1. types +``` + +
+ +
+ +- You can use indents + - To create sublists + - of the same type +- Or sublists + 1. Of different + 2. types + +
+ +
+ +
+ +
+ +``` +# A Level-1 Heading +``` + +
+ +
+ +## A Level-1 Heading + +
+ +
+ +
+ +
+ +``` +## A Level-2 Heading (etc.) +``` + +
+ +
+ +## A Level-2 Heading (etc.) + +
+ +
+ +
+ +
+ +``` +Line breaks +don't matter. + +But blank lines +create new paragraphs. +``` + +
+ +
+ +Line breaks +don't matter. + +But blank lines +create new paragraphs. + +
+ +
+ +
+ +
+ +``` +[Create links](http://software-carpentry.org) with `[...](...)`. +Or use [named links][data_carpentry]. + +[data_carpentry]: http://datacarpentry.org +``` + +
+ +
+ +[Create links](https://software-carpentry.org) with `[...](...)`. +Or use [named links][data_carpentry]. + +
+ +
+ +::::::::::::::::::::::::::::::::::::::: challenge + +## Creating Lists in Markdown + +Create a nested list in a Markdown cell in a notebook that looks like this: + +1. Get funding. +2. Do work. + - Design experiment. + - Collect data. + - Analyze. +3. Write up. +4. Publish. + +::::::::::::::: solution + +## Solution + +This challenge integrates both the numbered list and bullet list. +Note that the bullet list is indented 2 spaces so that it is inline with the items of the numbered list. + +``` +1. Get funding. +2. Do work. + * Design experiment. + * Collect data. + * Analyze. +3. Write up. +4. Publish. +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## More Math + +What is displayed when a Python cell in a notebook +that contains several calculations is executed? +For example, what happens when this cell is executed? + +```python +7 * 3 +2 + 1 +``` + +::::::::::::::: solution + +## Solution + +Python returns the output of the last calculation. + +```python +3 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Change an Existing Cell from Code to Markdown + +What happens if you write some Python in a code cell +and then you switch it to a Markdown cell? +For example, +put the following in a code cell: + +```python +x = 6 * 7 + 12 +print(x) +``` + +And then run it with Shift\+Return to be sure that it works as a code cell. +Now go back to the cell and use Esc then m to switch the cell to Markdown +and "run" it with Shift\+Return. +What happened and how might this be useful? + +::::::::::::::: solution + +## Solution + +The Python code gets treated like Markdown text. +The lines appear as if they are part of one contiguous paragraph. +This could be useful to temporarily turn on and off cells in notebooks that get used for multiple purposes. + +```python +x = 6 * 7 + 12 print(x) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Equations + +Standard Markdown (such as we're using for these notes) won't render equations, +but the Notebook will. +Create a new Markdown cell +and enter the following: + +``` +$\sum_{i=1}^{N} 2^{-i} \approx 1$ +``` + +(It's probably easier to copy and paste.) +What does it display? +What do you think the underscore, `_`, circumflex, `^`, and dollar sign, `$`, do? + +::::::::::::::: solution + +## Solution + +The notebook shows the equation as it would be rendered from LaTeX equation syntax. +The dollar sign, `$`, is used to tell Markdown that the text in between is a LaTeX equation. +If you're not familiar with LaTeX, underscore, `_`, is used for subscripts and circumflex, `^`, is used for superscripts. +A pair of curly braces, `{` and `}`, is used to group text together so that the statement `i=1` becomes the subscript and `N` becomes the superscript. +Similarly, `-i` is in curly braces to make the whole statement the superscript for `2`. +`\sum` and `\approx` are LaTeX commands for "sum over" and "approximate" symbols. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Closing JupyterLab + +- From the Menu Bar select the "File" menu and then choose "Shut Down" at the bottom of the dropdown menu. You will be prompted to confirm that you wish to shutdown the JupyterLab server (don't forget to save your work!). Click "Shut Down" to shutdown the JupyterLab server. +- To restart the JupyterLab server you will need to re-run the following command from a shell. + +``` +$ jupyter lab +``` + +::::::::::::::::::::::::::::::::::::::: challenge + +## Closing JupyterLab + +Practice closing and restarting the JupyterLab server. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + + +[jupyterlab]: https://jupyterlab.readthedocs.io/en/stable/ +[jupyterlab-ui]: https://jupyterlab.readthedocs.io/en/stable/user/interface.html +[jupyterlab-notebook-docs]: https://jupyterlab.readthedocs.io/en/stable/user/notebook.html +[markdown]: https://en.wikipedia.org/wiki/Markdown +[data_carpentry]: https://datacarpentry.org + + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Python scripts are plain text files. +- Use the Jupyter Notebook for editing and running Python. +- The Notebook has Command and Edit modes. +- Use the keyboard and mouse to select and edit cells. +- The Notebook will turn Markdown into pretty-printed documentation. +- Markdown does most of what HTML does. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/02-variables.md b/02-variables.md new file mode 100644 index 000000000..561406f8a --- /dev/null +++ b/02-variables.md @@ -0,0 +1,420 @@ +--- +title: Variables and Assignment +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Write programs that assign scalar values to variables and perform calculations with those values. +- Correctly trace value changes in programs that use scalar assignment. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I store data in programs? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Use variables to store values. + +- **Variables** are names for values. + +- Variable names + + - can **only** contain letters, digits, and underscore `_` (typically used to separate words in long variable names) + - cannot start with a digit + - are **case sensitive** (age, Age and AGE are three different variables) + +- The name should also be meaningful so you or another programmer know what it is + +- Variable names that start with underscores like `__alistairs_real_age` have a special meaning + so we won't do that until we understand the convention. + +- In Python the `=` symbol assigns the value on the right to the name on the left. + +- The variable is created when a value is assigned to it. + +- Here, Python assigns an age to a variable `age` + and a name in quotes to a variable `first_name`. + + ```python + age = 42 + first_name = 'Ahmed' + ``` + +## Use `print` to display values. + +- Python has a built-in function called `print` that prints things as text. +- Call the function (i.e., tell Python to run it) by using its name. +- Provide values to the function (i.e., the things to print) in parentheses. +- To add a string to the printout, wrap the string in single or double quotes. +- The values passed to the function are called **arguments** + +```python +print(first_name, 'is', age, 'years old') +``` + +```output +Ahmed is 42 years old +``` + +- `print` automatically puts a single space between items to separate them. +- And wraps around to a new line at the end. + +## Variables must be created before they are used. + +- If a variable doesn't exist yet, or if the name has been mis-spelled, + Python reports an error. (Unlike some languages, which "guess" a default value.) + +```python +print(last_name) +``` + +```error +--------------------------------------------------------------------------- +NameError Traceback (most recent call last) + in () +----> 1 print(last_name) + +NameError: name 'last_name' is not defined +``` + +- The last line of an error message is usually the most informative. +- We will look at error messages in detail [later](17-scope.md#reading-error-messages). + +::::::::::::::::::::::::::::::::::::::::: callout + +## Variables Persist Between Cells + +Be aware that it is the *order* of execution of cells that is important in a Jupyter notebook, not the order +in which they appear. Python will remember *all* the code that was run previously, including any variables you have +defined, irrespective of the order in the notebook. Therefore if you define variables lower down the notebook and then +(re)run cells further up, those defined further down will still be present. As an example, create two cells with the +following content, in this order: + +```python +print(myval) +``` + +```python +myval = 1 +``` + +If you execute this in order, the first cell will give an error. However, if you run the first cell *after* the second +cell it will print out `1`. To prevent confusion, it can be helpful to use the `Kernel` -> `Restart & Run All` option which +clears the interpreter and runs everything from a clean slate going top to bottom. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Variables can be used in calculations. + +- We can use variables in calculations just as if they were values. + - Remember, we assigned the value `42` to `age` a few lines ago. + +```python +age = age + 3 +print('Age in three years:', age) +``` + +```output +Age in three years: 45 +``` + +## Use an index to get a single character from a string. + +- The characters (individual letters, numbers, and so on) in a string are + ordered. For example, the string `'AB'` is not the same as `'BA'`. Because of + this ordering, we can treat the string as a list of characters. +- Each position in the string (first, second, etc.) is given a number. This + number is called an **index** or sometimes a subscript. +- Indices are numbered from 0. +- Use the position's index in square brackets to get the character at that + position. + +![A line of Python code, print(atom\_name[0]), demonstrates that using the zero index will output just the initial letter, in this case 'h' for helium.](fig/2_indexing.svg) + +```python +atom_name = 'helium' +print(atom_name[0]) +``` + +```output +h +``` + +## Use a slice to get a substring. + +- A part of a string is called a **substring**. A substring can be as short as a + single character. +- An item in a list is called an element. Whenever we treat a string as if it + were a list, the string's elements are its individual characters. +- A slice is a part of a string (or, more generally, a part of any list-like thing). +- We take a slice with the notation `[start:stop]`, where `start` is the integer + index of the first element we want and `stop` is the integer index of + the element *just after* the last element we want. +- The difference between `stop` and `start` is the slice's length. +- Taking a slice does not change the contents of the original string. Instead, + taking a slice returns a copy of part of the original string. + +```python +atom_name = 'sodium' +print(atom_name[0:3]) +``` + +```output +sod +``` + +## Use the built-in function `len` to find the length of a string. + +```python +print(len('helium')) +``` + +```output +6 +``` + +- Nested functions are evaluated from the inside out, + like in mathematics. + +## Python is case-sensitive. + +- Python thinks that upper- and lower-case letters are different, + so `Name` and `name` are different variables. +- There are conventions for using upper-case letters at the start of variable names so we will use lower-case letters for now. + +## Use meaningful variable names. + +- Python doesn't care what you call variables as long as they obey the rules + (alphanumeric characters and the underscore). + +```python +flabadab = 42 +ewr_422_yY = 'Ahmed' +print(ewr_422_yY, 'is', flabadab, 'years old') +``` + +- Use meaningful variable names to help other people understand what the program does. +- The most important "other person" is your future self. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Swapping Values + +Fill the table showing the values of the variables in this program +*after* each statement is executed. + +```python +# Command # Value of x # Value of y # Value of swap # +x = 1.0 # # # # +y = 3.0 # # # # +swap = x # # # # +x = y # # # # +y = swap # # # # +``` + +::::::::::::::: solution + +## Solution + +```output +# Command # Value of x # Value of y # Value of swap # +x = 1.0 # 1.0 # not defined # not defined # +y = 3.0 # 1.0 # 3.0 # not defined # +swap = x # 1.0 # 3.0 # 1.0 # +x = y # 3.0 # 3.0 # 1.0 # +y = swap # 3.0 # 1.0 # 1.0 # +``` + +These three lines exchange the values in `x` and `y` using the `swap` +variable for temporary storage. This is a fairly common programming idiom. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Predicting Values + +What is the final value of `position` in the program below? +(Try to predict the value without running the program, +then check your prediction.) + +```python +initial = 'left' +position = initial +initial = 'right' +``` + +::::::::::::::: solution + +## Solution + +```python +print(position) +``` + +```output +left +``` + +The `initial` variable is assigned the value `'left'`. +In the second line, the `position` variable also receives +the string value `'left'`. In third line, the `initial` variable is given the +value `'right'`, but the `position` variable retains its string value +of `'left'`. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Challenge + +If you assign `a = 123`, +what happens if you try to get the second digit of `a` via `a[1]`? + +::::::::::::::: solution + +## Solution + +Numbers are not strings or sequences and Python will raise an error if you try to perform an index operation on a +number. In the [next lesson on types and type conversion](03-types-conversion.md) +we will learn more about types and how to convert between different types. If you want the Nth digit of a number you +can convert it into a string using the `str` built-in function and then perform an index operation on that string. + +```python +a = 123 +print(a[1]) +``` + +```error +TypeError: 'int' object is not subscriptable +``` + +```python +a = str(123) +print(a[1]) +``` + +```output +2 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Choosing a Name + +Which is a better variable name, `m`, `min`, or `minutes`? +Why? +Hint: think about which code you would rather inherit +from someone who is leaving the lab: + +1. `ts = m * 60 + s` +2. `tot_sec = min * 60 + sec` +3. `total_seconds = minutes * 60 + seconds` + +::::::::::::::: solution + +## Solution + +`minutes` is better because `min` might mean something like "minimum" +(and actually is an existing built-in function in Python that we will cover later). + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Slicing practice + +What does the following program print? + +```python +atom_name = 'carbon' +print('atom_name[1:3] is:', atom_name[1:3]) +``` + +::::::::::::::: solution + +## Solution + +```output +atom_name[1:3] is: ar +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Slicing concepts + +Given the following string: + +```python +species_name = "Acacia buxifolia" +``` + +What would these expressions return? + +1. `species_name[2:8]` +2. `species_name[11:]` (without a value after the colon) +3. `species_name[:4]` (without a value before the colon) +4. `species_name[:]` (just a colon) +5. `species_name[11:-3]` +6. `species_name[-5:-3]` +7. What happens when you choose a `stop` value which is out of range? (i.e., try `species_name[0:20]` or `species_name[:103]`) + +::::::::::::::: solution + +## Solutions + +1. `species_name[2:8]` returns the substring `'acia b'` +2. `species_name[11:]` returns the substring `'folia'`, from position 11 until the end +3. `species_name[:4]` returns the substring `'Acac'`, from the start up to but not including position 4 +4. `species_name[:]` returns the entire string `'Acacia buxifolia'` +5. `species_name[11:-3]` returns the substring `'fo'`, from the 11th position to the third last position +6. `species_name[-5:-3]` also returns the substring `'fo'`, from the fifth last position to the third last +7. If a part of the slice is out of range, the operation does not fail. `species_name[0:20]` gives the same result as `species_name[0:]`, and `species_name[:103]` gives the same result as `species_name[:]` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Use variables to store values. +- Use `print` to display values. +- Variables persist between cells. +- Variables must be created before they are used. +- Variables can be used in calculations. +- Use an index to get a single character from a string. +- Use a slice to get a substring. +- Use the built-in function `len` to find the length of a string. +- Python is case-sensitive. +- Use meaningful variable names. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/03-types-conversion.md b/03-types-conversion.md new file mode 100644 index 000000000..f20125577 --- /dev/null +++ b/03-types-conversion.md @@ -0,0 +1,499 @@ +--- +title: Data Types and Type Conversion +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain key differences between integers and floating point numbers. +- Explain key differences between numbers and character strings. +- Use built-in functions to convert between integers, floating point numbers, and strings. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- What kinds of data do programs store? +- How can I convert one type to another? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Every value has a type. + +- Every value in a program has a specific type. +- Integer (`int`): represents positive or negative whole numbers like 3 or -512. +- Floating point number (`float`): represents real numbers like 3.14159 or -2.5. +- Character string (usually called "string", `str`): text. + - Written in either single quotes or double quotes (as long as they match). + - The quote marks aren't printed when the string is displayed. + +## Use the built-in function `type` to find the type of a value. + +- Use the built-in function `type` to find out what type a value has. +- Works on variables as well. + - But remember: the *value* has the type --- the *variable* is just a label. + +```python +print(type(52)) +``` + +```output + +``` + +```python +fitness = 'average' +print(type(fitness)) +``` + +```output + +``` + +## Types control what operations (or methods) can be performed on a given value. + +- A value's type determines what the program can do to it. + +```python +print(5 - 3) +``` + +```output +2 +``` + +```python +print('hello' - 'h') +``` + +```error +--------------------------------------------------------------------------- +TypeError Traceback (most recent call last) + in () +----> 1 print('hello' - 'h') + +TypeError: unsupported operand type(s) for -: 'str' and 'str' +``` + +## You can use the "+" and "\*" operators on strings. + +- "Adding" character strings concatenates them. + +```python +full_name = 'Ahmed' + ' ' + 'Walsh' +print(full_name) +``` + +```output +Ahmed Walsh +``` + +- Multiplying a character string by an integer *N* creates a new string that consists of that character string repeated *N* times. + - Since multiplication is repeated addition. + +```python +separator = '=' * 10 +print(separator) +``` + +```output +========== +``` + +## Strings have a length (but numbers don't). + +- The built-in function `len` counts the number of characters in a string. + +```python +print(len(full_name)) +``` + +```output +11 +``` + +- But numbers don't have a length (not even zero). + +```python +print(len(52)) +``` + +```error +--------------------------------------------------------------------------- +TypeError Traceback (most recent call last) + in () +----> 1 print(len(52)) + +TypeError: object of type 'int' has no len() +``` + +## Must convert numbers to strings or vice versa when operating on them. {#convert-numbers-and-strings} + +- Cannot add numbers and strings. + +```python +print(1 + '2') +``` + +```error +--------------------------------------------------------------------------- +TypeError Traceback (most recent call last) + in () +----> 1 print(1 + '2') + +TypeError: unsupported operand type(s) for +: 'int' and 'str' +``` + +- Not allowed because it's ambiguous: should `1 + '2'` be `3` or `'12'`? +- Some types can be converted to other types by using the type name as a function. + +```python +print(1 + int('2')) +print(str(1) + '2') +``` + +```output +3 +12 +``` + +## Can mix integers and floats freely in operations. + +- Integers and floating-point numbers can be mixed in arithmetic. + - Python 3 automatically converts integers to floats as needed. + +```python +print('half is', 1 / 2.0) +print('three squared is', 3.0 ** 2) +``` + +```output +half is 0.5 +three squared is 9.0 +``` + +## Variables only change value when something is assigned to them. + +- If we make one cell in a spreadsheet depend on another, + and update the latter, + the former updates automatically. +- This does **not** happen in programming languages. + +```python +variable_one = 1 +variable_two = 5 * variable_one +variable_one = 2 +print('first is', variable_one, 'and second is', variable_two) +``` + +```output +first is 2 and second is 5 +``` + +- The computer reads the value of `variable_one` when doing the multiplication, + creates a new value, and assigns it to `variable_two`. +- Afterwards, the value of `variable_two` is set to the new value and *not dependent on `variable_one`* so its value + does not automatically change when `variable_one` changes. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Fractions + +What type of value is 3.4? +How can you find out? + +::::::::::::::: solution + +## Solution + +It is a floating-point number (often abbreviated "float"). +It is possible to find out by using the built-in function `type()`. + +```python +print(type(3.4)) +``` + +```output + +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Automatic Type Conversion + +What type of value is 3.25 + 4? + +::::::::::::::: solution + +## Solution + +It is a float: +integers are automatically converted to floats as necessary. + +```python +result = 3.25 + 4 +print(result, 'is', type(result)) +``` + +```output +7.25 is +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Choose a Type + +What type of value (integer, floating point number, or character string) +would you use to represent each of the following? Try to come up with more than one good answer for each problem. For example, in # 1, when would counting days with a floating point variable make more sense than using an integer? + +1. Number of days since the start of the year. +2. Time elapsed from the start of the year until now in days. +3. Serial number of a piece of lab equipment. +4. A lab specimen's age +5. Current population of a city. +6. Average population of a city over time. + +::::::::::::::: solution + +## Solution + +The answers to the questions are: + +1. Integer, since the number of days would lie between 1 and 365. +2. Floating point, since fractional days are required +3. Character string if serial number contains letters and numbers, otherwise integer if the serial number consists only of numerals +4. This will vary! How do you define a specimen's age? whole days since collection (integer)? date and time (string)? +5. Choose floating point to represent population as large aggregates (eg millions), or integer to represent population in units of individuals. +6. Floating point number, since an average is likely to have a fractional part. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Division Types + +In Python 3, the `//` operator performs integer (whole-number) floor division, the `/` operator performs floating-point +division, and the `%` (or *modulo*) operator calculates and returns the remainder from integer division: + +```python +print('5 // 3:', 5 // 3) +print('5 / 3:', 5 / 3) +print('5 % 3:', 5 % 3) +``` + +```output +5 // 3: 1 +5 / 3: 1.6666666666666667 +5 % 3: 2 +``` + +If `num_subjects` is the number of subjects taking part in a study, +and `num_per_survey` is the number that can take part in a single survey, +write an expression that calculates the number of surveys needed +to reach everyone once. + +::::::::::::::: solution + +## Solution + +We want the minimum number of surveys that reaches everyone once, which is +the rounded up value of `num_subjects/ num_per_survey`. This is +equivalent to performing a floor division with `//` and adding 1. Before +the division we need to subtract 1 from the number of subjects to deal with +the case where `num_subjects` is evenly divisible by `num_per_survey`. + +```python +num_subjects = 600 +num_per_survey = 42 +num_surveys = (num_subjects - 1) // num_per_survey + 1 + +print(num_subjects, 'subjects,', num_per_survey, 'per survey:', num_surveys) +``` + +```output +600 subjects, 42 per survey: 15 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Strings to Numbers + +Where reasonable, `float()` will convert a string to a floating point number, +and `int()` will convert a floating point number to an integer: + +```python +print("string to float:", float("3.4")) +print("float to int:", int(3.4)) +``` + +```output +string to float: 3.4 +float to int: 3 +``` + +If the conversion doesn't make sense, however, an error message will occur. + +```python +print("string to float:", float("Hello world!")) +``` + +```error +--------------------------------------------------------------------------- +ValueError Traceback (most recent call last) + in +----> 1 print("string to float:", float("Hello world!")) + +ValueError: could not convert string to float: 'Hello world!' +``` + +Given this information, what do you expect the following program to do? + +What does it actually do? + +Why do you think it does that? + +```python +print("fractional string to int:", int("3.4")) +``` + +::::::::::::::: solution + +## Solution + +What do you expect this program to do? It would not be so unreasonable to expect the Python 3 `int` command to +convert the string "3.4" to 3.4 and an additional type conversion to 3. After all, Python 3 performs a lot of other +magic - isn't that part of its charm? + +```python +int("3.4") +``` + +```output +--------------------------------------------------------------------------- +ValueError Traceback (most recent call last) + in +----> 1 int("3.4") +ValueError: invalid literal for int() with base 10: '3.4' +``` + +However, Python 3 throws an error. Why? To be consistent, possibly. If you ask Python to perform two consecutive +typecasts, you must convert it explicitly in code. + +```python +int(float("3.4")) +``` + +```output +3 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Arithmetic with Different Types + +Which of the following will return the floating point number `2.0`? +Note: there may be more than one right answer. + +```python +first = 1.0 +second = "1" +third = "1.1" +``` + +1. `first + float(second)` +2. `float(second) + float(third)` +3. `first + int(third)` +4. `first + int(float(third))` +5. `int(first) + int(float(third))` +6. `2.0 * second` + +::::::::::::::: solution + +## Solution + +Answer: 1 and 4 + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Complex Numbers + +Python provides complex numbers, +which are written as `1.0+2.0j`. +If `val` is a complex number, +its real and imaginary parts can be accessed using *dot notation* +as `val.real` and `val.imag`. + +```python +a_complex_number = 6 + 2j +print(a_complex_number.real) +print(a_complex_number.imag) +``` + +```output +6.0 +2.0 +``` + +1. Why do you think Python uses `j` instead of `i` for the imaginary part? +2. What do you expect `1 + 2j + 3` to produce? +3. What do you expect `4j` to be? What about `4 j` or `4 + j`? + +::::::::::::::: solution + +## Solution + +1. Standard mathematics treatments typically use `i` to denote an imaginary number. However, from media reports it + was an early convention established from electrical engineering that now presents a technically expensive area to + change. [Stack Overflow provides additional explanation and + discussion.](https://stackoverflow.com/questions/24812444/why-are-complex-numbers-in-python-denoted-with-j-instead-of-i) +2. `(4+2j)` +3. `4j` and `Syntax Error: invalid syntax`. In the latter cases, `j` is considered a variable and the statement + depends on if `j` is defined and if so, its assigned value. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Every value has a type. +- Use the built-in function `type` to find the type of a value. +- Types control what operations can be done on values. +- Strings can be added and multiplied. +- Strings have a length (but numbers don't). +- Must convert numbers to strings or vice versa when operating on them. +- Can mix integers and floats freely in operations. +- Variables only change value when something is assigned to them. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/04-built-in.md b/04-built-in.md new file mode 100644 index 000000000..e11685be7 --- /dev/null +++ b/04-built-in.md @@ -0,0 +1,424 @@ +--- +title: Built-in Functions and Help +teaching: 15 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain the purpose of functions. +- Correctly call built-in Python functions. +- Correctly nest calls to built-in functions. +- Use help to display documentation for built-in functions. +- Correctly describe situations in which SyntaxError and NameError occur. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I use built-in functions? +- How can I find out what they do? +- What kind of errors can occur in programs? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Use comments to add documentation to programs. + +```python +# This sentence isn't executed by Python. +adjustment = 0.5 # Neither is this - anything after '#' is ignored. +``` + +## A function may take zero or more arguments. + +- We have seen some functions already --- now let's take a closer look. +- An *argument* is a value passed into a function. +- `len` takes exactly one. +- `int`, `str`, and `float` create a new value from an existing one. +- `print` takes zero or more. +- `print` with no arguments prints a blank line. + - Must always use parentheses, even if they're empty, + so that Python knows a function is being called. + +```python +print('before') +print() +print('after') +``` + +```output +before + +after +``` + +## Every function returns something. + +- Every function call produces some result. +- If the function doesn't have a useful result to return, + it usually returns the special value `None`. `None` is a Python + object that stands in anytime there is no value. + +```python +result = print('example') +print('result of print is', result) +``` + +```output +example +result of print is None +``` + +## Commonly-used built-in functions include `max`, `min`, and `round`. + +- Use `max` to find the largest value of one or more values. +- Use `min` to find the smallest. +- Both work on character strings as well as numbers. + - "Larger" and "smaller" use (0-9, A-Z, a-z) to compare letters. + +```python +print(max(1, 2, 3)) +print(min('a', 'A', '0')) +``` + +```output +3 +0 +``` + +## Functions may only work for certain (combinations of) arguments. + +- `max` and `min` must be given at least one argument. + - "Largest of the empty set" is a meaningless question. +- And they must be given things that can meaningfully be compared. + +```python +print(max(1, 'a')) +``` + +```error +TypeError Traceback (most recent call last) + in +----> 1 print(max(1, 'a')) + +TypeError: '>' not supported between instances of 'str' and 'int' +``` + +## Functions may have default values for some arguments. + +- `round` will round off a floating-point number. +- By default, rounds to zero decimal places. + +```python +round(3.712) +``` + +```output +4 +``` + +- We can specify the number of decimal places we want. + +```python +round(3.712, 1) +``` + +```output +3.7 +``` + +## Functions attached to objects are called methods + +- Functions take another form that will be common in the pandas episodes. +- Methods have parentheses like functions, but come after the variable. +- Some methods are used for internal Python operations, and are marked with double underlines. + +```python +my_string = 'Hello world!' # creation of a string object + +print(len(my_string)) # the len function takes a string as an argument and returns the length of the string + +print(my_string.swapcase()) # calling the swapcase method on the my_string object + +print(my_string.__len__()) # calling the internal __len__ method on the my_string object, used by len(my_string) + +``` + +```output +12 +hELLO WORLD! +12 +``` + +- You might even see them chained together. They operate left to right. + +```python +print(my_string.isupper()) # Not all the letters are uppercase +print(my_string.upper()) # This capitalizes all the letters + +print(my_string.upper().isupper()) # Now all the letters are uppercase +``` + +```output +False +HELLO WORLD +True +``` + +## Use the built-in function `help` to get help for a function. + +- Every built-in function has online documentation. + +```python +help(round) +``` + +```output +Help on built-in function round in module builtins: + +round(number, ndigits=None) + Round a number to a given precision in decimal digits. + + The return value is an integer if ndigits is omitted or None. Otherwise + the return value has the same type as the number. ndigits may be negative. +``` + +## The Jupyter Notebook has two ways to get help. + +- Option 1: Place the cursor near where the function is invoked in a cell + (i.e., the function name or its parameters), + - Hold down Shift, and press Tab. + - Do this several times to expand the information returned. +- Option 2: Type the function name in a cell with a question mark after it. Then run the cell. + +## Python reports a syntax error when it can't understand the source of a program. + +- Won't even try to run the program if it can't be parsed. + +```python +# Forgot to close the quote marks around the string. +name = 'Feng +``` + +```error + File "", line 2 + name = 'Feng + ^ +SyntaxError: EOL while scanning string literal +``` + +```python +# An extra '=' in the assignment. +age = = 52 +``` + +```error + File "", line 2 + age = = 52 + ^ +SyntaxError: invalid syntax +``` + +- Look more closely at the error message: + +```python +print("hello world" +``` + +```error + File "", line 1 + print ("hello world" + ^ +SyntaxError: unexpected EOF while parsing +``` + +- The message indicates a problem on first line of the input ("line 1"). + - In this case the "ipython-input" section of the file name tells us that + we are working with input into IPython, + the Python interpreter used by the Jupyter Notebook. +- The `-6-` part of the filename indicates that + the error occurred in cell 6 of our Notebook. +- Next is the problematic line of code, + indicating the problem with a `^` pointer. + +## Python reports a runtime error when something goes wrong while a program is executing. {#runtime-error} + +```python +age = 53 +remaining = 100 - aege # mis-spelled 'age' +``` + +```error +NameError Traceback (most recent call last) + in + 1 age = 53 +----> 2 remaining = 100 - aege # mis-spelled 'age' + +NameError: name 'aege' is not defined +``` + +- Fix syntax errors by reading the source and runtime errors by tracing execution. + +::::::::::::::::::::::::::::::::::::::: challenge + +## What Happens When + +1. Explain in simple terms the order of operations in the following program: + when does the addition happen, when does the subtraction happen, + when is each function called, etc. +2. What is the final value of `radiance`? + +```python +radiance = 1.0 +radiance = max(2.1, 2.0 + min(radiance, 1.1 * radiance - 0.5)) +``` + +::::::::::::::: solution + +## Solution + +1. Order of operations: + 1. `1.1 * radiance = 1.1` + 2. `1.1 - 0.5 = 0.6` + 3. `min(radiance, 0.6) = 0.6` + 4. `2.0 + 0.6 = 2.6` + 5. `max(2.1, 2.6) = 2.6` +2. At the end, `radiance = 2.6` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Spot the Difference + +1. Predict what each of the `print` statements in the program below will print. +2. Does `max(len(rich), poor)` run or produce an error message? + If it runs, does its result make any sense? + +```python +easy_string = "abc" +print(max(easy_string)) +rich = "gold" +poor = "tin" +print(max(rich, poor)) +print(max(len(rich), len(poor))) +``` + +::::::::::::::: solution + +## Solution + +```python +print(max(easy_string)) +``` + +```output +c +``` + +```python +print(max(rich, poor)) +``` + +```output +tin +``` + +```python +print(max(len(rich), len(poor))) +``` + +```output +4 +``` + +`max(len(rich), poor)` throws a TypeError. This turns into `max(4, 'tin')` and +as we discussed earlier a string and integer cannot meaningfully be compared. + +```error +TypeError Traceback (most recent call last) + in +----> 1 max(len(rich), poor) + +TypeError: '>' not supported between instances of 'str' and 'int' +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Why Not? + +Why is it that `max` and `min` do not return `None` when they are called with no arguments? + +::::::::::::::: solution + +## Solution + +`max` and `min` return TypeErrors in this case because the correct number of parameters +was not supplied. If it just returned `None`, the error would be much harder to trace as it +would likely be stored into a variable and used later in the program, only to likely throw +a runtime error. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Last Character of a String + +If Python starts counting from zero, +and `len` returns the number of characters in a string, +what index expression will get the last character in the string `name`? +(Note: we will see a simpler way to do this in a later episode.) + +::::::::::::::: solution + +## Solution + +`name[len(name) - 1]` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Explore the Python docs! + +The [official Python documentation](https://docs.python.org/3/) is arguably the most complete +source of information about the language. It is available in different languages and contains a lot of useful +resources. The [Built-in Functions page](https://docs.python.org/3/library/functions.html) contains a catalogue of +all of these functions, including the ones that we've covered in this lesson. Some of these are more advanced and +unnecessary at the moment, but others are very simple and useful. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Use comments to add documentation to programs. +- A function may take zero or more arguments. +- Commonly-used built-in functions include `max`, `min`, and `round`. +- Functions may only work for certain (combinations of) arguments. +- Functions may have default values for some arguments. +- Use the built-in function `help` to get help for a function. +- The Jupyter Notebook has two ways to get help. +- Every function returns something. +- Python reports a syntax error when it can't understand the source of a program. +- Python reports a runtime error when something goes wrong while a program is executing. +- Fix syntax errors by reading the source code, and runtime errors by tracing the program's execution. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/05-coffee.md b/05-coffee.md new file mode 100644 index 000000000..366017b40 --- /dev/null +++ b/05-coffee.md @@ -0,0 +1,16 @@ +--- +title: Morning Coffee +teaching: 0 +exercises: 0 +break: 15 +--- + +## Reflection exercise + +Over coffee, reflect on and discuss the following: + +- What are the different kinds of errors Python will report? +- Did the code always produce the results you expected? If not, why? +- Is there something we can do to prevent errors when we write code? + + diff --git a/06-libraries.md b/06-libraries.md new file mode 100644 index 000000000..b6d23d4b4 --- /dev/null +++ b/06-libraries.md @@ -0,0 +1,470 @@ +--- +title: Libraries +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain what software libraries are and why programmers create and use them. +- Write programs that import and use modules from Python's standard library. +- Find and read documentation for the standard library interactively (in the interpreter) and online. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I use software that other people have written? +- How can I find out what that software does? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Most of the power of a programming language is in its libraries. + +- A *library* is a collection of files (called *modules*) that contains + functions for use by other programs. + - May also contain data values (e.g., numerical constants) and other things. + - Library's contents are supposed to be related, but there's no way to enforce that. +- The Python [standard library][stdlib] is an extensive suite of modules that comes + with Python itself. +- Many additional libraries are available from [PyPI][pypi] (the Python Package Index). +- We will see later how to write new libraries. + +::::::::::::::::::::::::::::::::::::::::: callout + +## Libraries and modules + +A library is a collection of modules, but the terms are often used +interchangeably, especially since many libraries only consist of a single +module, so don't worry if you mix them. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## A program must import a library module before using it. + +- Use `import` to load a library module into a program's memory. +- Then refer to things from the module as `module_name.thing_name`. + - Python uses `.` to mean "part of". +- Using `math`, one of the modules in the standard library: + +```python +import math + +print('pi is', math.pi) +print('cos(pi) is', math.cos(math.pi)) +``` + +```output +pi is 3.141592653589793 +cos(pi) is -1.0 +``` + +- Have to refer to each item with the module's name. + - `math.cos(pi)` won't work: the reference to `pi` + doesn't somehow "inherit" the function's reference to `math`. + +## Use `help` to learn about the contents of a library module. + +- Works just like help for a function. + +```python +help(math) +``` + +```output +Help on module math: + +NAME + math + +MODULE REFERENCE + http://docs.python.org/3/library/math + + The following documentation is automatically generated from the Python + source files. It may be incomplete, incorrect or include features that + are considered implementation detail and may vary between Python + implementations. When in doubt, consult the module reference at the + location listed above. + +DESCRIPTION + This module is always available. It provides access to the + mathematical functions defined by the C standard. + +FUNCTIONS + acos(x, /) + Return the arc cosine (measured in radians) of x. +⋮ ⋮ ⋮ +``` + +## Import specific items from a library module to shorten programs. + +- Use `from ... import ...` to load only specific items from a library module. +- Then refer to them directly without library name as prefix. + +```python +from math import cos, pi + +print('cos(pi) is', cos(pi)) +``` + +```output +cos(pi) is -1.0 +``` + +## Create an alias for a library module when importing it to shorten programs. + +- Use `import ... as ...` to give a library a short *alias* while importing it. +- Then refer to items in the library using that shortened name. + +```python +import math as m + +print('cos(pi) is', m.cos(m.pi)) +``` + +```output +cos(pi) is -1.0 +``` + +- Commonly used for libraries that are frequently used or have long names. + - E.g., the `matplotlib` plotting library is often aliased as `mpl`. +- But can make programs harder to understand, + since readers must learn your program's aliases. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Exploring the Math Module + +1. What function from the `math` module can you use to calculate a square root + *without* using `sqrt`? +2. Since the library contains this function, why does `sqrt` exist? + +::::::::::::::: solution + +## Solution + +1. Using `help(math)` we see that we've got `pow(x,y)` in addition to `sqrt(x)`, + so we could use `pow(x, 0.5)` to find a square root. + +2. The `sqrt(x)` function is arguably more readable than `pow(x, 0.5)` when + implementing equations. Readability is a cornerstone of good programming, so it + makes sense to provide a special function for this specific common case. + + Also, the design of Python's `math` library has its origin in the C standard, + which includes both `sqrt(x)` and `pow(x,y)`, so a little bit of the history + of programming is showing in Python's function names. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Locating the Right Module + +You want to select a random character from a string: + +```python +bases = 'ACTTGCTTGAC' +``` + +1. Which [standard library][stdlib] module could help you? +2. Which function would you select from that module? Are there alternatives? +3. Try to write a program that uses the function. + +::::::::::::::: solution + +## Solution + +The [random module][randommod] seems like it could help. + +The string has 11 characters, each having a positional index from 0 to 10. +You could use the [`random.randrange`](https://docs.python.org/3/library/random.html#random.randrange) +or [`random.randint`](https://docs.python.org/3/library/random.html#random.randint) functions +to get a random integer between 0 and 10, and then select the `bases` character at that index: + +```python +from random import randrange + +random_index = randrange(len(bases)) +print(bases[random_index]) +``` + +or more compactly: + +```python +from random import randrange + +print(bases[randrange(len(bases))]) +``` + +Perhaps you found the [`random.sample`](https://docs.python.org/3/library/random.html#random.sample) function? +It allows for slightly less typing but might be a bit harder to understand just by reading: + +```python +from random import sample + +print(sample(bases, 1)[0]) +``` + +Note that this function returns a list of values. We will learn about +lists in [episode 11](11-lists.md). + +The simplest and shortest solution is the [`random.choice`](https://docs.python.org/3/library/random.html#random.choice) +function that does exactly what we want: + +```python +from random import choice + +print(choice(bases)) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Jigsaw Puzzle (Parson's Problem) Programming Example + +Rearrange the following statements so that a random +DNA base is printed and its index in the string. +Not all statements may be needed. Feel free to use/add +intermediate variables. + +```python +bases="ACTTGCTTGAC" +import math +import random +___ = random.randrange(n_bases) +___ = len(bases) +print("random base ", bases[___], "base index", ___) +``` + +::::::::::::::: solution + +## Solution + +```python +import math +import random +bases = "ACTTGCTTGAC" +n_bases = len(bases) +idx = random.randrange(n_bases) +print("random base", bases[idx], "base index", idx) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## When Is Help Available? + +When a colleague of yours types `help(math)`, +Python reports an error: + +```error +NameError: name 'math' is not defined +``` + +What has your colleague forgotten to do? + +::::::::::::::: solution + +## Solution + +Importing the math module (`import math`) + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Importing With Aliases + +1. Fill in the blanks so that the program below prints `90.0`. +2. Rewrite the program so that it uses `import` *without* `as`. +3. Which form do you find easier to read? + +```python +import math as m +angle = ____.degrees(____.pi / 2) +print(____) +``` + +::::::::::::::: solution + +## Solution + +```python +import math as m +angle = m.degrees(m.pi / 2) +print(angle) +``` + +can be written as + +```python +import math +angle = math.degrees(math.pi / 2) +print(angle) +``` + +Since you just wrote the code and are familiar with it, you might actually +find the first version easier to read. But when trying to read a huge piece +of code written by someone else, or when getting back to your own huge piece +of code after several months, non-abbreviated names are often easier, except +where there are clear abbreviation conventions. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## There Are Many Ways To Import Libraries! + +Match the following print statements with the appropriate library calls. + +Print commands: + +1. `print("sin(pi/2) =", sin(pi/2))` +2. `print("sin(pi/2) =", m.sin(m.pi/2))` +3. `print("sin(pi/2) =", math.sin(math.pi/2))` + +Library calls: + +1. `from math import sin, pi` +2. `import math` +3. `import math as m` +4. `from math import *` + +::::::::::::::: solution + +## Solution + +1. Library calls 1 and 4. In order to directly refer to `sin` and `pi` without + the library name as prefix, you need to use the `from ... import ...` + statement. Whereas library call 1 specifically imports the two functions + `sin` and `pi`, library call 4 imports all functions in the `math` module. +2. Library call 3. Here `sin` and `pi` are referred to with a shortened library + name `m` instead of `math`. Library call 3 does exactly that using the + `import ... as ...` syntax - it creates an alias for `math` in the form of + the shortened name `m`. +3. Library call 2. Here `sin` and `pi` are referred to with the regular library + name `math`, so the regular `import ...` call suffices. + +**Note:** although library call 4 works, importing all names from a module using a wildcard +import is [not recommended][pep8-imports] as it makes it unclear which names from the module +are used in the code. In general it is best to make your imports as specific as possible and to +only import what your code uses. In library call 1, the `import` statement explicitly tells us +that the `sin` function is imported from the `math` module, but library call 4 does not +convey this information. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Importing Specific Items + +1. Fill in the blanks so that the program below prints `90.0`. +2. Do you find this version easier to read than preceding ones? +3. Why *wouldn't* programmers always use this form of `import`? + +```python +____ math import ____, ____ +angle = degrees(pi / 2) +print(angle) +``` + +::::::::::::::: solution + +## Solution + +```python +from math import degrees, pi +angle = degrees(pi / 2) +print(angle) +``` + +Most likely you find this version easier to read since it's less dense. +The main reason not to use this form of import is to avoid name clashes. +For instance, you wouldn't import `degrees` this way if you also wanted to +use the name `degrees` for a variable or function of your own. Or if you +were to also import a function named `degrees` from another library. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reading Error Messages + +1. Read the code below and try to identify what the errors are without running it. +2. Run the code, and read the error message. What type of error is it? + +```python +from math import log +log(0) +``` + +::::::::::::::: solution + +## Solution + +```output +--------------------------------------------------------------------------- +ValueError Traceback (most recent call last) + in + 1 from math import log +----> 2 log(0) + +ValueError: math domain error +``` + +1. The logarithm of `x` is only defined for `x > 0`, so 0 is outside the + domain of the function. +2. You get an error of type `ValueError`, indicating that the function + received an inappropriate argument value. The additional message + "math domain error" makes it clearer what the problem is. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +[stdlib]: https://docs.python.org/3/library/ +[pypi]: https://pypi.python.org/pypi/ +[randommod]: https://docs.python.org/3/library/random.html +[pep8-imports]: https://pep8.org/#imports + + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Most of the power of a programming language is in its libraries. +- A program must import a library module in order to use it. +- Use `help` to learn about the contents of a library module. +- Import specific items from a library to shorten programs. +- Create an alias for a library when importing it to shorten programs. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/07-reading-tabular.md b/07-reading-tabular.md new file mode 100644 index 000000000..d4cc4c37e --- /dev/null +++ b/07-reading-tabular.md @@ -0,0 +1,442 @@ +--- +title: Reading Tabular Data into DataFrames +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Import the Pandas library. +- Use Pandas to load a simple CSV data set. +- Get some basic information about a Pandas DataFrame. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I read tabular data? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Use the Pandas library to do statistics on tabular data. + +- [Pandas](https://pandas.pydata.org/) is a widely-used Python library for statistics, particularly on tabular data. +- Borrows many features from R's dataframes. + - A 2-dimensional table whose columns have names + and potentially have different data types. +- Load Pandas with `import pandas as pd`. The alias `pd` is commonly used to refer to the Pandas library in code. +- Read a Comma Separated Values (CSV) data file with `pd.read_csv`. + - Argument is the name of the file to be read. + - Returns a dataframe that you can assign to a variable + +```python +import pandas as pd + +data_oceania = pd.read_csv('data/gapminder_gdp_oceania.csv') +print(data_oceania) +``` + +```output + country gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 \ +0 Australia 10039.59564 10949.64959 12217.22686 +1 New Zealand 10556.57566 12247.39532 13175.67800 + + gdpPercap_1967 gdpPercap_1972 gdpPercap_1977 gdpPercap_1982 \ +0 14526.12465 16788.62948 18334.19751 19477.00928 +1 14463.91893 16046.03728 16233.71770 17632.41040 + + gdpPercap_1987 gdpPercap_1992 gdpPercap_1997 gdpPercap_2002 \ +0 21888.88903 23424.76683 26997.93657 30687.75473 +1 19007.19129 18363.32494 21050.41377 23189.80135 + + gdpPercap_2007 +0 34435.36744 +1 25185.00911 +``` + +- The columns in a dataframe are the observed variables, and the rows are the observations. +- Pandas uses backslash `\` to show wrapped lines when output is too wide to fit the screen. +- Using descriptive dataframe names helps us distinguish between multiple dataframes so we won't accidentally overwrite a dataframe or read from the wrong one. + +::::::::::::::::::::::::::::::::::::::::: callout + +## File Not Found + +Our lessons store their data files in a `data` sub-directory, +which is why the path to the file is `data/gapminder_gdp_oceania.csv`. +If you forget to include `data/`, +or if you include it but your copy of the file is somewhere else, +you will get a [runtime error](04-built-in.md) +that ends with a line like this: + +```error +FileNotFoundError: [Errno 2] No such file or directory: 'data/gapminder_gdp_oceania.csv' +``` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Use `index_col` to specify that a column's values should be used as row headings. + +- Row headings are numbers (0 and 1 in this case). +- Really want to index by country. +- Pass the name of the column to `read_csv` as its `index_col` parameter to do this. +- Naming the dataframe `data_oceania_country` tells us which region the data includes (`oceania`) and how it is indexed (`country`). + +```python +data_oceania_country = pd.read_csv('data/gapminder_gdp_oceania.csv', index_col='country') +print(data_oceania_country) +``` + +```output + gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 gdpPercap_1967 \ +country +Australia 10039.59564 10949.64959 12217.22686 14526.12465 +New Zealand 10556.57566 12247.39532 13175.67800 14463.91893 + + gdpPercap_1972 gdpPercap_1977 gdpPercap_1982 gdpPercap_1987 \ +country +Australia 16788.62948 18334.19751 19477.00928 21888.88903 +New Zealand 16046.03728 16233.71770 17632.41040 19007.19129 + + gdpPercap_1992 gdpPercap_1997 gdpPercap_2002 gdpPercap_2007 +country +Australia 23424.76683 26997.93657 30687.75473 34435.36744 +New Zealand 18363.32494 21050.41377 23189.80135 25185.00911 +``` + +## Use the `DataFrame.info()` method to find out more about a dataframe. + +```python +data_oceania_country.info() +``` + +```output + +Index: 2 entries, Australia to New Zealand +Data columns (total 12 columns): +gdpPercap_1952 2 non-null float64 +gdpPercap_1957 2 non-null float64 +gdpPercap_1962 2 non-null float64 +gdpPercap_1967 2 non-null float64 +gdpPercap_1972 2 non-null float64 +gdpPercap_1977 2 non-null float64 +gdpPercap_1982 2 non-null float64 +gdpPercap_1987 2 non-null float64 +gdpPercap_1992 2 non-null float64 +gdpPercap_1997 2 non-null float64 +gdpPercap_2002 2 non-null float64 +gdpPercap_2007 2 non-null float64 +dtypes: float64(12) +memory usage: 208.0+ bytes +``` + +- This is a `DataFrame` +- Two rows named `'Australia'` and `'New Zealand'` +- Twelve columns, each of which has two actual 64-bit floating point values. + - We will talk later about null values, which are used to represent missing observations. +- Uses 208 bytes of memory. + +## The `DataFrame.columns` variable stores information about the dataframe's columns. + +- Note that this is data, *not* a method. (It doesn't have parentheses.) + - Like `math.pi`. + - So do not use `()` to try to call it. +- Called a *member variable*, or just *member*. + +```python +print(data_oceania_country.columns) +``` + +```output +Index(['gdpPercap_1952', 'gdpPercap_1957', 'gdpPercap_1962', 'gdpPercap_1967', + 'gdpPercap_1972', 'gdpPercap_1977', 'gdpPercap_1982', 'gdpPercap_1987', + 'gdpPercap_1992', 'gdpPercap_1997', 'gdpPercap_2002', 'gdpPercap_2007'], + dtype='object') +``` + +## Use `DataFrame.T` to transpose a dataframe. + +- Sometimes want to treat columns as rows and vice versa. +- Transpose (written `.T`) doesn't copy the data, just changes the program's view of it. +- Like `columns`, it is a member variable. + +```python +print(data_oceania_country.T) +``` + +```output +country Australia New Zealand +gdpPercap_1952 10039.59564 10556.57566 +gdpPercap_1957 10949.64959 12247.39532 +gdpPercap_1962 12217.22686 13175.67800 +gdpPercap_1967 14526.12465 14463.91893 +gdpPercap_1972 16788.62948 16046.03728 +gdpPercap_1977 18334.19751 16233.71770 +gdpPercap_1982 19477.00928 17632.41040 +gdpPercap_1987 21888.88903 19007.19129 +gdpPercap_1992 23424.76683 18363.32494 +gdpPercap_1997 26997.93657 21050.41377 +gdpPercap_2002 30687.75473 23189.80135 +gdpPercap_2007 34435.36744 25185.00911 +``` + +## Use `DataFrame.describe()` to get summary statistics about data. + +`DataFrame.describe()` gets the summary statistics of only the columns that have numerical data. +All other columns are ignored, unless you use the argument `include='all'`. + +```python +print(data_oceania_country.describe()) +``` + +```output + gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 gdpPercap_1967 \ +count 2.000000 2.000000 2.000000 2.000000 +mean 10298.085650 11598.522455 12696.452430 14495.021790 +std 365.560078 917.644806 677.727301 43.986086 +min 10039.595640 10949.649590 12217.226860 14463.918930 +25% 10168.840645 11274.086022 12456.839645 14479.470360 +50% 10298.085650 11598.522455 12696.452430 14495.021790 +75% 10427.330655 11922.958888 12936.065215 14510.573220 +max 10556.575660 12247.395320 13175.678000 14526.124650 + + gdpPercap_1972 gdpPercap_1977 gdpPercap_1982 gdpPercap_1987 \ +count 2.00000 2.000000 2.000000 2.000000 +mean 16417.33338 17283.957605 18554.709840 20448.040160 +std 525.09198 1485.263517 1304.328377 2037.668013 +min 16046.03728 16233.717700 17632.410400 19007.191290 +25% 16231.68533 16758.837652 18093.560120 19727.615725 +50% 16417.33338 17283.957605 18554.709840 20448.040160 +75% 16602.98143 17809.077557 19015.859560 21168.464595 +max 16788.62948 18334.197510 19477.009280 21888.889030 + + gdpPercap_1992 gdpPercap_1997 gdpPercap_2002 gdpPercap_2007 +count 2.000000 2.000000 2.000000 2.000000 +mean 20894.045885 24024.175170 26938.778040 29810.188275 +std 3578.979883 4205.533703 5301.853680 6540.991104 +min 18363.324940 21050.413770 23189.801350 25185.009110 +25% 19628.685413 22537.294470 25064.289695 27497.598692 +50% 20894.045885 24024.175170 26938.778040 29810.188275 +75% 22159.406358 25511.055870 28813.266385 32122.777857 +max 23424.766830 26997.936570 30687.754730 34435.367440 +``` + +- Not particularly useful with just two records, + but very helpful when there are thousands. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reading Other Data + +Read the data in `gapminder_gdp_americas.csv` +(which should be in the same directory as `gapminder_gdp_oceania.csv`) +into a variable called `data_americas` +and display its summary statistics. + +::::::::::::::: solution + +## Solution + +To read in a CSV, we use `pd.read_csv` and pass the filename `'data/gapminder_gdp_americas.csv'` to it. +We also once again pass the column name `'country'` to the parameter `index_col` in order to index by country. +The summary statistics can be displayed with the `DataFrame.describe()` method. + +```python +data_americas = pd.read_csv('data/gapminder_gdp_americas.csv', index_col='country') +data_americas.describe() +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Inspecting Data + +After reading the data for the Americas, +use `help(data_americas.head)` and `help(data_americas.tail)` +to find out what `DataFrame.head` and `DataFrame.tail` do. + +1. What method call will display the first three rows of this data? +2. What method call will display the last three columns of this data? + (Hint: you may need to change your view of the data.) + +::::::::::::::: solution + +## Solution + +1. We can check out the first five rows of `data_americas` by executing `data_americas.head()` + which lets us view the beginning of the DataFrame. We can specify the number of rows we wish + to see by specifying the parameter `n` in our call to `data_americas.head()`. + To view the first three rows, execute: + + ```python + data_americas.head(n=3) + ``` + + ```output + continent gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 \ + country + Argentina Americas 5911.315053 6856.856212 7133.166023 + Bolivia Americas 2677.326347 2127.686326 2180.972546 + Brazil Americas 2108.944355 2487.365989 3336.585802 + + gdpPercap_1967 gdpPercap_1972 gdpPercap_1977 gdpPercap_1982 \ + country + Argentina 8052.953021 9443.038526 10079.026740 8997.897412 + Bolivia 2586.886053 2980.331339 3548.097832 3156.510452 + Brazil 3429.864357 4985.711467 6660.118654 7030.835878 + + gdpPercap_1987 gdpPercap_1992 gdpPercap_1997 gdpPercap_2002 \ + country + Argentina 9139.671389 9308.418710 10967.281950 8797.640716 + Bolivia 2753.691490 2961.699694 3326.143191 3413.262690 + Brazil 7807.095818 6950.283021 7957.980824 8131.212843 + + gdpPercap_2007 + country + Argentina 12779.379640 + Bolivia 3822.137084 + Brazil 9065.800825 + ``` + +2. To check out the last three rows of `data_americas`, we would use the command, + `americas.tail(n=3)`, analogous to `head()` used above. However, here we want to look at + the last three columns so we need to change our view and then use `tail()`. To do so, we + create a new DataFrame in which rows and columns are switched: + + ```python + americas_flipped = data_americas.T + ``` + + We can then view the last three columns of `americas` by viewing the last three rows + of `americas_flipped`: + + ```python + americas_flipped.tail(n=3) + ``` + + ```output + country Argentina Bolivia Brazil Canada Chile Colombia \ + gdpPercap_1997 10967.3 3326.14 7957.98 28954.9 10118.1 6117.36 + gdpPercap_2002 8797.64 3413.26 8131.21 33329 10778.8 5755.26 + gdpPercap_2007 12779.4 3822.14 9065.8 36319.2 13171.6 7006.58 + + country Costa Rica Cuba Dominican Republic Ecuador ... \ + gdpPercap_1997 6677.05 5431.99 3614.1 7429.46 ... + gdpPercap_2002 7723.45 6340.65 4563.81 5773.04 ... + gdpPercap_2007 9645.06 8948.1 6025.37 6873.26 ... + + country Mexico Nicaragua Panama Paraguay Peru Puerto Rico \ + gdpPercap_1997 9767.3 2253.02 7113.69 4247.4 5838.35 16999.4 + gdpPercap_2002 10742.4 2474.55 7356.03 3783.67 5909.02 18855.6 + gdpPercap_2007 11977.6 2749.32 9809.19 4172.84 7408.91 19328.7 + + country Trinidad and Tobago United States Uruguay Venezuela + gdpPercap_1997 8792.57 35767.4 9230.24 10165.5 + gdpPercap_2002 11460.6 39097.1 7727 8605.05 + gdpPercap_2007 18008.5 42951.7 10611.5 11415.8 + ``` + + This shows the data that we want, but we may prefer to display three columns instead of three rows, + so we can flip it back: + + ```python + americas_flipped.tail(n=3).T + ``` + + **Note:** we could have done the above in a single line of code by 'chaining' the commands: + + ```python + data_americas.T.tail(n=3).T + ``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reading Files in Other Directories + +The data for your current project is stored in a file called `microbes.csv`, +which is located in a folder called `field_data`. +You are doing analysis in a notebook called `analysis.ipynb` +in a sibling folder called `thesis`: + +```output +your_home_directory ++-- field_data/ +| +-- microbes.csv ++-- thesis/ + +-- analysis.ipynb +``` + +What value(s) should you pass to `read_csv` to read `microbes.csv` in `analysis.ipynb`? + +::::::::::::::: solution + +## Solution + +We need to specify the path to the file of interest in the call to `pd.read_csv`. We first need to 'jump' out of +the folder `thesis` using '../' and then into the folder `field_data` using 'field\_data/'. Then we can specify the filename \`microbes.csv. +The result is as follows: + +```python +data_microbes = pd.read_csv('../field_data/microbes.csv') +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Writing Data + +As well as the `read_csv` function for reading data from a file, +Pandas provides a `to_csv` function to write dataframes to files. +Applying what you've learned about reading from files, +write one of your dataframes to a file called `processed.csv`. +You can use `help` to get information on how to use `to_csv`. + +::::::::::::::: solution + +## Solution + +In order to write the DataFrame `data_americas` to a file called `processed.csv`, execute the following command: + +```python +data_americas.to_csv('processed.csv') +``` + +For help on `read_csv` or `to_csv`, you could execute, for example: + +```python +help(data_americas.to_csv) +help(pd.read_csv) +``` + +Note that `help(to_csv)` or `help(pd.to_csv)` throws an error! This is due to the fact that `to_csv` is not a global Pandas function, but +a member function of DataFrames. This means you can only call it on an instance of a DataFrame +e.g., `data_americas.to_csv` or `data_oceania.to_csv` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Use the Pandas library to get basic statistics out of tabular data. +- Use `index_col` to specify that a column's values should be used as row headings. +- Use `DataFrame.info` to find out more about a dataframe. +- The `DataFrame.columns` variable stores information about the dataframe's columns. +- Use `DataFrame.T` to transpose a dataframe. +- Use `DataFrame.describe` to get summary statistics about data. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/08-data-frames.md b/08-data-frames.md new file mode 100644 index 000000000..b57e4ff6d --- /dev/null +++ b/08-data-frames.md @@ -0,0 +1,783 @@ +--- +title: Pandas DataFrames +teaching: 15 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Select individual values from a Pandas dataframe. +- Select entire rows or entire columns from a dataframe. +- Select a subset of both rows and columns from a dataframe in a single operation. +- Select a subset of a dataframe by a single Boolean criterion. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I do statistical analysis of tabular data? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Note about Pandas DataFrames/Series + +A [DataFrame][pandas-dataframe] is a collection of [Series][pandas-series]; +The DataFrame is the way Pandas represents a table, and Series is the data-structure +Pandas use to represent a column. + +Pandas is built on top of the [Numpy][numpy] library, which in practice means that +most of the methods defined for Numpy Arrays apply to Pandas Series/DataFrames. + +What makes Pandas so attractive is the powerful interface to access individual records +of the table, proper handling of missing values, and relational-databases operations +between DataFrames. + +## Selecting values + +To access a value at the position `[i,j]` of a DataFrame, we have two options, depending on +what is the meaning of `i` in use. +Remember that a DataFrame provides an *index* as a way to identify the rows of the table; +a row, then, has a *position* inside the table as well as a *label*, which +uniquely identifies its *entry* in the DataFrame. + +## Use `DataFrame.iloc[..., ...]` to select values by their (entry) position + +- Can specify location by numerical index analogously to 2D version of character selection in strings. + +```python +import pandas as pd +data = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country') +print(data.iloc[0, 0]) +``` + +```output +1601.056136 +``` + +## Use `DataFrame.loc[..., ...]` to select values by their (entry) label. + +- Can specify location by row and/or column name. + +```python +print(data.loc["Albania", "gdpPercap_1952"]) +``` + +```output +1601.056136 +``` + +## Use `:` on its own to mean all columns or all rows. + +- Just like Python's usual slicing notation. + +```python +print(data.loc["Albania", :]) +``` + +```output +gdpPercap_1952 1601.056136 +gdpPercap_1957 1942.284244 +gdpPercap_1962 2312.888958 +gdpPercap_1967 2760.196931 +gdpPercap_1972 3313.422188 +gdpPercap_1977 3533.003910 +gdpPercap_1982 3630.880722 +gdpPercap_1987 3738.932735 +gdpPercap_1992 2497.437901 +gdpPercap_1997 3193.054604 +gdpPercap_2002 4604.211737 +gdpPercap_2007 5937.029526 +Name: Albania, dtype: float64 +``` + +- Would get the same result printing `data.loc["Albania"]` (without a second index). + +```python +print(data.loc[:, "gdpPercap_1952"]) +``` + +```output +country +Albania 1601.056136 +Austria 6137.076492 +Belgium 8343.105127 +⋮ ⋮ ⋮ +Switzerland 14734.232750 +Turkey 1969.100980 +United Kingdom 9979.508487 +Name: gdpPercap_1952, dtype: float64 +``` + +- Would get the same result printing `data["gdpPercap_1952"]` +- Also get the same result printing `data.gdpPercap_1952` (not recommended, because easily confused with `.` notation for methods) + +## Select multiple columns or rows using `DataFrame.loc` and a named slice. + +```python +print(data.loc['Italy':'Poland', 'gdpPercap_1962':'gdpPercap_1972']) +``` + +```output + gdpPercap_1962 gdpPercap_1967 gdpPercap_1972 +country +Italy 8243.582340 10022.401310 12269.273780 +Montenegro 4649.593785 5907.850937 7778.414017 +Netherlands 12790.849560 15363.251360 18794.745670 +Norway 13450.401510 16361.876470 18965.055510 +Poland 5338.752143 6557.152776 8006.506993 +``` + +In the above code, we discover that **slicing using `loc` is inclusive at both +ends**, which differs from **slicing using `iloc`**, where slicing indicates +everything up to but not including the final index. + +## Result of slicing can be used in further operations. + +- Usually don't just print a slice. +- All the statistical operators that work on entire dataframes + work the same way on slices. +- E.g., calculate max of a slice. + +```python +print(data.loc['Italy':'Poland', 'gdpPercap_1962':'gdpPercap_1972'].max()) +``` + +```output +gdpPercap_1962 13450.40151 +gdpPercap_1967 16361.87647 +gdpPercap_1972 18965.05551 +dtype: float64 +``` + +```python +print(data.loc['Italy':'Poland', 'gdpPercap_1962':'gdpPercap_1972'].min()) +``` + +```output +gdpPercap_1962 4649.593785 +gdpPercap_1967 5907.850937 +gdpPercap_1972 7778.414017 +dtype: float64 +``` + +## Use comparisons to select data based on value. + +- Comparison is applied element by element. +- Returns a similarly-shaped dataframe of `True` and `False`. + +```python +# Use a subset of data to keep output readable. +subset = data.loc['Italy':'Poland', 'gdpPercap_1962':'gdpPercap_1972'] +print('Subset of data:\n', subset) + +# Which values were greater than 10000 ? +print('\nWhere are values large?\n', subset > 10000) +``` + +```output +Subset of data: + gdpPercap_1962 gdpPercap_1967 gdpPercap_1972 +country +Italy 8243.582340 10022.401310 12269.273780 +Montenegro 4649.593785 5907.850937 7778.414017 +Netherlands 12790.849560 15363.251360 18794.745670 +Norway 13450.401510 16361.876470 18965.055510 +Poland 5338.752143 6557.152776 8006.506993 + +Where are values large? + gdpPercap_1962 gdpPercap_1967 gdpPercap_1972 +country +Italy False True True +Montenegro False False False +Netherlands True True True +Norway True True True +Poland False False False +``` + +## Select values or NaN using a Boolean mask. + +- A frame full of Booleans is sometimes called a *mask* because of how it can be used. + +```python +mask = subset > 10000 +print(subset[mask]) +``` + +```output + gdpPercap_1962 gdpPercap_1967 gdpPercap_1972 +country +Italy NaN 10022.40131 12269.27378 +Montenegro NaN NaN NaN +Netherlands 12790.84956 15363.25136 18794.74567 +Norway 13450.40151 16361.87647 18965.05551 +Poland NaN NaN NaN +``` + +- Get the value where the mask is true, and NaN (Not a Number) where it is false. +- Useful because NaNs are ignored by operations like max, min, average, etc. + +```python +print(subset[subset > 10000].describe()) +``` + +```output + gdpPercap_1962 gdpPercap_1967 gdpPercap_1972 +count 2.000000 3.000000 3.000000 +mean 13120.625535 13915.843047 16676.358320 +std 466.373656 3408.589070 3817.597015 +min 12790.849560 10022.401310 12269.273780 +25% 12955.737547 12692.826335 15532.009725 +50% 13120.625535 15363.251360 18794.745670 +75% 13285.513523 15862.563915 18879.900590 +max 13450.401510 16361.876470 18965.055510 +``` + +## Group By: split-apply-combine + +::::::::::::::::::::::::::::::::::::: instructor +Learners often struggle here, many may not work with financial data and concepts so they +find the example concepts difficult to get their head around. The biggest problem +though is the line generating the wealth_score, this step needs to be talked through +throughly: +* It uses implicit conversion between boolean and float values which +has not been covered in the course so far. +* The axis=1 argument needs to be explained clearly. +::::::::::::::::::::::::::::::::::::::::::::::::: + +Pandas vectorizing methods and grouping operations are features that provide users +much flexibility to analyse their data. + +For instance, let's say we want to have a clearer view on how the European countries +split themselves according to their GDP. + +1. We may have a glance by splitting the countries in two groups during the years surveyed, + those who presented a GDP *higher* than the European average and those with a *lower* GDP. +2. We then estimate a *wealthy score* based on the historical (from 1962 to 2007) values, + where we account how many times a country has participated in the groups of *lower* or *higher* GDP + +```python +mask_higher = data > data.mean() +wealth_score = mask_higher.aggregate('sum', axis=1) / len(data.columns) +print(wealth_score) +``` + +```output +country +Albania 0.000000 +Austria 1.000000 +Belgium 1.000000 +Bosnia and Herzegovina 0.000000 +Bulgaria 0.000000 +Croatia 0.000000 +Czech Republic 0.500000 +Denmark 1.000000 +Finland 1.000000 +France 1.000000 +Germany 1.000000 +Greece 0.333333 +Hungary 0.000000 +Iceland 1.000000 +Ireland 0.333333 +Italy 0.500000 +Montenegro 0.000000 +Netherlands 1.000000 +Norway 1.000000 +Poland 0.000000 +Portugal 0.000000 +Romania 0.000000 +Serbia 0.000000 +Slovak Republic 0.000000 +Slovenia 0.333333 +Spain 0.333333 +Sweden 1.000000 +Switzerland 1.000000 +Turkey 0.000000 +United Kingdom 1.000000 +dtype: float64 +``` + +Finally, for each group in the `wealth_score` table, we sum their (financial) contribution +across the years surveyed using chained methods: + +```python +print(data.groupby(wealth_score).sum()) +``` + +```output + gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 gdpPercap_1967 \ +0.000000 36916.854200 46110.918793 56850.065437 71324.848786 +0.333333 16790.046878 20942.456800 25744.935321 33567.667670 +0.500000 11807.544405 14505.000150 18380.449470 21421.846200 +1.000000 104317.277560 127332.008735 149989.154201 178000.350040 + + gdpPercap_1972 gdpPercap_1977 gdpPercap_1982 gdpPercap_1987 \ +0.000000 88569.346898 104459.358438 113553.768507 119649.599409 +0.333333 45277.839976 53860.456750 59679.634020 64436.912960 +0.500000 25377.727380 29056.145370 31914.712050 35517.678220 +1.000000 215162.343140 241143.412730 263388.781960 296825.131210 + + gdpPercap_1992 gdpPercap_1997 gdpPercap_2002 gdpPercap_2007 +0.000000 92380.047256 103772.937598 118590.929863 149577.357928 +0.333333 67918.093220 80876.051580 102086.795210 122803.729520 +0.500000 36310.666080 40723.538700 45564.308390 51403.028210 +1.000000   315238.235970   346930.926170   385109.939210   427850.333420 +``` + +::::::::::::::::::::::::::::::::::::::: challenge + +## Selection of Individual Values + +Assume Pandas has been imported into your notebook +and the Gapminder GDP data for Europe has been loaded: + +```python +import pandas as pd + +data_europe = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country') +``` + +Write an expression to find the Per Capita GDP of Serbia in 2007. + +::::::::::::::: solution + +## Solution + +The selection can be done by using the labels for both the row ("Serbia") and the column ("gdpPercap\_2007"): + +```python +print(data_europe.loc['Serbia', 'gdpPercap_2007']) +``` + +The output is + +```output +9786.534714 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Extent of Slicing + +1. Do the two statements below produce the same output? +2. Based on this, + what rule governs what is included (or not) in numerical slices and named slices in Pandas? + +```python +print(data_europe.iloc[0:2, 0:2]) +print(data_europe.loc['Albania':'Belgium', 'gdpPercap_1952':'gdpPercap_1962']) +``` + +::::::::::::::: solution + +## Solution + +No, they do not produce the same output! The output of the first statement is: + +```output + gdpPercap_1952 gdpPercap_1957 +country +Albania 1601.056136 1942.284244 +Austria 6137.076492 8842.598030 +``` + +The second statement gives: + +```output + gdpPercap_1952 gdpPercap_1957 gdpPercap_1962 +country +Albania 1601.056136 1942.284244 2312.888958 +Austria 6137.076492 8842.598030 10750.721110 +Belgium 8343.105127 9714.960623 10991.206760 +``` + +Clearly, the second statement produces an additional column and an additional row compared to the first statement. +What conclusion can we draw? We see that a numerical slice, 0:2, *omits* the final index (i.e. index 2) +in the range provided, +while a named slice, 'gdpPercap\_1952':'gdpPercap\_1962', *includes* the final element. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reconstructing Data + +Explain what each line in the following short program does: +what is in `first`, `second`, etc.? + +```python +first = pd.read_csv('data/gapminder_all.csv', index_col='country') +second = first[first['continent'] == 'Americas'] +third = second.drop('Puerto Rico') +fourth = third.drop('continent', axis = 1) +fourth.to_csv('result.csv') +``` + +::::::::::::::: solution + +## Solution + +Let's go through this piece of code line by line. + +```python +first = pd.read_csv('data/gapminder_all.csv', index_col='country') +``` + +This line loads the dataset containing the GDP data from all countries into a dataframe called +`first`. The `index_col='country'` parameter selects which column to use as the +row labels in the dataframe. + +```python +second = first[first['continent'] == 'Americas'] +``` + +This line makes a selection: only those rows of `first` for which the 'continent' column matches +'Americas' are extracted. Notice how the Boolean expression inside the brackets, +`first['continent'] == 'Americas'`, is used to select only those rows where the expression is true. +Try printing this expression! Can you print also its individual True/False elements? +(hint: first assign the expression to a variable) + +```python +third = second.drop('Puerto Rico') +``` + +As the syntax suggests, this line drops the row from `second` where the label is 'Puerto Rico'. The +resulting dataframe `third` has one row less than the original dataframe `second`. + +```python +fourth = third.drop('continent', axis = 1) +``` + +Again we apply the drop function, but in this case we are dropping not a row but a whole column. +To accomplish this, we need to specify also the `axis` parameter (we want to drop the second column +which has index 1). + +```python +fourth.to_csv('result.csv') +``` + +The final step is to write the data that we have been working on to a csv file. Pandas makes this easy +with the `to_csv()` function. The only required argument to the function is the filename. Note that the +file will be written in the directory from which you started the Jupyter or Python session. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Selecting Indices + +Explain in simple terms what `idxmin` and `idxmax` do in the short program below. +When would you use these methods? + +```python +data = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country') +print(data.idxmin()) +print(data.idxmax()) +``` + +::::::::::::::: solution + +## Solution + +For each column in `data`, `idxmin` will return the index value corresponding to each column's minimum; +`idxmax` will do accordingly the same for each column's maximum value. + +You can use these functions whenever you want to get the row index of the minimum/maximum value and not the actual minimum/maximum value. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Practice with Selection + +Assume Pandas has been imported and the Gapminder GDP data for Europe has been loaded. +Write an expression to select each of the following: + +1. GDP per capita for all countries in 1982. +2. GDP per capita for Denmark for all years. +3. GDP per capita for all countries for years *after* 1985. +4. GDP per capita for each country in 2007 as a multiple of + GDP per capita for that country in 1952. + +::::::::::::::: solution + +## Solution + +1: + +```python +data['gdpPercap_1982'] +``` + +2: + +```python +data.loc['Denmark',:] +``` + +3: + +```python +data.loc[:,'gdpPercap_1985':] +``` + +Pandas is smart enough to recognize the number at the end of the column label and does not give you an error, although no column named `gdpPercap_1985` actually exists. This is useful if new columns are added to the CSV file later. + +4: + +```python +data['gdpPercap_2007']/data['gdpPercap_1952'] +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Many Ways of Access + +There are at least two ways of accessing a value or slice of a DataFrame: by name or index. +However, there are many others. For example, a single column or row can be accessed either as a `DataFrame` +or a `Series` object. + +Suggest different ways of doing the following operations on a DataFrame: + +1. Access a single column +2. Access a single row +3. Access an individual DataFrame element +4. Access several columns +5. Access several rows +6. Access a subset of specific rows and columns +7. Access a subset of row and column ranges + +::::::::::::::: solution + +## Solution + +1\. Access a single column: + +```python +# by name +data["col_name"] # as a Series +data[["col_name"]] # as a DataFrame + +# by name using .loc +data.T.loc["col_name"] # as a Series +data.T.loc[["col_name"]].T # as a DataFrame + +# Dot notation (Series) +data.col_name + +# by index (iloc) +data.iloc[:, col_index] # as a Series +data.iloc[:, [col_index]] # as a DataFrame + +# using a mask +data.T[data.T.index == "col_name"].T +``` + +2\. Access a single row: + +```python +# by name using .loc +data.loc["row_name"] # as a Series +data.loc[["row_name"]] # as a DataFrame + +# by name +data.T["row_name"] # as a Series +data.T[["row_name"]].T # as a DataFrame + +# by index +data.iloc[row_index] # as a Series +data.iloc[[row_index]] # as a DataFrame + +# using mask +data[data.index == "row_name"] +``` + +3\. Access an individual DataFrame element: + +```python +# by column/row names +data["column_name"]["row_name"] # as a Series + +data[["col_name"]].loc["row_name"] # as a Series +data[["col_name"]].loc[["row_name"]] # as a DataFrame + +data.loc["row_name"]["col_name"] # as a value +data.loc[["row_name"]]["col_name"] # as a Series +data.loc[["row_name"]][["col_name"]] # as a DataFrame + +data.loc["row_name", "col_name"] # as a value +data.loc[["row_name"], "col_name"] # as a Series. Preserves index. Column name is moved to `.name`. +data.loc["row_name", ["col_name"]] # as a Series. Index is moved to `.name.` Sets index to column name. +data.loc[["row_name"], ["col_name"]] # as a DataFrame (preserves original index and column name) + +# by column/row names: Dot notation +data.col_name.row_name + +# by column/row indices +data.iloc[row_index, col_index] # as a value +data.iloc[[row_index], col_index] # as a Series. Preserves index. Column name is moved to `.name` +data.iloc[row_index, [col_index]] # as a Series. Index is moved to `.name.` Sets index to column name. +data.iloc[[row_index], [col_index]] # as a DataFrame (preserves original index and column name) + +# column name + row index +data["col_name"][row_index] +data.col_name[row_index] +data["col_name"].iloc[row_index] + +# column index + row name +data.iloc[:, [col_index]].loc["row_name"] # as a Series +data.iloc[:, [col_index]].loc[["row_name"]] # as a DataFrame + +# using masks +data[data.index == "row_name"].T[data.T.index == "col_name"].T +``` + +4\. Access several columns: + +```python +# by name +data[["col1", "col2", "col3"]] +data.loc[:, ["col1", "col2", "col3"]] + +# by index +data.iloc[:, [col1_index, col2_index, col3_index]] +``` + +5\. Access several rows + +```python +# by name +data.loc[["row1", "row2", "row3"]] + +# by index +data.iloc[[row1_index, row2_index, row3_index]] +``` + +6\. Access a subset of specific rows and columns + +```python +# by names +data.loc[["row1", "row2", "row3"], ["col1", "col2", "col3"]] + +# by indices +data.iloc[[row1_index, row2_index, row3_index], [col1_index, col2_index, col3_index]] + +# column names + row indices +data[["col1", "col2", "col3"]].iloc[[row1_index, row2_index, row3_index]] + +# column indices + row names +data.iloc[:, [col1_index, col2_index, col3_index]].loc[["row1", "row2", "row3"]] +``` + +7\. Access a subset of row and column ranges + +```python +# by name +data.loc["row1":"row2", "col1":"col2"] + +# by index +data.iloc[row1_index:row2_index, col1_index:col2_index] + +# column names + row indices +data.loc[:, "col1_name":"col2_name"].iloc[row1_index:row2_index] + +# column indices + row names +data.iloc[:, col1_index:col2_index].loc["row1":"row2"] +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Exploring available methods using the `dir()` function + +Python includes a `dir()` function that can be used to display all of the available methods (functions) that are built into a data object. In Episode 4, we used some methods with a string. But we can see many more are available by using `dir()`: + +```python +my_string = 'Hello world!' # creation of a string object +dir(my_string) +``` + +This command returns: + +```python +['__add__', +... +'__subclasshook__', +'capitalize', +'casefold', +'center', +... +'upper', +'zfill'] +``` + +You can use `help()` or Shift\+Tab to get more information about what these methods do. + +Assume Pandas has been imported and the Gapminder GDP data for Europe has been loaded as `data`. Then, use `dir()` +to find the function that prints out the median per-capita GDP across all European countries for each year that information is available. + +::::::::::::::: solution + +## Solution + +Among many choices, `dir()` lists the `median()` function as a possibility. Thus, + +```python +data.median() +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Interpretation + +Poland's borders have been stable since 1945, +but changed several times in the years before then. +How would you handle this if you were creating a table of GDP per capita for Poland +for the entire twentieth century? + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +[pandas-dataframe]: https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html +[pandas-series]: https://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.html +[numpy]: https://www.numpy.org/ + + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Use `DataFrame.iloc[..., ...]` to select values by integer location. +- Use `:` on its own to mean all columns or all rows. +- Select multiple columns or rows using `DataFrame.loc` and a named slice. +- Result of slicing can be used in further operations. +- Use comparisons to select data based on value. +- Select values or NaN using a Boolean mask. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/09-plotting.md b/09-plotting.md new file mode 100644 index 000000000..e9b9b11ed --- /dev/null +++ b/09-plotting.md @@ -0,0 +1,386 @@ +--- +title: Plotting +teaching: 15 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Create a time series plot showing a single data set. +- Create a scatter plot showing relationship between two data sets. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I plot my data? +- How can I save my plot for publishing? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## [`matplotlib`](https://matplotlib.org/) is the most widely used scientific plotting library in Python. + +- Commonly use a sub-library called [`matplotlib.pyplot`](https://matplotlib.org/stable/tutorials/introductory/pyplot.html). +- The Jupyter Notebook will render plots inline by default. + +```python +import matplotlib.pyplot as plt +``` + +- Simple plots are then (fairly) simple to create. + +```python +time = [0, 1, 2, 3] +position = [0, 100, 200, 300] + +plt.plot(time, position) +plt.xlabel('Time (hr)') +plt.ylabel('Position (km)') +``` + +![](fig/9_simple_position_time_plot.svg){alt='A line chart showing time (hr) relative to position (km), using the values provided in the code block above. By default, the plotted line is blue against a white background, and the axes have been scaled automatically to fit the range of the input data.'} + +::::::::::::::::::::::::::::::::::::::::: callout + +## Display All Open Figures + +In our Jupyter Notebook example, running the cell should generate the figure directly below the code. +The figure is also included in the Notebook document for future viewing. +However, other Python environments like an interactive Python session started from a terminal +or a Python script executed via the command line require an additional command to display the figure. + +Instruct `matplotlib` to show a figure: + +```python +plt.show() +``` + +This command can also be used within a Notebook - for instance, to display multiple figures +if several are created by a single cell. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Plot data directly from a [`Pandas dataframe`](https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.html). + +- We can also plot [Pandas dataframes](https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html). +- Before plotting, we convert the column headings from a `string` to `integer` data type, since they represent numerical values, + using [str.replace()](https://pandas.pydata.org/docs/reference/api/pandas.Series.str.replace.html) to remove the `gpdPercap_` + prefix and then [astype(int)](https://pandas.pydata.org/docs/reference/api/pandas.Series.astype.html) + to convert the series of string values (`['1952', '1957', ..., '2007']`) to a series of integers: `[1925, 1957, ..., 2007]`. + +```python +import pandas as pd + +data = pd.read_csv('data/gapminder_gdp_oceania.csv', index_col='country') + +# Extract year from last 4 characters of each column name +# The current column names are structured as 'gdpPercap_(year)', +# so we want to keep the (year) part only for clarity when plotting GDP vs. years +# To do this we use replace(), which removes from the string the characters stated in the argument +# This method works on strings, so we use replace() from Pandas Series.str vectorized string functions + +years = data.columns.str.replace('gdpPercap_', '') + +# Convert year values to integers, saving results back to dataframe + +data.columns = years.astype(int) + +data.loc['Australia'].plot() +``` + +![](fig/9_gdp_australia.svg){alt='GDP plot for Australia'} + +## Select and transform data, then plot it. + +- By default, [`DataFrame.plot`](https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.plot.html#pandas.DataFrame.plot) plots with the rows as the X axis. +- We can transpose the data in order to plot multiple series. + +```python +data.T.plot() +plt.ylabel('GDP per capita') +``` + +![](fig/9_gdp_australia_nz.svg){alt='GDP plot for Australia and New Zealand'} + +## Many styles of plot are available. + +- For example, do a bar plot using a fancier style. + +```python +plt.style.use('ggplot') +data.T.plot(kind='bar') +plt.ylabel('GDP per capita') +``` + +![](fig/9_gdp_bar.svg){alt='GDP barplot for Australia'} + +## Data can also be plotted by calling the `matplotlib` `plot` function directly. + +- The command is `plt.plot(x, y)` +- The color and format of markers can also be specified as an additional optional argument e.g., `b-` is a blue line, `g--` is a green dashed line. + +## Get Australia data from dataframe + +```python +years = data.columns +gdp_australia = data.loc['Australia'] + +plt.plot(years, gdp_australia, 'g--') +``` + +![](fig/9_gdp_australia_formatted.svg){alt='GDP formatted plot for Australia'} + +## Can plot many sets of data together. + +```python +# Select two countries' worth of data. +gdp_australia = data.loc['Australia'] +gdp_nz = data.loc['New Zealand'] + +# Plot with differently-colored markers. +plt.plot(years, gdp_australia, 'b-', label='Australia') +plt.plot(years, gdp_nz, 'g-', label='New Zealand') + +# Create legend. +plt.legend(loc='upper left') +plt.xlabel('Year') +plt.ylabel('GDP per capita ($)') +``` + +::::::::::::::::::::::::::::::::::::::::: callout + +## Adding a Legend + +Often when plotting multiple datasets on the same figure it is desirable to have +a legend describing the data. + +This can be done in `matplotlib` in two stages: + +- Provide a label for each dataset in the figure: + +```python +plt.plot(years, gdp_australia, label='Australia') +plt.plot(years, gdp_nz, label='New Zealand') +``` + +- Instruct `matplotlib` to create the legend. + +```python +plt.legend() +``` + +By default matplotlib will attempt to place the legend in a suitable position. If you +would rather specify a position this can be done with the `loc=` argument, e.g to place +the legend in the upper left corner of the plot, specify `loc='upper left'` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +![](fig/9_gdp_australia_nz_formatted.svg){alt='GDP formatted plot for Australia and New Zealand'} + +- Plot a scatter plot correlating the GDP of Australia and New Zealand +- Use either `plt.scatter` or `DataFrame.plot.scatter` + +```python +plt.scatter(gdp_australia, gdp_nz) +``` + +![](fig/9_gdp_correlation_plt.svg){alt='GDP correlation using plt.scatter'} + +```python +data.T.plot.scatter(x = 'Australia', y = 'New Zealand') +``` + +![](fig/9_gdp_correlation_data.svg){alt='GDP correlation using data.T.plot.scatter'} + +::::::::::::::::::::::::::::::::::::::: challenge + +## Minima and Maxima + +Fill in the blanks below to plot the minimum GDP per capita over time +for all the countries in Europe. +Modify it again to plot the maximum GDP per capita over time for Europe. + +```python +data_europe = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country') +data_europe.____.plot(label='min') +data_europe.____ +plt.legend(loc='best') +plt.xticks(rotation=90) +``` + +::::::::::::::: solution + +## Solution + +```python +data_europe = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country') +data_europe.min().plot(label='min') +data_europe.max().plot(label='max') +plt.legend(loc='best') +plt.xticks(rotation=90) +``` + +![](fig/9_minima_maxima_solution.png){alt='Minima Maxima Solution'} + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Correlations + +Modify the example in the notes to create a scatter plot showing +the relationship between the minimum and maximum GDP per capita +among the countries in Asia for each year in the data set. +What relationship do you see (if any)? + +::::::::::::::: solution + +## Solution + +```python +data_asia = pd.read_csv('data/gapminder_gdp_asia.csv', index_col='country') +data_asia.describe().T.plot(kind='scatter', x='min', y='max') +``` + +![](fig/9_correlations_solution1.svg){alt='Correlations Solution 1'} + +No particular correlations can be seen between the minimum and maximum gdp values +year on year. It seems the fortunes of asian countries do not rise and fall together. + + +::::::::::::::::::::::::: + +You might note that the variability in the maximum is much higher than +that of the minimum. Take a look at the maximum and the max indexes: + +```python +data_asia = pd.read_csv('data/gapminder_gdp_asia.csv', index_col='country') +data_asia.max().plot() +print(data_asia.idxmax()) +print(data_asia.idxmin()) +``` + +::::::::::::::: solution + +## Solution + +![](fig/9_correlations_solution2.png){alt='Correlations Solution 2'} + +Seems the variability in this value is due to a sharp drop after 1972. +Some geopolitics at play perhaps? Given the dominance of oil producing countries, +maybe the Brent crude index would make an interesting comparison? +Whilst Myanmar consistently has the lowest gdp, the highest gdb nation has varied +more notably. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## More Correlations + +This short program creates a plot showing +the correlation between GDP and life expectancy for 2007, +normalizing marker size by population: + +```python +data_all = pd.read_csv('data/gapminder_all.csv', index_col='country') +data_all.plot(kind='scatter', x='gdpPercap_2007', y='lifeExp_2007', + s=data_all['pop_2007']/1e6) +``` + +Using online help and other resources, +explain what each argument to `plot` does. + +::::::::::::::: solution + +## Solution + +![](fig/9_more_correlations_solution.svg){alt='More Correlations Solution'} + +A good place to look is the documentation for the plot function - +help(data\_all.plot). + +kind - As seen already this determines the kind of plot to be drawn. + +x and y - A column name or index that determines what data will be +placed on the x and y axes of the plot + +s - Details for this can be found in the documentation of plt.scatter. +A single number or one value for each data point. Determines the size +of the plotted points. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Saving your plot to a file + +If you are satisfied with the plot you see you may want to save it to a file, +perhaps to include it in a publication. There is a function in the +matplotlib.pyplot module that accomplishes this: +[savefig](https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.savefig.html). +Calling this function, e.g. with + +```python +plt.savefig('my_figure.png') +``` + +will save the current figure to the file `my_figure.png`. The file format +will automatically be deduced from the file name extension (other formats +are pdf, ps, eps and svg). + +Note that functions in `plt` refer to a global figure variable +and after a figure has been displayed to the screen (e.g. with `plt.show`) +matplotlib will make this variable refer to a new empty figure. +Therefore, make sure you call `plt.savefig` before the plot is displayed to +the screen, otherwise you may find a file with an empty plot. + +When using dataframes, data is often generated and plotted to screen in one line. +In addition to using `plt.savefig`, we can save a reference to the current figure +in a local variable (with `plt.gcf`) and call the `savefig` class method from +that variable to save the figure to file. + +```python +data.plot(kind='bar') +fig = plt.gcf() # get current figure +fig.savefig('my_figure.png') +``` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Making your plots accessible + +Whenever you are generating plots to go into a paper or a presentation, there are a few things you can do to make sure that everyone can understand your plots. + +- Always make sure your text is large enough to read. Use the `fontsize` parameter in `xlabel`, `ylabel`, `title`, and `legend`, and [`tick_params` with `labelsize`](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.tick_params.html) to increase the text size of the numbers on your axes. +- Similarly, you should make your graph elements easy to see. Use `s` to increase the size of your scatterplot markers and `linewidth` to increase the sizes of your plot lines. +- Using color (and nothing else) to distinguish between different plot elements will make your plots unreadable to anyone who is colorblind, or who happens to have a black-and-white office printer. For lines, the `linestyle` parameter lets you use different types of lines. For scatterplots, `marker` lets you change the shape of your points. If you're unsure about your colors, you can use [Coblis](https://www.color-blindness.com/coblis-color-blindness-simulator/) or [Color Oracle](https://colororacle.org/) to simulate what your plots would look like to those with colorblindness. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- [`matplotlib`](https://matplotlib.org/) is the most widely used scientific plotting library in Python. +- Plot data directly from a Pandas dataframe. +- Select and transform data, then plot it. +- Many styles of plot are available: see the [Python Graph Gallery](https://python-graph-gallery.com/matplotlib/) for more options. +- Can plot many sets of data together. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/10-lunch.md b/10-lunch.md new file mode 100644 index 000000000..f786db36a --- /dev/null +++ b/10-lunch.md @@ -0,0 +1,14 @@ +--- +title: Lunch +teaching: 0 +exercises: 0 +break: 45 +--- + +Over lunch, reflect on and discuss the following: + +- What sort of packages might you use in Python and why would you use them? +- How would data need to be formatted to be used in Pandas data frames? Would the data you have meet these requirements? +- What limitations or problems might you run into when thinking about how to apply what we've learned to your own projects or data? + + diff --git a/11-lists.md b/11-lists.md new file mode 100644 index 000000000..a7b07e5a0 --- /dev/null +++ b/11-lists.md @@ -0,0 +1,506 @@ +--- +title: Lists +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain why programs need collections of values. +- Write programs that create flat lists, index them, slice them, and modify them through assignment and method calls. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I store multiple values? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## A list stores many values in a single structure. + +- Doing calculations with a hundred variables called `pressure_001`, `pressure_002`, etc., + would be at least as slow as doing them by hand. +- Use a *list* to store many values together. + - Contained within square brackets `[...]`. + - Values separated by commas `,`. +- Use `len` to find out how many values are in a list. + +```python +pressures = [0.273, 0.275, 0.277, 0.275, 0.276] +print('pressures:', pressures) +print('length:', len(pressures)) +``` + +```output +pressures: [0.273, 0.275, 0.277, 0.275, 0.276] +length: 5 +``` + +## Use an item's index to fetch it from a list. + +- Just like strings. + +```python +print('zeroth item of pressures:', pressures[0]) +print('fourth item of pressures:', pressures[4]) +``` + +```output +zeroth item of pressures: 0.273 +fourth item of pressures: 0.276 +``` + +## Lists' values can be replaced by assigning to them. + +- Use an index expression on the left of assignment to replace a value. + +```python +pressures[0] = 0.265 +print('pressures is now:', pressures) +``` + +```output +pressures is now: [0.265, 0.275, 0.277, 0.275, 0.276] +``` + +## Appending items to a list lengthens it. + +- Use `list_name.append` to add items to the end of a list. + +```python +primes = [2, 3, 5] +print('primes is initially:', primes) +primes.append(7) +print('primes has become:', primes) +``` + +```output +primes is initially: [2, 3, 5] +primes has become: [2, 3, 5, 7] +``` + +- `append` is a *method* of lists. + - Like a function, but tied to a particular object. +- Use `object_name.method_name` to call methods. + - Deliberately resembles the way we refer to things in a library. +- We will meet other methods of lists as we go along. + - Use `help(list)` for a preview. +- `extend` is similar to `append`, but it allows you to combine two lists. For example: + +```python +teen_primes = [11, 13, 17, 19] +middle_aged_primes = [37, 41, 43, 47] +print('primes is currently:', primes) +primes.extend(teen_primes) +print('primes has now become:', primes) +primes.append(middle_aged_primes) +print('primes has finally become:', primes) +``` + +```output +primes is currently: [2, 3, 5, 7] +primes has now become: [2, 3, 5, 7, 11, 13, 17, 19] +primes has finally become: [2, 3, 5, 7, 11, 13, 17, 19, [37, 41, 43, 47]] +``` + +Note that while `extend` maintains the "flat" structure of the list, appending a list to a list means +the last element in `primes` will itself be a list, not an integer. Lists can contain values of any +type; therefore, lists of lists are possible. + +## Use `del` to remove items from a list entirely. + +- We use `del list_name[index]` to remove an element from a list (in the example, 9 is not a prime number) and thus shorten it. +- `del` is not a function or a method, but a statement in the language. + +```python +primes = [2, 3, 5, 7, 9] +print('primes before removing last item:', primes) +del primes[4] +print('primes after removing last item:', primes) +``` + +```output +primes before removing last item: [2, 3, 5, 7, 9] +primes after removing last item: [2, 3, 5, 7] +``` + +## The empty list contains no values. + +- Use `[]` on its own to represent a list that doesn't contain any values. + - "The zero of lists." +- Helpful as a starting point for collecting values + (which we will see in the [next episode](12-for-loops.md)). + +## Lists may contain values of different types. + +- A single list may contain numbers, strings, and anything else. + +```python +goals = [1, 'Create lists.', 2, 'Extract items from lists.', 3, 'Modify lists.'] +``` + +## Character strings can be indexed like lists. + +- Get single characters from a character string using indexes in square brackets. + +```python +element = 'carbon' +print('zeroth character:', element[0]) +print('third character:', element[3]) +``` + +```output +zeroth character: c +third character: b +``` + +## Character strings are immutable. + +- Cannot change the characters in a string after it has been created. + - *Immutable*: can't be changed after creation. + - In contrast, lists are *mutable*: they can be modified in place. +- Python considers the string to be a single value with parts, + not a collection of values. + +```python +element[0] = 'C' +``` + +```error +TypeError: 'str' object does not support item assignment +``` + +- Lists and character strings are both *collections*. + +## Indexing beyond the end of the collection is an error. + +- Python reports an `IndexError` if we attempt to access a value that doesn't exist. + - This is a kind of [runtime error](04-built-in.md). + - Cannot be detected as the code is parsed + because the index might be calculated based on data. + +```python +print('99th element of element is:', element[99]) +``` + +```output +IndexError: string index out of range +``` + +::::::::::::::::::::::::::::::::::::::: challenge + +## Fill in the Blanks + +Fill in the blanks so that the program below produces the output shown. + +```python +values = ____ +values.____(1) +values.____(3) +values.____(5) +print('first time:', values) +values = values[____] +print('second time:', values) +``` + +```output +first time: [1, 3, 5] +second time: [3, 5] +``` + +::::::::::::::: solution + +## Solution + +```python +values = [] +values.append(1) +values.append(3) +values.append(5) +print('first time:', values) +values = values[1:] +print('second time:', values) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## How Large is a Slice? + +If `start` and `stop` are both non-negative integers, +how long is the list `values[start:stop]`? + +::::::::::::::: solution + +## Solution + +The list `values[start:stop]` has up to `stop - start` elements. For example, +`values[1:4]` has the 3 elements `values[1]`, `values[2]`, and `values[3]`. +Why 'up to'? As we saw in [episode 2](02-variables.md), +if `stop` is greater than the total length of the list `values`, +we will still get a list back but it will be shorter than expected. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## From Strings to Lists and Back + +Given this: + +```python +print('string to list:', list('tin')) +print('list to string:', ''.join(['g', 'o', 'l', 'd'])) +``` + +```output +string to list: ['t', 'i', 'n'] +list to string: gold +``` + +1. What does `list('some string')` do? +2. What does `'-'.join(['x', 'y', 'z'])` generate? + +::::::::::::::: solution + +## Solution + +1. [`list('some string')`](https://docs.python.org/3/library/stdtypes.html#list) converts a string into a list containing all of its characters. +2. [`join`](https://docs.python.org/3/library/stdtypes.html#str.join) returns a string that is the *concatenation* + of each string element in the list and adds the separator between each element in the list. This results in + `x-y-z`. The separator between the elements is the string that provides this method. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Working With the End + +What does the following program print? + +```python +element = 'helium' +print(element[-1]) +``` + +1. How does Python interpret a negative index? +2. If a list or string has N elements, + what is the most negative index that can safely be used with it, + and what location does that index represent? +3. If `values` is a list, what does `del values[-1]` do? +4. How can you display all elements but the last one without changing `values`? + (Hint: you will need to combine slicing and negative indexing.) + +::::::::::::::: solution + +## Solution + +The program prints `m`. + +1. Python interprets a negative index as starting from the end (as opposed to + starting from the beginning). The last element is `-1`. +2. The last index that can safely be used with a list of N elements is element + `-N`, which represents the first element. +3. `del values[-1]` removes the last element from the list. +4. `values[:-1]` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Stepping Through a List + +What does the following program print? + +```python +element = 'fluorine' +print(element[::2]) +print(element[::-1]) +``` + +1. If we write a slice as `low:high:stride`, what does `stride` do? +2. What expression would select all of the even-numbered items from a collection? + +::::::::::::::: solution + +## Solution + +The program prints + +```python +furn +eniroulf +``` + +1. `stride` is the step size of the slice. +2. The slice `1::2` selects all even-numbered items from a collection: it starts + with element `1` (which is the second element, since indexing starts at `0`), + goes on until the end (since no `end` is given), and uses a step size of `2` + (i.e., selects every second element). + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Slice Bounds + +What does the following program print? + +```python +element = 'lithium' +print(element[0:20]) +print(element[-1:3]) +``` + +::::::::::::::: solution + +## Solution + +```output +lithium + +``` + +The first statement prints the whole string, since the slice goes beyond the total length of the string. +The second statement returns an empty string, because the slice goes "out of bounds" of the string. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Sort and Sorted + +What do these two programs print? +In simple terms, explain the difference between `sorted(letters)` and `letters.sort()`. + +```python +# Program A +letters = list('gold') +result = sorted(letters) +print('letters is', letters, 'and result is', result) +``` + +```python +# Program B +letters = list('gold') +result = letters.sort() +print('letters is', letters, 'and result is', result) +``` + +::::::::::::::: solution + +## Solution + +Program A prints + +```output +letters is ['g', 'o', 'l', 'd'] and result is ['d', 'g', 'l', 'o'] +``` + +Program B prints + +```output +letters is ['d', 'g', 'l', 'o'] and result is None +``` + +`sorted(letters)` returns a sorted copy of the list `letters` (the original +list `letters` remains unchanged), while `letters.sort()` sorts the list +`letters` in-place and does not return anything. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Copying (or Not) + +What do these two programs print? +In simple terms, explain the difference between `new = old` and `new = old[:]`. + +```python +# Program A +old = list('gold') +new = old # simple assignment +new[0] = 'D' +print('new is', new, 'and old is', old) +``` + +```python +# Program B +old = list('gold') +new = old[:] # assigning a slice +new[0] = 'D' +print('new is', new, 'and old is', old) +``` + +::::::::::::::: solution + +## Solution + +Program A prints + +```output +new is ['D', 'o', 'l', 'd'] and old is ['D', 'o', 'l', 'd'] +``` + +Program B prints + +```output +new is ['D', 'o', 'l', 'd'] and old is ['g', 'o', 'l', 'd'] +``` + +`new = old` makes `new` a reference to the list `old`; `new` and `old` point +towards the same object. + +`new = old[:]` however creates a new list object `new` containing all elements +from the list `old`; `new` and `old` are different objects. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- A list stores many values in a single structure. +- Use an item's index to fetch it from a list. +- Lists' values can be replaced by assigning to them. +- Appending items to a list lengthens it. +- Use `del` to remove items from a list entirely. +- The empty list contains no values. +- Lists may contain values of different types. +- Character strings can be indexed like lists. +- Character strings are immutable. +- Indexing beyond the end of the collection is an error. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/12-for-loops.md b/12-for-loops.md new file mode 100644 index 000000000..c73f9ced2 --- /dev/null +++ b/12-for-loops.md @@ -0,0 +1,467 @@ +--- +title: For Loops +teaching: 10 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain what for loops are normally used for. +- Trace the execution of a simple (unnested) loop and correctly state the values of variables in each iteration. +- Write for loops that use the Accumulator pattern to aggregate values. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I make a program do many things? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## A *for loop* executes commands once for each value in a collection. + +- Doing calculations on the values in a list one by one + is as painful as working with `pressure_001`, `pressure_002`, etc. +- A *for loop* tells Python to execute some statements once for each value in a list, + a character string, + or some other collection. +- "for each thing in this group, do these operations" + +```python +for number in [2, 3, 5]: + print(number) +``` + +- This `for` loop is equivalent to: + +```python +print(2) +print(3) +print(5) +``` + +- And the `for` loop's output is: + +```output +2 +3 +5 +``` + +## A `for` loop is made up of a collection, a loop variable, and a body. + +```python +for number in [2, 3, 5]: + print(number) +``` + +- The collection, `[2, 3, 5]`, is what the loop is being run on. +- The body, `print(number)`, specifies what to do for each value in the collection. +- The loop variable, `number`, is what changes for each *iteration* of the loop. + - The "current thing". + +## The first line of the `for` loop must end with a colon, and the body must be indented. + +- The colon at the end of the first line signals the start of a *block* of statements. +- Python uses indentation rather than `{}` or `begin`/`end` to show *nesting*. + - Any consistent indentation is legal, but almost everyone uses four spaces. + +```python +for number in [2, 3, 5]: +print(number) +``` + +```error +IndentationError: expected an indented block +``` + +- Indentation is always meaningful in Python. + +```python +firstName = "Jon" + lastName = "Smith" +``` + +```error + File "", line 2 + lastName = "Smith" + ^ +IndentationError: unexpected indent +``` + +- This error can be fixed by removing the extra spaces + at the beginning of the second line. + +## Loop variables can be called anything. + +- As with all variables, loop variables are: + - Created on demand. + - Meaningless: their names can be anything at all. + +```python +for kitten in [2, 3, 5]: + print(kitten) +``` + +## The body of a loop can contain many statements. + +- But no loop should be more than a few lines long. +- Hard for human beings to keep larger chunks of code in mind. + +```python +primes = [2, 3, 5] +for p in primes: + squared = p ** 2 + cubed = p ** 3 + print(p, squared, cubed) +``` + +```output +2 4 8 +3 9 27 +5 25 125 +``` + +## Use `range` to iterate over a sequence of numbers. + +- The built-in function [`range`](https://docs.python.org/3/library/stdtypes.html#range) produces a sequence of numbers. + - *Not* a list: the numbers are produced on demand + to make looping over large ranges more efficient. +- `range(N)` is the numbers 0..N-1 + - Exactly the legal indices of a list or character string of length N + +```python +print('a range is not a list: range(0, 3)') +for number in range(0, 3): + print(number) +``` + +```output +a range is not a list: range(0, 3) +0 +1 +2 +``` + +## The Accumulator pattern turns many values into one. + +- A common pattern in programs is to: + 1. Initialize an *accumulator* variable to zero, the empty string, or the empty list. + 2. Update the variable with values from a collection. + +```python +# Sum the first 10 integers. +total = 0 +for number in range(10): + total = total + (number + 1) +print(total) +``` + +```output +55 +``` + +- Read `total = total + (number + 1)` as: + - Add 1 to the current value of the loop variable `number`. + - Add that to the current value of the accumulator variable `total`. + - Assign that to `total`, replacing the current value. +- We have to add `number + 1` because `range` produces 0..9, not 1..10. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Classifying Errors + +Is an indentation error a syntax error or a runtime error? + +::::::::::::::: solution + +## Solution + +An IndentationError is a syntax error. Programs with syntax errors cannot be started. +A program with a runtime error will start but an error will be thrown under certain conditions. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Tracing Execution + +Create a table showing the numbers of the lines that are executed when this program runs, +and the values of the variables after each line is executed. + +```python +total = 0 +for char in "tin": + total = total + 1 +``` + +::::::::::::::: solution + +## Solution + +| Line no | Variables | +| ------- | -------------------- | +| 1 | total = 0 | +| 2 | total = 0 char = 't' | +| 3 | total = 1 char = 't' | +| 2 | total = 1 char = 'i' | +| 3 | total = 2 char = 'i' | +| 2 | total = 2 char = 'n' | +| 3 | total = 3 char = 'n' | + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reversing a String + +Fill in the blanks in the program below so that it prints "nit" +(the reverse of the original character string "tin"). + +```python +original = "tin" +result = ____ +for char in original: + result = ____ +print(result) +``` + +::::::::::::::: solution + +## Solution + +```python +original = "tin" +result = "" +for char in original: + result = char + result +print(result) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Practice Accumulating + +Fill in the blanks in each of the programs below +to produce the indicated result. + +```python +# Total length of the strings in the list: ["red", "green", "blue"] => 12 +total = 0 +for word in ["red", "green", "blue"]: + ____ = ____ + len(word) +print(total) +``` + +::::::::::::::: solution + +## Solution + +```python +total = 0 +for word in ["red", "green", "blue"]: + total = total + len(word) +print(total) +``` + +::::::::::::::::::::::::: + +```python +# List of word lengths: ["red", "green", "blue"] => [3, 5, 4] +lengths = ____ +for word in ["red", "green", "blue"]: + lengths.____(____) +print(lengths) +``` + +::::::::::::::: solution + +## Solution + +```python +lengths = [] +for word in ["red", "green", "blue"]: + lengths.append(len(word)) +print(lengths) +``` + +::::::::::::::::::::::::: + +```python +# Concatenate all words: ["red", "green", "blue"] => "redgreenblue" +words = ["red", "green", "blue"] +result = ____ +for ____ in ____: + ____ +print(result) +``` + +::::::::::::::: solution + +## Solution + +```python +words = ["red", "green", "blue"] +result = "" +for word in words: + result = result + word +print(result) +``` + +::::::::::::::::::::::::: + +**Create an acronym:** Starting from the list `["red", "green", "blue"]`, create the acronym `"RGB"` using +a for loop. + +**Hint:** You may need to use a string method to properly format the acronym. + +::::::::::::::: solution + +## Solution + +```python +acronym = "" +for word in ["red", "green", "blue"]: + acronym = acronym + word[0].upper() +print(acronym) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Cumulative Sum + +Reorder and properly indent the lines of code below +so that they print a list with the cumulative sum of data. +The result should be `[1, 3, 5, 10]`. + +```python +cumulative.append(total) +for number in data: +cumulative = [] +total = total + number +total = 0 +print(cumulative) +data = [1,2,2,5] +``` + +::::::::::::::: solution + +## Solution + +```python +total = 0 +data = [1,2,2,5] +cumulative = [] +for number in data: + total = total + number + cumulative.append(total) +print(cumulative) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Identifying Variable Name Errors + +1. Read the code below and try to identify what the errors are + *without* running it. +2. Run the code and read the error message. + What type of `NameError` do you think this is? + Is it a string with no quotes, a misspelled variable, or a + variable that should have been defined but was not? +3. Fix the error. +4. Repeat steps 2 and 3, until you have fixed all the errors. + +```python +for number in range(10): + # use a if the number is a multiple of 3, otherwise use b + if (Number % 3) == 0: + message = message + a + else: + message = message + "b" +print(message) +``` + +::::::::::::::: solution + +## Solution + +- Python variable names are case sensitive: `number` and `Number` refer to different variables. +- The variable `message` needs to be initialized as an empty string. +- We want to add the string `"a"` to `message`, not the undefined variable `a`. + +```python +message = "" +for number in range(10): + # use a if the number is a multiple of 3, otherwise use b + if (number % 3) == 0: + message = message + "a" + else: + message = message + "b" +print(message) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Identifying Item Errors + +1. Read the code below and try to identify what the errors are + *without* running it. +2. Run the code, and read the error message. What type of error is it? +3. Fix the error. + +```python +seasons = ['Spring', 'Summer', 'Fall', 'Winter'] +print('My favorite season is ', seasons[4]) +``` + +::::::::::::::: solution + +## Solution + +This list has 4 elements and the index to access the last element in the list is `3`. + +```python +seasons = ['Spring', 'Summer', 'Fall', 'Winter'] +print('My favorite season is ', seasons[3]) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- A *for loop* executes commands once for each value in a collection. +- A `for` loop is made up of a collection, a loop variable, and a body. +- The first line of the `for` loop must end with a colon, and the body must be indented. +- Indentation is always meaningful in Python. +- Loop variables can be called anything (but it is strongly advised to have a meaningful name to the looping variable). +- The body of a loop can contain many statements. +- Use `range` to iterate over a sequence of numbers. +- The Accumulator pattern turns many values into one. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/13-conditionals.md b/13-conditionals.md new file mode 100644 index 000000000..217eca25b --- /dev/null +++ b/13-conditionals.md @@ -0,0 +1,411 @@ +--- +title: Conditionals +teaching: 10 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Correctly write programs that use if and else statements and simple Boolean expressions (without logical operators). +- Trace the execution of unnested conditionals and conditionals inside 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 (more properly called a *conditional* statement) + controls whether some block of code is executed or not. +- Structure is similar to a `for` statement: + - First line opens with `if` and ends with a colon + - Body containing one or more statements is indented (usually by 4 spaces) + +```python +mass = 3.54 +if mass > 3.0: + print(mass, 'is large') + +mass = 2.07 +if mass > 3.0: + print (mass, 'is large') +``` + +```output +3.54 is large +``` + +## Conditionals are often used inside loops. + +- Not much point using a conditional when we know the value (as above). +- But useful when we have a collection to process. + +```python +masses = [3.54, 2.07, 9.22, 1.86, 1.71] +for m in masses: + if m > 3.0: + print(m, 'is large') +``` + +```output +3.54 is large +9.22 is large +``` + +## Use `else` to execute a block of code when an `if` condition is *not* true. + +- `else` can be used following an `if`. +- Allows us to specify an alternative to execute when the `if` *branch* isn't taken. + +```python +masses = [3.54, 2.07, 9.22, 1.86, 1.71] +for m in masses: + if m > 3.0: + print(m, 'is large') + else: + print(m, 'is small') +``` + +```output +3.54 is large +2.07 is small +9.22 is large +1.86 is small +1.71 is small +``` + +## Use `elif` to specify additional tests. + +- May want to provide several alternative choices, each with its own test. +- Use `elif` (short for "else if") and a condition to specify these. +- Always associated with an `if`. +- Must come before the `else` (which is the "catch all"). + +```python +masses = [3.54, 2.07, 9.22, 1.86, 1.71] +for m in masses: + if m > 9.0: + print(m, 'is HUGE') + elif m > 3.0: + print(m, 'is large') + else: + print(m, 'is small') +``` + +```output +3.54 is large +2.07 is small +9.22 is HUGE +1.86 is small +1.71 is small +``` + +## Conditions are tested once, in order. + +- Python steps through the branches of the conditional in order, testing each in turn. +- So ordering matters. + +```python +grade = 85 +if grade >= 90: + print('grade is A') +elif grade >= 80: + print('grade is B') +elif grade >= 70: + print('grade is C') +``` + +```output +grade is B +``` + +- Does *not* automatically go back and re-evaluate if values change. + +```python +velocity = 10.0 +if velocity > 20.0: + print('moving too fast') +else: + print('adjusting velocity') + velocity = 50.0 +``` + +```output +adjusting velocity +``` + +- Often use conditionals in a loop to "evolve" the values of variables. + +```python +velocity = 10.0 +for i in range(5): # execute the loop 5 times + print(i, ':', velocity) + if velocity > 20.0: + print('moving too fast') + velocity = velocity - 5.0 + else: + print('moving too slow') + velocity = velocity + 10.0 +print('final velocity:', velocity) +``` + +```output +0 : 10.0 +moving too slow +1 : 20.0 +moving too slow +2 : 30.0 +moving too fast +3 : 25.0 +moving too fast +4 : 20.0 +moving too slow +final velocity: 30.0 +``` + +## Create a table showing variables' values to trace a program's execution. + + + + + + +
i 0 . 1 . 2 . 3 . 4 .
velocity 10.0 20.0 . 30.0 . 25.0 . 20.0 . 30.0
+ +- The program must have a `print` statement *outside* the body of the loop + to show the final value of `velocity`, + since its value is updated by the last iteration of the loop. + +::::::::::::::::::::::::::::::::::::::::: callout + +## Compound Relations Using `and`, `or`, and Parentheses + +Often, you want some combination of things to be true. You can combine +relations within a conditional using `and` and `or`. Continuing the example +above, suppose you have + +```python +mass = [ 3.54, 2.07, 9.22, 1.86, 1.71] +velocity = [10.00, 20.00, 30.00, 25.00, 20.00] + +i = 0 +for i in range(5): + if mass[i] > 5 and velocity[i] > 20: + print("Fast heavy object. Duck!") + elif mass[i] > 2 and mass[i] <= 5 and velocity[i] <= 20: + print("Normal traffic") + elif mass[i] <= 2 and velocity[i] <= 20: + print("Slow light object. Ignore it") + else: + print("Whoa! Something is up with the data. Check it") +``` + +Just like with arithmetic, you can and should use parentheses whenever there +is possible ambiguity. A good general rule is to *always* use parentheses +when mixing `and` and `or` in the same condition. That is, instead of: + +```python +if mass[i] <= 2 or mass[i] >= 5 and velocity[i] > 20: +``` + +write one of these: + +```python +if (mass[i] <= 2 or mass[i] >= 5) and velocity[i] > 20: +if mass[i] <= 2 or (mass[i] >= 5 and velocity[i] > 20): +``` + +so it is perfectly clear to a reader (and to Python) what you really mean. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Tracing Execution + +What does this program print? + +```python +pressure = 71.9 +if pressure > 50.0: + pressure = 25.0 +elif pressure <= 50.0: + pressure = 0.0 +print(pressure) +``` + +::::::::::::::: solution + +## Solution + +```output +25.0 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Trimming Values + +Fill in the blanks so that this program creates a new list +containing zeroes where the original list's values were negative +and ones where the original list's values were positive. + +```python +original = [-1.5, 0.2, 0.4, 0.0, -1.3, 0.4] +result = ____ +for value in original: + if ____: + result.append(0) + else: + ____ +print(result) +``` + +```output +[0, 1, 1, 1, 0, 1] +``` + +::::::::::::::: solution + +## Solution + +```python +original = [-1.5, 0.2, 0.4, 0.0, -1.3, 0.4] +result = [] +for value in original: + if value < 0.0: + result.append(0) + else: + result.append(1) +print(result) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Processing Small Files + +Modify this program so that it only processes files with fewer than 50 records. + +```python +import glob +import pandas as pd +for filename in glob.glob('data/*.csv'): + contents = pd.read_csv(filename) + ____: + print(filename, len(contents)) +``` + +::::::::::::::: solution + +## Solution + +```python +import glob +import pandas as pd +for filename in glob.glob('data/*.csv'): + contents = pd.read_csv(filename) + if len(contents) < 50: + print(filename, len(contents)) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Initializing + +Modify this program so that it finds the largest and smallest values in the list +no matter what the range of values originally is. + +```python +values = [...some test data...] +smallest, largest = None, None +for v in values: + if ____: + smallest, largest = v, v + ____: + smallest = min(____, v) + largest = max(____, v) +print(smallest, largest) +``` + +What are the advantages and disadvantages of using this method +to find the range of the data? + +::::::::::::::: solution + +## Solution + +```python +values = [-2,1,65,78,-54,-24,100] +smallest, largest = None, None +for v in values: + if smallest is None and largest is None: + smallest, largest = v, v + else: + smallest = min(smallest, v) + largest = max(largest, v) +print(smallest, largest) +``` + +If you wrote `== None` instead of `is None`, that works too, but Python programmers always +write `is None` because of the special way `None` works in the language. + +It can be argued that an advantage of using this method would be to make the code more readable. +However, a disadvantage is that this code is not efficient because within each iteration of the +`for` loop statement, there are two more loops that run over two numbers each (the `min` and +`max` functions). It would be more efficient to iterate over each number just once: + +```python +values = [-2,1,65,78,-54,-24,100] +smallest, largest = None, None +for v in values: + if smallest is None or v < smallest: + smallest = v + if largest is None or v > largest: + largest = v +print(smallest, largest) +``` + +Now we have one loop, but four comparison tests. There are two ways we could improve it further: +either use fewer comparisons in each iteration, or use two loops that each contain only one +comparison test. The simplest solution is often the best: + +```python +values = [-2,1,65,78,-54,-24,100] +smallest = min(values) +largest = max(values) +print(smallest, largest) +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: 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. +- Create a table showing variables' values to trace a program's execution. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/14-looping-data-sets.md b/14-looping-data-sets.md new file mode 100644 index 000000000..94d7ddbe4 --- /dev/null +++ b/14-looping-data-sets.md @@ -0,0 +1,268 @@ +--- +title: Looping Over Data Sets +teaching: 5 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Be able to read and write globbing expressions that match sets of files. +- Use glob to create lists of files. +- Write for loops to perform operations on files given their names in a list. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I process many data sets with a single command? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Use a `for` loop to process files given a list of their names. + +- A filename is a character string. +- And lists can contain character strings. + +```python +import pandas as pd +for filename in ['data/gapminder_gdp_africa.csv', 'data/gapminder_gdp_asia.csv']: + data = pd.read_csv(filename, index_col='country') + print(filename, data.min()) +``` + +```output +data/gapminder_gdp_africa.csv gdpPercap_1952 298.846212 +gdpPercap_1957 335.997115 +gdpPercap_1962 355.203227 +gdpPercap_1967 412.977514 +⋮ ⋮ ⋮ +gdpPercap_1997 312.188423 +gdpPercap_2002 241.165877 +gdpPercap_2007 277.551859 +dtype: float64 +data/gapminder_gdp_asia.csv gdpPercap_1952 331 +gdpPercap_1957 350 +gdpPercap_1962 388 +gdpPercap_1967 349 +⋮ ⋮ ⋮ +gdpPercap_1997 415 +gdpPercap_2002 611 +gdpPercap_2007 944 +dtype: float64 +``` + +## Use [`glob.glob`](https://docs.python.org/3/library/glob.html#glob.glob) to find sets of files whose names match a pattern. + +- In Unix, the term "globbing" means "matching a set of files with a pattern". +- The most common patterns are: + - `*` meaning "match zero or more characters" + - `?` meaning "match exactly one character" +- Python's standard library contains the [`glob`](https://docs.python.org/3/library/glob.html) module to provide pattern matching functionality +- The [`glob`](https://docs.python.org/3/library/glob.html) module contains a function also called `glob` to match file patterns +- E.g., `glob.glob('*.txt')` matches all files in the current directory + whose names end with `.txt`. +- Result is a (possibly empty) list of character strings. + +```python +import glob +print('all csv files in data directory:', glob.glob('data/*.csv')) +``` + +```output +all csv files in data directory: ['data/gapminder_all.csv', 'data/gapminder_gdp_africa.csv', \ +'data/gapminder_gdp_americas.csv', 'data/gapminder_gdp_asia.csv', 'data/gapminder_gdp_europe.csv', \ +'data/gapminder_gdp_oceania.csv'] +``` + +```python +print('all PDB files:', glob.glob('*.pdb')) +``` + +```output +all PDB files: [] +``` + +## Use `glob` and `for` to process batches of files. + +- Helps a lot if the files are named and stored systematically and consistently + so that simple patterns will find the right data. + +```python +for filename in glob.glob('data/gapminder_*.csv'): + data = pd.read_csv(filename) + print(filename, data['gdpPercap_1952'].min()) +``` + +```output +data/gapminder_all.csv 298.8462121 +data/gapminder_gdp_africa.csv 298.8462121 +data/gapminder_gdp_americas.csv 1397.717137 +data/gapminder_gdp_asia.csv 331.0 +data/gapminder_gdp_europe.csv 973.5331948 +data/gapminder_gdp_oceania.csv 10039.59564 +``` + +- This includes all data, as well as per-region data. +- Use a more specific pattern in the exercises to exclude the whole data set. +- But note that the minimum of the entire data set is also the minimum of one of the data sets, + which is a nice check on correctness. + +::::::::::::::::::::::::::::::::::::::: challenge + +## Determining Matches + +Which of these files is *not* matched by the expression `glob.glob('data/*as*.csv')`? + +1. `data/gapminder_gdp_africa.csv` +2. `data/gapminder_gdp_americas.csv` +3. `data/gapminder_gdp_asia.csv` + +::::::::::::::: solution + +## Solution + +1 is not matched by the glob. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Minimum File Size + +Modify this program so that it prints the number of records in +the file that has the fewest records. + +```python +import glob +import pandas as pd +fewest = ____ +for filename in glob.glob('data/*.csv'): + dataframe = pd.____(filename) + fewest = min(____, dataframe.shape[0]) +print('smallest file has', fewest, 'records') +``` + +Note that the [`DataFrame.shape()` method][shape-method] +returns a tuple with the number of rows and columns of the data frame. + +::::::::::::::: solution + +## Solution + +```python +import glob +import pandas as pd +fewest = float('Inf') +for filename in glob.glob('data/*.csv'): + dataframe = pd.read_csv(filename) + fewest = min(fewest, dataframe.shape[0]) +print('smallest file has', fewest, 'records') +``` + +You might have chosen to initialize the `fewest` variable with a number greater than the numbers +you're dealing with, but that could lead to trouble if you reuse the code with bigger numbers. +Python lets you use positive infinity, which will work no matter how big your numbers are. +What other special strings does the [`float` function][float-function] recognize? + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Comparing Data + +Write a program that reads in the regional data sets +and plots the average GDP per capita for each region over time +in a single chart. Pandas will raise an error if it encounters +non-numeric columns in a dataframe computation so you may need +to either filter out those columns or tell pandas to ignore them. + + +::::::::::::::: solution + +## Solution + +This solution builds a useful legend by using the [string `split` method][split-method] to +extract the `region` from the path 'data/gapminder\_gdp\_a\_specific\_region.csv'. + +```python +import glob +import pandas as pd +import matplotlib.pyplot as plt +fig, ax = plt.subplots(1,1) +for filename in glob.glob('data/gapminder_gdp*.csv'): + dataframe = pd.read_csv(filename) + # extract from the filename, expected to be in the format 'data/gapminder_gdp_.csv'. + # we will split the string using the split method and `_` as our separator, + # retrieve the last string in the list that split returns (`.csv`), + # and then remove the `.csv` extension from that string. + # NOTE: the pathlib module covered in the next callout also offers + # convenient abstractions for working with filesystem paths and could solve this as well: + # from pathlib import Path + # region = Path(filename).stem.split('_')[-1] + region = filename.split('_')[-1][:-4] + # pandas raises errors when it encounters non-numeric columns in a dataframe computation + # but we can tell pandas to ignore them with the `numeric_only` parameter + dataframe.mean(numeric_only=True).plot(ax=ax, label=region) + # NOTE: another way of doing this selects just the columns with gdp in their name using the filter method + # dataframe.filter(like="gdp").mean().plot(ax=ax, label=region) + +plt.legend() +plt.show() +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Dealing with File Paths + +The [`pathlib` module][pathlib-module] provides useful abstractions for file and path manipulation like +returning the name of a file without the file extension. This is very useful when looping over files and +directories. In the example below, we create a `Path` object and inspect its attributes. + +```python +from pathlib import Path + +p = Path("data/gapminder_gdp_africa.csv") +print(p.parent) +print(p.stem) +print(p.suffix) +``` + +```output +data +gapminder_gdp_africa +.csv +``` + +**Hint:** Check all available attributes and methods on the `Path` object with the `dir()` +function. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +[shape-method]: https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.shape.html +[float-function]: https://docs.python.org/3/library/functions.html#float +[split-method]: https://docs.python.org/3/library/stdtypes.html#str.split +[pathlib-module]: https://docs.python.org/3/library/pathlib.html + + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Use a `for` loop to process files given a list of their names. +- Use `glob.glob` to find sets of files whose names match a pattern. +- Use `glob` and `for` to process batches of files. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/15-coffee.md b/15-coffee.md new file mode 100644 index 000000000..2cb1ddc11 --- /dev/null +++ b/15-coffee.md @@ -0,0 +1,18 @@ +--- +title: Afternoon Coffee +teaching: 0 +exercises: 0 +break: 15 +--- + +## Reflection exercise + +Over break, reflect on and discuss the following: + +- A common refrain in software engineering is "Don't Repeat Yourself". How do the techniques we've learned in the last + lessons help us avoid repeating ourselves? *Note that in practice there is some nuance to this and should be balanced + with doing the simplest thing that could possibly work.* +- What are the pros / cons of making a variable global or local to a function? +- When would you consider turning a block of code into a function definition? + + diff --git a/16-writing-functions.md b/16-writing-functions.md new file mode 100644 index 000000000..613850f9b --- /dev/null +++ b/16-writing-functions.md @@ -0,0 +1,678 @@ +--- +title: Writing Functions +teaching: 10 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Explain and identify the difference between function definition and function call. +- Write a function that takes a small, fixed number of arguments and produces a single result. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I create my own functions? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Break programs down into functions to make them easier to understand. + +- Human beings can only keep a few items in working memory at a time. +- Understand larger/more complicated ideas by understanding and combining pieces. + - Components in a machine. + - Lemmas when proving theorems. +- Functions serve the same purpose in programs. + - *Encapsulate* complexity so that we can treat it as a single "thing". +- Also enables *re-use*. + - Write one time, use many times. + +## Define a function using `def` with a name, parameters, and a block of code. + +- Begin the definition of a new function with `def`. +- Followed by the name of the function. + - Must obey the same rules as variable names. +- Then *parameters* in parentheses. + - Empty parentheses if the function doesn't take any inputs. + - We will discuss this in detail in a moment. +- Then a colon. +- Then an indented block of code. + +```python +def print_greeting(): + print('Hello!') + print('The weather is nice today.') + print('Right?') +``` + +## Defining a function does not run it. + +- Defining a function does not run it. + - Like assigning a value to a variable. +- Must call the function to execute the code it contains. + +```python +print_greeting() +``` + +```output +Hello! +``` + +## Arguments in a function call are matched to its defined parameters. + +- Functions are most useful when they can operate on different data. +- Specify *parameters* when defining a function. + - These become variables when the function is executed. + - Are assigned the arguments in the call (i.e., the values passed to the function). + - If you don't name the arguments when using them in the call, the arguments will be matched to + parameters in the order the parameters are defined in the function. + +```python +def print_date(year, month, day): + joined = str(year) + '/' + str(month) + '/' + str(day) + print(joined) + +print_date(1871, 3, 19) +``` + +```output +1871/3/19 +``` + +Or, we can name the arguments when we call the function, which allows us to +specify them in any order and adds clarity to the call site; otherwise as +one is reading the code they might forget if the second argument is the month +or the day for example. + +```python +print_date(month=3, day=19, year=1871) +``` + +```output +1871/3/19 +``` + +- Via [Twitter](https://twitter.com/minisciencegirl/status/693486088963272705): + `()` contains the ingredients for the function + while the body contains the recipe. + +## Functions may return a result to their caller using `return`. + +- Use `return ...` to give a value back to the caller. +- May occur anywhere in the function. +- But functions are easier to understand if `return` occurs: + - At the start to handle special cases. + - At the very end, with a final result. + +```python +def average(values): + if len(values) == 0: + return None + return sum(values) / len(values) +``` + +```python +a = average([1, 3, 4]) +print('average of actual values:', a) +``` + +```output +average of actual values: 2.6666666666666665 +``` + +```python +print('average of empty list:', average([])) +``` + +```output +average of empty list: None +``` + +- Remember: [every function returns something](04-built-in.md). +- A function that doesn't explicitly `return` a value automatically returns `None`. + +```python +result = print_date(1871, 3, 19) +print('result of call is:', result) +``` + +```output +1871/3/19 +result of call is: None +``` + +::::::::::::::::::::::::::::::::::::::: challenge + +## Identifying Syntax Errors + +1. Read the code below and try to identify what the errors are + *without* running it. +2. Run the code and read the error message. + Is it a `SyntaxError` or an `IndentationError`? +3. Fix the error. +4. Repeat steps 2 and 3 until you have fixed all the errors. + +```python +def another_function + print("Syntax errors are annoying.") + print("But at least python tells us about them!") + print("So they are usually not too hard to fix.") +``` + +::::::::::::::: solution + +## Solution + +```python +def another_function(): + print("Syntax errors are annoying.") + print("But at least Python tells us about them!") + print("So they are usually not too hard to fix.") +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Definition and Use + +What does the following program print? + +```python +def report(pressure): + print('pressure is', pressure) + +print('calling', report, 22.5) +``` + +::::::::::::::: solution + +## Solution + +```output +calling 22.5 +``` + +A function call always needs parenthesis, otherwise you get memory address of the function object. So, if we wanted to call the function named report, and give it the value 22.5 to report on, we could have our function call as follows + +```python +print("calling") +report(22.5) +``` + +```output +calling +pressure is 22.5 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Order of Operations + +1. What's wrong in this example? + + ```python + result = print_time(11, 37, 59) + + def print_time(hour, minute, second): + time_string = str(hour) + ':' + str(minute) + ':' + str(second) + print(time_string) + ``` + +2. After fixing the problem above, explain why running this example code: + + ```python + result = print_time(11, 37, 59) + print('result of call is:', result) + ``` + + gives this output: + + ```output + 11:37:59 + result of call is: None + ``` + +3. Why is the result of the call `None`? + +::::::::::::::: solution + +## Solution + +1. The problem with the example is that the function `print_time()` is defined *after* the call to the function is made. Python + doesn't know how to resolve the name `print_time` since it hasn't been defined yet and will raise a `NameError` e.g., + `NameError: name 'print_time' is not defined` + +2. The first line of output `11:37:59` is printed by the first line of code, `result = print_time(11, 37, 59)` that binds the value + returned by invoking `print_time` to the variable `result`. The second line is from the second print call to print the contents + of the `result` variable. + +3. `print_time()` does not explicitly `return` a value, so it automatically returns `None`. + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Encapsulation + +Fill in the blanks to create a function that takes a single filename as an argument, +loads the data in the file named by the argument, +and returns the minimum value in that data. + +```python +import pandas as pd + +def min_in_data(____): + data = ____ + return ____ +``` + +::::::::::::::: solution + +## Solution + +```python +import pandas as pd + +def min_in_data(filename): + data = pd.read_csv(filename) + return data.min() +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Find the First + +Fill in the blanks to create a function that takes a list of numbers as an argument +and returns the first negative value in the list. +What does your function do if the list is empty? What if the list has no negative numbers? + +```python +def first_negative(values): + for v in ____: + if ____: + return ____ +``` + +::::::::::::::: solution + +## Solution + +```python +def first_negative(values): + for v in values: + if v < 0: + return v +``` + +If an empty list or a list with all positive values is passed to this function, it returns `None`: + +```python +my_list = [] +print(first_negative(my_list)) +``` + +```output +None +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Calling by Name + +Earlier we saw this function: + +```python +def print_date(year, month, day): + joined = str(year) + '/' + str(month) + '/' + str(day) + print(joined) +``` + +We saw that we can call the function using *named arguments*, like this: + +```python +print_date(day=1, month=2, year=2003) +``` + +1. What does `print_date(day=1, month=2, year=2003)` print? +2. When have you seen a function call like this before? +3. When and why is it useful to call functions this way? + +::::::::::::::: solution + +## Solution + +1. `2003/2/1` +2. We saw examples of using *named arguments* when working with the pandas library. For example, when reading in a dataset + using `data = pd.read_csv('data/gapminder_gdp_europe.csv', index_col='country')`, the last argument `index_col` is a + named argument. +3. Using named arguments can make code more readable since one can see from the function call what name the different arguments + have inside the function. It can also reduce the chances of passing arguments in the wrong order, since by using named arguments + the order doesn't matter. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Encapsulation of an If/Print Block + +The code below will run on a label-printer for chicken eggs. A digital scale will report a chicken egg mass (in grams) +to the computer and then the computer will print a label. + +```python +import random +for i in range(10): + + # simulating the mass of a chicken egg + # the (random) mass will be 70 +/- 20 grams + mass = 70 + 20.0 * (2.0 * random.random() - 1.0) + + print(mass) + + # egg sizing machinery prints a label + if mass >= 85: + print("jumbo") + elif mass >= 70: + print("large") + elif mass < 70 and mass >= 55: + print("medium") + else: + print("small") +``` + +The if-block that classifies the eggs might be useful in other situations, +so to avoid repeating it, we could fold it into a function, `get_egg_label()`. +Revising the program to use the function would give us this: + +```python +# revised version +import random +for i in range(10): + + # simulating the mass of a chicken egg + # the (random) mass will be 70 +/- 20 grams + mass = 70 + 20.0 * (2.0 * random.random() - 1.0) + + print(mass, get_egg_label(mass)) + +``` + +1. Create a function definition for `get_egg_label()` that will work with the revised program above. Note that the `get_egg_label()` function's return value will be important. Sample output from the above program would be `71.23 large`. +2. A dirty egg might have a mass of more than 90 grams, and a spoiled or broken egg will probably have a mass that's less than 50 grams. Modify your `get_egg_label()` function to account for these error conditions. Sample output could be `25 too light, probably spoiled`. + +::::::::::::::: solution + +## Solution + +```python +def get_egg_label(mass): + # egg sizing machinery prints a label + egg_label = "Unlabelled" + if mass >= 90: + egg_label = "warning: egg might be dirty" + elif mass >= 85: + egg_label = "jumbo" + elif mass >= 70: + egg_label = "large" + elif mass < 70 and mass >= 55: + egg_label = "medium" + elif mass < 50: + egg_label = "too light, probably spoiled" + else: + egg_label = "small" + return egg_label +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Encapsulating Data Analysis + +Assume that the following code has been executed: + +```python +import pandas as pd + +data_asia = pd.read_csv('data/gapminder_gdp_asia.csv', index_col=0) +japan = data_asia.loc['Japan'] +``` + +1. Complete the statements below to obtain the average GDP for Japan + across the years reported for the 1980s. + + ```python + year = 1983 + gdp_decade = 'gdpPercap_' + str(year // ____) + avg = (japan.loc[gdp_decade + ___] + japan.loc[gdp_decade + ___]) / 2 + ``` + +2. Abstract the code above into a single function. + + ```python + def avg_gdp_in_decade(country, continent, year): + data_countries = pd.read_csv('data/gapminder_gdp_'+___+'.csv',delimiter=',',index_col=0) + ____ + ____ + ____ + return avg + ``` + +3. How would you generalize this function + if you did not know beforehand which specific years occurred as columns in the data? + For instance, what if we also had data from years ending in 1 and 9 for each decade? + (Hint: use the columns to filter out the ones that correspond to the decade, + instead of enumerating them in the code.) + +::::::::::::::: solution + +## Solution + +1. The average GDP for Japan across the years reported for the 1980s is computed with: + + ```python + year = 1983 + gdp_decade = 'gdpPercap_' + str(year // 10) + avg = (japan.loc[gdp_decade + '2'] + japan.loc[gdp_decade + '7']) / 2 + ``` + +2. That code as a function is: + + ```python + def avg_gdp_in_decade(country, continent, year): + data_countries = pd.read_csv('data/gapminder_gdp_' + continent + '.csv', index_col=0) + c = data_countries.loc[country] + gdp_decade = 'gdpPercap_' + str(year // 10) + avg = (c.loc[gdp_decade + '2'] + c.loc[gdp_decade + '7'])/2 + return avg + ``` + +3. To obtain the average for the relevant years, we need to loop over them: + + ```python + def avg_gdp_in_decade(country, continent, year): + data_countries = pd.read_csv('data/gapminder_gdp_' + continent + '.csv', index_col=0) + c = data_countries.loc[country] + gdp_decade = 'gdpPercap_' + str(year // 10) + total = 0.0 + num_years = 0 + for yr_header in c.index: # c's index contains reported years + if yr_header.startswith(gdp_decade): + total = total + c.loc[yr_header] + num_years = num_years + 1 + return total/num_years + ``` + +The function can now be called by: + +```python +avg_gdp_in_decade('Japan','asia',1983) +``` + +```output +20880.023800000003 +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Simulating a dynamical system + +In mathematics, a [dynamical system](https://en.wikipedia.org/wiki/Dynamical_system) is a system +in which a function describes the time dependence of a point in a geometrical space. A canonical +example of a dynamical system is the [logistic map](https://en.wikipedia.org/wiki/Logistic_map), +a growth model that computes a new population density (between 0 and 1) based on the current +density. In the model, time takes discrete values 0, 1, 2, ... + +1. Define a function called `logistic_map` that takes two inputs: `x`, representing the current + population (at time `t`), and a parameter `r = 1`. This function should return a value + representing the state of the system (population) at time `t + 1`, using the mapping function: + + `f(t+1) = r * f(t) * [1 - f(t)]` + +2. Using a `for` or `while` loop, iterate the `logistic_map` function defined in part 1, starting + from an initial population of 0.5, for a period of time `t_final = 10`. Store the intermediate + results in a list so that after the loop terminates you have accumulated a sequence of values + representing the state of the logistic map at times `t = [0,1,...,t_final]` (11 values in total). + Print this list to see the evolution of the population. + +3. Encapsulate the logic of your loop into a function called `iterate` that takes the initial + population as its first input, the parameter `t_final` as its second input and the parameter + `r` as its third input. The function should return the list of values representing the state of + the logistic map at times `t = [0,1,...,t_final]`. Run this function for periods `t_final = 100` + and `1000` and print some of the values. Is the population trending toward a steady state? + +::::::::::::::: solution + +## Solution + +1. ```python + def logistic_map(x, r): + return r * x * (1 - x) + ``` + +2. ```python + initial_population = 0.5 + t_final = 10 + r = 1.0 + population = [initial_population] + for t in range(t_final): + population.append( logistic_map(population[t], r) ) + ``` + +3. ```python + def iterate(initial_population, t_final, r): + population = [initial_population] + for t in range(t_final): + population.append( logistic_map(population[t], r) ) + return population + + for period in (10, 100, 1000): + population = iterate(0.5, period, 1) + print(population[-1]) + ``` + + ```output + 0.06945089389714401 + 0.009395779870614648 + 0.0009913908614406382 + ``` + + The population seems to be approaching zero. + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::::: callout + +## Using Functions With Conditionals in Pandas + +Functions will often contain conditionals. Here is a short example that +will indicate which quartile the argument is in based on hand-coded values +for the quartile cut points. + +```python +def calculate_life_quartile(exp): + if exp < 58.41: + # This observation is in the first quartile + return 1 + elif exp >= 58.41 and exp < 67.05: + # This observation is in the second quartile + return 2 + elif exp >= 67.05 and exp < 71.70: + # This observation is in the third quartile + return 3 + elif exp >= 71.70: + # This observation is in the fourth quartile + return 4 + else: + # This observation has bad data + return None + +calculate_life_quartile(62.5) +``` + +```output +2 +``` + +That function would typically be used within a `for` loop, but Pandas has +a different, more efficient way of doing the same thing, and that is by +*applying* a function to a dataframe or a portion of a dataframe. Here +is an example, using the definition above. + +```python +data = pd.read_csv('data/gapminder_all.csv') +data['life_qrtl'] = data['lifeExp_1952'].apply(calculate_life_quartile) +``` + +There is a lot in that second line, so let's take it piece by piece. +On the right side of the `=` we start with `data['lifeExp']`, which is the +column in the dataframe called `data` labeled `lifExp`. We use the +`apply()` to do what it says, apply the `calculate_life_quartile` to the +value of this column for every row in the dataframe. + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Break programs down into functions to make them easier to understand. +- Define a function using `def` with a name, parameters, and a block of code. +- Defining a function does not run it. +- Arguments in a function call are matched to its defined parameters. +- Functions may return a result to their caller using `return`. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/17-scope.md b/17-scope.md new file mode 100644 index 000000000..afa533b98 --- /dev/null +++ b/17-scope.md @@ -0,0 +1,143 @@ +--- +title: Variable Scope +teaching: 10 +exercises: 10 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Identify local and global variables. +- Identify parameters as local variables. +- Read a traceback and determine the file, function, and line number on which the error occurred, the type of error, and the error message. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How do function calls actually work? +- How can I determine where errors occurred? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## The scope of a variable is the part of a program that can 'see' that variable. + +- There are only so many sensible names for variables. +- People using functions shouldn't have to worry about + what variable names the author of the function used. +- People writing functions shouldn't have to worry about + what variable names the function's caller uses. +- The part of a program in which a variable is visible is called its *scope*. + +```python +pressure = 103.9 + +def adjust(t): + temperature = t * 1.43 / pressure + return temperature +``` + +- `pressure` is a *global variable*. + - Defined outside any particular function. + - Visible everywhere. +- `t` and `temperature` are *local variables* in `adjust`. + - Defined in the function. + - Not visible in the main program. + - Remember: a function parameter is a variable + that is automatically assigned a value when the function is called. + +```python +print('adjusted:', adjust(0.9)) +print('temperature after call:', temperature) +``` + +```output +adjusted: 0.01238691049085659 +``` + +```error +Traceback (most recent call last): + File "/Users/swcarpentry/foo.py", line 8, in + print('temperature after call:', temperature) +NameError: name 'temperature' is not defined +``` + +::::::::::::::::::::::::::::::::::::::: challenge + +## Local and Global Variable Use + +Trace the values of all variables in this program as it is executed. +(Use '---' as the value of variables before and after they exist.) + +```python +limit = 100 + +def clip(value): + return min(max(0.0, value), limit) + +value = -22.5 +print(clip(value)) +``` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Reading Error Messages + +Read the traceback below, and identify the following: + +1. How many levels does the traceback have? +2. What is the file name where the error occurred? +3. What is the function name where the error occurred? +4. On which line number in this function did the error occur? +5. What is the type of error? +6. What is the error message? + +```error +--------------------------------------------------------------------------- +KeyError Traceback (most recent call last) + in () + 1 import errors_02 +----> 2 errors_02.print_friday_message() + +/Users/ghopper/thesis/code/errors_02.py in print_friday_message() + 13 + 14 def print_friday_message(): +---> 15 print_message("Friday") + +/Users/ghopper/thesis/code/errors_02.py in print_message(day) + 9 "sunday": "Aw, the weekend is almost over." + 10 } +---> 11 print(messages[day]) + 12 + 13 + +KeyError: 'Friday' +``` + +::::::::::::::: solution + +## Solution + +1. Three levels. +2. `errors_02.py` +3. `print_message` +4. Line 11 +5. `KeyError`. These errors occur when we are trying to look up a key that does not exist (usually in a data + structure such as a dictionary). We can find more information about the `KeyError` and other built-in exceptions + in the [Python docs](https://docs.python.org/3/library/exceptions.html#KeyError). +6. `KeyError: 'Friday'` + + + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- The scope of a variable is the part of a program that can 'see' that variable. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/18-style.md b/18-style.md new file mode 100644 index 000000000..886093885 --- /dev/null +++ b/18-style.md @@ -0,0 +1,257 @@ +--- +title: Programming Style +teaching: 15 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Provide sound justifications for basic rules of coding style. +- Refactor one-page programs to make them more readable and justify the changes. +- Use Python community coding standards (PEP-8). + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How can I make my programs more readable? +- How do most programmers format their code? +- How can programs check their own operation? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Coding style + +A consistent coding style helps others (including our future selves) read and understand code more easily. Code is read much more often than it is written, and as the [Zen of Python](https://www.python.org/dev/peps/pep-0020) states, "Readability counts". +Python proposed a standard style through one of its first Python Enhancement Proposals (PEP), [PEP8](https://www.python.org/dev/peps/pep-0008). + +Some points worth highlighting: + +- document your code and ensure that assumptions, internal algorithms, expected inputs, expected outputs, etc., are clear +- use clear, semantically meaningful variable names +- use white-space, *not* tabs, to indent lines (tabs can cause problems across different text editors, operating systems, and version control systems) + +## Follow standard Python style in your code. + +- [PEP8](https://www.python.org/dev/peps/pep-0008): + a style guide for Python that discusses topics such as how to name variables, + how to indent your code, + how to structure your `import` statements, + etc. + Adhering to PEP8 makes it easier for other Python developers to read and understand your code, and to understand what their contributions should look like. +- To check your code for compliance with PEP8, you can use the [pycodestyle application](https://pypi.org/project/pycodestyle/) and tools like the [black code formatter](https://github.com/psf/black) can automatically format your code to conform to PEP8 and pycodestyle (a Jupyter notebook formatter also exists [nb\_black](https://github.com/dnanhkhoa/nb_black)). +- Some groups and organizations follow different style guidelines besides PEP8. For example, the [Google style guide on Python](https://google.github.io/styleguide/pyguide.html) makes slightly different recommendations. Google wrote an application that can help you format your code in either their style or PEP8 called [yapf](https://github.com/google/yapf/). +- With respect to coding style, the key is *consistency*. Choose a style for your project be it PEP8, the Google style, or something else and do your best to ensure that you and anyone else you are collaborating with sticks to it. Consistency within a project is often more impactful than the particular style used. A consistent style will make your software easier to read and understand for others and for your future self. + +## Use assertions to check for internal errors. + +Assertions are a simple but powerful method for making sure that the context in which your code is executing is as you expect. + +```python +def calc_bulk_density(mass, volume): + '''Return dry bulk density = powder mass / powder volume.''' + assert volume > 0 + return mass / volume +``` + +If the assertion is `False`, the Python interpreter raises an `AssertionError` runtime exception. The source code for the expression that failed will be displayed as part of the error message. To ignore assertions in your code run the interpreter with the '-O' (optimize) switch. Assertions should contain only simple checks and never change the state of the program. For example, an assertion should never contain an assignment. + +## Use docstrings to provide builtin help. + +If the first thing in a function is a character string that is not assigned directly to a variable, Python attaches it to the function, accessible via the builtin help function. This string that provides documentation is also known as a *docstring*. + +```python +def average(values): + "Return average of values, or None if no values are supplied." + + if len(values) == 0: + return None + return sum(values) / len(values) + +help(average) +``` + +```output +Help on function average in module __main__: + +average(values) + Return average of values, or None if no values are supplied. +``` + +::::::::::::::::::::::::::::::::::::::::: callout + +## Multiline Strings + +Often use *multiline strings* for documentation. +These start and end with three quote characters (either single or double) +and end with three matching characters. + +```python +"""This string spans +multiple lines. + +Blank lines are allowed.""" +``` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## What Will Be Shown? + +Highlight the lines in the code below that will be available as online help. +Are there lines that should be made available, but won't be? +Will any lines produce a syntax error or a runtime error? + +```python +"Find maximum edit distance between multiple sequences." +# This finds the maximum distance between all sequences. + +def overall_max(sequences): + '''Determine overall maximum edit distance.''' + + highest = 0 + for left in sequences: + for right in sequences: + '''Avoid checking sequence against itself.''' + if left != right: + this = edit_distance(left, right) + highest = max(highest, this) + + # Report. + return highest +``` + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Document This + +Use comments to describe and help others understand potentially unintuitive +sections or individual lines of code. They are especially useful to whoever +may need to understand and edit your code in the future, including yourself. + +Use docstrings to document the acceptable inputs and expected outputs of a method +or class, its purpose, assumptions and intended behavior. Docstrings are displayed +when a user invokes the builtin `help` method on your method or class. + +Turn the comment in the following function into a docstring +and check that `help` displays it properly. + +```python +def middle(a, b, c): + # Return the middle value of three. + # Assumes the values can actually be compared. + values = [a, b, c] + values.sort() + return values[1] +``` + +::::::::::::::: solution + +## Solution + +```python +def middle(a, b, c): + '''Return the middle value of three. + Assumes the values can actually be compared.''' + values = [a, b, c] + values.sort() + return values[1] +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +::::::::::::::::::::::::::::::::::::::: challenge + +## Clean Up This Code + +1. Read this short program and try to predict what it does. +2. Run it: how accurate was your prediction? +3. Refactor the program to make it more readable. + Remember to run it after each change to ensure its behavior hasn't changed. +4. Compare your rewrite with your neighbor's. + What did you do the same? + What did you do differently, and why? + +```python +n = 10 +s = 'et cetera' +print(s) +i = 0 +while i < n: + # print('at', j) + new = '' + for j in range(len(s)): + left = j-1 + right = (j+1)%len(s) + if s[left]==s[right]: new = new + '-' + else: new = new + '*' + s=''.join(new) + print(s) + i += 1 +``` + +::::::::::::::: solution + +## Solution + +Here's one solution. + +```python +def string_machine(input_string, iterations): + """ + Takes input_string and generates a new string with -'s and *'s + corresponding to characters that have identical adjacent characters + or not, respectively. Iterates through this procedure with the resultant + strings for the supplied number of iterations. + """ + print(input_string) + input_string_length = len(input_string) + old = input_string + for i in range(iterations): + new = '' + # iterate through characters in previous string + for j in range(input_string_length): + left = j-1 + right = (j+1) % input_string_length # ensure right index wraps around + if old[left] == old[right]: + new = new + '-' + else: + new = new + '*' + print(new) + # store new string as old + old = new + +string_machine('et cetera', 10) +``` + +```output +et cetera +*****-*** +----*-*-- +---*---*- +--*-*-*-* +**------- +***-----* +--**---** +*****-*** +----*-*-- +---*---*- +``` + +::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Follow standard Python style in your code. +- Use docstrings to provide builtin help. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/19-wrap.md b/19-wrap.md new file mode 100644 index 000000000..e6cfdf074 --- /dev/null +++ b/19-wrap.md @@ -0,0 +1,51 @@ +--- +title: Wrap-Up +teaching: 20 +exercises: 0 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Name and locate scientific Python community sites for software, workshops, and help. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- What have we learned? +- What else is out there and where do I find it? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +Leslie Lamport once said, "Writing is nature's way of showing you how sloppy your thinking is." +The same is true of programming: +many things that seem obvious when we're thinking about them +turn out to be anything but when we have to explain them precisely. + +## Python supports a large and diverse community across academia and industry. + +- The [Python 3 documentation](https://docs.python.org/3/) covers the core language + and the standard library. + +- [PyCon](https://pycon.org/) is the largest annual conference for the Python community. + +- [SciPy](https://scipy.org) is a rich collection of scientific utilities. + It is also the name of [a series of annual conferences](https://conference.scipy.org/). + +- [Jupyter](https://jupyter.org) is the home of Project Jupyter. + +- [Pandas](https://pandas.pydata.org) is the home of the Pandas data library. + +- Stack Overflow's [general Python section](https://stackoverflow.com/questions/tagged/python?tab=Votes) + can be helpful, + as well as the sections on [NumPy](https://stackoverflow.com/questions/tagged/numpy?tab=Votes), + [SciPy](https://stackoverflow.com/questions/tagged/scipy?tab=Votes), and + [Pandas](https://stackoverflow.com/questions/tagged/pandas?tab=Votes). + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- Python supports a large and diverse community across academia and industry. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/20-feedback.md b/20-feedback.md new file mode 100644 index 000000000..37e3060dd --- /dev/null +++ b/20-feedback.md @@ -0,0 +1,27 @@ +--- +title: Feedback +teaching: 0 +exercises: 15 +--- + +::::::::::::::::::::::::::::::::::::::: objectives + +- Gather feedback on the class + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +:::::::::::::::::::::::::::::::::::::::: questions + +- How did the class go? + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +Gather feedback from participants. + +:::::::::::::::::::::::::::::::::::::::: keypoints + +- We are constantly seeking to improve this course. + +:::::::::::::::::::::::::::::::::::::::::::::::::: + + diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..f19b80495 --- /dev/null +++ b/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 diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 000000000..7632871ff --- /dev/null +++ b/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 ), 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 diff --git a/config.yaml b/config.yaml new file mode 100644 index 000000000..212cb4b7c --- /dev/null +++ b/config.yaml @@ -0,0 +1,100 @@ +#------------------------------------------------------------ +# Values for this lesson. +#------------------------------------------------------------ + +# Which carpentry is this (swc, dc, lc, or cp)? +# swc: Software Carpentry +# dc: Data Carpentry +# lc: Library Carpentry +# cp: Carpentries (to use for instructor training for instance) +# incubator: The Carpentries Incubator +carpentry: 'swc' + +# Overall title for pages. +title: 'Plotting and Programming in Python' + +# Date the lesson was created (YYYY-MM-DD, this is empty by default) +created: '2016-01-07' + +# Comma-separated list of keywords for the lesson +keywords: 'software, data, lesson, The Carpentries' + +# Life cycle stage of the lesson +# possible values: pre-alpha, alpha, beta, stable +life_cycle: 'stable' + +# License of the lesson materials (recommended CC-BY 4.0) +license: 'CC-BY 4.0' + +# Link to the source repository for this lesson +source: 'https://github.com/swcarpentry/python-novice-gapminder' + +# Default branch of your lesson +branch: 'main' + +# Who to contact if there are any issues +contact: 'team@carpentries.org' + +# Navigation ------------------------------------------------ +# +# Use the following menu items to specify the order of +# individual pages in each dropdown section. Leave blank to +# include all pages in the folder. +# +# Example ------------- +# +# episodes: +# - introduction.md +# - first-steps.md +# +# learners: +# - setup.md +# +# instructors: +# - instructor-notes.md +# +# profiles: +# - one-learner.md +# - another-learner.md + +# Order of episodes in your lesson +episodes: +- 01-run-quit.md +- 02-variables.md +- 03-types-conversion.md +- 04-built-in.md +- 05-coffee.md +- 06-libraries.md +- 07-reading-tabular.md +- 08-data-frames.md +- 09-plotting.md +- 10-lunch.md +- 11-lists.md +- 12-for-loops.md +- 13-conditionals.md +- 14-looping-data-sets.md +- 15-coffee.md +- 16-writing-functions.md +- 17-scope.md +- 18-style.md +- 19-wrap.md +- 20-feedback.md + +# Information for Learners +learners: + +# Information for Instructors +instructors: + +# Learner Profiles +profiles: + +# Customisation --------------------------------------------- +# +# This space below is where custom yaml items (e.g. pinning +# sandpaper and varnish versions) should live + + +url: 'https://swcarpentry.github.io/python-novice-gapminder' +analytics: carpentries +lang: en diff --git a/data/asia_gdp_per_capita.csv b/data/asia_gdp_per_capita.csv new file mode 100644 index 000000000..6fba7d500 --- /dev/null +++ b/data/asia_gdp_per_capita.csv @@ -0,0 +1,13 @@ +'year','Afghanistan','Bahrain','Bangladesh','Cambodia','China','Hong Kong China','India','Indonesia','Iran','Iraq','Israel','Japan','Jordan','Korea Dem. Rep.','Korea Rep.','Kuwait','Lebanon','Malaysia','Mongolia','Myanmar','Nepal','Oman','Pakistan','Philippines','Saudi Arabia','Singapore','Sri Lanka','Syria','Taiwan','Thailand','Vietnam','West Bank and Gaza','Yemen Rep.' +1952,779.4453145,9867.084765,684.2441716,368.4692856,400.4486107,3054.421209,546.5657493,749.6816546,3035.326002,4129.766056,4086.522128,3216.956347,1546.907807,1088.277758,1030.592226,108382.3529,4834.804067,1831.132894,786.5668575,331,545.8657229,1828.230307,684.5971438,1272.880995,6459.554823,2315.138227,1083.53203,1643.485354,1206.947913,757.7974177,605.0664917,1515.592329,781.7175761 +1957,820.8530296,11635.79945,661.6374577,434.0383364,575.9870009,3629.076457,590.061996,858.9002707,3290.257643,6229.333562,5385.278451,4317.694365,1886.080591,1571.134655,1487.593537,113523.1329,6089.786934,1810.066992,912.6626085,350,597.9363558,2242.746551,747.0835292,1547.944844,8157.591248,2843.104409,1072.546602,2117.234893,1507.86129,793.5774148,676.2854478,1827.067742,804.8304547 +1962,853.10071,12753.27514,686.3415538,496.9136476,487.6740183,4692.648272,658.3471509,849.2897701,4187.329802,8341.737815,7105.630706,6576.649461,2348.009158,1621.693598,1536.344387,95458.11176,5714.560611,2036.884944,1056.353958,388,652.3968593,2924.638113,803.3427418,1649.552153,11626.41975,3674.735572,1074.47196,2193.037133,1822.879028,1002.199172,772.0491602,2198.956312,825.6232006 +1967,836.1971382,14804.6727,721.1860862,523.4323142,612.7056934,6197.962814,700.7706107,762.4317721,5906.731805,8931.459811,8393.741404,9847.788607,2741.796252,2143.540609,2029.228142,80894.88326,6006.983042,2277.742396,1226.04113,349,676.4422254,4720.942687,942.4082588,1814.12743,16903.04886,4977.41854,1135.514326,1881.923632,2643.858681,1295.46066,637.1232887,2649.715007,862.4421463 +1972,739.9811058,18268.65839,630.2336265,421.6240257,676.9000921,8315.928145,724.032527,1111.107907,9613.818607,9576.037596,12786.93223,14778.78636,2110.856309,3701.621503,3030.87665,109347.867,7486.384341,2849.09478,1421.741975,357,674.7881296,10618.03855,1049.938981,1989.37407,24837.42865,8597.756202,1213.39553,2571.423014,4062.523897,1524.358936,699.5016441,3133.409277,1265.047031 +1977,786.11336,19340.10196,659.8772322,524.9721832,741.2374699,11186.14125,813.337323,1382.702056,11888.59508,14688.23507,13306.61921,16610.37701,2852.351568,4106.301249,4657.22102,59265.47714,8659.696836,3827.921571,1647.511665,371,694.1124398,11848.34392,1175.921193,2373.204287,34167.7626,11210.08948,1348.775651,3195.484582,5596.519826,1961.224635,713.5371196,3682.831494,1829.765177 +1982,978.0114388,19211.14731,676.9818656,624.4754784,962.4213805,14560.53051,855.7235377,1516.872988,7608.334602,14517.90711,15367.0292,19384.10571,4161.415959,4106.525293,5622.942464,31354.03573,7640.519521,4920.355951,2000.603139,424,718.3730947,12954.79101,1443.429832,2603.273765,33693.17525,15169.16112,1648.079789,3761.837715,7426.354774,2393.219781,707.2357863,4336.032082,1977.55701 +1987,852.3959448,18524.02406,751.9794035,683.8955732,1378.904018,20038.47269,976.5126756,1748.356961,6642.881371,11643.57268,17122.47986,22375.94189,4448.679912,4106.492315,8533.088805,28118.42998,5377.091329,5249.802653,2338.008304,385,775.6324501,18115.22313,1704.686583,2189.634995,21198.26136,18861.53081,1876.766827,3116.774285,11054.56175,2982.653773,820.7994449,5107.197384,1971.741538 +1992,649.3413952,19035.57917,837.8101643,682.3031755,1655.784158,24757.60301,1164.406809,2383.140898,7235.653188,3745.640687,18051.52254,26824.89511,3431.593647,3726.063507,12104.27872,34932.91959,6890.806854,7277.912802,1785.402016,347,897.7403604,18616.70691,1971.829464,2279.324017,24841.61777,24769.8912,2153.739222,3340.542768,15215.6579,4616.896545,989.0231487,6017.654756,1879.496673 +1997,635.341351,20292.01679,972.7700352,734.28517,2289.234136,28377.63219,1458.817442,3119.335603,8263.590301,3076.239795,20896.60924,28816.58499,3645.379572,1690.756814,15993.52796,40300.61996,8754.96385,10132.90964,1902.2521,415,1010.892138,19702.05581,2049.350521,2536.534925,20586.69019,33519.4766,2664.477257,4014.238972,20206.82098,5852.625497,1385.896769,7110.667619,2117.484526 +2002,726.7340548,23403.55927,1136.39043,896.2260153,3119.280896,30209.01516,1746.769454,2873.91287,9240.761975,4390.717312,21905.59514,28604.5919,3844.917194,1646.758151,19233.98818,35110.10566,9313.93883,10206.97794,2140.739323,611,1057.206311,19774.83687,2092.712441,2650.921068,19014.54118,36023.1054,3015.378833,4090.925331,23235.42329,5913.187529,1764.456677,4515.487575,2234.820827 +2007,974.5803384,29796.04834,1391.253792,1713.778686,4959.114854,39724.97867,2452.210407,3540.651564,11605.71449,4471.061906,25523.2771,31656.06806,4519.461171,1593.06548,23348.13973,47306.98978,10461.05868,12451.6558,3095.772271,944,1091.359778,22316.19287,2605.94758,3190.481016,21654.83194,47143.17964,3970.095407,4184.548089,28718.27684,7458.396327,2441.576404,3025.349798,2280.769906 diff --git a/data/gapminder_all.csv b/data/gapminder_all.csv new file mode 100644 index 000000000..6824ead2d --- /dev/null +++ b/data/gapminder_all.csv @@ -0,0 +1,143 @@ +"continent","country","gdpPercap_1952","gdpPercap_1957","gdpPercap_1962","gdpPercap_1967","gdpPercap_1972","gdpPercap_1977","gdpPercap_1982","gdpPercap_1987","gdpPercap_1992","gdpPercap_1997","gdpPercap_2002","gdpPercap_2007","lifeExp_1952","lifeExp_1957","lifeExp_1962","lifeExp_1967","lifeExp_1972","lifeExp_1977","lifeExp_1982","lifeExp_1987","lifeExp_1992","lifeExp_1997","lifeExp_2002","lifeExp_2007","pop_1952","pop_1957","pop_1962","pop_1967","pop_1972","pop_1977","pop_1982","pop_1987","pop_1992","pop_1997","pop_2002","pop_2007" +"Africa","Algeria",2449.008185,3013.976023,2550.81688,3246.991771,4182.663766,4910.416756,5745.160213,5681.358539,5023.216647,4797.295051,5288.040382,6223.367465,43.077,45.685,48.303,51.407,54.518,58.014,61.368,65.799,67.744,69.152,70.994,72.301,9279525,10270856,11000948,12760499,14760787,17152804,20033753,23254956,26298373,29072015,31287142,33333216 +"Africa","Angola",3520.610273,3827.940465,4269.276742,5522.776375,5473.288005,3008.647355,2756.953672,2430.208311,2627.845685,2277.140884,2773.287312,4797.231267,30.015,31.999,34,35.985,37.928,39.483,39.942,39.906,40.647,40.963,41.003,42.731,4232095,4561361,4826015,5247469,5894858,6162675,7016384,7874230,8735988,9875024,10866106,12420476 +"Africa","Benin",1062.7522,959.6010805,949.4990641,1035.831411,1085.796879,1029.161251,1277.897616,1225.85601,1191.207681,1232.975292,1372.877931,1441.284873,38.223,40.358,42.618,44.885,47.014,49.19,50.904,52.337,53.919,54.777,54.406,56.728,1738315,1925173,2151895,2427334,2761407,3168267,3641603,4243788,4981671,6066080,7026113,8078314 +"Africa","Botswana",851.2411407,918.2325349,983.6539764,1214.709294,2263.611114,3214.857818,4551.14215,6205.88385,7954.111645,8647.142313,11003.60508,12569.85177,47.622,49.618,51.52,53.298,56.024,59.319,61.484,63.622,62.745,52.556,46.634,50.728,442308,474639,512764,553541,619351,781472,970347,1151184,1342614,1536536,1630347,1639131 +"Africa","Burkina Faso",543.2552413,617.1834648,722.5120206,794.8265597,854.7359763,743.3870368,807.1985855,912.0631417,931.7527731,946.2949618,1037.645221,1217.032994,31.975,34.906,37.814,40.697,43.591,46.137,48.122,49.557,50.26,50.324,50.65,52.295,4469979,4713416,4919632,5127935,5433886,5889574,6634596,7586551,8878303,10352843,12251209,14326203 +"Africa","Burundi",339.2964587,379.5646281,355.2032273,412.9775136,464.0995039,556.1032651,559.603231,621.8188189,631.6998778,463.1151478,446.4035126,430.0706916,39.031,40.533,42.045,43.548,44.057,45.91,47.471,48.211,44.736,45.326,47.36,49.58,2445618,2667518,2961915,3330989,3529983,3834415,4580410,5126023,5809236,6121610,7021078,8390505 +"Africa","Cameroon",1172.667655,1313.048099,1399.607441,1508.453148,1684.146528,1783.432873,2367.983282,2602.664206,1793.163278,1694.337469,1934.011449,2042.09524,38.523,40.428,42.643,44.799,47.049,49.355,52.961,54.985,54.314,52.199,49.856,50.43,5009067,5359923,5793633,6335506,7021028,7959865,9250831,10780667,12467171,14195809,15929988,17696293 +"Africa","Central African Republic",1071.310713,1190.844328,1193.068753,1136.056615,1070.013275,1109.374338,956.7529907,844.8763504,747.9055252,740.5063317,738.6906068,706.016537,35.463,37.464,39.475,41.478,43.457,46.775,48.295,50.485,49.396,46.066,43.308,44.741,1291695,1392284,1523478,1733638,1927260,2167533,2476971,2840009,3265124,3696513,4048013,4369038 +"Africa","Chad",1178.665927,1308.495577,1389.817618,1196.810565,1104.103987,1133.98495,797.9081006,952.386129,1058.0643,1004.961353,1156.18186,1704.063724,38.092,39.881,41.716,43.601,45.569,47.383,49.517,51.051,51.724,51.573,50.525,50.651,2682462,2894855,3150417,3495967,3899068,4388260,4875118,5498955,6429417,7562011,8835739,10238807 +"Africa","Comoros",1102.990936,1211.148548,1406.648278,1876.029643,1937.577675,1172.603047,1267.100083,1315.980812,1246.90737,1173.618235,1075.811558,986.1478792,40.715,42.46,44.467,46.472,48.944,50.939,52.933,54.926,57.939,60.66,62.974,65.152,153936,170928,191689,217378,250027,304739,348643,395114,454429,527982,614382,710960 +"Africa","Congo Dem. Rep.",780.5423257,905.8602303,896.3146335,861.5932424,904.8960685,795.757282,673.7478181,672.774812,457.7191807,312.188423,241.1658765,277.5518587,39.143,40.652,42.122,44.056,45.989,47.804,47.784,47.412,45.548,42.587,44.966,46.462,14100005,15577932,17486434,19941073,23007669,26480870,30646495,35481645,41672143,47798986,55379852,64606759 +"Africa","Congo Rep.",2125.621418,2315.056572,2464.783157,2677.939642,3213.152683,3259.178978,4879.507522,4201.194937,4016.239529,3484.164376,3484.06197,3632.557798,42.111,45.053,48.435,52.04,54.907,55.625,56.695,57.47,56.433,52.962,52.97,55.322,854885,940458,1047924,1179760,1340458,1536769,1774735,2064095,2409073,2800947,3328795,3800610 +"Africa","Cote d'Ivoire",1388.594732,1500.895925,1728.869428,2052.050473,2378.201111,2517.736547,2602.710169,2156.956069,1648.073791,1786.265407,1648.800823,1544.750112,40.477,42.469,44.93,47.35,49.801,52.374,53.983,54.655,52.044,47.991,46.832,48.328,2977019,3300000,3832408,4744870,6071696,7459574,9025951,10761098,12772596,14625967,16252726,18013409 +"Africa","Djibouti",2669.529475,2864.969076,3020.989263,3020.050513,3694.212352,3081.761022,2879.468067,2880.102568,2377.156192,1895.016984,1908.260867,2082.481567,34.812,37.328,39.693,42.074,44.366,46.519,48.812,50.04,51.604,53.157,53.373,54.791,63149,71851,89898,127617,178848,228694,305991,311025,384156,417908,447416,496374 +"Africa","Egypt",1418.822445,1458.915272,1693.335853,1814.880728,2024.008147,2785.493582,3503.729636,3885.46071,3794.755195,4173.181797,4754.604414,5581.180998,41.893,44.444,46.992,49.293,51.137,53.319,56.006,59.797,63.674,67.217,69.806,71.338,22223309,25009741,28173309,31681188,34807417,38783863,45681811,52799062,59402198,66134291,73312559,80264543 +"Africa","Equatorial Guinea",375.6431231,426.0964081,582.8419714,915.5960025,672.4122571,958.5668124,927.8253427,966.8968149,1132.055034,2814.480755,7703.4959,12154.08975,34.482,35.983,37.485,38.987,40.516,42.024,43.662,45.664,47.545,48.245,49.348,51.579,216964,232922,249220,259864,277603,192675,285483,341244,387838,439971,495627,551201 +"Africa","Eritrea",328.9405571,344.1618859,380.9958433,468.7949699,514.3242082,505.7538077,524.8758493,521.1341333,582.8585102,913.47079,765.3500015,641.3695236,35.928,38.047,40.158,42.189,44.142,44.535,43.89,46.453,49.991,53.378,55.24,58.04,1438760,1542611,1666618,1820319,2260187,2512642,2637297,2915959,3668440,4058319,4414865,4906585 +"Africa","Ethiopia",362.1462796,378.9041632,419.4564161,516.1186438,566.2439442,556.8083834,577.8607471,573.7413142,421.3534653,515.8894013,530.0535319,690.8055759,34.078,36.667,40.059,42.115,43.515,44.51,44.916,46.684,48.091,49.402,50.725,52.947,20860941,22815614,25145372,27860297,30770372,34617799,38111756,42999530,52088559,59861301,67946797,76511887 +"Africa","Gabon",4293.476475,4976.198099,6631.459222,8358.761987,11401.94841,21745.57328,15113.36194,11864.40844,13522.15752,14722.84188,12521.71392,13206.48452,37.003,38.999,40.489,44.598,48.69,52.79,56.564,60.19,61.366,60.461,56.761,56.735,420702,434904,455661,489004,537977,706367,753874,880397,985739,1126189,1299304,1454867 +"Africa","Gambia",485.2306591,520.9267111,599.650276,734.7829124,756.0868363,884.7552507,835.8096108,611.6588611,665.6244126,653.7301704,660.5855997,752.7497265,30,32.065,33.896,35.857,38.308,41.842,45.58,49.265,52.644,55.861,58.041,59.448,284320,323150,374020,439593,517101,608274,715523,848406,1025384,1235767,1457766,1688359 +"Africa","Ghana",911.2989371,1043.561537,1190.041118,1125.69716,1178.223708,993.2239571,876.032569,847.0061135,925.060154,1005.245812,1111.984578,1327.60891,43.149,44.779,46.452,48.072,49.875,51.756,53.744,55.729,57.501,58.556,58.453,60.022,5581001,6391288,7355248,8490213,9354120,10538093,11400338,14168101,16278738,18418288,20550751,22873338 +"Africa","Guinea",510.1964923,576.2670245,686.3736739,708.7595409,741.6662307,874.6858643,857.2503577,805.5724718,794.3484384,869.4497668,945.5835837,942.6542111,33.609,34.558,35.753,37.197,38.842,40.762,42.891,45.552,48.576,51.455,53.676,56.007,2664249,2876726,3140003,3451418,3811387,4227026,4710497,5650262,6990574,8048834,8807818,9947814 +"Africa","Guinea-Bissau",299.850319,431.7904566,522.0343725,715.5806402,820.2245876,764.7259628,838.1239671,736.4153921,745.5398706,796.6644681,575.7047176,579.231743,32.5,33.489,34.488,35.492,36.486,37.465,39.327,41.245,43.266,44.873,45.504,46.388,580653,601095,627820,601287,625361,745228,825987,927524,1050938,1193708,1332459,1472041 +"Africa","Kenya",853.540919,944.4383152,896.9663732,1056.736457,1222.359968,1267.613204,1348.225791,1361.936856,1341.921721,1360.485021,1287.514732,1463.249282,42.27,44.686,47.949,50.654,53.559,56.155,58.766,59.339,59.285,54.407,50.992,54.11,6464046,7454779,8678557,10191512,12044785,14500404,17661452,21198082,25020539,28263827,31386842,35610177 +"Africa","Lesotho",298.8462121,335.9971151,411.8006266,498.6390265,496.5815922,745.3695408,797.2631074,773.9932141,977.4862725,1186.147994,1275.184575,1569.331442,42.138,45.047,47.747,48.492,49.767,52.208,55.078,57.18,59.685,55.558,44.593,42.592,748747,813338,893143,996380,1116779,1251524,1411807,1599200,1803195,1982823,2046772,2012649 +"Africa","Liberia",575.5729961,620.9699901,634.1951625,713.6036483,803.0054535,640.3224383,572.1995694,506.1138573,636.6229191,609.1739508,531.4823679,414.5073415,38.48,39.486,40.502,41.536,42.614,43.764,44.852,46.027,40.802,42.221,43.753,45.678,863308,975950,1112796,1279406,1482628,1703617,1956875,2269414,1912974,2200725,2814651,3193942 +"Africa","Libya",2387.54806,3448.284395,6757.030816,18772.75169,21011.49721,21951.21176,17364.27538,11770.5898,9640.138501,9467.446056,9534.677467,12057.49928,42.723,45.289,47.808,50.227,52.773,57.442,62.155,66.234,68.755,71.555,72.737,73.952,1019729,1201578,1441863,1759224,2183877,2721783,3344074,3799845,4364501,4759670,5368585,6036914 +"Africa","Madagascar",1443.011715,1589.20275,1643.38711,1634.047282,1748.562982,1544.228586,1302.878658,1155.441948,1040.67619,986.2958956,894.6370822,1044.770126,36.681,38.865,40.848,42.881,44.851,46.881,48.969,49.35,52.214,54.978,57.286,59.443,4762912,5181679,5703324,6334556,7082430,8007166,9171477,10568642,12210395,14165114,16473477,19167654 +"Africa","Malawi",369.1650802,416.3698064,427.9010856,495.5147806,584.6219709,663.2236766,632.8039209,635.5173634,563.2000145,692.2758103,665.4231186,759.3499101,36.256,37.207,38.41,39.487,41.766,43.767,45.642,47.457,49.42,47.495,45.009,48.303,2917802,3221238,3628608,4147252,4730997,5637246,6502825,7824747,10014249,10419991,11824495,13327079 +"Africa","Mali",452.3369807,490.3821867,496.1743428,545.0098873,581.3688761,686.3952693,618.0140641,684.1715576,739.014375,790.2579846,951.4097518,1042.581557,33.685,35.307,36.936,38.487,39.977,41.714,43.916,46.364,48.388,49.903,51.818,54.467,3838168,4241884,4690372,5212416,5828158,6491649,6998256,7634008,8416215,9384984,10580176,12031795 +"Africa","Mauritania",743.1159097,846.1202613,1055.896036,1421.145193,1586.851781,1497.492223,1481.150189,1421.603576,1361.369784,1483.136136,1579.019543,1803.151496,40.543,42.338,44.248,46.289,48.437,50.852,53.599,56.145,58.333,60.43,62.247,64.164,1022556,1076852,1146757,1230542,1332786,1456688,1622136,1841240,2119465,2444741,2828858,3270065 +"Africa","Mauritius",1967.955707,2034.037981,2529.067487,2475.387562,2575.484158,3710.982963,3688.037739,4783.586903,6058.253846,7425.705295,9021.815894,10956.99112,50.986,58.089,60.246,61.557,62.944,64.93,66.711,68.74,69.745,70.736,71.954,72.801,516556,609816,701016,789309,851334,913025,992040,1042663,1096202,1149818,1200206,1250882 +"Africa","Morocco",1688.20357,1642.002314,1566.353493,1711.04477,1930.194975,2370.619976,2702.620356,2755.046991,2948.047252,2982.101858,3258.495584,3820.17523,42.873,45.423,47.924,50.335,52.862,55.73,59.65,62.677,65.393,67.66,69.615,71.164,9939217,11406350,13056604,14770296,16660670,18396941,20198730,22987397,25798239,28529501,31167783,33757175 +"Africa","Mozambique",468.5260381,495.5868333,556.6863539,566.6691539,724.9178037,502.3197334,462.2114149,389.8761846,410.8968239,472.3460771,633.6179466,823.6856205,31.286,33.779,36.161,38.113,40.328,42.495,42.795,42.861,44.284,46.344,44.026,42.082,6446316,7038035,7788944,8680909,9809596,11127868,12587223,12891952,13160731,16603334,18473780,19951656 +"Africa","Namibia",2423.780443,2621.448058,3173.215595,3793.694753,3746.080948,3876.485958,4191.100511,3693.731337,3804.537999,3899.52426,4072.324751,4811.060429,41.725,45.226,48.386,51.159,53.867,56.437,58.968,60.835,61.999,58.909,51.479,52.906,485831,548080,621392,706640,821782,977026,1099010,1278184,1554253,1774766,1972153,2055080 +"Africa","Niger",761.879376,835.5234025,997.7661127,1054.384891,954.2092363,808.8970728,909.7221354,668.3000228,581.182725,580.3052092,601.0745012,619.6768924,37.444,38.598,39.487,40.118,40.546,41.291,42.598,44.555,47.391,51.313,54.496,56.867,3379468,3692184,4076008,4534062,5060262,5682086,6437188,7332638,8392818,9666252,11140655,12894865 +"Africa","Nigeria",1077.281856,1100.592563,1150.927478,1014.514104,1698.388838,1981.951806,1576.97375,1385.029563,1619.848217,1624.941275,1615.286395,2013.977305,36.324,37.802,39.36,41.04,42.821,44.514,45.826,46.886,47.472,47.464,46.608,46.859,33119096,37173340,41871351,47287752,53740085,62209173,73039376,81551520,93364244,106207839,119901274,135031164 +"Africa","Reunion",2718.885295,2769.451844,3173.72334,4021.175739,5047.658563,4319.804067,5267.219353,5303.377488,6101.255823,6071.941411,6316.1652,7670.122558,52.724,55.09,57.666,60.542,64.274,67.064,69.885,71.913,73.615,74.772,75.744,76.442,257700,308700,358900,414024,461633,492095,517810,562035,622191,684810,743981,798094 +"Africa","Rwanda",493.3238752,540.2893983,597.4730727,510.9637142,590.5806638,670.0806011,881.5706467,847.991217,737.0685949,589.9445051,785.6537648,863.0884639,40,41.5,43,44.1,44.6,45,46.218,44.02,23.599,36.087,43.413,46.242,2534927,2822082,3051242,3451079,3992121,4657072,5507565,6349365,7290203,7212583,7852401,8860588 +"Africa","Sao Tome and Principe",879.5835855,860.7369026,1071.551119,1384.840593,1532.985254,1737.561657,1890.218117,1516.525457,1428.777814,1339.076036,1353.09239,1598.435089,46.471,48.945,51.893,54.425,56.48,58.55,60.351,61.728,62.742,63.306,64.337,65.528,60011,61325,65345,70787,76595,86796,98593,110812,125911,145608,170372,199579 +"Africa","Senegal",1450.356983,1567.653006,1654.988723,1612.404632,1597.712056,1561.769116,1518.479984,1441.72072,1367.899369,1392.368347,1519.635262,1712.472136,37.278,39.329,41.454,43.563,45.815,48.879,52.379,55.769,58.196,60.187,61.6,63.062,2755589,3054547,3430243,3965841,4588696,5260855,6147783,7171347,8307920,9535314,10870037,12267493 +"Africa","Sierra Leone",879.7877358,1004.484437,1116.639877,1206.043465,1353.759762,1348.285159,1465.010784,1294.447788,1068.696278,574.6481576,699.489713,862.5407561,30.331,31.57,32.767,34.113,35.4,36.788,38.445,40.006,38.333,39.897,41.012,42.568,2143249,2295678,2467895,2662190,2879013,3140897,3464522,3868905,4260884,4578212,5359092,6144562 +"Africa","Somalia",1135.749842,1258.147413,1369.488336,1284.73318,1254.576127,1450.992513,1176.807031,1093.244963,926.9602964,930.5964284,882.0818218,926.1410683,32.978,34.977,36.981,38.977,40.973,41.974,42.955,44.501,39.658,43.795,45.936,48.159,2526994,2780415,3080153,3428839,3840161,4353666,5828892,6921858,6099799,6633514,7753310,9118773 +"Africa","South Africa",4725.295531,5487.104219,5768.729717,7114.477971,7765.962636,8028.651439,8568.266228,7825.823398,7225.069258,7479.188244,7710.946444,9269.657808,45.009,47.985,49.951,51.927,53.696,55.527,58.161,60.834,61.888,60.236,53.365,49.339,14264935,16151549,18356657,20997321,23935810,27129932,31140029,35933379,39964159,42835005,44433622,43997828 +"Africa","Sudan",1615.991129,1770.337074,1959.593767,1687.997641,1659.652775,2202.988423,1895.544073,1507.819159,1492.197043,1632.210764,1993.398314,2602.394995,38.635,39.624,40.87,42.858,45.083,47.8,50.338,51.744,53.556,55.373,56.369,58.556,8504667,9753392,11183227,12716129,14597019,17104986,20367053,24725960,28227588,32160729,37090298,42292929 +"Africa","Swaziland",1148.376626,1244.708364,1856.182125,2613.101665,3364.836625,3781.410618,3895.384018,3984.839812,3553.0224,3876.76846,4128.116943,4513.480643,41.407,43.424,44.992,46.633,49.552,52.537,55.561,57.678,58.474,54.289,43.869,39.613,290243,326741,370006,420690,480105,551425,649901,779348,962344,1054486,1130269,1133066 +"Africa","Tanzania",716.6500721,698.5356073,722.0038073,848.2186575,915.9850592,962.4922932,874.2426069,831.8220794,825.682454,789.1862231,899.0742111,1107.482182,41.215,42.974,44.246,45.757,47.62,49.919,50.608,51.535,50.44,48.466,49.651,52.517,8322925,9452826,10863958,12607312,14706593,17129565,19844382,23040630,26605473,30686889,34593779,38139640 +"Africa","Togo",859.8086567,925.9083202,1067.53481,1477.59676,1649.660188,1532.776998,1344.577953,1202.201361,1034.298904,982.2869243,886.2205765,882.9699438,38.596,41.208,43.922,46.769,49.759,52.887,55.471,56.941,58.061,58.39,57.561,58.42,1219113,1357445,1528098,1735550,2056351,2308582,2644765,3154264,3747553,4320890,4977378,5701579 +"Africa","Tunisia",1468.475631,1395.232468,1660.30321,1932.360167,2753.285994,3120.876811,3560.233174,3810.419296,4332.720164,4876.798614,5722.895655,7092.923025,44.6,47.1,49.579,52.053,55.602,59.837,64.048,66.894,70.001,71.973,73.042,73.923,3647735,3950849,4286552,4786986,5303507,6005061,6734098,7724976,8523077,9231669,9770575,10276158 +"Africa","Uganda",734.753484,774.3710692,767.2717398,908.9185217,950.735869,843.7331372,682.2662268,617.7244065,644.1707969,816.559081,927.7210018,1056.380121,39.978,42.571,45.344,48.051,51.016,50.35,49.849,51.509,48.825,44.578,47.813,51.542,5824797,6675501,7688797,8900294,10190285,11457758,12939400,15283050,18252190,21210254,24739869,29170398 +"Africa","Zambia",1147.388831,1311.956766,1452.725766,1777.077318,1773.498265,1588.688299,1408.678565,1213.315116,1210.884633,1071.353818,1071.613938,1271.211593,42.038,44.077,46.023,47.768,50.107,51.386,51.821,50.821,46.1,40.238,39.193,42.384,2672000,3016000,3421000,3900000,4506497,5216550,6100407,7272406,8381163,9417789,10595811,11746035 +"Africa","Zimbabwe",406.8841148,518.7642681,527.2721818,569.7950712,799.3621758,685.5876821,788.8550411,706.1573059,693.4207856,792.4499603,672.0386227,469.7092981,48.451,50.469,52.358,53.995,55.635,57.674,60.363,62.351,60.377,46.809,39.989,43.487,3080907,3646340,4277736,4995432,5861135,6642107,7636524,9216418,10704340,11404948,11926563,12311143 +"Americas","Argentina",5911.315053,6856.856212,7133.166023,8052.953021,9443.038526,10079.02674,8997.897412,9139.671389,9308.41871,10967.28195,8797.640716,12779.37964,62.485,64.399,65.142,65.634,67.065,68.481,69.942,70.774,71.868,73.275,74.34,75.32,17876956,19610538,21283783,22934225,24779799,26983828,29341374,31620918,33958947,36203463,38331121,40301927 +"Americas","Bolivia",2677.326347,2127.686326,2180.972546,2586.886053,2980.331339,3548.097832,3156.510452,2753.69149,2961.699694,3326.143191,3413.26269,3822.137084,40.414,41.89,43.428,45.032,46.714,50.023,53.859,57.251,59.957,62.05,63.883,65.554,2883315,3211738,3593918,4040665,4565872,5079716,5642224,6156369,6893451,7693188,8445134,9119152 +"Americas","Brazil",2108.944355,2487.365989,3336.585802,3429.864357,4985.711467,6660.118654,7030.835878,7807.095818,6950.283021,7957.980824,8131.212843,9065.800825,50.917,53.285,55.665,57.632,59.504,61.489,63.336,65.205,67.057,69.388,71.006,72.39,56602560,65551171,76039390,88049823,100840058,114313951,128962939,142938076,155975974,168546719,179914212,190010647 +"Americas","Canada",11367.16112,12489.95006,13462.48555,16076.58803,18970.57086,22090.88306,22898.79214,26626.51503,26342.88426,28954.92589,33328.96507,36319.23501,68.75,69.96,71.3,72.13,72.88,74.21,75.76,76.86,77.95,78.61,79.77,80.653,14785584,17010154,18985849,20819767,22284500,23796400,25201900,26549700,28523502,30305843,31902268,33390141 +"Americas","Chile",3939.978789,4315.622723,4519.094331,5106.654313,5494.024437,4756.763836,5095.665738,5547.063754,7596.125964,10118.05318,10778.78385,13171.63885,54.745,56.074,57.924,60.523,63.441,67.052,70.565,72.492,74.126,75.816,77.86,78.553,6377619,7048426,7961258,8858908,9717524,10599793,11487112,12463354,13572994,14599929,15497046,16284741 +"Americas","Colombia",2144.115096,2323.805581,2492.351109,2678.729839,3264.660041,3815.80787,4397.575659,4903.2191,5444.648617,6117.361746,5755.259962,7006.580419,50.643,55.118,57.863,59.963,61.623,63.837,66.653,67.768,68.421,70.313,71.682,72.889,12350771,14485993,17009885,19764027,22542890,25094412,27764644,30964245,34202721,37657830,41008227,44227550 +"Americas","Costa Rica",2627.009471,2990.010802,3460.937025,4161.727834,5118.146939,5926.876967,5262.734751,5629.915318,6160.416317,6677.045314,7723.447195,9645.06142,57.206,60.026,62.842,65.424,67.849,70.75,73.45,74.752,75.713,77.26,78.123,78.782,926317,1112300,1345187,1588717,1834796,2108457,2424367,2799811,3173216,3518107,3834934,4133884 +"Americas","Cuba",5586.53878,6092.174359,5180.75591,5690.268015,5305.445256,6380.494966,7316.918107,7532.924763,5592.843963,5431.990415,6340.646683,8948.102923,59.421,62.325,65.246,68.29,70.723,72.649,73.717,74.174,74.414,76.151,77.158,78.273,6007797,6640752,7254373,8139332,8831348,9537988,9789224,10239839,10723260,10983007,11226999,11416987 +"Americas","Dominican Republic",1397.717137,1544.402995,1662.137359,1653.723003,2189.874499,2681.9889,2861.092386,2899.842175,3044.214214,3614.101285,4563.808154,6025.374752,45.928,49.828,53.459,56.751,59.631,61.788,63.727,66.046,68.457,69.957,70.847,72.235,2491346,2923186,3453434,4049146,4671329,5302800,5968349,6655297,7351181,7992357,8650322,9319622 +"Americas","Ecuador",3522.110717,3780.546651,4086.114078,4579.074215,5280.99471,6679.62326,7213.791267,6481.776993,7103.702595,7429.455877,5773.044512,6873.262326,48.357,51.356,54.64,56.678,58.796,61.31,64.342,67.231,69.613,72.312,74.173,74.994,3548753,4058385,4681707,5432424,6298651,7278866,8365850,9545158,10748394,11911819,12921234,13755680 +"Americas","El Salvador",3048.3029,3421.523218,3776.803627,4358.595393,4520.246008,5138.922374,4098.344175,4140.442097,4444.2317,5154.825496,5351.568666,5728.353514,45.262,48.57,52.307,55.855,58.207,56.696,56.604,63.154,66.798,69.535,70.734,71.878,2042865,2355805,2747687,3232927,3790903,4282586,4474873,4842194,5274649,5783439,6353681,6939688 +"Americas","Guatemala",2428.237769,2617.155967,2750.364446,3242.531147,4031.408271,4879.992748,4820.49479,4246.485974,4439.45084,4684.313807,4858.347495,5186.050003,42.023,44.142,46.954,50.016,53.738,56.029,58.137,60.782,63.373,66.322,68.978,70.259,3146381,3640876,4208858,4690773,5149581,5703430,6395630,7326406,8486949,9803875,11178650,12572928 +"Americas","Haiti",1840.366939,1726.887882,1796.589032,1452.057666,1654.456946,1874.298931,2011.159549,1823.015995,1456.309517,1341.726931,1270.364932,1201.637154,37.579,40.696,43.59,46.243,48.042,49.923,51.461,53.636,55.089,56.671,58.137,60.916,3201488,3507701,3880130,4318137,4698301,4908554,5198399,5756203,6326682,6913545,7607651,8502814 +"Americas","Honduras",2194.926204,2220.487682,2291.156835,2538.269358,2529.842345,3203.208066,3121.760794,3023.096699,3081.694603,3160.454906,3099.72866,3548.330846,41.912,44.665,48.041,50.924,53.884,57.402,60.909,64.492,66.399,67.659,68.565,70.198,1517453,1770390,2090162,2500689,2965146,3055235,3669448,4372203,5077347,5867957,6677328,7483763 +"Americas","Jamaica",2898.530881,4756.525781,5246.107524,6124.703451,7433.889293,6650.195573,6068.05135,6351.237495,7404.923685,7121.924704,6994.774861,7320.880262,58.53,62.61,65.61,67.51,69,70.11,71.21,71.77,71.766,72.262,72.047,72.567,1426095,1535090,1665128,1861096,1997616,2156814,2298309,2326606,2378618,2531311,2664659,2780132 +"Americas","Mexico",3478.125529,4131.546641,4581.609385,5754.733883,6809.40669,7674.929108,9611.147541,8688.156003,9472.384295,9767.29753,10742.44053,11977.57496,50.789,55.19,58.299,60.11,62.361,65.032,67.405,69.498,71.455,73.67,74.902,76.195,30144317,35015548,41121485,47995559,55984294,63759976,71640904,80122492,88111030,95895146,102479927,108700891 +"Americas","Nicaragua",3112.363948,3457.415947,3634.364406,4643.393534,4688.593267,5486.371089,3470.338156,2955.984375,2170.151724,2253.023004,2474.548819,2749.320965,42.314,45.432,48.632,51.884,55.151,57.47,59.298,62.008,65.843,68.426,70.836,72.899,1165790,1358828,1590597,1865490,2182908,2554598,2979423,3344353,4017939,4609572,5146848,5675356 +"Americas","Panama",2480.380334,2961.800905,3536.540301,4421.009084,5364.249663,5351.912144,7009.601598,7034.779161,6618.74305,7113.692252,7356.031934,9809.185636,55.191,59.201,61.817,64.071,66.216,68.681,70.472,71.523,72.462,73.738,74.712,75.537,940080,1063506,1215725,1405486,1616384,1839782,2036305,2253639,2484997,2734531,2990875,3242173 +"Americas","Paraguay",1952.308701,2046.154706,2148.027146,2299.376311,2523.337977,3248.373311,4258.503604,3998.875695,4196.411078,4247.400261,3783.674243,4172.838464,62.649,63.196,64.361,64.951,65.815,66.353,66.874,67.378,68.225,69.4,70.755,71.752,1555876,1770902,2009813,2287985,2614104,2984494,3366439,3886512,4483945,5154123,5884491,6667147 +"Americas","Peru",3758.523437,4245.256698,4957.037982,5788.09333,5937.827283,6281.290855,6434.501797,6360.943444,4446.380924,5838.347657,5909.020073,7408.905561,43.902,46.263,49.096,51.445,55.448,58.447,61.406,64.134,66.458,68.386,69.906,71.421,8025700,9146100,10516500,12132200,13954700,15990099,18125129,20195924,22430449,24748122,26769436,28674757 +"Americas","Puerto Rico",3081.959785,3907.156189,5108.34463,6929.277714,9123.041742,9770.524921,10330.98915,12281.34191,14641.58711,16999.4333,18855.60618,19328.70901,64.28,68.54,69.62,71.1,72.16,73.44,73.75,74.63,73.911,74.917,77.778,78.746,2227000,2260000,2448046,2648961,2847132,3080828,3279001,3444468,3585176,3759430,3859606,3942491 +"Americas","Trinidad and Tobago",3023.271928,4100.3934,4997.523971,5621.368472,6619.551419,7899.554209,9119.528607,7388.597823,7370.990932,8792.573126,11460.60023,18008.50924,59.1,61.8,64.9,65.4,65.9,68.3,68.832,69.582,69.862,69.465,68.976,69.819,662850,764900,887498,960155,975199,1039009,1116479,1191336,1183669,1138101,1101832,1056608 +"Americas","United States",13990.48208,14847.12712,16173.14586,19530.36557,21806.03594,24072.63213,25009.55914,29884.35041,32003.93224,35767.43303,39097.09955,42951.65309,68.44,69.49,70.21,70.76,71.34,73.38,74.65,75.02,76.09,76.81,77.31,78.242,157553000,171984000,186538000,198712000,209896000,220239000,232187835,242803533,256894189,272911760,287675526,301139947 +"Americas","Uruguay",5716.766744,6150.772969,5603.357717,5444.61962,5703.408898,6504.339663,6920.223051,7452.398969,8137.004775,9230.240708,7727.002004,10611.46299,66.071,67.044,68.253,68.468,68.673,69.481,70.805,71.918,72.752,74.223,75.307,76.384,2252965,2424959,2598466,2748579,2829526,2873520,2953997,3045153,3149262,3262838,3363085,3447496 +"Americas","Venezuela",7689.799761,9802.466526,8422.974165,9541.474188,10505.25966,13143.95095,11152.41011,9883.584648,10733.92631,10165.49518,8605.047831,11415.80569,55.088,57.907,60.77,63.479,65.712,67.456,68.557,70.19,71.15,72.146,72.766,73.747,5439568,6702668,8143375,9709552,11515649,13503563,15620766,17910182,20265563,22374398,24287670,26084662 +"Asia","Afghanistan",779.4453145,820.8530296,853.10071,836.1971382,739.9811058,786.11336,978.0114388,852.3959448,649.3413952,635.341351,726.7340548,974.5803384,28.801,30.332,31.997,34.02,36.088,38.438,39.854,40.822,41.674,41.763,42.129,43.828,8425333,9240934,10267083,11537966,13079460,14880372,12881816,13867957,16317921,22227415,25268405,31889923 +"Asia","Bahrain",9867.084765,11635.79945,12753.27514,14804.6727,18268.65839,19340.10196,19211.14731,18524.02406,19035.57917,20292.01679,23403.55927,29796.04834,50.939,53.832,56.923,59.923,63.3,65.593,69.052,70.75,72.601,73.925,74.795,75.635,120447,138655,171863,202182,230800,297410,377967,454612,529491,598561,656397,708573 +"Asia","Bangladesh",684.2441716,661.6374577,686.3415538,721.1860862,630.2336265,659.8772322,676.9818656,751.9794035,837.8101643,972.7700352,1136.39043,1391.253792,37.484,39.348,41.216,43.453,45.252,46.923,50.009,52.819,56.018,59.412,62.013,64.062,46886859,51365468,56839289,62821884,70759295,80428306,93074406,103764241,113704579,123315288,135656790,150448339 +"Asia","Cambodia",368.4692856,434.0383364,496.9136476,523.4323142,421.6240257,524.9721832,624.4754784,683.8955732,682.3031755,734.28517,896.2260153,1713.778686,39.417,41.366,43.415,45.415,40.317,31.22,50.957,53.914,55.803,56.534,56.752,59.723,4693836,5322536,6083619,6960067,7450606,6978607,7272485,8371791,10150094,11782962,12926707,14131858 +"Asia","China",400.448610699994,575.9870009,487.6740183,612.7056934,676.9000921,741.2374699,962.4213805,1378.904018,1655.784158,2289.234136,3119.280896,4959.114854,44,50.54896,44.50136,58.38112,63.11888,63.96736,65.525,67.274,68.69,70.426,72.028,72.961,556263527.999989,637408000,665770000,754550000,862030000,943455000,1000281000,1084035000,1164970000,1230075000,1280400000,1318683096 +"Asia","Hong Kong China",3054.421209,3629.076457,4692.648272,6197.962814,8315.928145,11186.14125,14560.53051,20038.47269,24757.60301,28377.63219,30209.01516,39724.97867,60.96,64.75,67.65,70,72,73.6,75.45,76.2,77.601,80,81.495,82.208,2125900,2736300,3305200,3722800,4115700,4583700,5264500,5584510,5829696,6495918,6762476,6980412 +"Asia","India",546.5657493,590.061996,658.3471509,700.7706107,724.032527,813.337323,855.7235377,976.5126756,1164.406809,1458.817442,1746.769454,2452.210407,37.373,40.249,43.605,47.193,50.651,54.208,56.596,58.553,60.223,61.765,62.879,64.698,3.72e+08,4.09e+08,4.54e+08,5.06e+08,5.67e+08,6.34e+08,7.08e+08,7.88e+08,8.72e+08,9.59e+08,1034172547,1110396331 +"Asia","Indonesia",749.6816546,858.9002707,849.2897701,762.4317721,1111.107907,1382.702056,1516.872988,1748.356961,2383.140898,3119.335603,2873.91287,3540.651564,37.468,39.918,42.518,45.964,49.203,52.702,56.159,60.137,62.681,66.041,68.588,70.65,82052000,90124000,99028000,109343000,121282000,136725000,153343000,169276000,184816000,199278000,211060000,223547000 +"Asia","Iran",3035.326002,3290.257643,4187.329802,5906.731805,9613.818607,11888.59508,7608.334602,6642.881371,7235.653188,8263.590301,9240.761975,11605.71449,44.869,47.181,49.325,52.469,55.234,57.702,59.62,63.04,65.742,68.042,69.451,70.964,17272000,19792000,22874000,26538000,30614000,35480679,43072751,51889696,60397973,63327987,66907826,69453570 +"Asia","Iraq",4129.766056,6229.333562,8341.737815,8931.459811,9576.037596,14688.23507,14517.90711,11643.57268,3745.640687,3076.239795,4390.717312,4471.061906,45.32,48.437,51.457,54.459,56.95,60.413,62.038,65.044,59.461,58.811,57.046,59.545,5441766,6248643,7240260,8519282,10061506,11882916,14173318,16543189,17861905,20775703,24001816,27499638 +"Asia","Israel",4086.522128,5385.278451,7105.630706,8393.741404,12786.93223,13306.61921,15367.0292,17122.47986,18051.52254,20896.60924,21905.59514,25523.2771,65.39,67.84,69.39,70.75,71.63,73.06,74.45,75.6,76.93,78.269,79.696,80.745,1620914,1944401,2310904,2693585,3095893,3495918,3858421,4203148,4936550,5531387,6029529,6426679 +"Asia","Japan",3216.956347,4317.694365,6576.649461,9847.788607,14778.78636,16610.37701,19384.10571,22375.94189,26824.89511,28816.58499,28604.5919,31656.06806,63.03,65.5,68.73,71.43,73.42,75.38,77.11,78.67,79.36,80.69,82,82.603,86459025,91563009,95831757,100825279,107188273,113872473,118454974,122091325,124329269,125956499,127065841,127467972 +"Asia","Jordan",1546.907807,1886.080591,2348.009158,2741.796252,2110.856309,2852.351568,4161.415959,4448.679912,3431.593647,3645.379572,3844.917194,4519.461171,43.158,45.669,48.126,51.629,56.528,61.134,63.739,65.869,68.015,69.772,71.263,72.535,607914,746559,933559,1255058,1613551,1937652,2347031,2820042,3867409,4526235,5307470,6053193 +"Asia","Korea Dem. Rep.",1088.277758,1571.134655,1621.693598,2143.540609,3701.621503,4106.301249,4106.525293,4106.492315,3726.063507,1690.756814,1646.758151,1593.06548,50.056,54.081,56.656,59.942,63.983,67.159,69.1,70.647,69.978,67.727,66.662,67.297,8865488,9411381,10917494,12617009,14781241,16325320,17647518,19067554,20711375,21585105,22215365,23301725 +"Asia","Korea Rep.",1030.592226,1487.593537,1536.344387,2029.228142,3030.87665,4657.22102,5622.942464,8533.088805,12104.27872,15993.52796,19233.98818,23348.13973,47.453,52.681,55.292,57.716,62.612,64.766,67.123,69.81,72.244,74.647,77.045,78.623,20947571,22611552,26420307,30131000,33505000,36436000,39326000,41622000,43805450,46173816,47969150,49044790 +"Asia","Kuwait",108382.3529,113523.1329,95458.11176,80894.88326,109347.867,59265.47714,31354.03573,28118.42998,34932.91959,40300.61996,35110.10566,47306.98978,55.565,58.033,60.47,64.624,67.712,69.343,71.309,74.174,75.19,76.156,76.904,77.588,160000,212846,358266,575003,841934,1140357,1497494,1891487,1418095,1765345,2111561,2505559 +"Asia","Lebanon",4834.804067,6089.786934,5714.560611,6006.983042,7486.384341,8659.696836,7640.519521,5377.091329,6890.806854,8754.96385,9313.93883,10461.05868,55.928,59.489,62.094,63.87,65.421,66.099,66.983,67.926,69.292,70.265,71.028,71.993,1439529,1647412,1886848,2186894,2680018,3115787,3086876,3089353,3219994,3430388,3677780,3921278 +"Asia","Malaysia",1831.132894,1810.066992,2036.884944,2277.742396,2849.09478,3827.921571,4920.355951,5249.802653,7277.912802,10132.90964,10206.97794,12451.6558,48.463,52.102,55.737,59.371,63.01,65.256,68,69.5,70.693,71.938,73.044,74.241,6748378,7739235,8906385,10154878,11441462,12845381,14441916,16331785,18319502,20476091,22662365,24821286 +"Asia","Mongolia",786.5668575,912.6626085,1056.353958,1226.04113,1421.741975,1647.511665,2000.603139,2338.008304,1785.402016,1902.2521,2140.739323,3095.772271,42.244,45.248,48.251,51.253,53.754,55.491,57.489,60.222,61.271,63.625,65.033,66.803,800663,882134,1010280,1149500,1320500,1528000,1756032,2015133,2312802,2494803,2674234,2874127 +"Asia","Myanmar",331,350,388,349,357,371,424,385,347,415,611,944,36.319,41.905,45.108,49.379,53.07,56.059,58.056,58.339,59.32,60.328,59.908,62.069,20092996,21731844,23634436,25870271,28466390,31528087,34680442,38028578,40546538,43247867,45598081,47761980 +"Asia","Nepal",545.8657229,597.9363558,652.3968593,676.4422254,674.7881296,694.1124398,718.3730947,775.6324501,897.7403604,1010.892138,1057.206311,1091.359778,36.157,37.686,39.393,41.472,43.971,46.748,49.594,52.537,55.727,59.426,61.34,63.785,9182536,9682338,10332057,11261690,12412593,13933198,15796314,17917180,20326209,23001113,25873917,28901790 +"Asia","Oman",1828.230307,2242.746551,2924.638113,4720.942687,10618.03855,11848.34392,12954.79101,18115.22313,18616.70691,19702.05581,19774.83687,22316.19287,37.578,40.08,43.165,46.988,52.143,57.367,62.728,67.734,71.197,72.499,74.193,75.64,507833,561977,628164,714775,829050,1004533,1301048,1593882,1915208,2283635,2713462,3204897 +"Asia","Pakistan",684.5971438,747.0835292,803.3427418,942.4082588,1049.938981,1175.921193,1443.429832,1704.686583,1971.829464,2049.350521,2092.712441,2605.94758,43.436,45.557,47.67,49.8,51.929,54.043,56.158,58.245,60.838,61.818,63.61,65.483,41346560,46679944,53100671,60641899,69325921,78152686,91462088,105186881,120065004,135564834,153403524,169270617 +"Asia","Philippines",1272.880995,1547.944844,1649.552153,1814.12743,1989.37407,2373.204287,2603.273765,2189.634995,2279.324017,2536.534925,2650.921068,3190.481016,47.752,51.334,54.757,56.393,58.065,60.06,62.082,64.151,66.458,68.564,70.303,71.688,22438691,26072194,30325264,35356600,40850141,46850962,53456774,60017788,67185766,75012988,82995088,91077287 +"Asia","Saudi Arabia",6459.554823,8157.591248,11626.41975,16903.04886,24837.42865,34167.7626,33693.17525,21198.26136,24841.61777,20586.69019,19014.54118,21654.83194,39.875,42.868,45.914,49.901,53.886,58.69,63.012,66.295,68.768,70.533,71.626,72.777,4005677,4419650,4943029,5618198,6472756,8128505,11254672,14619745,16945857,21229759,24501530,27601038 +"Asia","Singapore",2315.138227,2843.104409,3674.735572,4977.41854,8597.756202,11210.08948,15169.16112,18861.53081,24769.8912,33519.4766,36023.1054,47143.17964,60.396,63.179,65.798,67.946,69.521,70.795,71.76,73.56,75.788,77.158,78.77,79.972,1127000,1445929,1750200,1977600,2152400,2325300,2651869,2794552,3235865,3802309,4197776,4553009 +"Asia","Sri Lanka",1083.53203,1072.546602,1074.47196,1135.514326,1213.39553,1348.775651,1648.079789,1876.766827,2153.739222,2664.477257,3015.378833,3970.095407,57.593,61.456,62.192,64.266,65.042,65.949,68.757,69.011,70.379,70.457,70.815,72.396,7982342,9128546,10421936,11737396,13016733,14116836,15410151,16495304,17587060,18698655,19576783,20378239 +"Asia","Syria",1643.485354,2117.234893,2193.037133,1881.923632,2571.423014,3195.484582,3761.837715,3116.774285,3340.542768,4014.238972,4090.925331,4184.548089,45.883,48.284,50.305,53.655,57.296,61.195,64.59,66.974,69.249,71.527,73.053,74.143,3661549,4149908,4834621,5680812,6701172,7932503,9410494,11242847,13219062,15081016,17155814,19314747 +"Asia","Taiwan",1206.947913,1507.86129,1822.879028,2643.858681,4062.523897,5596.519826,7426.354774,11054.56175,15215.6579,20206.82098,23235.42329,28718.27684,58.5,62.4,65.2,67.5,69.39,70.59,72.16,73.4,74.26,75.25,76.99,78.4,8550362,10164215,11918938,13648692,15226039,16785196,18501390,19757799,20686918,21628605,22454239,23174294 +"Asia","Thailand",757.7974177,793.5774148,1002.199172,1295.46066,1524.358936,1961.224635,2393.219781,2982.653773,4616.896545,5852.625497,5913.187529,7458.396327,50.848,53.63,56.061,58.285,60.405,62.494,64.597,66.084,67.298,67.521,68.564,70.616,21289402,25041917,29263397,34024249,39276153,44148285,48827160,52910342,56667095,60216677,62806748,65068149 +"Asia","Vietnam",605.0664917,676.2854478,772.0491602,637.1232887,699.5016441,713.5371196,707.2357863,820.7994449,989.0231487,1385.896769,1764.456677,2441.576404,40.412,42.887,45.363,47.838,50.254,55.764,58.816,62.82,67.662,70.672,73.017,74.249,26246839,28998543,33796140,39463910,44655014,50533506,56142181,62826491,69940728,76048996,80908147,85262356 +"Asia","West Bank and Gaza",1515.592329,1827.067742,2198.956312,2649.715007,3133.409277,3682.831494,4336.032082,5107.197384,6017.654756,7110.667619,4515.487575,3025.349798,43.16,45.671,48.127,51.631,56.532,60.765,64.406,67.046,69.718,71.096,72.37,73.422,1030585,1070439,1133134,1142636,1089572,1261091,1425876,1691210,2104779,2826046,3389578,4018332 +"Asia","Yemen Rep.",781.7175761,804.8304547,825.6232006,862.4421463,1265.047031,1829.765177,1977.55701,1971.741538,1879.496673,2117.484526,2234.820827,2280.769906,32.548,33.97,35.18,36.984,39.848,44.175,49.113,52.922,55.599,58.02,60.308,62.698,4963829,5498090,6120081,6740785,7407075,8403990,9657618,11219340,13367997,15826497,18701257,22211743 +"Europe","Albania",1601.056136,1942.284244,2312.888958,2760.196931,3313.422188,3533.00391,3630.880722,3738.932735,2497.437901,3193.054604,4604.211737,5937.029526,55.23,59.28,64.82,66.22,67.69,68.93,70.42,72,71.581,72.95,75.651,76.423,1282697,1476505,1728137,1984060,2263554,2509048,2780097,3075321,3326498,3428038,3508512,3600523 +"Europe","Austria",6137.076492,8842.59803,10750.72111,12834.6024,16661.6256,19749.4223,21597.08362,23687.82607,27042.01868,29095.92066,32417.60769,36126.4927,66.8,67.48,69.54,70.14,70.63,72.17,73.18,74.94,76.04,77.51,78.98,79.829,6927772,6965860,7129864,7376998,7544201,7568430,7574613,7578903,7914969,8069876,8148312,8199783 +"Europe","Belgium",8343.105127,9714.960623,10991.20676,13149.04119,16672.14356,19117.97448,20979.84589,22525.56308,25575.57069,27561.19663,30485.88375,33692.60508,68,69.24,70.25,70.94,71.44,72.8,73.93,75.35,76.46,77.53,78.32,79.441,8730405,8989111,9218400,9556500,9709100,9821800,9856303,9870200,10045622,10199787,10311970,10392226 +"Europe","Bosnia and Herzegovina",973.5331948,1353.989176,1709.683679,2172.352423,2860.16975,3528.481305,4126.613157,4314.114757,2546.781445,4766.355904,6018.975239,7446.298803,53.82,58.45,61.93,64.79,67.45,69.86,70.69,71.14,72.178,73.244,74.09,74.852,2791000,3076000,3349000,3585000,3819000,4086000,4172693,4338977,4256013,3607000,4165416,4552198 +"Europe","Bulgaria",2444.286648,3008.670727,4254.337839,5577.0028,6597.494398,7612.240438,8224.191647,8239.854824,6302.623438,5970.38876,7696.777725,10680.79282,59.6,66.61,69.51,70.42,70.9,70.81,71.08,71.34,71.19,70.32,72.14,73.005,7274900,7651254,8012946,8310226,8576200,8797022,8892098,8971958,8658506,8066057,7661799,7322858 +"Europe","Croatia",3119.23652,4338.231617,5477.890018,6960.297861,9164.090127,11305.38517,13221.82184,13822.58394,8447.794873,9875.604515,11628.38895,14619.22272,61.21,64.77,67.13,68.5,69.61,70.64,70.46,71.52,72.527,73.68,74.876,75.748,3882229,3991242,4076557,4174366,4225310,4318673,4413368,4484310,4494013,4444595,4481020,4493312 +"Europe","Czech Republic",6876.14025,8256.343918,10136.86713,11399.44489,13108.4536,14800.16062,15377.22855,16310.4434,14297.02122,16048.51424,17596.21022,22833.30851,66.87,69.03,69.9,70.38,70.29,70.71,70.96,71.58,72.4,74.01,75.51,76.486,9125183,9513758,9620282,9835109,9862158,10161915,10303704,10311597,10315702,10300707,10256295,10228744 +"Europe","Denmark",9692.385245,11099.65935,13583.31351,15937.21123,18866.20721,20422.9015,21688.04048,25116.17581,26406.73985,29804.34567,32166.50006,35278.41874,70.78,71.81,72.35,72.96,73.47,74.69,74.63,74.8,75.33,76.11,77.18,78.332,4334000,4487831,4646899,4838800,4991596,5088419,5117810,5127024,5171393,5283663,5374693,5468120 +"Europe","Finland",6424.519071,7545.415386,9371.842561,10921.63626,14358.8759,15605.42283,18533.15761,21141.01223,20647.16499,23723.9502,28204.59057,33207.0844,66.55,67.49,68.75,69.83,70.87,72.52,74.55,74.83,75.7,77.13,78.37,79.313,4090500,4324000,4491443,4605744,4639657,4738902,4826933,4931729,5041039,5134406,5193039,5238460 +"Europe","France",7029.809327,8662.834898,10560.48553,12999.91766,16107.19171,18292.63514,20293.89746,22066.44214,24703.79615,25889.78487,28926.03234,30470.0167,67.41,68.93,70.51,71.55,72.38,73.83,74.89,76.34,77.46,78.64,79.59,80.657,42459667,44310863,47124000,49569000,51732000,53165019,54433565,55630100,57374179,58623428,59925035,61083916 +"Europe","Germany",7144.114393,10187.82665,12902.46291,14745.62561,18016.18027,20512.92123,22031.53274,24639.18566,26505.30317,27788.88416,30035.80198,32170.37442,67.5,69.1,70.3,70.8,71,72.5,73.8,74.847,76.07,77.34,78.67,79.406,69145952,71019069,73739117,76368453,78717088,78160773,78335266,77718298,80597764,82011073,82350671,82400996 +"Europe","Greece",3530.690067,4916.299889,6017.190733,8513.097016,12724.82957,14195.52428,15268.42089,16120.52839,17541.49634,18747.69814,22514.2548,27538.41188,65.86,67.86,69.51,71,72.34,73.68,75.24,76.67,77.03,77.869,78.256,79.483,7733250,8096218,8448233,8716441,8888628,9308479,9786480,9974490,10325429,10502372,10603863,10706290 +"Europe","Hungary",5263.673816,6040.180011,7550.359877,9326.64467,10168.65611,11674.83737,12545.99066,12986.47998,10535.62855,11712.7768,14843.93556,18008.94444,64.03,66.41,67.96,69.5,69.76,69.95,69.39,69.58,69.17,71.04,72.59,73.338,9504000,9839000,10063000,10223422,10394091,10637171,10705535,10612740,10348684,10244684,10083313,9956108 +"Europe","Iceland",7267.688428,9244.001412,10350.15906,13319.89568,15798.06362,19654.96247,23269.6075,26923.20628,25144.39201,28061.09966,31163.20196,36180.78919,72.49,73.47,73.68,73.73,74.46,76.11,76.99,77.23,78.77,78.95,80.5,81.757,147962,165110,182053,198676,209275,221823,233997,244676,259012,271192,288030,301931 +"Europe","Ireland",5210.280328,5599.077872,6631.597314,7655.568963,9530.772896,11150.98113,12618.32141,13872.86652,17558.81555,24521.94713,34077.04939,40675.99635,66.91,68.9,70.29,71.08,71.28,72.03,73.1,74.36,75.467,76.122,77.783,78.885,2952156,2878220,2830000,2900100,3024400,3271900,3480000,3539900,3557761,3667233,3879155,4109086 +"Europe","Italy",4931.404155,6248.656232,8243.58234,10022.40131,12269.27378,14255.98475,16537.4835,19207.23482,22013.64486,24675.02446,27968.09817,28569.7197,65.94,67.81,69.24,71.06,72.19,73.48,74.98,76.42,77.44,78.82,80.24,80.546,47666000,49182000,50843200,52667100,54365564,56059245,56535636,56729703,56840847,57479469,57926999,58147733 +"Europe","Montenegro",2647.585601,3682.259903,4649.593785,5907.850937,7778.414017,9595.929905,11222.58762,11732.51017,7003.339037,6465.613349,6557.194282,9253.896111,59.164,61.448,63.728,67.178,70.636,73.066,74.101,74.865,75.435,75.445,73.981,74.543,413834,442829,474528,501035,527678,560073,562548,569473,621621,692651,720230,684736 +"Europe","Netherlands",8941.571858,11276.19344,12790.84956,15363.25136,18794.74567,21209.0592,21399.46046,23651.32361,26790.94961,30246.13063,33724.75778,36797.93332,72.13,72.99,73.23,73.82,73.75,75.24,76.05,76.83,77.42,78.03,78.53,79.762,10381988,11026383,11805689,12596822,13329874,13852989,14310401,14665278,15174244,15604464,16122830,16570613 +"Europe","Norway",10095.42172,11653.97304,13450.40151,16361.87647,18965.05551,23311.34939,26298.63531,31540.9748,33965.66115,41283.16433,44683.97525,49357.19017,72.67,73.44,73.47,74.08,74.34,75.37,75.97,75.89,77.32,78.32,79.05,80.196,3327728,3491938,3638919,3786019,3933004,4043205,4114787,4186147,4286357,4405672,4535591,4627926 +"Europe","Poland",4029.329699,4734.253019,5338.752143,6557.152776,8006.506993,9508.141454,8451.531004,9082.351172,7738.881247,10159.58368,12002.23908,15389.92468,61.31,65.77,67.64,69.61,70.85,70.67,71.32,70.98,70.99,72.75,74.67,75.563,25730551,28235346,30329617,31785378,33039545,34621254,36227381,37740710,38370697,38654957,38625976,38518241 +"Europe","Portugal",3068.319867,3774.571743,4727.954889,6361.517993,9022.247417,10172.48572,11753.84291,13039.30876,16207.26663,17641.03156,19970.90787,20509.64777,59.82,61.51,64.39,66.6,69.26,70.41,72.77,74.06,74.86,75.97,77.29,78.098,8526050,8817650,9019800,9103000,8970450,9662600,9859650,9915289,9927680,10156415,10433867,10642836 +"Europe","Romania",3144.613186,3943.370225,4734.997586,6470.866545,8011.414402,9356.39724,9605.314053,9696.273295,6598.409903,7346.547557,7885.360081,10808.47561,61.05,64.1,66.8,66.8,69.21,69.46,69.66,69.53,69.36,69.72,71.322,72.476,16630000,17829327,18680721,19284814,20662648,21658597,22356726,22686371,22797027,22562458,22404337,22276056 +"Europe","Serbia",3581.459448,4981.090891,6289.629157,7991.707066,10522.06749,12980.66956,15181.0927,15870.87851,9325.068238,7914.320304,7236.075251,9786.534714,57.996,61.685,64.531,66.914,68.7,70.3,70.162,71.218,71.659,72.232,73.213,74.002,6860147,7271135,7616060,7971222,8313288,8686367,9032824,9230783,9826397,10336594,10111559,10150265 +"Europe","Slovak Republic",5074.659104,6093.26298,7481.107598,8412.902397,9674.167626,10922.66404,11348.54585,12037.26758,9498.467723,12126.23065,13638.77837,18678.31435,64.36,67.45,70.33,70.98,70.35,70.45,70.8,71.08,71.38,72.71,73.8,74.663,3558137,3844277,4237384,4442238,4593433,4827803,5048043,5199318,5302888,5383010,5410052,5447502 +"Europe","Slovenia",4215.041741,5862.276629,7402.303395,9405.489397,12383.4862,15277.03017,17866.72175,18678.53492,14214.71681,17161.10735,20660.01936,25768.25759,65.57,67.85,69.15,69.18,69.82,70.97,71.063,72.25,73.64,75.13,76.66,77.926,1489518,1533070,1582962,1646912,1694510,1746919,1861252,1945870,1999210,2011612,2011497,2009245 +"Europe","Spain",3834.034742,4564.80241,5693.843879,7993.512294,10638.75131,13236.92117,13926.16997,15764.98313,18603.06452,20445.29896,24835.47166,28821.0637,64.94,66.66,69.69,71.44,73.06,74.39,76.3,76.9,77.57,78.77,79.78,80.941,28549870,29841614,31158061,32850275,34513161,36439000,37983310,38880702,39549438,39855442,40152517,40448191 +"Europe","Sweden",8527.844662,9911.878226,12329.44192,15258.29697,17832.02464,18855.72521,20667.38125,23586.92927,23880.01683,25266.59499,29341.63093,33859.74835,71.86,72.49,73.37,74.16,74.72,75.44,76.42,77.19,78.16,79.39,80.04,80.884,7124673,7363802,7561588,7867931,8122293,8251648,8325260,8421403,8718867,8897619,8954175,9031088 +"Europe","Switzerland",14734.23275,17909.48973,20431.0927,22966.14432,27195.11304,26982.29052,28397.71512,30281.70459,31871.5303,32135.32301,34480.95771,37506.41907,69.62,70.56,71.32,72.77,73.78,75.39,76.21,77.41,78.03,79.37,80.62,81.701,4815000,5126000,5666000,6063000,6401400,6316424,6468126,6649942,6995447,7193761,7361757,7554661 +"Europe","Turkey",1969.10098,2218.754257,2322.869908,2826.356387,3450.69638,4269.122326,4241.356344,5089.043686,5678.348271,6601.429915,6508.085718,8458.276384,43.585,48.079,52.098,54.336,57.005,59.507,61.036,63.108,66.146,68.835,70.845,71.777,22235677,25670939,29788695,33411317,37492953,42404033,47328791,52881328,58179144,63047647,67308928,71158647 +"Europe","United Kingdom",9979.508487,11283.17795,12477.17707,14142.85089,15895.11641,17428.74846,18232.42452,21664.78767,22705.09254,26074.53136,29478.99919,33203.26128,69.18,70.42,70.76,71.36,72.01,72.76,74.04,75.007,76.42,77.218,78.471,79.425,50430000,51430000,53292000,54959000,56079000,56179000,56339704,56981620,57866349,58808266,59912431,60776238 +"Oceania","Australia",10039.59564,10949.64959,12217.22686,14526.12465,16788.62948,18334.19751,19477.00928,21888.88903,23424.76683,26997.93657,30687.75473,34435.36744,69.12,70.33,70.93,71.1,71.93,73.49,74.74,76.32,77.56,78.83,80.37,81.235,8691212,9712569,10794968,11872264,13177000,14074100,15184200,16257249,17481977,18565243,19546792,20434176 +"Oceania","New Zealand",10556.57566,12247.39532,13175.678,14463.91893,16046.03728,16233.7177,17632.4104,19007.19129,18363.32494,21050.41377,23189.80135,25185.00911,69.39,70.26,71.24,71.52,71.89,72.22,73.84,74.32,76.33,77.55,79.11,80.204,1994794,2229407,2488550,2728150,2929100,3164900,3210650,3317166,3437674,3676187,3908037,4115771 diff --git a/data/gapminder_gdp_africa.csv b/data/gapminder_gdp_africa.csv new file mode 100644 index 000000000..1609c405d --- /dev/null +++ b/data/gapminder_gdp_africa.csv @@ -0,0 +1,53 @@ +country,gdpPercap_1952,gdpPercap_1957,gdpPercap_1962,gdpPercap_1967,gdpPercap_1972,gdpPercap_1977,gdpPercap_1982,gdpPercap_1987,gdpPercap_1992,gdpPercap_1997,gdpPercap_2002,gdpPercap_2007 +Algeria,2449.008185,3013.976023,2550.81688,3246.991771,4182.663766,4910.416756,5745.160213,5681.358539,5023.216647,4797.295051,5288.040382,6223.367465 +Angola,3520.610273,3827.940465,4269.276742,5522.776375,5473.288005,3008.647355,2756.953672,2430.208311,2627.845685,2277.140884,2773.287312,4797.231267 +Benin,1062.7522,959.6010805,949.4990641,1035.831411,1085.796879,1029.161251,1277.897616,1225.85601,1191.207681,1232.975292,1372.877931,1441.284873 +Botswana,851.2411407,918.2325349,983.6539764,1214.709294,2263.611114,3214.857818,4551.14215,6205.88385,7954.111645,8647.142313,11003.60508,12569.85177 +Burkina Faso,543.2552413,617.1834648,722.5120206,794.8265597,854.7359763,743.3870368,807.1985855,912.0631417,931.7527731,946.2949618,1037.645221,1217.032994 +Burundi,339.2964587,379.5646281,355.2032273,412.9775136,464.0995039,556.1032651,559.603231,621.8188189,631.6998778,463.1151478,446.4035126,430.0706916 +Cameroon,1172.667655,1313.048099,1399.607441,1508.453148,1684.146528,1783.432873,2367.983282,2602.664206,1793.163278,1694.337469,1934.011449,2042.09524 +Central African Republic,1071.310713,1190.844328,1193.068753,1136.056615,1070.013275,1109.374338,956.7529907,844.8763504,747.9055252,740.5063317,738.6906068,706.016537 +Chad,1178.665927,1308.495577,1389.817618,1196.810565,1104.103987,1133.98495,797.9081006,952.386129,1058.0643,1004.961353,1156.18186,1704.063724 +Comoros,1102.990936,1211.148548,1406.648278,1876.029643,1937.577675,1172.603047,1267.100083,1315.980812,1246.90737,1173.618235,1075.811558,986.1478792 +Congo Dem. Rep.,780.5423257,905.8602303,896.3146335,861.5932424,904.8960685,795.757282,673.7478181,672.774812,457.7191807,312.188423,241.1658765,277.5518587 +Congo Rep.,2125.621418,2315.056572,2464.783157,2677.939642,3213.152683,3259.178978,4879.507522,4201.194937,4016.239529,3484.164376,3484.06197,3632.557798 +Cote d'Ivoire,1388.594732,1500.895925,1728.869428,2052.050473,2378.201111,2517.736547,2602.710169,2156.956069,1648.073791,1786.265407,1648.800823,1544.750112 +Djibouti,2669.529475,2864.969076,3020.989263,3020.050513,3694.212352,3081.761022,2879.468067,2880.102568,2377.156192,1895.016984,1908.260867,2082.481567 +Egypt,1418.822445,1458.915272,1693.335853,1814.880728,2024.008147,2785.493582,3503.729636,3885.46071,3794.755195,4173.181797,4754.604414,5581.180998 +Equatorial Guinea,375.6431231,426.0964081,582.8419714,915.5960025,672.4122571,958.5668124,927.8253427,966.8968149,1132.055034,2814.480755,7703.4959,12154.08975 +Eritrea,328.9405571,344.1618859,380.9958433,468.7949699,514.3242082,505.7538077,524.8758493,521.1341333,582.8585102,913.47079,765.3500015,641.3695236 +Ethiopia,362.1462796,378.9041632,419.4564161,516.1186438,566.2439442,556.8083834,577.8607471,573.7413142,421.3534653,515.8894013,530.0535319,690.8055759 +Gabon,4293.476475,4976.198099,6631.459222,8358.761987,11401.94841,21745.57328,15113.36194,11864.40844,13522.15752,14722.84188,12521.71392,13206.48452 +Gambia,485.2306591,520.9267111,599.650276,734.7829124,756.0868363,884.7552507,835.8096108,611.6588611,665.6244126,653.7301704,660.5855997,752.7497265 +Ghana,911.2989371,1043.561537,1190.041118,1125.69716,1178.223708,993.2239571,876.032569,847.0061135,925.060154,1005.245812,1111.984578,1327.60891 +Guinea,510.1964923,576.2670245,686.3736739,708.7595409,741.6662307,874.6858643,857.2503577,805.5724718,794.3484384,869.4497668,945.5835837,942.6542111 +Guinea-Bissau,299.850319,431.7904566,522.0343725,715.5806402,820.2245876,764.7259628,838.1239671,736.4153921,745.5398706,796.6644681,575.7047176,579.231743 +Kenya,853.540919,944.4383152,896.9663732,1056.736457,1222.359968,1267.613204,1348.225791,1361.936856,1341.921721,1360.485021,1287.514732,1463.249282 +Lesotho,298.8462121,335.9971151,411.8006266,498.6390265,496.5815922,745.3695408,797.2631074,773.9932141,977.4862725,1186.147994,1275.184575,1569.331442 +Liberia,575.5729961,620.9699901,634.1951625,713.6036483,803.0054535,640.3224383,572.1995694,506.1138573,636.6229191,609.1739508,531.4823679,414.5073415 +Libya,2387.54806,3448.284395,6757.030816,18772.75169,21011.49721,21951.21176,17364.27538,11770.5898,9640.138501,9467.446056,9534.677467,12057.49928 +Madagascar,1443.011715,1589.20275,1643.38711,1634.047282,1748.562982,1544.228586,1302.878658,1155.441948,1040.67619,986.2958956,894.6370822,1044.770126 +Malawi,369.1650802,416.3698064,427.9010856,495.5147806,584.6219709,663.2236766,632.8039209,635.5173634,563.2000145,692.2758103,665.4231186,759.3499101 +Mali,452.3369807,490.3821867,496.1743428,545.0098873,581.3688761,686.3952693,618.0140641,684.1715576,739.014375,790.2579846,951.4097518,1042.581557 +Mauritania,743.1159097,846.1202613,1055.896036,1421.145193,1586.851781,1497.492223,1481.150189,1421.603576,1361.369784,1483.136136,1579.019543,1803.151496 +Mauritius,1967.955707,2034.037981,2529.067487,2475.387562,2575.484158,3710.982963,3688.037739,4783.586903,6058.253846,7425.705295,9021.815894,10956.99112 +Morocco,1688.20357,1642.002314,1566.353493,1711.04477,1930.194975,2370.619976,2702.620356,2755.046991,2948.047252,2982.101858,3258.495584,3820.17523 +Mozambique,468.5260381,495.5868333,556.6863539,566.6691539,724.9178037,502.3197334,462.2114149,389.8761846,410.8968239,472.3460771,633.6179466,823.6856205 +Namibia,2423.780443,2621.448058,3173.215595,3793.694753,3746.080948,3876.485958,4191.100511,3693.731337,3804.537999,3899.52426,4072.324751,4811.060429 +Niger,761.879376,835.5234025,997.7661127,1054.384891,954.2092363,808.8970728,909.7221354,668.3000228,581.182725,580.3052092,601.0745012,619.6768924 +Nigeria,1077.281856,1100.592563,1150.927478,1014.514104,1698.388838,1981.951806,1576.97375,1385.029563,1619.848217,1624.941275,1615.286395,2013.977305 +Reunion,2718.885295,2769.451844,3173.72334,4021.175739,5047.658563,4319.804067,5267.219353,5303.377488,6101.255823,6071.941411,6316.1652,7670.122558 +Rwanda,493.3238752,540.2893983,597.4730727,510.9637142,590.5806638,670.0806011,881.5706467,847.991217,737.0685949,589.9445051,785.6537648,863.0884639 +Sao Tome and Principe,879.5835855,860.7369026,1071.551119,1384.840593,1532.985254,1737.561657,1890.218117,1516.525457,1428.777814,1339.076036,1353.09239,1598.435089 +Senegal,1450.356983,1567.653006,1654.988723,1612.404632,1597.712056,1561.769116,1518.479984,1441.72072,1367.899369,1392.368347,1519.635262,1712.472136 +Sierra Leone,879.7877358,1004.484437,1116.639877,1206.043465,1353.759762,1348.285159,1465.010784,1294.447788,1068.696278,574.6481576,699.489713,862.5407561 +Somalia,1135.749842,1258.147413,1369.488336,1284.73318,1254.576127,1450.992513,1176.807031,1093.244963,926.9602964,930.5964284,882.0818218,926.1410683 +South Africa,4725.295531,5487.104219,5768.729717,7114.477971,7765.962636,8028.651439,8568.266228,7825.823398,7225.069258,7479.188244,7710.946444,9269.657808 +Sudan,1615.991129,1770.337074,1959.593767,1687.997641,1659.652775,2202.988423,1895.544073,1507.819159,1492.197043,1632.210764,1993.398314,2602.394995 +Swaziland,1148.376626,1244.708364,1856.182125,2613.101665,3364.836625,3781.410618,3895.384018,3984.839812,3553.0224,3876.76846,4128.116943,4513.480643 +Tanzania,716.6500721,698.5356073,722.0038073,848.2186575,915.9850592,962.4922932,874.2426069,831.8220794,825.682454,789.1862231,899.0742111,1107.482182 +Togo,859.8086567,925.9083202,1067.53481,1477.59676,1649.660188,1532.776998,1344.577953,1202.201361,1034.298904,982.2869243,886.2205765,882.9699438 +Tunisia,1468.475631,1395.232468,1660.30321,1932.360167,2753.285994,3120.876811,3560.233174,3810.419296,4332.720164,4876.798614,5722.895655,7092.923025 +Uganda,734.753484,774.3710692,767.2717398,908.9185217,950.735869,843.7331372,682.2662268,617.7244065,644.1707969,816.559081,927.7210018,1056.380121 +Zambia,1147.388831,1311.956766,1452.725766,1777.077318,1773.498265,1588.688299,1408.678565,1213.315116,1210.884633,1071.353818,1071.613938,1271.211593 +Zimbabwe,406.8841148,518.7642681,527.2721818,569.7950712,799.3621758,685.5876821,788.8550411,706.1573059,693.4207856,792.4499603,672.0386227,469.7092981 diff --git a/data/gapminder_gdp_americas.csv b/data/gapminder_gdp_americas.csv new file mode 100644 index 000000000..e93fb979a --- /dev/null +++ b/data/gapminder_gdp_americas.csv @@ -0,0 +1,26 @@ +continent,country,gdpPercap_1952,gdpPercap_1957,gdpPercap_1962,gdpPercap_1967,gdpPercap_1972,gdpPercap_1977,gdpPercap_1982,gdpPercap_1987,gdpPercap_1992,gdpPercap_1997,gdpPercap_2002,gdpPercap_2007 +Americas,Argentina,5911.315053,6856.856212,7133.166023,8052.953021,9443.038526,10079.02674,8997.897412,9139.671389,9308.41871,10967.28195,8797.640716,12779.37964 +Americas,Bolivia,2677.326347,2127.686326,2180.972546,2586.886053,2980.331339,3548.097832,3156.510452,2753.69149,2961.699694,3326.143191,3413.26269,3822.137084 +Americas,Brazil,2108.944355,2487.365989,3336.585802,3429.864357,4985.711467,6660.118654,7030.835878,7807.095818,6950.283021,7957.980824,8131.212843,9065.800825 +Americas,Canada,11367.16112,12489.95006,13462.48555,16076.58803,18970.57086,22090.88306,22898.79214,26626.51503,26342.88426,28954.92589,33328.96507,36319.23501 +Americas,Chile,3939.978789,4315.622723,4519.094331,5106.654313,5494.024437,4756.763836,5095.665738,5547.063754,7596.125964,10118.05318,10778.78385,13171.63885 +Americas,Colombia,2144.115096,2323.805581,2492.351109,2678.729839,3264.660041,3815.80787,4397.575659,4903.2191,5444.648617,6117.361746,5755.259962,7006.580419 +Americas,Costa Rica,2627.009471,2990.010802,3460.937025,4161.727834,5118.146939,5926.876967,5262.734751,5629.915318,6160.416317,6677.045314,7723.447195,9645.06142 +Americas,Cuba,5586.53878,6092.174359,5180.75591,5690.268015,5305.445256,6380.494966,7316.918107,7532.924763,5592.843963,5431.990415,6340.646683,8948.102923 +Americas,Dominican Republic,1397.717137,1544.402995,1662.137359,1653.723003,2189.874499,2681.9889,2861.092386,2899.842175,3044.214214,3614.101285,4563.808154,6025.374752 +Americas,Ecuador,3522.110717,3780.546651,4086.114078,4579.074215,5280.99471,6679.62326,7213.791267,6481.776993,7103.702595,7429.455877,5773.044512,6873.262326 +Americas,El Salvador,3048.3029,3421.523218,3776.803627,4358.595393,4520.246008,5138.922374,4098.344175,4140.442097,4444.2317,5154.825496,5351.568666,5728.353514 +Americas,Guatemala,2428.237769,2617.155967,2750.364446,3242.531147,4031.408271,4879.992748,4820.49479,4246.485974,4439.45084,4684.313807,4858.347495,5186.050003 +Americas,Haiti,1840.366939,1726.887882,1796.589032,1452.057666,1654.456946,1874.298931,2011.159549,1823.015995,1456.309517,1341.726931,1270.364932,1201.637154 +Americas,Honduras,2194.926204,2220.487682,2291.156835,2538.269358,2529.842345,3203.208066,3121.760794,3023.096699,3081.694603,3160.454906,3099.72866,3548.330846 +Americas,Jamaica,2898.530881,4756.525781,5246.107524,6124.703451,7433.889293,6650.195573,6068.05135,6351.237495,7404.923685,7121.924704,6994.774861,7320.880262 +Americas,Mexico,3478.125529,4131.546641,4581.609385,5754.733883,6809.40669,7674.929108,9611.147541,8688.156003,9472.384295,9767.29753,10742.44053,11977.57496 +Americas,Nicaragua,3112.363948,3457.415947,3634.364406,4643.393534,4688.593267,5486.371089,3470.338156,2955.984375,2170.151724,2253.023004,2474.548819,2749.320965 +Americas,Panama,2480.380334,2961.800905,3536.540301,4421.009084,5364.249663,5351.912144,7009.601598,7034.779161,6618.74305,7113.692252,7356.031934,9809.185636 +Americas,Paraguay,1952.308701,2046.154706,2148.027146,2299.376311,2523.337977,3248.373311,4258.503604,3998.875695,4196.411078,4247.400261,3783.674243,4172.838464 +Americas,Peru,3758.523437,4245.256698,4957.037982,5788.09333,5937.827283,6281.290855,6434.501797,6360.943444,4446.380924,5838.347657,5909.020073,7408.905561 +Americas,Puerto Rico,3081.959785,3907.156189,5108.34463,6929.277714,9123.041742,9770.524921,10330.98915,12281.34191,14641.58711,16999.4333,18855.60618,19328.70901 +Americas,Trinidad and Tobago,3023.271928,4100.3934,4997.523971,5621.368472,6619.551419,7899.554209,9119.528607,7388.597823,7370.990932,8792.573126,11460.60023,18008.50924 +Americas,United States,13990.48208,14847.12712,16173.14586,19530.36557,21806.03594,24072.63213,25009.55914,29884.35041,32003.93224,35767.43303,39097.09955,42951.65309 +Americas,Uruguay,5716.766744,6150.772969,5603.357717,5444.61962,5703.408898,6504.339663,6920.223051,7452.398969,8137.004775,9230.240708,7727.002004,10611.46299 +Americas,Venezuela,7689.799761,9802.466526,8422.974165,9541.474188,10505.25966,13143.95095,11152.41011,9883.584648,10733.92631,10165.49518,8605.047831,11415.80569 diff --git a/data/gapminder_gdp_asia.csv b/data/gapminder_gdp_asia.csv new file mode 100644 index 000000000..7b026f549 --- /dev/null +++ b/data/gapminder_gdp_asia.csv @@ -0,0 +1,34 @@ +country,gdpPercap_1952,gdpPercap_1957,gdpPercap_1962,gdpPercap_1967,gdpPercap_1972,gdpPercap_1977,gdpPercap_1982,gdpPercap_1987,gdpPercap_1992,gdpPercap_1997,gdpPercap_2002,gdpPercap_2007 +Afghanistan,779.4453145,820.8530296,853.10071,836.1971382,739.9811058,786.11336,978.0114388,852.3959448,649.3413952,635.341351,726.7340548,974.5803384 +Bahrain,9867.084765,11635.79945,12753.27514,14804.6727,18268.65839,19340.10196,19211.14731,18524.02406,19035.57917,20292.01679,23403.55927,29796.04834 +Bangladesh,684.2441716,661.6374577,686.3415538,721.1860862,630.2336265,659.8772322,676.9818656,751.9794035,837.8101643,972.7700352,1136.39043,1391.253792 +Cambodia,368.4692856,434.0383364,496.9136476,523.4323142,421.6240257,524.9721832,624.4754784,683.8955732,682.3031755,734.28517,896.2260153,1713.778686 +China,400.4486107,575.9870009,487.6740183,612.7056934,676.9000921,741.2374699,962.4213805,1378.904018,1655.784158,2289.234136,3119.280896,4959.114854 +Hong Kong China,3054.421209,3629.076457,4692.648272,6197.962814,8315.928145,11186.14125,14560.53051,20038.47269,24757.60301,28377.63219,30209.01516,39724.97867 +India,546.5657493,590.061996,658.3471509,700.7706107,724.032527,813.337323,855.7235377,976.5126756,1164.406809,1458.817442,1746.769454,2452.210407 +Indonesia,749.6816546,858.9002707,849.2897701,762.4317721,1111.107907,1382.702056,1516.872988,1748.356961,2383.140898,3119.335603,2873.91287,3540.651564 +Iran,3035.326002,3290.257643,4187.329802,5906.731805,9613.818607,11888.59508,7608.334602,6642.881371,7235.653188,8263.590301,9240.761975,11605.71449 +Iraq,4129.766056,6229.333562,8341.737815,8931.459811,9576.037596,14688.23507,14517.90711,11643.57268,3745.640687,3076.239795,4390.717312,4471.061906 +Israel,4086.522128,5385.278451,7105.630706,8393.741404,12786.93223,13306.61921,15367.0292,17122.47986,18051.52254,20896.60924,21905.59514,25523.2771 +Japan,3216.956347,4317.694365,6576.649461,9847.788607,14778.78636,16610.37701,19384.10571,22375.94189,26824.89511,28816.58499,28604.5919,31656.06806 +Jordan,1546.907807,1886.080591,2348.009158,2741.796252,2110.856309,2852.351568,4161.415959,4448.679912,3431.593647,3645.379572,3844.917194,4519.461171 +Korea Dem. Rep.,1088.277758,1571.134655,1621.693598,2143.540609,3701.621503,4106.301249,4106.525293,4106.492315,3726.063507,1690.756814,1646.758151,1593.06548 +Korea Rep.,1030.592226,1487.593537,1536.344387,2029.228142,3030.87665,4657.22102,5622.942464,8533.088805,12104.27872,15993.52796,19233.98818,23348.13973 +Kuwait,108382.3529,113523.1329,95458.11176,80894.88326,109347.867,59265.47714,31354.03573,28118.42998,34932.91959,40300.61996,35110.10566,47306.98978 +Lebanon,4834.804067,6089.786934,5714.560611,6006.983042,7486.384341,8659.696836,7640.519521,5377.091329,6890.806854,8754.96385,9313.93883,10461.05868 +Malaysia,1831.132894,1810.066992,2036.884944,2277.742396,2849.09478,3827.921571,4920.355951,5249.802653,7277.912802,10132.90964,10206.97794,12451.6558 +Mongolia,786.5668575,912.6626085,1056.353958,1226.04113,1421.741975,1647.511665,2000.603139,2338.008304,1785.402016,1902.2521,2140.739323,3095.772271 +Myanmar,331,350,388,349,357,371,424,385,347,415,611,944 +Nepal,545.8657229,597.9363558,652.3968593,676.4422254,674.7881296,694.1124398,718.3730947,775.6324501,897.7403604,1010.892138,1057.206311,1091.359778 +Oman,1828.230307,2242.746551,2924.638113,4720.942687,10618.03855,11848.34392,12954.79101,18115.22313,18616.70691,19702.05581,19774.83687,22316.19287 +Pakistan,684.5971438,747.0835292,803.3427418,942.4082588,1049.938981,1175.921193,1443.429832,1704.686583,1971.829464,2049.350521,2092.712441,2605.94758 +Philippines,1272.880995,1547.944844,1649.552153,1814.12743,1989.37407,2373.204287,2603.273765,2189.634995,2279.324017,2536.534925,2650.921068,3190.481016 +Saudi Arabia,6459.554823,8157.591248,11626.41975,16903.04886,24837.42865,34167.7626,33693.17525,21198.26136,24841.61777,20586.69019,19014.54118,21654.83194 +Singapore,2315.138227,2843.104409,3674.735572,4977.41854,8597.756202,11210.08948,15169.16112,18861.53081,24769.8912,33519.4766,36023.1054,47143.17964 +Sri Lanka,1083.53203,1072.546602,1074.47196,1135.514326,1213.39553,1348.775651,1648.079789,1876.766827,2153.739222,2664.477257,3015.378833,3970.095407 +Syria,1643.485354,2117.234893,2193.037133,1881.923632,2571.423014,3195.484582,3761.837715,3116.774285,3340.542768,4014.238972,4090.925331,4184.548089 +Taiwan,1206.947913,1507.86129,1822.879028,2643.858681,4062.523897,5596.519826,7426.354774,11054.56175,15215.6579,20206.82098,23235.42329,28718.27684 +Thailand,757.7974177,793.5774148,1002.199172,1295.46066,1524.358936,1961.224635,2393.219781,2982.653773,4616.896545,5852.625497,5913.187529,7458.396327 +Vietnam,605.0664917,676.2854478,772.0491602,637.1232887,699.5016441,713.5371196,707.2357863,820.7994449,989.0231487,1385.896769,1764.456677,2441.576404 +West Bank and Gaza,1515.592329,1827.067742,2198.956312,2649.715007,3133.409277,3682.831494,4336.032082,5107.197384,6017.654756,7110.667619,4515.487575,3025.349798 +Yemen Rep.,781.7175761,804.8304547,825.6232006,862.4421463,1265.047031,1829.765177,1977.55701,1971.741538,1879.496673,2117.484526,2234.820827,2280.769906 diff --git a/data/gapminder_gdp_europe.csv b/data/gapminder_gdp_europe.csv new file mode 100644 index 000000000..1792319f6 --- /dev/null +++ b/data/gapminder_gdp_europe.csv @@ -0,0 +1,31 @@ +country,gdpPercap_1952,gdpPercap_1957,gdpPercap_1962,gdpPercap_1967,gdpPercap_1972,gdpPercap_1977,gdpPercap_1982,gdpPercap_1987,gdpPercap_1992,gdpPercap_1997,gdpPercap_2002,gdpPercap_2007 +Albania,1601.056136,1942.284244,2312.888958,2760.196931,3313.422188,3533.00391,3630.880722,3738.932735,2497.437901,3193.054604,4604.211737,5937.029526 +Austria,6137.076492,8842.59803,10750.72111,12834.6024,16661.6256,19749.4223,21597.08362,23687.82607,27042.01868,29095.92066,32417.60769,36126.4927 +Belgium,8343.105127,9714.960623,10991.20676,13149.04119,16672.14356,19117.97448,20979.84589,22525.56308,25575.57069,27561.19663,30485.88375,33692.60508 +Bosnia and Herzegovina,973.5331948,1353.989176,1709.683679,2172.352423,2860.16975,3528.481305,4126.613157,4314.114757,2546.781445,4766.355904,6018.975239,7446.298803 +Bulgaria,2444.286648,3008.670727,4254.337839,5577.0028,6597.494398,7612.240438,8224.191647,8239.854824,6302.623438,5970.38876,7696.777725,10680.79282 +Croatia,3119.23652,4338.231617,5477.890018,6960.297861,9164.090127,11305.38517,13221.82184,13822.58394,8447.794873,9875.604515,11628.38895,14619.22272 +Czech Republic,6876.14025,8256.343918,10136.86713,11399.44489,13108.4536,14800.16062,15377.22855,16310.4434,14297.02122,16048.51424,17596.21022,22833.30851 +Denmark,9692.385245,11099.65935,13583.31351,15937.21123,18866.20721,20422.9015,21688.04048,25116.17581,26406.73985,29804.34567,32166.50006,35278.41874 +Finland,6424.519071,7545.415386,9371.842561,10921.63626,14358.8759,15605.42283,18533.15761,21141.01223,20647.16499,23723.9502,28204.59057,33207.0844 +France,7029.809327,8662.834898,10560.48553,12999.91766,16107.19171,18292.63514,20293.89746,22066.44214,24703.79615,25889.78487,28926.03234,30470.0167 +Germany,7144.114393,10187.82665,12902.46291,14745.62561,18016.18027,20512.92123,22031.53274,24639.18566,26505.30317,27788.88416,30035.80198,32170.37442 +Greece,3530.690067,4916.299889,6017.190733,8513.097016,12724.82957,14195.52428,15268.42089,16120.52839,17541.49634,18747.69814,22514.2548,27538.41188 +Hungary,5263.673816,6040.180011,7550.359877,9326.64467,10168.65611,11674.83737,12545.99066,12986.47998,10535.62855,11712.7768,14843.93556,18008.94444 +Iceland,7267.688428,9244.001412,10350.15906,13319.89568,15798.06362,19654.96247,23269.6075,26923.20628,25144.39201,28061.09966,31163.20196,36180.78919 +Ireland,5210.280328,5599.077872,6631.597314,7655.568963,9530.772896,11150.98113,12618.32141,13872.86652,17558.81555,24521.94713,34077.04939,40675.99635 +Italy,4931.404155,6248.656232,8243.58234,10022.40131,12269.27378,14255.98475,16537.4835,19207.23482,22013.64486,24675.02446,27968.09817,28569.7197 +Montenegro,2647.585601,3682.259903,4649.593785,5907.850937,7778.414017,9595.929905,11222.58762,11732.51017,7003.339037,6465.613349,6557.194282,9253.896111 +Netherlands,8941.571858,11276.19344,12790.84956,15363.25136,18794.74567,21209.0592,21399.46046,23651.32361,26790.94961,30246.13063,33724.75778,36797.93332 +Norway,10095.42172,11653.97304,13450.40151,16361.87647,18965.05551,23311.34939,26298.63531,31540.9748,33965.66115,41283.16433,44683.97525,49357.19017 +Poland,4029.329699,4734.253019,5338.752143,6557.152776,8006.506993,9508.141454,8451.531004,9082.351172,7738.881247,10159.58368,12002.23908,15389.92468 +Portugal,3068.319867,3774.571743,4727.954889,6361.517993,9022.247417,10172.48572,11753.84291,13039.30876,16207.26663,17641.03156,19970.90787,20509.64777 +Romania,3144.613186,3943.370225,4734.997586,6470.866545,8011.414402,9356.39724,9605.314053,9696.273295,6598.409903,7346.547557,7885.360081,10808.47561 +Serbia,3581.459448,4981.090891,6289.629157,7991.707066,10522.06749,12980.66956,15181.0927,15870.87851,9325.068238,7914.320304,7236.075251,9786.534714 +Slovak Republic,5074.659104,6093.26298,7481.107598,8412.902397,9674.167626,10922.66404,11348.54585,12037.26758,9498.467723,12126.23065,13638.77837,18678.31435 +Slovenia,4215.041741,5862.276629,7402.303395,9405.489397,12383.4862,15277.03017,17866.72175,18678.53492,14214.71681,17161.10735,20660.01936,25768.25759 +Spain,3834.034742,4564.80241,5693.843879,7993.512294,10638.75131,13236.92117,13926.16997,15764.98313,18603.06452,20445.29896,24835.47166,28821.0637 +Sweden,8527.844662,9911.878226,12329.44192,15258.29697,17832.02464,18855.72521,20667.38125,23586.92927,23880.01683,25266.59499,29341.63093,33859.74835 +Switzerland,14734.23275,17909.48973,20431.0927,22966.14432,27195.11304,26982.29052,28397.71512,30281.70459,31871.5303,32135.32301,34480.95771,37506.41907 +Turkey,1969.10098,2218.754257,2322.869908,2826.356387,3450.69638,4269.122326,4241.356344,5089.043686,5678.348271,6601.429915,6508.085718,8458.276384 +United Kingdom,9979.508487,11283.17795,12477.17707,14142.85089,15895.11641,17428.74846,18232.42452,21664.78767,22705.09254,26074.53136,29478.99919,33203.26128 diff --git a/data/gapminder_gdp_oceania.csv b/data/gapminder_gdp_oceania.csv new file mode 100644 index 000000000..e15b16056 --- /dev/null +++ b/data/gapminder_gdp_oceania.csv @@ -0,0 +1,3 @@ +country,gdpPercap_1952,gdpPercap_1957,gdpPercap_1962,gdpPercap_1967,gdpPercap_1972,gdpPercap_1977,gdpPercap_1982,gdpPercap_1987,gdpPercap_1992,gdpPercap_1997,gdpPercap_2002,gdpPercap_2007 +Australia,10039.59564,10949.64959,12217.22686,14526.12465,16788.62948,18334.19751,19477.00928,21888.88903,23424.76683,26997.93657,30687.75473,34435.36744 +New Zealand,10556.57566,12247.39532,13175.678,14463.91893,16046.03728,16233.7177,17632.4104,19007.19129,18363.32494,21050.41377,23189.80135,25185.00911 diff --git a/design.md b/design.md new file mode 100644 index 000000000..059a6f7da --- /dev/null +++ b/design.md @@ -0,0 +1,360 @@ +--- +title: Lesson Design +--- + +::::::::::::::::::::::::::::::::::::::::: callout + +## Help Wanted + +**We are filling in the exercises [below](#stage-3-learning-plan) +in order to make the lesson plan more concrete. +Contributions (both in the form of pull requests with filled-in exercises, +and comments on specific exercises, ordering, and timings) are greatly appreciated.** + + +:::::::::::::::::::::::::::::::::::::::::::::::::: + +## Process Used + +> Michael Pollan's advice if he taught R or Python programming: +> +> 1. Write code. +> 2. Not too much. +> 3. Mostly plots. +> +> — [Michael Koontz](https://twitter.com/_mikoontz/status/758021742078025728) +> {: .quotation} + +This lesson was developed using a slimmed-down variant of the "Understanding by Design" process. +The main sections are: + +1. Assumptions about audience, time, etc. + (The current draft also includes some conclusions and decisions in this + section - that should be refactored.) + +2. Desired results: + overall goals, summative assessments at half-day granularity, what learners + will be able to do, what learners will know. + +3. Learning plan: + each episode has a heading that summarizes what will be covered, + then estimates time that will be spent on teaching and on exercises, + while the exercises are given as bullet points. + +## Stage 1: Assumptions + +- Audience + - Graduate students in numerate disciplines from cosmology to archaeology + - Who have manipulated data in spreadsheets and with interactive tools like SAS + - But have *not* programmed beyond CPD (copy-paste-despair) +- Constraints + - One full day 09:00-16:30 + - 06:15 class time + - 0:45 lunch + - 0:30 total for two coffee breaks + - Learners use native installs on their own machines + - May use VMs or cloud resources at instructor's discretion + - But must keep native local install as an option + - No dependence on other Carpentry modules + - In particular, does not require knowledge of shell or version control + - Use the Jupyter Notebook + - Authentic tool used by many instructors + - There isn't really an alternative + - And means that even people who have seen a bit of Python before + will probably learn something +- Motivating Example + - Creating 2D plots suitable for inclusion in papers + - Appeals to almost everyone + - Makes lesson usable by both Carpentries + - And means that even people who have seen a bit of Python before + will probably learn something +- Data + - Use the gapminder data throughout + - But break into multiple files by continent + - To make display of output from examples tidier + (e.g., use Australia/New Zealand, which is only two lines) + - And allow examples showing use of multiple data sets +- Focus on Pandas instead of NumPy + - Makes lesson usable by both Data Carpentry and Software Carpentry + - Genuine novices are likely to want data analysis + - And people with some prior experience: + - will accept data analysis as an authentic task, + - and are unlikely to have encountered Pandas, + so they'll still get something useful out of the lesson +- Challenges will mostly *not* be "write this code from scratch" + - Want lots of short exercises that can reliably be finished in allotted time + - So use MCQs, fill-in-the-blanks, Parsons Problems, "tweak this code", etc. + +## Stage 2: Desired Results + +### Questions + +How do I... + +- ...read tabular data? +- ...plot a single vector of values? +- ...create a time series plot? +- ...create one plot for each of several data sets? +- ...get extra data from a single data set for plotting? +- ...write programs I can read and re-use in future? + +### Skills + +I can... + +- ...write short scripts using loops and conditionals. +- ...write functions with a fixed number of parameters that return a single result. +- ...import libraries using aliases and refer to those libraries' contents. +- ...do simple data extraction and formatting using Pandas. + +### Concepts + +I know... + +- ...that a program is a piece of lab equipment that implements an analysis + - Needs to be validated/calibrated before/during use + - Makes analysis reproducible, reviewable, shareable +- ...that programs are written for people, not for computers + - Meaningful variable names + - Modularity for readability as well as re-use + - No duplication + - Document purpose and use +- ...that there is no magic: the programs they use are no different + in principle from those they build +- ...how to assign values to variables +- ...what integers, floats, strings, NumPy arrays, and Pandas dataframes are +- ...how to trace the execution of a `for` loop +- ...how to trace the execution of `if`/`else` statements +- ...how to create and index lists +- ...how to create and index NumPy arrays +- ...how to create and index Pandas dataframes +- ...how to create time series plots +- ...the difference between defining and calling a function +- ...where to find documentation on standard libraries +- ...how to find out what else scientific Python offers + +## Stage 3: Learning Plan + +### Summative Assessment + +- Midpoint: create time-series plot for each file in a directory. +- Final: extract data from Pandas dataframe + and create comparative multi-line time series plot. + +### [Running and Quitting Interactively](../episodes/01-run-quit.md) (9:00) + +- Teaching: 15 min (because setup issues) + - Launch the Jupyter Notebook, create new notebooks, and exit the Notebook. + - Create Markdown cells in a notebook. + - Create and run Python cells in a notebook. +- Challenges: 0 min (accounted for in teaching time - no separate exercise) + - Creating lists in Markdown + - What is displayed when several expressions are put in a single cell? + - Change an existing cell from code to Markdown + - Rendering LaTeX-style equations + +### [Variables and Assignment](../episodes/02-variables.md) (9:15) + +- Teaching: 10 min + - Write programs that assign scalar values to variables and perform calculations with those values. + - Correctly trace value changes in programs that use scalar assignment. +- Challenges: 10 min + - Trace execution of code swapping two values using an intermediate variable. + - Predict final values of variables after several assignments. + - What happens if you try to index a number? + - Which is a better variable name, `m`, `min`, or `minutes`? + - What do the following slice expressions produce? + +### [Data Types and Type Conversion](../episodes/03-types-conversion.md) (09:35) + +- Teaching: 10 min + - Explain key differences between integers and floating point numbers. + - Explain key differences between numbers and character strings. + - Use built-in functions to convert between integers, floating point numbers, and strings. +- Challenges: 10 min + - What type of value is 3.4? + - What type of value is 3.25 + 4? + - What type of value would you use to represent: + - Number of days since the start of the year. + - Time elapsed since the start of the year. + - Etc. + - How can you use `//` (integer division) and `%` (modulo)? + - What does `int("3.4")` do? + - Given these float, int, and string values, which expressions will print a particular result? + - What do you expect `1+2j + 3` to produce? + +### [Built-in Functions and Help](../episodes/04-built-in.md) (09:55) + +- Teaching: 15 min + - Explain the purpose of functions. + - Correctly call built-in Python functions. + - Correctly nest calls to built-in functions. + - Use help to display documentation for built-in functions. + - Correctly describe situations in which SyntaxError and NameError occur. +- Challenges: 10 min + - Explain the order of operations in the following complex expression. + - What will each nested combination of `min` and `max` calls produce? + - Why don't `max` and `min` return `None` when given no arguments? + - Given what we have seen so far, + what index expression will get the last character in a string? + +### [Coffee](../episodes/05-coffee.md): 15 min (10:20) + +### [Libraries](../episodes/06-libraries.md) (10:35) + +- Teaching: 10 min + - Explain what software libraries are and why programmers create and use them. + - Write programs that import and use libraries from Python's standard library. + - Find and read documentation for standard libraries interactively (in the interpreter) and online. +- Challenges: 10 min + - Which function from the standard math library could you use to calculate a square root? + - What library would you use to select a random value from data? + - If `help(math)` produces an error, what have you forgotten to do? + - Fill in the blanks in code below so that the import statement and program run. + +### [Reading Tabular Data](../episodes/07-reading-tabular.md) (10:55) + +- Teaching: 10 min + - Import the Pandas library. + - Use Pandas to load a simple CSV data set. + - Get some basic information about a Pandas DataFrame. +- Challenges: 10 min + - Read the data for the Americas and display its summary statistics. + - What do `.head` and `.tail` do? + - What string(s) should you pass to `read_csv` to read files from other directories? + - How can you *write* CSV data? + +### [DataFrames](../episodes/08-data-frames.md) (11:15) + +- Teaching: 15 min + - Select individual values from a Pandas dataframe. + - Select entire rows or entire columns from a dataframe. + - Select a subset of both rows and columns from a dataframe in a single operation. + - Select a subset of a dataframe by a single Boolean criterion. +- Challenges: 15 min + - Write an expression to find the Per Capita GDP of Serbia in 2007. + - What rule governs what is (or isn't) included in numerical and named slices in Pandas? + - What does each line in the following short program do? + - What do `idxmin` and `idxmax` do? + - Write expressions to get the GDP per capita for all countries in 1982, + for all countries *after* 1985, + etc. + - Given the way its borders have changed since 1900, + what would you do if asked to create a table of GDP per capita for Poland + for the Twentieth Century? + +### [Plotting](../episodes/09-plotting.md) (11:45) + +- Teaching: 15 min + - Create a time series plot showing a single data set. + - Create a scatter plot showing relationship between two data sets. +- Exercise: 15 min + - Fill in the blanks to plot the minimum GDP per capita over time for European countries. + - Modify the example to create a scatter plot of GDP per capita in Asian countries. + - Explain what each argument to `plot` does in the following example. + +### [Lunch](../episodes/10-lunch.md) (12:15): 45 min + +### [Lists](../episodes/11-lists.md) (13:00) + +- Teaching: 10 min + - Explain why programs need collections of values. + - Write programs that create flat lists, index them, slice them, and modify them through assignment and method calls. +- Challenges: 10 min + - Fill in the blanks so that the program produces the output shown. + - How large are the following slices? + - What do negative index expressions print? + - What does a "stride" in a slice do? + - How do slices treat out-of-range bounds? + - What are the differences between sorting these two ways? + - What is the difference between `new = old` and `new = old[:]`? + +### [Loops](../episodes/12-for-loops.md) (13:20) + +- Teaching: 10 min + - Explain what for loops are normally used for. + - Trace the execution of a simple (unnested) loop and correctly state the values of variables in each iteration. + - Write for loops that use the Accumulator pattern to aggregate values. +- Challenges: 15 min + - Is an indentation error a syntax error or a runtime error? + - Trace which lines of this program are executed in what order. + - Fill in the blanks in this program so that it reverses a string. + - Fill in the blanks in this series of examples to get practice accumulating values. + - Reorder and indent these lines to calculate the cumulative sum of the list values. + +### [Looping Over Data Sets](13-looping-data-sets) (13:45) + +- Teaching: 5 min + - Be able to read and write globbing expressions that match sets of files. + - Use glob to create lists of files. + - Write for loops to perform operations on files given their names in a list. +- Challenges: 10 min + - Which filenames are *not* matched by this glob expression? + - Modify this program so that it prints the number of records in the shortest file. + - Write a program that reads and plots all of the regional data sets. + +### [Writing Functions](14-writing-functions) (14:00) + +- Teaching: 10 min + - Explain and identify the difference between function definition and function call. + - Write a function that takes a small, fixed number of arguments and produces a single result. +- Challenges: 15 min + - This code defines and calls a function - what does it print when run? + - Explain why this short program prints things in the order it does. + - Fill in the blanks to create a function that finds the minimum value in a data file. + - Fill in the blanks to create a function that finds the first negative value in a list. + What does your function do if the list is empty? + - Why is it sometimes useful to pass arguments by naming the corresponding parameters? + - Fill in the blanks and turn this short piece of code into a function. + +### [Variable Scope](15-scope) (14:25) + +- Teaching: 10 min + - Identify local and global variables. + - Identify parameters as local variables. + - Read a traceback and determine the file, function, and line number on which the error occurred. +- Challenges: 10 min + - Trace the changes to the values in this program, + being careful to distinguish local from global values. + +### [Coffee](16-coffee) (14:45): 15 min + +### [Conditionals](17-conditionals) (15:00) + +- Teaching: 10 min + - Correctly write programs that use if and else statements and simple Boolean expressions (without logical operators). + - Trace the execution of unnested conditionals and conditionals inside loops. +- Challenges: 15 min + - Trace the execution of this conditional statement. + - Fill in the blanks so that this function replaces negative values with zeroes. + - Modify this program so that it only processes files with fewer than 50 records. + - Modify this program so that it always finds the largest and smallest values in a list + no matter what the list's values are. + +### [Programming Style](../episodes/18-style.md) (15:25) + +- Teaching: 15 min + - How can I make my programs more readable? + - How do most programmers format their code? + - How can programs check their own operation? +- Challenges: 15 min + - Which lines in this code will be available as online help? + - Turn the comments in this program into docstrings. + - Rewrite this short program to be more readable. + +### [Wrap-Up](../episodes/19-wrap.md) (15:55) + +- Teaching: 20 min + - Name and locate scientific Python community sites for software, workshops, and help. +- Challenges: 0 min + - None. + +### [Feedback](../episodes/20-feedback.md) (16:15) + +- Teaching: 0 min +- Challenges: 15 min + - Collect feedback + +### Finish (16:30) + + diff --git a/discuss.md b/discuss.md new file mode 100644 index 000000000..2882ce8ae --- /dev/null +++ b/discuss.md @@ -0,0 +1,7 @@ +--- +title: Discussion +--- + +FIXME: general discussion and further reading for learners. + + diff --git a/exercises.md b/exercises.md new file mode 100644 index 000000000..e717ad504 --- /dev/null +++ b/exercises.md @@ -0,0 +1,7 @@ +--- +title: Further Exercises +--- + +FIXME: exercises that don't fit into the regular schedule. + + diff --git a/fig/0_anaconda_navigator_landing_page.png b/fig/0_anaconda_navigator_landing_page.png new file mode 100644 index 0000000000000000000000000000000000000000..a5953fa5eb358707d89d12cb6f33f7deab4201d5 GIT binary patch literal 244877 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�|UwC!dnKzU!RhJYvzB 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�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 L*>CyB?Qi`b656#^ literal 0 HcmV?d00001 diff --git a/fig/0_jupyterlab_landing_page.png b/fig/0_jupyterlab_landing_page.png new file mode 100644 index 0000000000000000000000000000000000000000..6eb836b7c6b49d5d7ada821d3bbf9fa473995a48 GIT binary patch literal 460307 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