Skip to content

segmentation

news_recommendation.segmentation

Segment every article body of the MIND full-text catalog with the fixed news segmenter.

PYTHONPATH=src python -m news_recommendation.segmentation --output runs/segmentation/segmented.jsonl

Run from recommendation/ in the topic-segmentation environment. Short bodies stay whole; missing bodies have no segments.

sentences(body, splitter, min_words)

The units of a body and whether the model segments them: short bodies stay whole, missing ones are empty.

Source code in src/news_recommendation/segmentation.py
16
17
18
19
20
21
22
def sentences(body, splitter, min_words):
    """The units of a body and whether the model segments them: short bodies stay whole, missing ones are empty."""
    if not body.strip() or body.strip().lower() in ("nan", "none", "null", "n/a"):
        return [], False
    if len(body.split()) < min_words:
        return [body], False
    return [body[start:end] for start, end in splitter.span_tokenize(body)], True

join_segments(units, labels)

Group sentences into segments, each ending at a boundary label of 1.

Source code in src/news_recommendation/segmentation.py
25
26
27
28
29
30
31
32
33
def join_segments(units, labels):
    """Group sentences into segments, each ending at a boundary label of 1."""
    segments, current = [], []
    for unit, boundary in zip(units, labels):
        current.append(unit)
        if boundary:
            segments.append({"segment_id": len(segments) + 1, "text": " ".join(current)})
            current = []
    return segments

main()

Source code in src/news_recommendation/segmentation.py
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
def main():
    from topic_segmentation.inference import ModernBertSegmenter

    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    parser.add_argument("--output", type=Path, required=True, help="Segmented catalog, relative to recommendation/")
    parser.add_argument("--config", default="configs/segmentation.json")
    parser.add_argument("--device", default="cuda:0")
    args = parser.parse_args()
    config = json.loads((REPOSITORY / args.config).read_text())
    with (REPOSITORY / config["punkt"]).open("rb") as stream:
        splitter = pickle.load(stream)
    segmenter = ModernBertSegmenter(REPOSITORY / config["model"], args.device, config["window"], config["stride"],
                                    config["batch_size"], config["protect_window_end"])
    csv.field_size_limit(10_000_000)
    with (REPOSITORY / config["source"]).open(newline="") as stream:
        rows = list(csv.DictReader(stream))
    output = REPOSITORY / args.output
    output.parent.mkdir(parents=True, exist_ok=True)
    with output.open("w") as result:
        for offset in range(0, len(rows), 512):
            batch = rows[offset:offset + 512]
            units, modeled = zip(*(sentences(row["body"], splitter, config["min_words"]) for row in batch))
            segmented = [i for i in range(len(batch)) if modeled[i]]
            labels = dict(zip(segmented, segmenter.segment_batch([units[i] for i in segmented])))
            for i, row in enumerate(batch):
                record = {key: row[key] for key in ("news_id", "title", "abstract", "url")}
                record |= {"full_body": row["body"],
                           "segments": join_segments(units[i], labels.get(i, [1] * len(units[i])))}
                result.write(json.dumps(record, ensure_ascii=False) + "\n")