SDT-base         Contents     Functions              PDF Index

sdtm

• pause
• save,-safe
• urn , urnCb, urnValG, urnObj ...
• range
• store
• to ...
• node ...

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

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.