app/scripts/jitter-trackio-data.mjs

#!/usr/bin/env node

// Jitter Trackio CSV data with small, controlled noise.
// - Preserves comments (# ...) and blank lines
// - Leaves 'epoch' values unchanged
// - Adds mild noise to train/val accuracy (clamped to [0,1])
// - Adds mild noise to train/val loss (kept >= 0)
// - Keeps steps untouched
// Usage:
//   node app/scripts/jitter-trackio-data.mjs \
//     --in app/src/content/assets/data/trackio_wandb_demo.csv \
//     --out app/src/content/assets/data/trackio_wandb_demo.jitter.csv \
//     [--seed 42] [--amount 1.0] [--in-place]

import fs from 'node:fs/promises';
import path from 'node:path';

function parseArgs(argv){
  const args = { in: '', out: '', seed: undefined, amount: 1, inPlace: false };
  for (let i = 2; i < argv.length; i++){
    const a = argv[i];
    if (a === '--in' && argv[i+1]) { args.in = argv[++i]; continue; }
    if (a === '--out' && argv[i+1]) { args.out = argv[++i]; continue; }
    if (a === '--seed' && argv[i+1]) { args.seed = Number(argv[++i]); continue; }
    if (a === '--amount' && argv[i+1]) { args.amount = Number(argv[++i]) || 3; continue; }
    if (a === '--in-place') { args.inPlace = true; continue; }
  }
  if (!args.in) throw new Error('--in is required');
  if (args.inPlace) args.out = args.in;
  if (!args.out) {
    const { dir, name, ext } = path.parse(args.in);
    args.out = path.join(dir, `${name}.jitter${ext || '.csv'}`);
  }
  return args;
}

function mulberry32(seed){
  let t = seed >>> 0;
  return function(){
    t += 0x6D2B79F5;
    let r = Math.imul(t ^ (t >>> 15), 1 | t);
    r ^= r + Math.imul(r ^ (r >>> 7), 61 | r);
    return ((r ^ (r >>> 14)) >>> 0) / 4294967296;
  };
}

function makeRng(seed){
  if (Number.isFinite(seed)) return mulberry32(seed);
  return Math.random;
}

function randn(rng){
  // Box-Muller transform
  let u = 0, v = 0;
  while (u === 0) u = rng();
  while (v === 0) v = rng();
  return Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
}

function jitterValue(metric, value, amount, rng){
  const m = metric.toLowerCase();
  if (m === 'epoch') return value; // keep as-is
  if (m.includes('accuracy')){
    const n = Math.max(-0.02 * amount, Math.min(0.02 * amount, randn(rng) * 0.01 * amount));
    return Math.max(0, Math.min(1, value + n));
  }
  if (m.includes('loss')){
    const n = Math.max(-0.03 * amount, Math.min(0.03 * amount, randn(rng) * 0.01 * amount));
    return Math.max(0, value + n);
  }
  // default: tiny noise
  const n = Math.max(-0.01 * amount, Math.min(0.01 * amount, randn(rng) * 0.005 * amount));
  return value + n;
}

function formatNumberLike(original, value){
  const s = String(original);
  const dot = s.indexOf('.')
  const decimals = dot >= 0 ? (s.length - dot - 1) : 0;
  if (!Number.isFinite(value)) return s;
  if (decimals <= 0) return String(Math.round(value));
  return value.toFixed(decimals);
}

async function main(){
  const args = parseArgs(process.argv);
  const rng = makeRng(args.seed);
  const raw = await fs.readFile(args.in, 'utf8');
  const lines = raw.split(/\r?\n/);
  const out = new Array(lines.length);

  for (let i = 0; i < lines.length; i++){
    const line = lines[i];
    if (!line || line.trim().length === 0) { out[i] = line; continue; }
    if (/^\s*#/.test(line)) { out[i] = line; continue; }

    // Preserve header line unmodified
    if (i === 0 && /^\s*run\s*,\s*step\s*,\s*metric\s*,\s*value\s*,\s*stderr\s*$/i.test(line)) {
      out[i] = line; continue;
    }

    const cols = line.split(',');
    if (cols.length < 4) { out[i] = line; continue; }

    const [run, stepStr, metric, valueStr, stderrStr = ''] = cols;
    const trimmedMetric = (metric || '').trim();
    const valueNum = Number((valueStr || '').trim());

    if (!Number.isFinite(valueNum)) { out[i] = line; continue; }

    const jittered = jitterValue(trimmedMetric, valueNum, args.amount, rng);
    const valueOut = formatNumberLike(valueStr, jittered);

    // Reassemble with original column count and positions
    const result = [run, stepStr, metric, valueOut, stderrStr].join(',');
    out[i] = result;
  }

  const finalText = out.join('\n');
  await fs.writeFile(args.out, finalText, 'utf8');
  const relIn = path.relative(process.cwd(), args.in);
  const relOut = path.relative(process.cwd(), args.out);
  console.log(`Jittered data written: ${relOut} (from ${relIn})`);
}

main().catch(err => {
  console.error(err?.stack || String(err));
  process.exit(1);
});