From d2da0425c664f9cf19a1c30169a081699a3dfc1f Mon Sep 17 00:00:00 2001 From: Nathan Schneider Date: Tue, 28 Oct 2025 11:04:06 -0600 Subject: [PATCH] Restructured data/ into analysis/ --- .gitignore | 1 + README.md | 37 +- analysis/.~lock.output-edit.csv# | 1 + analysis/README.md | 27 + analysis/chunk.sh | 8 + analysis/output-edit.csv | 599 ++++++++++++++++ analysis/output-raw.csv | 1107 ++++++++++++++++++++++++++++++ analysis/protocols.csv | 12 + bicorder.json | 10 +- prompts.md | 32 + 10 files changed, 1821 insertions(+), 13 deletions(-) create mode 100644 .gitignore create mode 100644 analysis/.~lock.output-edit.csv# create mode 100644 analysis/README.md create mode 100644 analysis/chunk.sh create mode 100644 analysis/output-edit.csv create mode 100644 analysis/output-raw.csv create mode 100644 analysis/protocols.csv create mode 100644 prompts.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a9a5aec --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +tmp diff --git a/README.md b/README.md index 72776f8..fe451d0 100644 --- a/README.md +++ b/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. +