Skip to content

Data format

What Kilnvera reads from your firing logs

One row per temperature reading, as most kiln controllers, SCADA historians and data loggers can export. Comma, semicolon and tab separators all work, and header names are matched case-insensitively against the aliases below.

The sample is fictional: 24 batches across two kilns, with faults injected on purpose.

ColumnStatusMeaningAlso accepted
batch_idRequiredBatch, lot or firing-cycle identifier. One file can hold many batches.batch, batch_no, lot, firing_id, cycle_id
timestampRequiredReading time: ISO 8601 (2026-10-05T06:05:00Z), "2026-10-05 06:05", Unix seconds/milliseconds, or minutes from start.time, datetime, recorded_at
temp_cRequiredMeasured kiln temperature in °C.temperature, temp, actual_temp, pv
setpoint_cRequiredProgrammed setpoint in °C at that time.setpoint, set_point, target_temp, sp
kiln_idOptionalKiln or line name, used for filtering.kiln, line
productOptionalProduct, body or SKU.product_type, sku, ware
fuel_m3OptionalFuel used during that reading interval (summed per batch).gas_m3, fuel, gas
load_kgOptionalKiln charge mass for the batch (any row of the batch).charge_kg, load
units_inspectedOptionalPieces inspected for the batch (any row).inspected, pieces_inspected
units_defectiveOptionalPieces rejected for the batch (any row).defective, rejects, pieces_rejected

Limits and handling

  • Files up to 8 MB and 250,000 rows; up to 2,000 batches per file.
  • Rows with a missing batch, unreadable timestamp or non-numeric temperature are skipped and counted in the results.
  • Batches with fewer than 5 readings are skipped. Readings every 1–10 minutes give the most reliable ramp rates.
  • Defect correlations need inspection counts for at least 4 batches.
batch_id,kiln_id,product,timestamp,temp_c,setpoint_c,fuel_m3,load_kg,units_inspected,units_defective
B-2401,K1,Floor tile 600x600,2026-10-05T06:05:00Z,36.1,39.2,3.58,8212,,
B-2401,K1,Floor tile 600x600,2026-10-05T06:10:00Z,44.7,48.3,5.03,,,
...
B-2401,K1,Floor tile 600x600,2026-10-05T22:50:00Z,89.1,80.0,0.29,,391,13