rustling 0.8.0

A blazingly fast library for computational linguistics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

.. _chat_measures:

Developmental Measures
======================

Some developmental measures are defined as :class:`~rustling.chat.CHAT` methods:

.. currentmodule:: rustling.chat.CHAT

.. autosummary::

    mlu
    mlum
    mluw
    ttr
    ipsyn


For the mean length of utterance in morphemes in Eve's data from Brown:

.. code-block:: python

    import rustling
    eve = rustling.read_chat("path/to/your/local/Brown.zip", filter_files="Eve")
    eve_chi = eve.filter(participants="CHI")
    eve_chi.mlum()
    # [1.43, 1.82, 2.15, 2.07, 2.16, 2.4, 2.43, 2.4, 2.86, 2.72, 2.69, 3.4, 3.5, 2.83, 3.54, 3.24, 3.61, 3.2, 3.8, 2.24]

The result is the MLU in morphemes for each of Eve's CHAT files in order.
As this is a list of floats, they can be readily piped into
other packages for making plots, for example:

.. code-block:: python

    import rustling

    # matplotlib and seaborn required for this code snippet
    import matplotlib.pyplot as plt
    import seaborn as sns

    brown = rustling.read_chat("path/to/your/local/Brown.zip")
    eve = brown.filter(files="Eve")
    eve_chi = eve.filter(participants="CHI")
    ages_in_months = [age.in_months() for age in eve_chi.ages()]

    plt.figure(figsize=(8, 5))
    sns.lineplot(
        x=ages_in_months,
        y=eve_chi.mlum(),
        errorbar=None,
    )

    plt.title("Mean Length of Utterance in Morphemes for Brown's Eve")
    plt.xlabel("Age in months")
    plt.ylabel("MLU (morphemes)")
    plt.xticks(ages_in_months)

    plt.savefig("brown_eve_mlum.png")
    plt.close()

.. image:: ../_static/brown_eve_mlum.png
   :alt: Mean Length of Utterance in Morphemes for Brown's Eve