Lecture 7 — Tuples, Modules, Images¶
Material for this lecture is drawn from Chapter 4 of Practical Programming.
We will first learn a simple data type called tuples which simplify some things (like returning multiple values).
We will then revisit modules, how functions you write can be used in other programs.
Most of the class we will learning how to use a new module for manipulating Images.
We will introduce a new data type - an image - which is much more complex than the other data types we have learned so far
We will study a module called pillow which is specifically designed for this data type
Note: We will NOT use the
mediamodule discussed in the text, opting instead for the more widely-used
PILLOW(Python Imaging Library), comprised of multiple modules.
Class will end with a review for Monday’s Exam 1, so it will be a bit long...
Tuple Data Type¶
A tuple is a simple data type that puts together multiple values as a single unit.
The main advantage is that you can access individual elements in a tuple: first value starts at zero (this “indexing” will turn into a big Computer Science thing!)
>>> x = (4, 5, 10) # note the parentheses >>> print x 4 >>> print x 10 >>> len(x) 3
Actually, tuples and strings are very similar in many ways. We will explore this similarity in class.
>>> s = 'abc' >>> s 'a' >>> s 'b'
Importantly, just as for a string, you cannot change a part of the tuple; you can only change the entire tuple!
>>> x = 2 Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: 'tuple' object does not support item assignment >>> s = 'A' Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: 'str' object does not support item assignment
What are tuples good for?¶
Tuples are Python’s way of making multiple assignments.
>>> 2,3 (2, 3) >>> x = 2,3 >>> x (2, 3) >>> a,b=x >>> a 2 >>> b 3 >>> c,d=3,4
You can write functions that return multiple values.
def split(n): ''' Split a two-digit number into its tens and ones digit ''' tens = n / 10 ones = n % 10 return (tens, ones) x = 83 ten,one = split(x) print "%d has tens digit %d and ones digit %d" %(x,ten,one)
Exercise 1: Finding distance between two points¶
- Write a function that takes as input two tuples representing points: (x,y) and returns the distance between them.
Basics of modules¶
Recall that a module is a collection of Python variables, functions and objects, all stored in a file
Modules allow code to be shared across many different programs.
Before we can use a module, we need to import it:
>>> import module_name >>> module_name.function()
We will see an example class of using code that we have written as a module in another program.
PIL/PILLOW — Python Image Library¶
PILLOW is a series of modules built around the
Imagetype, our first object type that is not part of the main Python language
- We have to tell Python about this type through
- We have to tell Python about this type through
We will use images as a continuing example of what can be done in programming beyond numbers and beyond text.
for more details.
An image is a two-dimensional matrix of pixel values
The origin is in the upper left corner, see below:
Pixel values stored in an image can be:
- RGB — a “three-tuple” consisting of the red, green and blue values, all non-negative integers
- L — a single “gray-scale” integer value representing the brightness of each pixel
Some basic colors:
Color (red,green,blue) value Black (0,0,0) Red (255,0,0) Green (0,255,0) Blue (0,0,255) White (255,255,255) Light Gray (122,122,122)
Some important image modules¶
- Image module contains main functions to manipulate images: open, save, resize, crop, paste, create new images, change pixels, etc.
- ImageDraw module contains functions to touch up images by adding text to it, draw ellipses, rectangles, etc.
- ImageFont contains functions to create images of text for a specific font.
- We will only use the Image module in this lecture.
Image Type and Methods¶
Let us now see some very useful image methods
im = Image.open(filename)reads an image with the given filename
and returns an image object (which we are storing in the variable
im). It assumes the file is stored in the same directory as your script.
im.show()displays the image
im.save(filename)saves the image to the given file
Images are complex objects. They have associated properties that you can print or use:
>>> im = Image.open('swarm1.jpg') >>> im.size (600, 800) >>> im.format 'JPEG' >>> im.mode 'RGB' >>> im.show()
You can see that
im.modeare strings, while
im.sizeis a tuple.
You can create an empty new image with given dimensions using:
>>> im5 = Image.new('RGB', (200,200)) >>> im5.show()
You can also create a new image by cropping a part of a given image:
which will crop a box from upper left corner (w1, h1) to lower right corner (w2,h2). You can see that the box is entered as a tuple. Try this:
>>> im2 = im.crop((100,100,300,400)) >>> im2.show() >>> im.show()
You can resize an image and get a new image. The new size must be given as a tuple:
>>> im3 = im.resize((300,200)) >>> im3.save('resized.jpg')
im.convert(mode)changes the mode of an image (
'L'is black and white)
>>> im4 = im.convert('L') >>> im4.show()
Our First Image Program¶
from PIL import Image filename = "chipmunk.jpg" im = Image.open(filename) print '\n' '********************' print "Here's the information about", filename print im.format, im.size, im.mode gray_im = im.convert('L') scaled = gray_im.resize( (128,128) ) print "After converting to gray scale and resizing," print "the image information has changed to" print scaled.format, scaled.size, scaled.mode scaled.show() scaled.save(filename + "_scaled.jpg")
Something new, functions that change an image¶
All functions we have seen so far return a new result, but never change the object that they apply to.
We will see that this is not true for more complex objects, mostly for efficiency reason.
You just have to remember how each function works. For now, images are the only objects with this property.
Here is our first function with this property:
im.paste(im2, (x,y))pastes one image (
im2) into the first image (
im1) starting at the top left coordinates
Note that the second image must fit in the first image starting with these coordinates.
How we call such a function is different:
>>> im1 = Image.open('sheep.jpg') >>> im1.size (600, 396) >>> im = Image.new('RGB', (600, 396*2)) >>> im.paste( im1, (0,0)) >>> im.show() >>> im.paste( im1, (0, 396)) >>> im.show()
The fact that the function
pastechanges an image is an implementation decision made by the designers of PIL, mostly because images are so large and copying is therefore time consuming.
Later in the semester, we will learn how to write such functions.
Example 2: Cut and pasting parts of an image¶
This example crops three boxes from an image, creates a new image and pastes the boxes at different locations of this new image.
from PIL import Image im = Image.open("lego_movie.jpg") w,h = im.size ## Crop out three columns from the image ## Note: the crop function returns a new image part1 = im.crop((0,0,w/3,h)) part2 = im.crop((w/3,0,2*w/3,h)) part3 = im.crop((2*w/3,0,w,h)) ## Create a new image newim = Image.new("RGB",(w,h)) ## Paste the image in different order ## Note: the paste function changes the image it is applied to newim.paste(part3, (0,0)) newim.paste(part1, (w/3,0)) newim.paste(part2, (2*w/3,0)) newim.show()
- Tuples are similar to strings and numbers in many ways. You cannot change a part of a tuple. However, unlike other simple data types, tuples allow access to the individual components using the list notation.
- Modules contain a combination of functions, variables, object definitions, and other code, all designed for use in other Python programs and modules
PILLOWprovides a set of modules that define the
Imageobject type and associated methods.
Reviewing for the exam: topics and ideas¶
Here are crucial topics to before the exam.
Syntax: can you find syntax errors in code?
Correct variable names, assigning a value to a variable
Output: can you compute the output of a piece of code?
Expressions: operator precedence
The distinction between integer and float division
The distinction between division (4/5) and modulo (4%5) operators, and how they work for positive and negative numbers
Functions: defining functions and using them
Distinguish between variables local to functions and variables that are global
Modules: how to import and call functions that are from a specific module (
mathis the only one we learned so far)
How to access variable values defined in a module (see
Strings: how to create them, how to escape characters, multi-line strings
How to use
raw_input(): remember it always returns a string
Boolean data type: distinguish between expressions that return integer/float/string/Boolean
Remember the distinction between
Boolean value of conditions involving AND/OR/NOT
IF/ELIF/ELSE statements, how to write them. Understand what parts are optional and how they work
Creating, indexing and using tuples
Remember the same function may work differently and do different things when applied to a different data type
Review all about the different ways to call the print function for multiple line of input
name = 'Eric Cartman' age = 8 location = 'South Park' print "Option 1: Student name:", name, 'lives at:', location print "Student age:", age print print "Option 2: Student name:", name, 'lives at:', location, "\nStudent age:", age print print "Option 3: Student name: %s lives at: %s Student age: %d" %(name, location, age) print Try and see whether you can predict the output.
+(concatenation and addition),
*(replication and multiplication),
Functions applied to string objects using the dot notation, where
stringis an actual string, such as
"car"or the name of a string variable:
Distinguish between the different types of functions we have learned in this class:
- Functions that take one or more values as input and return something (input objects/values are not modified)>>> min(3,2,1) 1 >>> mystr = 'Monty Python' >>> len(mystr) 12
- Functions that take one or more values as input and return nothing (input objects/values are not modified)>>> def print_max(val1, val2): ... print "Maximum value is", max(val1, val2) ... >>> x1 = 10 >>> x2 = 15 >>> print_max(x1, x2) Maximum value is 15
- Functions that apply to an object, like a string, and return a value (but not modify the object that they apply to)>>> mystr = 'Monty Python' >>> mystr.replace('o','x') 'Mxnty Pythxn' >>> mystr 'Monty Python' >>> mystr.upper() 'MONTY PYTHON' >>> mystr 'Monty Python'
- Functions that apply to an object, like an
Imageand modify it (but not return anything), we only learn
Image.pasteso far.>>> im.paste( im2, (0,0) )
- Local vs. global variables: Can you tell what each of the print statements print and explain why?
def f1(x,y): return x+y def f2(x): return x+y x = 5 y = 10 print 'A:', f1(x,y) print 'B:', f1(y,x) print 'C:', f2(x) print 'D:', f2(y) print 'E:', f1(x)
Reviewing for the exam: problem solving¶
In the remaining time we will go through several practice questions to demonstrate how we approach these problems. While our immediate concern is the exam, you will be developing your problem solving skills and programming abilities. Most of these questions have appeared on previous exams in CS 1.
- What is the exact output of the following Python code? What are the global variables, the function arguments, the local variables, and the parameters in the code?
x=3 def do_something(x, y): z=x+y print z z += z print z z += z * z print z do_something(1,1) y=1 do_something(y,x)
- Write a Python function that takes two strings as input and prints them together on one 35-character line, with the first string left-justified, the second string right-justified, and as many periods between the words as needed. For example, the function calls
print_left_right( 'apple', 'banana') print_left_right( 'syntax error', 'semantic error')
should outputapple........................banana syntax error.........semantic error
You may assume that the lengths of the two strings passed as arguments together are less than 35 characters.
- In the United States, a car’s fuel efficiency is measured in miles driven per gallon used. In the metric system it is liters used per 100 kilometers driven. Using the values 1.609 kilometers equals 1 mile and 1 gallon equals 3.785 liters, write a Python function that converts a fuel efficiency measure in miles per gallon to one in liters per 100 kilometers and returns the result.
- Write a program that reads Erin’s height (in cm), Erin’s age (years), Dale’s height (in cm) and Dale’s age (years) and tells the name of the person who is both older and taller or tells that neither is both older and taller.