maialib 1.6.1__cp310-cp310-musllinux_1_2_i686.whl → 1.7.1__cp310-cp310-musllinux_1_2_i686.whl

maialib/maiacore/maiacore.pyi

@@ -5,6 +5,9 @@ from __future__ import annotations
 import typing
 __all__ = ['Barline', 'C', 'Chord', 'Clef', 'ClefSign', 'F', 'G', 'HeapData', 'Helper', 'Interval', 'Key', 'Measure', 'Note', 'NoteData', 'NoteDataHeap', 'P', 'Part', 'RhythmFigure', 'Score', 'ScoreCollection', 'TimeSignature']
 class Barline:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     def __init__(self) -> None:
@@ -32,6 +35,9 @@ class Barline:
     def toXML(self, identSize: int = 2) -> str:
         ...
 class Chord:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __add__(self, arg0: Chord) -> Chord:
         ...
     def __eq__(self, arg0: Chord) -> bool:
@@ -322,6 +328,9 @@ class Chord:
     def transposeStackOnly(self, semiTonesNumber: int) -> None:
         ...
 class Clef:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     def __init__(self, sign: ClefSign = ..., line: int = -1) -> None:
@@ -355,6 +364,9 @@ class ClefSign:
     G: typing.ClassVar[ClefSign]  # value = <ClefSign.G: 0>
     P: typing.ClassVar[ClefSign]  # value = <ClefSign.P: 3>
     __members__: typing.ClassVar[dict[str, ClefSign]]  # value = {'G': <ClefSign.G: 0>, 'F': <ClefSign.F: 1>, 'C': <ClefSign.C: 2>, 'P': <ClefSign.P: 3>}
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __eq__(self, other: typing.Any) -> bool:
         ...
     def __getstate__(self) -> int:
@@ -382,9 +394,30 @@ class ClefSign:
     def value(self) -> int:
         ...
 class HeapData:
-    pass
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
 class Helper:
     @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
+    @staticmethod
+    @typing.overload
+    def calculateMelodyEuclideanSimilarity(melodyPattern: list[Note], otherMelody: list[Note]) -> float:
+        ...
+    @staticmethod
+    @typing.overload
+    def calculateMelodyEuclideanSimilarity(semitonesDifference: list[float]) -> float:
+        ...
+    @staticmethod
+    @typing.overload
+    def calculateRhythmicEuclideanSimilarity(rhythmPattern: list[Note], otherRhythm: list[Note]) -> float:
+        ...
+    @staticmethod
+    @typing.overload
+    def calculateRhythmicEuclideanSimilarity(durationDifferences: list[float]) -> float:
+        ...
+    @staticmethod
     def durationRatio(duration_A: float, duration_B: float) -> float:
         ...
     @staticmethod
@@ -400,9 +433,15 @@ class Helper:
     def frequencies2cents(freq_A: float, freq_B: float) -> int:
         ...
     @staticmethod
+    def getDurationDifferenceBetweenRhythms(referenceRhythm: list[Note], otherRhythm: list[Note]) -> list[float]:
+        ...
+    @staticmethod
     def getPercentiles(arg0: typing.Any, arg1: list[float]) -> typing.Any:
         ...
     @staticmethod
+    def getSemitonesDifferenceBetweenMelodies(referenceMelody: list[Note], otherMelody: list[Note]) -> list[float]:
+        ...
+    @staticmethod
     def isEnharmonic(arg0: str, arg1: str) -> bool:
         ...
     @staticmethod
@@ -459,6 +498,9 @@ class Helper:
     def transposePitch(pitch: str, semitones: int, accType: str = '#') -> str:
         ...
 class Interval:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     @typing.overload
@@ -475,6 +517,8 @@ class Interval:
         ...
     def getDiatonicSteps(self, useSingleOctave: bool = True, absoluteValue: bool = False) -> int:
         ...
+    def getDirection(self) -> str:
+        ...
     def getName(self) -> str:
         ...
     def getNotes(self) -> list[Note]:
@@ -634,6 +678,9 @@ class Interval:
     def toCents(self) -> int:
         ...
 class Key:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     @typing.overload
