v1.0

Data Dictionary

Input formats, output columns, and field definitions for the Decision Machine platform.

Input Time-Series CSV

SML-App accepts time-series data as CSV files uploaded through the Time-Series Views panel. Each file represents one or more time-series to be analysed.

Format Requirements
RuleDetail
First columnDate in YYYY-MM-DD format — required on every data row
Remaining columnsNumeric time-series values — at least one column required, maximum of 25
Header rowRequired — first row must contain column names
Minimum rowsAt least fifty rows beyond the header
File type.csv only — .xlsx and other formats are rejected
EncodingUTF-8 or UTF-8 BOM
Example
date,price,volume 2024-01-01,142.50,1200000 2024-01-02,143.75,980000 2024-01-03,141.20,1450000
Validation Rules

SML-App validates the following on upload:

CheckDetail
Date column presentAll values in column 1 must match YYYY-MM-DD
Numeric columns presentAt least one column beyond the date column is required, with a maximum of 25 columns
Minimum lengthAt least 50 data rows required
File typeOnly .csv accepted at upload
Known Gaps
Note: The following validations are not currently performed at upload time and are on the roadmap.
Missing values — blank cells are not detected at upload. A CSV with missing values will pass validation but may produce a pipeline error during SML processing.
Non-numeric data — text in numeric columns is not validated at upload time.
Date gaps — non-contiguous date sequences are not detected.

Binary Output

Triggered by submitting a Binary job from the SML Measurements panel. Uses the config_ prefix file. Machine learned measurement dynamics in a generally non-equilibrium setting — any time-series of values can be equally well processed.

The output CSV is served by SML-App with an injected header row. The file on disk contains no header — the column names are added at serve time by the local Flask server.
Output Columns
Symbol Time-series identifier String

Time-series identifier derived from the input filename.

TS Timestamp YYYY-MM-DD

Date of the measurement, corresponding to the input date column.

value Raw measured value Float, 4 d.p.

The raw measured value from the input time-series at this timestamp.

p+ Probability of upward movement Float, 4 d.p.

Computed, machine learned probability that the value will go up in the next time step. Computed exactly up to machine error.

The probability is a function of the system energy and process extent (Lagrange multiplier).

p- Probability of downward or flat movement Float, 4 d.p.

Computed, machine learned probability that the value will go down or stay the same in the next time step. Computed exactly up to machine error.

The probability is a function of the system energy and process extent (Lagrange multiplier).

energy System energy from equilibrium Float, 4 d.p.

Computed, machine learned system energy measured from equilibrium as a zero offset. Positive: Bull. Negative: Bear. Internally generated energy could include emotions (plural) — human-generated displacement energy from equilibrium.

At equilibrium, the probability that an asset price will go up equals the probability that it won't (an "unbiased coin"). Markets are driven by emotions which throw participants into non-equilibrium almost all of the time. The energy/emotions measurement quantifies how far away the data is from statistical equilibrium.

power Rate of energy flow per time step Float, 4 d.p.

Rate of energy flow per time step. Combines Emotion and Resistance. At equilibrium, Power = Emotion² / R (V²/2R). Power is the energy available to perform work — "to move the needle".

resistance Market resistance to changing price Float, 4 d.p.

Wherever there is energy available to move the needle, there is also resistance. The more resistance, the harder it is to move the needle. Resistance is not constant in systems that are not in equilibrium.

noise Nyquist noise dissipating system energy Float, 4 d.p.

Computed, machine learned market (Nyquist) noise that dissipates system energy so that it cannot be used for price movement. Power can be wasted through dissipation (strain or viscosity), making it unavailable to do work. As noise increases, the amount of wasted power increases.

T Entropic temperature of the system Alpha-numeric

The entropic temperature of the system. Temperature is the reciprocal of the derivative of entropy with respect to energy — the general definition of entropic temperature.

In non-equilibrium dynamics, free energy and temperature are coupled to produce a heat engine. By observing free energy and temperature together, price entry and exit points can be identified. Recommended to plot as a double-sided plot alongside free energy.

FE Helmholtz free energy Float, 4 d.p.

Helmholtz free energy (F = E − TS). The total energy/emotion available to do useful work. Minimum Free Energy is a more convenient form of maximum entropy in non-equilibrium problems.

When free energy decreases it does work in the dominant emotion (bull or bear). Local maxima indicate when energy is available for price movement — an entry point. After the price movement a local minimum develops, equivalent to maximum entropy. The stable minimum signifies an exit point for the dominant emotion trade.

therm_p+ Thermal probability of upward movement Float, 4 d.p.

