From dfce68aa6758280cb084a8cffe21319db980510f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Trevor=20Ba=C4=8Da?= Date: Sun, 30 Oct 2022 16:25:03 -0400 Subject: [PATCH] Removed natural-language inequalities from abjad.Timespan. Closes #1491. --- abjad/timespan.py | 874 +--------------------------------------------- 1 file changed, 3 insertions(+), 871 deletions(-) diff --git a/abjad/timespan.py b/abjad/timespan.py index c2f71a96143..9f0622c7c7e 100644 --- a/abjad/timespan.py +++ b/abjad/timespan.py @@ -932,82 +932,6 @@ def wellformed(self) -> bool: ### PUBLIC METHODS ### - def contains_timespan_improperly(self, timespan) -> bool: - """ - Is true when timespan contains ``timespan`` improperly. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset <= expr_start_offset - and expr_stop_offset <= self_stop_offset - ) - - def curtails_timespan(self, timespan) -> bool: - """ - Is true when timespan curtails ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset < self_start_offset - and self_start_offset <= expr_stop_offset - and expr_stop_offset <= self_stop_offset - ) - - def delays_timespan(self, timespan) -> bool: - """ - Is true when timespan delays ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset <= expr_start_offset - and expr_start_offset < self_stop_offset - ) - def divide_by_ratio(self, ratio) -> tuple["Timespan", ...]: """ Divides timespan by ``ratio``. @@ -1083,250 +1007,6 @@ def get_overlap_with_timespan(self, timespan) -> _duration.Duration | None: return result return None - def happens_during_timespan(self, timespan) -> bool: - """ - Is true when timespan happens during ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset <= self_start_offset - and self_stop_offset <= expr_stop_offset - ) - - def intersects_timespan(self, timespan) -> bool: - """ - Is true when timespan intersects ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset <= self_start_offset - and self_start_offset < expr_stop_offset - ) or ( - self_start_offset <= expr_start_offset - and expr_start_offset < self_stop_offset - ) - - def is_congruent_to_timespan(self, timespan) -> bool: - """ - Is true when timespan is congruent to ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset == self_start_offset - and expr_stop_offset == self_stop_offset - ) - - def is_tangent_to_timespan(self, timespan) -> bool: - """ - Is true when timespan is tangent to ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_stop_offset == expr_start_offset - or expr_stop_offset == self_start_offset - ) - - def overlaps_all_of_timespan(self, timespan) -> bool: - """ - Is true when timespan overlaps all of ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset < expr_start_offset - and expr_stop_offset < self_stop_offset - ) - - def overlaps_only_start_of_timespan(self, timespan) -> bool: - """ - Is true when timespan overlaps only start of ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset < expr_start_offset - and expr_start_offset < self_stop_offset - and self_stop_offset <= expr_stop_offset - ) - - def overlaps_only_stop_of_timespan(self, timespan) -> bool: - """ - Is true when timespan overlaps only stop of ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset <= self_start_offset - and self_start_offset < expr_stop_offset - and expr_stop_offset < self_stop_offset - ) - - def overlaps_start_of_timespan(self, timespan) -> bool: - """ - Is true when timespan overlaps start of ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset < expr_start_offset - and expr_start_offset < self_stop_offset - ) - - def overlaps_stop_of_timespan(self, timespan) -> bool: - """ - Is true when timespan overlaps start of ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - self_start_offset < expr_stop_offset and expr_stop_offset < self_stop_offset - ) - def reflect(self, axis=None) -> "Timespan": """ Reflects timespan about ``axis``. @@ -1568,526 +1248,6 @@ def split_at_offsets(self, offsets) -> "TimespanList": result.append(right) return result - def starts_after_offset(self, offset) -> bool: - """ - Is true when timespan overlaps start of ``timespan``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.starts_after_offset((-5, 1)) - True - >>> timespan_1.starts_after_offset((0, 1)) - False - >>> timespan_1.starts_after_offset((5, 1)) - False - - """ - offset = _duration.Offset(offset) - return offset < self.start_offset - - def starts_after_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan starts after ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return expr_start_offset < self_start_offset - - def starts_after_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan starts after ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return expr_stop_offset <= self_start_offset - - def starts_at_offset(self, offset) -> bool: - """ - Is true when timespan starts at ``offset``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.starts_at_offset((-5, 1)) - False - >>> timespan_1.starts_at_offset((0, 1)) - True - >>> timespan_1.starts_at_offset((5, 1)) - False - - """ - offset = _duration.Offset(offset) - return self.start_offset == offset - - def starts_at_or_after_offset(self, offset) -> bool: - """ - Is true when timespan starts at or after ``offset``. - - .. container:: example - - >>> 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 - - """ - offset = _duration.Offset(offset) - return offset <= self.start_offset - - def starts_before_offset(self, offset) -> bool: - """ - Is true when timespan starts before ``offset``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.starts_before_offset((-5, 1)) - False - >>> timespan_1.starts_before_offset((0, 1)) - False - >>> timespan_1.starts_before_offset((5, 1)) - True - - """ - offset = _duration.Offset(offset) - return self.start_offset < offset - - def starts_before_or_at_offset(self, offset) -> bool: - """ - Is true when timespan starts before or at ``offset``. - - .. container:: example - - >>> 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 - - """ - offset = _duration.Offset(offset) - return self.start_offset <= offset - - def starts_before_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan starts before ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_start_offset < expr_start_offset - - def starts_before_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan starts before ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_start_offset < expr_stop_offset - - def starts_during_timespan(self, timespan) -> bool: - """ - Is true when timespan starts during ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset <= self_start_offset - and self_start_offset < expr_stop_offset - ) - - def starts_when_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan starts when ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return expr_start_offset == self_start_offset - - def starts_when_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan starts when ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_start_offset == expr_stop_offset - - def stops_after_offset(self, offset) -> bool: - """ - Is true when timespan stops after ``offset``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.starts_after_offset((-5, 1)) - True - >>> timespan_1.starts_after_offset((0, 1)) - False - >>> timespan_1.starts_after_offset((5, 1)) - False - - """ - offset = _duration.Offset(offset) - return offset < self.stop_offset - - def stops_after_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan stops when ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return expr_start_offset < self_stop_offset - - def stops_after_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan stops when ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return expr_stop_offset < self_stop_offset - - def stops_at_offset(self, offset) -> bool: - """ - Is true when timespan stops at ``offset``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.stops_at_offset((-5, 1)) - False - >>> timespan_1.stops_at_offset((0, 1)) - False - >>> timespan_1.stops_at_offset((5, 1)) - False - - """ - offset = _duration.Offset(offset) - return self.stop_offset == offset - - def stops_at_or_after_offset(self, offset) -> bool: - """ - Is true when timespan stops at or after ``offset``. - - .. container:: example - - >>> 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 - - """ - offset = _duration.Offset(offset) - return offset <= self.stop_offset - - def stops_before_offset(self, offset) -> bool: - """ - Is true when timespan stops before ``offset``. - - .. container:: example - - >>> timespan_1 = abjad.Timespan(0, 10) - - >>> timespan_1.stops_before_offset((-5, 1)) - False - >>> timespan_1.stops_before_offset((0, 1)) - False - >>> timespan_1.stops_before_offset((5, 1)) - False - - """ - offset = _duration.Offset(offset) - return self.stop_offset < offset - - def stops_before_or_at_offset(self, offset) -> bool: - """ - Is true when timespan stops before or at ``offset``. - - .. container:: example - - >>> 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 - - """ - offset = _duration.Offset(offset) - return self.stop_offset <= offset - - def stops_before_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan stops before ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_stop_offset < expr_start_offset - - def stops_before_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan stops before ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_stop_offset < expr_stop_offset - - def stops_during_timespan(self, timespan) -> bool: - """ - Is true when timespan stops during ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset < self_stop_offset - and self_stop_offset <= expr_stop_offset - ) - - def stops_when_timespan_starts(self, timespan) -> bool: - """ - Is true when timespan stops when ``timespan`` starts. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_stop_offset == expr_start_offset - - def stops_when_timespan_stops(self, timespan) -> bool: - """ - Is true when timespan stops when ``timespan`` stops. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return self_stop_offset == expr_stop_offset - def stretch(self, multiplier, anchor=None) -> "Timespan": """ Stretches timespan by ``multiplier`` relative to ``anchor``. @@ -2186,32 +1346,6 @@ def translate_offsets( self, start_offset=new_start_offset, stop_offset=new_stop_offset ) - def trisects_timespan(self, timespan) -> bool: - """ - Is true when timespan trisects ``timespan``. - - .. container:: example - - >>> 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 - - """ - self_start_offset, self_stop_offset = self.offsets - expr_start_offset, expr_stop_offset = self._get_offsets(timespan) - return ( - expr_start_offset < self_start_offset - and self_stop_offset < expr_stop_offset - ) - @dataclasses.dataclass(slots=True) class TimespanList(list): @@ -4030,7 +3164,7 @@ def get_timespan_that_satisfies_time_relation(self, time_relation): >>> abjad.show(timespans, scale=0.5) # doctest: +SKIP >>> timespan = abjad.Timespan(2, 5) - >>> time_relation = lambda _: _.starts_during_timespan(timespan) + >>> time_relation = lambda _: timespan.start_offset < _.start_offset < timespan.stop_offset >>> timespan = timespans.get_timespan_that_satisfies_time_relation( ... time_relation ... ) @@ -4072,7 +3206,7 @@ def get_timespans_that_satisfy_time_relation(self, time_relation) -> "TimespanLi >>> abjad.show(timespans, scale=0.5) # doctest: +SKIP >>> timespan = abjad.Timespan(2, 8) - >>> time_relation = lambda _: _.starts_during_timespan(timespan) + >>> time_relation = lambda _: timespan.start_offset < _.start_offset < timespan.stop_offset >>> timespans = timespans.get_timespans_that_satisfy_time_relation( ... time_relation) >>> abjad.show(timespans, range_=(0, 10), scale=0.5) # doctest: +SKIP @@ -4102,15 +3236,13 @@ def has_timespan_that_satisfies_time_relation(self, time_relation) -> bool: >>> abjad.show(timespans, scale=0.5) # doctest: +SKIP >>> timespan = abjad.Timespan(2, 8) - >>> time_relation = lambda _: _.starts_during_timespan(timespan) + >>> time_relation = lambda _: timespan.start_offset < _.start_offset < timespan.stop_offset >>> timespans.has_timespan_that_satisfies_time_relation(time_relation) True Is false when list does not have matching timespan: >>> timespan = abjad.Timespan(10, 20) - >>> time_relation = lambda _: _.starts_during_timespan(timespan) - >>> timespans.has_timespan_that_satisfies_time_relation(time_relation) False