@@ -657,6 +704,9 @@ class Key:
     def setIsMajorMode(self, isMajorMode: bool) -> None:
         ...
 class Measure:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     def __init__(self, numStaves: int = 1, divisionsPerQuarterNote: int = 256) -> None:
@@ -828,6 +878,9 @@ class Measure:
     def toXML(self, instrumentId: int = 1, identSize: int = 2) -> str:
         ...
 class Note:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __eq__(self, arg0: Note) -> bool:
         ...
     def __ge__(self, arg0: Note) -> bool:
@@ -1017,6 +1070,9 @@ class Note:
     def transpose(self, semitones: int, accType: str = '') -> None:
         ...
 class NoteData:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     @typing.overload
     def __init__(self) -> None:
         ...
@@ -1024,8 +1080,13 @@ class NoteData:
     def __init__(self, note: Note, wasEnharmonized: bool, enharmonicDiatonicDistance: int) -> None:
         ...
 class NoteDataHeap:
-    pass
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
 class Part:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     def __init__(self, partName: str, numStaves: int = 1, isPitched: bool = True, divisionsPerQuarterNote: int = 256) -> None:
@@ -1052,6 +1113,8 @@ class Part:
     @typing.overload
     def getMeasure(self, measureId: int) -> Measure:
         ...
+    def getMeasures(self) -> list[Measure]:
+        ...
     def getMidiUnpitched(self) -> list[int]:
         ...
     def getName(self) -> str:
@@ -1141,6 +1204,9 @@ class RhythmFigure:
     QUARTER: typing.ClassVar[RhythmFigure]  # value = <RhythmFigure.QUARTER: 5>
     WHOLE: typing.ClassVar[RhythmFigure]  # value = <RhythmFigure.WHOLE: 3>
     __members__: typing.ClassVar[dict[str, RhythmFigure]]  # value = {'MAXIMA': <RhythmFigure.MAXIMA: 0>, 'LONG': <RhythmFigure.LONG: 1>, 'BREVE': <RhythmFigure.BREVE: 2>, 'WHOLE': <RhythmFigure.WHOLE: 3>, 'HALF': <RhythmFigure.HALF: 4>, 'QUARTER': <RhythmFigure.QUARTER: 5>, 'EIGHTH': <RhythmFigure.EIGHTH: 6>, 'N16TH': <RhythmFigure.N16TH: 7>, 'N32ND': <RhythmFigure.N32ND: 8>, 'N64TH': <RhythmFigure.N64TH: 9>, 'N128TH': <RhythmFigure.N128TH: 10>, 'N256TH': <RhythmFigure.N256TH: 11>, 'N512TH': <RhythmFigure.N512TH: 12>, 'N1024TH': <RhythmFigure.N1024TH: 13>}
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __eq__(self, other: typing.Any) -> bool:
         ...
     def __getstate__(self) -> int:
@@ -1168,6 +1234,9 @@ class RhythmFigure:
     def value(self) -> int:
         ...
 class Score:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __hash__(self) -> int:
         ...
     @typing.overload
@@ -1184,6 +1253,12 @@ class Score:
         ...
     def clear(self) -> None:
         ...
+    @typing.overload
+    def findMelodyPatternDataFrame(self, melodyPattern: list[Note], totalIntervalsSimilarityThreshold: float = 0.5, totalRhythmSimilarityThreshold: float = 0.5, intervalsSimilarityCallback: typing.Callable[[list[Note], list[Note]], list[float]] = None, rhythmSimilarityCallback: typing.Callable[[list[Note], list[Note]], list[float]] = None, totalIntervalSimilarityCallback: typing.Callable[[list[float]], float] = None, totalRhythmSimilarityCallback: typing.Callable[[list[float]], float] = None, totalSimilarityCallback: typing.Callable[[float, float], float] = None) -> typing.Any:
+        ...
+    @typing.overload
+    def findMelodyPatternDataFrame(self, melodyPatterns: list[list[Note]], intervalSimilarityThreshold: float = 0.5, rhythmSimilarityThreshold: float = 0.5, intervalsSimilarityCallback: typing.Callable[[list[Note], list[Note]], list[float]] = None, rhythmSimilarityCallback: typing.Callable[[list[Note], list[Note]], list[float]] = None, totalIntervalSimilarityCallback: typing.Callable[[list[float]], float] = None, totalRhythmSimilarityCallback: typing.Callable[[list[float]], float] = None, totalSimilarityCallback: typing.Callable[[float, float], float] = None) -> typing.Any:
+        ...
     def forEachNote(self, callback: typing.Callable[[Part, Measure, int, Note], None], measureStart: int = 0, measureEnd: int = -1, partNames: list[str] = []) -> None:
         ...
     def getChords(self, config: json = None) -> list[tuple[int, float, Key, Chord, bool]]:
