commit 0a3a035cc794a63af63c86c0c68decfdb2d808f2 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Mon Aug 8 13:58:58 2022 -0400 Updates diff --git a/graphs.md b/graphs.md index 595a7d2..757574f 100644 --- a/graphs.md +++ b/graphs.md @@ -1,6 +1,9 @@ -# Graphs and Charts +--- +pagetitle: Good Graphs and Charts +version: 1.2 +--- -v1.1 +# Good Graphs and Charts + Graphs, charts and tables that include a mean must also include a measure of spread, such as standard deviation, standard error or commit 2d03f9c99e085311599c9f415bcbd37dc777bc6b Author: Mark Claypool <claypool@cs.wpi.edu> Date: Sun Mar 27 09:14:39 2022 -0400 Updates diff --git a/graphs.md b/graphs.md index d02625b..595a7d2 100644 --- a/graphs.md +++ b/graphs.md @@ -29,8 +29,8 @@ v1.1 + Pie charts are almost always the wrong graph type to pick. -+ For comparing distributions, consider a box and whiskers plot - instead, or a cumulative distribution function. ++ For comparing distributions, instead of a histogram consider a box + and whiskers plot or a cumulative distribution function. + For graphs with 2+ data sets, be sure to include a legend, spaced with a readable font. commit 507329de461ad83aaa712d9762f0d2a1bb91c678 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Sat Feb 26 10:55:36 2022 -0500 Updates diff --git a/graphs.md b/graphs.md index 2a65d46..d02625b 100644 --- a/graphs.md +++ b/graphs.md @@ -57,4 +57,4 @@ Summing this up, below is an example: <https://web.cs.wpi.edu/~imgd2905/d20/samples/analysis-example.html> Do not worry about the data - instead look at the form. Note -especially 6 guidelines at the top. +especially the 6 guidelines at the top. commit 13647cf9078d66b1182de2b31c5fbd3f4fbedc0c Author: Mark Claypool <claypool@cs.wpi.edu> Date: Fri Sep 18 09:12:35 2020 -0400 Updates diff --git a/graphs.md b/graphs.md index 231668b..2a65d46 100644 --- a/graphs.md +++ b/graphs.md @@ -1,6 +1,6 @@ # Graphs and Charts -v1.0 +v1.1 + Graphs, charts and tables that include a mean must also include a measure of spread, such as standard deviation, standard error or @@ -52,3 +52,9 @@ v1.0 Capitalize "Figure" when referring to it by number (e.g., "The results in Figure 3...") +Summing this up, below is an example: + +<https://web.cs.wpi.edu/~imgd2905/d20/samples/analysis-example.html> + +Do not worry about the data - instead look at the form. Note +especially 6 guidelines at the top. commit d4128661ee0785908dc7548a8b4ee9b53509e7fe Author: Mark Claypool <claypool@cs.wpi.edu> Date: Tue Feb 25 06:22:58 2020 -0500 Updates diff --git a/graphs.md b/graphs.md new file mode 100644 index 0000000..231668b --- /dev/null +++ b/graphs.md @@ -0,0 +1,54 @@ +# Graphs and Charts + +v1.0 + ++ Graphs, charts and tables that include a mean must also include a + measure of spread, such as standard deviation, standard error or + confidence intervals. In a graph, this can be done with error bars + bounding the mean. + ++ Tick marks along axes should be reasonable (e.g., "10, 20, 30..." + and not "2, 5, 8..."). + ++ Quantitative data along an axes should be spaced according to it's + magnitude (e.g., 8 should be twice as far from the origin as 4). + ++ The bottom left corner of a graph should be (0,0) unless there is a + really good reason. + ++ Axes should *not* be in logscale unless there is a really good + reason. + ++ All axes must be labeled (e.g., "Bitrate") and given units (e.g., + "(Mb/s)"). + ++ Make sure any screenshots and graphs have readable fonts, + particularly if they are shrunk to fit. As a guideline, the font in + the graph should be the same size or just slightly smaller than the + reports main text font. + ++ Pie charts are almost always the wrong graph type to pick. + ++ For comparing distributions, consider a box and whiskers plot + instead, or a cumulative distribution function. + ++ For graphs with 2+ data sets, be sure to include a legend, spaced + with a readable font. + ++ Use of colors in graphs is encouraged, but also differentiate data + sets with symbols and hashing. + ++ A title on the graph is useful for discussions, but when the graph + goes in a report the title should be removed and replaced with a + figure number and caption. + ++ All Graphs, Charts (and tables) must be accompanied by have figure + numbers followed by a caption, even if the caption is already + written inside the figure. E.g. "Figure 4: Results of first trial + run." + ++ Each figure must be referred to at least once in the text, telling + the user what to look for in that figure. E.g. "Figure 4 shows...." + Capitalize "Figure" when referring to it by number (e.g., "The + results in Figure 3...") +