nlpap 1.0.0

A comprehensive NLP library for text preprocessing, semantic analysis, and information extraction

NLPAP - NLP Analyzer Package

A comprehensive Natural Language Processing library that provides easy-to-use tools for text preprocessing, semantic analysis, and information extraction.

Features

Q1: Text Preprocessing & Representation

• ✅ Advanced tokenization using NLTK
• ✅ Stop word removal and text cleaning
• ✅ Lemmatization and stemming
• ✅ Bag-of-Words (BoW) representation
• ✅ TF-IDF calculation and analysis
• ✅ Vocabulary analysis and word frequency

Q2: Semantic Understanding & Language Modeling

• ✅ WordNet integration for synonyms, antonyms, and hypernyms
• ✅ N-gram language models (unigram, bigram, trigram)
• ✅ Laplace smoothing for probability estimation
• ✅ Next word prediction capabilities
• ✅ Semantic relationship extraction

Q3: Information Extraction & Sentiment Analysis

• ✅ Named Entity Recognition (NER)
• ✅ Rule-based sentiment analysis
• ✅ Word similarity analysis using co-occurrence
• ✅ Entity classification (Person, Organization, Location)
• ✅ Sentiment distribution analysis

Installation

pip install nlpap

Quick Start

from nlpap import ComprehensiveNLP

# Initialize the analyzer
nlp = ComprehensiveNLP()

# Sample texts (Mental Health domain example)
texts = [
    "I feel overwhelmed with anxiety and stress lately. Need professional help.",
    "The therapy sessions have been very helpful for my mental health recovery.",
    "Depression affects many students during exam periods. Support is crucial."
]

# Run complete analysis
results = nlp.run_complete_analysis(texts)

# Access individual components
processed_data, tokens = nlp.preprocess_text(texts)
semantic_data = nlp.semantic_analysis(tokens)
entities, sentiments = nlp.information_extraction_and_sentiment(texts)

Detailed Usage

Text Preprocessing & Representation

# Initialize analyzer
nlp = ComprehensiveNLP()

# Preprocess texts
processed_data, all_tokens = nlp.preprocess_text(your_texts)

# The method returns:
# - Tokenized text
# - Filtered tokens (no stopwords/punctuation)
# - Lemmatized tokens
# - Stemmed tokens
# - BoW and TF-IDF representations

Semantic Analysis

# Analyze semantic relationships
semantic_data = nlp.semantic_analysis(tokens)

# Returns WordNet analysis:
# - Definitions
# - Synonyms and antonyms
# - Hypernyms (broader categories)
# - Language model with Laplace smoothing

Information Extraction & Sentiment

# Extract entities and analyze sentiment
entities, sentiments = nlp.information_extraction_and_sentiment(texts)

# Returns:
# - Named entities (Person, Organization, Location)
# - Sentiment classification (Positive, Negative, Neutral)
# - Word similarity analysis

Command Line Interface

After installation, you can use the command line interface:

# Analyze a single text
nlpap-analyze --text "Your text here"

# Analyze a file
nlpap-analyze --file path/to/your/textfile.txt

# Get help
nlpap-analyze --help

Dependencies

• nltk >= 3.7
• numpy >= 1.19.0
• pandas >= 1.2.0
• matplotlib >= 3.3.0

Educational Use

This library is designed for educational purposes and covers fundamental NLP concepts:

1. Text Preprocessing: Learn how to clean and prepare text data
2. Representation Methods: Understand BoW vs TF-IDF approaches
3. Semantic Analysis: Explore word relationships using WordNet
4. Language Modeling: Implement N-gram models with smoothing
5. Information Extraction: Practice NER and sentiment analysis
6. Word Embeddings: Analyze word similarity and relationships

Examples

Mental Health Text Analysis

from nlpap import ComprehensiveNLP

# Mental health related texts
mental_health_texts = [
    "Feeling stressed about exams, need support and guidance.",
    "Therapy has been helpful for managing anxiety effectively.",
    "University counseling services provide excellent mental health support."
]

nlp = ComprehensiveNLP()
results = nlp.run_complete_analysis(mental_health_texts)

print("Analysis complete!")
print(f"Entities found: {results['entities']}")
print(f"Sentiments: {results['sentiments']}")

Custom Domain Analysis

# Use with your own domain-specific texts
your_texts = [
    "Your domain-specific text here...",
    "Another text for analysis...",
]

nlp = ComprehensiveNLP()

# Run individual analyses
processed_data, tokens = nlp.preprocess_text(your_texts)
semantic_data = nlp.semantic_analysis(tokens)
entities, sentiments = nlp.information_extraction_and_sentiment(your_texts)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Citation

If you use this library in your research or projects, please cite:

@software{nlp_comprehensive_analyzer,
  title={NLP Comprehensive Analyzer},
  author={Your Name},
  year={2024},
  url={https://github.com/yourusername/nlp-comprehensive-analyzer}
}

Support

For support, please open an issue on GitHub or contact [[e-mail]]

---

Perfect for students, researchers, and developers learning NLP fundamentals!