@@ -1255,6 +1330,9 @@ class Score:
     def xPathCountNodes(self, xPath: str) -> int:
         ...
 class ScoreCollection:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __add__(self, arg0: ScoreCollection) -> ScoreCollection:
         ...
     def __hash__(self) -> int:
@@ -1301,6 +1379,9 @@ class ScoreCollection:
     def setDirectoriesPaths(self, directoriesPaths: list[str]) -> None:
         ...
 class TimeSignature:
+    @staticmethod
+    def _pybind11_conduit_v1_(*args, **kwargs):
+        ...
     def __init__(self, timeUpper: int = 4, timeLower: int = 4) -> None:
         ...
     def getLowerValue(self) -> int:
@@ -1317,4 +1398,4 @@ C: ClefSign  # value = <ClefSign.C: 2>
 F: ClefSign  # value = <ClefSign.F: 1>
 G: ClefSign  # value = <ClefSign.G: 0>
 P: ClefSign  # value = <ClefSign.P: 3>
-__version__: str = '"1.6.1"'
+__version__: str = '"1.7.1"'

maialib/maiapy/other.py

@@ -1,4 +1,5 @@
 import os
+import sys
 from enum import Enum
 import subprocess
 import maialib.maiacore as mc
@@ -102,7 +103,15 @@ def getSampleScorePath(sampleEnum: SampleScore) -> str:
         SampleScore.Strauss_Also_Sprach_Zarathustra: "Strauss_Also_Sprach_Zarathustra.mxl"
     }[sampleEnum]
 
-    xmlDir = pkg_resources.files("maialib").joinpath("xml-scores-examples")
+    # xmlDir = pkg_resources.files("maialib").joinpath("xml-scores-examples")
+    xmlDir = ""
+    if sys.version_info >= (3, 9):
+        from importlib import resources
+        xmlDir = resources.files("maialib").joinpath("xml-scores-examples")
+    else:
+        from importlib_resources import files
+        xmlDir = files("maialib").joinpath("xml-scores-examples")
+
     fileFullPath = os.path.join(xmlDir, xmlFileName)
     return str(fileFullPath)
 

maialib/maiapy/other.pyi

@@ -1,20 +1,79 @@
 import maialib.maiacore as mc
 from enum import Enum
 
-__all__ = ['getSampleScorePath', 'SampleScore', 'setScoreEditorApp', 'getScoreEditorApp', 'openScore', 'getXmlSamplesDirPath']
+def setScoreEditorApp(executableFullPath: str) -> None:
+    '''Set the full path to the installed score editor app
 
-def setScoreEditorApp(executableFullPath: str) -> None: ...
+    Args:
+       executableFullPath (str): Score editor full path
+       Example 01: "C:/path/to/MuseScore"
+       Example 02: "/Applications/MuseScore 4.app/Contents/MacOS/mscore"
+
+    Examples of use:
+
+    >>> import maialib as ml
+    >>> # Example for Windows:
+    >>> ml.setScoreEditorApp("C:/path/to/MuseScore.exe")
+    >>> # Example for Mac OSX:
+    >>> ml.setScoreEditorApp("/Applications/MuseScore 4.app/Contents/MacOS/mscore")
+    '''
 def getScoreEditorApp() -> str: ...
 def openScore(score: mc.Score) -> None: ...
 
 class SampleScore(Enum):
