Generic URN conventions

SDT-base Contents Functions

8.4 Generic URN conventions

urn, stands for Uniform Resource Name, which are used in SDT to designate, select or build objects. This is used throughout SDT for models, GUI, design or experiments.

8.4.1 Format dependent string conversion (urnCb, urnVal)

The specification of callbacks is handled by sdtm.urnCb which follows the rules

@fun is translated to the function handle @fun and the callback is executed using fun(obj,evt).
fun@cmd assumes that fun contains a subfunction cmd and that a handle to it is obtained using fun('@cmd').
fun(cmd) is translated to {@fun,cmd} and the callback is executed using fun(obj,evt,cmd).
after transformation to a cell array. When the URN is evaluated made within a function, strings of the form '$var' are replaced by the local variable var in the function calling sdtm.urnCb. For example a=101;cb=sdtm.urnCb('disp($a)');feval(cb{:}).

Vector generation handled by sdtm.urnValG (which is called with the %g format)

numeric values are not transformed.
@log(lmin,lmax,n) uses logspace(lmin,max,n). @ll(min,max,n) uses logspace(log10(lmin),log10(max),n). @lin(min,max,n) uses linspace(lmin,max,n).
{a,b} is converted to a numeric vector [a,b].
/str returns 1./val with val the interpretation of str.

Vector generation handled by sdtm.urnValUG (which is called with the %ug format) eases the specification of units by considering the following replacements : nano n by 1e-9, micro u by 1e-6, milli m by 1e-3,unit no replacement, kilo k by 1e3, mega M by 1e6, giga G by 1e9.

Vector generation handled by sdtm.urnValS (which is called with variants of the %s format)

%s,g,.,dim transforms to/from a numeric matrix with dim columns.
%s,s,1 transforms to/from a cell array of strings with 1 row.

8.4.2 Search for graphical objects by name sdth.urn

This is a partial list of ongoing uniformed naming of graphical objects. The naming can be

absolute as in cf=sdth.urn('Dock.Id.ci') where there can only be a single Id dock and it contains a main iiplot figure labeled ci
relative to a graphical object as in ub=sdth.urn('Tab.Channel',gf) where gf can be a figure number, or an SDT handle pointing to feplot, iiplot figure.
relative to a structure as in Case=sdth.urn('Case 1',model) where one will search the model stack, the case stack, ...

To identify feplot or iiplot figures use cf=sdth.urn('feplot(20)');
To access comgui dock use cf=sdth.urn('Dock.Name'). You can then point to figures contained within the dock thus
- cf=sdth.urn('Dock.Id.ci') is the main iiplot figure of the dockid. The main SDT docks are Id, CoTopo, CoShape.
- cf=sdth.urn('Dock.Id.cf') the feplot figure. .cipro property figure where tabs are located.
- cg=sdth.urn('Dock.Id.ci.Clone{20}'); opens a clone of the iiplot figure.
- gf=sdth.urn('dock.Id.AutoMACIdMain'); returns the figure handle for a figure whose tag or SdtName is AutoMACIdMain. Know names are SumI, Cluster, StabD, FvsDTrack, MIF, ...
- sdth.urn('dock.id.Figure{StabD,MIF tile holder}');
- cj=sdth.urn('Dock.Id.iiplot{Elec,Tile Mif Holder}'); force specific tile.
to access and manipulate tabs
- ub=sdth.urn('Tab.Channel',gf) get structure associated with the channel tab of figure gf
- u0=sdth.urn('iiplot(2).Tab.Ident'); alternative where you specify the figure by name then the tab.
- Tab(Name,Item) allows selection of a tab by name and possibly use of Item to select items in the main list using regular expressions. For example sdth.urn('Tab(Cases,Point.*1){Proview,on}',cf) selects the Point.*1 entry(ies) and clicks on the ProView button.
- .Report implements report generation commands associated with the selected object.
- sdth.urn('Tab.MDRE.repaint',UI.gf) forces refresh of java object.
to access information in a model (fields, Stack entries, nmap values)
- to deal with node, material, ... maps pro=sdth.urn('nmap.pro."Std_shell_[3]"',model)
mat=sdth.urn('SPPI-01-03 12dpi 48k RCT45 VF58',mo1);

8.4.3 Specification of graphical objects (urnObj)

to generate MATLAB objects with sdtm.urnObj commands. Execute sdtm.urnObj in the MATLAB console to display the list and syntax of urnObj commands.
Example : The Dlg syntax is Dlg{Message%s,title%s,type%s}:{T%g} meaning that an urnObj string that begins with Dlg parses the 3 first mandatory arguments as window Message, title and type.
The optional arguments must specify the argument name (here the automatic closing time T) followed by the argument value. Arguments are given between braces and coma separated.
Thus sdtm.urnObj('Dlg{"Job end","error!",error,T5}') opens an error window titled error! with the message Job end and a automatic closing time after 5 seconds.
- Tog is used to generate uitooggletool objects.
- Push generates uipushtool objects.
- Dlg opens window (info, warning, error,...) with message, title and optional automatic closing time.
- Link{compA,compB,p{properties }} is used to link properties of multiple axes (used in dockId for example.

8.4.4 String conversion DOE events (urnSig)

Conventions DOE nomenclature

fun(Designation) uses function handle @fun to interpret the Designation. The first definition of such a main function is kept until another is used.
The designations are typically split using column separators :. Thus sdtsys('UrnSig','dt48u:Cst(2):Tri(1,/60,1,k50') considers a sequence of 3 definitions dt48u which sets the time step. Cst(2) for a constant value maintained for 2 seconds, ...