# Introduction to Python Open In Colab [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/intro-stat-learning/ISLP_labs/v2.2?labpath=Ch02-statlearn-lab.ipynb) ## Getting Started To run the labs in this book, you will need two things: * An installation of `Python3`, which is the specific version of `Python` used in the labs. * Access to `Jupyter`, a very popular `Python` interface that runs code through a file called a *notebook*. You can download and install `Python3` by following the instructions available at [anaconda.com](http://anaconda.com). There are a number of ways to get access to `Jupyter`. Here are just a few: * Using Google's `Colaboratory` service: [colab.research.google.com/](https://colab.research.google.com/). * Using `JupyterHub`, available at [jupyter.org/hub](https://jupyter.org/hub). * Using your own `jupyter` installation. Installation instructions are available at [jupyter.org/install](https://jupyter.org/install). Please see the `Python` resources page on the book website [statlearning.com](https://www.statlearning.com) for up-to-date information about getting `Python` and `Jupyter` working on your computer. You will need to install the `ISLP` package, which provides access to the datasets and custom-built functions that we provide. Inside a macOS or Linux terminal type `pip install ISLP`; this also installs most other packages needed in the labs. The `Python` resources page has a link to the `ISLP` documentation website. To run this lab, download the file `Ch2-statlearn-lab.ipynb` from the `Python` resources page. Now run the following code at the command line: `jupyter lab Ch2-statlearn-lab.ipynb`. If you're using Windows, you can use the `start menu` to access `anaconda`, and follow the links. For example, to install `ISLP` and run this lab, you can run the same code above in an `anaconda` shell. ## Basic Commands In this lab, we will introduce some simple `Python` commands. For more resources about `Python` in general, readers may want to consult the tutorial at [docs.python.org/3/tutorial/](https://docs.python.org/3/tutorial/). Like most programming languages, `Python` uses *functions* to perform operations. To run a function called `fun`, we type `fun(input1,input2)`, where the inputs (or *arguments*) `input1` and `input2` tell `Python` how to run the function. A function can have any number of inputs. For example, the `print()` function outputs a text representation of all of its arguments to the console. ```{python} print('fit a model with', 11, 'variables') ``` The following command will provide information about the `print()` function. ```{python} # print? ``` Adding two integers in `Python` is pretty intuitive. ```{python} 3 + 5 ``` In `Python`, textual data is handled using *strings*. For instance, `"hello"` and `'hello'` are strings. We can concatenate them using the addition `+` symbol. ```{python} "hello" + " " + "world" ``` A string is actually a type of *sequence*: this is a generic term for an ordered list. The three most important types of sequences are lists, tuples, and strings. We introduce lists now. The following command instructs `Python` to join together the numbers 3, 4, and 5, and to save them as a *list* named `x`. When we type `x`, it gives us back the list. ```{python} x = [3, 4, 5] x ``` Note that we used the brackets `[]` to construct this list. We will often want to add two sets of numbers together. It is reasonable to try the following code, though it will not produce the desired results. ```{python} y = [4, 9, 7] x + y ``` The result may appear slightly counterintuitive: why did `Python` not add the entries of the lists element-by-element? In `Python`, lists hold *arbitrary* objects, and are added using *concatenation*. In fact, concatenation is the behavior that we saw earlier when we entered `"hello" + " " + "world"`. This example reflects the fact that `Python` is a general-purpose programming language. Much of `Python`'s data-specific functionality comes from other packages, notably `numpy` and `pandas`. In the next section, we will introduce the `numpy` package. See [docs.scipy.org/doc/numpy/user/quickstart.html](https://docs.scipy.org/doc/numpy/user/quickstart.html) for more information about `numpy`. ## Introduction to Numerical Python As mentioned earlier, this book makes use of functionality that is contained in the `numpy` *library*, or *package*. A package is a collection of modules that are not necessarily included in the base `Python` distribution. The name `numpy` is an abbreviation for *numerical Python*. To access `numpy`, we must first `import` it. ```{python} import numpy as np ``` In the previous line, we named the `numpy` *module* `np`; an abbreviation for easier referencing. In `numpy`, an *array* is a generic term for a multidimensional set of numbers. We use the `np.array()` function to define `x` and `y`, which are one-dimensional arrays, i.e. vectors. ```{python} x = np.array([3, 4, 5]) y = np.array([4, 9, 7]) ``` Note that if you forgot to run the `import numpy as np` command earlier, then you will encounter an error in calling the `np.array()` function in the previous line. The syntax `np.array()` indicates that the function being called is part of the `numpy` package, which we have abbreviated as `np`. Since `x` and `y` have been defined using `np.array()`, we get a sensible result when we add them together. Compare this to our results in the previous section, when we tried to add two lists without using `numpy`. ```{python} x + y ``` In `numpy`, matrices are typically represented as two-dimensional arrays, and vectors as one-dimensional arrays. {While it is also possible to create matrices using `np.matrix()`, we will use `np.array()` throughout the labs in this book.} We can create a two-dimensional array as follows. ```{python} x = np.array([[1, 2], [3, 4]]) x ``` The object `x` has several *attributes*, or associated objects. To access an attribute of `x`, we type `x.attribute`, where we replace `attribute` with the name of the attribute. For instance, we can access the `ndim` attribute of `x` as follows. ```{python} x.ndim ``` The output indicates that `x` is a two-dimensional array. Similarly, `x.dtype` is the *data type* attribute of the object `x`. This indicates that `x` is comprised of 64-bit integers: ```{python} x.dtype ``` Why is `x` comprised of integers? This is because we created `x` by passing in exclusively integers to the `np.array()` function. If we had passed in any decimals, then we would have obtained an array of *floating point numbers* (i.e. real-valued numbers). ```{python} np.array([[1, 2], [3.0, 4]]).dtype ``` Typing `fun?` will cause `Python` to display documentation associated with the function `fun`, if it exists. We can try this for `np.array()`. ```{python} # np.array? ``` This documentation indicates that we could create a floating point array by passing a `dtype` argument into `np.array()`. ```{python} np.array([[1, 2], [3, 4]], float).dtype ``` The array `x` is two-dimensional. We can find out the number of rows and columns by looking at its `shape` attribute. ```{python} x.shape ``` A *method* is a function that is associated with an object. For instance, given an array `x`, the expression `x.sum()` sums all of its elements, using the `sum()` method for arrays. The call `x.sum()` automatically provides `x` as the first argument to its `sum()` method. ```{python} x = np.array([1, 2, 3, 4]) x.sum() ``` We could also sum the elements of `x` by passing in `x` as an argument to the `np.sum()` function. ```{python} x = np.array([1, 2, 3, 4]) np.sum(x) ``` As another example, the `reshape()` method returns a new array with the same elements as `x`, but a different shape. We do this by passing in a `tuple` in our call to `reshape()`, in this case `(2, 3)`. This tuple specifies that we would like to create a two-dimensional array with $2$ rows and $3$ columns. {Like lists, tuples represent a sequence of objects. Why do we need more than one way to create a sequence? There are a few differences between tuples and lists, but perhaps the most important is that elements of a tuple cannot be modified, whereas elements of a list can be.} In what follows, the `\n` character creates a *new line*. ```{python} x = np.array([1, 2, 3, 4, 5, 6]) print('beginning x:\n', x) x_reshape = x.reshape((2, 3)) print('reshaped x:\n', x_reshape) ``` The previous output reveals that `numpy` arrays are specified as a sequence of *rows*. This is called *row-major ordering*, as opposed to *column-major ordering*. `Python` (and hence `numpy`) uses 0-based indexing. This means that to access the top left element of `x_reshape`, we type in `x_reshape[0,0]`. ```{python} x_reshape[0, 0] ``` Similarly, `x_reshape[1,2]` yields the element in the second row and the third column of `x_reshape`. ```{python} x_reshape[1, 2] ``` Similarly, `x[2]` yields the third entry of `x`. Now, let's modify the top left element of `x_reshape`. To our surprise, we discover that the first element of `x` has been modified as well! ```{python} print('x before we modify x_reshape:\n', x) print('x_reshape before we modify x_reshape:\n', x_reshape) x_reshape[0, 0] = 5 print('x_reshape after we modify its top left element:\n', x_reshape) print('x after we modify top left element of x_reshape:\n', x) ``` Modifying `x_reshape` also modified `x` because the two objects occupy the same space in memory. We just saw that we can modify an element of an array. Can we also modify a tuple? It turns out that we cannot --- and trying to do so introduces an *exception*, or error. ```{python} my_tuple = (3, 4, 5) my_tuple[0] = 2 ``` We now briefly mention some attributes of arrays that will come in handy. An array's `shape` attribute contains its dimension; this is always a tuple. The `ndim` attribute yields the number of dimensions, and `T` provides its transpose. ```{python} x_reshape.shape, x_reshape.ndim, x_reshape.T ``` Notice that the three individual outputs `(2,3)`, `2`, and `array([[5, 4],[2, 5], [3,6]])` are themselves output as a tuple. We will often want to apply functions to arrays. For instance, we can compute the square root of the entries using the `np.sqrt()` function: ```{python} np.sqrt(x) ``` We can also square the elements: ```{python} x**2 ``` We can compute the square roots using the same notation, raising to the power of $1/2$ instead of 2. ```{python} x**0.5 ``` Throughout this book, we will often want to generate random data. The `np.random.normal()` function generates a vector of random normal variables. We can learn more about this function by looking at the help page, via a call to `np.random.normal?`. The first line of the help page reads `normal(loc=0.0, scale=1.0, size=None)`. This *signature* line tells us that the function's arguments are `loc`, `scale`, and `size`. These are *keyword* arguments, which means that when they are passed into the function, they can be referred to by name (in any order). {`Python` also uses *positional* arguments. Positional arguments do not need to use a keyword. To see an example, type in `np.sum?`. We see that `a` is a positional argument, i.e. this function assumes that the first unnamed argument that it receives is the array to be summed. By contrast, `axis` and `dtype` are keyword arguments: the position in which these arguments are entered into `np.sum()` does not matter.} By default, this function will generate random normal variable(s) with mean (`loc`) $0$ and standard deviation (`scale`) $1$; furthermore, a single random variable will be generated unless the argument to `size` is changed. We now generate 50 independent random variables from a $N(0,1)$ distribution. ```{python} x = np.random.normal(size=50) x ``` We create an array `y` by adding an independent $N(50,1)$ random variable to each element of `x`. ```{python} y = x + np.random.normal(loc=50, scale=1, size=50) ``` The `np.corrcoef()` function computes the correlation matrix between `x` and `y`. The off-diagonal elements give the correlation between `x` and `y`. ```{python} np.corrcoef(x, y) ``` If you're following along in your own `Jupyter` notebook, then you probably noticed that you got a different set of results when you ran the past few commands. In particular, each time we call `np.random.normal()`, we will get a different answer, as shown in the following example. ```{python} print(np.random.normal(scale=5, size=2)) print(np.random.normal(scale=5, size=2)) ``` In order to ensure that our code provides exactly the same results each time it is run, we can set a *random seed* using the `np.random.default_rng()` function. This function takes an arbitrary, user-specified integer argument. If we set a random seed before generating random data, then re-running our code will yield the same results. The object `rng` has essentially all the random number generating methods found in `np.random`. Hence, to generate normal data we use `rng.normal()`. ```{python} rng = np.random.default_rng(1303) print(rng.normal(scale=5, size=2)) rng2 = np.random.default_rng(1303) print(rng2.normal(scale=5, size=2)) ``` Throughout the labs in this book, we use `np.random.default_rng()` whenever we perform calculations involving random quantities within `numpy`. In principle, this should enable the reader to exactly reproduce the stated results. However, as new versions of `numpy` become available, it is possible that some small discrepancies may occur between the output in the labs and the output from `numpy`. The `np.mean()`, `np.var()`, and `np.std()` functions can be used to compute the mean, variance, and standard deviation of arrays. These functions are also available as methods on the arrays. ```{python} rng = np.random.default_rng(3) y = rng.standard_normal(10) np.mean(y), y.mean() ``` ```{python} np.var(y), y.var(), np.mean((y - y.mean())**2) ``` Notice that by default `np.var()` divides by the sample size $n$ rather than $n-1$; see the `ddof` argument in `np.var?`. ```{python} np.sqrt(np.var(y)), np.std(y) ``` The `np.mean()`, `np.var()`, and `np.std()` functions can also be applied to the rows and columns of a matrix. To see this, we construct a $10 \times 3$ matrix of $N(0,1)$ random variables, and consider computing its row sums. ```{python} X = rng.standard_normal((10, 3)) X ``` Since arrays are row-major ordered, the first axis, i.e. `axis=0`, refers to its rows. We pass this argument into the `mean()` method for the object `X`. ```{python} X.mean(axis=0) ``` The following yields the same result. ```{python} X.mean(0) ``` ## Graphics In `Python`, common practice is to use the library `matplotlib` for graphics. However, since `Python` was not written with data analysis in mind, the notion of plotting is not intrinsic to the language. We will use the `subplots()` function from `matplotlib.pyplot` to create a figure and the axes onto which we plot our data. For many more examples of how to make plots in `Python`, readers are encouraged to visit [matplotlib.org/stable/gallery/](https://matplotlib.org/stable/gallery/index.html). In `matplotlib`, a plot consists of a *figure* and one or more *axes*. You can think of the figure as the blank canvas upon which one or more plots will be displayed: it is the entire plotting window. The *axes* contain important information about each plot, such as its $x$- and $y$-axis labels, title, and more. (Note that in `matplotlib`, the word *axes* is not the plural of *axis*: a plot's *axes* contains much more information than just the $x$-axis and the $y$-axis.) We begin by importing the `subplots()` function from `matplotlib`. We use this function throughout when creating figures. The function returns a tuple of length two: a figure object as well as the relevant axes object. We will typically pass `figsize` as a keyword argument. Having created our axes, we attempt our first plot using its `plot()` method. To learn more about it, type `ax.plot?`. ```{python} from matplotlib.pyplot import subplots fig, ax = subplots(figsize=(8, 8)) x = rng.standard_normal(100) y = rng.standard_normal(100) ax.plot(x, y); ``` We pause here to note that we have *unpacked* the tuple of length two returned by `subplots()` into the two distinct variables `fig` and `ax`. Unpacking is typically preferred to the following equivalent but slightly more verbose code: ```{python} output = subplots(figsize=(8, 8)) fig = output[0] ax = output[1] ``` We see that our earlier cell produced a line plot, which is the default. To create a scatterplot, we provide an additional argument to `ax.plot()`, indicating that circles should be displayed. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.plot(x, y, 'o'); ``` Different values of this additional argument can be used to produce different colored lines as well as different linestyles. As an alternative, we could use the `ax.scatter()` function to create a scatterplot. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.scatter(x, y, marker='o'); ``` Notice that in the code blocks above, we have ended the last line with a semicolon. This prevents `ax.plot(x, y)` from printing text to the notebook. However, it does not prevent a plot from being produced. If we omit the trailing semi-colon, then we obtain the following output: ```{python} fig, ax = subplots(figsize=(8, 8)) ax.scatter(x, y, marker='o') ``` In what follows, we will use trailing semicolons whenever the text that would be output is not germane to the discussion at hand. To label our plot, we make use of the `set_xlabel()`, `set_ylabel()`, and `set_title()` methods of `ax`. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.scatter(x, y, marker='o') ax.set_xlabel("this is the x-axis") ax.set_ylabel("this is the y-axis") ax.set_title("Plot of X vs Y"); ``` Having access to the figure object `fig` itself means that we can go in and change some aspects and then redisplay it. Here, we change the size from `(8, 8)` to `(12, 3)`. ```{python} fig.set_size_inches(12,3) fig ``` Occasionally we will want to create several plots within a figure. This can be achieved by passing additional arguments to `subplots()`. Below, we create a $2 \times 3$ grid of plots in a figure of size determined by the `figsize` argument. In such situations, there is often a relationship between the axes in the plots. For example, all plots may have a common $x$-axis. The `subplots()` function can automatically handle this situation when passed the keyword argument `sharex=True`. The `axes` object below is an array pointing to different plots in the figure. ```{python} fig, axes = subplots(nrows=2, ncols=3, figsize=(15, 5)) ``` We now produce a scatter plot with `'o'` in the second column of the first row and a scatter plot with `'+'` in the third column of the second row. ```{python} axes[0,1].plot(x, y, 'o') axes[1,2].scatter(x, y, marker='+') fig ``` Type `subplots?` to learn more about `subplots()`. To save the output of `fig`, we call its `savefig()` method. The argument `dpi` is the dots per inch, used to determine how large the figure will be in pixels. ```{python} fig.savefig("Figure.png", dpi=400) fig.savefig("Figure.pdf", dpi=200); ``` We can continue to modify `fig` using step-by-step updates; for example, we can modify the range of the $x$-axis, re-save the figure, and even re-display it. ```{python} axes[0,1].set_xlim([-1,1]) fig.savefig("Figure_updated.jpg") fig ``` We now create some more sophisticated plots. The `ax.contour()` method produces a *contour plot* in order to represent three-dimensional data, similar to a topographical map. It takes three arguments: * A vector of `x` values (the first dimension), * A vector of `y` values (the second dimension), and * A matrix whose elements correspond to the `z` value (the third dimension) for each pair of `(x,y)` coordinates. To create `x` and `y`, we’ll use the command `np.linspace(a, b, n)`, which returns a vector of `n` numbers starting at `a` and ending at `b`. ```{python} fig, ax = subplots(figsize=(8, 8)) x = np.linspace(-np.pi, np.pi, 50) y = x f = np.multiply.outer(np.cos(y), 1 / (1 + x**2)) ax.contour(x, y, f); ``` We can increase the resolution by adding more levels to the image. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.contour(x, y, f, levels=45); ``` To fine-tune the output of the `ax.contour()` function, take a look at the help file by typing `?plt.contour`. The `ax.imshow()` method is similar to `ax.contour()`, except that it produces a color-coded plot whose colors depend on the `z` value. This is known as a *heatmap*, and is sometimes used to plot temperature in weather forecasts. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.imshow(f); ``` ## Sequences and Slice Notation As seen above, the function `np.linspace()` can be used to create a sequence of numbers. ```{python} seq1 = np.linspace(0, 10, 11) seq1 ``` The function `np.arange()` returns a sequence of numbers spaced out by `step`. If `step` is not specified, then a default value of $1$ is used. Let's create a sequence that starts at $0$ and ends at $10$. ```{python} seq2 = np.arange(0, 10) seq2 ``` Why isn't $10$ output above? This has to do with *slice* notation in `Python`. Slice notation is used to index sequences such as lists, tuples and arrays. Suppose we want to retrieve the fourth through sixth (inclusive) entries of a string. We obtain a slice of the string using the indexing notation `[3:6]`. ```{python} "hello world"[3:6] ``` In the code block above, the notation `3:6` is shorthand for `slice(3,6)` when used inside `[]`. ```{python} "hello world"[slice(3,6)] ``` You might have expected `slice(3,6)` to output the fourth through seventh characters in the text string (recalling that `Python` begins its indexing at zero), but instead it output the fourth through sixth. This also explains why the earlier `np.arange(0, 10)` command output only the integers from $0$ to $9$. See the documentation `slice?` for useful options in creating slices. ## Indexing Data To begin, we create a two-dimensional `numpy` array. ```{python} A = np.array(np.arange(16)).reshape((4, 4)) A ``` Typing `A[1,2]` retrieves the element corresponding to the second row and third column. (As usual, `Python` indexes from $0.$) ```{python} A[1,2] ``` The first number after the open-bracket symbol `[` refers to the row, and the second number refers to the column. ### Indexing Rows, Columns, and Submatrices To select multiple rows at a time, we can pass in a list specifying our selection. For instance, `[1,3]` will retrieve the second and fourth rows: ```{python} A[[1,3]] ``` To select the first and third columns, we pass in `[0,2]` as the second argument in the square brackets. In this case we need to supply the first argument `:` which selects all rows. ```{python} A[:,[0,2]] ``` Now, suppose that we want to select the submatrix made up of the second and fourth rows as well as the first and third columns. This is where indexing gets slightly tricky. It is natural to try to use lists to retrieve the rows and columns: ```{python} A[[1,3],[0,2]] ``` Oops --- what happened? We got a one-dimensional array of length two identical to ```{python} np.array([A[1,0],A[3,2]]) ``` Similarly, the following code fails to extract the submatrix comprised of the second and fourth rows and the first, third, and fourth columns: ```{python} A[[1,3],[0,2,3]] ``` We can see what has gone wrong here. When supplied with two indexing lists, the `numpy` interpretation is that these provide pairs of $i,j$ indices for a series of entries. That is why the pair of lists must have the same length. However, that was not our intent, since we are looking for a submatrix. One easy way to do this is as follows. We first create a submatrix by subsetting the rows of `A`, and then on the fly we make a further submatrix by subsetting its columns. ```{python} A[[1,3]][:,[0,2]] ``` There are more efficient ways of achieving the same result. The *convenience function* `np.ix_()` allows us to extract a submatrix using lists, by creating an intermediate *mesh* object. ```{python} idx = np.ix_([1,3],[0,2,3]) A[idx] ``` Alternatively, we can subset matrices efficiently using slices. The slice `1:4:2` captures the second and fourth items of a sequence, while the slice `0:3:2` captures the first and third items (the third element in a slice sequence is the step size). ```{python} A[1:4:2,0:3:2] ``` Why are we able to retrieve a submatrix directly using slices but not using lists? Its because they are different `Python` types, and are treated differently by `numpy`. Slices can be used to extract objects from arbitrary sequences, such as strings, lists, and tuples, while the use of lists for indexing is more limited. ### Boolean Indexing In `numpy`, a *Boolean* is a type that equals either `True` or `False` (also represented as $1$ and $0$, respectively). The next line creates a vector of $0$'s, represented as Booleans, of length equal to the first dimension of `A`. ```{python} keep_rows = np.zeros(A.shape[0], bool) keep_rows ``` We now set two of the elements to `True`. ```{python} keep_rows[[1,3]] = True keep_rows ``` Note that the elements of `keep_rows`, when viewed as integers, are the same as the values of `np.array([0,1,0,1])`. Below, we use `==` to verify their equality. When applied to two arrays, the `==` operation is applied elementwise. ```{python} np.all(keep_rows == np.array([0,1,0,1])) ``` (Here, the function `np.all()` has checked whether all entries of an array are `True`. A similar function, `np.any()`, can be used to check whether any entries of an array are `True`.) However, even though `np.array([0,1,0,1])` and `keep_rows` are equal according to `==`, they index different sets of rows! The former retrieves the first, second, first, and second rows of `A`. ```{python} A[np.array([0,1,0,1])] ``` By contrast, `keep_rows` retrieves only the second and fourth rows of `A` --- i.e. the rows for which the Boolean equals `TRUE`. ```{python} A[keep_rows] ``` This example shows that Booleans and integers are treated differently by `numpy`. We again make use of the `np.ix_()` function to create a mesh containing the second and fourth rows, and the first, third, and fourth columns. This time, we apply the function to Booleans, rather than lists. ```{python} keep_cols = np.zeros(A.shape[1], bool) keep_cols[[0, 2, 3]] = True idx_bool = np.ix_(keep_rows, keep_cols) A[idx_bool] ``` We can also mix a list with an array of Booleans in the arguments to `np.ix_()`: ```{python} idx_mixed = np.ix_([1,3], keep_cols) A[idx_mixed] ``` For more details on indexing in `numpy`, readers are referred to the `numpy` tutorial mentioned earlier. ## Loading Data Data sets often contain different types of data, and may have names associated with the rows or columns. For these reasons, they typically are best accommodated using a *data frame*. We can think of a data frame as a sequence of arrays of identical length; these are the columns. Entries in the different arrays can be combined to form a row. The `pandas` library can be used to create and work with data frame objects. ### Reading in a Data Set The first step of most analyses involves importing a data set into `Python`. Before attempting to load a data set, we must make sure that `Python` knows where to find the file containing it. If the file is in the same location as this notebook file, then we are all set. Otherwise, the command `os.chdir()` can be used to *change directory*. (You will need to call `import os` before calling `os.chdir()`.) We will begin by reading in `Auto.csv`, available on the book website. This is a comma-separated file, and can be read in using `pd.read_csv()`: ```{python} import pandas as pd Auto = pd.read_csv('Auto.csv') Auto ``` The book website also has a whitespace-delimited version of this data, called `Auto.data`. This can be read in as follows: ```{python} Auto = pd.read_csv('Auto.data', delim_whitespace=True) ``` Both `Auto.csv` and `Auto.data` are simply text files. Before loading data into `Python`, it is a good idea to view it using a text editor or other software, such as Microsoft Excel. We now take a look at the column of `Auto` corresponding to the variable `horsepower`: ```{python} Auto['horsepower'] ``` We see that the `dtype` of this column is `object`. It turns out that all values of the `horsepower` column were interpreted as strings when reading in the data. We can find out why by looking at the unique values. ```{python} np.unique(Auto['horsepower']) ``` We see the culprit is the value `?`, which is being used to encode missing values. To fix the problem, we must provide `pd.read_csv()` with an argument called `na_values`. Now, each instance of `?` in the file is replaced with the value `np.nan`, which means *not a number*: ```{python} Auto = pd.read_csv('Auto.data', na_values=['?'], delim_whitespace=True) Auto['horsepower'].sum() ``` The `Auto.shape` attribute tells us that the data has 397 observations, or rows, and nine variables, or columns. ```{python} Auto.shape ``` There are various ways to deal with missing data. In this case, since only five of the rows contain missing observations, we choose to use the `Auto.dropna()` method to simply remove these rows. ```{python} Auto_new = Auto.dropna() Auto_new.shape ``` ### Basics of Selecting Rows and Columns We can use `Auto.columns` to check the variable names. ```{python} Auto = Auto_new # overwrite the previous value Auto.columns ``` Accessing the rows and columns of a data frame is similar, but not identical, to accessing the rows and columns of an array. Recall that the first argument to the `[]` method is always applied to the rows of the array. Similarly, passing in a slice to the `[]` method creates a data frame whose *rows* are determined by the slice: ```{python} Auto[:3] ``` Similarly, an array of Booleans can be used to subset the rows: ```{python} idx_80 = Auto['year'] > 80 Auto[idx_80] ``` However, if we pass in a list of strings to the `[]` method, then we obtain a data frame containing the corresponding set of *columns*. ```{python} Auto[['mpg', 'horsepower']] ``` Since we did not specify an *index* column when we loaded our data frame, the rows are labeled using integers 0 to 396. ```{python} Auto.index ``` We can use the `set_index()` method to re-name the rows using the contents of `Auto['name']`. ```{python} Auto_re = Auto.set_index('name') Auto_re ``` ```{python} Auto_re.columns ``` We see that the column `'name'` is no longer there. Now that the index has been set to `name`, we can access rows of the data frame by `name` using the `{loc[]`} method of `Auto`: ```{python} rows = ['amc rebel sst', 'ford torino'] Auto_re.loc[rows] ``` As an alternative to using the index name, we could retrieve the 4th and 5th rows of `Auto` using the `{iloc[]`} method: ```{python} Auto_re.iloc[[3,4]] ``` We can also use it to retrieve the 1st, 3rd and and 4th columns of `Auto_re`: ```{python} Auto_re.iloc[:,[0,2,3]] ``` We can extract the 4th and 5th rows, as well as the 1st, 3rd and 4th columns, using a single call to `iloc[]`: ```{python} Auto_re.iloc[[3,4],[0,2,3]] ``` Index entries need not be unique: there are several cars in the data frame named `ford galaxie 500`. ```{python} Auto_re.loc['ford galaxie 500', ['mpg', 'origin']] ``` ### More on Selecting Rows and Columns Suppose now that we want to create a data frame consisting of the `weight` and `origin` of the subset of cars with `year` greater than 80 --- i.e. those built after 1980. To do this, we first create a Boolean array that indexes the rows. The `loc[]` method allows for Boolean entries as well as strings: ```{python} idx_80 = Auto_re['year'] > 80 Auto_re.loc[idx_80, ['weight', 'origin']] ``` To do this more concisely, we can use an anonymous function called a `lambda`: ```{python} Auto_re.loc[lambda df: df['year'] > 80, ['weight', 'origin']] ``` The `lambda` call creates a function that takes a single argument, here `df`, and returns `df['year']>80`. Since it is created inside the `loc[]` method for the dataframe `Auto_re`, that dataframe will be the argument supplied. As another example of using a `lambda`, suppose that we want all cars built after 1980 that achieve greater than 30 miles per gallon: ```{python} Auto_re.loc[lambda df: (df['year'] > 80) & (df['mpg'] > 30), ['weight', 'origin'] ] ``` The symbol `&` computes an element-wise *and* operation. As another example, suppose that we want to retrieve all `Ford` and `Datsun` cars with `displacement` less than 300. We check whether each `name` entry contains either the string `ford` or `datsun` using the `str.contains()` method of the `index` attribute of of the dataframe: ```{python} Auto_re.loc[lambda df: (df['displacement'] < 300) & (df.index.str.contains('ford') | df.index.str.contains('datsun')), ['weight', 'origin'] ] ``` Here, the symbol `|` computes an element-wise *or* operation. In summary, a powerful set of operations is available to index the rows and columns of data frames. For integer based queries, use the `iloc[]` method. For string and Boolean selections, use the `loc[]` method. For functional queries that filter rows, use the `loc[]` method with a function (typically a `lambda`) in the rows argument. ## For Loops A `for` loop is a standard tool in many languages that repeatedly evaluates some chunk of code while varying different values inside the code. For example, suppose we loop over elements of a list and compute their sum. ```{python} total = 0 for value in [3,2,19]: total += value print('Total is: {0}'.format(total)) ``` The indented code beneath the line with the `for` statement is run for each value in the sequence specified in the `for` statement. The loop ends either when the cell ends or when code is indented at the same level as the original `for` statement. We see that the final line above which prints the total is executed only once after the for loop has terminated. Loops can be nested by additional indentation. ```{python} total = 0 for value in [2,3,19]: for weight in [3, 2, 1]: total += value * weight print('Total is: {0}'.format(total)) ``` Above, we summed over each combination of `value` and `weight`. We also took advantage of the *increment* notation in `Python`: the expression `a += b` is equivalent to `a = a + b`. Besides being a convenient notation, this can save time in computationally heavy tasks in which the intermediate value of `a+b` need not be explicitly created. Perhaps a more common task would be to sum over `(value, weight)` pairs. For instance, to compute the average value of a random variable that takes on possible values 2, 3 or 19 with probability 0.2, 0.3, 0.5 respectively we would compute the weighted sum. Tasks such as this can often be accomplished using the `zip()` function that loops over a sequence of tuples. ```{python} total = 0 for value, weight in zip([2,3,19], [0.2,0.3,0.5]): total += weight * value print('Weighted average is: {0}'.format(total)) ``` ### String Formatting In the code chunk above we also printed a string displaying the total. However, the object `total` is an integer and not a string. Inserting the value of something into a string is a common task, made simple using some of the powerful string formatting tools in `Python`. Many data cleaning tasks involve manipulating and programmatically producing strings. For example we may want to loop over the columns of a data frame and print the percent missing in each column. Let’s create a data frame `D` with columns in which 20% of the entries are missing i.e. set to `np.nan`. We’ll create the values in `D` from a normal distribution with mean 0 and variance 1 using `rng.standard_normal()` and then overwrite some random entries using `rng.choice()`. ```{python} rng = np.random.default_rng(1) A = rng.standard_normal((127, 5)) M = rng.choice([0, np.nan], p=[0.8,0.2], size=A.shape) A += M D = pd.DataFrame(A, columns=['food', 'bar', 'pickle', 'snack', 'popcorn']) D[:3] ``` ```{python} for col in D.columns: template = 'Column "{0}" has {1:.2%} missing values' print(template.format(col, np.isnan(D[col]).mean())) ``` We see that the `template.format()` method expects two arguments `{0}` and `{1:.2%}`, and the latter includes some formatting information. In particular, it specifies that the second argument should be expressed as a percent with two decimal digits. The reference [docs.python.org/3/library/string.html](https://docs.python.org/3/library/string.html) includes many helpful and more complex examples. ## Additional Graphical and Numerical Summaries We can use the `ax.plot()` or `ax.scatter()` functions to display the quantitative variables. However, simply typing the variable names will produce an error message, because `Python` does not know to look in the `Auto` data set for those variables. ```{python} fig, ax = subplots(figsize=(8, 8)) ax.plot(horsepower, mpg, 'o'); ``` We can address this by accessing the columns directly: ```{python} fig, ax = subplots(figsize=(8, 8)) ax.plot(Auto['horsepower'], Auto['mpg'], 'o'); ``` Alternatively, we can use the `plot()` method with the call `Auto.plot()`. Using this method, the variables can be accessed by name. The plot methods of a data frame return a familiar object: an axes. We can use it to update the plot as we did previously: ```{python} ax = Auto.plot.scatter('horsepower', 'mpg') ax.set_title('Horsepower vs. MPG'); ``` If we want to save the figure that contains a given axes, we can find the relevant figure by accessing the `figure` attribute: ```{python} fig = ax.figure fig.savefig('horsepower_mpg.png'); ``` We can further instruct the data frame to plot to a particular axes object. In this case the corresponding `plot()` method will return the modified axes we passed in as an argument. Note that when we request a one-dimensional grid of plots, the object `axes` is similarly one-dimensional. We place our scatter plot in the middle plot of a row of three plots within a figure. ```{python} fig, axes = subplots(ncols=3, figsize=(15, 5)) Auto.plot.scatter('horsepower', 'mpg', ax=axes[1]); ``` Note also that the columns of a data frame can be accessed as attributes: try typing in `Auto.horsepower`. We now consider the `cylinders` variable. Typing in `Auto.cylinders.dtype` reveals that it is being treated as a quantitative variable. However, since there is only a small number of possible values for this variable, we may wish to treat it as qualitative. Below, we replace the `cylinders` column with a categorical version of `Auto.cylinders`. The function `pd.Series()` owes its name to the fact that `pandas` is often used in time series applications. ```{python} Auto.cylinders = pd.Series(Auto.cylinders, dtype='category') Auto.cylinders.dtype ``` Now that `cylinders` is qualitative, we can display it using the `boxplot()` method. ```{python} fig, ax = subplots(figsize=(8, 8)) Auto.boxplot('mpg', by='cylinders', ax=ax); ``` The `hist()` method can be used to plot a *histogram*. ```{python} fig, ax = subplots(figsize=(8, 8)) Auto.hist('mpg', ax=ax); ``` The color of the bars and the number of bins can be changed: ```{python} fig, ax = subplots(figsize=(8, 8)) Auto.hist('mpg', color='red', bins=12, ax=ax); ``` See `Auto.hist?` for more plotting options. We can use the `pd.plotting.scatter_matrix()` function to create a *scatterplot matrix* to visualize all of the pairwise relationships between the columns in a data frame. ```{python} pd.plotting.scatter_matrix(Auto); ``` We can also produce scatterplots for a subset of the variables. ```{python} pd.plotting.scatter_matrix(Auto[['mpg', 'displacement', 'weight']]); ``` The `describe()` method produces a numerical summary of each column in a data frame. ```{python} Auto[['mpg', 'weight']].describe() ``` We can also produce a summary of just a single column. ```{python} Auto['cylinders'].describe() Auto['mpg'].describe() ``` To exit `Jupyter`, select `File / Shut Down`.