,jzSrSSKrSSKrSSKJr SSKJrJrJrJ r J r J r J r J r JrJrJrJr SSKrSSKJr SSKJrJrJr SSKJrJr SS KJr SS KJ r SS K!J"r"J#r# SS K$J%r%J&r&J'r'J(r(J)r)J*r* \(aSSK+r,"S S5r-g)a ########## Annotation ########## .. plot:: pyplots/annotation.py :class:`pyannote.core.Annotation` instances are ordered sets of non-empty tracks: - ordered, because segments are sorted by start time (and end time in case of tie) - set, because one cannot add twice the same track - non-empty, because one cannot add empty track A track is a (support, name) pair where `support` is a Segment instance, and `name` is an additional identifier so that it is possible to add multiple tracks with the same support. To define the annotation depicted above: .. code-block:: ipython In [1]: from pyannote.core import Annotation, Segment In [6]: annotation = Annotation() ...: annotation[Segment(1, 5)] = 'Carol' ...: annotation[Segment(6, 8)] = 'Bob' ...: annotation[Segment(12, 18)] = 'Carol' ...: annotation[Segment(7, 20)] = 'Alice' ...: which is actually a shortcut for .. code-block:: ipython In [6]: annotation = Annotation() ...: annotation[Segment(1, 5), '_'] = 'Carol' ...: annotation[Segment(6, 8), '_'] = 'Bob' ...: annotation[Segment(12, 18), '_'] = 'Carol' ...: annotation[Segment(7, 20), '_'] = 'Alice' ...: where all tracks share the same (default) name ``'_'``. In case two tracks share the same support, use a different track name: .. code-block:: ipython In [6]: annotation = Annotation(uri='my_video_file', modality='speaker') ...: annotation[Segment(1, 5), 1] = 'Carol' # track name = 1 ...: annotation[Segment(1, 5), 2] = 'Bob' # track name = 2 ...: annotation[Segment(12, 18)] = 'Carol' ...: The track name does not have to be unique over the whole set of tracks. .. note:: The optional *uri* and *modality* keywords argument can be used to remember which document and modality (e.g. speaker or face) it describes. Several convenient methods are available. Here are a few examples: .. code-block:: ipython In [9]: annotation.labels() # sorted list of labels Out[9]: ['Bob', 'Carol'] In [10]: annotation.chart() # label duration chart Out[10]: [('Carol', 10), ('Bob', 4)] In [11]: list(annotation.itertracks()) Out[11]: [(, 1), (, 2), (, u'_')] In [12]: annotation.label_timeline('Carol') Out[12]: , ])> See :class:`pyannote.core.Annotation` for the complete reference. N) defaultdict) HashableOptionalDictUnionIterableListSetTextIOTupleIteratorText TYPE_CHECKING) SortedDict)PYANNOTE_SEGMENTPYANNOTE_TRACKPYANNOTE_LABEL)Segment SlidingWindow)Timeline)SlidingWindowFeature)string_generator int_generator)LabelKeySupportLabelGenerator TrackNameCropModec 6\rSrSrSr\SXSSS\\S\\SS4S jj5rSXS\\S\\4S jjr \ S 5r \ RS\4S j5r S r SrSrSrS\\\\44SjrSrSYS\S\\\\\4\\\\444SjjrSrSZS\S\4SjjrS[SjrS[SjrS\\\44Sjr S\\!4Sjr"S\!4Sjr#S\$4S jr%S\\!4S!jr&S\!4S"jr'S\$4S#jr(S\S$\)S%\*SS4S&jjr+S\S'\)S%\*SS4S(jjr,S]S)\\-\SS*4S+jjr.S,\S\/\4S-jr0S,\S.\S\4S/jr1S^S0jr2SXS,\S1\\S2\\S\4S3jjr3S4r4S5\54S6jr6S5\5S\4S7jr7S5\5S8\4S9jr8S^S:jr9S\:\4S;jr;SZS,\S<\S\\/\\:\44S=jjr\SS4S?jjr=SYS@SS\SS4SAjjr>SZS8\S\S\4SBjjr?S8\S\4SCjr@S8\S\A4SDjrBSYSE\S\:\\\A44SFjjrCS]S$\\)S\\4SGjjrDS_SH\ESS4SIjjrFS`SJ\\GSH\ES\SS4SKjjrHS_SH\ESS4SLjjrISaSM\ASS4SNjjrJSSS\\\\\4\\\444SOjrKSSS\LR4SPjrNSbS$\\SQ\\A\O4S)\\:\PSR\\A4SSjjrQ\SXST\\\\\4S\\S\\SS4SUjj5rRSVrSSWrTg)c AnnotationzAnnotation Parameters ---------- uri : string, optional name of annotated resource (e.g. audio or video file) modality : string, optional name of annotated modality Returns ------- annotation : Annotation New annotation Ndfz pd.DataFrameurimodalityreturncpU[[[/n[R UR SS9X#5$)NF)index)rrrr" from_records itertuples)clsr$r%r&s ڦC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pyannote/core/annotation.pyfrom_dfAnnotation.from_dfs4!>>B C&&r}}5}'A3QQcrXlX l[5Ul0Ul0UlSUlSUlg)NT)_urir&r_tracks_labels_labelNeedsUpdate _timeline_timelineNeedsUpdate)selfr%r&s r-__init__Annotation.__init__s:#& '/ ?Il /1 46$(*.!r0cUR$N)r2r8s r-r%Annotation.uris yyr0cUR5HnURUSS9nXlM URSS9nXlXlg)NFcopy)labelslabel_timeliner% get_timeliner2)r8r%labeltimelines r-r%r>sM[[]E**5u*=HL#$$%$0  r0c[SURR555nUVs0sHo"/_M nnURSS9H upEnX!;dM X2R U5 M" UHxnX2(a4[ X2UR S9URU'SURU'M@URRUS5 URRUS5 Mz gs snf)Nc3<# UHupU(dMUv M g7fr<).0rEupdates r- +Annotation._updateLabels..s 'EmeEE'Es  T yield_labelsegmentsr%F) setr5items itertracksappendrr%r4pop)r8rKrE _segmentssegmenttracks r- _updateLabelsAnnotation._updateLabelss '+'='='C'C'E   -33F5BYF 3%)___%F !GE ''0&G E&. 8Hdhh&W U#05&&u-   -&&**5$7  4s C/c,[UR5$)zPNumber of segments >>> len(annotation) # annotation contains three segments 3 lenr3r=s r-__len__Annotation.__len__s 4<<  r0c"UR5$r<)__bool__r=s r- __nonzero__Annotation.__nonzero__s}}r0c2[UR5S:$)zfEmptiness >>> if annotation: ... # annotation is not empty ... else: ... # annotation is empty rr]r=s r-rbAnnotation.__bool__s4<< 1$$r0c#H# URSS9H upnX4v M g7f)zIterate over (segment, label) pairs in chronological order Examples -------- >>> for segment, label in annotation: ... # do something with the segment and its label TrNN)rT)r8rX_rEs r-__iter__Annotation.__iter__s*"&T!B G. "Cs "c,[UR5$)zIterate over segments (in chronological order) >>> for segment in annotation.itersegments(): ... # do something with the segment See also -------- :class:`pyannote.core.Segment` describes how segments are sorted. )iterr3r=s r- itersegmentsAnnotation.itersegmentssDLL!!r0rOc## URR5H;up#[UR5SS9HupEU(aX$U4v MX$4v M M= g7f)aIterate over tracks (in chronological order) Parameters ---------- yield_label : bool, optional When True, yield (segment, track, label) tuples, such that annotation[segment, track] == label. Defaults to yielding (segment, track) tuple. Examples -------- >>> for segment, track in annotation.itertracks(): ... # do something with the track >>> for segment, track, label in annotation.itertracks(yield_label=True): ... # do something with the track and its label c:[US5[US54$)Nrr)str)tls r-'Annotation.itertracks..*sBqE C1J/Gr0keyN)r3rSsorted)r8rOrXtracksrYlbls r-rTAnnotation.itertrackssU, $||113OG$ $G !#--!.(  4sAAcX[URURS9UlSUlg)NrPF)rr3r%r6r7r=s r-_updateTimelineAnnotation._updateTimeline1s !4<>&&( (~~r0otherc[R"URSS9URSS95n[SU55$)zzEquality >>> annotation == other Two annotations are equal if and only if their tracks and associated labels are equal. TrNc3.# UH upX:Hv M g7fr<rIrJt1t2s r-rL$Annotation.__eq__..[7,28,) itertools zip_longestrTallr8r pairOfTrackss r-__eq__Annotation.__eq__PsE!,, OOO -u/?/?D/?/Q 7,777r0c[R"URSS9URSS95n[SU55$) InequalityTrNc3.# UH upX:gv M g7fr<rIrs r-rL$Annotation.__ne__..crr)rrrTanyrs r-__ne__Annotation.__ne__]sC ,, OOO -u/?/?D/?/Q 7,777r0includedc$XRSS9;$)a+Inclusion Check whether every segment of `included` does exist in annotation. Parameters ---------- included : Segment or Timeline Segment or timeline being checked for inclusion Returns ------- contains : bool True if every segment in `included` exists in timeline, False otherwise Fr@)rD)r8rs r- __contains__Annotation.__contains__es",,%,888r0c #z# UR(a UROSn[U[5(aSU;aSUS3n[U5eUR SS9HYup4n[U[5(aSU;aSUS3n[U5eSUS UR S SUR S S US 3 v M[ g 7f)zGenerate lines for an RTTM file for this annotation Returns ------- iterator: Iterator[str] An iterator over RTTM text lines z zSSpace-separated RTTM file format does not allow file URIs containing spaces (got: "").TrNzPSpace-separated RTTM file format does not allow labels containing spaces (got: "zSPEAKER z 1 .3fz z N)r% isinstancer ValueErrorrTstartduration)r8r%msgrXrhrEs r- _iter_rttmAnnotation._iter_rttmxs((dhh c4 SCZ,,/55 S/ !!%T!B G%&&3%<005wc;!o%3%s7=="5Qw7G7G6LM"G<1 "CsB9B;cjSRUR5Vs/sHoPM sn5$s snf)zdSerialize annotation as a string using RTTM format Returns ------- serialized: str RTTM string )joinrr8lines r-to_rttmAnnotation.to_rttms.ww):;):):;<<; 0filecTUR5HnURU5 M g)zDump annotation to file using RTTM format Parameters ---------- file : file object Usage ----- >>> with open('file.rttm', 'w') as file: ... annotation.write_rttm(file) N)rwriter8rrs r- write_rttmAnnotation.write_rttms!OO%D JJt &r0c## URSS9Hbupn[U[5(aSU;aSUS3n[U5eURSSURUR -SSUS3v Md g7f) zGenerate lines for a LAB file for this annotation Returns ------- iterator: Iterator[str] An iterator over LAB text lines TrNrzOSpace-separated LAB file format does not allow labels containing spaces (got: "rr N)rTrrrrr)r8rXrhrErs r- _iter_labAnnotation._iter_labs"&T!B G%&&3%<005wc;!o%]]3'q9I9I)I#(NaPUwVXY Y"CsA7A9cjSRUR5Vs/sHoPM sn5$s snf)zbSerialize annotation as a string using LAB format Returns ------- serialized: str LAB string r)rrrs r-to_labAnnotation.to_labs.ww)9:)9)9:;;:rcTUR5HnURU5 M g)zDump annotation to file using LAB format Parameters ---------- file : file object Usage ----- >>> with open('file.lab', 'w') as file: ... annotation.write_lab(file) N)rrrs r- write_labAnnotation.write_labs!NN$D JJt %r0supportmodecJ[U[5(a$[U/URS9nUR XS9$[U[5(Ga@UR 5nUR URURS9nUS:Xa0n[/5nURSS9RU5H@upg[URU5nXU'URUR55 MB [U5Ul UV s0sHoS_M sn UlUV s0sHoS_M sn UlSUlSUlU$US :Xa0n[/5nURSS9RU5HGupjXj;aM [URU5nXU'URUR55 MI [U5Ul UV s0sHoS_M sn UlUV s0sHoS_M sn UlSUlSUlU$US :XagURSS9RU5HCupjXj-n URUR)5HupUR+XS 9n XX4'M ME U$[-S U-5egs sn fs sn fs sn fs sn f) aCrop annotation to new support Parameters ---------- support : Segment or Timeline If `support` is a `Timeline`, its support is used. mode : {'strict', 'loose', 'intersection'}, optional Controls how segments that are not fully included in `support` are handled. 'strict' mode only keeps fully included segments. 'loose' mode keeps any intersecting segment. 'intersection' mode keeps any intersecting segment but replace them by their actual intersection. Returns ------- cropped : Annotation Cropped annotation Note ---- In 'intersection' mode, the best is done to keep the track names unchanged. However, in some cases where two original segments are cropped into the same resulting segments, conflicting track names are modified to make sure no track is lost. rPrr%r&looseFr@TNstrict intersection) candidatezunsupported mode: '%s')rrrr%cropr __class__r&rRrDco_iterdictr3rKvaluesrr5r4r7r6rS new_trackNotImplementedError) r8rrcroppedr3r4rXrhrxrE other_segmentrrYs r-rAnnotation.crops: gw ' ' txx@G99W90 0  * *oo'GnnDMMnJGwb'"&"3"3"3"?"G"G"PJG!$,,w"78F'-G$NN6==?3#Q #-W"5FM,NgUD[g,N)>2 ","4"4Z"@ HRhrF|tF|+ OOBG $ #A ""$$r0rXch[URRU05R55$)zQuery tracks by segment Parameters ---------- segment : Segment Query Returns ------- tracks : set Set of tracks Note ---- This will return an empty set if segment does not exist. )rRr3getkeys)r8rXs r- get_tracksAnnotation.get_trackss)"4<<##GR055788r0rYc>X RRU05;$)zCheck whether a given track exists Parameters ---------- segment : Segment Query segment track : Query track Returns ------- exists : bool True if track exists for segment )r3r)r8rXrYs r- has_trackAnnotation.has_tracks (("555r0cURURURS9n/[/5p2URR 5H@upEUR UR55 URU[U545 MB [U5UlUVs0sHofS_M snUl UVs0sHofS_M snUl SUl SUlU$s snfs snf)zaGet a copy of the annotation Returns ------- annotation : Annotation Copy of the annotation rNT)rr%r&rRr3rSrKrrUrrr4r5r6r7)r8copiedr3r4rvvaluerEs r-rAAnnotation.copysDHHt}}Es2w,,,,.JC NN5<<> * NNCe- ./$G,3:;7%+7;=D#EWE4KW#E &*# <#Es # C; C$rprefixc[URRU055nUbX$;aU$UcSnSnSX54-U;aUS- nSX54-U;aMSX54-$)aGenerate a new track name for given segment Ensures that the returned track name does not already exist for the given segment. Parameters ---------- segment : Segment Segment for which a new track name is generated. candidate : any valid track name, optional When provided, try this candidate name first. prefix : str, optional Track name prefix. Defaults to the empty string ''. Returns ------- name : str New track name rrz%s%dr)rRr3r)r8rXrrexisting_trackscounts r-rAnnotation.new_tracks}6dll..w;<  ! (H  >F'O; QJE'O;''r0c SRURSS9VVVs/sHupo1<SU<SU<3PM snnn5$s snnnf)zHuman-friendly representationrTrNr)rrT)r8stls r-__str__Annotation.__str__sByy37??t?3T U3Ta1a #3T U  UsA rvc[U[5(aKURRU5nSUlUR 5Hup4SUR U'M g[U[5(ar[U5S:XacURUSnURUS5nSUR U'U(d&URRUS5 SUlgg[S5e)zrDelete one track >>> del annotation[segment, track] Delete all tracks of a segment >>> del annotation[segment] Trrz:Deletion only works with Segment or (Segment, track) keys.N) rrr3rVr7rSr5tupler^r)r8rvrxrYrEs r- __delitem__Annotation.__delitem__s c7 # # \\%%c*F)-D %!'  04&&u-!/U # #CA \\#a&)F JJs1v&E-1D " "5 )   Q(,0) &L r0cd[U[5(aUS4nURUSUS$)zGet track label >>> label = annotation[segment, track] Note ---- ``annotation[segment]`` is equivalent to ``annotation[segment, '_']`` rhrr)rrr3)r8rvs r- __getitem__Annotation.__getitem__Rs6 c7 # #*C||CF#CF++r0rEc>[U[5(aUS4nUup4U(dgX0R;a0URU'SUlX@RU;a!URUUnSURU'X RUU'SURU'g)aBAdd new or update existing track >>> annotation[segment, track] = label If (segment, track) does not exist, it is added. If (segment, track) already exists, it is updated. Note ---- ``annotation[segment] = label`` is equivalent to ``annotation[segment, '_'] = label`` Note ---- If `segment` is empty, it does nothing. rhNT)rrr3r7r5)r8rvrErXrY old_labels r- __setitem__Annotation.__setitem__cs" c7 # #*C  ,, &$&DLL !(,D % LL) ) W-e4I04D " "9 -(- We$(,u%r0cJURURURS9$)zReturn an empty copy Returns ------- empty : Annotation Empty annotation using the same 'uri' and 'modality' attributes. r)rr%r&r=s r-emptyAnnotation.emptys~~$((T]]~CCr0c[URR5Vs/sHoPM sn5(aUR5 [ UR [ S9$s snf)zSGet sorted list of labels Returns ------- labels : list Sorted list of labels ru)rr5rrZrwr4rq)r8lnus r-rBAnnotation.labelssR t55<<>?>>? @ @    dll,,@s A!uniquecURRU05R5nU(a [U5$[ U5$)aQuery labels by segment Parameters ---------- segment : Segment Query unique : bool, optional When False, return the list of (possibly repeated) labels. Defaults to returning the set of labels. Returns ------- labels : set or list Set (resp. list) of labels for `segment` if it exists, empty set (resp. list) otherwise if unique (resp. if not unique). Examples -------- >>> annotation = Annotation() >>> segment = Segment(0, 2) >>> annotation[segment, 'speaker1'] = 'Bernard' >>> annotation[segment, 'speaker2'] = 'John' >>> print sorted(annotation.get_labels(segment)) set(['Bernard', 'John']) >>> print annotation.get_labels(Segment(1, 2)) set([]) )r3rrrRlist)r8rXr rBs r- get_labelsAnnotation.get_labelss;@!!'2.557 v; F|r0invertc[U5nU(a[UR55U- nOU[UR55-nURURURS9n0[/5pTUR R 5H\upgUR 5VV s0sHupX;dM X_M n nn U (dM9XU'URU R55 M^ [U5UlUV s0sHoS_M sn Ul UV s0sHoS_M sn Ul SUl SUl U$s sn nfs sn fs sn f)zFilter annotation by labels Parameters ---------- labels : iterable List of filtered labels invert : bool, optional If invert is True, extract all but requested labels Returns ------- filtered : Annotation Filtered annotation rTN)rRrBrr%r&r3rSrKrrr5r4r7r6) r8rBrsubr3r4rXrxrYrE sub_trackss r-rAnnotation.subsets) V '&0Fc$++-00FnnDMMnBs2w#||113OG171?5?   z#- z0023 4!) :A B'' B078ud{8 #'   !C8s. E=E E " ErctU(aUR5OUnURSS9H upEnXcXE4'M U$)arAdd every track of an existing annotation (in place) Parameters ---------- annotation : Annotation Annotation whose tracks are being added copy : bool, optional Return a copy of the annotation. Defaults to updating the annotation in-place. Returns ------- self : Annotation Updated annotation Note ---- Existing tracks are updated with the new label. TrN)rArT)r8rrAresultrXrYrEs r-rKAnnotation.updatesD*!%$&0%:%:t%:%L !GE%*7> "&M r0cXR5;a[URS9$URU(aUR 5 U(aUR UR 5$UR U$)aNQuery segments by label Parameters ---------- label : object Query copy : bool, optional Defaults (True) to returning a copy of the internal timeline. Set to False to return the actual internal timeline (faster). Returns ------- timeline : Timeline Timeline made of all segments for which at least one track is annotated as label Note ---- If label does not exist, this will return an empty timeline. Note ---- In case copy is set to False, be careful **not** to modify the returned timeline, as it may lead to weird subsequent behavior of the annotation instance. r)rBrr%r5rZr4rA)r8rErAs r-rCAnnotation.label_timelinesc8  %) )  ! !% (    <<&++- -||E""r0c>URUSS9R5$)aLabel support Equivalent to ``Annotation.label_timeline(label).support()`` Parameters ---------- label : object Query Returns ------- support : Timeline Label support See also -------- :func:`~pyannote.core.Annotation.label_timeline` :func:`~pyannote.core.Timeline.support` Fr@)rCrr8rEs r- label_supportAnnotation.label_support;s#*""5u"5==??r0c>URUSS9R5$)a(Label duration Equivalent to ``Annotation.label_timeline(label).duration()`` Parameters ---------- label : object Query Returns ------- duration : float Duration, in seconds. See also -------- :func:`~pyannote.core.Annotation.label_timeline` :func:`~pyannote.core.Timeline.duration` Fr@)rCrrs r-label_durationAnnotation.label_durationRs#,""5u"5>>@@r0percentc^[U4SjTR55SSS9nU(aE[R"UVVs/sHup4UPM snn5nUVVs/sH updXdU- 4PM nnnU$s snnfs snnf)a5Get labels chart (from longest to shortest duration) Parameters ---------- percent : bool, optional Return list of (label, percentage) tuples. Defaults to returning list of (label, duration) tuples. Returns ------- chart : list List of (label, duration), sorted by duration in decreasing order. c3H># UHoTRU54v M g7fr<r )rJLr8s r-rL#Annotation.chart..zs @-Q$$Q' (-"c US$NrrIxs r-rs"Annotation.chart..{!A$r0T)rvreverse)rwrBnpsum)r8r"chartrhrtotalrEs` r-r2Annotation.chartjss @$++- @  FF>H>?EHMN3DEe-.EN ?Ns A4 A:c^UmUbTRUSS9mT(dg[U4SjTR55SS9S$)aGet label with longest duration Parameters ---------- support : Segment or Timeline, optional Find label with longest duration within provided support. Defaults to whole extent. Returns ------- label : any existing label or None Label with longest intersection Examples -------- >>> annotation = Annotation(modality='speaker') >>> annotation[Segment(0, 10), 'speaker1'] = 'Alice' >>> annotation[Segment(8, 20), 'speaker1'] = 'Bob' >>> print "%s is such a talker!" % annotation.argmax() Bob is such a talker! >>> segment = Segment(22, 23) >>> if not annotation.argmax(support): ... print "No label intersecting %s" % segment No label intersection [22 --> 23] Nrrc3H># UHoTRU54v M g7fr<r%)rJrhrs r-rL$Annotation.argmax..s! F5E''* +5Er(c US$r*rIr+s r-rs#Annotation.argmax..r.r0rur)rmaxrB)r8rrs @r-argmaxAnnotation.argmaxsQ8  ll7l@G FW^^5E F    r0 generatorcURURURS9nUS:Xa [5nOUS:Xa [ 5nUR SS9Hup4nXRU[ U54'M U$)aRename all tracks Parameters ---------- generator : 'string', 'int', or iterable, optional If 'string' (default) rename tracks to 'A', 'B', 'C', etc. If 'int', rename tracks to 0, 1, 2, etc. If iterable, use it to generate track names. Returns ------- renamed : Annotation Copy of the original annotation where tracks are renamed. Example ------- >>> annotation = Annotation() >>> annotation[Segment(0, 1), 'a'] = 'a' >>> annotation[Segment(0, 1), 'b'] = 'b' >>> annotation[Segment(1, 2), 'a'] = 'a' >>> annotation[Segment(1, 3), 'c'] = 'c' >>> print(annotation) [ 00:00:00.000 --> 00:00:01.000] a a [ 00:00:00.000 --> 00:00:01.000] b b [ 00:00:01.000 --> 00:00:02.000] a a [ 00:00:01.000 --> 00:00:03.000] c c >>> print(annotation.rename_tracks(generator='int')) [ 00:00:00.000 --> 00:00:01.000] 0 a [ 00:00:00.000 --> 00:00:01.000] 1 b [ 00:00:01.000 --> 00:00:02.000] 2 a [ 00:00:01.000 --> 00:00:03.000] 3 c rstringintTrN)rr%r&rrrTnext)r8r=renamedrrhrEs r- rename_tracksAnnotation.rename_trackssoD..TXX .F  (*I % %I ??t?# URSS9nURSS9nURU5HfupE[URU5[S9n[URU5[S9n[ R "Xg5H upXH4XY44v M Mh g7f)aIIterate over pairs of intersecting tracks Parameters ---------- other : Annotation Second annotation Returns ------- iterable : (Segment, object), (Segment, object) iterable Yields pairs of intersecting tracks, in chronological (then alphabetical) order. See also -------- :func:`~pyannote.core.Timeline.co_iter` Fr@ruN)rDrrwrrqrproduct) r8rrFother_timelinerSrx other_tracksrTs r-rAnnotation.co_iterfs*$$%$0+++7$$^4DADOOA.C8F!%"2"21"53?L!))&?fqfn$@5sBBc[U[5(d [S5eUR5nUR5n[ U5VVs0sHupEXT_M nnn[ U5VVs0sHupuXW_M nnn[ R "[U5[U545n URU5H6uupupX`X4nXX4nX-RnXU4==U- ss'M8 U $s snnfs snnf)a1Cooccurrence (or confusion) matrix >>> matrix = annotation * other Parameters ---------- other : Annotation Second annotation Returns ------- cooccurrence : (n_self, n_other) np.ndarray Cooccurrence matrix where `n_self` (resp. `n_other`) is the number of labels in `self` (resp. `other`). zCcomputing cooccurrence matrix only works with Annotation instances.) rr" TypeErrorrB enumerater0zerosr^rr)r8ri_labelsj_labelsirEIjJmatrixrXrYr other_trackrs r-__mul__Annotation.__mul__s"%,,X ;;=<<>&/&9 :&9(!UX&9 :&/&9 :&9(!UX&9 :3q63q6*+?Cll5>Q : W:}w~&'A 234A/99H a4LH $L ?R   ; :s C6.C< resolutionrcUcUR5R5nUupVURUSS9nUcUR5n[ U[ 5(a[ XRR URS9nO [ XRUS9nURU5nUcURU5n X- n O [[XBR - 55n [R"U [U54[RS9n [U5HVupUR!U 5nURUSSS9H+unnU [#SU5[%UU 52U 4==S - ss'M- MX [R&"U S U S 9n [)XUS 9$) a?Discretize Parameters ---------- support : Segment, optional Part of annotation to discretize. Defaults to annotation full extent. resolution : float or SlidingWindow, optional Defaults to 10ms frames. labels : list of labels, optional Defaults to self.labels() duration : float, optional Overrides support duration and ensures that the number of returned frames is fixed (which might otherwise not be the case because of rounding errors). Returns ------- discretized : SlidingWindowFeature (num_frames, num_labels)-shaped binary features. rr)rstepr)dtypecenterT)r return_rangesrr)out)rB)rDrrrBrrrir closest_framer@roundr0r\r^uint8r[rCr:minminimumr)r8rrgrBr start_timeend_timer start_frame end_frame num_framesdatakrErQrstops r- discretizeAnnotation.discretizess: ?'')002G& ))G.)9 >^^%F j- 0 0& ATATJ' JJ!..z:  "00:I"0JU8oo#=>?JxxS[1B!&)HA--e4H)xt /  tSE]Sz%::A=>!C> * zz$t,#DVDDr0recordscPU"X#S9n[[5n[5nUHupxn XUU'URU 5 M [ U5UlUV s0sHoS_M sn UlUR V s0sHoS_M sn UlSUlSUl U$s sn fs sn f)a+Annotation Parameters ---------- records : iterator of tuples (segment, track, label) tuples uri : string, optional name of annotated resource (e.g. audio or video file) modality : string, optional name of annotated modality Returns ------- annotation : Annotation New annotation rNT) rrrRrrr3r4r5r6r7) r,r}r%r&rrxrBrXrYrEs r-r*Annotation.from_recordss0S4 T"%, !GE%*7OE " JJu &-(/ 7=>veTkv> AKASAS'TASt AS'T $# *. ' ?'Ts  B: B#cSSKJnJn U(d8[R"UR UR RS95 gSSKJn U"U5$)zJIPython notebook support See also -------- :mod:`pyannote.core.notebook` r)MATPLOTLIB_IS_AVAILABLEMATPLOTLIB_WARNING)klassN)repr_annotation) notebookrrwarningswarnformatr__name__r)r8rrrs r- _repr_png_Annotation._repr_png_sA J& MM,33$..:Q:Q3R S-t$$r0)r5r4r6r7r3r2r&)NN)F)T)rr")rr<)r'r")r?)Nr?T)g)Ng{Gz?NN)Ur __module__ __qualname____firstlineno____doc__ classmethodrrqr.r9propertyr%setterrZr_rcrbr r rrrirmboolrrrTr|rrDrrrrrrr rrrrrr rrrrr rrrArrrrrrrr rBrrrKrCrfloatr r2r;rrCrrIrMrrr0ndarrayrerrr{r*r__static_attributes__rIr0r-r"r"s< ""& R Rc]R3- R  RR/HSM/HSM/( ZZs8,!% !(5%#89 ! "#()) %gy015)U9R3SST U)>*6 889U7H+<%=9&HTN6== v Z8D>Z"<< f cKGcK8cKcKL2@>8>8&.>8 >8@'%(8E?";'%z'%R9'9c)n9&666t6">*. $ 0(0(I&0( 0(  0(d 2s2j,s,u,"(-s(-5(-T D -U -04%%(,% s5z4;& '%N*Xe_*d*|*XTl:%#E%#%#%#N@5@X@.AEAeA0Td53F.G6& hw/& 8E?& P,~,\,`#'$, 6$6"6 6  6pl85e5l5n%!% %gy015)9K3LLM N%:%\%bjj%R&*26+/$( ?E'"?E%./?Eh( ?E 5/ ?EB""& #%E 9:;#c]#3- #  ##J%r0r").rrr collectionsrtypingrrrrrr r r r r rrnumpyr0sortedcontainersrrrrrrXrrrFrfeaturerutils.generatorsrr utils.typesrrrrrr pandaspdr"rIr0r-rsc