def __sub__(self, timespan): r'''Subtract `timespan` from start-positioned rhythm payload expression. Example 1. Subtract from left: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(0, Offset(1, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ d'8 e'8 f'8 }" ), start_offset=durationtools.Offset(1, 8), ), ] ) Example 2. Subtract from right: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(3, 8), 100) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 d'8 e'8 }" ), start_offset=durationtools.Offset(0, 1), ), ] ) Example 3. Subtract from middle: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan( ... Offset(1, 8), Offset(3, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 }" ), start_offset=durationtools.Offset(0, 1), ), musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ f'8 }" ), start_offset=durationtools.Offset(3, 8), ), ] ) Example 4. Subtract nothing: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(100, 200) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 d'8 e'8 f'8 }" ), start_offset=durationtools.Offset(0, 1), ), ] ) Operates in place and returns timespan inventory. ''' return StartPositionedPayloadExpression.__sub__(self, timespan)
def __sub__(self, timespan): r'''Subtract `timespan` from start-positioned division payload expression. Example 1. Subtract from left: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(0, Offset(1, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(5, 8), durationtools.Division(6, 8), durationtools.Division(3, 4), ], start_offset=durationtools.Offset(1, 8), ), start_offset=durationtools.Offset(1, 8), ), ] ) Example 2. Subtract from right: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(17, 8), 100) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(6, 8), durationtools.Division(6, 8), durationtools.Division(5, 8), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), ] ) Example 3. Subtract from middle: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(1, 8), Offset(17, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(1, 8), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(1, 8), ], start_offset=durationtools.Offset(17, 8), ), start_offset=durationtools.Offset(17, 8), ), ] ) Example 4. Subtract from nothing: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(100, 200) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(6, 8), durationtools.Division(6, 8), durationtools.Division(3, 4), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), ] ) Operates in place and returns timespan inventory. ''' return StartPositionedPayloadExpression.__sub__(self, timespan)
def __sub__(self, timespan): r'''Subtract `timespan` from start-positioned division payload expression. Example 1. Subtract from left: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(0, Offset(1, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(5, 8), durationtools.Division(6, 8), durationtools.Division(3, 4), ], start_offset=durationtools.Offset(1, 8), ), start_offset=durationtools.Offset(1, 8), ), ] ) Example 2. Subtract from right: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(17, 8), 100) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(6, 8), durationtools.Division(6, 8), durationtools.Division(5, 8), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), ] ) Example 3. Subtract from middle: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(1, 8), Offset(17, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(1, 8), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(1, 8), ], start_offset=durationtools.Offset(17, 8), ), start_offset=durationtools.Offset(17, 8), ), ] ) Example 4. Subtract from nothing: :: >>> payload = [(6, 8), (6, 8), (3, 4)] >>> expression = musicexpressiontools.StartPositionedDivisionPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(100, 200) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedDivisionPayloadExpression( payload=musicexpressiontools.DivisionList( [ durationtools.Division(6, 8), durationtools.Division(6, 8), durationtools.Division(3, 4), ], start_offset=durationtools.Offset(0, 1), ), start_offset=durationtools.Offset(0, 1), ), ] ) Operates in place and returns timespan inventory. ''' return StartPositionedPayloadExpression.__sub__(self, timespan)
def __sub__(self, timespan): r'''Subtract `timespan` from start-positioned rhythm payload expression. Example 1. Subtract from left: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(0, Offset(1, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ d'8 e'8 f'8 }" ), start_offset=durationtools.Offset(1, 8), ), ] ) Example 2. Subtract from right: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(Offset(3, 8), 100) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 d'8 e'8 }" ), start_offset=durationtools.Offset(0, 1), ), ] ) Example 3. Subtract from middle: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan( ... Offset(1, 8), Offset(3, 8)) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 }" ), start_offset=durationtools.Offset(0, 1), ), musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ f'8 }" ), start_offset=durationtools.Offset(3, 8), ), ] ) Example 4. Subtract nothing: :: >>> payload = [Container("c'8 d'8 e'8 f'8")] >>> expression = \ ... musicexpressiontools.StartPositionedRhythmPayloadExpression( ... payload, Offset(0)) >>> result = expression - timespantools.Timespan(100, 200) :: >>> print(format(result)) timespantools.TimespanInventory( [ musicexpressiontools.StartPositionedRhythmPayloadExpression( payload=scoretools.Container( "{ c'8 d'8 e'8 f'8 }" ), start_offset=durationtools.Offset(0, 1), ), ] ) Operates in place and returns timespan inventory. ''' return StartPositionedPayloadExpression.__sub__(self, timespan)