From d6cec8e38eb307525c86b1ca24034edc3da068db Mon Sep 17 00:00:00 2001 From: jacksonllee Date: Thu, 17 Mar 2022 00:51:19 -0400 Subject: [PATCH] DOC refresh docs --- README.rst | 7 - docs/.buildinfo | 2 +- docs/_modules/index.html | 74 ++-- docs/_modules/pylangacq/chat.html | 74 ++-- docs/_modules/pylangacq/objects.html | 74 ++-- docs/_static/basic.css | 3 +- docs/_static/doctools.js | 5 +- docs/_static/documentation_options.js | 2 +- docs/_static/language_data.js | 2 +- docs/_static/pygments.css | 2 + docs/_static/scripts/furo.js | 2 +- docs/_static/scripts/furo.js.map | 2 +- docs/_static/searchtools.js | 2 +- docs/_static/styles/furo-extensions.css | 2 +- docs/_static/styles/furo-extensions.css.map | 2 +- docs/_static/styles/furo.css | 2 +- docs/_static/styles/furo.css.map | 2 +- docs/api.html | 176 +++++----- docs/changelog.html | 362 +++++++++++--------- docs/frequencies.html | 76 ++-- docs/genindex.html | 72 ++-- docs/headers.html | 86 +++-- docs/index.html | 138 ++++---- docs/measures.html | 76 ++-- docs/objects.inv | Bin 843 -> 843 bytes docs/quickstart.html | 88 +++-- docs/read.html | 94 ++--- docs/search.html | 72 ++-- docs/searchindex.js | 2 +- docs/source/build_docs.py | 4 +- docs/source/changelog.rst | 22 ++ docs/transcriptions.html | 92 ++--- docs/write.html | 76 ++-- 33 files changed, 974 insertions(+), 721 deletions(-) diff --git a/README.rst b/README.rst index 32ed637..c47bb9a 100644 --- a/README.rst +++ b/README.rst @@ -42,13 +42,6 @@ To download and install the most recent version:: Ready for more? Check out the `Quickstart `_ page. -Consulting ----------- - -If your team would like professional assistance in using PyLangAcq, -freelance consulting and training services are available for both academic and commercial groups. -Please email `Jackson L. Lee `_. - Support ------- diff --git a/docs/.buildinfo b/docs/.buildinfo index 3d21c7b..cfd84dc 100644 --- a/docs/.buildinfo +++ b/docs/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 55e57f073151487b4452d5da95cf5614 +config: b8a061c5250ba40d6bab5633c3c42eec tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_modules/index.html b/docs/_modules/index.html index a76c91c..29290c9 100644 --- a/docs/_modules/index.html +++ b/docs/_modules/index.html @@ -4,11 +4,11 @@ - - Overview: module code - PyLangAcq 0.16.0 documentation + + Overview: module code - PyLangAcq 0.16.1 documentation - - + + @@ -20,16 +20,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -41,17 +43,13 @@ Contents - - - - - + + Menu - @@ -60,14 +58,14 @@ Expand - Light mode - @@ -82,7 +80,7 @@ Dark mode - @@ -90,7 +88,7 @@ Auto light/dark mode - @@ -123,7 +121,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -146,7 +144,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation
+
@@ -175,8 +174,13 @@
-
-
+ + + + + Back to top + +
- -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/_modules/pylangacq/chat.html b/docs/_modules/pylangacq/chat.html index 3f4673d..6e3ac68 100644 --- a/docs/_modules/pylangacq/chat.html +++ b/docs/_modules/pylangacq/chat.html @@ -4,11 +4,11 @@ - - pylangacq.chat - PyLangAcq 0.16.0 documentation + + pylangacq.chat - PyLangAcq 0.16.1 documentation - - + + @@ -20,16 +20,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -41,17 +43,13 @@ Contents - - - - - + + Menu - @@ -60,14 +58,14 @@ Expand - Light mode - @@ -82,7 +80,7 @@ Dark mode - @@ -90,7 +88,7 @@ Auto light/dark mode - @@ -123,7 +121,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -146,7 +144,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -168,6 +166,7 @@
+
@@ -175,8 +174,13 @@
-
-
+ + + + + Back to top + +
@@ -175,8 +174,13 @@
-
-
+ + + + + Back to top + +
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

API Reference

+

API Reference#

-

read_chat()

+

read_chat()#

-pylangacq.read_chat(path: str, match: str = None, exclude: str = None, encoding: str = 'utf-8', cls: type = <class 'pylangacq.chat.Reader'>) → pylangacq.chat.Reader[source]
+pylangacq.read_chat(path: str, match: str = None, exclude: str = None, encoding: str = 'utf-8', cls: type = <class 'pylangacq.chat.Reader'>) → pylangacq.chat.Reader[source]#

Create a reader of CHAT data.

If path is a remote ZIP file and you expect to call this function with the same path multiple times, consider downloading the data to the local @@ -250,10 +254,10 @@

-

Reader

+

Reader#

-class pylangacq.Reader[source]
+class pylangacq.Reader[source]#

A reader that handles CHAT data.

Methods

@@ -377,7 +381,7 @@

-ages(participant='CHI', months=False) → Union[List[Tuple[int, int, int]], List[float]][source]
+ages(participant='CHI', months=False) → Union[List[Tuple[int, int, int]], List[float]][source]#

Return the ages of the given participant in the data.

Parameters
@@ -401,7 +405,7 @@

-append(reader: pylangacq.chat.Reader) → None[source]
+append(reader: pylangacq.chat.Reader) → None[source]#

Append data from another reader.

New data is appended as-is with no filtering of any sort, even for files whose file paths duplicate those already in the current reader.

@@ -416,7 +420,7 @@

-append_left(reader: pylangacq.chat.Reader) → None[source]
+append_left(reader: pylangacq.chat.Reader) → None[source]#

Left-append data from another reader.

New data is appended as-is with no filtering of any sort, even for files whose file paths duplicate those already in the current reader.

@@ -431,12 +435,12 @@

-clear() → None[source]
+clear() → None[source]#

Remove all data from this reader.

-dates_of_recording(by_files=False) → Union[Set[datetime.date], List[Set[datetime.date]]][source]
+dates_of_recording(by_files=False) → Union[Set[datetime.date], List[Set[datetime.date]]][source]#

Return the dates of recording.

Parameters
@@ -460,7 +464,7 @@

-extend(readers: Iterable[pylangacq.chat.Reader]) → None[source]
+extend(readers: Iterable[pylangacq.chat.Reader]) → None[source]#

Extend data from other readers.

New data is appended as-is with no filtering of any sort, even for files whose file paths duplicate those already in the current reader.

@@ -475,7 +479,7 @@

-extend_left(readers: Iterable[pylangacq.chat.Reader]) → None[source]
+extend_left(readers: Iterable[pylangacq.chat.Reader]) → None[source]#

Left-extend data from other readers.

New data is appended as-is with no filtering of any sort, even for files whose file paths duplicate those already in the current reader.

@@ -490,7 +494,7 @@

-file_paths() → List[str][source]
+file_paths() → List[str][source]#

Return the file paths.

If the data comes from in-memory strings, then the “file paths” are arbitrary UUID random strings.

@@ -504,7 +508,7 @@

-filter(match: str = None, exclude: str = None) → pylangacq.chat.Reader[source]
+filter(match: str = None, exclude: str = None) → pylangacq.chat.Reader[source]#

Return a new reader filtered by file paths.

Parameters
@@ -539,7 +543,7 @@

-classmethod from_dir(path: str, match: str = None, exclude: str = None, extension: str = '.cha', encoding: str = 'utf-8', parallel: bool = True) → pylangacq.chat.Reader[source]
+classmethod from_dir(path: str, match: str = None, exclude: str = None, extension: str = '.cha', encoding: str = 'utf-8', parallel: bool = True) → pylangacq.chat.Reader[source]#

Instantiate a reader from a local directory with CHAT data files.

Parameters
@@ -584,7 +588,7 @@

-classmethod from_files(paths: List[str], match: str = None, exclude: str = None, encoding: str = 'utf-8', parallel: bool = True) → pylangacq.chat.Reader[source]
+classmethod from_files(paths: List[str], match: str = None, exclude: str = None, encoding: str = 'utf-8', parallel: bool = True) → pylangacq.chat.Reader[source]#

Instantiate a reader from local CHAT data files.

Parameters
@@ -626,7 +630,7 @@

-classmethod from_strs(strs: List[str], ids: List[str] = None, parallel: bool = True) → pylangacq.chat.Reader[source]
+classmethod from_strs(strs: List[str], ids: List[str] = None, parallel: bool = True) → pylangacq.chat.Reader[source]#

Instantiate a reader from in-memory CHAT data strings.

Parameters
@@ -656,7 +660,7 @@

-classmethod from_zip(path: str, match: str = None, exclude: str = None, extension: str = '.cha', encoding: str = 'utf-8', parallel: bool = True, use_cached: bool = True, session: requests.sessions.Session = None) → pylangacq.chat.Reader[source]
+classmethod from_zip(path: str, match: str = None, exclude: str = None, extension: str = '.cha', encoding: str = 'utf-8', parallel: bool = True, use_cached: bool = True, session: requests.sessions.Session = None) → pylangacq.chat.Reader[source]#

Instantiate a reader from a local or remote ZIP file.

If the input data is a remote ZIP file and you expect to call this method with the same path multiple times, consider downloading the data to the local @@ -725,7 +729,7 @@

-head(n: int = 5, participants=None, exclude=None)[source]
+head(n: int = 5, participants=None, exclude=None)[source]#

Return the first several utterances.

Parameters
@@ -757,7 +761,7 @@

-headers() → List[Dict][source]
+headers() → List[Dict][source]#

Return the headers.

Returns
@@ -769,7 +773,7 @@

-info(verbose=False) → None[source]
+info(verbose=False) → None[source]#

Print a summary of this Reader’s data.

Parameters
@@ -782,7 +786,7 @@

-ipsyn(participant='CHI') → List[int][source]
+ipsyn(participant='CHI') → List[int][source]#

Return the indexes of productive syntax (IPSyn).

Parameters
@@ -801,7 +805,7 @@

-languages(by_files=False) → Union[Set[str], List[List[str]]][source]
+languages(by_files=False) → Union[Set[str], List[List[str]]][source]#

Return the languages in the data.

Parameters
@@ -828,7 +832,7 @@

-mlu(participant='CHI') → List[float][source]
+mlu(participant='CHI') → List[float][source]#

Return the mean lengths of utterance (MLU).

This method is equivalent to mlum().

@@ -848,7 +852,7 @@

-mlum(participant='CHI') → List[float][source]
+mlum(participant='CHI') → List[float][source]#

Return the mean lengths of utterance by morphemes.

Parameters
@@ -867,7 +871,7 @@

-mluw(participant='CHI') → List[float][source]
+mluw(participant='CHI') → List[float][source]#

Return the mean lengths of utterance by words.

Parameters
@@ -886,12 +890,12 @@

-n_files() → int[source]
+n_files() → int[source]#

Return the number of files.

-participants(by_files=False) → Union[Set[str], List[Set[str]]][source]
+participants(by_files=False) → Union[Set[str], List[Set[str]]][source]#

Return the participants (e.g., CHI, MOT).

Parameters
@@ -914,7 +918,7 @@

-pop() → pylangacq.chat.Reader[source]
+pop() → pylangacq.chat.Reader[source]#

Drop the last data file from the reader and return it as a reader.

Returns
@@ -926,7 +930,7 @@

-pop_left() → pylangacq.chat.Reader[source]
+pop_left() → pylangacq.chat.Reader[source]#

Drop the first data file from the reader and return it as a reader.

Returns
@@ -938,7 +942,7 @@

-sents(participants=None, exclude=None, by_files=False) → Union[List[List[str]], List[List[List[str]]]][source]
+sents(participants=None, exclude=None, by_files=False) → Union[List[List[str]], List[List[List[str]]]][source]#

Return the sents.

Deprecated since version 0.13.0: Please use words() with by_utterances=True @@ -979,7 +983,7 @@

