Skip to main content
Use the joint atoms when your decision depends on a combination of outcomes, such as high demand and low generation. Use marginals for a summary of one target. The branches list is limited by max_branches. Use receipt.atoms when you need the full retained forecast support. Numeric marginals contain mean and quantiles with keys "0.05", "0.5", and "0.95". Categorical marginals contain probabilities. Category keys are canonical JSON: a boolean key is "true", while a string category’s key includes its JSON quotes. Use json.loads(key) when decoding those labels in Python. The displayed branch probabilities plus omitted_probability should sum to one, within floating-point tolerance. Do not rescale the visible branches to one and silently discard omitted mass. Numeric branches are distribution representatives, not a statement that only those exact physical values can occur.

Read the joint atoms

Read transition_prediction.futures.receipt.atoms when status is predicted. The atom list describes the support used for this forecast, which is bounded by max_support. Check that the returned weights sum to one within rounding tolerance before calculating a joint event or expected cost. When your response contains only displayed branches, carry omitted_probability into any calculation that depends on the missing mass. This example calculates the probability of high demand and low generation in the same interval. Use thresholds in the same units as the atoms. The issued distribution uses probability. To compare conditioning with its prior after the outcome arrives, score the same support with prior and conditional separately. Both sets of weights are available in the receipt, so that comparison needs no additional query.
The joint demand and generation recipe uses these target paths. For its physical-unit thresholds, restore any scaling before calling the event predicate or express the thresholds on the sent scale.

Forecast a changing numeric level

Set this inside the transition declaration:
Put this fragment under learning.transition in the Domain declaration. To tune a fit that is sensitive to large or collinear inputs, see Tune a Domain for your stream. The mode learns how the numeric outcome’s typical level depends on current inputs, then carries the observed residual uncertainty around that level. It is useful when returning only absolute historical outcomes would miss a changing numeric level. Multiple targets still form a joint forecast. Inspect futures.numeric_transport.status:
  • active: one or more numeric targets passed the transport validation gate.
  • inactive: no applicable transport was requested or available for these inputs.
  • unavailable: a transport fit could not pass the support/validation conditions.
If transport cannot be used, the empirical futures forecast can still be returned. Check target_paths to see which numeric targets were transported. linear_residual is not a feedback-policy model class. It does not mean learning.training.model_type: "linear_residual", which is invalid. The transition’s existing numeric_model setting separately controls the point predictor. Selecting numeric transport does not silently switch that predictor. Quantile bounds are forecast summaries, not guaranteed real-world coverage. Transport does not automatically enforce physical limits on predicted values.