def fill(
a,
b=None,
c=None,
along="x",
baseline=None,
color=None,
filename=None,
height=None,
label=None,
margin=50,
opacity=1.0,
padding=10,
show=True,
style=None,
title=None,
width=None,
xlabel=None,
xmax=None,
xmin=None,
xscale="linear",
xshow=True,
ylabel=None,
ymax=None,
ymin=None,
yscale="linear",
yshow=True,
):
"""Convenience function for creating a fill plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.fill`,
:meth:`toyplot.canvas.Canvas.cartesian`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.FillBoundaries` or :class:`toyplot.mark.FillMagnitudes`
The new fill mark.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.cartesian(
label=label,
margin=margin,
padding=padding,
show=show,
xlabel=xlabel,
xmax=xmax,
xmin=xmin,
xscale=xscale,
xshow=xshow,
ylabel=ylabel,
ymax=ymax,
ymin=ymin,
yscale=yscale,
yshow=yshow,
)
mark = axes.fill(
a=a,
b=b,
c=c,
along=along,
baseline=baseline,
color=color,
filename=filename,
opacity=opacity,
style=style,
title=title,
)
return canvas, axes, mark
def graph(
a,
b=None,
c=None,
along="x",
ecolor=None,
eopacity=1.0,
estyle=None,
ewidth=1.0,
height=None,
hmarker=None,
layout=None,
margin=50,
mmarker=None,
mposition=0.5,
olayout=None,
padding=20,
tmarker=None,
varea=None,
vcolor=None,
vcoordinates=None,
vlabel=None,
vlshow=True,
vlstyle=None,
vmarker="o",
vopacity=1.0,
vsize=None,
vstyle=None,
vtitle=None,
width=None,
): # pragma: no cover
"""Convenience function for creating a graph plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.graph`,
:meth:`toyplot.canvas.Canvas.cartesian`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.Graph`
The new graph mark.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.cartesian(
aspect="fit-range",
margin=margin,
padding=padding,
show=False,
)
mark = axes.graph(
a=a,
b=b,
c=c,
along=along,
ecolor=ecolor,
eopacity=eopacity,
estyle=estyle,
ewidth=ewidth,
hmarker=hmarker,
layout=layout,
mmarker=mmarker,
mposition=mposition,
olayout=olayout,
tmarker=tmarker,
varea=varea,
vcolor=vcolor,
vcoordinates=vcoordinates,
vlabel=vlabel,
vlshow=vlshow,
vlstyle=vlstyle,
vmarker=vmarker,
vopacity=vopacity,
vsize=vsize,
vstyle=vstyle,
vtitle=vtitle,
)
return canvas, axes, mark
def scatterplot(
a,
b=None,
along="x",
area=None,
aspect=None,
color=None,
filename=None,
height=None,
label=None,
margin=50,
marker="o",
mlstyle=None,
mstyle=None,
opacity=1.0,
padding=10,
show=True,
size=None,
title=None,
width=None,
xlabel=None,
xmax=None,
xmin=None,
xscale="linear",
xshow=True,
ylabel=None,
ymax=None,
ymin=None,
yscale="linear",
yshow=True,
):
"""Convenience function for creating a scatter plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.scatterplot`,
:meth:`toyplot.canvas.Canvas.cartesian`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.Scatterplot`
The new scatter plot mark.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.cartesian(
aspect=aspect,
label=label,
margin=margin,
padding=padding,
show=show,
xlabel=xlabel,
xmax=xmax,
xmin=xmin,
xscale=xscale,
xshow=xshow,
ylabel=ylabel,
ymax=ymax,
ymin=ymin,
yscale=yscale,
yshow=yshow,
)
mark = axes.scatterplot(
a=a,
b=b,
along=along,
area=area,
color=color,
filename=filename,
marker=marker,
mlstyle=mlstyle,
mstyle=mstyle,
opacity=opacity,
size=size,
title=title,
)
return canvas, axes, mark
def plot(
a,
b=None,
along="x",
color=None,
stroke_width=2.0,
opacity=1.0,
title=None,
marker=None,
area=None,
size=None,
mfill=None,
mopacity=1.0,
mtitle=None,
style=None,
mstyle=None,
mlstyle=None,
filename=None,
aspect=None,
xmin=None,
xmax=None,
ymin=None,
ymax=None,
show=True,
xshow=True,
yshow=True,
label=None,
xlabel=None,
ylabel=None,
xscale="linear",
yscale="linear",
padding=10,
width=None,
height=None,
):
"""Convenience function for creating a line plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.plot`,
:meth:`toyplot.canvas.Canvas.axes`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.Plot`
The new plot mark.
"""
canvas = Canvas(width=width, height=height)
axes = canvas.cartesian(aspect=aspect,
xmin=xmin,
xmax=xmax,
ymin=ymin,
ymax=ymax,
show=show,
xshow=xshow,
yshow=yshow,
label=label,
xlabel=xlabel,
ylabel=ylabel,
xscale=xscale,
yscale=yscale,
padding=padding)
mark = axes.plot(a=a,
b=b,
along=along,
color=color,
stroke_width=stroke_width,
opacity=opacity,
title=title,
marker=marker,
area=area,
size=size,
mfill=mfill,
mopacity=mopacity,
mtitle=mtitle,
style=style,
mstyle=mstyle,
mlstyle=mlstyle,
filename=filename)
return canvas, axes, mark
def bars(
a,
b=None,
c=None,
along="x",
baseline="stacked",
color=None,
opacity=1.0,
title=None,
style=None,
filename=None,
xmin=None,
xmax=None,
ymin=None,
ymax=None,
show=True,
xshow=True,
yshow=True,
label=None,
xlabel=None,
ylabel=None,
xscale="linear",
yscale="linear",
padding=10,
width=None,
height=None,
):
"""Convenience function for creating a bar plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.bars`,
:meth:`toyplot.canvas.Canvas.axes`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.BarMagnitudes` or :class:`toyplot.mark.BarBoundaries`
The new bar mark.
"""
canvas = Canvas(width=width, height=height)
axes = canvas.cartesian(xmin=xmin,
xmax=xmax,
ymin=ymin,
ymax=ymax,
show=show,
xshow=xshow,
yshow=yshow,
label=label,
xlabel=xlabel,
ylabel=ylabel,
xscale=xscale,
yscale=yscale,
padding=padding)
mark = axes.bars(a=a,
b=b,
c=c,
along=along,
baseline=baseline,
color=color,
opacity=opacity,
title=title,
style=style,
filename=filename)
return canvas, axes, mark
def fill(
a,
b=None,
c=None,
along="x",
baseline=None,
color=None,
opacity=1.0,
title=None,
style=None,
filename=None,
xmin=None,
xmax=None,
ymin=None,
ymax=None,
show=True,
xshow=True,
yshow=True,
label=None,
xlabel=None,
ylabel=None,
xscale="linear",
yscale="linear",
padding=10,
width=None,
height=None,
):
"""Convenience function for creating a fill plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.fill`,
:meth:`toyplot.canvas.Canvas.axes`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.FillBoundaries` or :class:`toyplot.mark.FillMagnitudes`
The new bar mark.
"""
canvas = Canvas(width=width, height=height)
axes = canvas.cartesian(
xmin=xmin,
xmax=xmax,
ymin=ymin,
ymax=ymax,
show=show,
xshow=xshow,
yshow=yshow,
label=label,
xlabel=xlabel,
ylabel=ylabel,
xscale=xscale,
yscale=yscale,
padding=padding)
mark = axes.fill(
a=a,
b=b,
c=c,
along=along,
baseline=baseline,
color=color,
opacity=opacity,
title=title,
style=style,
filename=filename)
return canvas, axes, mark
def scatterplot(
a,
b=None,
along="x",
color=None,
marker="o",
area=None,
size=None,
opacity=1.0,
title=None,
style=None,
mstyle=None,
mlstyle=None,
filename=None,
aspect=None,
xmin=None,
xmax=None,
ymin=None,
ymax=None,
show=True,
xshow=True,
yshow=True,
label=None,
xlabel=None,
ylabel=None,
xscale="linear",
yscale="linear",
padding=10,
width=None,
height=None,
):
"""Convenience function for creating a scatter plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.scatterplot`,
:meth:`toyplot.canvas.Canvas.axes`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.Plot`
The new scatter plot mark.
"""
canvas = Canvas(width=width, height=height)
axes = canvas.cartesian(
aspect=aspect,
xmin=xmin,
xmax=xmax,
ymin=ymin,
ymax=ymax,
show=show,
xshow=xshow,
yshow=yshow,
label=label,
xlabel=xlabel,
ylabel=ylabel,
xscale=xscale,
yscale=yscale,
padding=padding)
mark = axes.scatterplot(
a=a,
b=b,
along=along,
color=color,
marker=marker,
area=area,
size=size,
opacity=opacity,
title=title,
style=style,
mstyle=mstyle,
mlstyle=mlstyle,
filename=filename)
return canvas, axes, mark
def graph(
a,
b=None,
c=None,
olayout=None,
layout=None,
along="x",
vlabel=None,
vcoordinates=None,
vcolor=None,
vmarker="o",
varea=None,
vsize=None,
vopacity=1.0,
vtitle=None,
vstyle=None,
vlstyle=None,
vlshow=True,
ecolor=None,
ewidth=1.0,
eopacity=1.0,
estyle=None,
padding=20,
width=None,
height=None,
): # pragma: no cover
"""Convenience function for creating a graph plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.graph`,
:meth:`toyplot.canvas.Canvas.axes`, and :class:`toyplot.canvas.Canvas` for
parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
axes: :class:`toyplot.coordinates.Cartesian`
A new set of 2D axes that fill the canvas.
mark: :class:`toyplot.mark.Graph`
The new graph mark.
"""
canvas = Canvas(width=width, height=height)
axes = canvas.cartesian(aspect="fit-range", show=False, padding=padding)
mark = axes.graph(
a=a,
b=b,
c=c,
olayout=olayout,
layout=layout,
along=along,
vlabel=vlabel,
vcoordinates=vcoordinates,
vcolor=vcolor,
vmarker=vmarker,
varea=varea,
vsize=vsize,
vopacity=vopacity,
vtitle=vtitle,
vstyle=vstyle,
vlstyle=vlstyle,
vlshow=vlshow,
ecolor=ecolor,
ewidth=ewidth,
eopacity=eopacity,
estyle=estyle,
)
return canvas, axes, mark
