fortplot_matplotlib_plot_wrappers Module

Matplotlib-style plot creation wrappers built on top of fortplot figures.

Each wrapper exposes a matplotlib-compatible signature. Color kwargs accept either a character string (name, hex, single-letter) or an RGB triple through generic interfaces defined below. Parameters that have no visual effect in the current backend are accepted silently so that matplotlib-style code does not generate spurious runtime warnings.

Interfaces

public interface boxplot

• private subroutine boxplot_string(data, position, width, label, show_outliers, horizontal, color)

  Plot a boxplot with a named color.

  Parameters data : real(wp), contiguous, intent(in) Sample values. position : real(wp), optional Box position. width : real(wp), optional Box width. label : character(len=), optional Legend label. show_outliers : logical, optional Show outlier markers. horizontal : logical, optional Draw a horizontal boxplot. color : character(len=), intent(in) Box color.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	data(:)
  real(kind=wp),	intent(in),	optional		::	position
  real(kind=wp),	intent(in),	optional		::	width
  character(len=*),	intent(in),	optional		::	label
  logical,	intent(in),	optional		::	show_outliers
  logical,	intent(in),	optional		::	horizontal
  character(len=*),	intent(in)			::	color

• private subroutine boxplot_rgb(data, position, width, label, show_outliers, horizontal, color)

  Plot a boxplot with an RGB color.

  Parameters data : real(wp), contiguous, intent(in) Sample values. position : real(wp), optional Box position. width : real(wp), optional Box width. label : character(len=*), optional Legend label. show_outliers : logical, optional Show outlier markers. horizontal : logical, optional Draw a horizontal boxplot. color : real(wp)(3), optional Box color.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	data(:)
  real(kind=wp),	intent(in),	optional		::	position
  real(kind=wp),	intent(in),	optional		::	width
  character(len=*),	intent(in),	optional		::	label
  logical,	intent(in),	optional		::	show_outliers
  logical,	intent(in),	optional		::	horizontal
  real(kind=wp),	intent(in),	optional		::	color(3)

public interface add_3d_plot

