stanfordnlp/CoreNLP · error · IllegalStateException

Unhandled natural logic relation: " + insertionRel

Error message

Unhandled natural logic relation: " + insertionRel

What it means

insertionToDeletion() maps an insertion relation to its dual deletion relation; the switch handles FORWARD/REVERSE_ENTAILMENT, NEGATION, ALTERNATION, COVER, and INDEPENDENCE. The default branch throws an IllegalStateException for any other relation, meaning an unexpected enum value (or null via switch on null) reached the method.

Solutions

1. Ensure the relation passed in comes from the standard NaturalLogicRelation constants, not from manual index conversion.
2. Null-check the argument before calling to avoid falling into the default branch.
3. If you added enum constants, add matching cases in insertionToDeletion (and forDependencyDeletion).

Example fix

// before
NaturalLogicRelation del = NaturalLogicRelation.insertionToDeletion(rel);
// after
if (rel != null) {
  NaturalLogicRelation del = NaturalLogicRelation.insertionToDeletion(rel);
}

if (insertionRel == null) throw new IllegalArgumentException("insertion relation required");

try {
  del = NaturalLogicRelation.insertionToDeletion(rel);
} catch (IllegalStateException e) {
  log.warn("Unhandled relation " + rel + ", defaulting to INDEPENDENCE");
  del = NaturalLogicRelation.INDEPENDENCE;
}

When it happens

Trigger: Calling insertionToDeletion with null (default branch in a switch on null throws NPE in older style, or hits default semantics) or an unexpected relation constant, typically reached via forDependencyDeletion when a computed insertion relation is invalid.

Common situations: Modified enum constants in forks; passing a relation computed by buggy index conversion code.

Understand the failure class

Background: Invalid enum value errors: "Unknown type", "Invalid scope", "must be one of" — when a string is not on the library's allowed list — this error's family across 23 libraries.

Related errors

• [should be impossible]: Incomplete join table for " + this…
• Cannot run Natural Logic forward entailment without…
• check flag in markMentionRelation…
• Comparing a mention with itself for representativeness
• Could not load clause splitter model at " + splitterModel

AI-assisted analysis of stanfordnlp/CoreNLP@1b7edd19c4 (2026-09-10). Data as JSON: /api/errors/20d5d286d90075d0. Report an issue: GitHub.

Appendix: source

Thrown at src/edu/stanford/nlp/naturalli/NaturalLogicRelation.java:602

      } else if (dependencyLabel.startsWith("advcl")) {
        return NaturalLogicRelation.REVERSE_ENTAILMENT;
      } else {
        return NaturalLogicRelation.INDEPENDENCE;
      }
    }
  }

  private static NaturalLogicRelation insertionToDeletion(NaturalLogicRelation insertionRel) {
    switch (insertionRel) {
      case EQUIVALENT: return EQUIVALENT;
      case FORWARD_ENTAILMENT: return REVERSE_ENTAILMENT;
      case REVERSE_ENTAILMENT: return FORWARD_ENTAILMENT;
      case NEGATION: return NEGATION;
      case ALTERNATION: return COVER;
      case COVER: return ALTERNATION;
      case INDEPENDENCE: return INDEPENDENCE;
      default:
        throw new IllegalStateException("Unhandled natural logic relation: " + insertionRel);
    }
  }

  /**
   * Returns the natural logic relation corresponding to the given dependency arc being deleted from a sentence.
   */
  public static NaturalLogicRelation forDependencyDeletion(String dependencyLabel) {
    return forDependencyDeletion(dependencyLabel, true);
  }

  /**
   * Returns the natural logic relation corresponding to the given dependency arc being deleted from a sentence.
   * @param dependencyLabel The label we are checking the relation for
   * @param isSubject Whether this is on the subject side of a relation (e.g., for CONJ_OR edges)
   */
  public static NaturalLogicRelation forDependencyDeletion(String dependencyLabel, boolean isSubject) {
    NaturalLogicRelation rel = forDependencyInsertion(dependencyLabel, isSubject);
    return insertionToDeletion(rel);

View on GitHub (pinned to 1b7edd19c4)