How decompositional-semantics-initiative/decomp works
Decomp is a Python toolkit for loading and exploring Universal Decompositional Semantics (UDS) corpora: it builds sentence graphs combining Universal Dependencies syntax with semantic annotations, which users can inspect, query, serialize, and visualize. A separate PredPatt subsystem extracts predicate–argument structures from dependency parses and can represent them as graphs. The README documents RDF/SPARQL interoperability and multiple serialization formats. Some subsystem wiring is inferred only from package structure and documentation; unsampled implementation details are not represented as specific call edges.
Main entry points: uds/corpus.py UDS Corpus · graph.py Sentence Graph · predpatt/corpus.py PredPatt Corpus · engine.py Extraction Engine
Components 25
Corpus Loading
- UDS Corpus
decomp/semantics/uds/corpus.py - Corpus Container
decomp/corpus/corpus.py - Dependency Trees
decomp/syntax/dependency.py
UDS Graph Model
- Sentence Graph
decomp/semantics/uds/graph.py - Document Graph
decomp/semantics/uds/document.py - Annotations
decomp/semantics/uds/annotation.py - Annotation Metadata
decomp/semantics/uds/metadata.py - Graph Types
decomp/semantics/uds/types.py
Predicate Extraction
- PredPatt Corpus
decomp/semantics/predpatt/corpus.py - UD Parse
decomp/semantics/predpatt/parsing/udparse.py - Parse Loader
decomp/semantics/predpatt/parsing/loader.py - Extraction Engine
decomp/semantics/predpatt/extraction/engine.py - Predicates And Arguments
decomp/semantics/predpatt/core/predicate.py - Extraction Rules
decomp/semantics/predpatt/rules - Extraction Filters
decomp/semantics/predpatt/filters - PredPatt Graph
decomp/semantics/predpatt/graph.py - Linearized Output
decomp/semantics/predpatt/utils/linearization.py
Query And Export
- NetworkX Graph Support
decomp/graph/nx.py - RDF Conversion
decomp/graph/rdf.py - RDF Graph
Graph Visualization
- UDS Visualizer
decomp/vis/uds_vis.py
Other components
- Researcher
- UD Treebank
- UDS Annotations
- Graph Formats
Connections 29
- Researcher → UDS Corpus: loads corpus
- UD Treebank → Dependency Trees: provides parses
- UDS Annotations → UDS Corpus: provides annotations
- UDS Corpus → Corpus Container: uses container
- UDS Corpus → Dependency Trees: builds syntax
- UDS Corpus → Sentence Graph: builds graphs
- UDS Corpus → Document Graph: provides documents
- Sentence Graph → Annotations: models attributes
- Sentence Graph → Annotation Metadata: uses metadata
- Sentence Graph → Graph Types: uses types
- Researcher → PredPatt Corpus: extracts predicates
- Parse Loader → UD Parse: loads parse
- PredPatt Corpus → Parse Loader: loads parses
- PredPatt Corpus → Extraction Engine: runs extraction
- Extraction Engine → Predicates And Arguments: builds structures
- Extraction Engine → Extraction Rules: applies rules
- Extraction Engine → Extraction Filters: filters results
- PredPatt Corpus → PredPatt Graph: builds graphs
- PredPatt Graph → Dependency Trees: combines syntax
- Researcher → Linearized Output: formats extraction
- Researcher → NetworkX Graph Support: queries graph
- NetworkX Graph Support → Sentence Graph: operates on
- Researcher → RDF Conversion: converts graph
- RDF Conversion → RDF Graph: creates triples
- Researcher → RDF Graph: queries with SPARQL
- Researcher → Graph Formats: serializes graph
- NetworkX Graph Support → Graph Formats: exports formats
- Researcher → UDS Visualizer: views graphs
- UDS Visualizer → Sentence Graph: renders graph