SDT-base         Contents     Functions              PDF Index

vhandle.nmap

Purpose

Class constructor for SDT name map handle objects.

Description

Examples can be found in d_feplot('TutoVhandle.nmap').

nmap handle objects is a handle to a containers.Map which stores several maps linking names to identifiers. The list of common maps can be found below in the documentation below.

The list of maps stored in nmap can be retrieved with command keys(nmap). The value associated with the nmap key (for example the map named Map:Nodes) is itself a containers.Map used to link names (as keys) with identifiers (as values).

Syntax sdth.urn

To ease operations on these maps, the sdth.urn methods supports a number of overloads. Commands below illustrate main manipulations with sdth.urn methods, applied on the map Map:Nodes

This development is still not fully stable and you should look at test examples in d_feplot('vhandle.nmap')

• set the correspondence between node names and values using a structure

   mo1=sdth.urn('nmap.Node.set',mo1,struct('value',1:4,'ID',{{'A','B','C','D'}}));
  

• set using a list of strings giving ID:name

   mo1=sdth.urn('nmap.Node.set',mo1,{'1:A','2:B'});
  

• get from map nodes, names or simply display with no output argument

   [n1,name]=sdth.urn... % get node and name
             sdt.urn ... % display names and nodes in the console
   % Without output, display in console : NodeName = Nodeid, matid proid gid, x y z
   sdth.urn('nmap.Node',mo1,{'A','B'}) % Get from names
   sdth.urn('nmap.Node',mo1,{1,2}) % Get from id
   sdth.urn('nmap.Node',mo1,'[AB]') % Get from matched regular expressions on names
   [n1,name]=sdth.urn('nmap.Node',mo1,{'A','[CD]',2}) % Get from mixed ID/name/regular exp list
   [n1,name]=sdth.urn('nmap.Node.{A,[CD],2}',mo1) % Alternate call format with node selection directly after nmap.Node.
  
   sdth.findobj('_sub.','nmap.Node([1:3 7])') % get from NodeId list
  

• combine two maps using append method

   nodeM1=mo1.nmap('Map:Nodes');
   nodeM2=mo2.nmap('Map:Nodes');
   nodeM1.append(nodeM2)