numdaplot 0.1.0__py3-none-any.whl

numdaplot/plots/charts/color_scale.py

@@ -0,0 +1,147 @@
+"""
+Color scales of a HeatmapChart and of a ScatterChart.
+
+.. versionadded:: 0.1.0
+"""
+
+from enum import Enum, auto
+
+
+class ColorScale(Enum):
+	"""
+	Color scales of a ``HeatmapChart`` and of a ``ScatterChart``, from the smallest value to the largest one.
+
+	.. versionadded:: 0.1.0
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.BLUES)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	VIRIDIS = auto()
+	"""
+	From dark purple for the smallest values to yellow for the largest. Default value.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.VIRIDIS)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	BLUES = auto()
+	"""
+	From white for the smallest values to dark blue for the largest.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.BLUES)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	REDS = auto()
+	"""
+	From white for the smallest values to dark red for the largest.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.REDS)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	RED_BLUE = auto()
+	"""
+	From blue for the smallest values to red for the largest, through white. When the values are on both
+	sides of 0, the scale is centered on 0, so white means 0.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([1.5, -2.0, 0.5])
+	>>> february = ndp.Array.from_list([-0.5, 1.0, 2.5])
+	>>> march = ndp.Array.from_list([-3.0, 0.5, 1.0])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.RED_BLUE)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	GREENS = auto()
+	"""
+	From white for the smallest values to dark green for the largest.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.GREENS)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	GRAYS = auto()
+	"""
+	From white for the smallest values to black for the largest, for a printing in black and white.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.GRAYS)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	CIVIDIS = auto()
+	"""
+	From dark blue for the smallest values to yellow for the largest, readable with most forms of color blindness.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", scale=ndp.ColorScale.CIVIDIS)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""

numdaplot/plots/charts/heatmap_chart.py

@@ -0,0 +1,92 @@
+"""
+Chart coloring each value of a grid of numbers.
+
+.. versionadded:: 0.1.0
+"""
+
+from dataclasses import dataclass
+
+from numdaplot.plots.charts.cell_values import CellValues
+from numdaplot.plots.charts.chart import Chart
+from numdaplot.plots.charts.chart_settings import copy_columns
+from numdaplot.plots.charts.color_scale import ColorScale
+from numdaplot.settings.field_types import require_field_types
+from numdaplot.tables.columns.column_names import require_optional_column_name
+
+
+@dataclass(frozen=True)
+class HeatmapChart(Chart):
+	"""
+	Chart drawing each value as a cell colored along a color scale, used by ``Plot.heatmap``.
+
+	The columns are side by side and the rows go down from the first one. A color bar next to the cells shows
+	the scale. A missing value leaves its cell light gray.
+
+	.. versionadded:: 0.1.0
+
+	Parameters
+	----------
+	columns
+		For a Table, the columns drawn, holding numbers. A Table needs it, even for a single column. An Array of one or
+		two dimensions takes none: when omitted, each of its columns is drawn.
+	labels
+		For a Table, the column labeling the rows: numbers, dates, datetimes, times of day (labeled ``HH:MM``), texts or
+		booleans, the row numbers when omitted. A row whose label text is missing is left out. An Array takes none, its
+		rows being numbered.
+	scale
+		The colors of the cells, ``ColorScale.VIRIDIS`` by default.
+	values
+		Whether each cell shows its value, ``CellValues.HIDDEN`` by default.
+
+	Raises
+	------
+	InvalidTypeError
+		When a setting is not of the type its annotation names.
+	InvalidColumnNameError
+		When ``labels`` or a name in ``columns`` is an empty text.
+	EmptyListError
+		When ``columns`` is an empty list.
+	DuplicateColumnError
+		When a column name appears twice in ``columns``.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Pau"])
+	>>> january = ndp.Array.from_list([5.5, 3.0, 8.0])
+	>>> february = ndp.Array.from_list([6.0, 4.5, 9.0])
+	>>> march = ndp.Array.from_list([9.5, 8.0, 11.5])
+	>>> temperatures = ndp.Table.from_arrays({"city": cities, "jan": january, "feb": february, "mar": march})
+	>>> chart = ndp.HeatmapChart(columns=["jan", "feb", "mar"], labels="city", values=ndp.CellValues.SHOWN)
+	>>> plot = ndp.Plot.heatmap(temperatures, chart)
+	>>> plot.show()
+	"""
+
+	columns: list[str] | None = None
+	labels: str | None = None
+	scale: ColorScale = ColorScale.VIRIDIS
+	values: CellValues = CellValues.HIDDEN
+
+	def __post_init__(self) -> None:
+		"""
+		Check the columns and replace them with a copy that only the chart holds.
+
+		.. versionadded:: 0.1.0
+
+		Raises
+		------
+		InvalidTypeError
+			When a setting is not of the type its annotation names.
+		InvalidColumnNameError
+			When ``labels`` or a name in ``columns`` is an empty text.
+		EmptyListError
+			When ``columns`` is an empty list.
+		DuplicateColumnError
+			When a column name appears twice in ``columns``.
+		"""
+		require_field_types(self)
+
+		require_optional_column_name(self.labels)
+
+		columns_copy = copy_columns(self.columns)
+		object.__setattr__(self, "columns", columns_copy)

