Written Project Report, Presentation and Demo
Counts towards 30% of your final grade
Your final written report is due: Monday, May 10 by noon
You should prepare a final report of 12-15 pages that describes
your project. Your report may not be more than 20 pages long (including
references). It should be similar in style and organization to the
research papers that we read this semester (the well-organized ones that is).
This is your opportunity to describe in detail what problem you were solving,
how you solved it, how you tested your solution, what your results show,
difficulties you encountered along the way, what you would have liked to
have done (or done differently), and what you learned from your project.
You should also email me a gziped tar file of your project code by
Monday May 10th. However, your grade is almost exclusively
determined by your written report and oral presentation. This models the
real research world where the research paper is the primary, and usually only,
mechanism through which your work is evaluated, and where written conference
proceedings and conference presentations are the main mechanism through
which others learn about your work. Therefore, you should spend a
significant amount of effort making sure that you have a complete, and
well-written final report and presentation; don't do a fabulous project
and then fail to present it well.
See the "Detailed Requirements for the Written Report" section below
for how to structure your written report.
Presentation
Sometime during the last 1.5 weeks of class you will give a 25 minute class
presentation of your work (see the class schedule for the date and time
of your presentation). You should design your presentation in
similar way that you designed your paper presentation. See my
Oral Presentation Guide for more information on how to structure
your talk.
Add your talk slides to the course page wiki prior to the class meeting
when you will give your presentation.
One general comment I have is to add more figures/diagrams of your system
to help with your explanation of your project.
Demo
During Finals Week, you will give me a 30 minute demo of your project.
I will have a sign-up sheet outside my office door.
It is up to you to decide what you are going to demo. Before we meet,
decide what you are going to show me, come up with a simple demo script,
and run through it several times to make sure that there are no glitches
during the demo. This is your chance to show off all your hard work; you
want to convince me that you did something interesting and that you did
a substantial amount of work.
Detailed Requirements for the Written Report:
Paper Organization
Writing Style Guidelines
Paper Organization
You should have the following main sections in your paper:
- Abstract
The abstract is a brief summary of your work. It should be written
to make the reader want to read the rest of your paper. Briefly state the
basic contents and conclusions of your paper: the problem you are solving,
why the reader should care about this problem, your unique solution and/or
implementation, and the main results and and contributions of your work.
- Introduction
The introduction is the big picture of your work: what, why,
and how. It includes a definition of the problem you are
solving, a high-level description of your solution including
any novel techniques and results you provide, and a summary of the main
results of your paper. In addition, motivates the problem you are solving
(why should a reader find your work important), and describes your
contribution to the area (this may not be applicable to your project).
The first paragraph of the introduction should contain all of this
information in a very high-level. Subsequent paragraphs should discuss in
more detail the problem you are solving, your solution, and your results and
conclusions.
- Statement of Problem Being Solved
- Motivation
- Problem Solution
- Results and Conclusions
- Related Work
This is an essential part of a research paper; discussing related work is
a good way to put your work in context with other similar work, and to
provide a way for you to compare/ contrast your work to other's work.
- One or more sections describing your Solution
- Details of the problem you are solving
- Details of your solution and the project's implementation
Even though you may have spent an enourmous amount of time writing
code, this should not include a listing of any code you wrote. Only
if your project is about developing an algorithm or a new language, may
code examples be appropriate here.
- Discussion of how your solution solves the problem.
- Experimental Results demonstrating/proving your solution
- Explain the tests you performed (and why)
- Explain how you gathered the data and details of how your
experiments were run (any system/environment set up)
- Present your results
Choose quality over quantity; the reader will not be impressed with
pages and pages of graphs and tables, instead s/he wants to be
convinced that your results show something interesting and that your
experiments support your conclusions.
- Discuss your results!
Explain/interpret your results (possibly compare your results to
related work). Do not just present data and leave it up to the
reader to infer what the data show and why they are interesting.
- Conclusions & Future Directions for your work
Conclude with the main ideas and results of your work. Discuss ways in
which your project could be extended...what's next? what are the interesting
problems and questions that resulted from your work?
- A brief meta-discussion of your project
Include two paragraphs in this section:
- Discussion of what you found to be the most difficult and least
difficult parts of your project.
- In what ways did your implementation vary from your proposal and why?
- References
At the end of your paper is a Reference section. You must cite each
paper that you have referenced...your work is related to some prior work.
Writing Style Guidelines
- Write in a top-down style
First present the the high-level issues, then expand them.
This applies to the overall organization of your paper as well as the
organization of sub-sections and individual paragraphs.
- Conclude each paragraph, section and entire paper
Each chunk of your paper whether it be a paragraph, a sub-section, a
section, or the entire paper should have a conclusion. For example, each
paragraph should be written as follow:
- 1st sentence(s): main idea of paragraph
- middle sentences: expansion of the idea (further explanation or
elaboration of the topic)
- concluding sentence(s)
Each section of your paper should be organized as: high-level important points first, details second, summarize high-level points last.
- Use active 3rd person
We present, we show, we demonstrate...
- Define terms, and always define them before using them
- Use figures
Use diagrams to help explain system design, and graphs or tables for
presenting results. If your project has a GUI component, then your paper
should have some screen dumps of your interface (look at the man page for xwd).
You should have a figure showing the high-level design of your
implementation.
More detailed writing advice and guidelines can be found here:
CS Research and Writing Guide