qevents

Abstract Classes

QEvent

Abstract Q-event.

abstract class nauert.qevents.QEvent(offset: Offset = Offset(Fraction(0, 1)), index: int | None = None, attachments: Iterable = ())[source]

Abstract Q-event.

Represents an attack point to be quantized.

All QEvents possess a rational offset in milliseconds, and an optional index for disambiguating events which fall on the same offset in a QGrid.

Attributes Summary

`__lt__`	Is true when epxr is a q-event with offset greater than that of this q-event.
`__repr__`	Gets repr.
`attachments`	The attachments of the QEvent.
`from_offset_pitches_attachments`
`index`	The optional index, for sorting QEvents with identical offsets.
`offset`	The offset in milliseconds of the event.

Special methods

overridden __lt__(argument) → bool[source]: Is true when epxr is a q-event with offset greater than that of this q-event. Otherwise false.

overridden __repr__() → str[source]: Gets repr.

Methods

offset() → Offset[source]: The offset in milliseconds of the event.

Class & static methods

classmethod from_offset_pitches_attachments(offset: Offset, pitches, attachments) → QEvent[source]

Read-only properties

attachments: The attachments of the QEvent.

index: The optional index, for sorting QEvents with identical offsets.

Classes

`PitchedQEvent`	Pitched q-event.
`SilentQEvent`	Silent q-event.
`TerminalQEvent`	Terminal q-event.

class nauert.qevents.PitchedQEvent(offset: Offset = Offset(Fraction(0, 1)), pitches: Iterable[int | float] = (), attachments: Iterable = (), index: int | None = None)[source]

Pitched q-event.

Indicates the onset of a period of pitched material in a q-event sequence.

>>> pitches = [0, 1, 4]
>>> nauert.PitchedQEvent(abjad.duration.offset(1000), pitches)
PitchedQEvent(offset=Offset(Fraction(1000, 1)), pitches=(NamedPitch("c'"), NamedPitch("cs'"), NamedPitch("e'")), index=None, attachments=())

Attributes Summary

`__eq__`	Is true when argument is a pitched q-event with offset, pitches, attachments and index equal to those of this pitched q-event.
`__hash__`	Hashes pitched q-event.
`__repr__`	Gets repr.
`attachments`	Gets attachments of pitched q-event.
`pitches`	Gets pitches of pitched q-event.

Special methods

overridden __eq__(argument) → bool[source]: Is true when argument is a pitched q-event with offset, pitches, attachments and index equal to those of this pitched q-event. Otherwise false.

overridden __hash__() → int[source]

Hashes pitched q-event.

Required to be explicitly redefined on Python 3 if __eq__ changes.

(QEvent).__lt__(argument) → bool: Is true when epxr is a q-event with offset greater than that of this q-event. Otherwise false.

overridden __repr__() → str[source]: Gets repr.

Methods

(QEvent).offset() → Offset: The offset in milliseconds of the event.

Class & static methods

classmethod (QEvent).from_offset_pitches_attachments(offset: Offset, pitches, attachments) → QEvent

Read-only properties

overridden attachments: Gets attachments of pitched q-event.

(QEvent).index: The optional index, for sorting QEvents with identical offsets.

pitches: Gets pitches of pitched q-event.

class nauert.qevents.SilentQEvent(offset: Offset = Offset(Fraction(0, 1)), attachments: Iterable = (), index: int | None = None)[source]

Silent q-event.

>>> q_event = nauert.SilentQEvent(abjad.duration.offset(1000))
>>> q_event
SilentQEvent(offset=Offset(Fraction(1000, 1)), index=None, attachments=())

Attributes Summary

`__eq__`	Is true when argument is a silent q-event with offset, attachments and index equal to those of this silent q-event.
`__hash__`	Hashes silent q-event.
`attachments`	Gets attachments of silent q-event.

Special methods

overridden __eq__(argument) → bool[source]: Is true when argument is a silent q-event with offset, attachments and index equal to those of this silent q-event. Otherwise false.

overridden __hash__() → int[source]

Hashes silent q-event.

Required to be explicitly redefined on Python 3 if __eq__ changes.

(QEvent).__lt__(argument) → bool: Is true when epxr is a q-event with offset greater than that of this q-event. Otherwise false.

(QEvent).__repr__() → str: Gets repr.

Methods

(QEvent).offset() → Offset: The offset in milliseconds of the event.

Class & static methods

classmethod (QEvent).from_offset_pitches_attachments(offset: Offset, pitches, attachments) → QEvent

Read-only properties

overridden attachments: Gets attachments of silent q-event.

(QEvent).index: The optional index, for sorting QEvents with identical offsets.

class nauert.qevents.TerminalQEvent(offset: Offset = Offset(Fraction(0, 1)))[source]

Terminal q-event.

>>> nauert.TerminalQEvent(abjad.duration.offset(1000))
TerminalQEvent(offset=Offset(Fraction(1000, 1)), index=None, attachments=())

Carries no significance outside the context of a QEventSequence.

Attributes Summary

`__eq__`	Is true when argument is a terminal q-event with offset equal to that of this terminal q-event.
`__hash__`	Hashes terminal q-event.

Special methods

overridden __eq__(argument) → bool[source]: Is true when argument is a terminal q-event with offset equal to that of this terminal q-event. Otherwise false.

overridden __hash__() → int[source]

Hashes terminal q-event.

Required to be explicitly redefined on Python 3 if __eq__ changes.

(QEvent).__lt__(argument) → bool: Is true when epxr is a q-event with offset greater than that of this q-event. Otherwise false.

(QEvent).__repr__() → str: Gets repr.

Methods

(QEvent).offset() → Offset: The offset in milliseconds of the event.

Class & static methods

classmethod (QEvent).from_offset_pitches_attachments(offset: Offset, pitches, attachments) → QEvent

Read-only properties

(QEvent).attachments: The attachments of the QEvent.

(QEvent).index: The optional index, for sorting QEvents with identical offsets.