Goals

After the lab, you should be proficient at

  1. adapting "basic" binary search for use in another algorithm
  2. creating and processing 2D lists

Review

Review the slides for today.

Objective: Set up

  1. Run runHelpClient
  2. Copy the entire directory /csdept/courses/cs111/handouts/lab11 into your cs111 directory.
  3. Copy the Python files (although not the entire directory) from your lab10 directory into the lab11 directory so that you can extend your InstaFace application in this lab.
  4. If you haven't completed the Lab 10 social network program and you don't expect to finish it, you can use my solution, which is in the lab10_solution subdirectory of the lab11 directory you copied. You can also compare your solution to mine.

    Objective: How Much Code Have I Written? (8 pts)

    You've been writing code for 11 weeks (or so), and the programs have gotten larger. Last week's lab was the largest yet. In the grand scheme of programming, this code is still relatively small, but it's not small to you!

    1. From your lab11 directory in the terminal, execute the command:
      wc ../lab10/*.py

      wc stands for "Word Count". We called the "word count" command on all the *.py files (i.e., the Python scripts, not other files or directories) in your lab10 directory. The first column of output is the number of lines, the second is the number of words, and the third is the number of characters in each file. The total for all the files is listed in the last line of output.

      For example: 

        170   588  5087 ../lab10/instaface.py
  112   284  2747 ../lab10/person.py
  282   799  8534 ../lab10/social.py
   17    62   574 ../lab10/test.py
  581  1733 16942 total
    2. Run the wc command so that you only see the number of lines, using the command-line argument "-l", i.e.,
      wc -l ../lab10/*.py

      3. Note that the number of lines does not distinguish between lines of codes and lines of comments.

    3. Finally, write the output of the command into a file, using the > operator, i.e.,
      wc -l ../lab10/*.py > mywc10.txt
    4. View the output of the command that was saved in the mywc10.txt file, using the Unix commands more, e.g., more mywc10.txt, or cat, e.g., cat mywc10.txt or opening the file in a text editor.
    5. Next, look at all the code you've written throughout the semester. Run the command wc -l ../*/*.py. Then save it to a file: wc -l ../*/*.py > mywc.txt This is an overestimate because it likely contains code you didn't write (e.g., graphics.py and test.py plus it includes comments, but it gives you some idea of what you've done throughout the semester.
    6. In comments near the top of social.py (after the high-level comments), reflect on the amount of code you wrote for the last lab and for written the semester.

    Objective: Programming in Python

    Adding Search Functionality to InstaFace (48 pts)

    As discussed in class, you will update your InstaFace to find a person with a certain name. For improved usability, it shouldn't matter if the user capitalizes the name appropriately. We also need to make a few changes to the original binary search function so that it can be turned into a method of the SocialNetwork class.

    As before, for each of the classes, you should save an output file with the tests you ran.

    Add __lt__(self, other) method to Person class (12)

    If we implement the __lt__ method, we can compare two Person objects using <. (What do you think __lt__ stands for?) If __lt__ is implemented, then list's sort method will use __lt__ to order the Person objects, by default. By implementing __lt__, we don't need to use the key parameter in sort. 

        def __lt__(self, other):
        """
        Takes as a parameter a Person object named other.
        Returns True if this person's name, lowercased, comes before
        the other person's name, lowercased, alphabetically.
        Otherwise, returns False.
        """
    1. Implement the above method in the Person class.
    2. Test the method by comparing two Person objects, for example: 
        print(person1 < person2)
  print(person2 < person1)
  test.testEqual(person1 < person2, True)
  test.testEqual(person2 < person1, False)

      The above print statements should print either True or False.

      Consider what are good test cases for the given functionality.

    3. Then, create a list of Person objects and make sure that sorting the list of Person objects does what is expected.

    Searching for a Person with the given name (26)

    Add a search method to the SocialNetwork class. The method will take as a parameter the name to search for and returns a person who has that name.

      def searchForPerson(self, name):
      """
      Search for the person with the given name (a string) in the social network.
      Returns a Person with this name, ignoring case, or None if no person with this
      name exists in the social network.
      """

    Note, unlike the function we wrote in class, the method does not take as a parameter the list of Person objects. Where should that list of Person objects come from?

    Your method should leverage binary search to find a person that has the given name. Recall: What does binary search require of the list it searches?

    For better usability, the search shouldn't care whether the name is capitalized correctly. Therefore, you should lowercase the given name to search for to get the most intuitive results. (Save the result in a variable so you don't have to keep performing these operations on the name.)


    5. If the given key is lowercased, what should you do to the Person's name?

    Start by searching for a name on a small number of users. Your "final" test should use data/large.txt, which has 50 users in it, or some other similarly large set of people (perhaps that you created).

    What are good test cases for this method? Note that we now have two different ways to search the social network--by name or by id. You can use each to check the other, i.e., you can check the Person you found by id is the same as the Person you found when you look them up by name.

    The user interface will be responsible for printing out the person with that name or printing out a message if no one matches.

    We've been programming for 11 weeks now. Do what you can to help you visualize what is happening--draw pictures, print out variables. Use small datasets instead of trying to work on a large set. Name variables by their data types so you remember what you're working with. Review/execute related examples to make sure you understand what they did.

    Adding Options to your InstaFace User Interface Program (12 pts)

    Add an option that allows the user to search for a person with a given name.

    Example Run: 

    ID      Name                      Num Friends
---------------------------------------------
astley  Rick Astley                         1
doej    Jane Doe                            2
ht8     Henry VIII                          2
schmoj  Joe Schmo                           1


Select one of the following options:
        (D)isplay the social network
        (V)iew a person in the social network
        (S)earch for people in the social network
        Add (P)eople to the social network from a file
        Add (C)onnections to the social network from a file
        Add a (U)ser to the social network
        Add a pair of (F)riends to the social network
        E(X)port the social network
        (Q)uit the program

Which option do you want? s
What is the name of the person you want to find? jane DOE

Jane Doe (id: doej) has 2 friends


Which option do you want? s

What is the name of the person you want to find? Jane
No person named Jane found.

    Demonstrate InstaFace

    Demonstrate that your program works in IDLE (just the new functionality: searching) and save the output in an appropriately named ".out" file.

    You must demonstrate the search functionality on a larger data set. How can you add more people to your social network easily?

    Working with 2D Lists (42)

    For each of the following problems, create a new Python script, named using our usual naming.

    After you've developed a correct solution to each program, restart IDLE or close and reopen the IDLE "shell" by running the program again (using F5), demonstrate that the program works using several good test cases, and save the output to a file named lab11.x.out, where x is the problem number.

    1. (10 pts) Create a 2D list that looks like: 
      [ [0,1,2], [1,3,5], [2,5,8] ]

      To make each row, you can either use the range function or append to a list, but do not create the list by typing twod=[ [0,1,2], [1,3,5], [2,5,8] ]

      Print out the list--as a list--each time you add a row. Do not worry about formatting yet. (See the next problem.)

    2. (16 pts) Copy the previous program for this program. Add a function that takes a two-dimensional, rectangular list as a parameter and prints that list so that it looks like the below format. You can assume that the numbers in the list are all single digits.)

      Test on the list you created in the last program, as well as several different 2-d lists, all in one execution of the program. What would make good tests? (Note that you can't test display functions programmatically.) 

      0 1 2
1 3 5
2 5 8
    3. (16 pts)
      1. Open up connectfour.py that you copied earlier and look at the ConnectFour class.

        Familiarize yourself with its attributes and how other methods are implemented. Investing your time in understanding the existing code will result in faster implementation of the solution. What is the data for this class? How do the (fully implemented) methods manipulate this data?

      2. Uncomment the makeMove method and its docstring comment and implement the method. Make sure the indentation is correct. Adhere to the method's comment description when implementing the method.
      3. Uncomment the code in the play method, as described in the code. Run connectfour.py to test your game.

        4. You should only have to modify connectfour.py--not csplot.py.

      You have to hit Control-C in the terminal to kill the game. Attempting to close the window does not work in IDLE.

      You won't submit any output from this program.

    Extra Credit: Searching (up to 8 points)

    The search functionality is pretty limited -- it only finds one person with the matching name.

    Modify the binary search to find all the people with a certain name. If you search for "Jane Smith", there is probably more than one person with that name. Modify your search so that it returns a list of Person objects, rather than just one of the possible people. Where will the other people with that same name be with respect to the person you found using binary search? What should your method return if there is no Person with that name? To test this method, you will need to update the data files or somehow include multiple people with the same name.

    You should demo this functionality. Update any dependent code to make sure that making this change doesn't break it.

    Extra Credit: ConnectFour

    Implement the _isDraw (up to 4 pts) or_isWon methods (up to 10 pts) of the ConnectFour class. You can receive partial credit.

    Alternatively, you can improve the _computerMakeMove method that chooses the "best" column to place the checker (up to 10 pts). A naive first approach (which is currently implemented) is to randomly pick a column. A more sophisticated approach is to assign a score to each column that says how "good" a column is for you and select the column with the highest score. What properties would make the column's score increase?

    Finishing up: What to turn in for this lab

    1. Move csplot.py into the parent directory. (This is a large file that you don't want to print out.)

      2. Note that each command links to a page with more information about using the command.

    2. Create the printable lab assignment, using the createPrintableLab command:
      createPrintableLab <labdirname>
    3. View your file using the evince command.
    4. Submit your lab directory into your turnin directory.
    5. Log out of your machine when you are done.

    Labs are due before the beginning of Friday's class.

    Ask well before the deadline if you need help turning in your assignment!

    Grading (100 pts)