Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Français - Português - 日本語
Справка Scilab >> Графики > axes_operations > replot

replot

redraw with new boundaries the current or a given set of axes

Syntax

replot()
replot(area)
replot(idAxes)
replot(area, idAxes)
replot(.., tight_limits)

Arguments

area

row vector [xmin ymin xmax ymax] or [xmin ymin zmin xmax ymax zmax]: new bounds of the area to be replotted.

  • %nan can be used to keep a bound as is.
  • %inf can be used to set a bound to the position of the most marginal graphical component existing in the axes, for the considered direction.
The default area is [%inf %inf %inf %inf] for a 2D axes, or [%inf %inf %inf %inf %inf %inf] for a 3D one.

If N axes are identified in idAxes, area may be a matrix with N rows and 4 or 6 columns. The row #i is then related to the axes #i of idAxes. If area is only a vector of 4 or 6 bounds, these ones are used for all axes to be reframed.

idAxes

Vector of graphic handles, expected to be of Axes type or to have direct children of type Axes, such as Figures or some frame uicontrols. idAxes specifies direct or children Axes to crop. If no axes is found, nothing is done.

By default, the current Axes is considered.

tight_limits

Single word "tight" or "on" or "off", or vector of 2 (in 2D) or 3 (in 3D) words "tight" or "on" or "off". If a single word is provided, it is used for every axis. This option forces the .tight_limits attribute of considered axes to the specified "on" or "off" values. By default, current limits modes are unchanged.

Description

replot is used to reframe the (set of) axes specified with idAxes -- or by default the current axes -- with new boundaries defined by area = [xmin,ymin, xmax,ymax] or area = [xmin,ymin,zmin, xmax,ymax,zmax].

It changes the data_bounds attribute of processed axes.

When a specified bound is infinite (%inf and -%inf are equivalent), replot looks for the most marginal graphical object and sets the actual related bound to its position, taking also objects sizes into account. This ensures not clipping any object that would be beyond the targeted side of the axes.

When the tight_limits option is provided, its value is assigned to the .tight_limits attribute of each considered axes, in an axis-wise way.

Examples

x = [0:0.1:2*%pi]';
plot2d(x,sin(x))
replot([-1,-1,10,2])
xdel(winsid());
plot() // plot demo
f = gcf();
replot([-1,-1,10,2],f.children(1)) // specify axes handle's value
replot([-3,-2,8,4],f.children(2))
// Leaving some bounds as is with %nan:
x = linspace(0,360,200).';
clf
plot2d(x,[sind(x) tand(x)])
ax = gca();
ax.data_bounds              // initial bounds
replot([%nan,-10,%nan,10])  // only Ymin and Ymax are changed
ax.data_bounds              // updated bounds

// Resizing Z bounds as well as X and Y ones in 3D view:
clf
x = linspace(-4,4,100);
X = meshgrid(x);
R = (X-0.5).^2 + (X.'+0.7).^2;
Z = sinc(R);
surf(x-0.5,x+0.7,Z)
f = gcf();
f.color_map = autumncolormap(100);
ax = gca();
ax.data_bounds
sleep(3000)
replot([-5 0 -0.4 0 5 0.5])
ax.data_bounds

// Resizing several chosen axes together:
clf
x = linspace(-%pi,%pi,400);
subplot(2,2,1)
plot2d(x,sin(1 ./sqrt(abs(x))))
ax1 = gca();
subplot(2,2,2)
plot2d(x,sinh(sqrt(abs(x))))
subplot(2,1,2)
plot2d(x,cos(1 ./sqrt(abs(x))))
ax2 = gca();
sleep(4000)
f = gcf();
replot([-1 %nan 1.5 %nan], [ax1 ax2])

See also

  • zoom_rect — zoom a selection of the current graphic figure
  • rubberbox — растягиваемая рамка для прямоугольного выделения
  • axes_properties — description of the axes entity properties

History

ВерсияОписание
5.5.0
  • Extension to 3D
  • axesHandles vectorized
  • %nan can be used to keep a bound as is.
6.0
  • Handles of frame uicontrols having Axes children are now accepted.
  • %inf can now be used to set a bound to the position of most marginal contents.
  • replot() as replot([%inf %inf %inf %inf]) is added.
  • Option tight_limits added.
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 14 15:13:26 CET 2017