macroextract 0.1.1

Extract causal relation sentences from macroeconomic news articles

macroextract

Extract causal relation sentences from macroeconomic news articles.

Installation

pip install macroextract
python -m spacy download en_core_web_md

Usage

CLI

# Extract relations from test articles
macro bench extract_all

# Verbose output with sentences
macro bench extract_all -v

# Filter by filename pattern
macro bench extract_all "bbc*"

# Debug sentence structure
macro debug sentence "Inflation rose due to supply constraints."

Python API

import macroextract

# Extract all sentences with context
all_sentences = macroextract.extract(article_text)

# Extract only causal relation sentences with context
relations = macroextract.extract_relations(article_text)

for r in relations:
    print(r["sentence"])
    print(r["time"])
    print(r["place"])

Output Format

sentence: "Tobacco prices grew largely due to duty rises announced in the Budget."
time:     November
place:    (none)

Causal Markers

The extractor identifies sentences containing causal language:

• Connectors: because, due to, after, following, amid
• Verbs: cause, trigger, fuel, drive, support, spark, spur, dampen, contribute, push
• Nouns: contributor, driver, factor, catalyst, impact

License

MIT