Skip to main content

sigrank-standard (Python)

Portable five-metric core for AI operator token-processing efficiency.

Install

pip install sigrank-standard

Usage

Compute metrics

from sigrank_standard import compute_metrics, build_record

# Four token pillars: input, output, cache_write, cache_read
result = compute_metrics(
    input_tokens=1_251_211,
    output_tokens=11_296_121,
    cache_write=128_196_310,
    cache_read=2_555_179_769,
)
print(result["metrics"])
# {'yield': 18436.98, 'leverage': 2042.2, 'velocity': 9.028, 'snr': 0.9, 'dev10x': 3.31}

Build a full record

from sigrank_standard import build_record
import json

record = build_record(
    input_tokens=1_251_211,
    output_tokens=11_296_121,
    cache_write=128_196_310,
    cache_read=2_555_179_769,
    provider="anthropic",
    model="claude-sonnet-4",
    tool="claude-code",
)
print(json.dumps(record, indent=2))

Run conformance suite

sigrank-conformance
# or
python -m sigrank_standard

Metrics

Metric Formula Description
Yield (Υ) (cache_read * output) / input^2 Token cascade efficiency
Leverage cache_read / input Context reuse
Velocity output / input Output amplification
SNR output / (input + output) Signal cleanliness
10xDEV log10(cache_read / input) Dev leverage

Null semantics

  • When a denominator is zero, the metric is None (not 0 or Infinity)
  • When cache_read is None, Yield, Leverage, and 10xDEV are None
  • When cache_write is None, 10xDEV is None

Spec

SigRank Standard v0.1-draft. See signalaf.com/standard.

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sigrank_standard-0.1.0.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sigrank_standard-0.1.0-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file sigrank_standard-0.1.0.tar.gz.

File metadata

  • Download URL: sigrank_standard-0.1.0.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for sigrank_standard-0.1.0.tar.gz
Algorithm Hash digest
SHA256 cef01fec41e937cf19ce6994ee8376ea9f7bb55f7ab594e2bf06712e44a4c9f7
MD5 ff7811e18c39fc17ed4e0cb240131ef1
BLAKE2b-256 292ea701e2c432d8a961348ed14674753dee38139556c670280c57c17b446201

See more details on using hashes here.

File details

Details for the file sigrank_standard-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sigrank_standard-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0f1aee149ac04d243217eb648e9f57d5f1895ef4a9284a1ab36227aa30112671
MD5 ccded73d89c8fb5cf1ad0fea4266e698
BLAKE2b-256 0cf0d8daaabdaaab2982391a6f01be6dd8c871a0392e56aee45041faf42ed18f

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.5

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page