larc-iu/dmrst-ettin-400m-rstdt-coarse

A pretrained DMRST parser trained with Dipo.

This model uses jhu-clsp/ettin-encoder-400m as its underlying encoder.

Data

RST Discourse Treebank (RST-DT) (English). 385 WSJ articles from the Penn Treebank, annotated in RST with a fine-grained relation inventory. RST-DT is the traditional English benchmark for RST parsing. This model was trained on the original, untokenized EDU text of the LDC release, to match raw input.

Relation labels: Mapped from an original label inventory with 111 items to 18 labels. Mapped labels:

attribution, background, cause, comparison, condition, contrast, elaboration, enablement, evaluation, explanation, joint, manner-means, same-unit, summary, temporal, textual-organization, topic-change, topic-comment

Metrics

F1 x 100 under original Parseval, with trivial leaf spans excluded. E2E scores parse trees predicted from raw text, segmentation included. Gold-EDU scores them given the gold EDU segmentation. Seg is the per-token BeginSeg F1 computed during training, which can read up to about a point below the official DISRPT scorer's value. The checkpoint was selected on dev e2e_full_f1.

Usage

Install the library first with pip install dipo.

CLI

dipo dmrst predict \
    --hub-id larc-iu/dmrst-ettin-400m-rstdt-coarse \
    --text 'Although the experiment was carefully designed, the results were inconclusive. We plan to repeat it tonight.'

To parse a raw .txt file or a directory of them instead, use --text-file <path> --output-dir out/.

Python

from dipo.rst.parsers.dmrst.modeling_dmrst import DMRSTParser

parser = DMRSTParser.from_pretrained("larc-iu/dmrst-ettin-400m-rstdt-coarse")
tree = parser.predict_from_text(
    "Although the experiment was carefully designed, the results were inconclusive. We plan to repeat it tonight."
)
print(tree.to_rs4_string())

Citation

If you use this model, please cite both the underlying paper:

