Analysis Module (``PsychiatryNLPKit.analysis``)
================================================

Seven categories of linguistic analysis functions, each returning a dictionary keyed by
section name with numeric metric values.

All functions accept pre-computed features from ``TextData`` properties and are designed
to be called individually or orchestrated via :class:`~PsychiatryNLPKit.analysis.BatchAnalyzer`.

Batch Analysis
--------------

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.AnalysisResult
   PsychiatryNLPKit.analysis.BatchAnalyzer

Syntax Metrics
--------------

POS tag ratios, clause structure, syntax tree depth, and sentence complexity.

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.sentence_length
   PsychiatryNLPKit.analysis.syntax_depth
   PsychiatryNLPKit.analysis.unique_pos_tags
   PsychiatryNLPKit.analysis.adverb_ratio
   PsychiatryNLPKit.analysis.coordinating_conjunction_ratio
   PsychiatryNLPKit.analysis.adjective_ratio
   PsychiatryNLPKit.analysis.pronoun_ratio
   PsychiatryNLPKit.analysis.determiner_ratio
   PsychiatryNLPKit.analysis.modal_auxiliary_verb_ratio
   PsychiatryNLPKit.analysis.stop_words_ratio
   PsychiatryNLPKit.analysis.clause_count
   PsychiatryNLPKit.analysis.noun_group_count
   PsychiatryNLPKit.analysis.adjective_sentence_length

Similarity Metrics
------------------

Semantic coherence measured as cosine similarity between adjacent embeddings.

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.word_level_cosine_similarity
   PsychiatryNLPKit.analysis.sentence_level_cosine_similarity

Perplexity Metrics
------------------

Language model perplexity at paragraph and sentence levels (generative + masked LM).

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.paragraph_level_perplexity
   PsychiatryNLPKit.analysis.sentence_level_perplexity
   PsychiatryNLPKit.analysis.paragraph_level_pseudo_perplexity
   PsychiatryNLPKit.analysis.sentence_level_pseudo_perplexity

Density Metrics
---------------

Semantic space dimensionality via PCA explained variance and intrinsic dimension estimation.

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.pca_density_metrics
   PsychiatryNLPKit.analysis.intrinsic_dimensionality_density

Lexicon Metrics
---------------

Disfluency markers and filler word frequency analysis.

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.filler_words_count

Optional Analyses
-----------------

These require additional dependencies (``networkx`` for graph, ``pillow`` for image).

.. autosummary::
   :toctree: generated

   PsychiatryNLPKit.analysis.structural_graph
   PsychiatryNLPKit.analysis.image_text_similarity
   :members:
   :undoc-members:
   :show-inheritance: