Skip to content

Main content

Information: Relative Entropy Single Cell Term Tool

Compute one p*log(p/q) relative-entropy contribution, allowing zero-p limit and rejecting positive p with zero q rather than returning infinity.

Loading tool…

Description

Return p × (ln(p) - ln(q))/ln(base), or zero for p zero.

Divergences and information densities compare probabilities on a common support. A weighted cell contribution and an unweighted logarithmic ratio differ, and zero-support cases require explicit limits.

Return p × (ln(p) - ln(q))/ln(base), or zero for p zero.

When to use this tool

Use Information: Relative Entropy Single Cell Term when you need one precisely defined information-comparison term.

How to use the tool and how it works

  1. Enter p, q, base. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read result. Expand result to inspect the returned fields.

Require p and q in [0, 1], base > 1, and positive q whenever p is positive. Return p × (ln(p) - ln(q))/ln(base), or zero for p zero.1

Input fieldMeaning and unitsAccepted input
pPRequired. Finite number.
qQRequired. Finite number.
baseNumeric base or source quantity interpreted under the specific calculation above.Required. Finite number.
Output fieldInterpretationReturned shape
resultResultRequired. Object.
result.relativeEntropyTermRelative Entropy TermCalculated result member: number.
json
{
  "input": {
    "p": 0.5,
    "q": 0.25,
    "base": 2
  },
  "output": {
    "result": {
      "relativeEntropyTerm": 0.5
    }
  }
}

Limitations and assumptions

  • A single relative-entropy term can be negative; infinite positive-p/zero-q cases are rejected instead of returned as infinity.
  • Outputs are nested inside result. Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Align and validate complete distributions before summing terms or interpreting a full divergence or dependence measure.

References

  1. Calculation and input contract: information/relative-entropy-single-cell-term — tool.io

Similar or alternative tools