Data Sources in Object Groups (GNU Octave (version 11.2.0))

#### 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.