-tagged_sents(participants=None, exclude=None, by_files=False) → Union[List[List[pylangacq.objects.Token]], List[List[List[pylangacq.objects.Token]]]][source]
+tagged_sents(participants=None, exclude=None, by_files=False) → Union[List[List[pylangacq.objects.Token]], List[List[List[pylangacq.objects.Token]]]][source]#

Return the tagged sents.

Deprecated since version 0.13.0: Please use tokens() with by_utterances=True @@ -1021,7 +1025,7 @@

-tagged_words(participants=None, exclude=None, by_files=False) → Union[List[pylangacq.objects.Token], List[List[pylangacq.objects.Token]]][source]
+tagged_words(participants=None, exclude=None, by_files=False) → Union[List[pylangacq.objects.Token], List[List[pylangacq.objects.Token]]][source]#

Return the tagged words.

Deprecated since version 0.13.0: Please use tokens() with by_utterances=False @@ -1062,7 +1066,7 @@

-tail(n: int = 5, participants=None, exclude=None)[source]
+tail(n: int = 5, participants=None, exclude=None)[source]#

Return the last several utterances.

Parameters
@@ -1094,7 +1098,7 @@

-to_chat(path: str, is_dir: bool = False, filenames: Optional[Iterable[str]] = None, tabular: bool = True, encoding: str = 'utf-8') → None[source]
+to_chat(path: str, is_dir: bool = False, filenames: Optional[Iterable[str]] = None, tabular: bool = True, encoding: str = 'utf-8') → None[source]#

Export to CHAT data files.

Parameters
@@ -1138,7 +1142,7 @@

-to_strs(tabular: bool = True) → Generator[str, None, None][source]
+to_strs(tabular: bool = True) → Generator[str, None, None][source]#

Yield CHAT data strings.

Note

@@ -1171,7 +1175,7 @@

-tokens(participants=None, exclude=None, by_utterances=False, by_files=False) → Union[List[pylangacq.objects.Token], List[List[pylangacq.objects.Token]], List[List[List[pylangacq.objects.Token]]]][source]
+tokens(participants=None, exclude=None, by_utterances=False, by_files=False) → Union[List[pylangacq.objects.Token], List[List[pylangacq.objects.Token]], List[List[List[pylangacq.objects.Token]]]][source]#

Return the tokens.

Parameters
@@ -1216,7 +1220,7 @@

-ttr(keep_case=True, participant='CHI') → List[float][source]
+ttr(keep_case=True, participant='CHI') → List[float][source]#

Return the type-token ratios (TTR).

Parameters
@@ -1244,7 +1248,7 @@

-utterances(participants=None, exclude=None, by_files=False) → Union[List[pylangacq.objects.Utterance], List[List[pylangacq.objects.Utterance]]][source]
+utterances(participants=None, exclude=None, by_files=False) → Union[List[pylangacq.objects.Utterance], List[List[pylangacq.objects.Utterance]]][source]#

Return the utterances.

Parameters
@@ -1281,7 +1285,7 @@

-word_frequencies(keep_case=True, participants=None, exclude=None, by_files=False) → Union[collections.Counter, List[collections.Counter]][source]
+word_frequencies(keep_case=True, participants=None, exclude=None, by_files=False) → Union[collections.Counter, List[collections.Counter]][source]#

Return word frequencies.

Parameters
@@ -1328,7 +1332,7 @@

-word_ngrams(n, keep_case=True, participants=None, exclude=None, by_files=False) → Union[collections.Counter, List[collections.Counter]][source]
+word_ngrams(n, keep_case=True, participants=None, exclude=None, by_files=False) → Union[collections.Counter, List[collections.Counter]][source]#

Return word ngrams.

Parameters
@@ -1375,7 +1379,7 @@

-words(participants=None, exclude=None, by_utterances=False, by_files=False) → Union[List[str], List[List[str]], List[List[List[str]]]][source]
+words(participants=None, exclude=None, by_utterances=False, by_files=False) → Union[List[str], List[List[str]], List[List[List[str]]]][source]#

Return the words.

Parameters
@@ -1421,10 +1425,10 @@

-

Token

+

Token#

-class pylangacq.objects.Token(word: str, pos: Optional[str], mor: Optional[str], gra: Optional[pylangacq.objects.Gra])[source]
+class pylangacq.objects.Token(word: str, pos: Optional[str], mor: Optional[str], gra: Optional[pylangacq.objects.Gra])[source]#

Token with attributes as parsed from a CHAT utterance.

Attributes
@@ -1458,10 +1462,10 @@

-

Gra

+

Gra#

-class pylangacq.objects.Gra(dep: int, head: int, rel: str)[source]
+class pylangacq.objects.Gra(dep: int, head: int, rel: str)[source]#

Grammatical relation of a word in an utterance.

Attributes
@@ -1478,10 +1482,10 @@

-

Utterance

+

Utterance#

-class pylangacq.objects.Utterance(participant: str, tokens: List[pylangacq.objects.Token], time_marks: Optional[Tuple[int, int]], tiers: Dict[str, str])[source]
+class pylangacq.objects.Utterance(participant: str, tokens: List[pylangacq.objects.Token], time_marks: Optional[Tuple[int, int]], tiers: Dict[str, str])[source]#

Utterance in a CHAT transcript data.

Attributes
@@ -1507,10 +1511,10 @@

-

Helper Functions

+

Helper Functions#

-pylangacq.chat.cached_data_info() → Set[str][source]
+pylangacq.chat.cached_data_info() → Set[str][source]#

Return the information of the cached datasets.

Returns
@@ -1523,7 +1527,7 @@

Helper Functions
-pylangacq.chat.remove_cached_data(url: Optional[str] = None) → None[source]
+pylangacq.chat.remove_cached_data(url: Optional[str] = None) → None[source]#

Remove data cached on disk.

Parameters
@@ -1564,11 +1568,21 @@

Helper Functions - Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/changelog.html b/docs/changelog.html index 9dc2b8d..bff6d71 100644 --- a/docs/changelog.html +++ b/docs/changelog.html @@ -5,11 +5,11 @@ - - Changelog - PyLangAcq 0.16.0 documentation + + Changelog - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@

-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+

@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Changelog

+

Changelog#

-

[Unreleased]

+

[Unreleased]#

-

Added

+

Added#

-

Changed

+

Changed#

-

Deprecated

+

Deprecated#

-

Removed

+

Removed#

-

Fixed

+

Fixed#

-

Security

+

Security#

-

[0.16.0] - 2021-12-27

+

[0.16.1] - 2022-03-17#

-

Added

+

Changed#

+
    +

  • Restructured the repository to use top-level src/ and tests/ directories.

    • +
+
+
+

Removed#

+
    +

  • Removed setup.py.

    • +
+
+
+

Fixed#

+
    +

  • Moved BaseTestCHATReader back under the pylangacq package namespace +so that download packages can import BaseTestCHATReader for testing.

    • +
+
+
+
+

[0.16.0] - 2021-12-27#

+
+

Added#

  • Reader objects can now be concatenated by the addition operator +.

  • Implemented the head, tail, and info methods at Reader.

    • @@ -227,8 +253,8 @@

    Added¶ build metadata and options.

-
-

Changed

+
+

Changed#

-
-

Removed

+
+

Removed#

  • Dropped support for Python 3.6.

-
-

Security

+
+

Security#

  • Turned on safety and bandit checks at CircleCI builds.

-
-

[0.15.0] - 2021-06-06

-
-

Added

+
+

[0.15.0] - 2021-06-06#

+
+

Added#

-
-

Changed

+
+

Changed#

  • CHAT parsing for the header information is now more robust for varying whitespace characters between the head and its associated value.

-
-

Removed

+
+

Removed#

  • Dropped kwarg allow_remote in Reader.from_zip. This kwarg wouldn’t make any sense anymore, or at least would be confusing with the introduction of use_cached.

-
-

[0.14.1] - 2021-05-16

-
-

Fixed

+
+

[0.14.1] - 2021-05-16#

+
+

Fixed#

  • The header/metadata has a more reasonable representation for emptiness when input data is empty.

-
-

[0.14.0] - 2021-05-12

-
-

Added

+
+

[0.14.0] - 2021-05-12#

+
+

Added#

  • Added the parallel optional argument to the Reader methods {from_zip, from_dir, from_files, from_strs} @@ -311,44 +337,44 @@

    Added

-
-

[0.13.3] - 2021-05-07

-
-

Fixed

+
+

[0.13.3] - 2021-05-07#

+
+

Fixed#

  • The methods append, append_left, extend, and extend_left now work with a subclass of Reader, not just Reader itself.

-
-

[0.13.2] - 2021-05-02

-
-

Fixed

+
+

[0.13.2] - 2021-05-02#

+
+

Fixed#

  • Fixed utterance cleaning so that it is now compatible with all CHILDES datasets.

-
-

[0.13.1] - 2021-03-23

-
-

Fixed

+
+

[0.13.1] - 2021-03-23#

+
+

Fixed#

  • Fixed a CHAT parsing issue when correction and repetition are combined.

-
-

[0.13.0] - 2021-03-15

+
+

[0.13.0] - 2021-03-15#

API-breaking changes: The Reader class has been completely rewritten. A couple methods have been removed, while others have been renamed. For methods that remain (renamed or not), their behavior for output data structure and arguments allowed has been changed. The details are in the following.

-
-

Added

+
+

Added#

-
-

Changed

+
+

Changed#

-
-

Deprecated

+
+

Deprecated#

-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Word Frequencies and Ngrams

+

Word Frequencies and Ngrams#

Because word frequencies and combinatorics are useful for many purposes, the following Reader methods are defined:

@@ -287,11 +291,21 @@ - -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/genindex.html b/docs/genindex.html index 9b07d21..e0f8c57 100644 --- a/docs/genindex.html +++ b/docs/genindex.html @@ -4,10 +4,10 @@ - Index - PyLangAcq 0.16.0 documentation + Index - PyLangAcq 0.16.1 documentation - - + + @@ -19,16 +19,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -40,17 +42,13 @@ Contents - - - - - + + Menu - @@ -59,14 +57,14 @@ Expand - Light mode - @@ -81,7 +79,7 @@ Dark mode - @@ -89,7 +87,7 @@ Auto light/dark mode - @@ -122,7 +120,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -145,7 +143,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -167,6 +165,7 @@
+
@@ -174,8 +173,13 @@
-
-
+ + + + + Back to top + +
- -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/headers.html b/docs/headers.html index f6ba592..7821a58 100644 --- a/docs/headers.html +++ b/docs/headers.html @@ -5,11 +5,11 @@ - - Accessing Headers - PyLangAcq 0.16.0 documentation + + Accessing Headers - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Accessing Headers

+

Accessing Headers#

CHAT data files record metadata such as the participants’ demographic information in a header section, which has lines starting with the @ character and is typically found at the top of a data file. @@ -241,7 +245,7 @@

-

Ages

+

Ages#

ages() returns the age information of the participant "CHI" (the target child) by default, since CHAT is by far most commonly used in language acquisition and development research, and that typically only the age of the @@ -299,7 +303,7 @@

Ages

-

Dates of Recording

+

Dates of Recording#

dates_of_recording() returns the dates of recording as a set of date objects for all the date files.

@@ -334,7 +338,7 @@

Dates of Recording -

Languages

+

Languages#

languages() returns the language information. Eve’s data is naturally in English. In datasets with more than one language (bi-/multilingualism), @@ -346,7 +350,7 @@

Languages -

Participants

+

Participants#

participants() returns the participants (e.g., "CHI", "MOT") in the reader. by_files=True is also available if you need the information by individual files.

@@ -359,7 +363,7 @@

Participants -

Other Header Information

+

Other Header Information#

For any header information not given by one of the implemented methods above, headers() gives a list of headers, where each header is a generic Python dictionary for each data file, @@ -444,11 +448,21 @@

Other Header Information - Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/index.html b/docs/index.html index 2b3b51e..380eb63 100644 --- a/docs/index.html +++ b/docs/index.html @@ -7,11 +7,11 @@ - - PyLangAcq 0.16.0 documentation + + PyLangAcq 0.16.1 documentation - - + + @@ -23,16 +23,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -44,17 +46,13 @@ Contents - - - - - + + Menu - @@ -63,14 +61,14 @@ Expand - Light mode - @@ -85,7 +83,7 @@ Dark mode - @@ -93,7 +91,7 @@ Auto light/dark mode - @@ -126,7 +124,7 @@

