Visualize CI runs by test type and job category
This visualization is a stacked bar chart with each bar representing a
job category and each colored segment represesenting a test type.
Change-Id: I4b8c470cef40266bf3dabd1f35a135592619a12c
diff --git a/script/graphs/README.rst b/script/graphs/README.rst
new file mode 100644
index 0000000..10724cb
--- /dev/null
+++ b/script/graphs/README.rst
@@ -0,0 +1,21 @@
+Scripts that Generate Graphs
+============================
+
+This directory contains scripts that generate graphs. Each script is run with
+bash and may require additional tools. All of the scripts require gnuplot.
+
+All scripts produce a PNG graph on stdout and the data on stderr.
+
+Test Runs by category
+---------------------
+
+The script `categorize-tests.bash`, and its associated awk and plot scripts,
+generate a stacked bar chart with bars representing groups of tests (l1 l2,
+etc.) and segments of the bars representing types. `categorize-tests.bash`
+accepts an argument to filter the tests included with grep.
+
+For example, the following will produce a graph of the juno-specific tests:
+
+ bash categorize-tests.bash juno > juno-tests.png 2> juno-tests.txt
+
+*Copyright (c) 2021, Arm Limited. All rights reserved.*