OPLS Component Variance

Partition caller-provided OPLS predictive and orthogonal variance.

Description

OPLS variance summaries separate predictive, orthogonal and residual components supplied by an upstream model.

OPLS variance summaries separate predictive, orthogonal and residual components supplied by an upstream model. The two percentages use different denominators.^[1]

Partition caller-provided OPLS predictive and orthogonal variance.

When to use OPLS Component Variance

Use this tool to partition caller-provided OPLS predictive and orthogonal variance.

Prepare the measured profile, formula counts, upstream model outputs or caller-defined reference criteria requested. Keep paired entries aligned and units, sample basis and preprocessing consistent.

How to use OPLS Component Variance and understand its results

Prepare the measured profile, formula counts, upstream model outputs or caller-defined reference criteria requested. Keep paired entries aligned and units, sample basis and preprocessing consistent.
Enter predictiveVariance, orthogonalVariance, residualVariance using the field table and calculation rules, then run the tool.
Read explainedPercent, predictiveShareOfExplainedPercent. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
predictiveVariance	Predictive variance	number	Required
orthogonalVariance	Orthogonal variance	number	Required
residualVariance	Residual variance	number	Required

Enter nonnegative component variances with positive total and positive explained sum. Return explained fraction of total and predictive fraction of explained variance.

explained%=100(P+O)/(P+O+R); predictive%=100P/(P+O)

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
explainedPercent	Explained percent	number
predictiveShareOfExplainedPercent	Predictive share of explained percent	number

json

{
  "input": {
    "predictiveVariance": 30,
    "orthogonalVariance": 20,
    "residualVariance": 50
  },
  "output": {
    "explainedPercent": 50,
    "predictiveShareOfExplainedPercent": 60
  }
}

Limitations and assumptions

No OPLS model, component extraction, validation or significance test is performed.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use VIP Threshold Gate: Gate variable-importance scores against a supplied VIP minimum. For a complementary task, use Q Residual Gate: Flag samples exceeding a caller-selected Q-residual model-fit limit.

References

OPLS Component Variance — tool.io

Similar or alternative tools

VIP Threshold Gate
Gate variable-importance scores against a supplied VIP minimum.
Q Residual Gate
Flag samples exceeding a caller-selected Q-residual model-fit limit.