,jMlSrSSKrSSKJrJrJrJrJrJr SSK J r SSK r SSK Jr \"SSS9"S S 55r"S S 5rg) as ####### Segment ####### .. plot:: pyplots/segment.py :class:`pyannote.core.Segment` instances describe temporal fragments (*e.g.* of an audio file). The segment depicted above can be defined like that: .. code-block:: ipython In [1]: from pyannote.core import Segment In [2]: segment = Segment(start=5, end=15) In [3]: print(segment) It is nothing more than 2-tuples augmented with several useful methods and properties: .. code-block:: ipython In [4]: start, end = segment In [5]: start In [6]: segment.end In [7]: segment.duration # duration (read-only) In [8]: segment.middle # middle (read-only) In [9]: segment & Segment(3, 12) # intersection In [10]: segment | Segment(3, 12) # union In [11]: segment.overlaps(3) # does segment overlap time t=3? Use `Segment.set_precision(ndigits)` to automatically round start and end timestamps to `ndigits` precision after the decimal point. To ensure consistency between `Segment` instances, it is recommended to call this method only once, right after importing `pyannote.core.Segment`. .. code-block:: ipython In [12]: Segment(1/1000, 330/1000) == Segment(1/1000, 90/1000+240/1000) Out[12]: False In [13]: Segment.set_precision(ndigits=4) In [14]: Segment(1/1000, 330/1000) == Segment(1/1000, 90/1000+240/1000) Out[14]: True See :class:`pyannote.core.Segment` for the complete reference. N)UnionOptionalTupleListIteratorIterable) Alignment) dataclassT)frozenorderc\rSrSr%SrSr\\S'Sr\\S'\ SS\ \ 4Sjj5r S r S r\S \4S j5r\S \4S j5rS \\4SjrSSjrS SjrSrSSS \4SjrS\S \4SjrS!SjrS!SjrS\S \4SjrSrSrSr Sr!g)"Segment]ar Time interval Parameters ---------- start : float interval start time, in seconds. end : float interval end time, in seconds. Segments can be compared and sorted using the standard operators: >>> Segment(0, 1) == Segment(0, 1.) True >>> Segment(0, 1) != Segment(3, 4) True >>> Segment(0, 1) < Segment(2, 3) True >>> Segment(0, 1) < Segment(0, 2) True >>> Segment(1, 2) < Segment(0, 3) False Note ---- A segment is smaller than another segment if one of these two conditions is verified: - `segment.start < other_segment.start` - `segment.start == other_segment.start` and `segment.end < other_segment.end` startendNndigitsc$UcSqSqgSqSU*-qg)amAutomatically round start and end timestamps to `ndigits` precision after the decimal point To ensure consistency between `Segment` instances, it is recommended to call this method only once, right after importing `pyannote.core.Segment`. Usage ----- >>> from pyannote.core import Segment >>> Segment.set_precision(2) >>> Segment(1/3, 2/3) NFgư>T )AUTO_ROUND_TIMESEGMENT_PRECISION)rs ڣC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pyannote/core/segment.py set_precisionSegment.set_precisions&" ?#O $ "O "x 0 cT[URUR- [:5$)uEmptiness >>> if segment: ... # segment is not empty. ... else: ... # segment is empty. Note ---- A segment is considered empty if its end time is smaller than its start time, or its duration is smaller than 1μs. )boolrrrselfs r__bool__Segment.__bool__s"TXX *.??@@rc[(aw[RUS[UR[ - S-5[ -5 [RUS[UR [ - S-5[ -5 gg)zERound start and end up to SEGMENT_PRECISION precision (when required)r?rN)robject __setattr__intrrrrs r __post_init__Segment.__post_init__se ?   tWc$**?P2PSV2V.WZk.k l   tUC;L0Ls0R,SVg,g h rreturncFU(aURUR- $S$)zSegment duration (read-only)r)rrrs rdurationSegment.durations)-txx$**$4"4rc:SURUR--$)zSegment mid-time (read-only)r$rrrs rmiddleSegment.middlesTZZ$((*++rc#D# URv URv g7f)zUUnpack segment boundaries >>> segment = Segment(start, end) >>> start, end = segment Nr/rs r__iter__Segment.__iter__s jjhhs c>[URURS9$)zSGet a copy of the segment Returns ------- copy : Segment Copy of the segment. r/)rrrrs rcopy Segment.copysTZZTXX66rotherctURUR:*=(a URUR:$)zInclusion >>> segment = Segment(start=0, end=10) >>> Segment(start=3, end=10) in segment: True >>> Segment(start=5, end=15) in segment: False r/r r8s r __contains__Segment.__contains__s) ekk)FEII0EFrc[URUR5n[URUR5n[ X#S9$)ajIntersection >>> segment = Segment(0, 10) >>> other_segment = Segment(5, 15) >>> segment & other_segment Note ---- When the intersection is empty, an empty segment is returned: >>> segment = Segment(0, 10) >>> other_segment = Segment(15, 20) >>> intersection = segment & other_segment >>> if not intersection: ... # intersection is empty. r/)maxrminrrr r8rrs r__and__Segment.__and__s7$DJJ ,$((EII&U,,rcPURUR:=(a URUR[- :=(d` URUR:=(a URUR[- :=(d URUR:H$)zCheck whether two segments intersect each other Parameters ---------- other : Segment Other segment Returns ------- intersect : bool True if segments intersect, False otherwise )rrrr:s r intersectsSegment.intersectss{ U[[(; dhh):::+ U[[(; UYY):::+ ekk)  +rtcLURU:*=(a URU:$)zCheck if segment overlaps a given time Parameters ---------- t : float Time, in seconds. Returns ------- overlap: bool True if segment overlaps time t, False otherwise. r/r rFs roverlapsSegment.overlapsszzQ0488q=0rcU(dU$U(dU$[URUR5n[URUR5n[ X#S9$)a8Union >>> segment = Segment(0, 10) >>> other_segment = Segment(5, 15) >>> segment | other_segment Note ---- When a gap exists between the segment, their union covers the gap as well: >>> segment = Segment(0, 10) >>> other_segment = Segment(15, 20) >>> segment | other_segment rrr@s r__or__Segment.__or__sI&LKDJJ ,$((EII&U,,rcU(aU(d [S5e[URUR5n[URUR5n[ X#S9$)afGap >>> segment = Segment(0, 10) >>> other_segment = Segment(15, 20) >>> segment ^ other_segment >> segment = Segment(0, 10) >>> empty_segment = Segment(11, 11) >>> segment ^ empty_segment ValueError: The gap between a segment and an empty segment is not defined. z>The gap between a segment and an empty segment is not defined.r/) ValueErrorr?rr>rrr@s r__xor__Segment.__xor__3sP&e"# #DHHeii($**ekk*U,,rsecondscSSKJn US:n[U5nU"US9nURSUR--nUR n[ US5upg[ US5upSU(aSOS XhXS - 4-$) Nr) timedelta)rRiQi<z%s%02d:%02d:%02d.%03d- i)datetimerTabsrRdays microsecondsdivmod) r rRrTnegativetdr[hours remainderminutess r _str_helperSegment._str_helperOs&Q;g, w '**urww. !'40!)R0&Ce D(*** *rcU(a=SURUR5<SURUR5<S3$g)zHuman-readable representation >>> print(Segment(1337, 1337 + 0.42)) [ 00:22:17.000 --> 00:22:17.420] Note ---- Empty segments are printed as "[]" [z --> ]z[])rbrrrs r__str__Segment.__str__\s: $($4$4TZZ$@$($4$4TXX$>@ @rc8SURUR4-$)zZComputer-readable representation >>> Segment(1337, 1337 + 0.42) zr/rs r__repr__Segment.__repr__ks #djj$((%;;;rcSSKJnJn U(d8[R"UR UR RS95 gSSKJn U"U5$![a [R"SUS35 gf=f)zJIPython notebook support See also -------- :mod:`pyannote.core.notebook` r )MATPLOTLIB_IS_AVAILABLEMATPLOTLIB_WARNING)klassN) repr_segmentzBCouldn't import matplotlib to render the vizualization for object zY. To enable, install the required dependencies with 'pip install pyannore.core[notebook]') notebookrmrnwarningswarnformat __class____name__rp ImportError)r rmrnrps r _repr_png_Segment._repr_png_ss{ J& MM,33$..:Q:Q3R S* % %  MMTUYTZ[tu v sA$A>=A>N)r*r)r8r)r8rr*r)"rv __module__ __qualname____firstlineno____doc__rfloat__annotations__r staticmethodrr'rr!r(propertyr,r0rr3r6r;rArrDrIrLrPstrrbrgrjrx__static_attributes__rzrrrr]s@E5C1x}112 Ai 5%55,,,(5/7 G-,+ +d+( 1% 1D 1-<-8 *5 *S * <rrc>\rSrSrSrS-Sjr\S\4Sj5r\S\4Sj5r \S\4Sj5r \S\4S j5r S \S\ 4S jr S.S \S \S\ 4SjjrS/S\\S4S \S\\S\\S\\R*\\\ 44 SjjrS\S\\ \ 44SjrS\S\\ \ 44SjrS\ S\ S\4SjrS\ S\ S\4SjrS\ S\4SjrS\ S\4SjrS\S\ 4S jrS\S\ 4S!jr S"\ S\4S#jr!S\4S$jr"S\4S%jr#S0S&jr$S\ 4S'jr%S0S(jr&S1S)\\S4S*\S\'\4S+jjr(S,r)g)2 SlidingWindowiaQSliding window Parameters ---------- duration : float > 0, optional Window duration, in seconds. Default is 30 ms. step : float > 0, optional Step between two consecutive position, in seconds. Default is 10 ms. start : float, optional First start position of window, in seconds. Default is 0. end : float > `start`, optional Default is infinity (ie. window keeps sliding forever) Examples -------- >>> sw = SlidingWindow(duration, step, start) >>> frame_range = (a, b) >>> frame_range == sw.toFrameRange(sw.toSegment(*frame_range)) ... True >>> segment = Segment(A, B) >>> new_segment = sw.toSegment(*sw.toFrameRange(segment)) >>> abs(segment) - abs(segment & new_segment) < .5 * sw.step >>> sw = SlidingWindow(end=0.1) >>> print(next(sw)) [ 00:00:00.000 --> 00:00:00.030] >>> print(next(sw)) [ 00:00:00.010 --> 00:00:00.040] NcUS::a [S5eXlUS::a [S5eX lX0lUc[R UlOXC::a [S5eX@lSUlg)Nrz'duration' must be a float > 0.z'step' must be a float > 0.z#'end' must be greater than 'start'.)rO_SlidingWindow__duration_SlidingWindow__step_SlidingWindow__startnpinf_SlidingWindow__end_SlidingWindow__i)r r,steprrs r__init__SlidingWindow.__init__sp q=>? ?" 19:; ;! $  ; "DJ| !FGG #Jrr*cUR$)z%Sliding window start time in seconds.)rrs rrSlidingWindow.starts||rcUR$)z#Sliding window end time in seconds.)rrs rrSlidingWindow.endszzrcUR$)zSliding window step in seconds.)rrs rrSlidingWindow.steps{{rcUR$)z#Sliding window duration in seconds.)rrs rr,SlidingWindow.durationsrrFc[[R"XR- SUR-- UR - 55$)zClosest frame to timestamp. Parameters ---------- t : float Timestamp, in seconds. Returns ------- index : int Index of frame whose middle is the closest to `timestamp` r$)r'rrintrrrrHs r closest_frameSlidingWindow.closest_frames=277  T__ 4 4 C   r from_durationmodecdUS:Xa;[[R"XR- UR- 55S-$US:Xa8[[R"XR-UR- 55$US:Xa+[[R "XR- 55$g)ajNumber of frames Parameters ---------- from_duration : float Duration in seconds. mode : {'strict', 'loose', 'center'} In 'strict' mode, computes the maximum number of consecutive frames that can be fitted into a segment with duration `from_duration`. In 'loose' mode, computes the maximum number of consecutive frames intersecting a segment with duration `from_duration`. In 'center' mode, computes the average number of consecutive frames where the first one is centered on the start time and the last one is centered on the end time of a segment with duration `from_duration`. strictr loosecenterN)r'rfloorr,rr)r rrs rsamplesSlidingWindow.sampless$ 8 rxx!>$)) KLMPQQ Q W_rxx!>$)) KLM M X rww 9;< <rfocusTimelinefixed return_rangesc pSSKJn [U[U45(d Sn[ U5e[X5(aUb Sn[ U5eU(ac/n[ UR55HBupURXUSS9n US:XdU SSUSS:aXz- nM4U SSUSS'MD U$[R"UR5V s/sHn URXUS S9PM sn 5n [R"U 5$US :XaURUR- UR- UR- n [[R "U 55nUcMUR"UR- UR- n [[R$"U 55nXS-4n GO@UR'US S 9nXU-4n GO(US :XaURUR- UR- n [[R "U 55nUcYUR"UR- UR- UR- n [[R$"U 55nXS-4n OUR'US S 9nXU-4n OjUS :XaWUR)UR5nUc"UR)UR"5nXS-4n O$UR'US S 9nXU-4n O Sn[ U5eU(a [+U 5/$[R,"[/U 6[R0S9$s sn f)aUCrop sliding window Parameters ---------- focus : `Segment` or `Timeline` mode : {'strict', 'loose', 'center'}, optional In 'strict' mode, only indices of segments fully included in 'focus' support are returned. In 'loose' mode, indices of any intersecting segments are returned. In 'center' mode, first and last positions are chosen to be the positions whose centers are the closest to 'focus' start and end times. Defaults to 'loose'. fixed : float, optional Overrides `Segment` 'focus' duration and ensures that the number of returned frames is fixed (which might otherwise not be the case because of rounding erros). return_ranges : bool, optional Return as list of ranges. Defaults to indices numpy array. Returns ------- indices : np.array (or list of ranges) Array of unique indices of matching segments r rz3"focus" must be a `Segment` or `Timeline` instance.z1'fixed' is not supported with `Timeline` 'focus'.T)rrrrrFr)rrrz4'mode' must be one of {'loose', 'strict', 'center'}.)dtype)timeliner isinstancer TypeErrorrO enumeratesupportcroprhstackuniquerr,rr'ceilrrrrlistarrayrangeint64)r rrrrrmsgrangesisrngindicesi_j_jns rrSlidingWindow.crops: '%'8!455GCC. e & & I o%%emmo6DA))A26$8CAvQVBZ]!: ),Aq r 1 7 ii!*(A !e5 I(!*+G 99W% % 7?++ - :diiGBBGGBK A}ii$**, 9 %a%jLLWL5a%j X ++ *dii7BBGGBK A}ii$--/$**< I %a%jLLXL6a%j X ""5;;/A}&&uyy1a%jLLXL6a%jICS/ ! I; xxs 28844E!*sL3segmentcZ[R"S[5 URU5$)Nz)Deprecated in favor of `segment_to_range`)rrrsDeprecationWarningsegment_to_range)r rs rsegmentToRangeSlidingWindow.segmentToRanges% A( *$$W--rcURUR5n[URUR- 5S-nX#4$)aConvert segment to 0-indexed frame range Parameters ---------- segment : Segment Returns ------- i0 : int Index of first frame n : int Number of frames Examples -------- >>> window = SlidingWindow() >>> print window.segment_to_range(Segment(10, 15)) i0, n r )rrr'r,r)r ri0rs rrSlidingWindow.segment_to_ranges?.   .   499, - 1u rrrcZ[R"S[5 URX5$)Nz1This is deprecated in favor of `range_to_segment`)rrrsrrange_to_segment)r rrs rrangeToSegmentSlidingWindow.rangeToSegments% I( *$$R++rcURUS- UR--SUR--nX R-nX4-nUS:Xa URn[ X55$)aConvert 0-indexed frame range to segment Each frame represents a unique segment of duration 'step', centered on the middle of the frame. The very first frame (i0 = 0) is the exception. It is extended to the sliding window start time. Parameters ---------- i0 : int Index of first frame n : int Number of frames Returns ------- segment : Segment Examples -------- >>> window = SlidingWindow() >>> print window.range_to_segment(3, 2) [ --> ] r$r)rrrrr)r rrrr,rs rrSlidingWindow.range_to_segments^F R4;;66doo9MM{{? 7JJEu""rnSamplescZ[R"S[5 URU5$)Nz4This is deprecated in favor of `samples_to_duration`)rrrsrsamples_to_duration)r rs rsamplesToDurationSlidingWindow.samplesToDuration% L( *''11r n_samplesc:URSU5R$)zReturns duration of samplesr)rr,)r rs rr!SlidingWindow.samples_to_durations$$Q 2;;;rr,cZ[R"S[5 URU5$)Nz4This is deprecated in favor of `duration_to_samples`)rrrsrduration_to_samplesr r,s rdurationToSamplesSlidingWindow.durationToSamplesrrc>UR[SU55S$)zReturns samples in durationrr )rrrs rr!SlidingWindow.duration_to_sampless$$WQ%9:1==rrcURXR--nX R:ag[X"UR-S9$)z Parameters ---------- i : int Index of sliding window position Returns ------- segment : :class:`Segment` Sliding window at ith position Nr/)rrrrr)r rrs r __getitem__SlidingWindow.__getitem__s; q;;. JJ U(?@@rc"UR5$r{)__next__rs rnextSlidingWindow.nexts}}rcnU=RS- slXRnU(aU$[5e)Nr )r StopIteration)r windows rrSlidingWindow.__next__s* A hh M/ !rcSUlU$)aSliding window iterator Use expression 'for segment in sliding_window' Examples -------- >>> window = SlidingWindow(end=0.1) >>> for segment in window: ... print(segment) [ 00:00:00.000 --> 00:00:00.030] [ 00:00:00.010 --> 00:00:00.040] [ 00:00:00.020 --> 00:00:00.050] [ 00:00:00.030 --> 00:00:00.060] [ 00:00:00.040 --> 00:00:00.070] [ 00:00:00.050 --> 00:00:00.080] [ 00:00:00.060 --> 00:00:00.090] [ 00:00:00.070 --> 00:00:00.100] [ 00:00:00.080 --> 00:00:00.110] [ 00:00:00.090 --> 00:00:00.120] r)rrs rr3SlidingWindow.__iter__s0 rc[R"UR5(a [S5eUR UR5nX(aUS- nX(aMUnU$)zNumber of positions Equivalent to len([segment for segment in window]) Returns ------- length : int Number of positions taken by the sliding window (from start times to end times) zinfinite sliding window.r )risinfrrOr)r rlengths r__len__SlidingWindow.__len__*sZ 88DJJ  78 8   tzz *w FAww rcURnURnURnURnUR XX4S9nU$)zDuplicate sliding windowr,rrr)r,rrrru)r r,rrrsliding_windows rr6SlidingWindow.copyCsF==yy hh( rr align_lastc#.# SSKJn [X5(aUnO7[U[5(aU"U/S9nOS[ U5S3n[ U5eUHnUR UR :aM[UR URURURS9nUHnX;dM Uv Un M U(dMrW RUR:dM[URUR - URS9v M g7f) a'Slide window over support Parameter --------- support : Segment or Timeline Support on which to slide the window. align_last : bool, optional Yield a final segment so that it aligns exactly with end of support. Yields ------ chunk : Segment Example ------- >>> window = SlidingWindow(duration=2., step=1.) >>> for chunk in window(Segment(3, 7.5)): ... print(tuple(chunk)) (3.0, 5.0) (4.0, 6.0) (5.0, 7.0) >>> for chunk in window(Segment(3, 7.5), align_last=True): ... print(tuple(chunk)) (3.0, 5.0) (4.0, 6.0) (5.0, 7.0) (5.5, 7.5) rr)segmentsz>"support" must be either a Segment or a Timeline instance (is )rr/N) pyannote.corerrrtyperr,rrrr) r rrrrrrrrlasts r__call__SlidingWindow.__call__Ns@ + g ( (H  ) )'3H $W a1 C. G$--/"DMM(, )0'.{{4F <GD  zdhh4GKK$--$?")++//# sB.D4DD#2D) __duration__end__i__start__step)gQ?g{Gz?rN)r)rNF)r*r)F)*rvr|r}r~rrrrrrrr,r'rr rrrrrrndarrayrrrrrrrrrrrrrrr3rr6rrrrzrrrrsF@6uUe% u  $=U=)=3=8 '&*-2}5% 34}5}5UO}5%TN}5 "**d49o- . }5~.g.%S/. E#s(O<,,,, +#3+#3+#7+#Z2#2%2 E>c>ASAWA0g"'"62 %*@/ 34@/!@/.6w.?@/@/rr)rrrtypingrrrrrr utils.typesr numpyr dataclassesr rrrzrrrsO:4lCC"! $d#gg$gT F/F/r