---

15.4.6.1 Data Sources in Object Groups ¶

All of the group objects contain data source parameters. There are string parameters that contain an expression that is evaluated to update the relevant data property of the group when the refreshdata function is called.

 

refreshdata () ¶

refreshdata (h) ¶

refreshdata (h, workspace) ¶

Evaluate any ‘datasource’ properties of the current figure and update the plot if the corresponding data has changed.

If the first argument h is a list of graphics handles to figure, axes, or graphic objects with a DataSource property, then operate on these objects rather than the current figure returned by gcf.

The optional second argument workspace can take the following values:

"base"

Evaluate the datasource properties in the base workspace. (default).

"caller"

Evaluate the datasource properties in the workspace of the function that called refreshdata.

An example of the use of refreshdata is:

x = 0:0.1:10;
y = sin (x);
plot (x, y, "ydatasource", "y");
for i = 1 : 100
  pause (0.1);
  y = sin (x + 0.1*i);
  refreshdata ();
endfor

Programming Note: For performance, specify h as the actual object(s) to be updated. If no object is supplied then Octave must search through all graphic objects of the current figure and determine which ones have DataSource properties that are not empty.