Ctrl+K

sdtm

sdtm#

Purpose

Name space for public methods implementing base SDT operations.

Syntax

  methods(sdtm) % do list methods
  sdtweb('_taglist','sdtm') % to list tags and access associated code

Description

sdtm groups a number of methods of general interest.

pause#

Runs a robust pause with the same arguments than the MATLAB pause command. This one avoids memory leaks and avoids skips occurring in batch mode for some MATLAB versions.

save,-safe#

High level handling of saving to MAT-files. This function integrates saving with exploitation of saving preferences, filename and robustness. It uses sdth.fileutil('fsafe','save') .

  • Use of SDT.V6Flag preferences as options to the save function.
  • Robust saving options handling with version save append incompatibilities
  • Shortcut to using ProjectWd using @ProjectWd in save path.
  • use token -noh to force use of MATLAB save function. 
r1=struct('val',10);
r2=25;
% setup saving options
% use V6Flag-setpred to make this permanent
sdtdef('V6Flag',{'-v7.3','-nocompression'});
% generate a file name
f1=nas2up('tempname.mat')
% call save
sdtm.save(f1,'r1');
sdtm.save(f1,'r2','-append')
% example using ProjectWd
[wd1,f1,ext]=fileparts(f1);
sdtroot('setProject',struct('ProjectWd',wd1));
sdtm.save(struct('UI','SDT Root','FileName',fullfile('@ProjectWd',[f1 ext])),'r2')
% clear file
sdth.fileutil('fsafe','delete',fullfile(wd1,[f1 ext]));

urn , urnCb, urnValG, urnObj ...#

urn which stands for Uniform Resource Name (section 8.4) utilities are

  • urnCb build callback cell
  • urnValG transform string to double value/matrix see sdtm.urnValG.
  • urnPar parse input string to structure parameter name/value pairs see sdtm.urnPar
  • urnObj interpret urn to generate Matlab objects see sdtm.urnObj

busyWindow#

See section 8.6.1

range#

Provides a uniform entry point to run series of experiments doe. Parameters of the experiments are listed in a range (see fe_range).

store#

Uniform description of how to store results of a step.

  • sdtm.store(targHandle,'{q0/d2}') save to a given target handle. Typical targets are projM project vhandle.nmap, ci iiplot handle, cf feplot handle, UI where this refers to a project GUI through the MainFcn.
  • sdtm.store('Dock.Id.cf(2)model/Sens') string where the target is obtained using a a sdth.urn call.

to ...#

to... methods are used for robust conversion to specific types using testing of object content to decide on the proper conversion methodology. sdtm.toString converts any object to a string. sdtm.toStruct converts to a MATLAB struct. sdtm.toCinCell converts to the SDT java object associated with a table cell.

node ...#

node... methods implement robust loading of data files for integration in a database object. This is an ongoing development that will be further detailed.

sdtm.nodeLoadSE(FileName,RO) is a robust superelement loading strategy. Options can be given as fields of the RO structure.

  • RO.Code defaults to femlink('fun',FileName); but can be given manually.
Contents