numdaplot/plots/charts/histogram_chart.py

@@ -0,0 +1,93 @@
+"""
+Chart counting the values of each bin.
+
+.. versionadded:: 0.1.0
+"""
+
+from collections.abc import Sequence
+from dataclasses import dataclass
+
+from numdaplot.plots.charts.bin_count import BinCount
+from numdaplot.plots.charts.bin_width import BinWidth
+from numdaplot.plots.charts.chart import Chart
+from numdaplot.plots.charts.chart_settings import copy_colors, copy_columns
+from numdaplot.plots.style.color import Color
+from numdaplot.plots.style.custom_color import CustomColor
+from numdaplot.ratios.measure import Measure
+from numdaplot.settings.field_types import require_field_types
+
+
+@dataclass(frozen=True)
+class HistogramChart(Chart):
+	"""
+	Chart drawing how many values of each column fall in each bin, used by ``Plot.histogram``.
+
+	Several columns share the same bins and are drawn over each other, half transparent. Missing values are
+	left out.
+
+	.. versionadded:: 0.1.0
+
+	Parameters
+	----------
+	columns
+		For a Table, the columns drawn, holding numbers or times of day, not both. A Table needs it, even for a
+		single column. An Array takes none: when omitted, each of its columns is drawn.
+	bins
+		The bins, ``BinCount(10)`` for numbers and one bin per hour from 00:00 to 24:00 for times of day when
+		omitted, or ``BinWidth`` for bins of a given width: a number for numbers, a duration for times of day.
+	measure
+		``Measure.COUNT`` by default for the number of values of each bin, ``Measure.RATIO`` for their share
+		of the values of the column.
+	colors
+		One color per column, the colors of the default cycle when omitted. The chart keeps its own list.
+
+	Raises
+	------
+	InvalidTypeError
+		When a setting is not of the type its annotation names.
+	InvalidColumnNameError
+		When a name in ``columns`` is an empty text.
+	EmptyListError
+		When ``columns`` or ``colors`` is an empty list.
+	DuplicateColumnError
+		When a column name appears twice in ``columns``.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices_2025 = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0, 13.5, 16.0, 14.5, 15.0])
+	>>> prices_2026 = ndp.Array.from_list([14.0, 17.5, 16.0, 19.0, 15.5, 18.0, 16.5, 17.0])
+	>>> prices = ndp.Table.from_arrays({"2025": prices_2025, "2026": prices_2026})
+	>>> chart = ndp.HistogramChart(columns=["2025", "2026"], bins=ndp.BinWidth(1.0))
+	>>> plot = ndp.Plot.histogram(prices, chart)
+	>>> plot.show()
+	"""
+
+	columns: list[str] | None = None
+	bins: BinCount | BinWidth | None = None
+	measure: Measure = Measure.COUNT
+	colors: Sequence[Color | CustomColor] | None = None
+
+	def __post_init__(self) -> None:
+		"""
+		Check the columns and the colors and replace them with copies that only the chart holds.
+
+		.. versionadded:: 0.1.0
+
+		Raises
+		------
+		InvalidTypeError
+			When a setting is not of the type its annotation names.
+		InvalidColumnNameError
+			When a name in ``columns`` is an empty text.
+		EmptyListError
+			When ``columns`` or ``colors`` is an empty list.
+		DuplicateColumnError
+			When a column name appears twice in ``columns``.
+		"""
+		require_field_types(self)
+
+		columns_copy = copy_columns(self.columns)
+		colors_copy = copy_colors(self.colors)
+		object.__setattr__(self, "columns", columns_copy)
+		object.__setattr__(self, "colors", colors_copy)