-    Bach_Cello_Suite_1 = 'Bach_Cello_Suite_1'
-    Beethoven_Symphony_5th = 'Beethoven_Symphony_5th'
-    Chopin_Fantasie_Impromptu = 'Chopin_Fantasie_Impromptu'
-    Dvorak_Symphony_9_mov_4 = 'Dvorak_Symphony_9_mov_4'
-    Mahler_Symphony_8_Finale = 'Mahler_Symphony_8_Finale'
-    Mozart_Requiem_Introitus = 'Mozart_Requiem_Introitus'
-    Strauss_Also_Sprach_Zarathustra = 'Strauss_Also_Sprach_Zarathustra'
-
-def getSampleScorePath(sampleEnum: SampleScore) -> str: ...
-def getXmlSamplesDirPath() -> str: ...
+    Bach_Cello_Suite_1: str
+    Beethoven_Symphony_5th: str
+    Chopin_Fantasie_Impromptu: str
+    Dvorak_Symphony_9_mov_4: str
+    Mahler_Symphony_8_Finale: str
+    Mozart_Requiem_Introitus: str
+    Strauss_Also_Sprach_Zarathustra: str
+
+def getSampleScorePath(sampleEnum: SampleScore) -> str:
+    """Get a maialib internal XML sample file
+
+    Args:
+       sampleEnum (SampleScore): Maialib SampleScore enum value
+           - Bach_Cello_Suite_1
+           - Beethoven_Symphony_5th
+           - Chopin_Fantasie_Impromptu
+           - Dvorak_Symphony_9_mov_4
+           - Mahler_Symphony_8_Finale
+           - Mozart_Requiem_Introitus
+           - Strauss_Also_Sprach_Zarathustra
+
+    Kwargs:
+       None
+
+    Returns:
+       A full file path (str) to the XML maialib internal sample score
+
+    Raises:
+       RuntimeError
+
+    Examples of use:
+
+    >>> import maialib as ml
+    >>> filePath = ml.getSampleScorePath(ml.SampleScore.Bach_Cello_Suite_1)
+    >>> score = ml.Score(filePath)
+    >>> score.info()
+    """
+def getXmlSamplesDirPath() -> str:
+    '''Get the maialib XML samples directory path
+
+    Kwargs:
+       None
+
+    Returns:
+       A full dir path (str) to the XML maialib internal samples score directory
+
+    Raises:
+       RuntimeError
+
+    Examples of use:
+
+    >>> import maialib as ml
+    >>> xmlDir = ml.getXmlSamplesDirPath()
+    >>> score = ml.Score(xmlDir + "Bach/cello_suite_1_violin.xml")
+    >>> score.info()
+    '''

maialib/maiapy/plots.pyi

@@ -2,9 +2,102 @@ import maialib.maiacore as mc
 import pandas as pd
 import plotly
 
