def plot(data1, data2=None, data3=None,
lw=1, lc='b', ls="-", mw=7, mc='b', ms='', mew=1, mec='k',
alpha=1, axesAdjust=True, axes=None, **kwargs):
""" plot(*args, lw=1, lc='b', ls="-", mw=7, mc='b', ms='', mew=1, mec='k',
alpha=1, axesAdjust=True, axes=None):
Plot 1, 2 or 3 dimensional data and return the Line object.
Usage
-----
* plot(Y, ...) plots a 1D signal, with the values plotted along the y-axis
* plot(X, Y, ...) also supplies x coordinates
* plot(X, Y, Z, ...) also supplies z coordinates
* plot(P, ...) plots using a Point or Pointset instance
Keyword arguments
-----------------
(The longer names for the line properties can also be used)
lw : scalar
lineWidth. The width of the line. If zero, no line is drawn.
mw : scalar
markerWidth. The width of the marker. If zero, no marker is drawn.
mew : scalar
markerEdgeWidth. The width of the edge of the marker.
lc : 3-element tuple or char
lineColor. The color of the line. A tuple should represent the RGB
values between 0 and 1. If a char is given it must be
one of 'rgbmcywk', for reg, green, blue, magenta, cyan, yellow,
white, black, respectively.
mc : 3-element tuple or char
markerColor. The color of the marker. See lineColor.
mec : 3-element tuple or char
markerEdgeColor. The color of the edge of the marker.
ls : string
lineStyle. The style of the line. (See below)
ms : string
markerStyle. The style of the marker. (See below)
axesAdjust : bool
If axesAdjust==True, this function will call axes.SetLimits(), set
the camera type to 2D when plotting 2D data and to 3D when plotting
3D data. If daspectAuto has not been set yet, it is set to True.
axes : Axes instance
Display the image in this axes, or the current axes if not given.
Line styles
-----------
* Solid line: '-'
* Dotted line: ':'
* Dashed line: '--'
* Dash-dot line: '-.' or '.-'
* A line that is drawn between each pair of points: '+'
* No line: '' or None.
Marker styles
-------------
* Plus: '+'
* Cross: 'x'
* Square: 's'
* Diamond: 'd'
* Triangle (pointing up, down, left, right): '^', 'v', '<', '>'
* Pentagram star: 'p' or '*'
* Hexgram: 'h'
* Point/cirle: 'o' or '.'
* No marker: '' or None
"""
# create a dict from the properties and combine with kwargs
tmp = { 'lineWidth':lw, 'lineColor':lc, 'lineStyle':ls,
'markerWidth':mw, 'markerColor':mc, 'markerStyle':ms,
'markerEdgeWidth':mew, 'markerEdgeColor':mec}
for i in tmp:
if not i in kwargs:
kwargs[i] = tmp[i]
# init dimension variable
camDim = 0
## create the data
# If one argument is given, and it looks like a pointset stored
# in a numpy array, use it as such
if isinstance(data1, np.ndarray) and (data2 is None) and (data3 is None):
if data1.ndim == 2 and data1.shape[1] in (2,3):
data1 = Pointset(data1) # Use shape as given
if is_Pointset(data1):
pp = data1
elif is_Point(data1):
pp = Pointset(data1.ndim)
pp.append(data1)
else:
if data1 is None:
raise Exception("The first argument cannot be None!")
data1 = np.asanyarray(data1)
d3 = data3
if data3 is None:
data3 = 0.1*np.ones(data1.shape)
camDim = 2
else:
camDim = 3
data3 = np.asanyarray(data3)
if data2 is None:
if d3 is not None:
tmp = "third argument in plot() ignored, as second not given."
print("Warning: " + tmp)
# y data is given, xdata must be a range starting from 1
data2 = data1
data1 = np.arange(1,data2.shape[0]+1)
data3 = 0.1*np.ones(data2.shape)
else:
data2 = np.asanyarray(data2)
# check dimensions
L = data1.size
if L != data2.size or L != data3.size:
raise Exception("Array dimensions do not match! %i vs %i vs %i" %
(data1.size, data2.size, data3.size))
# build points
data1 = data1.reshape((data1.size,1))
data2 = data2.reshape((data2.size,1))
data3 = data3.reshape((data3.size,1))
# Concatenate to a single Nx3 array (take care of masked arrays)
tmp = data1, data2, data3
if any([isinstance(d, np.ma.MaskedArray) for d in tmp]):
pp = np.ma.concatenate(tmp, 1)
else:
pp = np.concatenate(tmp, 1)
# Process camdim for given points or pointsets
if not camDim:
camDim = max(2, pp.ndim)
## create the line
if axes is None:
axes = vv.gca()
l = vv.Line(axes, pp)
l.lw = kwargs['lineWidth']
l.lc = kwargs['lineColor']
l.ls = kwargs['lineStyle']
l.mw = kwargs['markerWidth']
l.mc = kwargs['markerColor']
l.ms = kwargs['markerStyle']
l.mew = kwargs['markerEdgeWidth']
l.mec = kwargs['markerEdgeColor']
l.alpha = alpha
## done...
if axesAdjust:
if axes.daspectAuto is None:
axes.daspectAuto = True
axes.cameraType = str(camDim)+'d'
axes.SetLimits()
axes.Draw()
return l
def plot(data1, data2=None, data3=None,
lw=1, lc='b', ls="-", mw=7, mc='b', ms='', mew=1, mec='k',
alpha=1, axesAdjust=True, axes=None, **kwargs):
""" plot(*args, lw=1, lc='b', ls="-", mw=7, mc='b', ms='', mew=1, mec='k',
alpha=1, axesAdjust=True, axes=None):
Plot 1, 2 or 3 dimensional data and return the Line object.
Usage
-----
* plot(Y, ...) plots a 1D signal, with the values plotted along the y-axis
* plot(X, Y, ...) also supplies x coordinates
* plot(X, Y, Z, ...) also supplies z coordinates
* plot(P, ...) plots using a Point or Pointset instance
Keyword arguments
-----------------
(The longer names for the line properties can also be used)
lw : scalar
lineWidth. The width of the line. If zero, no line is drawn.
mw : scalar
markerWidth. The width of the marker. If zero, no marker is drawn.
mew : scalar
markerEdgeWidth. The width of the edge of the marker.
lc : 3-element tuple or char
lineColor. The color of the line. A tuple should represent the RGB
values between 0 and 1. If a char is given it must be
one of 'rgbmcywk', for reg, green, blue, magenta, cyan, yellow,
white, black, respectively.
mc : 3-element tuple or char
markerColor. The color of the marker. See lineColor.
mec : 3-element tuple or char
markerEdgeColor. The color of the edge of the marker.
ls : string
lineStyle. The style of the line. (See below)
ms : string
markerStyle. The style of the marker. (See below)
axesAdjust : bool
If axesAdjust==True, this function will call axes.SetLimits(), set
the camera type to 2D when plotting 2D data and to 3D when plotting
3D data. If daspectAuto has not been set yet, it is set to True.
axes : Axes instance
Display the image in this axes, or the current axes if not given.
Line styles
-----------
* Solid line: '-'
* Dotted line: ':'
* Dashed line: '--'
* Dash-dot line: '-.' or '.-'
* A line that is drawn between each pair of points: '+'
* No line: '' or None.
Marker styles
-------------
* Plus: '+'
* Cross: 'x'
* Square: 's'
* Diamond: 'd'
* Triangle (pointing up, down, left, right): '^', 'v', '<', '>'
* Pentagram star: 'p' or '*'
* Hexgram: 'h'
* Point/cirle: 'o' or '.'
* No marker: '' or None
"""
# create a dict from the properties and combine with kwargs
tmp = { 'lineWidth':lw, 'lineColor':lc, 'lineStyle':ls,
'markerWidth':mw, 'markerColor':mc, 'markerStyle':ms,
'markerEdgeWidth':mew, 'markerEdgeColor':mec}
for i in tmp:
if not i in kwargs:
kwargs[i] = tmp[i]
# init dimension variable
camDim = 0
## create the data
# If one argument is given, and it looks like a pointset stored
# in a numpy array, use it as such
if isinstance(data1, np.ndarray) and (data2 is None) and (data3 is None):
if data1.ndim == 2 and data1.shape[1] in (2,3):
data1 = Pointset(data1) # Use shape as given
if is_Pointset(data1):
pp = data1
elif is_Point(data1):
pp = Pointset(data1.ndim)
pp.append(data1)
else:
if data1 is None:
raise Exception("The first argument cannot be None!")
data1 = np.asanyarray(data1)
d3 = data3
if data3 is None:
data3 = 0.1*np.ones(data1.shape)
camDim = 2
else:
camDim = 3
data3 = np.asanyarray(data3)
if data2 is None:
if d3 is not None:
tmp = "third argument in plot() ignored, as second not given."
print("Warning: " + tmp)
# y data is given, xdata must be a range starting from 1
data2 = data1
data1 = np.arange(1,data2.shape[0]+1)
data3 = 0.1*np.ones(data2.shape)
else:
data2 = np.asanyarray(data2)
# check dimensions
L = data1.size
if L != data2.size or L != data3.size:
raise Exception("Array dimensions do not match! %i vs %i vs %i" %
(data1.size, data2.size, data3.size))
# build points
data1 = data1.reshape((data1.size,1))
data2 = data2.reshape((data2.size,1))
data3 = data3.reshape((data3.size,1))
# Concatenate to a single Nx3 array (take care of masked arrays)
tmp = data1, data2, data3
if any([isinstance(d, np.ma.MaskedArray) for d in tmp]):
pp = np.ma.concatenate(tmp, 1)
else:
pp = np.concatenate(tmp, 1)
# Process camdim for given points or pointsets
if not camDim:
camDim = max(2, pp.ndim)
## create the line
if axes is None:
axes = vv.gca()
l = vv.Line(axes, pp)
l.lw = kwargs['lineWidth']
l.lc = kwargs['lineColor']
l.ls = kwargs['lineStyle']
l.mw = kwargs['markerWidth']
l.mc = kwargs['markerColor']
l.ms = kwargs['markerStyle']
l.mew = kwargs['markerEdgeWidth']
l.mec = kwargs['markerEdgeColor']
l.alpha = alpha
## done...
if axesAdjust:
if axes.daspectAuto is None:
axes.daspectAuto = True
axes.cameraType = str(camDim)+'d'
axes.SetLimits()
axes.Draw()
return l
