Matrix Operator Samples

About The Samples

In this sample, the TIBCO Streaming® Matrix operator is used to create a list of tuples.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top-level menu, select File>Import Samples and Community Content.

  • Enter matrix to narrow the list of options.

  • Select Matrix Operator from the Data Constructs and Operators category.

  • Click Import Now.

StreamBase Studio creates a single project containing the sample files.

Running The Matrix Samples

AllSelected Sample

In the AllSelected sample, the TIBCO Streaming® Matrix operator is configured to create a list of tuples and output the list only when all the selected values change between the last input tuple and second-to-last input for all the selected fields, which in this sample are the Temperature and Voltage fields.

  1. In the Project Explorer view, open this sample's folder.

    Keep an eye on the bottom right status bar of the Studio window. Make sure any Updating, Downloading, Building, or Rebuild project messages finish before you proceed.

  2. Open the src/main/eventflow/packageName folder.

  3. Double-click to open the Matrix_AllSelected.sbapp module. Make sure the module is the currently active tab in the EventFlow Editor.

  4. Click the Run button. This opens the SB Test/Debug perspective and starts the module.

  5. In the Feed Simulations view, select the available feed simulation and click the Run button.

  6. In the Output Streams view, observe tuples emitted on the DataOut output stream.

  7. Press F9 or click the Stop Running Application button.

AnySelected Sample

In the AnySelected sample, the TIBCO Streaming® Matrix operator is configured to create a list of tuples and output the list only when any of the selected values change between the last input tuple and second-to-last input for all the selected fields, which in this sample is the Temperature and Voltage fields.

  1. In the Project Explorer view, open this sample's folder.

    Keep an eye on the bottom right status bar of the Studio window. Make sure any Updating, Downloading, Building, or Rebuild project messages finish before you proceed.

  2. Open the src/main/eventflow/packageName folder.

  3. Double-click to open the Matrix_AnySelected.sbapp module. Make sure the module is the currently active tab in the EventFlow Editor.

  4. Click the Run button. This opens the SB Test/Debug perspective and starts the module.

  5. In the Feed Simulations view, select the available feed simulation and click the Run button.

  6. In the Output Streams view, observe tuples emitted on the DataOut output stream.

  7. Press F9 or click the Stop Running Application button.

Interval Sample

In the Interval sample, the TIBCO Streaming® Matrix operator is configured to create a list of tuples and output the list every 1 second, with a maximum of 5 tuples in the list.

  1. In the Project Explorer view, open this sample's folder.

    Keep an eye on the bottom right status bar of the Studio window. Make sure any Updating, Downloading, Building, or Rebuild project messages finish before you proceed.

  2. Open the src/main/eventflow/packageName folder.

  3. Double-click to open the Matrix_Interval.sbapp module. Make sure the module is the currently active tab in the EventFlow Editor.

  4. Click the Run button. This opens the SB Test/Debug perspective and starts the module.

  5. In the Feed Simulations view, select the available feed simulation and click the Run button.

  6. In the Output Streams view, observe tuples emitted on the DataOut output stream.

  7. Press F9 or click the Stop Running Application button.

RowAdded Sample

In the RowAdded sample, the TIBCO Streaming® Matrix operator is configured to create a list of tuples and output the list every time a new tuple is added.

  1. In the Project Explorer view, open this sample's folder.

    Keep an eye on the bottom right status bar of the Studio window. Make sure any Updating, Downloading, Building, or Rebuild project messages finish before you proceed.

  2. Open the src/main/eventflow/packageName folder.

  3. Double-click to open the Matrix_RowAdded.sbapp module. Make sure the module is the currently active tab in the EventFlow Editor.

  4. Click the Run button. This opens the SB Test/Debug perspective and starts the module.

  5. In the Feed Simulations view, select the available feed simulation and click the Run button.

  6. In the Output Streams view, observe tuples emitted on the DataOut output stream.

  7. Press F9 or click the Stop Running Application button.

Sample Location

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.

Important

Load this sample in StreamBase Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.

Using the workspace copy of the sample avoids permission problems. The default workspace location for this sample is:

studio-workspace/sample_matrix

See Default Installation Directories for the default location of studio-workspace on your system.