11 Porting From PLoT <= 5.1.3

If it seems porting will take too long, you can get your old code running more quickly using the Compatibility Module.

You should also set (plot-deprecation-warnings? #t) to be alerted to uses of deprecated features.

11.1 Replacing Deprecated Functions

Replace mix with list, and replace surface with surface3d. These functions are drop-in replacements, but surface3d has many more features (and a name more consistent with similar functions).

Replace line with function, parametric or polar, depending on the keyword arguments to line. These are not at all drop-in replacements, but finding the right arguments should be straightforward.

Replace contour with contours, and replace shade with contour-intervals. These are mostly drop-in replacements: they should always work, but may not place contours at the same values (unless the levels are given as a list of values). For example, the default #:levels argument is now 'auto, which chooses contour values in the same way that z axis tick locations are usually chosen in 3D plots. The number of contour levels is therefore some number between 4 and 10, depending on the plot.

11.2 Ensuring That Plots Have Bounds

The safest way to ensure that plot can determine bounds for the plot area is to add #:x-min -5 #:x-max 5 #:y-min -5 #:y-max 5 to every call to plot. Similarly, add #:x-min -5 #:x-max 5 #:y-min -5 #:y-max 5 #:z-min -5 #:z-max 5 to every call to plot3d.

Because PLoT is now smarter about choosing bounds, there are better ways. For example, suppose you have

> (plot (line sin))

plot: could not determine sensible plot bounds; got x ∈ [#f,#f], y ∈ [#f,#f]

You could either change it to

> (plot (function sin) #:x-min -5 #:x-max 5 #:y-min -5 #:y-max 5)

or change it to

> (plot (function sin -5 5))

When function is given x bounds, it determines tight y bounds.

11.3 Changing Keyword Arguments

Replace every #:width in a call to vector-field with #:line-width.

Replace every #:style 'scaled with #:scale 'auto (or because it is the default in both the old and new, take it out).

Replace every #:style 'real with #:scale 1.0.

Replace every #:style 'normalized with #:scale 'normalized.

The plot and plot3d functions still accept #:bgcolor, #:fgcolor and #:lncolor, but these are deprecated. Parameterize on plot-background and plot-foreground instead.

Change #:az in calls to plot3d to #:angle, and #:alt to #:altitude. Alternatively, parameterize multiple plots by setting the plot3d-angle and plot3d-altitude parameters.

11.4 Fixing Broken Calls to points

The points function used to be documented as accepting a (listof (vector/c real? real?)), but actually accepted a (listof (vectorof real?)) and silently ignored any extra vector elements.

If you have code that takes advantage of this, strip down the vectors first. For example, if vs is the list of vectors, send (map (λ (v) (vector-take v 2)) vs) to points.

11.5 Replacing Uses of plot-extend

Chances are, if you used plot-extend, you no longer need it. The canonical plot-extend example used to be a version of line that drew dashed lines. Every line-drawing function in PLoT now has a #:style or #:line-style keyword argument.

The rewritten PLoT will eventually have a similar extension mechanism.

11.6 Deprecated Functions

The following functions exist for backward compatibility, but may be removed in the future. Set (plot-deprecation-warnings? #t) to be alerted the first time each is used.