| Name | praatio JSON |
| Version |
6.2.0
JSON |
| download |
| home_page | https://github.com/timmahrt/praatIO |
| Summary | A library for working with praat, textgrids, time aligned audio transcripts, and audio files. |
| upload_time | 2023-12-10 09:24:26 |
| maintainer | |
| docs_url | None |
| author | Tim Mahrt |
| requires_python | >3.6.0 |
| license | LICENSE |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
# praatIO
[](https://app.travis-ci.com/github/timmahrt/praatIO) [](https://coveralls.io/github/timmahrt/praatIO?branch=main) [](http://opensource.org/licenses/MIT) [](https://pypi.org/project/praatio/)
*Questions? Comments? Feedback? [](https://gitter.im/praatio/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)*
-----
A library for working with praat, time aligned audio transcripts, and audio files *that comes with batteries included*.
Praat uses a file format called textgrids, which are time aligned speech transcripts.
This library isn't just a data struct for reading and writing textgrids--many utilities are
provided to make it easy to work with with transcripts and associated audio files.
This library also provides some other tools for use with praat.
Praat is an open source software program for doing phonetic analysis and annotation
of speech. [Praat can be downloaded here](<http://www.fon.hum.uva.nl/praat/>)
# Table of contents
1. [Documentation](#documentation)
2. [Tutorials](#tutorials)
3. [Version history](#version-history)
4. [Requirements](#requirements)
5. [Installation](#installation)
6. [Upgrading major versions](#upgrading)
7. [Usage](#usage)
8. [Common use cases](#common-use-cases)
9. [Output types](#output-types)
10. [Tests](#tests)
11. [Citing praatIO](#citing-praatio)
12. [Acknowledgements](#acknowledgements)
## Documentation
Automatically generated pdocs can be found here:
http://timmahrt.github.io/praatIO/
## Tutorials
There are tutorials available for learning how to use PraatIO. These
are in the form of IPython Notebooks which can be found in the /tutorials/
folder distributed with PraatIO.
You can view them online using the external website Jupyter:
[Tutorial 1: An introduction and tutorial](<https://nbviewer.jupyter.org/github/timmahrt/praatIO/blob/main/tutorials/tutorial1_intro_to_praatio.ipynb>)
## Version History
*Praatio uses semantic versioning (Major.Minor.Patch)*
Please view [CHANGELOG.md](https://github.com/timmahrt/praatIO/blob/main/CHANGELOG.md) for version history.
## Requirements
Python module `https://pypi.org/project/typing-extensions/`. It should be installed automatically with praatio but you can install it manually if you have any problems.
``Python 3.7.*`` or above (CI tested with python `3.7` through `3.12`).
If you are using ``Python 2.x`` or ``Python < 3.7``, you can use `PraatIO 4.x`.
## Installation
PraatIO is on pypi and can be installed or upgraded from the command-line shell with pip like so
python -m pip install praatio --upgrade
Otherwise, to manually install, after downloading the source from github, from a command-line shell, navigate to the directory containing setup.py and type
python setup.py install
If python is not in your path, you'll need to enter the full path e.g.
C:\Python37\python.exe setup.py install
## Upgrading
Please view [UPGRADING.md](https://github.com/timmahrt/praatIO/blob/main/UPGRADING.md) for detailed information about how to upgrade from earlier versions.
## Usage
99% of the time you're going to want to run
```python
from praatio import textgrid
tg = textgrid.openTextgrid(r"C:\Users\tim\Documents\transcript.TextGrid", False)
```
Or if you want to work with KlattGrid files
```python
from praatio import klattgrid
kg = klattgrid.openKlattGrid(r"C:\Users\tim\Documents\transcript.KlattGrid")
```
See /test for example usages
## Common Use Cases
What can you do with this library?
- query a textgrid to get information about the tiers or intervals contained within
```python
tg = textgrid.openTextgrid("path_to_textgrid", False)
entries = tg.tierDict["speaker_1_tier"].entries # Get all intervals
entries = tg.tierDict["phone_tier"].find("a") # Get the indicies of all occurrences of 'a'
```
- create or augment textgrids using data from other sources
- found that you clipped your audio file five seconds early and have added it back to your wavefile but now your textgrid is misaligned? Add five seconds to every interval in the textgrid
```python
tg = textgrid.openTextgrid("path_to_textgrid", False)
moddedTG = tg.editTimestamps(5)
moddedTG.save('output_path_to_textgrid', 'long_textgrid', True)
```
- utilize the klattgrid interface to raise all speech formants by 20%
```python
kg = klattgrid.openKlattGrid("path_to_klattgrid")
incrTwenty = lambda x: x * 1.2
kg.tierDict["oral_formants"].modifySubtiers("formants",incrTwenty)
kg.save(join(outputPath, "bobby_twenty_percent_less.KlattGrid"))
```
- replace labeled segments in a recording with silence or delete them
- see /examples/deleteVowels.py
- use set operations (union, intersection, difference) on textgrid tiers
- see /examples/textgrid_set_operations.py
- see /praatio/praatio_scripts.py for various ready-to-use functions such as
- `splitAudioOnTier()`: split an audio file into chunks specified by intervals in one tier
- `spellCheckEntries()`: spellcheck a textgrid tier
- `tgBoundariesToZeroCrossings()`: adjust all boundaries and points to fall at the nearest zero crossing in the corresponding audio file
- `alignBoundariesAcrossTiers()`: for handmade textgrids, sometimes entries may look as if they are aligned at the same time but actually are off by a small amount, this will correct them
## Output types
PraatIO supports 4 textgrid output file types: short textgrid, long textgrid, json, and textgrid-like json.
Short textgrids and long textgrids are both formats that are natively supported by praat.
Short textgrids are meant to be more concise while long textgrids are meant to be more human-readable.
For more information on these file formats, please see [praat's official documentation](https://www.fon.hum.uva.nl/praat/manual/TextGrid_file_formats.html)
JSON and textgrid-like JSON are more developer-friendly formats, but they are not supported by praat.
The default JSON format is more minimal while the textgrid-like JSON is formatted with information similar to a textgrid file.
The default JSON format does not support one use-case: a textgrid has a specified minimum and maximum timestamp.
The textgrid's tiers also have a specified minimum and maximum timestamp.
Under most circumstances, they are the same, but the user can specify them to be different and praat will respect this.
If you have such textgrids, you should use the textgrid-like JSON.
Here is the schema for the JSON output file:
```
{
"start": 0.0,
"end": 1.8,
"tiers": {
"phone": {
"type": "IntervalTier",
"entries": [[0.0, 0.3, ""], [0.3, 0.38, "m"]]
},
"pitch": {
"type": "TextTier",
"entries": [[0.32, "120"], [0.37, "85"]]
}
}
}
```
Here is the schema for the Textgrid-like JSON output file.
Notably, `tiers` is a list of hashes, rather than a hash of hashes.
Also, each tier specifies it's name, and a min and max time.
```
{
"xmin": 0.0,
"xmax": 1.8,
"tiers": [
{
"class": "IntervalTier",
"name": "phone",
"xmin": 0.0,
"xmax": 1.8,
"entries": [[0.0, 0.3, ""], [0.3, 0.38, "m"]]
},
{
"class": "TextTier",
"name": "pitch",
"xmin": 0.0,
"xmax": 1.8,
"entries": [[0.32, "120"], [0.37, "85"]]
}
]
}
```
## Citing praatIO
PraatIO is general purpose coding and doesn't need to be cited
but if you would like to, it can be cited like so:
Tim Mahrt. PraatIO. https://github.com/timmahrt/praatIO, 2016.
## Acknowledgements
Development of PraatIO was possible thanks to NSF grant **BCS 12-51343** to
Jennifer Cole, José I. Hualde, and Caroline Smith and to the A\*MIDEX project
(n° **ANR-11-IDEX-0001-02**) to James Sneed German funded by the
Investissements d'Avenir French Government program,
managed by the French National Research Agency (ANR).
Raw data
{
"_id": null,
"home_page": "https://github.com/timmahrt/praatIO",
"name": "praatio",
"maintainer": "",
"docs_url": null,
"requires_python": ">3.6.0",
"maintainer_email": "",
"keywords": "",
"author": "Tim Mahrt",
"author_email": "timmahrt@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3d/44/99cf2f7e4333cc10af2efd4a27658a7a18e397f5a1d181762dad02a361c4/praatio-6.2.0.tar.gz",
"platform": null,
"description": "\n# praatIO\n\n[](https://app.travis-ci.com/github/timmahrt/praatIO) [](https://coveralls.io/github/timmahrt/praatIO?branch=main) [](http://opensource.org/licenses/MIT) [](https://pypi.org/project/praatio/)\n\n*Questions? Comments? Feedback? [](https://gitter.im/praatio/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)*\n\n-----\n\nA library for working with praat, time aligned audio transcripts, and audio files *that comes with batteries included*.\n\nPraat uses a file format called textgrids, which are time aligned speech transcripts.\nThis library isn't just a data struct for reading and writing textgrids--many utilities are\nprovided to make it easy to work with with transcripts and associated audio files.\nThis library also provides some other tools for use with praat.\n\nPraat is an open source software program for doing phonetic analysis and annotation \nof speech. [Praat can be downloaded here](<http://www.fon.hum.uva.nl/praat/>)\n\n# Table of contents\n1. [Documentation](#documentation)\n2. [Tutorials](#tutorials)\n3. [Version history](#version-history)\n4. [Requirements](#requirements)\n5. [Installation](#installation)\n6. [Upgrading major versions](#upgrading)\n7. [Usage](#usage)\n8. [Common use cases](#common-use-cases)\n9. [Output types](#output-types)\n10. [Tests](#tests)\n11. [Citing praatIO](#citing-praatio)\n12. [Acknowledgements](#acknowledgements)\n\n## Documentation\n\nAutomatically generated pdocs can be found here:\n\nhttp://timmahrt.github.io/praatIO/\n\n\n## Tutorials\n\nThere are tutorials available for learning how to use PraatIO. These\nare in the form of IPython Notebooks which can be found in the /tutorials/\nfolder distributed with PraatIO.\n\nYou can view them online using the external website Jupyter:\n\n[Tutorial 1: An introduction and tutorial](<https://nbviewer.jupyter.org/github/timmahrt/praatIO/blob/main/tutorials/tutorial1_intro_to_praatio.ipynb>)\n \n \n## Version History\n\n*Praatio uses semantic versioning (Major.Minor.Patch)*\n\nPlease view [CHANGELOG.md](https://github.com/timmahrt/praatIO/blob/main/CHANGELOG.md) for version history.\n\n\n## Requirements\n\nPython module `https://pypi.org/project/typing-extensions/`. It should be installed automatically with praatio but you can install it manually if you have any problems.\n\n``Python 3.7.*`` or above (CI tested with python `3.7` through `3.12`).\n\nIf you are using ``Python 2.x`` or ``Python < 3.7``, you can use `PraatIO 4.x`.\n\n## Installation\n\nPraatIO is on pypi and can be installed or upgraded from the command-line shell with pip like so\n\n python -m pip install praatio --upgrade\n\nOtherwise, to manually install, after downloading the source from github, from a command-line shell, navigate to the directory containing setup.py and type\n\n python setup.py install\n\nIf python is not in your path, you'll need to enter the full path e.g.\n\n C:\\Python37\\python.exe setup.py install\n\n## Upgrading\n\nPlease view [UPGRADING.md](https://github.com/timmahrt/praatIO/blob/main/UPGRADING.md) for detailed information about how to upgrade from earlier versions.\n\n## Usage\n\n99% of the time you're going to want to run\n\n```python\nfrom praatio import textgrid\ntg = textgrid.openTextgrid(r\"C:\\Users\\tim\\Documents\\transcript.TextGrid\", False)\n```\n\nOr if you want to work with KlattGrid files\n\n```python\nfrom praatio import klattgrid\nkg = klattgrid.openKlattGrid(r\"C:\\Users\\tim\\Documents\\transcript.KlattGrid\")\n```\n\nSee /test for example usages\n\n\n## Common Use Cases\n\nWhat can you do with this library?\n\n- query a textgrid to get information about the tiers or intervals contained within\n ```python\n tg = textgrid.openTextgrid(\"path_to_textgrid\", False)\n entries = tg.tierDict[\"speaker_1_tier\"].entries # Get all intervals\n entries = tg.tierDict[\"phone_tier\"].find(\"a\") # Get the indicies of all occurrences of 'a'\n ```\n\n- create or augment textgrids using data from other sources\n\n- found that you clipped your audio file five seconds early and have added it back to your wavefile but now your textgrid is misaligned? Add five seconds to every interval in the textgrid\n ```python\n tg = textgrid.openTextgrid(\"path_to_textgrid\", False)\n moddedTG = tg.editTimestamps(5)\n moddedTG.save('output_path_to_textgrid', 'long_textgrid', True)\n ```\n\n- utilize the klattgrid interface to raise all speech formants by 20%\n ```python\n kg = klattgrid.openKlattGrid(\"path_to_klattgrid\")\n incrTwenty = lambda x: x * 1.2\n kg.tierDict[\"oral_formants\"].modifySubtiers(\"formants\",incrTwenty)\n kg.save(join(outputPath, \"bobby_twenty_percent_less.KlattGrid\"))\n ```\n\n- replace labeled segments in a recording with silence or delete them\n - see /examples/deleteVowels.py\n\n- use set operations (union, intersection, difference) on textgrid tiers\n - see /examples/textgrid_set_operations.py\n\n- see /praatio/praatio_scripts.py for various ready-to-use functions such as\n - `splitAudioOnTier()`: split an audio file into chunks specified by intervals in one tier\n - `spellCheckEntries()`: spellcheck a textgrid tier\n - `tgBoundariesToZeroCrossings()`: adjust all boundaries and points to fall at the nearest zero crossing in the corresponding audio file\n - `alignBoundariesAcrossTiers()`: for handmade textgrids, sometimes entries may look as if they are aligned at the same time but actually are off by a small amount, this will correct them\n\n\n## Output types\n\nPraatIO supports 4 textgrid output file types: short textgrid, long textgrid, json, and textgrid-like json.\n\nShort textgrids and long textgrids are both formats that are natively supported by praat.\nShort textgrids are meant to be more concise while long textgrids are meant to be more human-readable.\nFor more information on these file formats, please see [praat's official documentation](https://www.fon.hum.uva.nl/praat/manual/TextGrid_file_formats.html)\n\nJSON and textgrid-like JSON are more developer-friendly formats, but they are not supported by praat.\nThe default JSON format is more minimal while the textgrid-like JSON is formatted with information similar to a textgrid file.\n\nThe default JSON format does not support one use-case: a textgrid has a specified minimum and maximum timestamp.\nThe textgrid's tiers also have a specified minimum and maximum timestamp.\nUnder most circumstances, they are the same, but the user can specify them to be different and praat will respect this.\nIf you have such textgrids, you should use the textgrid-like JSON.\n\nHere is the schema for the JSON output file:\n```\n{\n \"start\": 0.0,\n \"end\": 1.8,\n \"tiers\": {\n \"phone\": {\n \"type\": \"IntervalTier\",\n \"entries\": [[0.0, 0.3, \"\"], [0.3, 0.38, \"m\"]]\n },\n \"pitch\": {\n \"type\": \"TextTier\",\n \"entries\": [[0.32, \"120\"], [0.37, \"85\"]]\n }\n }\n}\n```\n\nHere is the schema for the Textgrid-like JSON output file.\nNotably, `tiers` is a list of hashes, rather than a hash of hashes.\nAlso, each tier specifies it's name, and a min and max time.\n```\n{\n \"xmin\": 0.0,\n \"xmax\": 1.8,\n \"tiers\": [\n {\n \"class\": \"IntervalTier\",\n \"name\": \"phone\",\n \"xmin\": 0.0,\n \"xmax\": 1.8,\n \"entries\": [[0.0, 0.3, \"\"], [0.3, 0.38, \"m\"]]\n },\n {\n \"class\": \"TextTier\",\n \"name\": \"pitch\",\n \"xmin\": 0.0,\n \"xmax\": 1.8,\n \"entries\": [[0.32, \"120\"], [0.37, \"85\"]]\n }\n ]\n}\n```\n\n## Citing praatIO\n\nPraatIO is general purpose coding and doesn't need to be cited\nbut if you would like to, it can be cited like so:\n\nTim Mahrt. PraatIO. https://github.com/timmahrt/praatIO, 2016.\n\n\n## Acknowledgements\n\nDevelopment of PraatIO was possible thanks to NSF grant **BCS 12-51343** to\nJennifer Cole, Jos\u00e9 I. Hualde, and Caroline Smith and to the A\\*MIDEX project\n(n\u00b0 **ANR-11-IDEX-0001-02**) to James Sneed German funded by the\nInvestissements d'Avenir French Government program,\nmanaged by the French National Research Agency (ANR).\n",
"bugtrack_url": null,
"license": "LICENSE",
"summary": "A library for working with praat, textgrids, time aligned audio transcripts, and audio files.",
"version": "6.2.0",
"project_urls": {
"Homepage": "https://github.com/timmahrt/praatIO"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c48eeb83f93f0e46c5bfd20a3040eef7ccece8ac0703b06a500fb17a57627a2e",
"md5": "42c1c1d7b4ccf77ed177e7f7dd1e7549",
"sha256": "6541018791a3f0b087a8168d1746a165937c3fff1f94c7a6883b3f470e0cf405"
},
"downloads": -1,
"filename": "praatio-6.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42c1c1d7b4ccf77ed177e7f7dd1e7549",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">3.6.0",
"size": 80029,
"upload_time": "2023-12-10T09:24:24",
"upload_time_iso_8601": "2023-12-10T09:24:24.375794Z",
"url": "https://files.pythonhosted.org/packages/c4/8e/eb83f93f0e46c5bfd20a3040eef7ccece8ac0703b06a500fb17a57627a2e/praatio-6.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3d4499cf2f7e4333cc10af2efd4a27658a7a18e397f5a1d181762dad02a361c4",
"md5": "af8d078dc571a6dc7f5b526f18aa7e3c",
"sha256": "7d2a7f8135a3e0691743ada0af84308b64e637f07038cea77d814b8aa2fa2e40"
},
"downloads": -1,
"filename": "praatio-6.2.0.tar.gz",
"has_sig": false,
"md5_digest": "af8d078dc571a6dc7f5b526f18aa7e3c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">3.6.0",
"size": 85100,
"upload_time": "2023-12-10T09:24:26",
"upload_time_iso_8601": "2023-12-10T09:24:26.833560Z",
"url": "https://files.pythonhosted.org/packages/3d/44/99cf2f7e4333cc10af2efd4a27658a7a18e397f5a1d181762dad02a361c4/praatio-6.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-10 09:24:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "timmahrt",
"github_project": "praatIO",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "praatio"
}
