trfloadx

(trf.tbx/trfloadx.m)

Function Synopsis

ds = trfloadx(trfh, runs, vars, mintime, maxtime,other);

Help text

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

 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.
 other:   The other way to load data: one needs specify loading variables in different
          runs. The other variable should have the format:
          other = [run1, var11,var12,...,-1,run2,var21,var22,...,-1,....,-1].
          If the var is set to be zero, it means load all variables for this run.
          But we can't set run number to be zero.

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

Cross-Reference Information

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