def matrix(
matrix,
label=None,
step=1,
colormap=None,
palette=None,
width=None,
height=None,
canvas_style=None):
"""Convenience function to create a matrix visualization in a single call.
See :meth:`toyplot.canvas.Canvas.matrix`, and :class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.axes.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(width=width, height=height, style=canvas_style)
table = canvas.matrix(
matrix=matrix,
label=label,
step=step,
colormap=colormap,
palette=palette)
return canvas, table
def image(
data,
height=None,
margin=0,
width=None,
): # pragma: no cover
"""Convenience function for displaying an image in a single call.
See :meth:`toyplot.canvas.Canvas.image`, and :class:`toyplot.canvas.Canvas`
for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
mark: :class:`toyplot.mark.Image`
The new image mark.
"""
canvas = Canvas(
height=height,
width=width,
)
mark = canvas.image(
data=data,
margin=margin,
)
return canvas, mark
def matrix(matrix,
title=None,
step=1,
colormap=None,
palette=None,
width=None,
height=None,
canvas_style=None):
"""Convenience function to create a matrix visualization in a single call.
See :meth:`toyplot.canvas.Canvas.matrix`, and :class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.axes.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(width=width, height=height, style=canvas_style)
table = canvas.matrix(matrix=matrix,
title=title,
step=step,
colormap=colormap,
palette=palette)
return canvas, table
def table(
data=None,
rows=None,
columns=None,
hrows=None,
brows=None,
lcols=None,
rcols=None,
label=None,
width=None,
height=None,
canvas_style=None):
"""Convenience function to create a table visualization in a single call.
See :meth:`toyplot.canvas.Canvas.table`, and :class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.axes.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(width=width, height=height, style=canvas_style)
table = canvas.table(
data=data,
rows=rows,
columns=columns,
hrows=hrows,
brows=brows,
lcols=lcols,
rcols=rcols,
label=label)
return canvas, table
def table(data=None,
rows=None,
columns=None,
hrows=None,
brows=None,
lcols=None,
rcols=None,
title=None,
width=None,
height=None,
canvas_style=None):
"""Convenience function to create a table visualization in a single call.
See :meth:`toyplot.canvas.Canvas.table`, and :class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.axes.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(width=width, height=height, style=canvas_style)
table = canvas.table(data=data,
rows=rows,
columns=columns,
hrows=hrows,
brows=brows,
lcols=lcols,
rcols=rcols,
title=title)
return canvas, table
def image(
data,
height=None,
margin=0,
width=None,
): # pragma: no cover
"""Convenience function for displaying an image in a single call.
See :meth:`toyplot.canvas.Canvas.image`, and :class:`toyplot.canvas.Canvas`
for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
mark: :class:`toyplot.mark.Image`
The new image mark.
"""
canvas = Canvas(
height=height,
width=width,
)
mark = canvas.image(
data=data,
margin=margin,
)
return canvas, mark
def matrix(
data,
blabel=None,
blocator=None,
bshow=None,
colorshow=False,
filename=None,
height=None,
label=None,
llabel=None,
llocator=None,
lshow=None,
margin=50,
rlabel=None,
rlocator=None,
rshow=None,
step=1,
tlabel=None,
tlocator=None,
tshow=None,
width=None,
):
"""Convenience function to create a matrix visualization in a single call.
See :meth:`toyplot.canvas.Canvas.matrix`, and
:class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.coordinates.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.matrix(
blabel=blabel,
blocator=blocator,
bshow=bshow,
colorshow=colorshow,
data=data,
filename=filename,
label=label,
llabel=llabel,
llocator=llocator,
lshow=lshow,
margin=margin,
rlabel=rlabel,
rlocator=rlocator,
rshow=rshow,
step=step,
tlabel=tlabel,
tlocator=tlocator,
tshow=tshow,
)
return canvas, axes
def matrix(
data,
blabel=None,
blocator=None,
bshow=None,
colorshow=False,
filename=None,
height=None,
label=None,
llabel=None,
llocator=None,
lshow=None,
margin=50,
rlabel=None,
rlocator=None,
rshow=None,
step=1,
tlabel=None,
tlocator=None,
tshow=None,
width=None,
):
"""Convenience function to create a matrix visualization in a single call.
See :meth:`toyplot.canvas.Canvas.matrix`, and
:class:`toyplot.canvas.Canvas` for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.coordinates.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.matrix(
blabel=blabel,
blocator=blocator,
bshow=bshow,
colorshow=colorshow,
data=data,
filename=filename,
label=label,
llabel=llabel,
llocator=llocator,
lshow=lshow,
margin=margin,
rlabel=rlabel,
rlocator=rlocator,
rshow=rshow,
step=step,
tlabel=tlabel,
tlocator=tlocator,
tshow=tshow,
)
return canvas, axes
def scatterplot(a, b=None, along="x", color=None, colormap=None, palette=None, marker="o", size=20, fill=None, fill_colormap=None, fill_palette=None, opacity=1.0, title=None, style=None, mstyle=None, mlstyle=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, canvas_style=None):
"""Convenience function for creating a scatter plot in a single call.
See :meth:`toyplot.axes.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.axes.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, style=canvas_style)
axes = canvas.axes(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, colormap=colormap, palette=palette, marker=marker, size=size, fill=fill, fill_colormap=fill_colormap, fill_palette=fill_palette, opacity=opacity, title=title, style=style, mstyle=mstyle, mlstyle=mlstyle)
return canvas, axes, mark
def fill(a, b=None, c=None, along="x", baseline=None, fill=None, colormap=None, palette=None, opacity=1.0, title=None, style=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, canvas_style=None):
"""Convenience function for creating a fill plot in a single call.
See :meth:`toyplot.axes.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.axes.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, style=canvas_style)
axes = canvas.axes(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, fill=fill, colormap=colormap, palette=palette, opacity=opacity, title=title, style=style)
return canvas, axes, mark
def table(
data=None,
brows=None,
columns=None,
filename=None,
height=None,
label=None,
lcolumns=None,
margin=50,
rcolumns=None,
rows=None,
trows=None,
width=None,
):
"""Convenience function to create a table visualization in a single call.
See :meth:`toyplot.canvas.Canvas.table`, and :class:`toyplot.canvas.Canvas`
for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.coordinates.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.table(
brows=brows,
columns=columns,
data=data,
filename=filename,
label=label,
lcolumns=lcolumns,
margin=margin,
rcolumns=rcolumns,
rows=rows,
trows=trows,
)
return canvas, axes
def table(
data=None,
brows=None,
columns=None,
filename=None,
height=None,
label=None,
lcolumns=None,
margin=50,
rcolumns=None,
rows=None,
trows=None,
width=None,
):
"""Convenience function to create a table visualization in a single call.
See :meth:`toyplot.canvas.Canvas.table`, and :class:`toyplot.canvas.Canvas`
for parameter descriptions.
Returns
-------
canvas: :class:`toyplot.canvas.Canvas`
A new canvas object.
table: :class:`toyplot.coordinates.Table`
A new set of table axes that fill the canvas.
"""
canvas = Canvas(
height=height,
width=width,
)
axes = canvas.table(
brows=brows,
columns=columns,
data=data,
filename=filename,
label=label,
lcolumns=lcolumns,
margin=margin,
rcolumns=rcolumns,
rows=rows,
trows=trows,
)
return canvas, axes
def fill(a,
b=None,
c=None,
along="x",
baseline=None,
fill=None,
colormap=None,
palette=None,
opacity=1.0,
title=None,
style=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,
canvas_style=None):
"""Convenience function for creating a fill plot in a single call.
See :meth:`toyplot.axes.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.axes.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, style=canvas_style)
axes = canvas.axes(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,
fill=fill,
colormap=colormap,
palette=palette,
opacity=opacity,
title=title,
style=style)
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.axes.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.axes.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.axes(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 scatterplot(
a,
b=None,
along="x",
area=None,
aspect=None,
color=None,
filename=None,
height=None,
hyperlink=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.Point`
The new scatterplot 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,
hyperlink=hyperlink,
marker=marker,
mlstyle=mlstyle,
mstyle=mstyle,
opacity=opacity,
size=size,
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",
color=None,
colormap=None,
palette=None,
marker="o",
size=20,
fill=None,
fill_colormap=None,
fill_palette=None,
opacity=1.0,
title=None,
style=None,
mstyle=None,
mlstyle=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,
canvas_style=None):
"""Convenience function for creating a scatter plot in a single call.
See :meth:`toyplot.axes.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.axes.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, style=canvas_style)
axes = canvas.axes(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,
colormap=colormap,
palette=palette,
marker=marker,
size=size,
fill=fill,
fill_colormap=fill_colormap,
fill_palette=fill_palette,
opacity=opacity,
title=title,
style=style,
mstyle=mstyle,
mlstyle=mlstyle)
return canvas, axes, mark
def bars(
a,
b=None,
c=None,
along="x",
baseline="stacked",
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 bar plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.bars`,
: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.BarMagnitudes` or :class:`toyplot.mark.BarBoundaries`
The new bar mark.
"""
canvas = Canvas(width=width, height=height)
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.bars(
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 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 bars(
a,
b=None,
c=None,
along="x",
baseline="stacked",
color=None,
filename=None,
height=None,
hyperlink=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 bar plot in a single call.
See :meth:`toyplot.coordinates.Cartesian.bars`,
: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.BarMagnitudes` or :class:`toyplot.mark.BarBoundaries`
The new bar mark.
"""
canvas = Canvas(width=width, height=height)
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.bars(
a=a,
b=b,
c=c,
along=along,
baseline=baseline,
color=color,
filename=filename,
hyperlink=hyperlink,
opacity=opacity,
style=style,
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.axes.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.axes.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.axes(
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 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.axes.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.axes.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.axes(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