numdaplot/plots/charts/line_chart.py

@@ -0,0 +1,100 @@
+"""
+Chart drawing each series as a line.
+
+.. versionadded:: 0.1.0
+"""
+
+from collections.abc import Sequence
+from dataclasses import dataclass
+
+from numdaplot.plots.charts.chart import Chart
+from numdaplot.plots.charts.chart_settings import copy_colors, copy_columns
+from numdaplot.plots.charts.line_type import LineType
+from numdaplot.plots.charts.marker_shape import MarkerShape
+from numdaplot.plots.style.color import Color
+from numdaplot.plots.style.custom_color import CustomColor
+from numdaplot.settings.field_types import require_field_types
+from numdaplot.tables.columns.column_names import require_optional_column_name
+
+
+@dataclass(frozen=True)
+class LineChart(Chart):
+	"""
+	Chart drawing each series as a line joining its values, used by ``Plot.line``.
+
+	A missing value breaks the line, which starts again at the next present value.
+
+	.. versionadded:: 0.1.0
+
+	Parameters
+	----------
+	x
+		For a Table, the column of the horizontal positions: numbers, dates, datetimes, times of day, texts or
+		booleans, the row numbers when omitted. An Array takes none, its rows being numbered. Times of day are placed
+		on an axis of one day labeled ``HH:MM``.
+	y
+		For a Table, the columns drawn, holding numbers or times of day, not both, one line each. A Table needs it,
+		even for a single column. An Array takes none: when omitted, each of its columns is a line. Times of day are
+		measured on an axis labeled ``HH:MM``.
+	colors
+		One color per line, the colors of the default cycle when omitted. The chart keeps its own list.
+	line
+		How the lines are drawn, ``LineType.SOLID`` by default.
+	marker
+		The shape drawn at each value, ``MarkerShape.NONE`` by default.
+
+	Raises
+	------
+	InvalidTypeError
+		When a setting is not of the type its annotation names.
+	InvalidColumnNameError
+		When ``x`` or a name in ``y`` is an empty text.
+	EmptyListError
+		When ``y`` or ``colors`` is an empty list.
+	DuplicateColumnError
+		When a column name appears twice in ``y``.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> days = ndp.Array.from_list([1, 2, 3, 4])
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> costs = ndp.Array.from_list([8.0, 9.5, None, 10.0])
+	>>> sales = ndp.Table.from_arrays({"day": days, "price": prices, "cost": costs})
+	>>> colors = [ndp.Color.BLUE, ndp.CustomColor("#ff8800")]
+	>>> chart = ndp.LineChart(x="day", y=["price", "cost"], colors=colors, marker=ndp.MarkerShape.CIRCLE)
+	>>> plot = ndp.Plot.line(sales, chart)
+	>>> plot.show()
+	"""
+
+	x: str | None = None
+	y: list[str] | None = None
+	colors: Sequence[Color | CustomColor] | None = None
+	line: LineType = LineType.SOLID
+	marker: MarkerShape = MarkerShape.NONE
+
+	def __post_init__(self) -> None:
+		"""
+		Check the columns and the colors and replace them with copies that only the chart holds.
+
+		.. versionadded:: 0.1.0
+
+		Raises
+		------
+		InvalidTypeError
+			When a setting is not of the type its annotation names.
+		InvalidColumnNameError
+			When ``x`` or a name in ``y`` is an empty text.
+		EmptyListError
+			When ``y`` or ``colors`` is an empty list.
+		DuplicateColumnError
+			When a column name appears twice in ``y``.
+		"""
+		require_field_types(self)
+
+		require_optional_column_name(self.x)
+
+		columns_copy = copy_columns(self.y)
+		colors_copy = copy_colors(self.colors)
+		object.__setattr__(self, "y", columns_copy)
+		object.__setattr__(self, "colors", colors_copy)

numdaplot/plots/charts/line_type.py

