GNU Octave: Data Sources in Object Groups

Next: Area Series, Up: Object Groups [Contents][Index]

#### 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 graphic handles, 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