-__all__ = ['plotPartsActivity', 'plotPianoRoll', 'plotScorePitchEnvelope', 'plotChordsNumberOfNotes']
+def plotPartsActivity(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]:
+    '''Plots a timeline graph showing the musical activity of each score instrument
 
-def plotPartsActivity(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]: ...
-def plotPianoRoll(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]: ...
-def plotScorePitchEnvelope(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]: ...
-def plotChordsNumberOfNotes(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]: ...
+    Args:
+       score (maialib.Score):  A maialib Score object loaded with a valid MusicXML file
+
+    Kwargs:
+       measureStart (int): Start measure to plot
+       measureEnd (int): End measure to plot
+       partNames (list): A str list that contains the filtered desired score parts to plot
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> plotPartsActivity(myScore)
+    >>> plotPartsActivity(myScore, measureStart=50)
+    >>> plotPartsActivity(myScore, measureStart=50, measureEnd=100)
+    >>> plotPartsActivity(myScore, measureStart=50, measureEnd=100, partNames=["Violin 1", "Cello"])
+    '''
+def plotPianoRoll(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]:
+    '''Plots a piano roll graph showing the musical activity of each score instrument
+
+    Args:
+       score (maialib.Score):  A maialib Score object loaded with a valid MusicXML file
+
+    Kwargs:
+       measureStart (int): Start measure to plot
+       measureEnd (int): End measure to plot
+       partNames (list): A str list that contains the filtered desired score parts to plot
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> plotPianoRoll(myScore)
+    >>> plotPianoRoll(myScore, measureStart=50)
+    >>> plotPianoRoll(myScore, measureStart=50, measureEnd=100)
+    >>> plotPianoRoll(myScore, measureStart=50, measureEnd=100, partNames=["Violin 1", "Cello"])
+    '''
+def plotScorePitchEnvelope(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]:
+    '''Plot a score pitch envelope
+
+    Args:
+       score (maialib.Score):  A maialib Score object loaded with a valid MusicXML file
+
+    Kwargs:
+       numPoints: (int): Number of interpolated points
+       showHigher (bool): Plot the envelop upper limit
+       showLower (bool): Plot the envelop lower limit
+       showMean (bool): Plot the envelop mean curve
+       showMeanOfExtremes (bool): Plot the envelop mean of extremes curve
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> myScore = ml.Score("/path/to/score.xml")
+    >>> plotScorePitchEnvelope(myScore)
+    >>> plotScorePitchEnvelope(myScore, numPoints=10)
+    >>> plotScorePitchEnvelope(myScore, showLower=False)
+    >>> plotScorePitchEnvelope(myScore, showMean=False, showMean=True)
+    '''
+def plotChordsNumberOfNotes(score: mc.Score, **kwargs) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]:
+    '''Plot chord number of notes varying in time
+
+    Args:
+       score (maialib.Score):  A maialib Score object loaded with a valid MusicXML file
+
+    Kwargs:
+       measureStart (int): Start measure to plot
+       measureEnd (int): End measure to plot
+       numPoints (int): Number of interpolated points
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> myScore = ml.Score("/path/to/score.xml")
+    >>> plotChordsNumberOfNotes(myScore)
+    >>> plotChordsNumberOfNotes(myScore, numPoints=15)
+    >>> plotChordsNumberOfNotes(myScore, measureStart=10, measureEnd=20)
+    '''

maialib/maiapy/sethares_dissonance.pyi

@@ -4,8 +4,68 @@ import plotly.graph_objects as go
 from maialib import maiacore as mc
 from typing import Callable
 
