DataObject.Add_OBSTAT_Var

Prototypes

void Add_OBSTAT_Var()

Parameters

None

Remarks

This method adds or updates the SAS/INSIGHT-compatible _OBSTAT_ variable. If a variable named _OBSTAT_ does not exist in the DataObject, this method adds an _OBSTAT_ variable. If a variable named _OBSTAT_ already exists, this method updates the values of the existing _OBSTAT_ variable.

SAS/INSIGHT uses a special, hidden character variable named _OBSTAT_ to encode observation properties. The following observation properties are encoded in the _OBSTAT_ variable:

• Selection state
  (If the DataObject is in Local Selection Mode, an observation is considered selected if it is selected in any Selector view.)
• IncludeInPlots flag
• IncludeInAnalysis flag
• Marker shape
• Marker color
  (SAS/INSIGHT does not support both a fill color and an outline color, so the method Add_OBSTAT_Var only encodes the IML Studio fill color.)

IML Studio normally stores observation properties in a separate file with the extension .dmm. However, there may be times when you want to use observation properties in a DATA or PROC step. Because the SAS server cannot access information contained in a client-side .dmm file, you can use the method Add_OBSTAT_Var to encode the observation properties in a SAS data set. There may also be times when you want to export a SAS data set from IML Studio for use with SAS/INSIGHT.

Example

declare DataObject dobj;
dobj = DataObject.Create( "Example" );
x = 1:10;
dobj.AddVar( "X", x );
dobj.SetMarkerShape( 1:5, MARKER_TRIANGLE );
dobj.SetMarkerFillColor( 6:10, RED );
dobj.Add_OBSTAT_Var();
DataTable.Create( dobj ).ActivateWindow();