Computed, machine learned probability that the value will go up in the next time step when in a thermal bath of temperature T_R. Where thermal probabilities dominate over p+ and p-, thermal probabilities drive price movement.

The thermal probabilities depend on the temperature difference between the system temperature and the reservoir temperature T_R. Decision Machine uses a default value for T_R at statistical equilibrium (T_R = e/4) but it can and should be set by the customer in the configuration file.

A dissipative system is a thermodynamically open system operating out of, and often far from, statistical or thermal equilibrium, exchanging energy and information with its environment.

therm_p- Thermal probability of downward or flat movement Float, 4 d.p.

Computed, machine learned probability that the value will not go up in the next time step when in a thermal bath of temperature T_R. See therm_p+ for full description of thermal probabilities and dissipative systems.

Units Output

Triggered by submitting a Units job from the SML Measurements panel. Uses the measure_ prefix file. Scientific measurements of time-series dynamics based on the science of counting — counting units of measure with constraints on maximum entropy.

Note The column definitions below represent the intended end state of the Units output. The current pipeline produces a superset of scientific measurements; the columns below reflect the target reporting set.
Output Columns
Symbol Time-series identifier String

Time-series identifier derived from the input filename.

TS Timestamp YYYY-MM-DD

Date of the measurement, corresponding to the input date column.

value Raw measured value Float, 4 d.p.

The raw measured value from the input time-series at this timestamp.

p Momentum Float, 4 d.p.

Momentum measures the inertia of the time-series. As momentum increases, greater force is needed to produce a given deviation from the current direction.

When displacement velocity vanishes (v = 0), momentum equals the mass (p = m). When E ≠ 0, p = m·exp(v). Note: momentum is non-linear and not equal to mv.

Dispersion relations define the algebraic relationships between mass, momentum, and displacement energy measured from equilibrium.

E Displacement energy from equilibrium Float, 4 d.p.

The energy at equilibrium is subtracted from the total system energy to give the displacement energy. When E = 0, the system is in equilibrium — all states are equally likely, with no energy entering or exiting the system. When E ≠ 0, energy enters (E > 0) or exits (E < 0). Non-zero displacement energy signals non-equilibrium behavior.

T Entropic temperature Float, 4 d.p.

The entropic temperature of the system.

T_B Body temperature — reservoir temperature Float, 4 d.p.

Body temperature of the system — same as the reservoir temperature. Thermodynamic expressions define relationships between E, free energy, T, free entropy, and T_B through the second law: ⟨F⟩ ≡ T⟨A⟩/T_B = E − TS, offset from equilibrium.

When in thermal equilibrium, T = T_B and classical thermodynamics is regained. Equilibrium is not assumed and is infrequently observed in time-series.

exp_n Expected Supply ⟨ξ⟩ Float, 4 d.p.

Expected Supply ⟨ξ⟩. Combines the expected count and the expected strain (energy stored in extension). Defined by the affine connection as part of Natural Dynamics.

exp_strain Expected strain component of supply Float, 4 d.p.

Expected strain component of the supply measurement.

exp_demand Expected Demand ⟨η⟩ Float, 4 d.p.

Expected Demand ⟨η⟩. The expected value minus the expected strain — an extension that stores energy. Defined by the affine connection as part of Natural Dynamics.

sus_n Sustained supply count Float, 4 d.p.

Sustained supply count.

sus_strain Sustained strain component Float, 4 d.p.

Sustained strain component.

sus_E Sustained displacement energy Float, 4 d.p.

Sustained displacement energy.

sus_demand Sustained demand Float, 4 d.p.

Sustained demand.

var_n Variance of supply count Float, 4 d.p.

Variance of supply count.

var_strain Variance of strain Float, 4 d.p.

Variance of strain.

var_E Variance of displacement energy Float, 4 d.p.

Variance of displacement energy.

var_del_n Variance of change in supply count Float, 4 d.p.

Variance of change in supply count.

cov_n_strain Covariance of supply count and strain Float, 4 d.p.

Covariance of supply count and strain.

Thermodynamic Relationships
Free entropy: ⟨M⟩ = S − E/T (Massieu free entropy). The slope of the free entropy equals −F, the force due to the potential.

Free energy: ⟨F⟩ ≡ T⟨A⟩/T_B = E − TS, offset from equilibrium.

Entropy: S(λ,E) — the number of different counting configurations possible when subjected to the constraints of counting the time-series. A function of the Lagrange multiplier λ and displacement energy E. In general, S and entropic temperature 1/T = ∂S/∂E are not constant.