Experiment Template

1{
2  "cells": [
3    {
4      "cell_type": "markdown",
5      "metadata": {},
6      "source": [
7        "# Experiment: TITLE\n",
8        "\n",
9        "Objective:\n",
10        "- State the question you want to answer.\n",
11        "- Define the success criteria.\n"
12      ]
13    },
14    {
15      "cell_type": "code",
16      "execution_count": null,
17      "metadata": {},
18      "outputs": [],
19      "source": [
20        "# Setup: imports and reproducibility\n",
21        "from __future__ import annotations\n",
22        "\n",
23        "import random\n",
24        "import statistics\n",
25        "\n",
26        "SEED = 7\n",
27        "random.seed(SEED)\n",
28        "SEED\n"
29      ]
30    },
31    {
32      "cell_type": "markdown",
33      "metadata": {},
34      "source": [
35        "## Plan\n",
36        "\n",
37        "- Hypothesis:\n",
38        "- Variables to sweep:\n",
39        "- Metrics to record:\n"
40      ]
41    },
42    {
43      "cell_type": "code",
44      "execution_count": null,
45      "metadata": {},
46      "outputs": [],
47      "source": [
48        "# Define parameters and lightweight helpers\n",
49        "sample_size = 20\n",
50        "values = [random.random() for _ in range(sample_size)]\n",
51        "summary = {\n",
52        "    \"count\": len(values),\n",
53        "    \"mean\": statistics.fmean(values),\n",
54        "    \"min\": min(values),\n",
55        "    \"max\": max(values),\n",
56        "}\n",
57        "summary\n"
58      ]
59    },
60    {
61      "cell_type": "markdown",
62      "metadata": {},
63      "source": [
64        "## Results\n",
65        "\n",
66        "- Key observations:\n",
67        "- Surprises or failure modes:\n",
68        "- Decision: continue, pivot, or stop:\n"
69      ]
70    },
71    {
72      "cell_type": "code",
73      "execution_count": null,
74      "metadata": {},
75      "outputs": [],
76      "source": [
77        "# Record findings in a minimal, copy-pasteable structure\n",
78        "result = {\n",
79        "    \"seed\": SEED,\n",
80        "    \"mean\": summary[\"mean\"],\n",
81        "    \"range\": summary[\"max\"] - summary[\"min\"],\n",
82        "}\n",
83        "result\n"
84      ]
85    },
86    {
87      "cell_type": "markdown",
88      "metadata": {},
89      "source": [
90        "## Next steps\n",
91        "\n",
92        "- What to try next:\n",
93        "- What to document elsewhere (PRD, notes, issue):\n"
94      ]
95    }
96  ],
97  "metadata": {
98    "kernelspec": {
99      "display_name": "Python 3",
100      "language": "python",
101      "name": "python3"
102    },
103    "language_info": {
104      "name": "python",
105      "version": "3.12"
106    }
107  },
108  "nbformat": 4,
109  "nbformat_minor": 5
110}