{"record":{"id":"3ca11c52a25f8d73","repo":"stanfordnlp/CoreNLP","slug":"warning-no-coreference-map","errorCode":null,"errorMessage":"Warning: no coreference map!","messagePattern":"Warning: no coreference map!","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"src/edu/stanford/nlp/pipeline/QuoteAttributionAnnotator.java","lineNumber":162,"sourceCode":"  public final boolean VERBOSE;\n\n  // fields\n  private final Set<String> animacyList;\n  private final Set<String> familyRelations;\n  private final Map<String, Person.Gender> genderMap;\n  private Map<String, List<Person>> characterMap;\n  private final String qmSieveList;\n  private final String msSieveList;\n  private final DependencyParser parser;\n\n  public QuoteAttributionAnnotator(Properties props) {\n\n    VERBOSE = PropertiesUtils.getBool(props, \"verbose\", false);\n\n    Timing timer = null;\n    COREF_PATH = props.getProperty(\"booknlpCoref\", null);\n    if (COREF_PATH == null && VERBOSE) {\n      log.err(\"Warning: no coreference map!\");\n    }\n    MODEL_PATH = props.getProperty(\"modelPath\", DEFAULT_MODEL_PATH);\n    CHARACTERS_FILE = props.getProperty(\"charactersPath\", null);\n    if(CHARACTERS_FILE == null && VERBOSE) {\n      log.err(\"Warning: no characters file!\");\n    }\n    qmSieveList = props.getProperty(\"QMSieves\", DEFAULT_QMSIEVES);\n    msSieveList = props.getProperty(\"MSSieves\", DEFAULT_MSSIEVES);\n\n    if (VERBOSE) {\n      timer = new Timing();\n      log.info(\"Loading QuoteAttribution coref [\" + COREF_PATH + \"]...\");\n      log.info(\"Loading QuoteAttribution characters [\" + CHARACTERS_FILE + \"]...\");\n    }\n    // loading all our word lists\n    FAMILY_WORD_LIST = props.getProperty(\"familyWordsFile\", FAMILY_WORD_LIST);\n    ANIMACY_WORD_LIST = props.getProperty(\"animacyWordsFile\", ANIMACY_WORD_LIST);\n    GENDER_WORD_LIST = props.getProperty(\"genderNamesFile\", GENDER_WORD_LIST);","sourceCodeStart":144,"sourceCodeEnd":180,"githubUrl":"https://github.com/stanfordnlp/CoreNLP/blob/1b7edd19c4d0d7b1f13a2591425b9b60a0b1af7a/src/edu/stanford/nlp/pipeline/QuoteAttributionAnnotator.java#L144-L180","documentation":"The QuoteAttributionAnnotator (booknlp-style quote attribution) requires a coreference map file given via the 'booknlpCoref' property. When it is absent and verbose=true, it logs this warning; quote attribution will run with no coreference data and produce degraded (or empty) results.","triggerScenarios":"Adding the 'quoteattribution' annotator to the pipeline without setting props 'booknlpCoref' to a valid coreference file path, with 'verbose' set to true; constructor QuoteAttributionAnnotator(Properties).","commonSituations":"Copying a pipeline config from docs but omitting the booknlp.coref file; path typo so getProperty returns null; running on narrative text expecting character attribution without preparing the coref output.","solutions":["Set properties.setProperty(\"booknlpCoref\", \"/path/to/coref.tsv\") before constructing the annotator","Generate the coreference map first by running the required coref pre-processing for the QuoteAttributionAnnotator","Verify the property key spelling and that the value is not empty/whitespace","Run with verbose=true to confirm which booknlp inputs are missing"],"exampleFix":"// before\nProperties props = new Properties();\nprops.setProperty(\"annotators\", \"tokenize,ssplit,pos,lemma,ner,quoteattribution\");\n// after\nProperties props = new Properties();\nprops.setProperty(\"annotators\", \"tokenize,ssplit,pos,lemma,ner,quoteattribution\");\nprops.setProperty(\"booknlpCoref\", \"/data/book/coref.tsv\");","handlingStrategy":"validation","validationCode":"if (props.getProperty(\"booknlpCoref\") == null) {\n    throw new IllegalArgumentException(\"Set 'booknlpCoref' to the coreference map file before using quoteattribution\");\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Centralize CoreNLP property setup and assert booknlpCoref is present","Keep coref/characters files in a fixed data directory referenced by absolute path"],"tags":["configuration","missing-file","quote-attribution"],"backgroundTag":"missing-config-value","analyzedSha":"1b7edd19c4d0d7b1f13a2591425b9b60a0b1af7a","analyzedAt":"2026-09-10T02:24:07.274Z","contentChangedAt":"2026-09-10T02:24:07.274Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}