trfload

(trf.tbx/trfload.m)

Function Synopsis

ds = trfload(trfh, runs, vars, mintime, maxtime);

Help text

 Usage: trfhl = trfload(trfh, {runs}, {vars}, {mintime}, {maxtime});

 Description: trfload loads from the specified trf file, the contents of
    all variables specified in runs and/or vars. If runs and/or vars is
    not specified or is the null matrix, then all data is loaded. Mintime
    and maxtime are used to specify the minimum and maximum
    simulation virtual time for which data is to be loaded.

 Input Parameters:
 trfh: A trf_handle created by a previous trf toolbox function.
 runs: An array of run indices, which specify which runs are to be
       loaded.
 vars: An array of variable indices that specifies which variables are to
       be loaded for each run.
 mintime: The minimum simulation virtual time for which data is to be
          loaded. If not specified, then all data up to and including maxtime is
          loaded.
 maxtime: The maximum simulation virtual time for which data is to be
          loaded. If not specified, then all data after and including mintime is
          loaded.

 Return Variables:
 trfhl: A trf_handle containing all of the loaded data. If an error occurs
        during loading the null matrix is returned.

 Known Bugs:
    There is no way to specify loading different variables for distinct
    runs (but this can be done with trfsel). There is no way of specifying
    different minimum and maximum times for distinct runs and distinct
    variables. trfload does not warn the user when he is attempting to load
    too much data into his Matlab session.

Cross-Reference Information

trfloadvar     trf.tbx/trfloadvar.m
trftracerun    trf.tbx/trftracerun.m

trfselcallback trf.tbx/trfselcallback.m