@inproceedings{dmrst_paper,
  title = {DMRST: A Joint Framework for Document-Level Multilingual RST Discourse Segmentation and Parsing},
  author = {Zhengyuan Liu, Ke Shi, Nancy F. Chen},
  booktitle = {CODI 2021},
  url = {https://aclanthology.org/2021.codi-main.15/},
}

And the Dipo library:

@misc{gessler-dipo-2026,
  author       = {Gessler, Luke},
  title        = {{Dipo: The Discourse Parsing Omnibus}},
  year         = {2026},
  howpublished = {\url{https://github.com/larc-iu/dipo}},
}

Notes

• Input: Raw running text. Line breaks and other whitespace are fine, so there is no need to tokenize or clean the text first.
• Training: Trained on the training split only, with the checkpoint chosen on the dev split. Scores are from a single training run, and run-to-run variation on small test sets can be several points.
• Line structure: The model reads text with all whitespace collapsed, so it cannot see line breaks itself. predict_from_text therefore also starts a new segment at each blank-line paragraph break and after short heading-like lines (break_at_paragraphs=False turns this off). Hard-wrapped prose is left alone.
• License: Derived from jhu-clsp/ettin-encoder-400m, so use of these weights is subject to that model's terms: MIT.
• Data terms: Trained on RST-DT (LDC2002T07), which the Linguistic Data Consortium distributes under its user agreement. Check that your use is permitted by it.
• Intended use: Research and analysis of text. The weights carry the terms of the base model and of the training corpus above, and the scores on this card come from this checkpoint and not from the runs reported in the accompanying paper.

Full training configuration

See below for the full training configuration this model was trained with.

{
  "train_dir": "data/rstdt_notok/train",
  "dev_dir": "data/rstdt_notok/dev",
  "test_dir": "data/rstdt_notok/test",
  "relation_types": [
    [
      "attribution",
      "rst"
    ],
    [
      "background",
      "rst"
    ],
    [
      "cause",
      "multinuc"
    ],
    [
      "cause",
      "rst"
    ],
    [
      "comparison",
      "multinuc"
    ],
    [
      "comparison",
      "rst"
    ],
    [
      "condition",
      "multinuc"
    ],
    [
      "condition",
      "rst"
    ],
    [
      "contrast",
      "multinuc"
    ],
    [
      "contrast",
      "rst"
    ],
    [
      "elaboration",
      "rst"
    ],
    [
      "enablement",
      "rst"
    ],
    [
      "evaluation",
      "multinuc"
    ],
    [
      "evaluation",
      "rst"
    ],
    [
      "explanation",
      "multinuc"
    ],
    [
      "explanation",
      "rst"
    ],
    [
      "joint",
      "multinuc"
    ],
    [
      "manner-means",
      "rst"
    ],
    [
      "same-unit",
      "multinuc"
    ],
    [
      "summary",
      "rst"
    ],
    [
      "temporal",
      "multinuc"
    ],
    [
      "temporal",
      "rst"
    ],
    [
      "textual-organization",
      "multinuc"
    ],
    [
      "topic-change",
      "multinuc"
    ],
    [
      "topic-change",
      "rst"
    ],
    [
      "topic-comment",
      "multinuc"
    ],
    [
      "topic-comment",
      "rst"
    ]
  ],
  "relation_map": {
    "Analogy": "comparison",
    "Cause-Result": "cause",
    "Comment-Topic": "topic-comment",
    "Comparison": "comparison",
    "Consequence": "cause",
    "Contrast": "contrast",
    "Disjunction": "joint",
    "Evaluation": "evaluation",
    "Interpretation": "evaluation",
    "Inverted-Sequence": "temporal",
    "List": "joint",
    "Otherwise": "condition",
    "Problem-Solution": "topic-comment",
    "Proportion": "comparison",
    "Question-Answer": "topic-comment",
    "Reason": "explanation",
    "Same-Unit": "same-unit",
    "Sequence": "temporal",
    "Statement-Response": "topic-comment",
    "Temporal-Same-Time": "temporal",
    "TextualOrganization": "textual-organization",
    "Topic-Comment": "topic-comment",
    "Topic-Drift": "topic-change",
    "Topic-Shift": "topic-change",
    "analogy": "comparison",
    "analogy-e": "comparison",
    "antithesis": "contrast",
    "antithesis-e": "contrast",
    "attribution": "attribution",
    "attribution-e": "attribution",
    "attribution-n": "attribution",
    "background": "background",
    "background-e": "background",
    "cause": "cause",
    "circumstance": "background",
    "circumstance-e": "background",
    "comment": "evaluation",
    "comment-e": "evaluation",
    "comparison": "comparison",
    "comparison-e": "comparison",
    "concession": "contrast",
    "concession-e": "contrast",
    "conclusion": "evaluation",
    "condition": "condition",
    "condition-e": "condition",
    "consequence-n": "cause",
    "consequence-n-e": "cause",
    "consequence-s": "cause",
    "consequence-s-e": "cause",
    "contingency": "condition",
    "definition": "elaboration",
    "definition-e": "elaboration",
    "elaboration-additional": "elaboration",
    "elaboration-additional-e": "elaboration",
    "elaboration-general-specific": "elaboration",
    "elaboration-general-specific-e": "elaboration",
    "elaboration-object-attribute": "elaboration",
    "elaboration-object-attribute-e": "elaboration",
    "elaboration-part-whole": "elaboration",
    "elaboration-part-whole-e": "elaboration",
    "elaboration-process-step": "elaboration",
    "elaboration-process-step-e": "elaboration",
    "elaboration-set-member": "elaboration",
    "elaboration-set-member-e": "elaboration",
    "enablement": "enablement",
    "enablement-e": "enablement",
    "evaluation-n": "evaluation",
    "evaluation-s": "evaluation",
    "evaluation-s-e": "evaluation",
    "evidence": "explanation",
    "evidence-e": "explanation",
    "example": "elaboration",
    "example-e": "elaboration",
    "explanation-argumentative": "explanation",
    "explanation-argumentative-e": "explanation",
    "hypothetical": "condition",
    "interpretation-n": "evaluation",
    "interpretation-s": "evaluation",
    "interpretation-s-e": "evaluation",
    "manner": "manner-means",
    "manner-e": "manner-means",
    "means": "manner-means",
    "means-e": "manner-means",
    "otherwise": "condition",
    "preference": "comparison",
    "preference-e": "comparison",
    "problem-solution-n": "topic-comment",
    "problem-solution-s": "topic-comment",
    "purpose": "enablement",
    "purpose-e": "enablement",
    "question-answer-n": "topic-comment",
    "question-answer-s": "topic-comment",
    "reason": "explanation",
    "reason-e": "explanation",
    "restatement": "summary",
    "restatement-e": "summary",
    "result": "cause",
    "result-e": "cause",
    "rhetorical-question": "topic-comment",
    "statement-response-n": "topic-comment",
    "statement-response-s": "topic-comment",
    "summary-n": "summary",
    "summary-s": "summary",
    "temporal-after": "temporal",
    "temporal-after-e": "temporal",
    "temporal-before": "temporal",
    "temporal-before-e": "temporal",
    "temporal-same-time": "temporal",
    "temporal-same-time-e": "temporal",
    "topic-drift": "topic-change",
    "topic-shift": "topic-change"
  },
  "model_name": "jhu-clsp/ettin-encoder-400m",
  "stride": 100,
  "encoder_window_size": null,
  "attention_type": "dot_product",
  "classifier_use_bias": true,
  "num_rnn_layers": 1,
  "encoder_dropout": 0.5,
  "decoder_dropout": 0.5,
  "labeler_dropout": 0.5,
  "doc_gru_dropout": 0.2,
  "label_input_pooling": "mean",
  "freeze_embeddings": false,
  "freeze_encoder_layers": 0,
  "peft": {
    "r": 16,
    "alpha": 32,
    "dropout": 0.05,
    "target_modules": "all-linear",
    "bias": "none",
    "dora": false,
    "modules_to_save": [
      "embed_tokens"
    ],
    "train_only_new_embedding_rows": true,
    "base_dtype": "float32",
    "gradient_checkpointing": false,
    "load_in_4bit": false,
    "bnb_4bit_quant_type": "nf4",
    "bnb_4bit_use_double_quant": true,
    "bnb_4bit_compute_dtype": "bfloat16"
  },
  "curriculum": {
    "type": "simple",
    "epochs": 100
  },
  "segmentation": {
    "pos_weight": 10,
    "start_loss": false,
    "scheme": "BIE",
    "loss": "crf",
    "dropout": 0.3
  },
  "detokenizer": null,
  "split_cjk_tokens": false,
  "dlw": {
    "temperature": 2,
    "window": 30
  },
  "lr": 0.0002,
  "encoder_lr": 0.0003,
  "grad_accum": 3,
  "amp": true,
  "empty_cache_between_docs": false,
  "checkpoint_decoder": false,
  "patience": 100,
  "patience_window": 1,
  "max_grad_norm": 20,
  "weight_decay": 0.01,
  "num_warmup_steps": 100,
  "num_warmup_epochs": 5,
  "log_every": 1,
  "begin_validation_epoch": 0,
  "validate_every": 1,
  "edu_loss_weight_exponent": 0,
  "run_name": "release-dmrst-ettin-400m-rstdt-full",
  "seed": 42,
  "val_metric_name": "e2e_full_f1"
}