Skip to main content

CS1 Python Subgoals

Section 11.11 Worked Example: Lists - Average

Subgoals for Evaluating Lists.

  1. Declaring and initializing a list
    1. Set up a one dimensional table (i.e., one row) with 0 to size - 1 elements.
    2. Upon instantiation of a list, all elements contain values from the initializer list (i.e., the list of values inside the square brackets). If no initializer list is provided, the list is empty.
  2. Determining access, slicing, changing, adding, or whole list actions.
    1. Determine the list name and the action to be performed.
    2. If the list is on the left hand side of an assignment statement WITHOUT square brackets, it is a Whole List Action for List Assignment.
    3. If the list is on the left hand side of an assignment statement WITH square brackets, it is a Changing value of a List Element.
    4. If the append or insert method is being used on an instance of a list, it is an Adding a Value to a List Element.
    5. If the list is an expression WITHOUT square brackets, it is a Whole List Action for Passing a List as an Argument.
    6. If the list is an expression WITH square brackets, then check if there is a colon in the square brackets. If there is a colon inside of the square brackets, it is a Slicing Multiple Values from a List. Otherwise, it is an Accessing List Element.
  3. Accessing list element
    1. Determine value of index for element to be accessed; a positive value if counting from the beginning, or a negative value if counting from the end.
    2. listName[index] returns value stored at that index.
    3. Index must be between 0 and len(listName)-1, inclusive, or a negative value; otherwise an IndexError exception occurs at runtime.
  4. Slicing multiple values from a list
    1. Determine the range of indexes for the elements to be sliced
    2. listName[startIndex:endIndex] returns a new list containing the elements from startIndex to endIndex-1 (inclusive)
    3. Negative numbers can be used for startIndex and endIndex to count from the end of the list
    4. Omitting startIndex starts from the beginning of the list, and omitting endIndex goes to the end of the list
  5. Changing value of a list element
    1. Evaluate expression within [] brackets to determine the index of the element to be changed, and the list to change.
      Determine value of index for element to be changed; a positive value if counting from the beginning, or a negative value if counting from the end.
    2. Determine the expression of RHS (right-hand side) of the assignment statement.
    3. The lists’ value is now changed to match the value calculated from the RHS of the assignment statement.
  6. Adding a value to a list element
    1. Check whether the append or insert method is being used. Note that either way you do not use an assignment statement, it is just a method call.
    2. If append is used, the new value is added to the end of the list.
    3. If adding a value elsewhere in the list, use the insert method to add the new value at the specified index. Existing values starting from that index are shifted to the right.
  7. Traversing a List
    1. Determine the list that is being iterated over. If the expression also involves a range(len(list_name)), then the list is being traversed by index. The range function can either take one argument (the length of the list) or 3 arguments (the starting index, ending index, and step size). If the range function takes one argument, it will start at 0 and go to the length of the list - 1. If the range function takes 3 arguments, it will start at the first argument and go to the second argument - 1, incrementing by the third argument. Otherwise, if range is not used, then the list is being traversed by value.
    2. Determine the loop control variable that is being used to iterate over the list. The loop control variable will take on each value or index in the list, one at a time, depending on whether we are iterating by value or by index.
    3. The loop control variable is used to access the list element in the body of the loop. If iterating by index, the loop control variable is used as an index to access or update the list element. If iterating by value, the loop control variable is used directly to access the list element (no updates are possible).
    4. The list can also be added to with the append or insert methods. The append method adds a new value to the end of the list, while the insert method adds a new value at the specified index. Existing values starting from that index are shifted to the right.
  8. Whole list actions
    1. Passing a list as an argument
      1. Determine that the entire list must be passed as an argument to a method by consulting documentation.
      2. When calling a function, put variable name that represents the list as an argument in the method call. Remember that when passing a list as an argument that changes made by the function to the list are persistent. The list itself is not copied, so the function does not have its own copy of the list. However, the one exception to this is if you assign the argument to reference a different list in memory; then you will no longer be modifying the original list.
    2. List Assignment
      1. Determine that the reference to the list needs to be changed, not just its contents.
      2. The LHS of the assignment is the list reference needing to be changed.
      3. The RHS of the assignment is the new list reference.
🔗

Subsection 11.11.1

Problem: Assume that the integer list alpha has been properly declared and initialized with non-zero values. What does this code accomplish?
🔗
sum = 0
avg = 0.0
for value in alpha:
    sum += value
if len(alpha) != 0:
    avg = sum / len(alpha)
🔗

Subsection 11.11.2 SG1: Declaring and initialization of list

There is no explicit declaration or initialization of a list within the code. However, the instructions describe that the list alpha has been properly initialized with non-zero values.
🔗
This figure shows a table with 6 columns and 2 rows. The top row is labeled with the indexes of the list, and the bottom row is labeled with the values of the list, which are currently blank. The first index is 0, and the last index is size-1.
Figure 11.11.1.
🔗
  • alpha is a list of integers and has values, but we don’t know what those values are
  • However, we can still diagram a representation of this list.
🔗
🔗

Subsection 11.11.3 SG2: Determine access or action

Within the loop, we are accessing list elements.
🔗
🔗

Subsection 11.11.4 Evaluating code 

sum = 0
avg = 0.0
The first two lines are declaring two variables, an integer to hold the sum of all the values in the list and a double to hold the average of the values.
🔗
References to the list are in the loop and selection statements. First, let’s look at the loop:
🔗
for value in alpha:
    sum += value
  • This loop has a loop control variable value that is assigned the value of the list element at index i. The first iteration of the loop assigns the value of the first element in the list to value, and so on.
  • In each iteration of the loop, the variable value is added to the sum of all previous values in the list. The loop continues until all elements in the list have been accessed.
🔗
This is the same loop from the Section 11.9 example.
🔗
if len(alpha) != 0:
    avg = sum / len(alpha)
  • If the size of the list is not 0, then it is divided by the number of values in alpha.
🔗
Let us trace with a sample list.
🔗
This figure shows a table with 6 columns and 2 rows. The top row is labeled with the indexes of the list, and the bottom row is labeled with the values of the list. The first index is 0, and the last index is size-1. The values row is now populated with the values 12, 22, 8, 15, 2.
Figure 11.11.2.
🔗
First, sum and avg are both initialized to zero values, and then a for-loop is used to traverse the list to calculate the sum. The chart below uses one line to represent the memory and calculations during each iteration of the loop, starting when i has a value of zero.
🔗
Table 11.11.3. Example Trace of Average
index value sum
0 12 12
1 22 34
2 8 42
3 15 57
4 3 60
🔗
Next we look at the selection statement:
🔗
if len(alpha) != 0:
    avg = sum / len(alpha)
In our sample, len(alpha) is 5, and 60 divided by 5 is 12, for a final value of 12 in avg.
🔗
Why have the selection statement? What if the list has been declared, but has no values? Then its size is 0 – and we would be dividing by 0! An exception! So we guard against this by checking the length.
🔗
What does this code accomplish?
🔗
Answer.
avg contains the average of the values in the list alpha or 0 if alpha is empty.
🔗

Subsection 11.11.5 Practice Pages

🔗
You have attempted 1 of 1 activities on this page.
🔗
PrevTopNext