Final Project
Logistics
The final as a whole is due at the end of exams, Nov 23rd, 9:30pm. Because there is not a further opportunity to revise, there are intermediate draft deadlines to get feedback and be sure you are going in the right direction.
Collaboration policy
For this assignment, you will be assigned to work with 1-2 students from the ODEs class. You should discuss your implementation in depth with your partner(s). Further, you may discuss the project at a high level with other students in our class, however you must type up all of the code yourself. (It is therefore unexpected for two code submissions to be completely identical.) You can discuss the assignment with Anya, our course staff, or any lab assistants.
You should list any student or course staff with whom you discussed the assignment and the manner of discussion in your README.md file.
AI policy
As discussed in the syllabus, there are both acceptable and unacceptable uses of genAI in this class. Regardless of whether you use any genAI, you need to complete the AI Log in the README.md to satisfy the advanced requirement.
If you choose not to use genAI at all, you may state that for your AI Log (and I fully support this choice). I’d be interested in your reasons, though it’s not required to write them in the log for every assignment.
If you do choose to use genAI, you should log it in the AI Log section of the README in the following format:
- Date: Summary of use and assessment of usefulness
For example, a hypothetical log could be:
- 8/25/26: I asked Gemini how to do default values for a constructor and it helped me figure it out
- 8/26/26: I couldn’t figure out the problem with the
ApplyLinearSpringForcesmethod and Gemini was completely useless - 8/26/26: I googled the problem with the
ApplyLinearSpringForcesand the AI summary was helpful
This log requirement is both to give me an idea of how useful genAI is in this context and to make sure that your learning isn’t being hampered. As mentioned in the hypothetical log, you should include any genAI resources that you use, even the AI summary shown in search results or GitHub Copilot (which shows up as autocomplete in VSCode now).
Goal
The goals of this project are:
- To develop and demonstrate interdisciplinary communication skills
- To expand your ability to create an artificial life model to capture key dynamics of a system
- To explore the strengths of different modeling approaches to the same problem
Setup
You’ll again be using the Empirical library for this project. I’ve provided starter code similar to the Artificial Ecology homework to give you a starting place, though you will obviously need to further customize it depending on the ODE your group is working from.
-
Go to our 361-F26 Organization and find the
Final-Projectrepository for your account. Usegit clone --recurse-submodules [URL]as usual. - Then, go to the
emsdkfolder and install and activateemsdk:cd emsdk ./emsdk install 3.1.49 ./emsdk activate 3.1.49 - Then source
emsdk. You’ll need to do this command anytime you open a new Terminal, so if you are getting an error aboutemccnot existing, you probably forgot to do this:source ./emsdk_env.sh cd .. - Verify that everything is set up correctly by going back to the top level of your repository and running the appropriate compile-run script.
Assignment Specification
For this assignment, you will:
- work with your ODE partner(s) to understand the key interactions in their ODE model.
- implement the biological system modeled
- compare your system’s results to the ODE predictions
- create and record a group presentation explaining your implementations and comparing your results
- Your presentation should be roughly 5 min intro to paper, 5 min ODE methods and highlights, 5 min ABM methods and highlights, 5 min synthesis and conclusion
Intermediate Feedback
You should submit a nearly-complete version of your code and README by Monday, Nov 16th at 10pm. I will then give you feedback on those components so that you are prepared to create the presentation and do any final updates.
Presentation Rubric
Your presentation will be evaluated on a similar rubric to the ODE students, but focused on the ABM components:
| Beginning | Developing | Core Competency | Advanced Competency | |
|---|---|---|---|---|
| Duration Overall | < 10 or > 22 min | 10-15 or 21-22 min | 15-21 min | n/a |
| Components checklist (below) | few present | some present | all present | all present and well done |
| Comparison between ODE and ABM results | absent | perfunctory | reasonable | insightful |
| Visuals used when possible, minimal text, builds if needed | not very effective | somewhat effective | mostly effective | consistently effective |
| Verbal and visual delivery coordinated | not much | somewhat | mostly coordinated | consistently coordinated |
| ABM description | interactions and species mentioned | interactions OR species described clearly | both described clearly | interactions and species described clearly with custom graphics |
Components checklist
- Everywhere
- Cite sources for images with a url, citation, or image credit slide
- Intro
- Start with a title slide with a title, your names, and the date
- Motivate the problem that the research article seeks to address. Why is it interesting? What are the main points that you will make?
- Background: give any necessary biological background for non-experts of that field. (Assume an audience of CS/ODE peers)
- ABM highlights
- Describe the ABM implemented to address the research problem. Explain what makes each “species” unique (or mutant or state, depending on your system) and how the “species” (etc) interact with each other (i.e. infect, consume, transform into, etc)
- Give highlights from your data analysis and interpret the results in real-world terms
- Conclusion
- Compre your results to the ODE. What were aspects of your implementation that got your data closer to the ODE predictions? Where is there still difference between the models and what might explain that difference? Remember that your data isn’t expected to match up perfectly, but you should make an effort to get it closer and report on that effort. Don’t expect the numbers to match; instead focus on the extremes and the qualitative trends.
- What new questions do your results raise for future study?
- Bibliography: cite references in your presentaton and include full info at the end
- Acknowledge any sources of help from beyond your group
Assessment
Core Requirements
The Core requirements for this project are:
- Run and output data to a file when
compile-run-mac.shis run (i.e. the non-GUI version) - Reasonably captures the key interactions of the ODE
- Report in the README the exact paper that your group is replicating (include a link)
- Report in the README what the key interactions of the ODE were and how you implemented them in the
Coresection - Submit a group presentation that meets all the core competencies listed in the table above.
Advanced Requirements
The Advanced requirements for this project are:
- Complete all core requirements.
- Run and display a GUI of your system when
compile-run-web.shis run - Closely capture the key interactions of the ODE
- Report in the README
Advancedsection where your results match and diverge from the ODE predictions - Submit a group presentation that meets at least 4 of the advanced competencies in the table above.
Submission
As always, you should add/commit/push your files to GitHub and then tag your commit:
git tag -a initial_submission -m "initial submission"
git push origin initial_submission
For your group presentation: hopefully you can just upload it to the git repository, but if the file is too big, GitHub might reject it. In that case, upload it to the assignment on Moodle instead.