• private subroutine add_3d_plot_rgb(x, y, z, label, linestyle, color, linewidth, marker, markersize)

  Add a 3D line or marker plot with an RGB color.

  Parameters x : real(wp), contiguous, intent(in) X coordinates. y : real(wp), contiguous, intent(in) Y coordinates. z : real(wp), contiguous, intent(in) Z coordinates. label : character(len=), optional Legend label. linestyle : character(len=), optional Line style string. color : real(wp)(3), optional Plot color. linewidth : real(wp), optional Line width. marker : character(len=*), optional Marker style. markersize : real(wp), optional Marker size.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),		contiguous	::	z(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	linestyle
  real(kind=wp),	intent(in),	optional		::	color(3)
  real(kind=wp),	intent(in),	optional		::	linewidth
  character(len=*),	intent(in),	optional		::	marker
  real(kind=wp),	intent(in),	optional		::	markersize

• private subroutine add_3d_plot_string(x, y, z, label, linestyle, color, linewidth, marker, markersize)

  Add a 3D line or marker plot with a named color.

  Parameters x : real(wp), contiguous, intent(in) X coordinates. y : real(wp), contiguous, intent(in) Y coordinates. z : real(wp), contiguous, intent(in) Z coordinates. label : character(len=), optional Legend label. linestyle : character(len=), optional Line style string. color : character(len=), intent(in) Plot color. linewidth : real(wp), optional Line width. marker : character(len=), optional Marker style. markersize : real(wp), optional Marker size.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),		contiguous	::	z(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	linestyle
  character(len=*),	intent(in)			::	color
  real(kind=wp),	intent(in),	optional		::	linewidth
  character(len=*),	intent(in),	optional		::	marker
  real(kind=wp),	intent(in),	optional		::	markersize

public interface bar

• private subroutine bar_rgb(x, height, width, bottom, label, color, edgecolor, align, alpha)

  Plot a vertical bar chart with RGB colors.

  Parameters x : real(wp), contiguous, intent(in) Bar positions. height : real(wp), contiguous, intent(in) Bar heights. width : real(wp), optional Bar width. bottom : real(wp), optional Baseline values. label : character(len=), optional Legend label. color : real(wp)(3), optional Bar fill color. edgecolor : real(wp)(3), optional Bar edge color. align : character(len=), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	height(:)
  real(kind=wp),	intent(in),	optional		::	width
  real(kind=wp),	intent(in),	optional		::	bottom(:)
  character(len=*),	intent(in),	optional		::	label
  real(kind=wp),	intent(in),	optional		::	color(3)
  real(kind=wp),	intent(in),	optional		::	edgecolor(3)
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

• private subroutine bar_string(x, height, color, width, bottom, label, edgecolor, align, alpha)

  Plot a vertical bar chart with a named color.

  Parameters x : real(wp), contiguous, intent(in) Bar positions. height : real(wp), contiguous, intent(in) Bar heights. color : character(len=), intent(in) Bar fill color. width : real(wp), optional Bar width. bottom : real(wp), optional Baseline values. label : character(len=), optional Legend label. edgecolor : character(len=), optional Bar edge color. align : character(len=), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	height(:)
  character(len=*),	intent(in)			::	color
  real(kind=wp),	intent(in),	optional		::	width
  real(kind=wp),	intent(in),	optional		::	bottom(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	edgecolor
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

• private subroutine bar_rgb_edgecolor(x, height, color, edgecolor, width, bottom, label, align, alpha)

  Plot a vertical bar chart with RGB fill and named edge color.

  Parameters x : real(wp), contiguous, intent(in) Bar positions. height : real(wp), contiguous, intent(in) Bar heights. color : real(wp)(3), intent(in) Bar fill color. edgecolor : character(len=), intent(in) Bar edge color. width : real(wp), optional Bar width. bottom : real(wp), optional Baseline values. label : character(len=), optional Legend label. align : character(len=*), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	height(:)
  real(kind=wp),	intent(in)			::	color(3)
  character(len=*),	intent(in)			::	edgecolor
  real(kind=wp),	intent(in),	optional		::	width
  real(kind=wp),	intent(in),	optional		::	bottom(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

public interface barh

• private subroutine barh_rgb(y, width, height, left, label, color, edgecolor, align, alpha)

  Plot a horizontal bar chart with RGB colors.

  Parameters y : real(wp), contiguous, intent(in) Bar positions. width : real(wp), contiguous, intent(in) Bar lengths. height : real(wp), optional Bar thickness. left : real(wp), optional Baseline values. label : character(len=), optional Legend label. color : real(wp)(3), optional Bar fill color. edgecolor : real(wp)(3), optional Bar edge color. align : character(len=), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),		contiguous	::	width(:)
  real(kind=wp),	intent(in),	optional		::	height
  real(kind=wp),	intent(in),	optional		::	left(:)
  character(len=*),	intent(in),	optional		::	label
  real(kind=wp),	intent(in),	optional		::	color(3)
  real(kind=wp),	intent(in),	optional		::	edgecolor(3)
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

• private subroutine barh_string(y, width, color, height, left, label, edgecolor, align, alpha)

  Plot a horizontal bar chart with a named color.

  Parameters y : real(wp), contiguous, intent(in) Bar positions. width : real(wp), contiguous, intent(in) Bar lengths. color : character(len=), intent(in) Bar fill color. height : real(wp), optional Bar thickness. left : real(wp), optional Baseline values. label : character(len=), optional Legend label. edgecolor : character(len=), optional Bar edge color. align : character(len=), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),		contiguous	::	width(:)
  character(len=*),	intent(in)			::	color
  real(kind=wp),	intent(in),	optional		::	height
  real(kind=wp),	intent(in),	optional		::	left(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	edgecolor
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

• private subroutine barh_rgb_edgecolor(y, width, color, edgecolor, height, left, label, align, alpha)

  Plot a horizontal bar chart with RGB fill and named edge color.

  Parameters y : real(wp), contiguous, intent(in) Bar positions. width : real(wp), contiguous, intent(in) Bar lengths. color : real(wp)(3), intent(in) Bar fill color. edgecolor : character(len=), intent(in) Bar edge color. height : real(wp), optional Bar thickness. left : real(wp), optional Baseline values. label : character(len=), optional Legend label. align : character(len=*), optional Accepted for matplotlib parity. alpha : real(wp), optional Bar transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),		contiguous	::	width(:)
  real(kind=wp),	intent(in)			::	color(3)
  character(len=*),	intent(in)			::	edgecolor
  real(kind=wp),	intent(in),	optional		::	height
  real(kind=wp),	intent(in),	optional		::	left(:)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	align
  real(kind=wp),	intent(in),	optional		::	alpha

public interface add_plot

• private subroutine add_plot_rgb(x, y, color, label, linestyle, alpha)

  Add a line plot with an RGB color.

  Parameters x : real(wp), contiguous, intent(in) X coordinates. y : real(wp), contiguous, intent(in) Y coordinates. color : real(wp)(3), optional RGB line color. label : character(len=), optional Legend label. linestyle : character(len=), optional Line style string. alpha : real(wp), optional Line transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  real(kind=wp),	intent(in),	optional		::	color(3)
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	linestyle
  real(kind=wp),	intent(in),	optional		::	alpha

• private subroutine add_plot_string(x, y, color, label, linestyle, alpha)

  Add a line plot with a named color.

  Parameters x : real(wp), contiguous, intent(in) X coordinates. y : real(wp), contiguous, intent(in) Y coordinates. color : character(len=), intent(in) Named or hex color. label : character(len=), optional Legend label. linestyle : character(len=*), optional Line style string. alpha : real(wp), optional Line transparency.

  Arguments

  Type	Intent	Optional	Attributes		Name
  real(kind=wp),	intent(in),		contiguous	::	x(:)
  real(kind=wp),	intent(in),		contiguous	::	y(:)
  character(len=*),	intent(in)			::	color
  character(len=*),	intent(in),	optional		::	label
  character(len=*),	intent(in),	optional		::	linestyle
  real(kind=wp),	intent(in),	optional		::	alpha

Subroutines

public subroutine plot(x, y, label, linestyle, color, linewidth, marker, markersize, alpha)

Plot x and y data with the active figure or subplot.

Read more…

Arguments

Type	Intent	Optional	Attributes		Name
real(kind=wp),	intent(in),		contiguous	::	x(:)
real(kind=wp),	intent(in),		contiguous	::	y(:)
character(len=*),	intent(in),	optional		::	label
character(len=*),	intent(in),	optional		::	linestyle
real(kind=wp),	intent(in),	optional		::	color(3)
real(kind=wp),	intent(in),	optional		::	linewidth
character(len=*),	intent(in),	optional		::	marker
real(kind=wp),	intent(in),	optional		::	markersize
real(kind=wp),	intent(in),	optional		::	alpha

public subroutine bar_rgb_array(x, height, color_per_bar, edgecolor_per_bar, width, bottom, label, align, alpha)

Plot a vertical bar chart with per-bar RGB color arrays.

Read more…

Arguments

Type	Intent	Optional	Attributes		Name
real(kind=wp),	intent(in),		contiguous	::	x(:)
real(kind=wp),	intent(in),		contiguous	::	height(:)
real(kind=wp),	intent(in),	optional		::	color_per_bar(3,*)
real(kind=wp),	intent(in),	optional		::	edgecolor_per_bar(3,*)
real(kind=wp),	intent(in),	optional		::	width
real(kind=wp),	intent(in),	optional		::	bottom(:)
character(len=*),	intent(in),	optional		::	label
character(len=*),	intent(in),	optional		::	align
real(kind=wp),	intent(in),	optional		::	alpha

public subroutine barh_rgb_array(y, width, color_per_bar, edgecolor_per_bar, height, left, label, align, alpha)

Plot a horizontal bar chart with per-bar RGB color arrays.

Read more…

Arguments

Type	Intent	Optional	Attributes		Name
real(kind=wp),	intent(in),		contiguous	::	y(:)
real(kind=wp),	intent(in),		contiguous	::	width(:)
real(kind=wp),	intent(in),	optional		::	color_per_bar(3,*)
real(kind=wp),	intent(in),	optional		::	edgecolor_per_bar(3,*)
real(kind=wp),	intent(in),	optional		::	height
real(kind=wp),	intent(in),	optional		::	left(:)
character(len=*),	intent(in),	optional		::	label
character(len=*),	intent(in),	optional		::	align
real(kind=wp),	intent(in),	optional		::	alpha