PerformedTimespan¶
- class tsmakers.PerformedTimespan.PerformedTimespan(start_offset=NegativeInfinity, stop_offset=Infinity, divisions=None, forbid_fusing=None, forbid_splitting=None, layer=None, minimum_duration=None, music=None, music_specifier=None, original_start_offset=None, original_stop_offset=None, voice_name=None, handler=None)[source]¶
A Performed timespan.
>>> timespan = tsmakers.PerformedTimespan() >>> print(abjad.storage(timespan)) tsmakers.PerformedTimespan( start_offset=NegativeInfinity, stop_offset=Infinity, )
Attributes Summary
Is true when
argument
start offset is less than timespan start offset.Gets interpreter representation.
Return str(self).
Split into two parts when
offset
happens during timespan:Special methods
-
(
Timespan
).__and__(argument)¶ Logical AND of two timespans.
>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2) >>> timespan_4 = abjad.Timespan(10, 20)
>>> timespan_1 & timespan_2 TimespanList([Timespan(Offset((5, 1)), Offset((10, 1)))])
>>> timespan_1 & timespan_3 TimespanList([Timespan(Offset((0, 1)), Offset((2, 1)))])
>>> timespan_1 & timespan_4 TimespanList([])
>>> timespan_2 & timespan_3 TimespanList([])
>>> timespan_2 & timespan_4 TimespanList([Timespan(Offset((10, 1)), Offset((12, 1)))])
>>> timespan_3 & timespan_4 TimespanList([])
- Return type
TimespanList
-
(
Timespan
).__contains__(argument)¶ Is true when timespan contains
argument
.Works with offsets:
>>> timespan = abjad.Timespan(0, (1, 4))
>>> -1 in timespan False
>>> 0 in timespan True
>>> abjad.Offset(1, 8) in timespan True
>>> abjad.Offset(1, 4) in timespan True
>>> abjad.Offset(1, 2) in timespan False
Works with other timespans:
>>> timespan = abjad.Timespan(0, (1, 4))
>>> abjad.Timespan(0, (1, 4)) in timespan True
>>> abjad.Timespan((1, 16), (2, 16)) in timespan True
>>> abjad.Timespan(0, (1, 2)) in timespan False
- Return type
-
(
Timespan
).__ge__(argument)¶ Is true when
argument
start offset is greater or equal to timespan start offset.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2)
>>> timespan_2 >= timespan_3 True
>>> timespan_1 >= timespan_2 False
- Return type
-
(
Timespan
).__gt__(argument)¶ Is true when
argument
start offset is greater than timespan start offset.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2)
>>> timespan_2 > timespan_3 True
>>> timespan_1 > timespan_2 False
- Return type
-
(
Timespan
).__le__(argument)¶ Is true when
argument
start offset is less than or equal to timespan start offset.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2)
>>> timespan_2 <= timespan_3 False
>>> timespan_1 <= timespan_2 True
- Return type
- overridden __lt__(expr)[source]¶
Is true when
argument
start offset is less than timespan start offset.
-
(
Timespan
).__or__(argument)¶ Logical OR of two timespans.
>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2) >>> timespan_4 = abjad.Timespan(10, 20)
>>> new_timespan = timespan_1 | timespan_2 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((12, 1)), ), ] )
>>> new_timespan = timespan_1 | timespan_3 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((10, 1)), ), ] )
>>> new_timespan = timespan_1 | timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
>>> new_timespan = timespan_2 | timespan_3 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((2, 1)), ), abjad.Timespan( start_offset=abjad.Offset((5, 1)), stop_offset=abjad.Offset((12, 1)), ), ] )
>>> new_timespan = timespan_2 | timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((5, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
>>> new_timespan = timespan_3 | timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((2, 1)), ), abjad.Timespan( start_offset=abjad.Offset((10, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
- Return type
TimespanList
-
(
Timespan
).__sub__(argument)¶ Subtract
argument
from timespan.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2) >>> timespan_4 = abjad.Timespan(10, 20)
>>> timespan_1 - timespan_1 TimespanList([])
>>> timespan_1 - timespan_2 TimespanList([Timespan(Offset((0, 1)), Offset((5, 1)))])
>>> timespan_1 - timespan_3 TimespanList([Timespan(Offset((2, 1)), Offset((10, 1)))])
>>> timespan_1 - timespan_4 TimespanList([Timespan(Offset((0, 1)), Offset((10, 1)))])
>>> timespan_2 - timespan_1 TimespanList([Timespan(Offset((10, 1)), Offset((12, 1)))])
>>> timespan_2 - timespan_2 TimespanList([])
>>> timespan_2 - timespan_3 TimespanList([Timespan(Offset((5, 1)), Offset((12, 1)))])
>>> timespan_2 - timespan_4 TimespanList([Timespan(Offset((5, 1)), Offset((10, 1)))])
>>> timespan_3 - timespan_3 TimespanList([])
>>> timespan_3 - timespan_1 TimespanList([Timespan(Offset((-2, 1)), Offset((0, 1)))])
>>> timespan_3 - timespan_2 TimespanList([Timespan(Offset((-2, 1)), Offset((2, 1)))])
>>> timespan_3 - timespan_4 TimespanList([Timespan(Offset((-2, 1)), Offset((2, 1)))])
>>> timespan_4 - timespan_4 TimespanList([])
>>> timespan_4 - timespan_1 TimespanList([Timespan(Offset((10, 1)), Offset((20, 1)))])
>>> timespan_4 - timespan_2 TimespanList([Timespan(Offset((12, 1)), Offset((20, 1)))])
>>> timespan_4 - timespan_3 TimespanList([Timespan(Offset((10, 1)), Offset((20, 1)))])
Returns timespan list.
- Return type
TimespanList
-
(
Timespan
).__xor__(argument)¶ Logical XOR of two timespans.
>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 12) >>> timespan_3 = abjad.Timespan(-2, 2) >>> timespan_4 = abjad.Timespan(10, 20)
>>> new_timespan = timespan_1 ^ timespan_2 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((5, 1)), ), abjad.Timespan( start_offset=abjad.Offset((10, 1)), stop_offset=abjad.Offset((12, 1)), ), ] )
>>> new_timespan = timespan_1 ^ timespan_3 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((0, 1)), ), abjad.Timespan( start_offset=abjad.Offset((2, 1)), stop_offset=abjad.Offset((10, 1)), ), ] )
>>> new_timespan = timespan_1 ^ timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((10, 1)), ), abjad.Timespan( start_offset=abjad.Offset((10, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
>>> new_timespan = timespan_2 ^ timespan_3 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((2, 1)), ), abjad.Timespan( start_offset=abjad.Offset((5, 1)), stop_offset=abjad.Offset((12, 1)), ), ] )
>>> new_timespan = timespan_2 ^ timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((5, 1)), stop_offset=abjad.Offset((10, 1)), ), abjad.Timespan( start_offset=abjad.Offset((12, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
>>> new_timespan = timespan_3 ^ timespan_4 >>> string = abjad.storage(new_timespan) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((-2, 1)), stop_offset=abjad.Offset((2, 1)), ), abjad.Timespan( start_offset=abjad.Offset((10, 1)), stop_offset=abjad.Offset((20, 1)), ), ] )
- Return type
TimespanList
Methods
-
(
Timespan
).contains_timespan_improperly(timespan)¶ Is true when timespan contains
timespan
improperly.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 10)
>>> timespan_1.contains_timespan_improperly(timespan_1) True
>>> timespan_1.contains_timespan_improperly(timespan_2) True
>>> timespan_2.contains_timespan_improperly(timespan_1) False
>>> timespan_2.contains_timespan_improperly(timespan_2) True
- Return type
-
(
Timespan
).curtails_timespan(timespan)¶ Is true when timespan curtails
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 10)
>>> timespan_1.curtails_timespan(timespan_1) False
>>> timespan_1.curtails_timespan(timespan_2) False
>>> timespan_2.curtails_timespan(timespan_1) True
>>> timespan_2.curtails_timespan(timespan_2) False
- Return type
-
(
Timespan
).delays_timespan(timespan)¶ Is true when timespan delays
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15) >>> timespan_3 = abjad.Timespan(10, 20)
>>> timespan_1.delays_timespan(timespan_2) True
>>> timespan_2.delays_timespan(timespan_3) True
- Return type
-
(
Timespan
).divide_by_ratio(ratio)¶ Divides timespan by
ratio
.>>> timespan = abjad.Timespan((1, 2), (3, 2))
>>> for x in timespan.divide_by_ratio((1, 2, 1)): ... x ... Timespan(Offset((1, 2)), Offset((3, 4))) Timespan(Offset((3, 4)), Offset((5, 4))) Timespan(Offset((5, 4)), Offset((3, 2)))
- Return type
Tuple
[Timespan
, …]
-
(
Timespan
).get_overlap_with_timespan(timespan)¶ Gets duration of overlap with
timespan
.>>> timespan_1 = abjad.Timespan(0, 15) >>> timespan_2 = abjad.Timespan(5, 10) >>> timespan_3 = abjad.Timespan(6, 6) >>> timespan_4 = abjad.Timespan(12, 22)
>>> timespan_1.get_overlap_with_timespan(timespan_1) Duration(15, 1)
>>> timespan_1.get_overlap_with_timespan(timespan_2) Duration(5, 1)
>>> timespan_1.get_overlap_with_timespan(timespan_3) Duration(0, 1)
>>> timespan_1.get_overlap_with_timespan(timespan_4) Duration(3, 1)
>>> timespan_2.get_overlap_with_timespan(timespan_2) Duration(5, 1)
>>> timespan_2.get_overlap_with_timespan(timespan_3) Duration(0, 1)
>>> timespan_2.get_overlap_with_timespan(timespan_4) Duration(0, 1)
>>> timespan_3.get_overlap_with_timespan(timespan_3) Duration(0, 1)
>>> timespan_3.get_overlap_with_timespan(timespan_4) Duration(0, 1)
>>> timespan_4.get_overlap_with_timespan(timespan_4) Duration(10, 1)
- Return type
Optional
[Duration
]
-
(
Timespan
).happens_during_timespan(timespan)¶ Is true when timespan happens during
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 10)
>>> timespan_1.happens_during_timespan(timespan_1) True
>>> timespan_1.happens_during_timespan(timespan_2) False
>>> timespan_2.happens_during_timespan(timespan_1) True
>>> timespan_2.happens_during_timespan(timespan_2) True
- Return type
-
(
Timespan
).intersects_timespan(timespan)¶ Is true when timespan intersects
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15) >>> timespan_3 = abjad.Timespan(10, 15)
>>> timespan_1.intersects_timespan(timespan_1) True
>>> timespan_1.intersects_timespan(timespan_2) True
>>> timespan_1.intersects_timespan(timespan_3) False
- Return type
-
(
Timespan
).is_congruent_to_timespan(timespan)¶ Is true when timespan is congruent to
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.is_congruent_to_timespan(timespan_1) True
>>> timespan_1.is_congruent_to_timespan(timespan_2) False
>>> timespan_2.is_congruent_to_timespan(timespan_1) False
>>> timespan_2.is_congruent_to_timespan(timespan_2) True
- Return type
-
(
Timespan
).is_tangent_to_timespan(timespan)¶ Is true when timespan is tangent to
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.is_tangent_to_timespan(timespan_1) False
>>> timespan_1.is_tangent_to_timespan(timespan_2) True
>>> timespan_2.is_tangent_to_timespan(timespan_1) True
>>> timespan_2.is_tangent_to_timespan(timespan_2) False
- Return type
-
(
Timespan
).overlaps_all_of_timespan(timespan)¶ Is true when timespan overlaps all of
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 6) >>> timespan_3 = abjad.Timespan(5, 10)
>>> timespan_1.overlaps_all_of_timespan(timespan_1) False
>>> timespan_1.overlaps_all_of_timespan(timespan_2) True
>>> timespan_1.overlaps_all_of_timespan(timespan_3) False
- Return type
-
(
Timespan
).overlaps_only_start_of_timespan(timespan)¶ Is true when timespan overlaps only start of
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(-5, 5) >>> timespan_3 = abjad.Timespan(4, 6) >>> timespan_4 = abjad.Timespan(5, 15)
>>> timespan_1.overlaps_only_start_of_timespan(timespan_1) False
>>> timespan_1.overlaps_only_start_of_timespan(timespan_2) False
>>> timespan_1.overlaps_only_start_of_timespan(timespan_3) False
>>> timespan_1.overlaps_only_start_of_timespan(timespan_4) True
- Return type
-
(
Timespan
).overlaps_only_stop_of_timespan(timespan)¶ Is true when timespan overlaps only stop of
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(-5, 5) >>> timespan_3 = abjad.Timespan(4, 6) >>> timespan_4 = abjad.Timespan(5, 15)
>>> timespan_1.overlaps_only_stop_of_timespan(timespan_1) False
>>> timespan_1.overlaps_only_stop_of_timespan(timespan_2) True
>>> timespan_1.overlaps_only_stop_of_timespan(timespan_3) False
>>> timespan_1.overlaps_only_stop_of_timespan(timespan_4) False
- Return type
-
(
Timespan
).overlaps_start_of_timespan(timespan)¶ Is true when timespan overlaps start of
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(-5, 5) >>> timespan_3 = abjad.Timespan(4, 6) >>> timespan_4 = abjad.Timespan(5, 15)
>>> timespan_1.overlaps_start_of_timespan(timespan_1) False
>>> timespan_1.overlaps_start_of_timespan(timespan_2) False
>>> timespan_1.overlaps_start_of_timespan(timespan_3) True
>>> timespan_1.overlaps_start_of_timespan(timespan_4) True
- Return type
-
(
Timespan
).overlaps_stop_of_timespan(timespan)¶ Is true when timespan overlaps start of
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(-5, 5) >>> timespan_3 = abjad.Timespan(4, 6) >>> timespan_4 = abjad.Timespan(5, 15)
>>> timespan_1.overlaps_stop_of_timespan(timespan_1) False
>>> timespan_1.overlaps_stop_of_timespan(timespan_2) True
>>> timespan_1.overlaps_stop_of_timespan(timespan_3) True
>>> timespan_1.overlaps_stop_of_timespan(timespan_4) False
- Return type
-
(
Timespan
).reflect(axis=None)¶ Reflects timespan about
axis
.Reverse timespan about timespan axis:
>>> abjad.Timespan(3, 6).reflect() Timespan(Offset((3, 1)), Offset((6, 1)))
Reverse timespan about arbitrary axis:
>>> abjad.Timespan(3, 6).reflect(axis=abjad.Offset(10)) Timespan(Offset((14, 1)), Offset((17, 1)))
- Return type
Timespan
-
(
Timespan
).round_offsets(multiplier, anchor=Left, must_be_wellformed=True)¶ Rounds timespan offsets to multiple of
multiplier
.>>> timespan = abjad.Timespan((1, 5), (4, 5))
>>> timespan.round_offsets(1) Timespan(Offset((0, 1)), Offset((1, 1)))
>>> timespan.round_offsets(2) Timespan(Offset((0, 1)), Offset((2, 1)))
>>> timespan.round_offsets(2, anchor=abjad.Right) Timespan(Offset((-2, 1)), Offset((0, 1)))
>>> timespan.round_offsets(2, anchor=abjad.Right, must_be_wellformed=False) Timespan(Offset((0, 1)), Offset((0, 1)))
- Return type
Timespan
-
(
Timespan
).scale(multiplier, anchor=Left)¶ Scales timespan by
multiplier
.>>> timespan = abjad.Timespan(3, 6)
Scale timespan relative to timespan start offset:
>>> timespan.scale(abjad.Multiplier(2)) Timespan(Offset((3, 1)), Offset((9, 1)))
Scale timespan relative to timespan stop offset:
>>> timespan.scale(abjad.Multiplier(2), anchor=abjad.Right) Timespan(Offset((0, 1)), Offset((6, 1)))
- Return type
Timespan
-
(
Timespan
).set_duration(duration)¶ Sets timespan duration to
duration
.>>> timespan = abjad.Timespan((1, 2), (3, 2))
>>> timespan.set_duration((3, 5)) Timespan(Offset((1, 2)), Offset((11, 10)))
- Return type
Timespan
-
(
Timespan
).set_offsets(start_offset=None, stop_offset=None)¶ Sets timespan start offset to
start_offset
and stop offset tostop_offset
.>>> timespan = abjad.Timespan((1, 2), (3, 2))
>>> timespan.set_offsets(stop_offset=(7, 8)) Timespan(Offset((1, 2)), Offset((7, 8)))
Subtracts negative
start_offset
from existing stop offset:>>> timespan.set_offsets(start_offset=(-1, 2)) Timespan(Offset((1, 1)), Offset((3, 2)))
Subtracts negative
stop_offset
from existing stop offset:>>> timespan.set_offsets(stop_offset=(-1, 2)) Timespan(Offset((1, 2)), Offset((1, 1)))
- Return type
Timespan
- overridden split_at_offset(offset)[source]¶
Split into two parts when
offset
happens during timespan:>>> timespan = abjad.Timespan(0, 5)
>>> left, right = timespan.split_at_offset((2, 1))
>>> left Timespan(Offset((0, 1)), Offset((2, 1)))
>>> right Timespan(Offset((2, 1)), Offset((5, 1)))
Otherwise return a copy of timespan:
>>> timespan.split_at_offset((12, 1))[0] Timespan(Offset((0, 1)), Offset((5, 1)))
-
(
Timespan
).split_at_offsets(offsets)¶ Split into one or more parts when
offsets
happens during timespan:>>> timespan = abjad.Timespan(0, 10)
>>> result = timespan.split_at_offsets((1, 3, 7)) >>> string = abjad.storage(result) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((1, 1)), ), abjad.Timespan( start_offset=abjad.Offset((1, 1)), stop_offset=abjad.Offset((3, 1)), ), abjad.Timespan( start_offset=abjad.Offset((3, 1)), stop_offset=abjad.Offset((7, 1)), ), abjad.Timespan( start_offset=abjad.Offset((7, 1)), stop_offset=abjad.Offset((10, 1)), ), ] )
Otherwise return a timespan list containing a copy of timespan:
>>> result = timespan.split_at_offsets((-100,)) >>> string = abjad.storage(result) >>> print(string) abjad.TimespanList( [ abjad.Timespan( start_offset=abjad.Offset((0, 1)), stop_offset=abjad.Offset((10, 1)), ), ] )
- Return type
TimespanList
-
(
Timespan
).starts_after_timespan_starts(timespan)¶ Is true when timespan starts after
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.starts_after_timespan_starts(timespan_1) False
>>> timespan_1.starts_after_timespan_starts(timespan_2) False
>>> timespan_2.starts_after_timespan_starts(timespan_1) True
>>> timespan_2.starts_after_timespan_starts(timespan_2) False
- Return type
-
(
Timespan
).starts_after_timespan_stops(timespan)¶ Is true when timespan starts after
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15) >>> timespan_3 = abjad.Timespan(10, 20) >>> timespan_4 = abjad.Timespan(15, 25)
>>> timespan_1.starts_after_timespan_stops(timespan_1) False
>>> timespan_2.starts_after_timespan_stops(timespan_1) False
>>> timespan_3.starts_after_timespan_stops(timespan_1) True
>>> timespan_4.starts_after_timespan_stops(timespan_1) True
- Return type
-
(
Timespan
).starts_at_or_after_offset(offset)¶ Is true when timespan starts at or after
offset
.>>> timespan_1 = abjad.Timespan(0, 10)
>>> timespan_1.starts_at_or_after_offset((-5, 1)) True
>>> timespan_1.starts_at_or_after_offset((0, 1)) True
>>> timespan_1.starts_at_or_after_offset((5, 1)) False
- Return type
-
(
Timespan
).starts_before_or_at_offset(offset)¶ Is true when timespan starts before or at
offset
.>>> timespan_1 = abjad.Timespan(0, 10)
>>> timespan_1.starts_before_or_at_offset((-5, 1)) False
>>> timespan_1.starts_before_or_at_offset((0, 1)) True
>>> timespan_1.starts_before_or_at_offset((5, 1)) True
- Return type
-
(
Timespan
).starts_before_timespan_starts(timespan)¶ Is true when timespan starts before
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.starts_before_timespan_starts(timespan_1) False
>>> timespan_1.starts_before_timespan_starts(timespan_2) True
>>> timespan_2.starts_before_timespan_starts(timespan_1) False
>>> timespan_2.starts_before_timespan_starts(timespan_2) False
- Return type
-
(
Timespan
).starts_before_timespan_stops(timespan)¶ Is true when timespan starts before
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.starts_before_timespan_stops(timespan_1) True
>>> timespan_1.starts_before_timespan_stops(timespan_2) True
>>> timespan_2.starts_before_timespan_stops(timespan_1) True
>>> timespan_2.starts_before_timespan_stops(timespan_2) True
- Return type
-
(
Timespan
).starts_during_timespan(timespan)¶ Is true when timespan starts during
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.starts_during_timespan(timespan_1) True
>>> timespan_1.starts_during_timespan(timespan_2) False
>>> timespan_2.starts_during_timespan(timespan_1) True
>>> timespan_2.starts_during_timespan(timespan_2) True
- Return type
-
(
Timespan
).starts_when_timespan_starts(timespan)¶ Is true when timespan starts when
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 15)
>>> timespan_1.starts_when_timespan_starts(timespan_1) True
>>> timespan_1.starts_when_timespan_starts(timespan_2) False
>>> timespan_2.starts_when_timespan_starts(timespan_1) False
>>> timespan_2.starts_when_timespan_starts(timespan_2) True
- Return type
-
(
Timespan
).starts_when_timespan_stops(timespan)¶ Is true when timespan starts when
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.starts_when_timespan_stops(timespan_1) False
>>> timespan_1.starts_when_timespan_stops(timespan_2) False
>>> timespan_2.starts_when_timespan_stops(timespan_1) True
>>> timespan_2.starts_when_timespan_stops(timespan_2) False
- Return type
-
(
Timespan
).stops_after_timespan_starts(timespan)¶ Is true when timespan stops when
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_after_timespan_starts(timespan_1) True
>>> timespan_1.stops_after_timespan_starts(timespan_2) False
>>> timespan_2.stops_after_timespan_starts(timespan_1) True
>>> timespan_2.stops_after_timespan_starts(timespan_2) True
- Return type
-
(
Timespan
).stops_after_timespan_stops(timespan)¶ Is true when timespan stops when
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_after_timespan_stops(timespan_1) False
>>> timespan_1.stops_after_timespan_stops(timespan_2) False
>>> timespan_2.stops_after_timespan_stops(timespan_1) True
>>> timespan_2.stops_after_timespan_stops(timespan_2) False
- Return type
-
(
Timespan
).stops_at_or_after_offset(offset)¶ Is true when timespan stops at or after
offset
.>>> timespan_1 = abjad.Timespan(0, 10)
>>> timespan_1.stops_at_or_after_offset((-5, 1)) True
>>> timespan_1.stops_at_or_after_offset((0, 1)) True
>>> timespan_1.stops_at_or_after_offset((5, 1)) True
- Return type
-
(
Timespan
).stops_before_or_at_offset(offset)¶ Is true when timespan stops before or at
offset
.>>> timespan_1 = abjad.Timespan(0, 10)
>>> timespan_1.stops_before_or_at_offset((-5, 1)) False
>>> timespan_1.stops_before_or_at_offset((0, 1)) False
>>> timespan_1.stops_before_or_at_offset((5, 1)) False
- Return type
-
(
Timespan
).stops_before_timespan_starts(timespan)¶ Is true when timespan stops before
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_before_timespan_starts(timespan_1) False
>>> timespan_1.stops_before_timespan_starts(timespan_2) False
>>> timespan_2.stops_before_timespan_starts(timespan_1) False
>>> timespan_2.stops_before_timespan_starts(timespan_2) False
- Return type
-
(
Timespan
).stops_before_timespan_stops(timespan)¶ Is true when timespan stops before
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_before_timespan_stops(timespan_1) False
>>> timespan_1.stops_before_timespan_stops(timespan_2) True
>>> timespan_2.stops_before_timespan_stops(timespan_1) False
>>> timespan_2.stops_before_timespan_stops(timespan_2) False
- Return type
-
(
Timespan
).stops_during_timespan(timespan)¶ Is true when timespan stops during
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_during_timespan(timespan_1) True
>>> timespan_1.stops_during_timespan(timespan_2) False
>>> timespan_2.stops_during_timespan(timespan_1) False
>>> timespan_2.stops_during_timespan(timespan_2) True
- Return type
-
(
Timespan
).stops_when_timespan_starts(timespan)¶ Is true when timespan stops when
timespan
starts.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_when_timespan_starts(timespan_1) False
>>> timespan_1.stops_when_timespan_starts(timespan_2) True
>>> timespan_2.stops_when_timespan_starts(timespan_1) False
>>> timespan_2.stops_when_timespan_starts(timespan_2) False
- Return type
-
(
Timespan
).stops_when_timespan_stops(timespan)¶ Is true when timespan stops when
timespan
stops.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(10, 20)
>>> timespan_1.stops_when_timespan_stops(timespan_1) True
>>> timespan_1.stops_when_timespan_stops(timespan_2) False
>>> timespan_2.stops_when_timespan_stops(timespan_1) False
>>> timespan_2.stops_when_timespan_stops(timespan_2) True
- Return type
-
(
Timespan
).stretch(multiplier, anchor=None)¶ Stretches timespan by
multiplier
relative toanchor
.Stretch relative to timespan start offset:
>>> abjad.Timespan(3, 10).stretch(abjad.Multiplier(2)) Timespan(Offset((3, 1)), Offset((17, 1)))
Stretch relative to timespan stop offset:
>>> abjad.Timespan(3, 10).stretch(abjad.Multiplier(2), abjad.Offset(10)) Timespan(Offset((-4, 1)), Offset((10, 1)))
Stretch relative to offset prior to timespan:
>>> abjad.Timespan(3, 10).stretch(abjad.Multiplier(2), abjad.Offset(0, 1)) Timespan(Offset((6, 1)), Offset((20, 1)))
Stretch relative to offset after timespan:
>>> abjad.Timespan(3, 10).stretch(abjad.Multiplier(3), abjad.Offset(12)) Timespan(Offset((-15, 1)), Offset((6, 1)))
Stretch relative to offset that happens during timespan:
>>> abjad.Timespan(3, 10).stretch(abjad.Multiplier(2), abjad.Offset(4)) Timespan(Offset((2, 1)), Offset((16, 1)))
- Return type
Timespan
-
(
Timespan
).translate(translation=None)¶ Translates timespan by
translation
.>>> timespan = abjad.Timespan(5, 10)
>>> timespan.translate(2) Timespan(Offset((7, 1)), Offset((12, 1)))
- Return type
Timespan
-
(
Timespan
).translate_offsets(start_offset_translation=None, stop_offset_translation=None)¶ Translates timespan start offset by
start_offset_translation
and stop offset bystop_offset_translation
.>>> timespan = abjad.Timespan((1, 2), (3, 2))
>>> timespan.translate_offsets(start_offset_translation=(-1, 8)) Timespan(Offset((3, 8)), Offset((3, 2)))
- Return type
Timespan
-
(
Timespan
).trisects_timespan(timespan)¶ Is true when timespan trisects
timespan
.>>> timespan_1 = abjad.Timespan(0, 10) >>> timespan_2 = abjad.Timespan(5, 6)
>>> timespan_1.trisects_timespan(timespan_1) False
>>> timespan_1.trisects_timespan(timespan_2) False
>>> timespan_2.trisects_timespan(timespan_1) True
>>> timespan_2.trisects_timespan(timespan_2) False
- Return type
Read-only properties
-
(
Timespan
).axis¶ Gets arithmetic mean of timespan start- and stop-offsets.
>>> abjad.Timespan(0, 10).axis Offset((5, 1))
- Return type
Offset
- divisions¶
-
(
Timespan
).duration¶ Gets duration of timespan.
>>> abjad.Timespan(0, 10).duration Duration(10, 1)
- Return type
Duration
- forbid_fusing¶
- forbid_splitting¶
- handler¶
- is_left_broken¶
- is_right_broken¶
- layer¶
- minimum_duration¶
- music¶
- music_specifier¶
- original_start_offset¶
- original_stop_offset¶
-
(
Timespan
).start_offset¶ Gets start offset.
>>> abjad.Timespan(0, 10).start_offset Offset((0, 1))
- Return type
Offset
-
(
Timespan
).stop_offset¶ Gets stop offset.
>>> abjad.Timespan(0, 10).stop_offset Offset((10, 1))
- Return type
Offset
- voice_name¶
-
(