-__all__ = ['plotSetharesDissonanceCurve', 'plotScoreSetharesDissonance', 'plotChordDyadsSetharesDissonanceHeatmap']
+def plotSetharesDissonanceCurve(fundamentalFreq: float = 440, numPartials: int = 6, ratioLowLimit: float = 1.0, ratioHighLimit: float = 2.3, ratioStepIncrement: float = 0.001, amplCallback: Callable[[list[float]], list[float]] | None = None) -> tuple[go.Figure, pd.DataFrame]:
+    """
+    Compute the Sethares Dissonance Curve of a given base frequency
 
-def plotSetharesDissonanceCurve(fundamentalFreq: float = 440, numPartials: int = 6, ratioLowLimit: float = 1.0, ratioHighLimit: float = 2.3, ratioStepIncrement: float = 0.001, amplCallback: Callable[[list[float]], list[float]] | None = None) -> tuple[go.Figure, pd.DataFrame]: ...
-def plotScoreSetharesDissonance(score: mc.Score, plotType: str = 'line', lineShape: str = 'linear', numPartialsPerNote: int = 6, useMinModel: bool = True, amplCallback: Callable[[list[float]], list[float]] | None = None, dissCallback: Callable[[list[float]], float] | None = None, **kwargs) -> tuple[go.Figure, pd.DataFrame]: ...
-def plotChordDyadsSetharesDissonanceHeatmap(chord: mc.Chord, numPartialsPerNote: int = 6, useMinModel: bool = True, amplCallback: Callable[[list[float]], list[float]] | None = None, dissonanceThreshold: float = 0.1, dissonanceDecimalPoint: int = 2) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]: ...
+    Return
+        A tuple that contains a Plotly figure, and the pair 'ratios' and 'dissonance' lists
+    """
+def plotScoreSetharesDissonance(score: mc.Score, plotType: str = 'line', lineShape: str = 'linear', numPartialsPerNote: int = 6, useMinModel: bool = True, amplCallback: Callable[[list[float]], list[float]] | None = None, dissCallback: Callable[[list[float]], float] | None = None, **kwargs) -> tuple[go.Figure, pd.DataFrame]:
+    '''Plot 2D line graph of the Sethares Dissonance over time
+
+    Args:
+       score (maialib.Score): A maialib Score object loaded with a valid MusicXML file
+       plotType (str): Can be \'line\' or \'scatter\'
+       lineShape (str): Can be \'linear\' or \'spline\'
+       numPartialsPerNote (int): Amount of spectral partials for each note
+       useMinModel (bool): Sethares dissonance values can be computed using the \'minimal amplitude\' model
+                    or the \'product amplitudes\' model. The \'min\' model is a more recent approach
+       amplCallback: Custom user function callback to generate the amplitude of each spectrum partial
+       dissCallback: Custom user function callback to receive all paired partial dissonances and computes 
+                     a single total dissonance value output
+    Kwargs:
+       measureStart (int): Start measure to plot
+       measureEnd (int): End measure to plot
+       numPoints (int): Number of interpolated points
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> myScore = ml.Score("/path/to/score.xml")
+    >>> ml.plotScoreSetharesDissonance(myScore)
+    >>> ml.plotScoreSetharesDissonance(myScore, numPoints=15)
+    >>> ml.plotScoreSetharesDissonance(myScore, measureStart=10, measureEnd=20)
+    '''
+def plotChordDyadsSetharesDissonanceHeatmap(chord: mc.Chord, numPartialsPerNote: int = 6, useMinModel: bool = True, amplCallback: Callable[[list[float]], list[float]] | None = None, dissonanceThreshold: float = 0.1, dissonanceDecimalPoint: int = 2) -> tuple[plotly.graph_objs._figure.Figure, pd.DataFrame]:
+    '''Plot chord dyads Sethares dissonance heatmap
+
+    Args:
+       chord (maialib.Chord):  A maialib Chord
+
+    Kwargs:
+       numPartialsPerNote (int): Amount of spectral partials for each note
+       useMinModel (bool): Sethares dissonance values can be computed using the \'minimal amplitude\' model
+                    or the \'product amplitudes\' model. The \'min\' model is a more recent approach
+       amplCallback: Custom user function callback to generate the amplitude of each spectrum partial
+       dissonanceThreshold (float): Dissonance threshold to skip small dissonance values
+       dissonanceDecimalPoint (int): Round chord dissonance value in the plot title
+
+    Returns:
+       A list: [Plotly Figure, The plot data as a Pandas Dataframe]
+
+    Raises:
+       RuntimeError, KeyError
+
+    Examples of use:
+
+    >>> import maialib as ml
+    >>> myChord = ml.Chord(["C3", "E3", "G3"])
+    >>> fig, df = plotChordDyadsSetharesDissonanceHeatmap(myChord)
+    >>> fig.show()
+    '''

