points

Shapes that are composed of points.

Classes

DotsGrid(dataset)	Class representing a 3x3 grid of dots.
DownParabola(dataset)	Class for the down parabola shape.
Heart(dataset)	Class for the heart shape.
LeftParabola(dataset)	Class for the left parabola shape.
RightParabola(dataset)	Class for the right parabola shape.
Scatter(dataset)	Class for the scatter shape: a cloud of randomly-scattered points.
UpParabola(dataset)	Class for the up parabola shape.

class data_morph.shapes.points.DotsGrid(dataset: Dataset)

Bases: PointCollection

Class representing a 3x3 grid of dots.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.DownParabola(dataset: Dataset)

Bases: PointCollection

Class for the down parabola shape.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.Heart(dataset: Dataset)

Bases: PointCollection

Class for the heart shape.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

Notes

The formula for the heart shape is inspired by Heart Curve:

Weisstein, Eric W. “Heart Curve.” From MathWorld –A Wolfram Web Resource. https://mathworld.wolfram.com/HeartCurve.html

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.LeftParabola(dataset: Dataset)

Bases: PointCollection

Class for the left parabola shape.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.RightParabola(dataset: Dataset)

Bases: PointCollection

Class for the right parabola shape.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.Scatter(dataset: Dataset)

Bases: PointCollection

Class for the scatter shape: a cloud of randomly-scattered points.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → int

No-op that allows returns 0 so that all perturbations are accepted.

Parameters:

• x (int or float) – Coordinates of a point in 2D space.

• y (int or float) – Coordinates of a point in 2D space.

Returns:

Always returns 0 to allow for scattering of the points.

Return type:

int

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray

class data_morph.shapes.points.UpParabola(dataset: Dataset)

Bases: PointCollection

Class for the up parabola shape.

This shape is generated using the panda dataset.

Parameters:

dataset (Dataset) – The starting dataset to morph into other shapes.

distance(x: Number, y: Number) → float

Calculate the minimum distance from the points of this shape to a point (x, y).

Parameters:

• x (numbers.Number) – Coordinates of a point in 2D space.

• y (numbers.Number) – Coordinates of a point in 2D space.

Returns:

The minimum distance from the points of this shape to the point (x, y).

Return type:

float

plot(ax: Axes = None) → Axes

Plot the shape.

Parameters:

ax (matplotlib.axes.Axes, optional) – An optional Axes object to plot on.

Returns:

The Axes object containing the plot.

Return type:

matplotlib.axes.Axes

points

An array of (x, y) values representing an arrangement of points.

Type:

numpy.ndarray