Final Project Documentation Template

Snoweria Zhang
X-Information Modeling Spring 2021
6 min readApr 4, 2021

Project Title

Subtitle One sentence that summarizes your project.

This image should be an introductory banner that clearly describes your motivation and computational design model. Please include a short caption.

1. Project Overview

Clearly state both the problem that your project addresses and an explanation of your hypothesis — i.e., how the project might address the problem. This can incorporate the daring questions that you asked during the development of your computational model. Feel free to deviate from the mad libs structure, which may have now become restrictive.

For example, a daring question could be:

“What if all park space was equitably distributed?”

Then, you could take a google earth image of Manhattan and photoshop buildings in place of Central Park and many small parks scattered throughout the borough. See the image below.

This image should be a photo collage or diagram that is illustrative of the outcome of your project. Please include a short caption describing your college.

Goals and Metrics

This section should be descriptive of how your team is setting up goals and metrics to determine success.

  1. What are you measuring?
  2. Why you are measuring it?
  3. How does it relate to your goals (i.e. how did you set up your project to measure performance and what did you expect to find)?

What Did We Discover?

State your conclusions at a high level. This engages the audience and helps them to better follow along as you build up to how you arrived at the conclusion. The hook makes the audience want to pay attention. For example:

“Through the computational design model, we have identified X and Y trends that allows the city to address Z while achieving or increasing A and B.”

Explain why the outcome of your model is important by using your:

  1. Background research of the problem and proposal
  2. Future context exploration and transformation of NYC into a hypothetical condition
  3. Urban data mapping

Not all projects will cover all the above topics. Use what is needed to explain why the issues your project addresses matter.

2. Computational Design Model

This image should be a computational design model diagram that clearly describes the relationship between your inputs, procedural rules, and metrics. Make a clear, easily read diagram. Please include a short caption.

Analysis Tools

Please include a short caption describing your diagram.
Please include a short caption describing your diagram.

Describe how you are deriving your metric.

  1. Have a summary image with each analysis tool (examples above)
  2. Use an image/diagram for each custom tool that requires further explanation on how it works (example below).

Custom Tool Name

Please include a short caption describing your diagram.

Link to any packaged analysis tools you have documented and posted.

Procedural Types

This section focuses on the rules you have defined, the range of variability, and an explanation of how they relate to your goals and metrics.

Link to any procedural types you have documented and posted.

Please include a short caption describing your diagram.
Please include a short caption describing your diagram.

You are encouraged to use sketching when illustrating the rules and types of your computational design model. Please include a short caption describing your diagram.

Design Space

This section should be descriptive of your team’s input ranges, the reasoning why you picked that range, and an explanation of what you left out. For example

"I’m varying this input in this range because of X."

Please include simple diagram(s) that illustrate extremes of the design space, animated gif of design space, and computational model table. The diagrams and animations should be CLEAR and SIMPLE. These can be animations showing how your model changes one variable at a time, still images explaining the variables, or other drawing types. You must break down the complexity of your project into intelligible pieces.

Please include a short caption describing your diagram.

3. Analysis and Results

Exploring the Design Space

This section should be descriptive of your team’s design exploration and initial insights using Scout.

Each team will be conducting a live demonstration of your model in Scout when presenting the final project.

In addition, document the tlive demo on Medium with annotated, sequential screenshots replicating the sequence of the live demonstration. Show how you can use Scout to explore scenarios or answer specific questions using the parallel coordinates chart. For example,

“What if . . .”

Results

Were certain metrics inconclusive? Were there unexpected correlations? What are the general trends in your data? What are your specific insights/findings? You can annotate right on top of Scout screenshots or translate insights to diagrams. How does performance (metrics) relate to form (inputs)?

Please include a short caption describing your diagram.

Design Comparison

Create an image comparing several options that are representative of the trends in your analysis. This should include high and low-performing options, options that perform well in some metrics but poorly in others, options that do a good job of balancing trade-offs, etc. Include text explaining the comparison image and key take-aways. Include an option that gives context to the performance as a baseline or a benchmark. For example, it could be the existing context or an option with your target density but with traditional development patterns (i.e., densification without design innovation.)

Make sure to include both images and the data. Provide a visual hierarchy so that we can see which data are most relevant, which are high vs. low. These can be simple charts, or even just text. Focus on clearly communicating the data.

Zoom in to talk about the best option(s) and the worst. Take a few images to detail why these options perform well or poorly. The point of this entire exercise is to create a data-driven methodology for making DECISIONS, so choose which option or options are the best and defend those choices.

Conclusions and Next Steps

For the concluding text of your computational design model documentation, think about the following questions as you reinforce the reason why the results from your team’s model should be implemented.

  1. How do you recommend the results of your model be used? Who should learn from this?
  2. If we are treating this as a proof-of-concept to illustrate the viability of this type of computational approach to the city, what are the next steps for implementation?
  3. Your project will be evaluated relative to the anti-bias rubric we developed. These include identifying limitations, what this does and does not do or include.

Overall format and flow of text:

For each of the sections, write the minimum amount that is necessary for your project to be understood by someone reading your post. Each section needs to stand alone but it should not be text-heavy. Someone should be able to read through your post in 10–15 minutes.

--

--