-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -149,7 +147,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -171,6 +169,7 @@
+
@@ -178,8 +177,13 @@
-
-
+ + + + + Back to top + +
-

PyLangAcq: Language Acquisition Research in Python

+

PyLangAcq: Language Acquisition Research in Python#

PyLangAcq is a Python library for language acquisition research.

  • Easy access to CHILDES and other TalkBank datasets

    • @@ -205,7 +209,7 @@ more generally

-

Download and Install

+

Download and Install#

To download and install the most recent version:

$ pip install --upgrade pylangacq
@@ -213,19 +217,13 @@

Ready for more? Check out the Quickstart page.

-
-

Consulting

-

If your team would like professional assistance in using PyLangAcq, -freelance consulting and training services are available for both academic and commercial groups. -Please email Jackson L. Lee.

-
-

Support

+

Support#

If you have found PyLangAcq useful and would like to offer support, buying me a coffee would go a long way!

-

How to Cite

+

How to Cite#

PyLangAcq is authored and maintained by Jackson L. Lee.

Lee, Jackson L., Ross Burkholder, Gallagher B. Flinn, and Emily R. Coppess. 2016. Working with CHAT transcripts in Python. @@ -250,15 +248,15 @@

How to Cite -

License

+

License#

MIT License. Please see LICENSE.txt in the GitHub source code for details.

The test data files included come from CHILDES, and have a CC BY-NC-SA 3.0 license instead; please also see -pylangacq/tests/test_data/README.md in the GitHub source code for details.

+src/pylangacq/tests/README.md in the GitHub source code for details.

-

Table of Contents

+

Table of Contents#

-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Developmental Measures

+

Developmental Measures#

Several developmental measures are defined as Reader methods:

