Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
""" List Plots """ from __future__ import absolute_import from six.moves import range
from sage.structure.element import is_Matrix from sage.matrix.all import matrix from sage.rings.all import RDF
def list_plot3d(v, interpolation_type='default', texture="automatic", point_list=None, **kwds): r""" A 3-dimensional plot of a surface defined by the list `v` of points in 3-dimensional space.
INPUT:
- ``v`` - something that defines a set of points in 3 space, for example:
- a matrix
- a list of 3-tuples
- a list of lists (all of the same length) - this is treated the same as a matrix.
- ``texture`` - (default: "automatic", a solid light blue)
OPTIONAL KEYWORDS:
- ``interpolation_type`` - 'linear', 'clough' (CloughTocher2D), 'spline'
'linear' will perform linear interpolation
The option 'clough' will interpolate by using a piecewise cubic interpolating Bezier polynomial on each triangle, using a Clough-Tocher scheme. The interpolant is guaranteed to be continuously differentiable. The gradients of the interpolant are chosen so that the curvature of the interpolating surface is approximatively minimized.
The option 'spline' interpolates using a bivariate B-spline.
When v is a matrix the default is to use linear interpolation, when v is a list of points the default is 'clough'.
- ``degree`` - an integer between 1 and 5, controls the degree of spline used for spline interpolation. For data that is highly oscillatory use higher values
- ``point_list`` - If point_list=True is passed, then if the array is a list of lists of length three, it will be treated as an array of points rather than a 3xn array.
- ``num_points`` - Number of points to sample interpolating function in each direction, when ``interpolation_type`` is not ``default``. By default for an `n\times n` array this is `n`.
- ``**kwds`` - all other arguments are passed to the surface function
OUTPUT: a 3d plot
EXAMPLES:
We plot a matrix that illustrates summation modulo `n`.
::
sage: n = 5; list_plot3d(matrix(RDF, n, [(i+j)%n for i in [1..n] for j in [1..n]])) Graphics3d Object
We plot a matrix of values of sin.
::
sage: pi = float(pi) sage: m = matrix(RDF, 6, [sin(i^2 + j^2) for i in [0,pi/5,..,pi] for j in [0,pi/5,..,pi]]) sage: list_plot3d(m, texture='yellow', frame_aspect_ratio=[1, 1, 1/3]) Graphics3d Object
Though it doesn't change the shape of the graph, increasing num_points can increase the clarity of the graph.
::
sage: list_plot3d(m, texture='yellow', frame_aspect_ratio=[1, 1, 1/3], num_points=40) Graphics3d Object
We can change the interpolation type.
::
sage: import warnings sage: warnings.simplefilter('ignore', UserWarning) sage: list_plot3d(m, texture='yellow', interpolation_type='clough', frame_aspect_ratio=[1, 1, 1/3]) Graphics3d Object
We can make this look better by increasing the number of samples.
::
sage: list_plot3d(m, texture='yellow', interpolation_type='clough', frame_aspect_ratio=[1, 1, 1/3], num_points=40) Graphics3d Object
Let's try a spline.
::
sage: list_plot3d(m, texture='yellow', interpolation_type='spline', frame_aspect_ratio=[1, 1, 1/3]) Graphics3d Object
That spline doesn't capture the oscillation very well; let's try a higher degree spline.
::
sage: list_plot3d(m, texture='yellow', interpolation_type='spline', degree=5, frame_aspect_ratio=[1, 1, 1/3]) Graphics3d Object
We plot a list of lists::
sage: show(list_plot3d([[1, 1, 1, 1], [1, 2, 1, 2], [1, 1, 3, 1], [1, 2, 1, 4]]))
We plot a list of points. As a first example we can extract the (x,y,z) coordinates from the above example and make a list plot out of it. By default we do linear interpolation.
::
sage: l = [] sage: for i in range(6): ....: for j in range(6): ....: l.append((float(i*pi/5), float(j*pi/5), m[i, j])) sage: list_plot3d(l, texture='yellow') Graphics3d Object
Note that the points do not have to be regularly sampled. For example::
sage: l = [] sage: for i in range(-5, 5): ....: for j in range(-5, 5): ....: l.append((normalvariate(0, 1), normalvariate(0, 1), normalvariate(0, 1))) sage: L = list_plot3d(l, interpolation_type='clough', texture='yellow', num_points=100) sage: L Graphics3d Object
Check that no NaNs are produced (see :trac:`13135`)::
sage: any(math.isnan(c) for v in L.vertices() for c in v) False
TESTS:
We plot 0, 1, and 2 points::
sage: list_plot3d([]) Graphics3d Object
::
sage: list_plot3d([(2, 3, 4)]) Graphics3d Object
::
sage: list_plot3d([(0, 0, 1), (2, 3, 4)]) Graphics3d Object
However, if two points are given with the same x,y coordinates but different z coordinates, an exception will be raised::
sage: pts =[(-4/5, -2/5, -2/5), (-4/5, -2/5, 2/5), (-4/5, 2/5, -2/5), (-4/5, 2/5, 2/5), (-2/5, -4/5, -2/5), (-2/5, -4/5, 2/5), (-2/5, -2/5, -4/5), (-2/5, -2/5, 4/5), (-2/5, 2/5, -4/5), (-2/5, 2/5, 4/5), (-2/5, 4/5, -2/5), (-2/5, 4/5, 2/5), (2/5, -4/5, -2/5), (2/5, -4/5, 2/5), (2/5, -2/5, -4/5), (2/5, -2/5, 4/5), (2/5, 2/5, -4/5), (2/5, 2/5, 4/5), (2/5, 4/5, -2/5), (2/5, 4/5, 2/5), (4/5, -2/5, -2/5), (4/5, -2/5, 2/5), (4/5, 2/5, -2/5), (4/5, 2/5, 2/5)] sage: show(list_plot3d(pts, interpolation_type='clough')) Traceback (most recent call last): ... ValueError: Two points with same x,y coordinates and different z coordinates were given. Interpolation cannot handle this.
Additionally we need at least 3 points to do the interpolation::
sage: mat = matrix(RDF, 1, 2, [3.2, 1.550]) sage: show(list_plot3d(mat, interpolation_type='clough')) Traceback (most recent call last): ... ValueError: We need at least 3 points to perform the interpolation """ else:
return list_plot3d(matrix(v), interpolation_type, texture, **kwds)
# return empty 3d graphic # return a point # return a line else: raise TypeError("v must be a matrix or list")
def list_plot3d_matrix(m, texture, **kwds): """ A 3-dimensional plot of a surface defined by a matrix ``M`` defining points in 3-dimensional space. See :func:`list_plot3d` for full details.
INPUT:
- ``M`` - a matrix - ``texture`` - (default: "automatic", a solid light blue)
OPTIONAL KEYWORDS:
- ``**kwds`` - all other arguments are passed to the surface function
OUTPUT: a 3d plot
EXAMPLES:
We plot a matrix that illustrates summation modulo `n`::
sage: n = 5; list_plot3d(matrix(RDF, n, [(i+j)%n for i in [1..n] for j in [1..n]])) # indirect doctest Graphics3d Object
The interpolation type for matrices is 'linear'; for other types use other :func:`list_plot3d` input types.
We plot a matrix of values of `sin`::
sage: pi = float(pi) sage: m = matrix(RDF, 6, [sin(i^2 + j^2) for i in [0,pi/5,..,pi] for j in [0,pi/5,..,pi]]) sage: list_plot3d(m, texture='yellow', frame_aspect_ratio=[1, 1, 1/3]) # indirect doctest Graphics3d Object sage: list_plot3d(m, texture='yellow', interpolation_type='linear') # indirect doctest Graphics3d Object
Here is a colored example, using a colormap and a coloring function which must take values in (0, 1)::
sage: cm = colormaps.rainbow sage: n = 20 sage: cf = lambda x, y: ((2*(x-y)/n)**2) % 1 sage: list_plot3d(matrix(RDF, n, [cos(pi*(i+j)/n) for i in [1..n] ....: for j in [1..n]]), color=(cf,cm)) Graphics3d Object
.. PLOT::
cm = colormaps.rainbow cf = lambda x, y: ((2*(x-y)/20)**2) % 1 expl = list_plot3d(matrix(RDF,20,20,[cos(pi*(i+j)/20) for i in range(1,21) for j in range(1,21)]),color=(cf,cm)) sphinx_plot(expl) """ texture=texture, **kwds)
def list_plot3d_array_of_arrays(v, interpolation_type, texture, **kwds): """ A 3-dimensional plot of a surface defined by a list of lists ``v`` defining points in 3-dimensional space. This is done by making the list of lists into a matrix and passing back to :func:`list_plot3d`. See :func:`list_plot3d` for full details.
INPUT:
- ``v`` - a list of lists, all the same length - ``interpolation_type`` - (default: 'linear') - ``texture`` - (default: "automatic", a solid light blue)
OPTIONAL KEYWORDS:
- ``**kwds`` - all other arguments are passed to the surface function
OUTPUT: a 3d plot
EXAMPLES:
The resulting matrix does not have to be square::
sage: show(list_plot3d([[1, 1, 1, 1], [1, 2, 1, 2], [1, 1, 3, 1]])) # indirect doctest
The normal route is for the list of lists to be turned into a matrix and use :func:`list_plot3d_matrix`::
sage: show(list_plot3d([[1, 1, 1, 1], [1, 2, 1, 2], [1, 1, 3, 1], [1, 2, 1, 4]]))
With certain extra keywords (see :func:`list_plot3d_matrix`), this function will end up using :func:`list_plot3d_tuples`::
sage: show(list_plot3d([[1, 1, 1, 1], [1, 2, 1, 2], [1, 1, 3, 1], [1, 2, 1, 4]], interpolation_type='spline')) """
def list_plot3d_tuples(v, interpolation_type, texture, **kwds): r""" A 3-dimensional plot of a surface defined by the list `v` of points in 3-dimensional space.
INPUT:
- ``v`` - something that defines a set of points in 3 space, for example:
- a matrix
This will be if using an interpolation type other than 'linear', or if using ``num_points`` with 'linear'; otherwise see :func:`list_plot3d_matrix`.
- a list of 3-tuples
- a list of lists (all of the same length, under same conditions as a matrix)
- ``texture`` - (default: "automatic", a solid light blue)
OPTIONAL KEYWORDS:
- ``interpolation_type`` - 'linear', 'clough' (CloughTocher2D), 'spline'
'linear' will perform linear interpolation
The option 'clough' will interpolate by using a piecewise cubic interpolating Bezier polynomial on each triangle, using a Clough-Tocher scheme. The interpolant is guaranteed to be continuously differentiable.
The option 'spline' interpolates using a bivariate B-spline.
When v is a matrix the default is to use linear interpolation, when v is a list of points the default is 'clough'.
- ``degree`` - an integer between 1 and 5, controls the degree of spline used for spline interpolation. For data that is highly oscillatory use higher values
- ``point_list`` - If point_list=True is passed, then if the array is a list of lists of length three, it will be treated as an array of points rather than a `3\times n` array.
- ``num_points`` - Number of points to sample interpolating function in each direction. By default for an `n\times n` array this is `n`.
- ``**kwds`` - all other arguments are passed to the surface function
OUTPUT: a 3d plot
EXAMPLES:
All of these use this function; see :func:`list_plot3d` for other list plots::
sage: pi = float(pi) sage: m = matrix(RDF, 6, [sin(i^2 + j^2) for i in [0,pi/5,..,pi] for j in [0,pi/5,..,pi]]) sage: list_plot3d(m, texture='yellow', interpolation_type='linear', num_points=5) # indirect doctest Graphics3d Object
::
sage: list_plot3d(m, texture='yellow', interpolation_type='spline', frame_aspect_ratio=[1, 1, 1/3]) Graphics3d Object
::
sage: show(list_plot3d([[1, 1, 1], [1, 2, 1], [0, 1, 3], [1, 0, 4]], point_list=True))
::
sage: list_plot3d([(1, 2, 3), (0, 1, 3), (2, 1, 4), (1, 0, -2)], texture='yellow', num_points=50) # long time Graphics3d Object """
# If the (x,y)-coordinates lie in a one-dimensional subspace, the # matplotlib Delaunay code segfaults. Therefore, we compute the # correlation of the x- and y-coordinates and add small random # noise to avoid the problem if needed. ep = float(.000001) x = [float(p[0]) + random()*ep for p in v] y = [float(p[1]) + random()*ep for p in v]
# If the list of data points has two points with the exact same # (x,y)-coordinate but different z-coordinates, then we sometimes # get segfaults. The following block checks for this and raises # an exception if this is the case. # We also remove duplicate points (which matplotlib can't handle). # Alternatively, the code in the if block above which adds random # error could be applied to perturb the points. elif z[i] == z[j]: drop_list.append(j)
#arbitrary choice - assuming more or less a nxn grid of points # x should have n^2 entries. We sample 4 times that many points.
|