|
| 1 | +--- |
| 2 | +title: Publish Final Project |
| 3 | +subtitle: Commit the final version of your project |
| 4 | +week: 16 |
| 5 | +type: Task |
| 6 | +tasks: |
| 7 | + - Finalize your project and commit to GitHub |
| 8 | + - Confirm the final version renders correctly on your website |
| 9 | +--- |
| 10 | + |
| 11 | +```{r, echo=FALSE, message=FALSE, results='hide', purl=FALSE} |
| 12 | +source("functions.R") |
| 13 | +source("knitr_header.R") |
| 14 | +``` |
| 15 | + |
| 16 | +# Reading |
| 17 | + |
| 18 | +```{r reading,results='asis',echo=F} |
| 19 | +#md_bullet(rmarkdown::metadata$reading) |
| 20 | +``` |
| 21 | + |
| 22 | +# Tasks |
| 23 | + |
| 24 | +```{r reading,results='asis',echo=F} |
| 25 | +md_bullet(rmarkdown::metadata$tasks) |
| 26 | +``` |
| 27 | + |
| 28 | +## Final Draft |
| 29 | + |
| 30 | +You will have two opportunites to submit your final project and your final grade on the project will be the highest of the two submissions. |
| 31 | + |
| 32 | +The final project will include and be graded as follows: |
| 33 | + |
| 34 | +1. **Title** (<25 words) |
| 35 | +2. **Introduction [~ 200 words, 10%]** |
| 36 | + * Clearly stated background and questions / hypotheses / problems being addressed. Sets up the analysis in an interesting and compelling way. |
| 37 | +3. **Materials and methods [~ 200 words]** |
| 38 | + * **Narrative (10%)**: Clear narrative description of the data sources and methods. Includes data from at least two sources that were integrated / merged in R. |
| 39 | + * **Code (25%)**: The code associated with the project is well organized and easy to follow. Demonstrates mastery of R graphics and functions. |
| 40 | + * **Data (5%)**: The underlying data are publicly accessible via the web and downloaded/accessed within the Rmd script. If you want to use your own data, you must make it available on a website (e.g. [Figshare](figshare.org)) so that others are able to re-run your code. |
| 41 | +4. **Results [~200 words, 25%]** |
| 42 | + * Tables and figures (maps and other graphics) are carefully planned to convey the results of your analysis. Intense exploration and evidence of many trials and failures. The author looked at the data in many different ways before coming to the final presentation of the data. |
| 43 | +5. **Conclusions [~200 words, 5%]** |
| 44 | + * Clear summary adequately describing the results and putting them in context. Discussion of further questions and ways to continue investigation. |
| 45 | +6. **References [5%]** |
| 46 | + * All sources are cited in a consistent manner |
| 47 | +7. **General Scores** |
| 48 | + * **General organization (10%)**: Clear labels/headings demarcate separate sections. Excellent flow from one section to the next. Tables and graphics carefully tuned and placed for desired purpose.The 'story' is very well organized, makes good use of graphics, and is easy to understand. |
| 49 | + * **General Grammar (5%)**: All sentences are well constructed and have varied structure and length. The author makes no errors in grammar, mechanics, and/or spelling. |
| 50 | + |
| 51 | +See the project rubric below for more details and examples. |
| 52 | +<a href='assets/rubric.png' target="_blank"> <img src='assets/rubric.png'></a> |
| 53 | + |
| 54 | +Note that the word counts are quite short (~200 words per section). This does not mean it's _easy_! In fact, conveying all the necessary information succinctly requires extra effort. If English is not your first language, you are encouraged to contact the [UB Writing Center](https://www.buffalo.edu/writing.html) to get help writing succinctly and clearly. They schedule 45 minute sessions to go over your writing which can dramatically improve the quality of your project. Plan ahead to schedule this before upcoming deadlines. |
| 55 | + |
| 56 | +The more complete the second draft, the more feedback I'll be able to provide to ensure an excellent final project. So it's in your interest to finish as much as possible. In addition to the details from the first draft, I would like to see drafts of the text and figures/tables/etc in each section. |
| 57 | + |
| 58 | +When submitting your your second draft, you can include any questions or comments in the draft (e.g., "I'm planning to do X, but I'm not sure how to organize the data appropriately") or as a _comment_ in the UBLearns submission webpage. Please do not include these comments in the final submission. |
| 59 | + |
| 60 | +#### Formatting |
| 61 | +The final project will be produced as a [RMarkdown Website](http://rmarkdown.rstudio.com/rmarkdown_websites.html) that includes all the steps necessary to run the analysis and produce the output (figures, tables,etc.). For examples of similar documents, explore the [RPubs website](https://rpubs.com). |
| 62 | + |
| 63 | +See the [RMarkdown page](http://rmarkdown.rstudio.com/formats.html) for ideas on different html output designs. In particular, check out the [FlexaDashboard](http://rmarkdown.rstudio.com/flexdashboard/) options if you want to include interactive displays. |
| 64 | + |
| 65 | +#### Figures |
| 66 | +Figures (maps and other graphics) are a vital component of scientific communication and you should carefully plan your figures to convey the results of your analysis. |
| 67 | + |
| 68 | +#### References |
| 69 | +You should cite any relevant materials (including data sources and methods) in the text using a standard author-date citation format (e.g. Wilson, 2015) and then described in a References section. You can either compile the references manually (e.g. cutting and pasting the citation into the references section) or use the automated system in RMarkdown explained [here](http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html). Other citation styles are acceptable as long as they are consistent, complete, and easy to understand. |
| 70 | + |
| 71 | +### Resources |
| 72 | + |
| 73 | +Sites with examples of visual display of quantitative information |
| 74 | + |
| 75 | +* [http://www.informationisbeautiful.net](http://www.informationisbeautiful.net) |
| 76 | +* [http://flowingdata.com](http://flowingdata.com) |
| 77 | +* [https://visual.ly/m/design-portfolio/](https://visual.ly/m/design-portfolio/) |
| 78 | +* [40 Brilliant and Complex Topics Explained Perfectly By Infographics](https://designschool.canva.com/blog/best-infographics/) |
| 79 | +* [NY Times Graphics Department](https://twitter.com/nytgraphics) |
| 80 | +* [Open Data through R](https://github.com/ropensci/opendata): This Task View contains information about using R to obtain, parse, manipulate, create, and share open data. Much open data is available on the web, and the WebTechnologies TaskView addresses how to obtain and parse web-based data. There is obvious overlap between the two TaskViews, so some packages are described on both. There is also a considerable amount of open data available as R packages on CRAN. |
0 commit comments