---
# System prepended metadata

title: Homework 1
tags: [Homeworks-S25, '2025']

---

---
title: Homework 1
tags: Homeworks-F24, 2024
---

# Homework 1: Flags and Cool Images

#### **Due:** Tuesday, January 28th, 2025 at 11:59PM ET.
*If you joined the class late, you can have up until Tuesday, February 4th, 2024 at 11:59PM ET (the hwk2 deadline) to submit this, but to avoid falling behind you should submit this as soon as you can after you join. Everyone needs to submit homework 2 on time.*

:::warning
**Note:** We will cover the Pyret concepts you need for this homework on Friday's lecture (1/24). Feel free to explore Pyret or think about how you might render a flag, in the meantime!
:::

## Setup
- Go to code.pyret.org; this requires logging in with any Google account.
- Make a new file in code.pyret.org called `hw1-code.arr`.
- Do **not** put your name anywhere in the file.




## Resources

### Collaboration Policy

For this assignment, you are welcome to work as much as you want with other students. The whole point of this assignment is to make sure everyone is able to use Pyret, write simple programs, and submit assignments. That said, **we expect everyone to actually work on the assignment (not just hand in what someone else wrote) to avoid trouble with later assignments.**

### Documentation
[This guide](https://hackmd.io/@cs111/cpo-guide) reviews how to use the [Pyret programming environment (CPO)](https://code.pyret.org) in case you have questions beyond the demo in class.

The [Pyret Documentation](https://www.pyret.org/docs/latest/) is accessible from the Pirate button in the top left corner of code.pyret.org.

For this assignment, you will find the [image documentation](https://www.pyret.org/docs/latest/image.html) useful. When doing the problems, if you wish you had an operation on images that we did not cover in class, look in the documentation to see if you find something that does what you want (look at the operation names and their descriptions). If you run into problems using something you've found on documentation, post on [Edstem](https://edstem.org/us/courses/73794).


### Staff Assistance
Your friendly Professor and TAs are here to help with this assignment! You can find our schedule for office hours [here](https://brown-csci0111.github.io/pages/calendar).

![hi-cow](https://hackmd.io/_uploads/B1vjMRIvJl.gif)


### What we will look for when grading
- We want accuracy in the shapes that are present, their general locations, sizes, and orientations.
- We _do not care about exact positioning, size ratios, borders, or angles_. 
- We _do not care about specific color shades_. For example, you can use `"green"` even though it produces a much brighter green than on some of these flags. If you want to be accurate, a comprehensive list of color names can be found [here](https://www.pyret.org/docs/latest/color.html).
- We will not be grading for style on this assignment. (In fact, most of the style guide won't even make sense until the middle of next week.)

:::info
Learning Goals:
- Navigate Pyret documentation
- Work with Pyret image operators to compose expressions
- Practice program planning
:::

## The Assignment

Carol C. Cowley is looking for a new flag design to mount in her field! In this assignment, you will learn how to design some flags in order to help her.

![vecteezy_cute-cow-with-flag-cartoon-illustration_53098224](https://hackmd.io/_uploads/B17Tn-dPJx.jpg)
vecteezy.com

## Part One: Generating Flags
In this section, you will be creating four different flags: Madagascar, Turkey, Saint Lucia, and Greenland.

:::warning
**Note:** Set up your code so that **the four flags are output on the right hand side when we press the run button.** Make sure nothing else is output (no sub-images, numbers, strings, or otherwise).
:::

**Task 1:** Generate the flag of Madagascar.

<img src="https://cs.brown.edu/courses/csci0111/spring2020/data/madagascar.png" alt="Madagascar Flag" style="border:1px solid #123;" width=70%>

&NewLine;
:::spoiler Having trouble identifying colors in image?
:::info
Left rectangle is white. 
Top right rectangle is red. 
Bottom right rectangle is dark-green. 
:::

&NewLine;

**Task 2:** Generate the flag of Turkey.

<img src="https://cs.brown.edu/courses/csci0111/spring2020/data/turkey.png" alt="Turkey Flag" style="border:1px solid #123;" width=70%>

&NewLine;
:::spoiler Having trouble identifying colors in image?
:::info
Crescent and star are white. 
Background is red. 
:::
&NewLine;

**Task 3:** Generate the flag of Saint Lucia.

<img src="https://i.imgur.com/fbE8YvE.png" alt="Saint Lucia Flag" style="border:1px solid #123;" width=70%>

&NewLine;
:::spoiler Having trouble identifying colors in image? 
:::info
Foreground triangle is yellow. 
Middle triangle is black. 
Back triangle (border) is white. 
Flag background is light blue. 
:::
&NewLine;

**Task 4:** Generate the flag of Greenland.

<img src="https://cs.brown.edu/courses/csci0111/spring2020/data/greenland.png" alt="Greenland Flag" style="border:1px solid #123;" width=70%>

&NewLine;
:::spoiler Having trouble identifying colors in image? 
:::info
Bottom rectangle and upper half-circle are red. 
Top rectangle and bottom half-circle are white. 
:::
&NewLine;

:::info
Make sure to use the solid color white to fill shapes where appropriate. Do not depend on the Pyret website's background to fill in white areas of your image. 
:::

:::warning
**Reminder:** Set up your code so that **the four flags are output on the right hand side when we press the run button.** Make sure nothing else is output (no sub-images, numbers, strings, or otherwise).
:::

## Part Two: Practicing Program Planning
Most of the time, producing successful code requires thorough outlining and planning. Program planning is a skill that can help you deconstruct a problem in a way that allows you to avoid potential bugs. We now want to practice the process of outlining code prior to coding. 



**Task 5:** Pick one of the two images below. **Without coding it**, write a list of steps and action items that describe, in words, how to recreate your image (imagine that you were trying to get a child to draw the image from your steps) starting from basic shapes. Use any terms you want to describe the steps: you don't have to stick to names of operations that exist in Pyret or concepts that we've covered in class.

Write your instructions in a word processor or text editor of your choice (Word, Google Docs, etc), then save/export the file as a PDF (we're practicing this workflow now since we will need to do this multiple times this semester). Remember you're writing these steps in prose, not code.

![](https://i.imgur.com/Lm3i6ZM.png)



:::warning 
There is no lower or upper limit to how many steps you need to write. Try to make your instructions clear enough so that someone could replicate your image without having seen it.  
:::



## Handin
- Download your Pyret file (File > Download) and make sure it is called `hw1-code.arr` for Part One. 
- Create a file titled `program-steps.pdf` that **only** contains your written action items from part Two. 
- Hand in your work on [Gradescope](https://www.gradescope.com/courses/953715).
- You may submit as many times as you want before the deadline. Only your latest submission will be graded.
- If you have any questions, please post on [Edstem](https://edstem.org/us/courses/73794). Don't post any code unless requested by TAs, though. You can also consult the **frequently asked questions** for this assignment on Ed.


## Welcome to 111 Playlist
Please enjoy this playlist that CS111 staff has made for you :) We hope it will be a part of many good coding memories...

<iframe style="border-radius:12px" src="https://open.spotify.com/embed/playlist/0P94UJbqA1eHGzxgcnUZyX?utm_source=generator" width="100%" height="372" frameBorder="0" allowfullscreen="" allow="autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture" loading="lazy"></iframe>

------
> Brown University CSCI 0111 (Spring 2025)

<iframe src="https://forms.gle/ES2gWaUjHqRdypyh8" width="640" height="958" frameborder="0" marginheight="0" marginwidth="0">Loading…</iframe>