Bend

The muspy.Bend class is a container for pitch-bend markings.

Attributes	Description	Type	Default
points	List of points that make up the bend	list of muspy.Point

class muspy.Bend(points)

A container for bends.

points

List of points that make up the bend.

Type:

List[muspy.Point]

adjust_time(func, attr=None, recursive=True)

Adjust the timing of time-stamped objects.

Parameters:

• func (callable) – The function used to compute the new timing from the old timing, i.e., new_time = func(old_time).

• attr (str, optional) – Attribute to adjust. Defaults to adjust all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

append(obj)

Append an object to the corresponding list.

This will automatically determine the list attributes to append based on the type of the object.

Parameters:

obj – Object to append.

copy()

Return a shallow copy of the object.

This is equivalent to copy.copy(self)().

Return type:

Shallow copy of the object.

deepcopy()

Return a deep copy of the object.

This is equivalent to copy.deepcopy(self)()

Return type:

Deep copy of the object.

extend(other, deepcopy=False)

Extend the list(s) with another object or iterable.

Parameters:

• other (muspy.ComplexBase or iterable) – If an object of the same type is given, extend the list attributes with the corresponding list attributes of the other object. If an iterable is given, call muspy.ComplexBase.append() for each item.

• deepcopy (bool, default: False) – Whether to make deep copies of the appended objects.

Return type:

Object itself.

fix_type(attr=None, recursive=True)

Fix the types of attributes.

Parameters:

• attr (str, optional) – Attribute to adjust. Defaults to adjust all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

classmethod from_dict(dict_, strict=False, cast=False)

Return an instance constructed from a dictionary.

Instantiate an object whose attributes and the corresponding values are given as a dictionary.

Parameters:

• dict (dict or mapping) – A dictionary that stores the attributes and their values as key-value pairs, e.g., {“attr1”: value1, “attr2”: value2}.

• strict (bool, default: False) – Whether to raise errors for invalid input types.

• cast (bool, default: False) – Whether to cast types.

Return type:

Constructed object.

is_valid(attr=None, recursive=True)

Return True if an attribute has a valid type and value.

This will recursively apply to an attribute’s attributes.

Parameters:

• attr (str, optional) – Attribute to validate. Defaults to validate all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Returns:

Whether the attribute has a valid type and value.

Return type:

bool

See also

muspy.Base.validate()

Raise an error if an attribute has an invalid type or value.

muspy.Base.is_valid_type()

Return True if an attribute is of a valid type.

is_valid_type(attr=None, recursive=True)

Return True if an attribute is of a valid type.

This will apply recursively to an attribute’s attributes.

Parameters:

• attr (str, optional) – Attribute to validate. Defaults to validate all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Returns:

Whether the attribute is of a valid type.

Return type:

bool

See also

muspy.Base.validate_type()

Raise an error if a certain attribute is of an invalid type.

muspy.Base.is_valid()

Return True if an attribute has a valid type and value.

pretty_str(skip_missing=True)

Return the attributes as a string in a YAML-like format.

Parameters:

skip_missing (bool, default: True) – Whether to skip attributes with value None or those that are empty lists.

Returns:

Stored data as a string in a YAML-like format.

Return type:

str

See also

muspy.Base.print()

Print the attributes in a YAML-like format.

print(skip_missing=True)

Print the attributes in a YAML-like format.

Parameters:

skip_missing (bool, default: True) – Whether to skip attributes with value None or those that are empty lists.

See also

muspy.Base.pretty_str()

Return the the attributes as a string in a YAML-like format.

remove_duplicate(attr=None, recursive=True)

Remove duplicate items from a list attribute.

Parameters:

• attr (str, optional) – Attribute to check. Defaults to check all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

remove_invalid(attr=None, recursive=True)

Remove invalid items from a list attribute.

Parameters:

• attr (str, optional) – Attribute to validate. Defaults to validate all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

sort(attr=None, recursive=True)

Sort a list attribute.

Parameters:

• attr (str, optional) – Attribute to sort. Defaults to sort all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

to_ordered_dict(skip_missing=True, deepcopy=True)

Return the object as an OrderedDict.

Return an ordered dictionary that stores the attributes and their values as key-value pairs.

Parameters:

• skip_missing (bool, default: True) – Whether to skip attributes with value None or those that are empty lists.

• deepcopy (bool, default: True) – Whether to make deep copies of the attributes.

Returns:

A dictionary that stores the attributes and their values as key-value pairs, e.g., {“attr1”: value1, “attr2”: value2}.

Return type:

OrderedDict

validate(attr=None, recursive=True)

Raise an error if an attribute has an invalid type or value.

This will apply recursively to an attribute’s attributes.

Parameters:

• attr (str, optional) – Attribute to validate. Defaults to validate all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

See also

muspy.Base.is_valid()

Return True if an attribute has a valid type and value.

muspy.Base.validate_type()

Raise an error if an attribute is of an invalid type.

validate_type(attr=None, recursive=True)

Raise an error if an attribute is of an invalid type.

This will apply recursively to an attribute’s attributes.

Parameters:

• attr (str, optional) – Attribute to validate. Defaults to validate all attributes.

• recursive (bool, default: True) – Whether to apply recursively.

Return type:

Object itself.

See also

muspy.Base.is_valid_type()

Return True if an attribute is of a valid type.

muspy.Base.validate()

Raise an error if an attribute has an invalid type or value.