Quickstart

This example shows the shortest meaningful path through drcutils.

1. Install

pip install drcutils

Or install from source:

git clone https://github.com/cmudrc/drcutils.git
cd drcutils
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e .

2. Minimal Runnable Example

import matplotlib.pyplot as plt

from drcutils import convert, export_figure, is_notebook

convert("inputs/study.csv", "artifacts/study.json")

fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])
result = export_figure(fig, "artifacts/figures/main_result")

print(is_notebook())
print(result["files"])

3. What Happened

You converted a data artifact, exported a publication-style figure, and checked runtime context. This is the most common internal-lab usage pattern.

4. Where To Go Next

Ecosystem Note

In typical lab workflows, drcutils is the support layer used alongside design-research-agents, design-research-problems, design-research-experiments, and design-research-analysis.