{maialib-1.6.1.dist-info → maialib-1.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maialib
-Version: 1.6.1
+Version: 1.7.1
 Summary: A C++/Python library to manipulate sheet music data
 Home-page: https://github.com/nyckmaia/maialib
 Author: Nycholas Maia

{maialib-1.6.1.dist-info → maialib-1.7.1.dist-info}/RECORD

@@ -1,28 +1,28 @@
-maialib.libs/libstdc++-d2a021ba.so.6.0.32,sha256=1zr_iwGwEBe95gyKdgiw7C4Y1RR9ijV40j66rk4elzg,3537349
-maialib.libs/libgcc_s-f3fb5a36.so.1,sha256=SrjjCCuY7RHj-T9JLrY9XFMgCCpYD9Qmezr4uoJGVEQ,168321
-maialib-1.6.1.dist-info/RECORD,,
-maialib-1.6.1.dist-info/WHEEL,sha256=65TL7weo8kkgwEa4wF9uXAGMNyj2mu46h4HGOyuAzms,110
-maialib-1.6.1.dist-info/top_level.txt,sha256=sZWQaa-Up2ba00WpAxBhOLKM6qQYTpUKJMXgSE0Nc48,17
-maialib-1.6.1.dist-info/LICENSE.txt,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
-maialib-1.6.1.dist-info/METADATA,sha256=dnJv1NuCDKbjtn4NrsOrV78tXnuqADoSHmHknU8tUr4,6926
-maialib/__init__.py,sha256=qiIEL1ZDvpDK0bkGUdZRib3bG973EtKQDFYPFfvJKQA,122
+maialib-1.7.1.dist-info/top_level.txt,sha256=sZWQaa-Up2ba00WpAxBhOLKM6qQYTpUKJMXgSE0Nc48,17
+maialib-1.7.1.dist-info/RECORD,,
+maialib-1.7.1.dist-info/LICENSE.txt,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+maialib-1.7.1.dist-info/METADATA,sha256=YMcaVW1wyLigMx1hVgrONs_PhIOF8_ItN1J9Vt5hJYU,6926
+maialib-1.7.1.dist-info/WHEEL,sha256=z9pRu9iuo6pg7rkRiXSjLaWIdpFOYscQWpXbJJogsTM,110
 maialib/setup.py,sha256=1Cbv0DfEUNK1EQHb64-1B0rwbRrsTSnJBY8fVn8gtbU,2168
-maialib/xml-scores-examples/Mozart_Requiem_Introitus.mxl,sha256=_wc4hMaPhtgocUoL94uVzfVN3TGb08z8Xa2BL4SHfgA,91112
-maialib/xml-scores-examples/Strauss_Also_Sprach_Zarathustra.mxl,sha256=nOQra05RHHDe_dXFs5WBJG2l9R1KQk64urV7lWYC2vw,18863
-maialib/xml-scores-examples/Mahler_Symphony_8_Finale.mxl,sha256=F2-QBKNYjBv_sWT-z4LWi1rX84-P3msxtl-g6joA2FQ,229034
-maialib/xml-scores-examples/Bach_Cello_Suite_1.mxl,sha256=0XGNlcW8o0W7kkeG8j2V_M4eggdOnrxvvvCkpf6x_z4,29622
+maialib/__init__.py,sha256=qiIEL1ZDvpDK0bkGUdZRib3bG973EtKQDFYPFfvJKQA,122
+maialib/maiacore/maiacore.pyi,sha256=VP-QsvidFYf4nRU_WTLSVGtwhhSOmYhqUZQv5Yer0tQ,46920
+maialib/maiacore/maiacore.cpython-310-i386-linux-gnu.so,sha256=bL0DJpvZ7UEykvDfamvGqZ3Lrvifv_qjM1TpD0Eidcw,5381497
+maialib/maiacore/__init__.py,sha256=IW7E0LuzAttsn0b37SEthCA0LKuzSgkepSpq8DWExYQ,77
+maialib/maiacore/__init__.pyi,sha256=cJfflEKHJ6BPUTlDQt95xZmi2N3zwHJkHEXy27fBd5c,1282
+maialib/maiapy/sethares_dissonance.pyi,sha256=O8D_cYRPCE1K5Zw54ckg3I5frULcBGgs_di_bTOpuBU,3609
+maialib/maiapy/plots.py,sha256=laAt68-IiZ4vNLFPKcGCf4IcMDIIZ1uavJpROrS8tqs,23153
+maialib/maiapy/__init__.py,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
+maialib/maiapy/sethares_dissonance.py,sha256=uRQLTQN55dk74hIFpzu9RlTWP0ZhRpVT3yTLI-su1ww,12830
+maialib/maiapy/other.py,sha256=4LjETHcpDpNRjSYIbMW_9CuRZTymuoAzog_L3CkYDA0,4345
+maialib/maiapy/other.pyi,sha256=jEmAc-MDc3iMA2-5hp41RLgNrfBQRMvq-sF2_pexhbo,2163
+maialib/maiapy/__init__.pyi,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
+maialib/maiapy/plots.pyi,sha256=nRNUQ9h9kjJHTdbQt4eXv933MOx7TIztIg-inThglB4,3620
 maialib/xml-scores-examples/Chopin_Fantasie_Impromptu.mxl,sha256=HkouQ_4bI6XDoGmzJITuU81CzQZE2lQjwl6WNlfZmJA,35727
+maialib/xml-scores-examples/Bach_Cello_Suite_1.mxl,sha256=0XGNlcW8o0W7kkeG8j2V_M4eggdOnrxvvvCkpf6x_z4,29622
 maialib/xml-scores-examples/Dvorak_Symphony_9_mov_4.mxl,sha256=s7FGUEmFmgcIdmkZ-bv4sOGGj5HYKc2nc760V79DMtM,261438
+maialib/xml-scores-examples/Mahler_Symphony_8_Finale.mxl,sha256=F2-QBKNYjBv_sWT-z4LWi1rX84-P3msxtl-g6joA2FQ,229034
+maialib/xml-scores-examples/Mozart_Requiem_Introitus.mxl,sha256=_wc4hMaPhtgocUoL94uVzfVN3TGb08z8Xa2BL4SHfgA,91112
+maialib/xml-scores-examples/Strauss_Also_Sprach_Zarathustra.mxl,sha256=nOQra05RHHDe_dXFs5WBJG2l9R1KQk64urV7lWYC2vw,18863
 maialib/xml-scores-examples/Beethoven_Symphony_5_mov_1.xml,sha256=iZ2uqqHWMkDtmQVKovT-H_-zZp1SixASi1R7L3TmuOI,4775525
-maialib/maiapy/other.pyi,sha256=KmvytsOd9WJpb7VPXJE76tIvTqb2C1MZtrGScy6RYTE,851
-maialib/maiapy/__init__.pyi,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
-maialib/maiapy/sethares_dissonance.pyi,sha256=DMZtrHTGSAaJwcBWX_G-sHF15_eETp1OeRr2L5vwdF0,1171
-maialib/maiapy/other.py,sha256=5o2zXcm1quM-9jfUhzzzuKrj2qTBaNheA6Z05Ux9H_g,4042
-maialib/maiapy/plots.py,sha256=laAt68-IiZ4vNLFPKcGCf4IcMDIIZ1uavJpROrS8tqs,23153
-maialib/maiapy/plots.pyi,sha256=7zchTew8-uvIvo0TmJXRd_SRlIX9w1AyOSplbL5YGNM,619
-maialib/maiapy/sethares_dissonance.py,sha256=uRQLTQN55dk74hIFpzu9RlTWP0ZhRpVT3yTLI-su1ww,12830
-maialib/maiapy/__init__.py,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
-maialib/maiacore/__init__.pyi,sha256=cJfflEKHJ6BPUTlDQt95xZmi2N3zwHJkHEXy27fBd5c,1282
-maialib/maiacore/__init__.py,sha256=IW7E0LuzAttsn0b37SEthCA0LKuzSgkepSpq8DWExYQ,77
-maialib/maiacore/maiacore.pyi,sha256=IoVUJYogP4VGrxvj3RcCe-AXMQ2MHWhP0x-bPVQsMrY,43395
-maialib/maiacore/maiacore.cpython-310-i386-linux-gnu.so,sha256=LpsL8T_O98giuN-S10zcdRtHQHJZTxBVbTY6tTywjlA,5282253
+maialib.libs/libstdc++-d2a021ba.so.6.0.32,sha256=1zr_iwGwEBe95gyKdgiw7C4Y1RR9ijV40j66rk4elzg,3537349
+maialib.libs/libgcc_s-f3fb5a36.so.1,sha256=SrjjCCuY7RHj-T9JLrY9XFMgCCpYD9Qmezr4uoJGVEQ,168321

{maialib-1.6.1.dist-info → maialib-1.7.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.2.0)
+Generator: setuptools (75.3.0)
 Root-Is-Purelib: false
 Tag: cp310-cp310-musllinux_1_2_i686