CoNLL-U Tools

Contents:

  • Installation
    • Quick Install
    • Requirements
      • System Requirements
    • Other Installation Methods
      • From Source
      • From GitHub (Direct)
      • Specific Version
      • Upgrade
    • Troubleshooting
      • Import Error: No module named ‘conllu_tools’
      • Version Conflicts
      • Permission Errors
    • Next Steps
  • Quick Start Guide
    • Installation
    • Conversion
      • CoNLL-U to brat
      • brat to CoNLL-U
    • Validation
    • Evaluation
    • Pattern Matching
      • Basic Pattern Search
      • Pattern Syntax Examples
    • Utils
      • Normalize Morphology
      • Feature Conversion
      • XPOS Conversion
    • Next Steps
    • Need Help?
  • User Guide
    • Conversion
      • CoNLL-U to Brat
        • Basic Usage
        • Parameters
        • Output Structure
        • Features
        • The metadata.json File
      • Brat to CoNLL-U
        • Basic Usage
        • Parameters
        • Features
        • Using metadata.json for Automatic Configuration
      • Troubleshooting
        • Missing metadata.json
        • ID Mismatches
        • Token Mismatch Errors
        • Missing Features
        • Missing Output File
        • Encoding Issues
      • See Also
    • Validation
      • Overview
      • Quick Start
      • Validation Levels
        • Level 1: Basic Format
        • Level 2: Standard Validation (Default)
        • Level 3: Extended Validation
        • Level 4: Language-Specific Format
        • Level 5: Language-Specific Content
      • Advanced Usage
        • Custom Validator Configuration
        • Validating String Content
        • Accessing Error Details
      • Common Validation Errors
        • ID Sequence Errors
        • Multi-word Token Errors
        • UPOS-DEPREL Compatibility
        • Tree Structure Errors
      • See Also
    • Evaluation
      • Overview
      • Quick Start
      • Advanced Usage
        • Disabling Dependency Evaluation
        • Treebank Type Configuration
        • Accessing Score Details
      • Common Issues
        • File Alignment
        • Token Count Mismatch
      • See Also
    • Matching
      • Overview
      • Quick Start
      • Basic Usage
        • Building Patterns
        • Searching a Corpus
        • Working with Match Results
      • Pattern Syntax
        • Token Patterns
        • Sentence Patterns
      • Advanced Usage
        • Manual Pattern Construction
        • Condition Types
        • Nested Conditions
        • Pattern Explanation
        • Matching Individual Sentences
      • Common Issues
        • Pattern Not Matching
        • Empty Feature Handling
        • Quantifier Behavior
      • See Also
    • Data Loading
      • Feature Set Loading
        • Basic Loading
        • Understanding the Feature Set Format
        • Custom Feature Sets
      • Loading Other Language Data
      • See Also
    • Utils
      • Morphology Normalization
        • Quick Start
        • Basic Usage
        • With Reference Features
        • What Gets Normalized
      • UPOS Utilities
        • DALME to UPOS
        • UPOS to Perseus
      • Feature Utilities
        • Convert Features to XPOS
        • Convert XPOS to Features
        • Validate Features
      • XPOS Utilities
        • Format XPOS
        • Validate XPOS
        • Low-level Conversion Tools
  • Usage Examples
    • I/O Examples
      • Round-trip Conversion
      • Important Notes
      • See Also
    • Validation Examples
      • Post-Conversion Validation
      • Batch Validation
      • Integration with Other Tools
        • Validate Before Evaluation
        • Validate After Conversion
      • See Also
    • Evaluation Examples
      • Parser Development
      • Cross-Validation
      • Baseline Comparison
      • Integration Examples
        • Evaluate Conversion Accuracy
        • Export Results to JSON/CSV
      • See Also
    • Matching Examples
      • Linguistic Patterns
      • Syntactic Patterns
      • Morphological Patterns
      • See Also
    • Normalization Examples
      • Basic Normalization
        • Example 1: VERB with Gerund Features
        • Example 2: AUX with Finite Verb Features
        • Example 3: ADJ with Degree Reconciliation
        • Example 4: NOUN with XPOS/UPOS Mismatch Correction
      • Normalization Workflows
        • Normalizing a CoNLL-U File
        • Cleaning Imported Annotations
        • Validating After Normalization
        • Batch Normalization
      • Error Handling
        • Handling Normalization Errors
        • Safe Normalization with Fallbacks
      • See Also
    • Utilities Examples
      • Convert Features to XPOS
        • Complete Workflow
        • Filling Partial XPOS
      • Format XPOS
        • Processing Mixed Formats
      • See Also
  • API Reference
    • IO Module
      • Conversion Functions
        • conllu_to_brat
        • brat_to_conllu
      • Data Loading Functions
        • load_language_data
        • load_whitespace_exceptions
    • Validation Module
      • Main Classes
        • ConlluValidator
        • ErrorReporter
        • ErrorEntry
      • Exceptions
        • ValidationError
      • Validation Mixins
    • Evaluation Module
      • Main Classes
        • Evaluator
        • Score
      • Supporting Classes
        • UDWord
        • UDSpan
        • Alignment
        • AlignmentWord
      • Exceptions
        • UDError
    • Matching Module
      • Quick Example
      • Utility Functions
        • build_pattern
        • find_in_corpus
      • Pattern Classes
        • SentencePattern
        • TokenPattern
        • Condition
      • Result Classes
        • MatchResult
    • Utils Module
      • Morphology Normalization
        • normalize_morphology()
      • UPOS Utilities
        • upos_to_perseus()
        • dalme_to_upos()
      • Feature Utilities
        • feature_string_to_dict()
        • feature_dict_to_string()
        • features_to_xpos()
        • xpos_to_features()
        • validate_features()
      • XPOS Utilities
        • Format XPOS
        • Validate XPOS
        • ITTB to Perseus
        • PROIEL to Perseus
        • LLCT to Perseus
      • brat Utilities
        • type_to_safe_type()
        • safe_type_to_type()
        • parse_annotation_line()
        • format_annotation()
        • read_annotations()
        • read_text_lines()
        • sort_annotations_set()
        • sort_annotations()
        • write_annotations()
        • write_text()
        • write_auxiliary_files()
        • get_next_id_number()
    • Constants Module
      • Universal Dependencies Tags
        • UPOS Tags
        • Universal Dependency Relations
        • Universal Features
      • Relation Categories
        • conllu_tools.constants.CONTENT_DEPRELS
        • conllu_tools.constants.FUNCTIONAL_DEPRELS
        • conllu_tools.constants.LEFT_TO_RIGHT_RELATIONS
      • CoNLL-U Token Structure
        • conllu_tools.constants.TOKEN_KEYS
      • XPOS Mappings
        • conllu_tools.constants.UPOS_TO_PERSEUS
        • conllu_tools.constants.FEATS_TO_XPOS
        • conllu_tools.constants.XPOS_TO_FEATS
        • conllu_tools.constants.VALIDITY_BY_POS
      • Treebank Concordances
        • conllu_tools.constants.ITTB_CONCORDANCES
        • conllu_tools.constants.PROIEL_CONCORDANCES
        • conllu_tools.constants.LLCT_CONCORDANCES
      • MISC Column
        • conllu_tools.constants.MISC_ATTRIBUTES
CoNLL-U Tools
  • Usage Examples
  • Edit on GitHub

Usage Examples

This section provides practical code examples for common workflows.

  • I/O Examples
    • Round-trip Conversion
    • Important Notes
    • See Also
  • Validation Examples
    • Post-Conversion Validation
    • Batch Validation
    • Integration with Other Tools
    • See Also
  • Evaluation Examples
    • Parser Development
    • Cross-Validation
    • Baseline Comparison
    • Integration Examples
    • See Also
  • Matching Examples
    • Linguistic Patterns
    • Syntactic Patterns
    • Morphological Patterns
    • See Also
  • Normalization Examples
    • Basic Normalization
    • Normalization Workflows
    • Error Handling
    • See Also
  • Utilities Examples
    • Convert Features to XPOS
    • Format XPOS
    • See Also
Previous Next

© Copyright 2025, Gabe Pizzorno.