Restructured data/ into analysis/

README.md

@@ -1,8 +1,8 @@
 # Protocol Bicorder
 
-The Protocol Bicorder is a diagnostic tool for the study of protocols. It allows a human or machine user to evaluate protocol characteristics along a series of gradient scales.
+The Protocol Bicorder is a diagnostic tool for the study of protocols. It allows a human or machine user to evaluate protocol characteristics along a series of gradients between opposing terms.
 
-The name is a tribute to the [tricorder](https://en.wikipedia.org/wiki/Tricorder), a fictional device in the Star Trek franchise that the characters can use to obtain all manner of empirical data about their surroundings.
+The name is a tribute to the [tricorder](https://en.wikipedia.org/wiki/Tricorder), a fictional device in the Star Trek universe that the characters can use to obtain all manner of empirical data about their surroundings. Apparently there was a bicorder in [a 2009 Star Trek comic](https://memory-beta.fandom.com/wiki/Bicorder). The name was [also used](https://hackaday.io/project/11851-bicorder) for a sensing device created by Alex Haim at the 2016 Bay Area Maker Faire.
 
 ## Using the bicorder
 
@@ -29,7 +29,7 @@ To carry out the diagnostic, the analyst should consider the protocol from the p
 
 This is inevitably an interpretive exercise, but do your best to identify the most accurate `value`, with `1` being closest to `term_left` and `9` being closest to `term_right`.
 
-Choosing a `value` in the middle, such as `4`, can mean "a bit of both" or "neither."
+Choosing a `value` in the middle, such as `5`, can mean "a bit of both" or "neither."
 
 ### Analysis
 
@@ -57,6 +57,19 @@ Usage:
 
 An example output file from the template is maintained at `bicorder.txt`.
 
+Each gradient is represented this way:
+
+```
+       term_left < [|||||||||] > term_right
+```
+
+To mark a gradient in a particular place, it is represented with a `#` like this:
+
+```
+       term_left < [||||#||||] > term_right
+```
+
+
 ### Human-usable web app
 
 * Create an online tool for reporting a protocol
@@ -65,16 +78,13 @@ An example output file from the template is maintained at `bicorder.txt`.
     - Auto-analyze
     - Enable it to produce a JSON printout
 
-### Synthetic data analysis
 
-* Experiment plan
-    - Have AIs fill it out with example protocols
-        - Review papers on synthetic datasets
-        - Perhaps use local models or campus Gemini---try two parallel processes with appropriate supervision. Find literature on this. Do parallel processes on both dataset generation and bicorder coding
-        - Make sure to include a broad range of protocols, reflecting diversity of cultures, mediums, and scales
-    - Data analysis of correlations
-        - Which gradients seem to travel together?
-    - Perhaps convert this or generate it in JSON so it is easily machine-ingestible
+## Synthetic data analysis
+
+The bicorder repository is equipped with a synthetic dataset of protocols, as well as AI-generated analysis of that dataset.
+
+See [`analysis/`](analysis/) for complete documentation and materials.
+
 
 <!---
 ## To do
@@ -82,6 +92,9 @@ An example output file from the template is maintained at `bicorder.txt`.
 * Try data analysis
 * Continue iterating on the bicorder design
 * Develop the web app in a way that is tightly bound to the canonical JSON and schema
+* Fill out citations
+* Create script to output a book-friendly chart, utilizing ascii_bicorder but also adding descriptions and footnoted citations
+* Deploy to git.medlab.host
 
 ### Gradient citations