@@ -0,0 +1,75 @@
+"""
+How the lines of a LineChart are drawn.
+
+.. versionadded:: 0.1.0
+"""
+
+from enum import Enum, auto
+
+
+class LineType(Enum):
+	"""
+	How the lines of a ``LineChart`` are drawn.
+
+	.. versionadded:: 0.1.0
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(line=ndp.LineType.DASHED)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""
+
+	SOLID = auto()
+	"""
+	A continuous line. Default value.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(line=ndp.LineType.SOLID)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""
+
+	DASHED = auto()
+	"""
+	A line of dashes.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(line=ndp.LineType.DASHED)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""
+
+	DOTTED = auto()
+	"""
+	A line of dots.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(line=ndp.LineType.DOTTED)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""
+
+	DASH_DOT = auto()
+	"""
+	A line of dashes and dots in turn.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(line=ndp.LineType.DASH_DOT)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""

numdaplot/plots/charts/marker_shape.py

@@ -0,0 +1,113 @@
+"""
+Shapes drawn at the values of a chart.
+
+.. versionadded:: 0.1.0
+"""
+
+from enum import Enum, auto
+
+
+class MarkerShape(Enum):
+	"""
+	Shapes drawn at the values of a ``LineChart`` or a ``ScatterChart``.
+
+	.. versionadded:: 0.1.0
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.SQUARE)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""
+
+	NONE = auto()
+	"""
+	No marker, only the line. Default value of ``LineChart``, refused by ``ScatterChart``.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> prices = ndp.Array.from_list([12.0, 15.5, 14.0, 17.0])
+	>>> chart = ndp.LineChart(marker=ndp.MarkerShape.NONE)
+	>>> plot = ndp.Plot.line(prices, chart)
+	>>> plot.show()
+	"""
+
+	CIRCLE = auto()
+	"""
+	A disc. Default value of ``ScatterChart``.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.CIRCLE)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""
+
+	SQUARE = auto()
+	"""
+	A square.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.SQUARE)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""
+
+	TRIANGLE = auto()
+	"""
+	A triangle pointing up.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.TRIANGLE)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""
+
+	CROSS = auto()
+	"""
+	A cross made of two diagonal strokes.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.CROSS)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""
+
+	DIAMOND = auto()
+	"""
+	A diamond.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> surfaces = ndp.Array.from_list([30.0, 45.0, 60.0, 80.0])
+	>>> prices = ndp.Array.from_list([150.0, 210.0, 260.0, 330.0])
+	>>> flats = ndp.Table.from_arrays({"surface": surfaces, "price": prices})
+	>>> chart = ndp.ScatterChart(x="surface", y="price", marker=ndp.MarkerShape.DIAMOND)
+	>>> plot = ndp.Plot.scatter(flats, chart)
+	>>> plot.show()
+	"""

numdaplot/plots/charts/missing_chart.py

@@ -0,0 +1,60 @@
+"""
+Chart drawing the missing values of each column of a Table as bars.
+
+.. versionadded:: 0.1.0
+"""
+
+from dataclasses import dataclass
+
+from numdaplot.plots.charts.chart import Chart
+from numdaplot.ratios.measure import Measure
+from numdaplot.settings.field_types import require_field_types
+
+
+@dataclass(frozen=True)
+class MissingChart(Chart):
+	"""
+	Chart drawing one bar per column of a Table, as high as its missing values, used by ``Plot.missing_by_column``.
+
+	Every column has its bar, even without missing value.
+
+	.. versionadded:: 0.1.0
+
+	Parameters
+	----------
+	measure
+		``Measure.COUNT`` by default for the number of missing values of each column, ``Measure.RATIO`` for their
+		share, on an axis from 0 to 1.
+
+
+	Raises
+	------
+	InvalidTypeError
+		When a setting is not of the type its annotation names.
+
+	Examples
+	--------
+	>>> import numdaplot as ndp
+	>>> cities = ndp.Array.from_list(["Paris", "Lyon", "Nice", "Pau"])
+	>>> prices = ndp.Array.from_list([12.0, None, None, 15.5])
+	>>> rooms = ndp.Array.from_list([2, 3, 1, 4])
+	>>> flats = ndp.Table.from_arrays({"city": cities, "price": prices, "rooms": rooms})
+	>>> chart = ndp.MissingChart(measure=ndp.Measure.RATIO)
+	>>> plot = ndp.Plot.missing_by_column(flats, chart)
+	>>> plot.show()
+	"""
+
+	measure: Measure = Measure.COUNT
+
+	def __post_init__(self) -> None:
+		"""
+		Check the type of every setting.
+
+		.. versionadded:: 0.1.0
+
+		Raises
+		------
+		InvalidTypeError
+			When a setting is not of the type its annotation names.
+		"""
+		require_field_types(self)