Expanding Cell Movement.
CS 177 – Project #1
This assignment is an individual project and should be completed on your own using only your own
personally written code. You will submit one (1) copy of the completed Python program to the
Project 1 assignment on Blackboard. The completed file will include your name, the name of the
project and a description of its functionality and purpose of in the comments header. The file should
be named ”Project-1.py”.
This project will be the foundation of future assignments this semester, so it is important that you
maximize your program’s functionality.
Problem Description: Simulating the Movements of Cells in a Microscope
==============================================================
In 2014 Virginia scientist Eric Betzig won a Nobel Prize for his research in microscope technology.
Since receiving the award, Betzig has improved the technology so that cell functions, growth and
even movements can now be seen in real time while minimizing the damage caused by prior
methods. This allows the direct study of living nerve cells forming synapses in the brain, cells
undergoing mitosis and internal cell functions like protein translation and mitochondrial movements.
Your assignment is to write a Python program that graphically simulates viewing cellular organisms,
as they might be observed using Betzig’s technology. These simulated cells will be shown in a
graphics window (representing the field of view through Betzig’s microscope) and must be
animated, exhibiting behaviors based on the “Project Specifications” below. The simulation will
terminate based on user input (a mouse click) and will include two (2) types of cells, Crete and
Laelaps, (pronounced KREET and LEE-laps).
Crete cells should be represented in this simulation as three (3) small green circles with a radius of
8 pixels. These cells move nonlinearly in steps of 1-4 graphics window pixels. This makes their
movement appear jerky and random. Crete cells cannot move outside the microscope slide, (the
‘field’), so they may bump along the borders or even wander out into the middle of the field at times.
These cells have the ability to pass “through” each other.
A single red circle with a radius of 16 pixels will represent a Laelaps cell in this simulation. Laelaps
cells move across the field straight lines, appearing to ‘bounce’ off the field boundaries. Laelaps
sometimes appear to pass through other cells, however this is an optical illusion as they are very
thin and tend to slide over or under the other cells in the field of view.
Project Specifications:
====================
Graphics Window
• 500 x 500 pixel window
• White background
• 0,0 (x,y) coordinate should be set to the lower left-hand corner
Crete Cells
• Three (3) green filled circles with radius of 8 pixels
• Move in random increments between -4 and 4 pixels per step
• Movements are not in straight lines, but appear wander aimlessly
Laelaps Cells
• One (1) red filled circle with a radius of 16 pixels
• Move more quickly than Crete cells and in straight lines
• The Laelaps cell should advance in either -10 or 10 pixels per step
TODO #1: Initialize the simulation environment
========================================
• Import any libraries needed for the simulation
• Display a welcome message in the Python Shell. Describe the program’s functionality
• Create the 500 x 500 graphics window named “Field”
• Set the Field window parameters as specified
TODO #2: Create the Crete cells – makeCrete()
========================================
• Write a function that creates three green circle objects (radius 8) and stores them in a list
• Each entry of the list represents one Crete cell
• The starting (x, y) locations of the Crete cells will be random values between 50 – 450
• The function should return the list of Crete cells
TODO #3: Create the Laelaps cell – makeLaelaps()
===========================================
• Write a function that creates a list containing a single entry; a red filled circle (radius 16)
representing the Laelaps cell
• The starting (x, y) location of these cells should be random values between 100–400
• Add two randomly selected integers to the list. They should be either -10 or 10
• The function should return the Laelaps cell list
TODO #4: Define the bounce() function
==================================
• Write a function that accepts two (2) integers as parameters
• If the first integer is either less than 10 or greater than 490, the function should return the
inverse value of the 2nd integer, (ie: multiplying it by -1)
• Otherwise, the function should return the 2nd integer unmodified
TODO #5: Define the main() function
==================================
• Using the makeCrete() function, create a list of Crete cells
• Draw the Crete cells in the Field graphics window
• Using the makeLaelaps() function, create the Laelaps list
• Draw the Laelaps cell in the Field window
• Using a while loop, animate the cells in the Field window
o Animate each Crete cell by moving it’s (x,y) position by a number of pixels specified
by a randomly selected integer between -4 and 4
o Animate the Laelaps cell by moving it’s (x,y) position by the number of pixels
specified in the integer values in it’s list (this will always be either -10 or 10 pixels)
o HINT: Use the bounce() function to make sure the change in a cell’s position doesn’t
move the cell outside the Field boundaries
o End the while loop if a mouse click is detected in the Field graphics window
• Close the Field graphics window
• Print a message that the simulation has terminated
Extra Credit Challenges: 10 points each only if TODO #1 – 5 are complete
===============================================================
• CROSSING GUARD: Laelaps cell ‘bounces’ off the Crete cells instead sliding past them
• NO PASSING ZONE: Crete cells bounce off each other instead of passing through
Project 1 Grading Rubric: Points
TODO #1: Libraries imported, message shown, graphics window created to specifications 15
TODO #2: List of three (3) circle objects is created as specified 10
TODO #2: makeCrete() function properly returns list of circle objects 5
TODO #3: List including one circle object and 2 integers is created as specified 10
TODO #3: makeLaelaps() function properly returns list 5
TODO #4: bounce() function created as specified 10
TODO #5: makeCrete() and makeLaelaps() functions called, lists created successfully 10
TODO #5: Crete and LaeLaps cells drawn in the Field window 5
TODO #5: Cells move as specified within the Field window, bouncing off boundaries 20
TODO #5: Animation loop terminates when mouse clicked in the Field window 5
TODO #5: Message is displayed indicating the simulation has terminated 5
Total Points 100
You will submit one (1) copy of the completed Python program to the Project 1 assignment on
Blackboard. The completed file will include your name, the name of the project and a description of
its functionality and purpose of in the comments header. The file should be named ”Project-1.py”.
Coding Standards and Guidelines:
=============================
In this project, you are required to follow modular coding standards, particularly with respect to
modular design, indentation and comments. Your score will be affected if your code does not
conform to these standards.
Modular Design
Divide your program into functions to improve readability and to reduce redundanct code. Your
Python code should not have repetitve copies of the same block of statements. Instead, functions
to simplify and reduce the size of your code.
For example, if you had to find the distance between two x,y coordinate points in several different
parts of your code, instead of creating the formula to calculate this distance over and over again,
create a function “def distance(x1, y1, x2, y2):” and code it to calculate and return the distance
between the point using the Pythagorean Theorum.
Indentation
Following are a few rules on how to use indentation in your program,
• Use tabs for indentations
• Pay attention to indentation in nested for loops and if-else blocks
Comments
Your code for this project must also include appropriate comments about how functions are
implemented. Comments make your code more readable and easier to understand.
• Add a comment before a function describing what it does.
• Before a nested for loop, describe what happens in the loop and what controls the
iterations.
• Before an if-else block, explain what should happen for both the true and false cases.
• Always make a priority of keeping the comments up-to-date when the code changes.
For all variables that you use in your program, use meaningful variable and function names to help
make your program more readable. Names do not have to be long, but should give a clear
indication of the intended purpose of the variable.
CS 177 – Project #2
Summer 2015
Due Date:
==========
This project is due Thursday July 23rd before 11:59pm.
This assignment is an individual project and should be completed on your own using only your own
personally written code. You will submit one (1) copy of the completed Python program to the
Project 2 assignment on Blackboard. The completed file will include your name, the name of the
project and a description of its functionality and purpose of in the comments header. The file should
be named ”Project-2.py”.
This project will continue to be the foundation of future assignments this semester, so it is important
that you maximize your program’s functionality.
Problem Description: Expanding the Cell Movement Simulation
=====================================================
Your first program simulating Betzig’s microscopic technology was a huge hit and you’ve landed a
contract to expand its capabilities. Specifically, you are to modify the behavior of both cell types,
increase their numbers and add a graphical control panel.
Crete Cells should be represented in this expanded simulation by a random number (between 5 –
12) of small green circles with a radius of 8 pixels. These cells will move nonlinearly in steps of up
to 6 pixels at a time, (specifically, each movement should be between -6 and 6 pixels). This will
increase the speed of their movements, however they will still appear jerky and random. Crete cells
cannot move outside the microscope slide, (the ‘field’), so they may bump along the borders or
even wander out into the middle of the field at times. They must bounce off each other and the
Laelaps cells instead of appearing to pass through them.
Laelaps cells should be represented by a random number (between 3 – 6) of larger red circles with
a radius of 16 in this expansion. Laelaps cells move across the field straight lines, appearing to
‘bounce’ off the field boundaries, and all the other cells in the field of view. The dx and dy values for
each Laelaps cell will be randomly chosen from: [-12, -10, -8, 8, 10, or 12] and will change
in direction but not size when animated, only in direction.
The Control Panel should be a separate 300 x 200 graphic window, (see example next page).
Users can view and change the simulation settings by clicking in the labeled areas to:
• Increase / decrease the speed of the simulation
• Pause the simulation
• Increase / decrease the temperature of the microscopic field
• Drop a piece of ‘food’ into a random location on the field
Project Specifications:
====================
The Field Graphics Window #1 (from Project 1)
• 500 x 500 pixel window
• White background
• 0,0 (x,y) coordinate should be set to the lower left-hand corner
The ‘Control Panel’ Graphics Window #2 (new)
• 300 x 200 pixel window
• Gray background organized as follows:
• Actual colors of buttons and text are flexible, but must be easy to see
• The speed and pause buttons must actually modify the simulation in real time
• Food button should drop a 5 x 5 black square of ‘food’ in a random Field location
• The Warmer and Cooler buttons only need to change the Temp value displayed.
Crete Cells (updated from Project 1)
• Random number (between 5-12) of green filled circles with radius of 8 pixels
• Move in random increments between -6 and 6 pixels per step
o Hint: use random.randint(-6, 6)
• Movements are not in straight lines, but appear wander aimlessly
• Bounces off Laelaps cells and other Crete cells — will not pass ‘through’ or over
• Crete cells ignore any ‘food’ in the field
Laelaps Cells (updated from Project 1)
• Random number (between 3-6) of red filled circles with a radius of 16 pixels
• The Laelaps cell should advance in either -12, -10, -8, 8, 10 or 12 pixels per step
o Hint: use random.choice([-12, -10, -8, 8, 10, 12])
• Move more quickly than Crete cells and in straight lines
• Bounces off Crete cells and other Laelaps cells – will not pass ‘through’ or over
• Laelaps cells ignore any ‘food’ in the field
Faster
Slower
Pause Food Warmer
Cooler
Temp
42
Speed
2
TODO #1: Start with your own completed Project 1 Python file
====================================================
• Refer to the Project 1 specifications for details
• You must complete Project 1 before continuing with this assignment
• Your TAs and/or Instructors can help you finish your Project 1 if necessary
TODO #2: Modify the makeCrete() and makeLaelaps() functions
==========================================================
• Change the makeCrete() and makeLaelaps() functions to meet Project 2 specifications
• The makeCrete() and makeLaelaps() functions should accept an integer parameter that
specifies the number of cells to create. They should return the lists of cells.
• The makeLaelaps() function might create a list of lists. This might take the format:
[[laelaps, dx, dy], [laelaps, dx, dy], [laelaps, dx, dy]]
TODO #3: Create the Control Panel
===========================================
• Create a new 300 x 200 graphics window named “Control Panel”
• This should have the appearance shown in the Project 2 specifications above
• The buttons and functionality of the Control Panel should be as specified above
TODO #4: Modify the main() function
==================================
• Using the makeCrete() function, create a list of Crete cells and draw in the Field window
• Using the makeLaelaps() function, create the Laelaps cells and draw in the Field window
• Using a while loop, animate the Crete and Laelaps cells in the Field window
o Animate each Crete cells making sure they bounce off the boundaries of the Field
window and the other Crete cells
o Animate the Laelaps cells making sure they bounce off the Field boundaries, the
other Laelaps cells and Crete cells
o Check for and respond to mouse clicks in the Control Panel graphics window
o End the while loop if a mouse click is detected in the Field graphics window
• Close the Field and Control Panel graphics windows
• Print a message that the simulation has terminated
Extra Credit Challenges: 10 points each only if TODO #1 – 5 are complete
===============================================================
• DINNER TIME: Cells contacting food will increase their radius by 2 pixels, (food disappears)
• HOT IN HERE: Higher temperatures cause Laelaps to move faster, Crete to move slower.
Lower temps would have the opposite effect.
Project 2 Grading Rubric: Points
TODO #1: Simulation meets all Project 1 Specifications 5
TODO #2: Crete cell creation and returned list updated as specified 10
TODO #2: Laelaps cell creation and returned list updated as specified 10
TODO #3: Control Panel: Graphics window created, appears as specified 10
TODO #3: Control Panel: Speed and Pause buttons function as specified 15
TODO #3: Control Panel: Food button functions as specified 10
TODO #3: Control Panel: Warmer and Cooler buttons function as specified 10
TODO #4: main() function uses makeCrete() and makeLaelaps() to create cell lists 5
TODO #5: Cells move as specified within the Field window 15
TODO #5: Animation terminates, windows close when mouse clicked in the Field window 5
TODO #5: Message is displayed indicating the simulation has terminated 5
Total Points 100
You will submit one (1) copy of the completed Python program to the Project 2 assignment on
Blackboard. The completed file will include your name, the name of the project and a description of
its functionality and purpose of in the comments header. The file should be named ”Project-2.py”.
Coding Standards and Guidelines:
=============================
In this project, you are required to follow modular coding standards, particularly with respect to
modular design, indentation and comments. Your score will be affected if your code does not
conform to these standards.
Modular Design
Divide your program into functions to improve readability and to reduce redundanct code. Your
Python code should not have repetitve copies of the same block of statements. Instead, functions
to simplify and reduce the size of your code.
For example, if you had to find the distance between two x,y coordinate points in several different
parts of your code, instead of creating the formula to calculate this distance over and over again,
create a function “def distance(x1, y1, x2, y2):” and code it to calculate and return the distance
between the point using the Pythagorean Theorum.
Indentation
Following are a few rules on how to use indentation in your program,
• Use tabs for indentations
• Pay attention to indentation in nested for loops and if-else blocks
Comments
Your code for this project must also include appropriate comments about how functions are
implemented. Comments make your code more readable and easier to understand.
• Add a comment before a function describing what it does.
• Before a nested for loop, describe what happens in the loop and what controls the
iterations.
• Before an if-else block, explain what should happen for both the true and false cases.
• Always make a priority of keeping the comments up-to-date when the code changes.
For all variables that you use in your program, use meaningful variable and function names to help
make your program more readable. Names do not have to be long, but should give a clear
indication of the intended purpose of the variable.