In this project, you will practice using functions to make scenes with more hierarchical complexity. So far, you have made scenes as collections of compound shapes, which are collections of simple shapes. Now you will take this one step further and create a scene within a scene that will incorporate miniature versions of your previous scenes in it, inspired by the Surrealist Art Movement.

The goals of this project are:

• Encapsulation: making each shape and scene function work as independent units that you can re-use at any time.
• Use conditionals randomness to add nuance to your scenes.
• Use keyword parameters to add extra structure.
• Use best practices for code organization.

Extension points are awarded for complex scenes, especially those that show me that you can integrate concepts from lecture into making your scenes and take things to the next level!

---

Tasks

• Project 3: Scenes within scenes
  • Tasks
    • 1. Create better_shapelib.py
    • 2. Make a Mondrian "scene"
      • 2a. Make a mondrian function
      • 2b. Add position and scale parameters to mondrian
    • 3. Create Margritte "scene"
      • 3a. Include at least 2 simple shapes from Project 2 in better_shapelib.py and update them
      • 3b. Create a new compound shape for better_shapelib.py
      • 3c. Update Mondrian to randomly draw your new compound shape everywhere
      • 3d. Incorporate the new randomly placed objects into last week's scene
    • 4. Create a Surrealist "scene"
    • 4a. Update your scene from Project 2 in better_shapelib.py
    • 4b. Update and test drawing last week's scene at multiple positions and scales
  • Check reproducibility
  • Extensions
  • Submission checklist
    

1. Create better_shapelib.py

Import turtle and random. Copy-and-paste in your goto and rectangle functions from lab.

2. Make a Mondrian "scene"

2a. Make a mondrian function

Copy-and-paste your main function from lab into better_shapelib.py. Rename it mondrian.

Add an keyword argument named numRectangles that has some default value. The function signature so far should be:

def mondrian(numRectangles=<int of your choice>):
  '''Fill me in'''

Test out your mondrian function to make sure that it works. This should be done by adding the following to the bottom of better_shapelib.py:

if __name__== '__main__':
  mondrian()

Notes:

• Modify this main code to call exitonclick and probably turtle.tracer(False) (remember: if you turn animations off, call turtle.update() before exitonclick to make sure the canvas shows all your shapes).
• Every time that you develop a new shape and/or scene in this project, you should test them out in main code like this and running better_shapelib.py to make sure they work.
  Do NOT wait until the end of the project to test your code! Test as you go!
• For mondrian (and all other files and functions), follow the code organization best practices (e.g. make docstrings, use inline comments, etc.). This will affect your grade!

2b. Add position and scale parameters to mondrian

Imagine that the Mondrian that is drawn by your mondrian function is "a compound shape". Add required position and scale parameters. Make the position parameters adjust where on the canvas the Mondrian is drawn and the scale parameter adjust its size.

def mondrian(x, y, s, numRectangles=<int of your choice>):
  '''Fill me in'''

Write a mondrian_test function which draws your mondrian function a few times in different positions at different scales. You should get something that looks like this:

Take a screenshot. This is Required Image 1 to be included in your project report. Do NOT delete your mondrian or mondrian_test function, they are part of your project grade.

Hint: It might help to think of the random positions of the Mondrian rectangles as offsets from the (x, y) that you pass into the mondrian function.

3. Create Margritte "scene"

3a. Include at least 2 simple shapes from Project 2 in better_shapelib.py and update them

Think ahead: you will be creating a scene where an out of place object will be repeated all over last week's scene. You will want to pick shapes that are needed to draw your new object. Look at artwork from the Surrealist Art Movement to see examples of incongruent repetition like Golconda or Les valeurs personnelles by René Magritte.

Things to do for each simple shape function you paste into better_shapelib.py:

• Make sure that you use loops where ever possible. The goal is to make your code as efficient as possible in terms of the number of lines of code and the simplicity of that code. None of your functions should have lots of repetitive code!
• Add a fill keyword argument and integrate it into your function, include a default value.
• Add a color keyword argument and integrate it into your function, include a default value.
• Remember: test each function one-by-one as you go.

3b. Create a new compound shape for better_shapelib.py

It should rely on the simple shapes from above.

• Make sure that you use loops where ever possible.
• Add x and y keyword arguments and integrate them into your function to control the position the compound shape is placed.
• Add a s keyword argument and integrate it into your function to control the scale of the compound shape.
• Add a fill keyword argument and integrate it into your function.
• Add a color keyword argument (maybe more if you need to control more than one color) and integrate it into your function.