@@ -272,11 +276,21 @@ - -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/objects.inv b/docs/objects.inv index 9d86979aa9387f4eb5e8967f7953f39e658353e5..e75c41f14b436a24b6a6d5103a2ad60d4222753a 100644 GIT binary patch delta 12 TcmX@jcA9O16QkiqXAWin9Nz<` delta 12 TcmX@jcA9O16QjXKXAWin9NGh= diff --git a/docs/quickstart.html b/docs/quickstart.html index c5475bd..6f24eb8 100644 --- a/docs/quickstart.html +++ b/docs/quickstart.html @@ -5,11 +5,11 @@ - - Quickstart - PyLangAcq 0.16.0 documentation + + Quickstart - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Quickstart

+

Quickstart#

After you have downloaded and installed PyLangAcq (see Download and Install), import the package pylangacq in your Python interpreter:

>>> import pylangacq
@@ -200,7 +204,7 @@

No errors? Great! Now you’re ready to proceed.

-

Reading CHAT data

+

Reading CHAT data#

First off, we need some CHAT data to work with. The function read_chat() asks for a data source and returns a CHAT data reader. @@ -231,7 +235,7 @@

Reading CHAT dataReading CHAT Data.

-

Header Information

+

Header Information#

CHAT transcript files store metadata in the header with lines beginning with @. Among other things, eve has the age information of Eve when the recordings were made, which is from 1 year and 6 months old to 2 years and 3 months old:

@@ -261,7 +265,7 @@

Header InformationAccessing Headers.

-

Transcriptions and Annotations

+

Transcriptions and Annotations#

words() is the basic method to access the transcriptions:

>>> words = eve.words()  # list of strings, for all the words across all 20 files
 >>> len(words)  # total word count
@@ -351,7 +355,7 @@ 
Transcriptions and AnnotationsTranscriptions and Annotations.
-

Word Frequencies and Ngrams

+

Word Frequencies and Ngrams#

For word combinatorics, check out word_frequencies() and word_ngrams():

@@ -375,7 +379,7 @@

Word Frequencies and NgramsWord Frequencies and Ngrams.

-

Developmental Measures

+

Developmental Measures#

To get the mean length of utterance (MLU), use mlu():

>>> eve.mlu()
 [2.309041835357625,
@@ -409,7 +413,7 @@ 
Developmental MeasuresMore on Developmental Measures.
-

Questions?

+

Questions?#

If you have any questions, comments, bug reports etc, please open issues at the GitHub repository, or contact Jackson L. Lee.

@@ -442,11 +446,21 @@

Questions? - Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/read.html b/docs/read.html index 3fd195b..57125e9 100644 --- a/docs/read.html +++ b/docs/read.html @@ -5,11 +5,11 @@ - - Reading CHAT Data - PyLangAcq 0.16.0 documentation + + Reading CHAT Data - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@

-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Reading CHAT Data

+

Reading CHAT Data#

PyLangAcq is designed to handle conversational data represented in the CHAT format as used in the CHILDES database for language acquisition research; CHAT is documented in its official manual. @@ -206,9 +210,9 @@ for parallelization from the official Python documentation.

-

Initializing a Reader

+

Initializing a Reader#

-

read_chat()

+

read_chat()#

Reading CHAT data in PyLangAcq is all about creating a Reader object. The most convenient way to do it is to use the read_chat() function, which asks for a data source and several optional arguments. @@ -329,7 +333,7 @@

-

From a ZIP File or Local Directory

+

From a ZIP File or Local Directory#

Perhaps you don’t want read_chat() to do the guess work of what type of your data source is, or you want more fine-grained control of what counts as CHAT data files or not in your data source. @@ -351,7 +355,7 @@

From a ZIP File or Local Directorypylangacq.chat.remove_cached_data() let you check and remove cached data, respectively.

-

From Specific CHAT Data Files

+

From Specific CHAT Data Files#

If you’d like to target specific files, the Reader classmethod from_files() takes a list of file paths:

>>> path1 = "path/to/one/data/file.cha"
@@ -361,7 +365,7 @@ 
From Specific CHAT Data Files
-
From In-Memory Strings

+
From In-Memory Strings#

 
If your CHAT data comes from in-memory strings,
 the Reader classmethod
 from_strs() takes a list of strings,
@@ -406,7 +410,7 @@ 
From In-Memory Strings
-

Parallel Processing

+

Parallel Processing#

Because a CHILDES / TalkBank dataset usually comes with multiple CHAT data files, it is reasonable to parallelize the process of reading and parsing CHAT data for speed-up. By default, such parallelization is applied. @@ -421,7 +425,7 @@

Parallel ProcessingFalse .

-

Creating an Empty Reader

+

Creating an Empty Reader#

Calling Reader itself with no arguments initializes an empty reader:

>>> reader = pylangacq.Reader()
 >>> reader.n_files()
@@ -434,7 +438,7 @@ 
Creating an Empty Reader
-
Adding and Removing Data

+
Adding and Removing Data#

 
A Reader keeps the linear ordering of CHAT data
 by the ordering of the source data files.
 CHAT data typically comes as data files that each represent a recording session.
@@ -545,7 +549,7 @@ 
Adding and Removing Data
-
Custom Behavior

+
Custom Behavior#

 
If custom behavior in CHAT handling is needed,
 consider defining a child class that inherits from Reader.
 This approach is suitable if, for instance, new class methods are needed,
@@ -587,11 +591,21 @@ 
Custom Behavior
-              Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 |
-          Created using Sphinx and @pradyunsg's
-          Furo theme.
+        

+          

+            

+                Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022
+            

+            Made with Sphinx and @pradyunsg's
+            
+            Furo
+            
+          

+          

+            

+              
+            

+          

         

         
       
diff --git a/docs/search.html b/docs/search.html
index 724c7d9..f2aa695 100644
--- a/docs/search.html
+++ b/docs/search.html
@@ -4,9 +4,9 @@
     
     
 
-    Search - PyLangAcq 0.16.0 documentation
-    
-    
+    Search - PyLangAcq 0.16.1 documentation
+    
+    
     
     
     
@@ -18,16 +18,18 @@
   --color-code-foreground: black;
   
   }
-  body[data-theme="dark"] {
-    --color-code-background: #202020;
+  @media not print {
+    body[data-theme="dark"] {
+      --color-code-background: #202020;
   --color-code-foreground: #d0d0d0;
   
-  }
-  @media (prefers-color-scheme: dark) {
-    body:not([data-theme="light"]) {
-      --color-code-background: #202020;
+    }
+    @media (prefers-color-scheme: dark) {
+      body:not([data-theme="light"]) {
+        --color-code-background: #202020;
   --color-code-foreground: #d0d0d0;
   
+      }
     }
   }
 
@@ -39,17 +41,13 @@
 
   
     Contents
-    
-      
-      
-      
-      
+    
+      
     
   
   
     Menu
-    
       
       
@@ -58,14 +56,14 @@
   
   
     Expand
-    
       
     
   
   
     Light mode
-    
       
       
@@ -80,7 +78,7 @@
   
   
     Dark mode
-    
       
       
@@ -88,7 +86,7 @@
   
   
     Auto light/dark mode
-    
       
       
@@ -121,7 +119,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -144,7 +142,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -166,6 +164,7 @@
+
@@ -173,8 +172,13 @@
-
-
+ + + + + Back to top + +
- -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/searchindex.js b/docs/searchindex.js index 239407e..968516b 100644 --- a/docs/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["api","changelog","frequencies","headers","index","measures","quickstart","read","transcriptions","write"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":4,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.intersphinx":1,"sphinx.ext.viewcode":1,sphinx:56},filenames:["api.rst","changelog.rst","frequencies.rst","headers.rst","index.rst","measures.rst","quickstart.rst","read.rst","transcriptions.rst","write.rst"],objects:{"pylangacq.Reader":[[0,1,1,"","ages"],[0,1,1,"","append"],[0,1,1,"","append_left"],[0,1,1,"","clear"],[0,1,1,"","dates_of_recording"],[0,1,1,"","extend"],[0,1,1,"","extend_left"],[0,1,1,"","file_paths"],[0,1,1,"","filter"],[0,1,1,"","from_dir"],[0,1,1,"","from_files"],[0,1,1,"","from_strs"],[0,1,1,"","from_zip"],[0,1,1,"","head"],[0,1,1,"","headers"],[0,1,1,"","info"],[0,1,1,"","ipsyn"],[0,1,1,"","languages"],[0,1,1,"","mlu"],[0,1,1,"","mlum"],[0,1,1,"","mluw"],[0,1,1,"","n_files"],[0,1,1,"","participants"],[0,1,1,"","pop"],[0,1,1,"","pop_left"],[0,1,1,"","sents"],[0,1,1,"","tagged_sents"],[0,1,1,"","tagged_words"],[0,1,1,"","tail"],[0,1,1,"","to_chat"],[0,1,1,"","to_strs"],[0,1,1,"","tokens"],[0,1,1,"","ttr"],[0,1,1,"","utterances"],[0,1,1,"","word_frequencies"],[0,1,1,"","word_ngrams"],[0,1,1,"","words"]],"pylangacq.chat":[[0,2,1,"","cached_data_info"],[0,2,1,"","remove_cached_data"]],"pylangacq.objects":[[0,0,1,"","Gra"],[0,0,1,"","Token"],[0,0,1,"","Utterance"]],pylangacq:[[0,0,1,"","Reader"],[0,2,1,"","read_chat"]]},objnames:{"0":["py","class","Python class"],"1":["py","method","Python method"],"2":["py","function","Python function"]},objtypes:{"0":"py:class","1":"py:method","2":"py:function"},terms:{"0":[0,3,4,6,7,8],"00":[0,3],"000":7,"0001":[0,9],"0002":[0,9],"00034743":3,"01":4,"010600a":[3,7,8],"010600b":7,"010700a":7,"02":4,"020304":7,"020305":7,"020307":7,"020318":7,"020319":7,"020403":7,"020415":7,"020430":7,"03":4,"04":4,"05":4,"050106":7,"06":[0,3,4],"07":4,"09":4,"0_1073":[0,8],"0o777":[],"0v":[6,8],"0x15":0,"1":[0,3,4,6,7,8],"10":[2,3,4,6],"100":1,"104":2,"1073":[0,8],"10870":6,"11":[3,4,6],"11312":3,"119799":6,"12":[3,4],"1214":7,"1224":7,"124":2,"13":[0,3,4],"1305":7,"1344":7,"139":7,"14":[3,4],"1467":7,"149":2,"15":[3,4],"16":[3,4],"17":3,"1737":7,"177847113884555":[5,6],"178":2,"179732313575526":[5,6],"18":[0,3],"180":7,"184639":7,"19":3,"1962":3,"1963":3,"1972":7,"1990":8,"2":[3,4,5,6,7,8],"20":[3,6,7],"200":7,"20071":6,"2015":4,"2016":4,"2017":4,"2020":4,"2021":4,"2052":7,"208955223880597":[5,6],"21":[0,3],"214":7,"22":3,"23":[3,4],"2363":6,"24":3,"2493":6,"25":[3,4],"2524":6,"26":3,"2631578947368425":[5,6],"26920":7,"27":[3,4],"2758":7,"28":3,"29":3,"292035398230088":[5,6],"3":[2,3,4,5,6,7,8],"30":[3,4],"309041835357625":[5,6],"31":3,"320964749536178":[5,6],"35":2,"3695":6,"3813169984686064":[5,6],"39":2,"4":[3,4,5,6,7,8],"4171011470281543":[5,6],"4196":6,"42":2,"422776911076443":[5,6],"43":2,"4338":6,"4444":6,"4454":6,"45":2,"4535":6,"4568":7,"457182320441989":[5,6],"47":2,"471":6,"488372093023256":[5,6],"498338870431894":[5,6],"5":[0,3,4,6,7,8],"50":2,"510":6,"511":[],"5202":6,"5258":6,"5298":6,"5479":7,"55":2,"5577":7,"560":6,"5612":6,"5707":6,"5742":6,"5810":6,"6":[0,3,4,6,7],"6153846153846154":[5,6],"619":6,"6193":6,"6358":6,"6435":7,"6903":6,"7":[3,4,6],"703":6,"7361":6,"74":2,"741":7,"7749":7,"8":[0,3,4,6],"8063241106719365":[5,6],"8075":6,"822669104204753":[5,6],"840077071290944":[5,6],"8407":6,"850":3,"880322":7,"883668903803132":[5,6],"8866855524079322":[5,6],"89":2,"8901":6,"9":[3,4,6],"92":2,"94":2,"976890756302521":[5,6],"99":2,"boolean":[6,7],"break":1,"case":[0,1,3,7,8,9],"class":[0,1,3,6,7],"computational linguist":4,"default":[0,1,3,6,7,9],"do":[0,1,2,7,8],"export":[0,1,9],"float":[0,6],"function":[1,4,6,7],"import":[2,3,5,6,7,8,9],"int":[0,6,8],"language acquisit":4,"language develop":4,"long":[3,4,7],"natural language proces":4,"new":[0,1,7,9],"return":[0,1,2,3,6,7,8],"static":1,"switch":1,"true":[0,1,3,6,7,8,9],"while":[0,1,7,8],A:[0,1,2,6,7,8],As:[6,7],BY:4,By:[6,7,9],For:[0,1,2,3,5,6,7],If:[0,4,6,7,8,9],In:[1,3,8],It:[1,6,7],Its:1,No:6,Or:8,Such:[0,6],The:[0,1,3,4,6,7,8],There:[1,7],These:[0,7,9],To:[1,2,3,4,6,7,8,9],With:7,_:[],__main__:[6,7],__name__:[6,7],_clean_utter:1,_dependencygraph:1,_singleread:1,about:[1,7,8],abov:[1,3,6,8],absolut:1,abspath:1,academ:4,access:[4,6,8],accord:3,acknowledg:0,acquisit:[3,7],across:[1,6],action:3,ad:[4,8,9],adam:[0,7,9],add:1,addit:[1,7],adj:7,adjust:0,affect:0,after:6,ag:[0,1,4,6],again:[1,7],against:0,ahead:7,al:4,align:[0,8],all:[0,1,3,6,7,8],all_:1,allow:[0,1,7],allow_remot:1,alreadi:[0,7],also:[0,1,3,4,7,8],alter:7,although:8,american:[0,6,7,8],among:[6,7],amount:7,an:[0,1,6,8,9],analysi:6,ani:[0,1,3,6],annot:[0,1,4],anoth:[0,1,2,7,8],anymor:1,apart:[6,8],api:[1,4],appar:8,appear:[0,2,8],append:[0,1,7],append_left:[0,1],appli:[0,7],applic:[0,7],approach:7,appropri:0,ar:[0,1,2,4,5,6,7,8,9],arbitrari:0,archiv:[0,1,6,7],aren:7,argument:[0,1,2,3,7,8,9],around:8,ascii:0,ask:[6,7],assist:4,associ:[0,1,8],assum:7,asterisk:8,attempt:[0,2],attent:[2,8],attribut:[0,6,8],audio:[0,8],author:4,autobuild:1,automat:7,avail:[0,1,3,4,6,7,8,9],avoid:[0,1,6,7],awai:1,b:[2,4],backward:1,bandit:1,bar:0,base:[7,8],basic:6,becaus:[0,2,7,8],becom:0,been:[0,1],befor:[1,8],begin:[0,3,6,8],behavior:[0,1,4],behind:7,being:[0,1,2],below:7,besid:8,best:8,better:1,between:[1,2,8],beyond:[6,8],bi:[1,3],big:7,bigram:6,birth:1,black:1,block:[],bool:0,both:[0,1,2,4,8],brief:2,brown:[0,2,3,5,6,7,8,9],bug:[1,4,6],bui:4,build:[1,7],built:8,bundl:8,burkhold:4,by_fil:[0,1,2,3,6,8],by_utter:[0,1,8],c:[2,3],cach:[0,1,7],cached_data_info:[0,1,7],call:[0,7,8],can:[0,1,3,6,7,8,9],cannot:0,cantones:7,capabl:[1,7],capit:0,captur:8,care:1,cc:4,certain:[0,8],cfg:1,cha:[0,1,3,6,7,8,9],cha_lin:1,changelog:4,charact:[1,3],chat:[0,1,3,4],chatread:7,check:[0,1,2,4,6,7],checker:7,chi:[0,1,2,3,6,7,8],chicago:4,child:[0,1,2,3,4,5,6,7,8,9],children:[0,7],ci:1,circleci:1,circumst:0,cl:0,classmethod:[0,1,7],clean:[1,8],clean_utter:1,clean_word:1,clear:[0,1],co:1,code:[0,1,4,6,7,8],coffe:4,col:3,colin:3,collaps:[0,1,2],collect:[0,1,2,6],com:4,combin:1,combinator:[2,6],come:[0,4,7,8],comment:6,commerci:4,commit:1,common:[0,7],commonli:[1,3,7,8],compar:8,compat:1,complet:[0,1],comput:[1,4,6],concaten:[1,7],concord:1,conduct:3,confirm:[2,8],conform:7,confus:1,consid:[0,7],consist:1,construct:8,contact:6,contain:[0,6,7,8],content:1,contextu:8,continu:1,contrast:2,contribut:1,control:[7,8],conveni:[1,7],convent:[0,1,8],convers:[1,4,7,8],convert:3,cooki:[6,7,8],coppess:4,corpora:4,corpu:[3,6],correct:1,correspond:[0,1,8],count:[2,6,7],counter:[0,2,6],coupl:[1,7],cover:[1,7],creat:[0,8],cross:1,current:0,custom:[0,1,3,4,8,9],customari:8,d:7,dai:[0,3],data:[0,1,2,3,4,5,8],databas:7,dataclass:6,dataset:[0,1,3,4,6,7,8,9],date:[0,1,4],date_of_birth:1,date_of_record:1,dates_of_record:[0,1,3],datetim:[0,1,3],decim:[],decor:1,defin:[1,2,5,7],demand:[2,8],demograph:3,denot:8,dep:[0,6,8],depart:4,depend:[0,1,8],dependencygraph:1,deprec:0,dequ:7,deriv:8,describ:[0,7],design:[7,8],desir:1,detail:[0,1,3,4],detect:1,determin:[0,7],dev:1,develop:[1,3],development:4,dict:[0,1,3],dictionari:[0,1,3,8],differ:6,digit:[0,8],digraph:1,direct:[0,2,4,8],directori:[0,1,9],discuss:7,disk:[0,7,9],distinct:[0,2,6,8],distinguish:[1,8],distribut:9,dob:1,doc:1,docstr:1,document:[1,6,7],doe:[0,8],doesn:0,domin:[0,2],don:[7,8],done:0,down:7,download:[0,1,6,7],drill:7,drop:[0,1,7,8],drum:7,due:7,duplic:[0,1],durat:[0,3],dure:7,e:[0,1,3,7,8,9],each:[0,1,3,6,7,8],easi:4,easier:8,easili:7,educ:3,effect:7,either:[0,1,6,7,9],element:[0,1,7],email:4,emili:4,empti:1,enabl:1,encod:[0,1],end:[0,7,8],enforc:1,eng:[0,2,3,5,6,7,9],english:[0,3,6,7,8],enough:1,entir:1,equival:0,error:[6,7],especi:[6,7,8,9],essenti:1,et:4,etc:[0,1,6,7,9],european:0,ev:[0,1,2,3,5,6,7,8,9],eve_and_sarah:9,eve_one_fil:7,eve_token:8,even:[0,8],everi:8,everyth:7,exampl:[0,6,7,8],exclud:[0,1,2,8,9],exist:[0,1,9],expect:[0,6],explain:8,explicit:[],explicitli:7,expos:[1,8],express:[0,1],extend:[0,1,7],extend_left:[0,1],extens:[0,4,7],extra:[6,8],extract:[0,1,7,8],fair:7,fals:[0,1,7],far:[3,6,7],faster:7,fat:[3,8],femal:3,field:0,file:[0,1,3,4,6,9],file_path:[0,1,7],filenam:[0,1,9],filter:[0,1,7,9],find_filenam:1,fine:7,finish:7,first:[0,1,6,8],flag:3,flat:[6,8],flexibl:[4,8],flinn:4,focus:7,folder:7,follow:[0,1,2,3,7,8],foo:0,forc:[0,1,7],forkserv:[],form:[0,7,8],format:[0,1,3,4,7],found:[3,4,7,8],fraser:2,freelanc:4,frequenc:[0,4],frequent:2,from:[0,1,2,3,4,5,6,8,9],from_chat_fil:1,from_chat_str:1,from_dir:[0,1,7],from_fil:[0,1,7],from_str:[0,1,7,8,9],from_zip:[0,1,7],fulli:1,furo:1,further:[0,7,8],futur:1,g:[0,1,3,7,8,9],gain:1,gallagh:4,gender:3,gener:[0,3,4],get:[0,2,6,7],get_ipsyn:1,get_lemma_from_mor:1,github:[4,6],give:[1,3,7,8],given:[0,1,3],glimps:7,glo:3,go:[2,4,7],gra:[1,4,6,7,8],grain:7,grammar:[1,8],grammat:[0,1,6,8],grape:2,graph:1,great:6,greatli:1,group:[3,4],grow:7,guess:7,ha:[0,1,2,3,6,7,8,9],had:8,handl:[0,1,7,8],hard:1,hasn:1,have:[0,1,2,3,4,6,7,8],head:[0,1,6,7,8],header:[0,1,4],hei:9,hellolzc:1,helper:[1,4,7],her:8,here:[0,7,8],hi:2,hit:0,hood:7,how:[0,7,8],html:[],http:[0,2,3,4,5,6,7,9],i:[0,1,2,7,8],id:[0,3],identifi:0,idiom:[6,7],ignor:8,illustr:[2,3,6,7],imit:7,immedi:[7,8],imp:[6,8],implement:[0,1,3,6],improv:1,includ:[0,1,4,8],incroot:[6,7,8],independ:7,index:[0,4,6],index_to_ti:1,indic:[0,1,3,7,8],individu:[3,6,7],inflect:8,info:[0,1,7],inform:[0,1,4,8],inherit:7,initi:[1,4],inner:[6,8],input:[0,1,7],insid:7,inspect:7,instal:6,instanc:[0,1,6,7],instanti:[0,1,7],instead:[0,1,4,8],institut:4,integ:[3,8],integr:1,intention:0,interact:8,interest:[0,1,2,6],intermitt:0,intern:8,interpret:[0,6],inton:8,introduc:[7,8],introduct:1,intuit:4,inv:0,investig:[1,3],ipsyn:[0,1,4,6],is_dir:[0,9],isn:0,issu:[0,1,4,6],item:[1,8],iter:[0,7,8],its:[1,7,8,9],itself:[0,1,7,8],jackson:[4,6],jacksonlle:4,juic:2,just:[0,1,2,7,8],keep:[1,7],keep_cas:[0,2],kei:1,kept:[0,2],keyword:[7,9],know:7,knowledg:7,known:[0,8],kwarg:1,l:[4,6],languag:[0,1,6,7,8],last:0,latest:1,latter:6,lead:1,least:1,leav:0,lee:[4,6],left:[0,8],len:[0,1,6,7],length:[0,4,5,6],less:[1,7],let:[2,3,6,7,8],letter:0,level:[0,8],librari:[1,4],like:[0,1,2,3,4,7,9],line:[3,6,8],linear:7,linguist:[4,6,8],list:[0,1,3,6,7,8],local:[0,1,6,9],locat:[0,3],longer:1,look:[2,3,7,8],lot:1,loud:[6,8],lowercas:[0,2],made:[1,6,7],mai:[0,1,6,7,8],main:[0,6,7],maintain:4,make:[0,1,2,6],makedir:[],mani:[0,1,2,6,7,8],manipul:[1,4,7],manual:7,map:[1,2],mark:6,markdown:1,marker:1,match:[0,1,7],md:4,me:4,mean:[0,1,4,5,6,8],measur:[1,4],media:4,memori:[0,1,8,9],metadata:[0,1,3,6],method:[0,1,2,3,5,6,7,8,9],might:[0,8],millisecond:[0,8],minim:[1,7],minor:0,minut:2,mit:4,mlu:[0,1,4,5,6],mlum:[0,1],mluw:[0,1],mod:[1,7],mode:[],model:[7,8],modifi:[0,7],modul:[1,6,7],month:[0,1,3,6],mor:[0,6,7,8],more:[0,1,2,3,4,6,7,8],morphem:0,morpholog:[0,6,8],most:[0,3,4,7],most_common:[2,6],mostli:1,mot:[0,1,3,7,8,9],mother:[1,3,8],much:7,multilingu:[1,3],multipl:[0,1,3,7,8,9],multipli:0,multiprocess:1,must:8,mutat:7,n:[0,6,7,8],n_file:[0,1,6,7],n_utter:1,na:[0,2,3,5,6,7,9],nak:0,name:[1,3,7,9],natur:[1,2,3,7],nc:4,necessari:[0,7],necessarili:7,need:[3,6,7,8],neg:0,neither:0,network:0,networkx:1,next:[3,8],ngram:[0,4],nlp:4,nomin:8,non:1,none:[0,6,7,8],nor:0,note:0,notic:7,now:[1,6,9],number:[0,1,4,6,7],number_of_fil:1,number_of_utter:1,obj:8,object:[0,1,2,3,6,7,8,9],obligatori:8,oct:3,off:[1,6,7],offer:4,offici:[6,7],often:8,okai:7,old:[3,6],onc:[0,8],one:[0,1,2,3,6,7,8],onli:[0,1,3,7,8,9],open:6,oper:[1,7],optim:1,option:[0,1,2,6,7,8],orb:1,order:[0,1,7,8],org:[0,2,3,5,6,7,9],organ:[0,7,9],origin:[0,1,6,7,8],orthograph:[0,8],other:[0,1,4,6,7,8,9],otherwis:0,ourselv:7,out:[1,2,4,6],outermost:8,output:[0,1,9],over:7,own:0,packag:[0,1,6,7],page:[4,7,8],pai:8,parallel:[0,1,6],paramet:[0,1,6],parent:8,pars:[0,1,6,7],part:[0,7,8],part_of_speech_tag:1,particip:[0,1,2,4,6,7],participant_cod:1,participant_nam:1,participant_rol:1,particular:7,pass:[0,3,7,8],path1:7,path2:7,path:[0,1,7],paus:[0,8],pe:7,per:[6,8],perform:1,perhap:7,permiss:[],pho:[1,7],phonbank:1,pid:3,pip:4,pipe:[6,8],pl:[7,8],place:7,plai:7,pleas:[0,4,6,7],plot:6,plural:8,po:[0,6,7,8],point:[0,1,7],pop:[0,1],pop_left:[0,1],posit:[0,8],possibl:[0,1,4],potenti:1,power:[4,7],practic:[1,7],preprocess:0,preserv:8,preview:7,previou:1,previous:[0,1],print:[0,6,7,8],priorit:1,privat:1,pro:[6,8],proce:6,process:[1,6],product:[0,4,6],profession:4,prototyp:6,provid:[0,7,8],pull:1,punct:[6,7,8],punctuat:8,purpos:[2,7,8],put:[6,7],py:1,pycantones:7,pylangacq:[0,2,3,5,6,7,8,9],pyproject:1,python:[1,3,6,7,8],qn:[6,8],quant:[6,8],quantif:8,quantifi:8,question:[2,4,8],quick:7,quickstart:4,quot:1,r:[1,4],rais:0,random:0,rather:1,ratio:[0,4,6],re:[0,1,6,7,9],read:[0,1,4,9],read_chat:[1,2,3,4,5,6,9],reader1:7,reader2:7,reader:[1,2,3,4,5,6,8,9],reader_one_fil:7,readi:[4,6],readili:[0,4,6,8],readm:[1,4],realli:1,reason:[0,1,7],recent:[4,8],record:[0,1,4,6,7,8],recurs:[0,7],refer:[4,6,7],reflect:7,regular:[0,1],rel:[0,6,8],relat:[0,1,6,8],remain:1,remot:[0,6,7],remov:[0,4,9],remove_cached_data:[0,1,7],renam:1,repeatedli:0,repetit:1,report:[4,6],repositori:6,repres:[0,2,7,8],represent:1,reproduc:0,request:[0,1],requir:1,research:[3,7],respect:[6,7],respond:8,restrict:1,restructuredtext:1,result:[0,1,2,6,7],retain:0,retri:0,retriev:[0,3],revamp:1,rewrit:1,rewritten:1,ric:3,rich:[6,8],richard:3,right:[2,8],robust:[0,1],role:[1,3],root:[6,8],ross:4,rst:1,rtd:1,run:[6,7],s:[0,1,2,3,5,6,7,8,9],sa:4,safe:[6,7],safeti:1,sai:[1,8],same:[0,1,2,3,7,8],sampl:7,sarah:[0,7,9],satisfi:0,save:9,scene:7,scienc:4,script:[6,7],se:[1,3],search:[0,1],second:[7,8],section:[3,6,7,8],see:[0,1,3,4,6,7,8,9],seen:7,segment:[0,8],self:1,sens:[0,1],sent:[0,1],sentenc:0,separ:2,server:0,servic:4,session:[0,1,3,7,8],set:[0,1,3,7],setup:1,sever:[0,5,7,8],sex:3,should:[2,7],show:[0,2,3,7],shown:[6,8],sign:8,signal:[0,8],simpler:1,simpli:0,sinc:[0,1,3],singl:[0,1,7,8],singleread:1,six:3,skip:[],slice:7,slightli:2,small:1,smaller:7,snippet:[1,8],so:[0,1,6,7,8],social:4,socioeconom:1,some:[1,2,3,6,7,8,9],some_data:7,some_token:6,someth:1,sometim:8,somewher:9,sort:[0,7],sorted_by_ag:1,sourc:[0,4,6,7],spa:7,space:[0,8],spawn:1,speaker:1,specif:1,specifi:[0,1,2,7,8],sped:1,speech:[0,2,4,8],speed:[0,6,7],sphinx:1,standard:[1,4,8],start:[0,1,3,7,8],statement:7,statu:1,step:0,still:7,store:6,str:0,string:[0,1,6,8,9],structur:[0,1,4,6,7,8],studi:0,style:1,stylist:1,subclass:[0,1,7],subdirectori:7,subj:[6,8],submodul:1,subset:7,substr:7,sue:3,suggest:1,suit:[1,8],suitabl:7,summari:0,support:[1,7,9],suppos:7,sweeti:9,syntax:[0,4,6],system:[0,7],t:[0,1,7,8],tabul:1,tabular:0,tag:[0,1,8],tagged_s:[0,1],tagged_word:[0,1],tail:[0,1,7],take:[7,8],talkbank:[0,2,3,4,5,6,7,9],tape:[0,3],target:[0,3,7,8],target_child:3,td:3,team:4,technic:4,techreport:4,tell:7,temporari:1,term:8,terminolog:[1,7],test:[1,4],test_data:4,text:[0,8],than:[0,1,3,9],thei:[0,2,6,8],them:8,theme:1,therefor:[1,7,8],thi:[0,1,2,6,7,8],thing:[6,7],think:[6,7],those:0,though:1,three:[0,3,7],through:[1,3,6,7,9],ti:7,tie:8,tier:[0,1,6,7],tier_mark:1,tier_sniff:1,time:[0,1,3,6,7],time_mark:[0,6,7,8],timeout:0,titl:4,to_chat:[0,1,9],to_conl:1,to_gra_ti:[],to_mor_ti:[],to_str:[0,1,9],to_tikz:1,togeth:0,tokai:7,token:[1,2,4,6,7],toml:1,top:3,total:6,toyplai:3,tr:4,track:1,tracker:4,train:4,transcrib:0,transcript:[0,1,4],translat:8,travers:7,travi:1,treat:[0,1,7,8],treatment:7,trigram:2,trigrams_child_directed_speech:2,trigrams_child_speech:2,ttr:[0,1,4,6],tupl:[0,3,8],turn:[1,7],twitter:4,two:[7,8],txt:4,type:[0,3,4,6,7,8],typeerror:0,typic:[0,3,7],under:[0,1,6,7],underscor:1,understand:3,undesir:[0,7],undid:1,unicod:[0,1],union:0,univers:4,unnecessari:0,unord:1,unpars:[0,1,6,8],unreleas:4,unseg:6,unzip:[0,1,7],up:[0,1,6,7,8],upcom:7,updat:[0,1],upgrad:4,upon:7,upper:2,upstream:0,ur:3,url:[0,1,2,3,5,6,7],us:[0,1,2,3,4,6,7,8,9],usag:2,use_cach:[0,1,7],user:[6,7],usual:[1,7],utf8:3,utf:0,utter:[1,2,4,5,6,7],uuid:0,v:[6,8],valid:7,valu:[0,1],valueerror:0,vari:1,variou:[1,2,6],ve:[7,8],verbos:[0,7],veri:[2,8],version:[0,1,4],versu:2,via:[6,7,8],video:[0,8],visibl:1,w:1,wa:[1,8],wai:[0,4,7,9],walk:[1,3],want:[0,2,7,9],we:[1,2,6,7,8,9],well:[0,1,7,8],were:[3,6,7,8],what:[2,6,7,8],whatev:0,when:[0,1,6,7,8,9],where:[0,3,7,8],wherea:8,whether:2,which:[0,1,2,3,6,7,8],whitespac:1,who:8,whose:0,window:[1,6,7],within:[0,7],without:[0,7],won:7,word:[0,1,4,7],word_freq:6,word_frequ:[0,1,2,6],word_ngram:[0,1,2,6],words_by_fil:6,words_one_fil:6,work:[0,1,2,4,6,7,8],worth:1,would:[0,1,2,3,4,7,9],wouldn:1,wrap:[0,8],wrapper:7,write:[0,1,4],written:0,x:[0,1],xxx:0,yeah:6,year:[0,3,4,6],yet:[0,6],yield:[0,1],you:[0,1,2,3,4,6,7,8,9],your:[0,3,4,6,7,8,9],zero:3,zip:[0,1,2,3,5,6,9]},titles:["API Reference","Changelog","Word Frequencies and Ngrams","Accessing Headers","PyLangAcq: Language Acquisition Research in Python","Developmental Measures","Quickstart","Reading CHAT Data","Transcriptions and Annotations","Writing CHAT Data"],titleterms:{"0":1,"01":1,"02":1,"03":1,"04":1,"05":1,"06":1,"07":1,"09":1,"1":1,"10":1,"11":1,"12":1,"13":1,"14":1,"15":1,"16":1,"2":1,"2015":1,"2016":1,"2017":1,"2020":1,"2021":1,"23":1,"25":1,"27":1,"3":1,"30":1,"4":1,"5":1,"6":1,"7":1,"8":1,"9":1,"function":0,In:7,access:3,acquisit:4,ad:[1,7],ag:3,an:7,annot:[6,8],api:0,behavior:7,chang:1,changelog:1,chat:[6,7,8,9],cite:4,consult:4,content:4,creat:7,custom:7,data:[6,7,9],date:3,deprec:1,development:[5,6],directori:7,download:4,empti:7,file:[7,8],filter:8,fix:1,format:8,frequenc:[2,6],from:7,gra:0,header:[3,6],helper:0,how:4,inform:[3,6],initi:7,instal:4,languag:[3,4],licens:4,link:4,local:7,mark:8,measur:[5,6],memori:7,ngram:[2,6],other:3,output:8,parallel:7,particip:[3,8],process:7,pylangacq:4,python:4,question:6,quickstart:6,read:[6,7],read_chat:[0,7],reader:[0,7],record:3,refer:0,remov:[1,7],research:4,secur:1,specif:7,string:7,support:4,tabl:4,tier:8,time:8,token:[0,8],transcript:[6,8],unreleas:1,utter:[0,8],word:[2,6,8],write:9,zip:7}}) \ No newline at end of file +Search.setIndex({docnames:["api","changelog","frequencies","headers","index","measures","quickstart","read","transcriptions","write"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":4,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.intersphinx":1,"sphinx.ext.viewcode":1,sphinx:56},filenames:["api.rst","changelog.rst","frequencies.rst","headers.rst","index.rst","measures.rst","quickstart.rst","read.rst","transcriptions.rst","write.rst"],objects:{"pylangacq.Reader":[[0,1,1,"","ages"],[0,1,1,"","append"],[0,1,1,"","append_left"],[0,1,1,"","clear"],[0,1,1,"","dates_of_recording"],[0,1,1,"","extend"],[0,1,1,"","extend_left"],[0,1,1,"","file_paths"],[0,1,1,"","filter"],[0,1,1,"","from_dir"],[0,1,1,"","from_files"],[0,1,1,"","from_strs"],[0,1,1,"","from_zip"],[0,1,1,"","head"],[0,1,1,"","headers"],[0,1,1,"","info"],[0,1,1,"","ipsyn"],[0,1,1,"","languages"],[0,1,1,"","mlu"],[0,1,1,"","mlum"],[0,1,1,"","mluw"],[0,1,1,"","n_files"],[0,1,1,"","participants"],[0,1,1,"","pop"],[0,1,1,"","pop_left"],[0,1,1,"","sents"],[0,1,1,"","tagged_sents"],[0,1,1,"","tagged_words"],[0,1,1,"","tail"],[0,1,1,"","to_chat"],[0,1,1,"","to_strs"],[0,1,1,"","tokens"],[0,1,1,"","ttr"],[0,1,1,"","utterances"],[0,1,1,"","word_frequencies"],[0,1,1,"","word_ngrams"],[0,1,1,"","words"]],"pylangacq.chat":[[0,2,1,"","cached_data_info"],[0,2,1,"","remove_cached_data"]],"pylangacq.objects":[[0,0,1,"","Gra"],[0,0,1,"","Token"],[0,0,1,"","Utterance"]],pylangacq:[[0,0,1,"","Reader"],[0,2,1,"","read_chat"]]},objnames:{"0":["py","class","Python class"],"1":["py","method","Python method"],"2":["py","function","Python function"]},objtypes:{"0":"py:class","1":"py:method","2":"py:function"},terms:{"0":[0,3,4,6,7,8],"00":[0,3],"000":7,"0001":[0,9],"0002":[0,9],"00034743":3,"01":4,"010600a":[3,7,8],"010600b":7,"010700a":7,"02":4,"020304":7,"020305":7,"020307":7,"020318":7,"020319":7,"020403":7,"020415":7,"020430":7,"03":4,"04":4,"05":4,"050106":7,"06":[0,3,4],"07":4,"09":4,"0_1073":[0,8],"0o777":[],"0v":[6,8],"0x15":0,"1":[0,3,4,6,7,8],"10":[2,3,4,6],"100":1,"104":2,"1073":[0,8],"10870":6,"11":[3,4,6],"11312":3,"119799":6,"12":[3,4],"1214":7,"1224":7,"124":2,"13":[0,3,4],"1305":7,"1344":7,"139":7,"14":[3,4],"1467":7,"149":2,"15":[3,4],"16":[3,4],"17":[3,4],"1737":7,"177847113884555":[5,6],"178":2,"179732313575526":[5,6],"18":[0,3],"180":7,"184639":7,"19":3,"1962":3,"1963":3,"1972":7,"1990":8,"2":[3,4,5,6,7,8],"20":[3,6,7],"200":7,"20071":6,"2015":4,"2016":4,"2017":4,"2020":4,"2021":4,"2022":4,"2052":7,"208955223880597":[5,6],"21":[0,3],"214":7,"22":3,"23":[3,4],"2363":6,"24":3,"2493":6,"25":[3,4],"2524":6,"26":3,"2631578947368425":[5,6],"26920":7,"27":[3,4],"2758":7,"28":3,"29":3,"292035398230088":[5,6],"3":[2,3,4,5,6,7,8],"30":[3,4],"309041835357625":[5,6],"31":3,"320964749536178":[5,6],"35":2,"3695":6,"3813169984686064":[5,6],"39":2,"4":[3,4,5,6,7,8],"4171011470281543":[5,6],"4196":6,"42":2,"422776911076443":[5,6],"43":2,"4338":6,"4444":6,"4454":6,"45":2,"4535":6,"4568":7,"457182320441989":[5,6],"47":2,"471":6,"488372093023256":[5,6],"498338870431894":[5,6],"5":[0,3,4,6,7,8],"50":2,"510":6,"511":[],"5202":6,"5258":6,"5298":6,"5479":7,"55":2,"5577":7,"560":6,"5612":6,"5707":6,"5742":6,"5810":6,"6":[0,3,4,6,7],"6153846153846154":[5,6],"619":6,"6193":6,"6358":6,"6435":7,"6903":6,"7":[3,4,6],"703":6,"7361":6,"74":2,"741":7,"7749":7,"8":[0,3,4,6],"8063241106719365":[5,6],"8075":6,"822669104204753":[5,6],"840077071290944":[5,6],"8407":6,"850":3,"880322":7,"883668903803132":[5,6],"8866855524079322":[5,6],"89":2,"8901":6,"9":[3,4,6],"92":2,"94":2,"976890756302521":[5,6],"99":2,"boolean":[6,7],"break":1,"case":[0,1,3,7,8,9],"class":[0,1,3,6,7],"computational linguist":4,"default":[0,1,3,6,7,9],"do":[0,1,2,7,8],"export":[0,1,9],"float":[0,6],"function":[1,4,6,7],"import":[1,2,3,5,6,7,8,9],"int":[0,6,8],"language acquisit":4,"language develop":4,"long":[3,4,7],"natural language proces":4,"new":[0,1,7,9],"return":[0,1,2,3,6,7,8],"static":1,"switch":1,"true":[0,1,3,6,7,8,9],"while":[0,1,7,8],A:[0,1,2,6,7,8],As:[6,7],BY:4,By:[6,7,9],For:[0,1,2,3,5,6,7],If:[0,4,6,7,8,9],In:[1,3,8],It:[1,6,7],Its:1,No:6,Or:8,Such:[0,6],The:[0,1,3,4,6,7,8],There:[1,7],These:[0,7,9],To:[1,2,3,4,6,7,8,9],With:7,_:[],__main__:[6,7],__name__:[6,7],_clean_utter:1,_dependencygraph:1,_singleread:1,about:[1,7,8],abov:[1,3,6,8],absolut:1,abspath:1,academ:[],access:[4,6,8],accord:3,acknowledg:0,acquisit:[3,7],across:[1,6],action:3,ad:[4,8,9],adam:[0,7,9],add:1,addit:[1,7],adj:7,adjust:0,affect:0,after:6,ag:[0,1,4,6],again:[1,7],against:0,ahead:7,al:4,align:[0,8],all:[0,1,3,6,7,8],all_:1,allow:[0,1,7],allow_remot:1,alreadi:[0,7],also:[0,1,3,4,7,8],alter:7,although:8,american:[0,6,7,8],among:[6,7],amount:7,an:[0,1,6,8,9],analysi:6,ani:[0,1,3,6],annot:[0,1,4],anoth:[0,1,2,7,8],anymor:1,apart:[6,8],api:[1,4],appar:8,appear:[0,2,8],append:[0,1,7],append_left:[0,1],appli:[0,7],applic:[0,7],approach:7,appropri:0,ar:[0,1,2,5,6,7,8,9],arbitrari:0,archiv:[0,1,6,7],aren:7,argument:[0,1,2,3,7,8,9],around:8,ascii:0,ask:[6,7],assist:[],associ:[0,1,8],assum:7,asterisk:8,attempt:[0,2],attent:[2,8],attribut:[0,6,8],audio:[0,8],author:4,autobuild:1,automat:7,avail:[0,1,3,4,6,7,8,9],avoid:[0,1,6,7],awai:1,b:[2,4],back:1,backward:1,bandit:1,bar:0,base:[7,8],basetestchatread:1,basic:6,becaus:[0,2,7,8],becom:0,been:[0,1],befor:[1,8],begin:[0,3,6,8],behavior:[0,1,4],behind:7,being:[0,1,2],below:7,besid:8,best:8,better:1,between:[1,2,8],beyond:[6,8],bi:[1,3],big:7,bigram:6,birth:1,black:1,block:[],bool:0,both:[0,1,2,8],brief:2,brown:[0,2,3,5,6,7,8,9],bug:[1,4,6],bui:4,build:[1,7],built:8,bundl:8,burkhold:4,by_fil:[0,1,2,3,6,8],by_utter:[0,1,8],c:[2,3],cach:[0,1,7],cached_data_info:[0,1,7],call:[0,7,8],can:[0,1,3,6,7,8,9],cannot:0,cantones:7,capabl:[1,7],capit:0,captur:8,care:1,cc:4,certain:[0,8],cfg:1,cha:[0,1,3,6,7,8,9],cha_lin:1,changelog:4,charact:[1,3],chat:[0,1,3,4],chatread:7,check:[0,1,2,4,6,7],checker:7,chi:[0,1,2,3,6,7,8],chicago:4,child:[0,1,2,3,4,5,6,7,8,9],children:[0,7],ci:1,circleci:1,circumst:0,cl:0,classmethod:[0,1,7],clean:[1,8],clean_utter:1,clean_word:1,clear:[0,1],co:1,code:[0,1,4,6,7,8],coffe:4,col:3,colin:3,collaps:[0,1,2],collect:[0,1,2,6],com:4,combin:1,combinator:[2,6],come:[0,4,7,8],comment:6,commerci:[],commit:1,common:[0,7],commonli:[1,3,7,8],compar:8,compat:1,complet:[0,1],comput:[1,4,6],concaten:[1,7],concord:1,conduct:3,confirm:[2,8],conform:7,confus:1,consid:[0,7],consist:1,construct:8,contact:6,contain:[0,6,7,8],content:1,contextu:8,continu:1,contrast:2,contribut:1,control:[7,8],conveni:[1,7],convent:[0,1,8],convers:[1,4,7,8],convert:3,cooki:[6,7,8],coppess:4,corpora:4,corpu:[3,6],correct:1,correspond:[0,1,8],count:[2,6,7],counter:[0,2,6],coupl:[1,7],cover:[1,7],creat:[0,8],cross:1,current:0,custom:[0,1,3,4,8,9],customari:8,d:7,dai:[0,3],data:[0,1,2,3,4,5,8],databas:7,dataclass:6,dataset:[0,1,3,4,6,7,8,9],date:[0,1,4],date_of_birth:1,date_of_record:1,dates_of_record:[0,1,3],datetim:[0,1,3],decim:[],decor:1,defin:[1,2,5,7],demand:[2,8],demograph:3,denot:8,dep:[0,6,8],depart:4,depend:[0,1,8],dependencygraph:1,deprec:0,dequ:7,deriv:8,describ:[0,7],design:[7,8],desir:1,detail:[0,1,3,4],detect:1,determin:[0,7],dev:1,develop:[1,3],development:4,dict:[0,1,3],dictionari:[0,1,3,8],differ:6,digit:[0,8],digraph:1,direct:[0,2,4,8],directori:[0,1,9],discuss:7,disk:[0,7,9],distinct:[0,2,6,8],distinguish:[1,8],distribut:9,dob:1,doc:1,docstr:1,document:[1,6,7],doe:[0,8],doesn:0,domin:[0,2],don:[7,8],done:0,down:7,download:[0,1,6,7],drill:7,drop:[0,1,7,8],drum:7,due:7,duplic:[0,1],durat:[0,3],dure:7,e:[0,1,3,7,8,9],each:[0,1,3,6,7,8],easi:4,easier:8,easili:7,educ:3,effect:7,either:[0,1,6,7,9],element:[0,1,7],email:[],emili:4,empti:1,enabl:1,encod:[0,1],end:[0,7,8],enforc:1,eng:[0,2,3,5,6,7,9],english:[0,3,6,7,8],enough:1,entir:1,equival:0,error:[6,7],especi:[6,7,8,9],essenti:1,et:4,etc:[0,1,6,7,9],european:0,ev:[0,1,2,3,5,6,7,8,9],eve_and_sarah:9,eve_one_fil:7,eve_token:8,even:[0,8],everi:8,everyth:7,exampl:[0,6,7,8],exclud:[0,1,2,8,9],exist:[0,1,9],expect:[0,6],explain:8,explicit:[],explicitli:7,expos:[1,8],express:[0,1],extend:[0,1,7],extend_left:[0,1],extens:[0,4,7],extra:[6,8],extract:[0,1,7,8],fair:7,fals:[0,1,7],far:[3,6,7],faster:7,fat:[3,8],femal:3,field:0,file:[0,1,3,4,6,9],file_path:[0,1,7],filenam:[0,1,9],filter:[0,1,7,9],find_filenam:1,fine:7,finish:7,first:[0,1,6,8],flag:3,flat:[6,8],flexibl:[4,8],flinn:4,focus:7,folder:7,follow:[0,1,2,3,7,8],foo:0,forc:[0,1,7],forkserv:[],form:[0,7,8],format:[0,1,3,4,7],found:[3,4,7,8],fraser:2,freelanc:[],frequenc:[0,4],frequent:2,from:[0,1,2,3,4,5,6,8,9],from_chat_fil:1,from_chat_str:1,from_dir:[0,1,7],from_fil:[0,1,7],from_str:[0,1,7,8,9],from_zip:[0,1,7],fulli:1,furo:1,further:[0,7,8],futur:1,g:[0,1,3,7,8,9],gain:1,gallagh:4,gender:3,gener:[0,3,4],get:[0,2,6,7],get_ipsyn:1,get_lemma_from_mor:1,github:[4,6],give:[1,3,7,8],given:[0,1,3],glimps:7,glo:3,go:[2,4,7],gra:[1,4,6,7,8],grain:7,grammar:[1,8],grammat:[0,1,6,8],grape:2,graph:1,great:6,greatli:1,group:3,grow:7,guess:7,ha:[0,1,2,3,6,7,8,9],had:8,handl:[0,1,7,8],hard:1,hasn:1,have:[0,1,2,3,4,6,7,8],head:[0,1,6,7,8],header:[0,1,4],hei:9,hellolzc:1,helper:[1,4,7],her:8,here:[0,7,8],hi:2,hit:0,hood:7,how:[0,7,8],html:[],http:[0,2,3,4,5,6,7,9],i:[0,1,2,7,8],id:[0,3],identifi:0,idiom:[6,7],ignor:8,illustr:[2,3,6,7],imit:7,immedi:[7,8],imp:[6,8],implement:[0,1,3,6],improv:1,includ:[0,1,4,8],incroot:[6,7,8],independ:7,index:[0,4,6],index_to_ti:1,indic:[0,1,3,7,8],individu:[3,6,7],inflect:8,info:[0,1,7],inform:[0,1,4,8],inherit:7,initi:[1,4],inner:[6,8],input:[0,1,7],insid:7,inspect:7,instal:6,instanc:[0,1,6,7],instanti:[0,1,7],instead:[0,1,4,8],institut:4,integ:[3,8],integr:1,intention:0,interact:8,interest:[0,1,2,6],intermitt:0,intern:8,interpret:[0,6],inton:8,introduc:[7,8],introduct:1,intuit:4,inv:0,investig:[1,3],ipsyn:[0,1,4,6],is_dir:[0,9],isn:0,issu:[0,1,4,6],item:[1,8],iter:[0,7,8],its:[1,7,8,9],itself:[0,1,7,8],jackson:[4,6],jacksonlle:4,juic:2,just:[0,1,2,7,8],keep:[1,7],keep_cas:[0,2],kei:1,kept:[0,2],keyword:[7,9],know:7,knowledg:7,known:[0,8],kwarg:1,l:[4,6],languag:[0,1,6,7,8],last:0,latest:1,latter:6,lead:1,least:1,leav:0,lee:[4,6],left:[0,8],len:[0,1,6,7],length:[0,4,5,6],less:[1,7],let:[2,3,6,7,8],letter:0,level:[0,1,8],librari:[1,4],like:[0,1,2,3,4,7,9],line:[3,6,8],linear:7,linguist:[4,6,8],list:[0,1,3,6,7,8],local:[0,1,6,9],locat:[0,3],longer:1,look:[2,3,7,8],lot:1,loud:[6,8],lowercas:[0,2],made:[1,6,7],mai:[0,1,6,7,8],main:[0,6,7],maintain:4,make:[0,1,2,6],makedir:[],mani:[0,1,2,6,7,8],manipul:[1,4,7],manual:7,map:[1,2],mark:6,markdown:1,marker:1,match:[0,1,7],md:4,me:4,mean:[0,1,4,5,6,8],measur:[1,4],media:4,memori:[0,1,8,9],metadata:[0,1,3,6],method:[0,1,2,3,5,6,7,8,9],might:[0,8],millisecond:[0,8],minim:[1,7],minor:0,minut:2,mit:4,mlu:[0,1,4,5,6],mlum:[0,1],mluw:[0,1],mod:[1,7],mode:[],model:[7,8],modifi:[0,7],modul:[1,6,7],month:[0,1,3,6],mor:[0,6,7,8],more:[0,1,2,3,4,6,7,8],morphem:0,morpholog:[0,6,8],most:[0,3,4,7],most_common:[2,6],mostli:1,mot:[0,1,3,7,8,9],mother:[1,3,8],move:1,much:7,multilingu:[1,3],multipl:[0,1,3,7,8,9],multipli:0,multiprocess:1,must:8,mutat:7,n:[0,6,7,8],n_file:[0,1,6,7],n_utter:1,na:[0,2,3,5,6,7,9],nak:0,name:[1,3,7,9],namespac:1,natur:[1,2,3,7],nc:4,necessari:[0,7],necessarili:7,need:[3,6,7,8],neg:0,neither:0,network:0,networkx:1,next:[3,8],ngram:[0,4],nlp:4,nomin:8,non:1,none:[0,6,7,8],nor:0,note:0,notic:7,now:[1,6,9],number:[0,1,4,6,7],number_of_fil:1,number_of_utter:1,obj:8,object:[0,1,2,3,6,7,8,9],obligatori:8,oct:3,off:[1,6,7],offer:4,offici:[6,7],often:8,okai:7,old:[3,6],onc:[0,8],one:[0,1,2,3,6,7,8],onli:[0,1,3,7,8,9],open:6,oper:[1,7],optim:1,option:[0,1,2,6,7,8],orb:1,order:[0,1,7,8],org:[0,2,3,5,6,7,9],organ:[0,7,9],origin:[0,1,6,7,8],orthograph:[0,8],other:[0,1,4,6,7,8,9],otherwis:0,ourselv:7,out:[1,2,4,6],outermost:8,output:[0,1,9],over:7,own:0,packag:[0,1,6,7],page:[4,7,8],pai:8,parallel:[0,1,6],paramet:[0,1,6],parent:8,pars:[0,1,6,7],part:[0,7,8],part_of_speech_tag:1,particip:[0,1,2,4,6,7],participant_cod:1,participant_nam:1,participant_rol:1,particular:7,pass:[0,3,7,8],path1:7,path2:7,path:[0,1,7],paus:[0,8],pe:7,per:[6,8],perform:1,perhap:7,permiss:[],pho:[1,7],phonbank:1,pid:3,pip:4,pipe:[6,8],pl:[7,8],place:7,plai:7,pleas:[0,4,6,7],plot:6,plural:8,po:[0,6,7,8],point:[0,1,7],pop:[0,1],pop_left:[0,1],posit:[0,8],possibl:[0,1,4],potenti:1,power:[4,7],practic:[1,7],preprocess:0,preserv:8,preview:7,previou:1,previous:[0,1],print:[0,6,7,8],priorit:1,privat:1,pro:[6,8],proce:6,process:[1,6],product:[0,4,6],profession:[],prototyp:6,provid:[0,7,8],pull:1,punct:[6,7,8],punctuat:8,purpos:[2,7,8],put:[6,7],py:1,pycantones:7,pylangacq:[0,1,2,3,5,6,7,8,9],pyproject:1,python:[1,3,6,7,8],qn:[6,8],quant:[6,8],quantif:8,quantifi:8,question:[2,4,8],quick:7,quickstart:4,quot:1,r:[1,4],rais:0,random:0,rather:1,ratio:[0,4,6],re:[0,1,6,7,9],read:[0,1,4,9],read_chat:[1,2,3,4,5,6,9],reader1:7,reader2:7,reader:[1,2,3,4,5,6,8,9],reader_one_fil:7,readi:[4,6],readili:[0,4,6,8],readm:[1,4],realli:1,reason:[0,1,7],recent:[4,8],record:[0,1,4,6,7,8],recurs:[0,7],refer:[4,6,7],reflect:7,regular:[0,1],rel:[0,6,8],relat:[0,1,6,8],remain:1,remot:[0,6,7],remov:[0,4,9],remove_cached_data:[0,1,7],renam:1,repeatedli:0,repetit:1,report:[4,6],repositori:[1,6],repres:[0,2,7,8],represent:1,reproduc:0,request:[0,1],requir:1,research:[3,7],respect:[6,7],respond:8,restrict:1,restructur:1,restructuredtext:1,result:[0,1,2,6,7],retain:0,retri:0,retriev:[0,3],revamp:1,rewrit:1,rewritten:1,ric:3,rich:[6,8],richard:3,right:[2,8],robust:[0,1],role:[1,3],root:[6,8],ross:4,rst:1,rtd:1,run:[6,7],s:[0,1,2,3,5,6,7,8,9],sa:4,safe:[6,7],safeti:1,sai:[1,8],same:[0,1,2,3,7,8],sampl:7,sarah:[0,7,9],satisfi:0,save:9,scene:7,scienc:4,script:[6,7],se:[1,3],search:[0,1],second:[7,8],section:[3,6,7,8],see:[0,1,3,4,6,7,8,9],seen:7,segment:[0,8],self:1,sens:[0,1],sent:[0,1],sentenc:0,separ:2,server:0,servic:[],session:[0,1,3,7,8],set:[0,1,3,7],setup:1,sever:[0,5,7,8],sex:3,should:[2,7],show:[0,2,3,7],shown:[6,8],sign:8,signal:[0,8],simpler:1,simpli:0,sinc:[0,1,3],singl:[0,1,7,8],singleread:1,six:3,skip:[],slice:7,slightli:2,small:1,smaller:7,snippet:[1,8],so:[0,1,6,7,8],social:4,socioeconom:1,some:[1,2,3,6,7,8,9],some_data:7,some_token:6,someth:1,sometim:8,somewher:9,sort:[0,7],sorted_by_ag:1,sourc:[0,4,6,7],spa:7,space:[0,8],spawn:1,speaker:1,specif:1,specifi:[0,1,2,7,8],sped:1,speech:[0,2,4,8],speed:[0,6,7],sphinx:1,src:[1,4],standard:[1,4,8],start:[0,1,3,7,8],statement:7,statu:1,step:0,still:7,store:6,str:0,string:[0,1,6,8,9],structur:[0,1,4,6,7,8],studi:0,style:1,stylist:1,subclass:[0,1,7],subdirectori:7,subj:[6,8],submodul:1,subset:7,substr:7,sue:3,suggest:1,suit:[1,8],suitabl:7,summari:0,support:[1,7,9],suppos:7,sweeti:9,syntax:[0,4,6],system:[0,7],t:[0,1,7,8],tabul:1,tabular:0,tag:[0,1,8],tagged_s:[0,1],tagged_word:[0,1],tail:[0,1,7],take:[7,8],talkbank:[0,2,3,4,5,6,7,9],tape:[0,3],target:[0,3,7,8],target_child:3,td:3,team:[],technic:4,techreport:4,tell:7,temporari:1,term:8,terminolog:[1,7],test:[1,4],test_data:[],text:[0,8],than:[0,1,3,9],thei:[0,2,6,8],them:8,theme:1,therefor:[1,7,8],thi:[0,1,2,6,7,8],thing:[6,7],think:[6,7],those:0,though:1,three:[0,3,7],through:[1,3,6,7,9],ti:7,tie:8,tier:[0,1,6,7],tier_mark:1,tier_sniff:1,time:[0,1,3,6,7],time_mark:[0,6,7,8],timeout:0,titl:4,to_chat:[0,1,9],to_conl:1,to_gra_ti:[],to_mor_ti:[],to_str:[0,1,9],to_tikz:1,togeth:0,tokai:7,token:[1,2,4,6,7],toml:1,top:[1,3],total:6,toyplai:3,tr:4,track:1,tracker:4,train:[],transcrib:0,transcript:[0,1,4],translat:8,travers:7,travi:1,treat:[0,1,7,8],treatment:7,trigram:2,trigrams_child_directed_speech:2,trigrams_child_speech:2,ttr:[0,1,4,6],tupl:[0,3,8],turn:[1,7],twitter:4,two:[7,8],txt:4,type:[0,3,4,6,7,8],typeerror:0,typic:[0,3,7],under:[0,1,6,7],underscor:1,understand:3,undesir:[0,7],undid:1,unicod:[0,1],union:0,univers:4,unnecessari:0,unord:1,unpars:[0,1,6,8],unreleas:4,unseg:6,unzip:[0,1,7],up:[0,1,6,7,8],upcom:7,updat:[0,1],upgrad:4,upon:7,upper:2,upstream:0,ur:3,url:[0,1,2,3,5,6,7],us:[0,1,2,3,4,6,7,8,9],usag:2,use_cach:[0,1,7],user:[6,7],usual:[1,7],utf8:3,utf:0,utter:[1,2,4,5,6,7],uuid:0,v:[6,8],valid:7,valu:[0,1],valueerror:0,vari:1,variou:[1,2,6],ve:[7,8],verbos:[0,7],veri:[2,8],version:[0,1,4],versu:2,via:[6,7,8],video:[0,8],visibl:1,w:1,wa:[1,8],wai:[0,4,7,9],walk:[1,3],want:[0,2,7,9],we:[1,2,6,7,8,9],well:[0,1,7,8],were:[3,6,7,8],what:[2,6,7,8],whatev:0,when:[0,1,6,7,8,9],where:[0,3,7,8],wherea:8,whether:2,which:[0,1,2,3,6,7,8],whitespac:1,who:8,whose:0,window:[1,6,7],within:[0,7],without:[0,7],won:7,word:[0,1,4,7],word_freq:6,word_frequ:[0,1,2,6],word_ngram:[0,1,2,6],words_by_fil:6,words_one_fil:6,work:[0,1,2,4,6,7,8],worth:1,would:[0,1,2,3,4,7,9],wouldn:1,wrap:[0,8],wrapper:7,write:[0,1,4],written:0,x:[0,1],xxx:0,yeah:6,year:[0,3,4,6],yet:[0,6],yield:[0,1],you:[0,1,2,3,4,6,7,8,9],your:[0,3,6,7,8,9],zero:3,zip:[0,1,2,3,5,6,9]},titles:["API Reference","Changelog","Word Frequencies and Ngrams","Accessing Headers","PyLangAcq: Language Acquisition Research in Python","Developmental Measures","Quickstart","Reading CHAT Data","Transcriptions and Annotations","Writing CHAT Data"],titleterms:{"0":1,"01":1,"02":1,"03":1,"04":1,"05":1,"06":1,"07":1,"09":1,"1":1,"10":1,"11":1,"12":1,"13":1,"14":1,"15":1,"16":1,"17":1,"2":1,"2015":1,"2016":1,"2017":1,"2020":1,"2021":1,"2022":1,"23":1,"25":1,"27":1,"3":1,"30":1,"4":1,"5":1,"6":1,"7":1,"8":1,"9":1,"function":0,In:7,access:3,acquisit:4,ad:[1,7],ag:3,an:7,annot:[6,8],api:0,behavior:7,chang:1,changelog:1,chat:[6,7,8,9],cite:4,consult:[],content:4,creat:7,custom:7,data:[6,7,9],date:3,deprec:1,development:[5,6],directori:7,download:4,empti:7,file:[7,8],filter:8,fix:1,format:8,frequenc:[2,6],from:7,gra:0,header:[3,6],helper:0,how:4,inform:[3,6],initi:7,instal:4,languag:[3,4],licens:4,link:4,local:7,mark:8,measur:[5,6],memori:7,ngram:[2,6],other:3,output:8,parallel:7,particip:[3,8],process:7,pylangacq:4,python:4,question:6,quickstart:6,read:[6,7],read_chat:[0,7],reader:[0,7],record:3,refer:0,remov:[1,7],research:4,secur:1,specif:7,string:7,support:4,tabl:4,tier:8,time:8,token:[0,8],transcript:[6,8],unreleas:1,utter:[0,8],word:[2,6,8],write:9,zip:7}}) \ No newline at end of file diff --git a/docs/source/build_docs.py b/docs/source/build_docs.py index 332b1c9..1684422 100644 --- a/docs/source/build_docs.py +++ b/docs/source/build_docs.py @@ -5,7 +5,7 @@ import logging import os -import m2r +import m2r2 _DOCS_SOURCE = os.path.dirname(os.path.abspath(__file__)) @@ -36,7 +36,7 @@ def create_changelog_rst(): changelog_rst = ( ".. _changelog:\n\n" + "Changelog\n=========\n" - + m2r.convert(changelog_md[changelog_md.index("## [Unreleased]") :]) + + m2r2.convert(changelog_md[changelog_md.index("## [Unreleased]") :]) ) with open(os.path.join(_DOCS_SOURCE, "changelog.rst"), "w", encoding="utf8") as f: f.write(changelog_rst) diff --git a/docs/source/changelog.rst b/docs/source/changelog.rst index 1ff15b1..8e34708 100644 --- a/docs/source/changelog.rst +++ b/docs/source/changelog.rst @@ -24,6 +24,28 @@ Fixed Security ^^^^^^^^ +[0.16.1] - 2022-03-17 +--------------------- + +Changed +^^^^^^^ + + +* Restructured the repository to use top-level ``src/`` and ``tests/`` directories. + +Removed +^^^^^^^ + + +* Removed ``setup.py``. + +Fixed +^^^^^ + + +* Moved ``BaseTestCHATReader`` back under the ``pylangacq`` package namespace + so that download packages can import ``BaseTestCHATReader`` for testing. + [0.16.0] - 2021-12-27 --------------------- diff --git a/docs/transcriptions.html b/docs/transcriptions.html index 0954297..a509fa4 100644 --- a/docs/transcriptions.html +++ b/docs/transcriptions.html @@ -5,11 +5,11 @@ - - Transcriptions and Annotations - PyLangAcq 0.16.0 documentation + + Transcriptions and Annotations - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Transcriptions and Annotations

+

Transcriptions and Annotations#

Conversational data formatted in CHAT provides transcriptions with rich annotations for both linguistic and extra-linguistic information. PyLangAcq is designed to extract data and annotations in CHAT and expose them in Python data structures for flexible modeling work. This page explains how PyLangAcq represents CHAT data and annotations.

-

CHAT Format

+

CHAT Format#

To see how the CHAT format translates to PyLangAcq, let’s look at the very first two utterances in Eve’s data in the American English Brown @@ -287,7 +291,7 @@

CHAT Format -

Words

+

Words#

The Reader method words() returns the transcriptions as segmented words. Calling words() with no arguments gives a @@ -297,7 +301,7 @@

Words

-

Output by Utterances or Files

+

Output by Utterances or Files#

To preserve the utterance-level structure, pass in by_utterances=True so that an inner list is created around the words from each utterance:

>>> reader.words(by_utterances=True)
@@ -320,7 +324,7 @@ 
Output by Utterances or Files
-
Filter by Participants

+
Filter by Participants#

 
Besides controlling the output for its structure,
 you can also specify which participants’ data to return.
 The optional arguments participants and exclude are available for this purpose.
@@ -342,7 +346,7 @@ 
Filter by Participants
-

Tokens

+

Tokens#

Beyond the transcriptions from words(), tokens() gives you the word-based annotations from the CHAT data.

@@ -388,7 +392,7 @@

Tokensrel (relation).

-

Utterances

+

Utterances#

The utterances() method gives you information beyond tokens():

>>> reader.utterances(participants="CHI")
@@ -415,7 +419,7 @@ 
Utterances
-
Time Marks

+
Time Marks#

 
Many of the more recent CHILDES datasets (especially starting from the 1990s)
 come with digitized audio and video data associated with the text-based CHAT data files.
 In these datasets, an utterance in the CHAT file has time marks to indicate
@@ -425,7 +429,7 @@ 
Time Marks(0, 1073), for ·0_1073· found at the end of the CHAT transcription line.
-

Tiers

+

Tiers#

You may sometimes need the original, unparsed transcription lines, because they contain information, e.g., annotations for pauses, that is dropped when Token objects are constructed @@ -465,11 +469,21 @@

Tiers

- -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+
diff --git a/docs/write.html b/docs/write.html index 04b903b..2768507 100644 --- a/docs/write.html +++ b/docs/write.html @@ -5,11 +5,11 @@ - - Writing CHAT Data - PyLangAcq 0.16.0 documentation + + Writing CHAT Data - PyLangAcq 0.16.1 documentation - - + + @@ -21,16 +21,18 @@ --color-code-foreground: black; } - body[data-theme="dark"] { - --color-code-background: #202020; + @media not print { + body[data-theme="dark"] { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; - } - @media (prefers-color-scheme: dark) { - body:not([data-theme="light"]) { - --color-code-background: #202020; + } + @media (prefers-color-scheme: dark) { + body:not([data-theme="light"]) { + --color-code-background: #202020; --color-code-foreground: #d0d0d0; + } } } @@ -42,17 +44,13 @@ Contents - - - - - + + Menu - @@ -61,14 +59,14 @@ Expand - Light mode - @@ -83,7 +81,7 @@ Dark mode - @@ -91,7 +89,7 @@ Auto light/dark mode - @@ -124,7 +122,7 @@
-
PyLangAcq 0.16.0 documentation
 +
PyLangAcq 0.16.1 documentation
@@ -147,7 +145,7 @@
- PyLangAcq 0.16.0 documentation + PyLangAcq 0.16.1 documentation @@ -169,6 +167,7 @@
+
@@ -176,8 +175,13 @@
-
-
+ + + + + Back to top + +
-

Writing CHAT Data

+

Writing CHAT Data#

To output CHAT data, a Reader object can either export data to local files or write its data to strings.

@@ -262,11 +266,21 @@ - -
- Copyright © 2015-2021, Jackson L. Lee | PyLangAcq 0.16.0 | Documentation last updated on December 28, 2021 | - Created using Sphinx and @pradyunsg's - Furo theme. +
+
+
+ Copyright © 2015-2022, Jackson L. Lee | PyLangAcq 0.16.1 | Documentation last updated on March 17, 2022 +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+
+ +
+