From be42c49c3b7054eecc4801c7fc4b88a03cfee105 Mon Sep 17 00:00:00 2001 From: mauzzr Date: Tue, 7 Apr 2015 13:03:01 -0400 Subject: [PATCH 1/7] set up formatting for group member sections We each now have our own section to be completed individually --- README.md | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 5335908..cd284d9 100644 --- a/README.md +++ b/README.md @@ -10,20 +10,20 @@ Ask questions, as always, [on piazza!][piazza] Teams will submit ONE written proposal, with sections that each member has done individually detailing their proposed contributions. The submission will be on github, as a pull request of this very file. Below is a template proposal report. You should be proposing something that you have high confidence that you can achieve, and the proposal should project that confidence. -The proposal should be no longer than necessary, but long enough to include critical detail. Three pages is appropriate. Diagrams are welcome. +The proposal should be no longer than necessary, but long enough to include critical detail. Three pages is appropriate. Diagrams are welcome. Remember, you can do some neat [formatting things with Markdown.][markdown] ## In-Class Presentation Instructions Teams will each deliver an in-class presentation. **Presentations will be Wednesday, April 8** (and Friday, April 10 as necessary). The presentation material is due on April 8 by 9 am for everybody. [See piazza for full schedule.][piazza] -Your team will have two minutes to present. Create presentation with two or three slides. Make the slides in google drive, and share the public-viewable link at the bottom of this report. The day of presentations, I'll have the list of links on the display computer, so each team can simply click their link and begin. +Your team will have two minutes to present. Create presentation with two or three slides. Make the slides in google drive, and share the public-viewable link at the bottom of this report. The day of presentations, I'll have the list of links on the display computer, so each team can simply click their link and begin. (Template follows. You may delete this line and all above it. Please edit the following template to create your report.) # Project Title: title here (10 words maximum) ### Problem Statement -Describe your problem, and why it is interesting. +Describe your problem, and why it is interesting. ### Problem Analysis Explain what approaches from class you will bring to bear on the problem. Be explicit and succinct. @@ -47,35 +47,39 @@ Will it run on some data, like batch mode? Will you present some analytical resu Will it be interactive? Can you show it working? This project involves a live demo, so interactivity is good. ### Evaluation of Results -How will you know if you are successful? +How will you know if you are successful? If you include some kind of _quantitative analysis,_ that would be fantastic. ## Work Plan and Schedule -Explain how you will go from proposal to finished product. Write your general plan here. -There are three deliverable milestones to explicitly define, below. The nature of deliverables depend on your project, but may include things like processed data ready for import, core algorithms implemented, interface design prototyped, etc. +Explain how you will go from proposal to finished product. Write your general plan here. +There are three deliverable milestones to explicitly define, below. The nature of deliverables depend on your project, but may include things like processed data ready for import, core algorithms implemented, interface design prototyped, etc. -You will be expected to turn in code, documentation, and data (as appropriate) at each of these stages, so take care in writing concrete steps for your schedule. +You will be expected to turn in code, documentation, and data (as appropriate) at each of these stages, so take care in writing concrete steps for your schedule. In this general plan, and in the deliverables below. ### First Milestone (04-13) -What exactly will be turned in on this day? +What exactly will be turned in on this day? ### Second Milestone (04-21) -What exactly will be turned in on this day? +What exactly will be turned in on this day? ## Group Responsibilities Here each group member gets a section where they, as an individual, detail what they are responsible for in this project. Each group member writes their own Responsibility section. Include the milestones and final deliverable. -### Susan Scheme +### Alex Li will write the.... -### Leonard Lambda +### Pat Quaratiello will work on... +### Peter Welby +will build... + ## Proposal Presentation Link -insert your google presentation public link here, so with one click it will open up in the browser and you can present. +[Google Slides Presentation][presentation] [piazza]: https://piazza.com/class/i55is8xqqwhmr?cid=453 [markdown]: https://help.github.com/articles/markdown-basics/ +[presentation]: https://docs.google.com/presentation/d/1RS-RpMVcs_PuakTo_GzXePOPTVv_1goc3mxZHn5pIWY/edit?usp=sharing From 34e38e0dff31f0472c6d450755e51a0621ba13aa Mon Sep 17 00:00:00 2001 From: mauzzr Date: Tue, 7 Apr 2015 15:55:44 -0400 Subject: [PATCH 2/7] various progress not at all descriptive --- README.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index cd284d9..a795bde 100644 --- a/README.md +++ b/README.md @@ -21,14 +21,17 @@ Your team will have two minutes to present. Create presentation with two or thre (Template follows. You may delete this line and all above it. Please edit the following template to create your report.) -# Project Title: title here (10 words maximum) +# Project Title: Dr. Matchket ### Problem Statement -Describe your problem, and why it is interesting. +Racket lends itself particularly well to creating rules for a card-matching game. Using the cards and rsound libraries, we can programmatically create matched pairs (or larger sets) of cards which have unique characteristics that are reconciled within each pair or set. ### Problem Analysis Explain what approaches from class you will bring to bear on the problem. Be explicit and succinct. +Each matched pair or set of cards will have a particular set of sound effects associated with it. (e.g., one for turning a particular type of card face-up, and another for matching all the cards of that type successfully.) This should do well to provide an audible cue to accompany the visual cue of the card face itself, helping players to match pairs or sets successfully. + ### Data set or other source materials + +Sound effects will be generated programmatically via the rsound library. ### Deliverable and Demonstration -Explain exactly what you'll have at the end. What will it be able to do at the live demo? - -What exactly will you produce at the end of the project? A piece of software, yes, but what will it do? Here are some questions to think about (and answer depending on your application). - -Will it run on some data, like batch mode? Will you present some analytical results of the processing? How can it be re-run on different source data? - -Will it be interactive? Can you show it working? This project involves a live demo, so interactivity is good. +Our live demonstration will feature the playable matching game, with players winning upon successfully matching all corresponding cards. We plan to shuffle the cards after a set number of incorrect guesses in lieu of a firm lose condition. ### Evaluation of Results How will you know if you are successful? -If you include some kind of _quantitative analysis,_ that would be fantastic. +The purpose of a game is to entertain. As such, our success will depend largely on our ability to offer an entertaining experience through our core gameplay and audiovisual feedback features. ## Work Plan and Schedule Explain how you will go from proposal to finished product. Write your general plan here. From be64b9bd0989e540fcccdbdace4a5871ccf49e6e Mon Sep 17 00:00:00 2001 From: pwelby Date: Tue, 7 Apr 2015 21:23:50 -0400 Subject: [PATCH 3/7] merge pat's changes and expand more sections --- README.md | 41 +++++++++++++++++++++++++++++++---------- 1 file changed, 31 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index a795bde..22e3e01 100644 --- a/README.md +++ b/README.md @@ -21,14 +21,15 @@ Your team will have two minutes to present. Create presentation with two or thre (Template follows. You may delete this line and all above it. Please edit the following template to create your report.) -# Project Title: Dr. Matchket +# Project Title: Dr. Match-it ### Problem Statement -Racket lends itself particularly well to creating rules for a card-matching game. Using the cards and rsound libraries, we can programmatically create matched pairs (or larger sets) of cards which have unique characteristics that are reconciled within each pair or set. +Racket lends itself particularly well to creating rules for a card-matching game. Using the `cards` and `rsound` libraries, we can programmatically create matched pairs (or larger sets) of cards which have unique characteristics that are reconciled within each pair or set. ### Problem Analysis + +This project will rely heavily on the object-oriented facilities of Racket which we were introduced to in the lecture. The `cards` library uses local state to maintain the state of the game through the card table, and we will extend the card objects to keep track of the sound(s) they must play in response to particular gameplay events. ### Data set or other source materials -Sound effects will be generated programmatically via the rsound library. +We will design any assets which we cannot (or decide not to) define in code externally. Currently, we plan to design custom faces for our cards in Photoshop, which can be brought in as bitmaps. Additionally, some primitive sounds may be generated in Audacity if they cannot be adequately modeled by a generator procedure. These will be imported using the file I/O capabilities of the `rsound` library, and filtered to achieve the desired sound using the filter procedures we write. ### Deliverable and Demonstration -Our live demonstration will feature the playable matching game, with players winning upon successfully matching all corresponding cards. We plan to shuffle the cards after a set number of incorrect guesses in lieu of a firm lose condition. +Our live demonstration will feature the playable matching game, with players winning upon successfully matching all corresponding cards. We plan to shuffle the cards after a set number of incorrect guesses in lieu of a firm lose condition. The player's score will be calculated using failed attempts, as well as how long it took to find all of the matches. ### Evaluation of Results How will you know if you are successful? The purpose of a game is to entertain. As such, our success will depend largely on our ability to offer an entertaining experience through our core gameplay and audiovisual feedback features. ## Work Plan and Schedule + +### General Plan: + +* Create scramble feature. +* Determine how to create matches. +* Begin point system using matches. +* Determine how to keep time. +* Create a final point system based on time, matches and mismatches. +* Design primitive sound generators and filters +* Synthesize final sounds through combination and filtering of primitives ### First Milestone (04-13) -What exactly will be turned in on this day? +* Have the scramble feature working for a set number of cards. +* Determine how to create matches. +* Begin to determine the point values for each element of the final score, and how it will be calculated. +* Initial set of primitive sound generators completed +* One or more filters completed +* Some, if not all, card faces designed ### Second Milestone (04-21) -What exactly will be turned in on this day? +* Integration of scramble feature with the rest of the game. +* Completed scoring system. +* Sound integration figured out with some sounds added to card objects and usable in-game ## Group Responsibilities + ### Alex Li will write the.... ### Pat Quaratiello -will work on... +Will be working on creating the scramble feature after there are several (possibly 5 - we'll need to test what is reasonable) failed attempts at matching cards. I will also be working on the point system with the help of the other members to determine how we can incorporate both missed matches and time into your total score, as well as successful matches. ### Peter Welby -will build... +Will work primarily on building the sound effect system in `rsound`. This includes writing generators for primitive sounds, combining and filtering these primitives to create more interesting sounds for use in the game, and integrating these sounds with the core gameplay functionality. Additionally, I will design the custom card faces to be used in the game. ## Proposal Presentation Link [Google Slides Presentation][presentation] From 4697d0b246060dfde42c3e93ccceb00ff72526b4 Mon Sep 17 00:00:00 2001 From: aali2537 Date: Tue, 7 Apr 2015 22:07:23 -0400 Subject: [PATCH 4/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 22e3e01..f87a2a4 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,7 @@ Here each group member gets a section where they, as an individual, detail what --> ### Alex Li -will write the.... +Will be responsible for initializing the board state, as well as implementing the match checking system. The match checking system will called upon anytime there are two face up cards on the board. If the two cards are matching they will be removed, otherwise they will be flipped back down. Since this would be an ideal place to put any scoring procedures, I will be working with other members on how to implement the scoring system. ### Pat Quaratiello Will be working on creating the scramble feature after there are several (possibly 5 - we'll need to test what is reasonable) failed attempts at matching cards. I will also be working on the point system with the help of the other members to determine how we can incorporate both missed matches and time into your total score, as well as successful matches. From 333759999b2b20596633088e8698bff4784c85eb Mon Sep 17 00:00:00 2001 From: aali2537 Date: Tue, 7 Apr 2015 22:09:21 -0400 Subject: [PATCH 5/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f87a2a4..1cc59d3 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,7 @@ Here each group member gets a section where they, as an individual, detail what --> ### Alex Li -Will be responsible for initializing the board state, as well as implementing the match checking system. The match checking system will called upon anytime there are two face up cards on the board. If the two cards are matching they will be removed, otherwise they will be flipped back down. Since this would be an ideal place to put any scoring procedures, I will be working with other members on how to implement the scoring system. +Will be responsible for initializing the board state, as well as implementing the match checking system. The match checking system will called upon anytime there are two face up cards on the board. If the two cards are matching they will be removed, otherwise they will be flipped back down. Since this would be an ideal place to put any scoring procedures, I will also be working with other members on how to implement the scoring system. ### Pat Quaratiello Will be working on creating the scramble feature after there are several (possibly 5 - we'll need to test what is reasonable) failed attempts at matching cards. I will also be working on the point system with the help of the other members to determine how we can incorporate both missed matches and time into your total score, as well as successful matches. From 25443516794df1364a7aea3940f1b8b8200b76de Mon Sep 17 00:00:00 2001 From: pwelby Date: Tue, 7 Apr 2015 22:15:36 -0400 Subject: [PATCH 6/7] remove proposal instructions from template --- README.md | 23 ----------------------- 1 file changed, 23 deletions(-) diff --git a/README.md b/README.md index 1cc59d3..13ac96a 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,3 @@ -# FP4-proposal -Project Proposal is due 2015-04-08 at 8am - -Produce a plan for your final project, and prepare an in-class presentation. - -Ask questions, as always, [on piazza!][piazza] - -## Written Proposal Instructions - -Teams will submit ONE written proposal, with sections that each member has done individually detailing their proposed contributions. The submission will be on github, as a pull request of this very file. Below is a template proposal report. - -You should be proposing something that you have high confidence that you can achieve, and the proposal should project that confidence. -The proposal should be no longer than necessary, but long enough to include critical detail. Three pages is appropriate. Diagrams are welcome. - -Remember, you can do some neat [formatting things with Markdown.][markdown] - -## In-Class Presentation Instructions -Teams will each deliver an in-class presentation. **Presentations will be Wednesday, April 8** (and Friday, April 10 as necessary). The presentation material is due on April 8 by 9 am for everybody. [See piazza for full schedule.][piazza] - -Your team will have two minutes to present. Create presentation with two or three slides. Make the slides in google drive, and share the public-viewable link at the bottom of this report. The day of presentations, I'll have the list of links on the display computer, so each team can simply click their link and begin. - -(Template follows. You may delete this line and all above it. Please edit the following template to create your report.) - # Project Title: Dr. Match-it ### Problem Statement Racket lends itself particularly well to creating rules for a card-matching game. Using the `cards` and `rsound` libraries, we can programmatically create matched pairs (or larger sets) of cards which have unique characteristics that are reconciled within each pair or set. From 423322f7fc814afa81f6eca0b4b05623c74d071f Mon Sep 17 00:00:00 2001 From: pwelby Date: Tue, 7 Apr 2015 22:17:02 -0400 Subject: [PATCH 7/7] re-add FP4-proposal header --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 13ac96a..4df38ad 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +# FP4-proposal + # Project Title: Dr. Match-it ### Problem Statement Racket lends itself particularly well to creating rules for a card-matching game. Using the `cards` and `rsound` libraries, we can programmatically create matched pairs (or larger sets) of cards which have unique characteristics that are reconciled within each pair or set.