o xiY @sdZddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZ ddedededdeddef ddZdededdefddZdS)a Functions for reading/writing/manipulating textgrid files. This file links the main data structures for representing Textgrid data: Textgrid, IntervalTier, and PointTier A Textgrid is a container for multiple annotation tiers. Tiers can contain either interval data (IntervalTier) or point data (PointTier). Tiers in a Textgrid are ordered and must contain a unique name. openTextgrid() can be used to open a textgrid file. Textgrid.save() can be used to save a Textgrid object to a file. Historically, these three classes lived in this file. To make maintance easier, they were split off. You can still access them from this file as before, but please check out the respective files for more documentation on each class: IntervalTier in data_classes/interval_tier.py PointTier in data_classes/point_tier.py Textgrid in data_classes/textgrid.py see the **examples/** directory for examples using textgrid.py N)UnionType)Literal) INTERVAL_TIER) IntervalTier) PointTier)Textgrid) textgrid_io)utils) constants)errorswarningerror fnFullPathincludeEmptyIntervals reportingMode)silencer rduplicateNamesMode)rrenamereturnc CsNtd|tjtd|tjztj|ddd }|}Wdn1s(wYWn%tyStj|ddd }|}Wdn1sLwYYnwt ||}g}|dD]A}|d } | |vr|tjj kryt d | d |tjjkr| } d } | |vr| d | } | d7} | |vs| } | |d <|| q`t||S)aOpens a textgrid file (.TextGrid and .json are both fine) https://www.fon.hum.uva.nl/praat/manual/TextGrid_file_formats.html Args: fnFullPath: the path to the textgrid to open includeEmptyIntervals: if False, points and intervals with an empty label '' are not included in the returned Textgrid Returns: A Textgrid Raises: DuplicateTierName: The textgrid contains multiple tiers with the same name rrrzutf-16)encodingNzutf-8tiersnamez1Your textgrid contains tiers with the same name 'z'. This is not allowed. It is recommended that you rename them. If you set openTextgrid(..., duplicateNamesMode='rename'), praatio will automatically append numbers to the end of tiers to ensure they are unique._)r validateOptionr ErrorReportingModeDuplicateNamesioopenread UnicodeErrorr parseTextgridStrERRORr DuplicateTierNameRENAMEappend_dictionaryToTg) rrrrfddatatgAsDict tierNamestierrnewNameir1S/home/ubuntu/maya3_transcribe/venv/lib/python3.10/site-packages/praatio/textgrid.py openTextgrid.sF          r3r,cCs~td|tjt}|d|_|d|_|dD]#}|dtkr$t}nt }||d|d|d|d}|j ||dq|S) z@Converts a dictionary representation of a textgrid to a Textgridrxminxmaxrclassrentries)r) r rr rr minTimestamp maxTimestamprrraddTier)r,rtg tierAsDictklassr.r1r1r2r)is     r))r r)__doc__r typingrrtyping_extensionsrpraatio.utilities.constantsr"praatio.data_classes.interval_tierrpraatio.data_classes.point_tierrpraatio.data_classes.textgridrpraatio.utilitiesr r r r strboolr3dictr)r1r1r1r2s@          ;