specsrbench.paths

Where the inputs and outputs live, and how they are found.

Three layers, in the order they are consulted:

1. Environment variables. SPECSRBENCH_CACHE, SPECSRBENCH_SETS and SPECSRBENCH_FIGURES override everything. An installed wheel has no repo around it, so this is the only mechanism a pip install user has.

2. A repo root walked up from the caller. A directory is the root if it holds cache_logR_tuned/. Note what is not in that test: anything to do with the manuscript. The figures used to require the paper source to sit beside the cache, which made every one of them unbuildable anywhere except inside one particular checkout.

3. The current directory. So that specsrbench figures all in a fresh clone does the obvious thing.

Directories are not created on import. A module that only reads should fail with “no such directory” rather than silently make an empty one and then report a missing file inside it – the failure mode that sends people looking for a corrupted cache when the real problem is that they are in the wrong directory.

Functions

cache_dir()	The tuned cache every figure reads.
describe()	One line per resolved path, for printing at the top of a run.
figures_dir()	Where figure PDFs are written.
repo_root([start])	Directory holding cache_logR_tuned/, or the current directory.
sets_dir()	The paired evaluation/calibration/tuning sets the cache is built from.

specsrbench.paths.repo_root(start=None)

Directory holding cache_logR_tuned/, or the current directory.

Parameters:

start (Path | str | None)

Return type:

Path

specsrbench.paths.cache_dir()

The tuned cache every figure reads.

Return type:

Path

specsrbench.paths.sets_dir()

The paired evaluation/calibration/tuning sets the cache is built from.

Separate from cache_dir() because the two have different lifetimes: the sets come out of specsr and the JADES tree and change only when the models or the split do, while the cache is rebuilt every time a classical parameter moves.

Return type:

Path

specsrbench.paths.figures_dir()

Where figure PDFs are written.

Return type:

Path

specsrbench.paths.describe()

One line per resolved path, for printing at the top of a run.

Return type:

str