CSC1002 – Computational Laboratory Iris - 2025 OVERVIEW Inspired by a high school student I met in a high-school elite event organized by SSE in 2024. Her name is Iris. In this assignment, you are going to design and develop a program to display as many polygon shapes as possible on the canvas in random locations within a given period of time. Your program will load the custom shapes (name and coordinates) of all the polygons from an external file, start tracking the elapsed time and then repeatedly perform the shape-placement operation. Initially the canvas is empty. The shape-placement operation picks a random polygon shape, a random color and a random pair of x, y coordinates, trying to position the chosen polygon on the canvas at the chosen x, y coordinate, on condition that it is completely separate from all other polygons already drawn on the canvas. If it fails, your program repeatedly attempts to place the same polygon in another location by choosing another random pair of x, y coordinates. No polygon can be placed within another polygon and any polygon cannot 代写CSC1002 – Computationaltouch or overlap any other polygons. The placement operation ceases any further attempts for another polygon once the elapsed time has expired. The duration length is defined by the user at the program's launch. Please refer to the scope for detailed requirements.
CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory SCOPE
- Drawing Canvas - Use module “turtle” to create the drawing canvas, 75% width and 75% height of computer’s screen resolution, positioned at the center of the computer’s screen.
- Input - prompt the user to enter the following information: a. Stretch Value - a value used to resize polygon in both width and height. Default is 1. b. Duration - total number of seconds to place random polygons on canvas. Default is 5. c. Random Seed - the seed value used to initialize the random module. Default is 1. d. Terminate - ‘y’ or ’n’. Default is ’n’
- Termination a. after the duration is up, the program stops placing additional polygons on the canvas and then shows the total count of polygons successfully displayed on the canvas. In the title bar of the canvas, show your student ID, the time the operation started and ended, elapsed time (seconds) and the number of polygons displayed: and simply print the polygon count with your student ID on the console: b. Change the background color of the canvas to black. c. if “Terminate” is ‘y’ then exit the program immediately; otherwise do nothing and keep the canvas active so that TA can verify the positions of polygons on the canvas.
- Custom Shapes - the names and coordinates of all polygons are given in an external file called shapes.txt. Ensure the mode of the screen is set to “logo” and register the custom shapes using addshape(name, coordinates).
- Shape-Placement Operation a. Track the elapsed time b. Pick a random color - from a predefined list of colors (see template file). CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory c. Pick a random polygon shape d. Stretch the chosen polygon in both x and y directions and set the shape color accordingly using the following methods: i. shapesize(value, value) ii. color(value) e. Try repeatedly placing the chosen polygon on the canvas at a random location: i. pick a random x, y coordinates ii. show the polygon at the chosen x, y coordinates if the following conditions are met:
- no further adjustment is allowed to the polygon including rotation, heading adjustment, shearing, etc.
- simply call goto(x, y) to move the chosen polygon
- the polygon must be completely separate from all other polygons already drawn on the canvas
- the polygon cannot be placed within another polygon
- the polygon cannot touch or overlap any other polygons iii. if the condition isn’t met and there is more time to continue, repeat the above steps. f. track of the number of polygons successfully shown on the canvas. g. Repeat all the steps above until the total elapsed time (in seconds) exceeds the entered duration.
- Template File - follow the provided template file to complete the assignment. NOTE: • Keep your entire source code in ONE SINGLE file. • Use only Python modules as specified in the “Permitted Modules” section. • In your design stick ONLY to functions, in other words, no class objects of your own. o Furthermore, the lines of code containing the sub-function(s) defined within another function will be counted as part of the parent function. o NOTE: Failure to adhere to the instructions outlined in the assignment handout will result in a 50% reduction in the coding style score. CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory STARTUP OPTIONS Not applicable SKILLS In this assignment, you will be trained on the use of the followings: • Refactoring - logic reuse or simplification based on the existing logic. • Variable scope: global, local and function parameters. • Coding Styles (naming convention, meaningful names, comments, doc_string, …etc) • Problem Decomposition, Clean Code, Top-Down Design • Functions (with parameters and return) for program structure and logic decomposition • Standard objects (strings, numbers & lists) • Variable Scope PERMITTED MODULES Only the following Python module(s) is allowed to be used: • turtle • random • time DELIVERABLES Program source code (A2_School_StudentID.py), where School is SSE, SDS, SME, HSS, FE, LHS, MED and StudentID is your 9-digit student ID. For instance, a student from SME with student ID “119010001” will name the Python file as follows: • A2_SME_119010001.py: Ensure that your source file is saved in standard, regular UTF-8 encoding format. On the status bar of Visual Studio Code, you can view the current encoding format as follows: On an occasion, the encoding scheme is set to UTF-8 with BOM as follows: CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory The presence of the Byte Order Mark (BOM) could be due to copying from websites, older versions of editor, file conversion from other sources, default encoding settings, and so on. Confirm the encoding scheme is UTF-8 and the file name is correct, then submit the plain program file to the corresponding assignment folder. A deduction of 5% will be penalized if the file is incorrectly named or in wrong encoding format. TIPS & HINTS • Apply problem decomposition, Clean Code and Refactoring as illustrated during classes. • Beware of variable scope as you might keep a few variables as global such as current editor content, cursor position, undo buffer, and so on. • Refer to Python website for program styles and naming conventions (PEP 8) CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory SAMPLE OUTPUT NOTE: REFER TO THE SCOPE FOR THE REQUIRED INFORMATION TO BE DISPLAYED IN THE TITLE BAR OF THE TURTLE GRAPHICS WINDOWS. CSC1002 – 2025 Winter By Kinley Lam CSC1002 – Computational Laboratory MARKING CRITERIA • Coding Styles – overall program structure including layout, comments, white spaces, naming convention, variables, indentation, functions with appropriate parameters and return. • Program Correctness – whether or the program works 100% as per Scope. • User Interaction – how informative and accurate information is exchanged between your program and the player. • Readability counts – programs that are well structured and easy to follow using functions to break down complex problems into smaller cleaner generalized functions are preferred over a function embracing a complex logic with many nested conditions and branches! In other words, a design with a clean architecture and high readability is the predilection for the course objectives over efficiency. The logic in each function should be kept simple and short, and it should be designed to perform a single task and be generalized with parameters as needed. • KISS approach – Keep It Simple and Straightforward. • Balance approach – you are not required to come up with a very optimized solution. However, take a balance between readability and efficiency with good use of program constructs. DUE DATE April 6th, 2025, 11:59:00PM ITEMS PERCENTAGE REMARKS CODING STYLES 50%-60% 0% IF PROGRAM DOESN’T RUN FUNCTIONALITY 50%-60% REFER TO SCOPE CSC1002 – 2025 Winter By Kinley Lam WX：codinghelp
