Compartment Sign Switch

Detect A/B compartment eigenvector sign-switch boundaries.

Description

Compartment-vector sign changes compare supplied assignments, skipping zeros.

Compartment-vector sign changes compare supplied assignments, skipping zeros.^[1]

Detect A/B compartment eigenvector sign-switch boundaries.

When to use Compartment Sign Switch

Use this tool to detect A/B compartment eigenvector sign-switch boundaries.

Prepare the already measured signals, counts, coordinates, fitted coefficients or sequence strings requested. Keep assay definitions, units, aligned lists and caller-selected thresholds consistent.

How to use Compartment Sign Switch and understand its results

Prepare the already measured signals, counts, coordinates, fitted coefficients or sequence strings requested. Keep assay definitions, units, aligned lists and caller-selected thresholds consistent.
Enter compartmentEigenvector using the field table and calculation rules, then run the tool.
Read switchIndexes, switchCount, positiveSegmentCount. 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
compartmentEigenvector	Compartment eigenvector values	list of number	Required

Enter nonempty finite vector; return switch indices and positive-segment count.

record later zero-based index when successive nonzero signs differ

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

Output field	Meaning	Value type
switchIndexes	Indexes where sign switches	list of number
switchCount	Sign-switch count	integer; minimum: 0
positiveSegmentCount	Positive compartment segments	integer; minimum: 0

json

{
  "input": {
    "compartmentEigenvector": [
      1,
      2,
      -1,
      -2,
      3
    ]
  },
  "output": {
    "switchIndexes": [
      2,
      4
    ],
    "switchCount": 2,
    "positiveSegmentCount": 2
  }
}

Limitations and assumptions

Positive counting starts only when the first entry is positive: leading zeros then positives are not initially counted. No vector is fitted.

Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Insulation Local Minimum: Find the lowest insulation score within an interior search range. For a complementary task, use Matrix Row Balance: Measure matrix row-sum balance by coefficient of variation.

References

Compartment Sign Switch — tool.io

Similar or alternative tools

Insulation Local Minimum
Find the lowest insulation score within an interior search range.
Matrix Row Balance
Measure matrix row-sum balance by coefficient of variation.