3c. Create a magritte function to randomly draw your new compound shape everywhere

• Create a copy of your mondrian function and rename it magritte.
• Replace the rectangle function call with a call to your new compound shape.
• Add at least one element of randomness when drawing your compound shapes (it doesn't need to be fancy). For example, only fill the shape 50% of the time, or pick between a couple of colors.

• Test out drawing your "Magritte" image a few times in different positions at different scales. Write a magritte_test function which draws your magritte function a few times in different positions at different scales.

Take a screenshot of the image your magritte_test produces. This is Required Image 2 to be included in your project report.

3d. Incorporate the new randomly placed objects into last week's scene

Choose an artist or artwork from the Surrealist Art Movement for inspiration. For example, can you use this task to create a scene within a scene with disjointed or conflicting concepts?

• Copy over your scene1 function from Project 2.
• Copy only the dependent functions from shapelib.py to better_shapelib.py that haven't been copied over yet.
• Modify the scene1 function to call the local functions, making any necessary updates to parameters.
• Update the scene1 function to call the magritte function. Set the position and size parameters so that it only covers a portion of the scene.

Call only the scene1 function in main code — i.e. indented in if __name__== '__main__':. Run your code and take a screenshot. This is Required Image 3 to be included in your project report.

4. Create a Surrealist "scene"

4a. Update your scene from Project 2 in better_shapelib.py

def scene1(x, y, s):
  '''docstring'''
  # your code here

Make it so that your function uses the scale s and position (x, y) parameters like usual.

Reminders:

• Position one of your scene's shapes at (x, y), convert the remaining hard-coded positions into offsets from (x, y).
• Scale offsets and lengths/distances, NOT positions.
• Leave angles alone (e.g. don't change commands like turtle.left(30)).
• Commands that move the turtle count as lengths/distances turtle.forward(100) $\rightarrow$ turtle.forward(s*100)

4b. Update and test drawing last week's scene at multiple positions and scales

In sureal.py, import your better shape library. You probably want to rename the import to save you typing:

import better_shapelib as bsl

Create a function called sureal in sureal.py that draws your scene1 scene at least 3 times in different locations at different sizes.

Call your sureal function in main code — i.e. indented in if __name__== '__main__':. Take a screenshot like you did for the Mondrian above. This is Required Image 4 to be included in your project report.

In your report section called Art Reflection discuss which compositions/artists inspired you and what aspects of the compositions you emulated.

---

Check reproducibility

In order to grade your project, we need to be able to run your code and get the same results as you do! Here is a summary of the expected outputs from each of the source code files that you created:

• python3 better_shapelib.py: Draws your scene updated from Project 2 with a new compound object randomly placed multiple times at random sizes.
  • Contains shape functions, compound shape functions, goto, mondrian, mondrian_test, magritte, magritte_test, scene1
• python3 sureal.py: Draws your sureal scene in 3 different places at different sizes.
  • Contains surreal function.

---

Extensions

Congratulations on completing the core tasks! Between the code that you’ve already written and the report that you write, you’ve already earned up to 26/30 points for this project. If you turn it in by the first deadline that's 27/30 points.

The remaining 3/30 are a chance for you to earn credit for exploring parts of this project and digging deeper to express your creativity! This is entirely optional; 27/30 is an A- and is a perfectly respectable place to stop. Extensions are open-ended and exist to compliment the structured core project. Explore and learn something new that interests you! Concentrating your energy on 2 "deep" extensions that challenge you will earn you more points than many small, "shallow" extensions.

You can pick your own topics that interest you. Here are a few examples:

1. Create a scene that incorporates the surreal scene at different scales and locations.
2. Demonstrate even more levels of hierarchical encapsulation (scenes within scenes within scenes).
3. Learn about and use while loops as part of your scene.

To get credit for your extensions, you must document them in your report. For each extension this includes:

1. A description of your extension and how it fulfills one of the above tasks.
2. A screen shot (or multiple) of your extension.
3. An explanation of how you implemented your extension.

---

Submission checklist

To turn in your project, make sure you do all of the following:

• Create your report.
• Check the rubric in Google Classroom and make sure your report and code contain all the required parts.
• Rename your project folder to include your Colby username. For example, I would name mine hewolfe_Project3.zip.
• Create a zip file of your project.
• Attach (drag) the zip file to the posted project assignment on Google Classroom.
• Click "Turn In" on the Project 3 assignment in Google Classroom.

Link to detailed turn in instructions and more information about what should be contained in the report

---