On this page:
11.1 Replacing Deprecated Functions
11.2 Ensuring That Plots Have Bounds
11.3 Changing Keyword Arguments
11.4 Fixing Broken Calls to points
11.5 Replacing Uses of plot-extend
11.6 Deprecated Functions
mix
line
contour
shade
surface
Version: 5.2.1

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.

The update from PLoT version 5.1.3 to 5.2 introduces a few incompatibilities:
  • PLoT now allows plot elements to request plot area bounds, and finds bounds large enough to fit all plot elements. The old default plot area bounds of [-5,5] × [-5,5] cannot be made consistent with the improved behavior; the default bounds are now "no bounds". This causes code such as (plot (line sin)), which does not state bounds, to fail.

  • The #:width and #:style keyword arguments to vector-field have been replaced by #:line-width and #:scale to be consistent with other functions.

  • The plot function no longer takes a (-> (is-a?/c 2d-view%) void?) as an argument, but a (treeof renderer2d?). The argument change in plot3d is similar. This should not affect most code because PLoT encourages regarding these data types as black boxes.

  • The plot-extend module no longer exists.

  • The fit function and fit-result struct type have been removed.

This section of the PLoT manual will help you port code written for PLoT 5.1.3 and earlier to the most recent PLoT. There are four main tasks:
  • Replace deprecated functions.

  • Ensure that plots have bounds.

  • Change vector-field, plot and plot3d keyword arguments.

  • Fix broken calls to points.

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)

image

or change it to

> (plot (function sin -5 5))

image

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.

For example, if you have (plot (function sin -5 5) #:fgcolor '(0 0 128) #:bgcolor '(224 224 224)), change it to
> (parameterize ([plot-foreground  '(0 0 128)]
                 [plot-background  '(224 224 224)])
    (plot (function sin -5 5)))

image

The #:lncolor keyword argument now does nothing; change the renderer instead. For example, if you have (plot (function sin -5 5) #:lncolor '(0 0 128)), change it to
> (plot (function sin -5 5 #:color '(0 0 128)))

image

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.

(mix plot-data ...)  (any/c . -> . void?)
  plot-data : (any/c . -> . void?)
See Compatibility Module for the original documentation. Replace this with list.

(line f    
  [#:samples samples    
  #:width width    
  #:color color    
  #:mode mode    
  #:mapping mapping    
  #:t-min t-min    
  #:t-max t-max])  renderer2d?
  f : (real? . -> . (or/c real? (vector/c real? real?)))
  samples : (and/c exact-integer? (>=/c 2)) = 150
  width : (>=/c 0) = 1
  color : plot-color/c = 'red
  mode : (one-of/c 'standard 'parametric) = 'standard
  mapping : (one-of/c 'cartesian 'polar) = 'cartesian
  t-min : real? = -5
  t-max : real? = 5
See Compatibility Module for the original documentation. Replace this with function, parametric or polar, depending on keyword arguments.

(contour f    
  [#:samples samples    
  #:width width    
  #:color color    
  #:levels levels])  renderer2d?
  f : (real? real? . -> . real?)
  samples : (and/c exact-integer? (>=/c 2)) = 50
  width : (>=/c 0) = 1
  color : plot-color/c = 'black
  levels : (or/c (and/c exact-integer? (>=/c 2)) (listof real?))
   = 10
See Compatibility Module for the original documentation. Replace this with contours.

(shade f [#:samples samples #:levels levels])  renderer2d?
  f : (real? real? . -> . real?)
  samples : (and/c exact-integer? (>=/c 2)) = 50
  levels : (or/c (and/c exact-integer? (>=/c 2)) (listof real?))
   = 10
See Compatibility Module for the original documentation. Replace this with contour-intervals.

(surface f    
  [#:samples samples    
  #:width width    
  #:color color])  renderer3d?
  f : (real? real? . -> . real?)
  samples : (and/c exact-integer? (>=/c 2)) = 50
  width : (>=/c 0) = 1
  color : plot-color/c = 'black
See Compatibility Module for the original documentation. Replace this with surface3d.