Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

Trigger Process

NI InsightCM™ SDK Help

Edition Date: July 2017

Part Number: 375191C-01

»View Product Info
Download Help (Windows Only)

The Trigger process evaluates the expressions that define when a data group enters and exits operating states. After determining the current operating state of the data group, this process evaluates the file-collection expression for that state to determine whether to collect data.

Separately from the Dataflow Script feature, this process handles force-trigger requests made by users of the InsightCM web application.

Actions Performed

  • For each data set, this process performs the following actions:
    • Evaluates the expression for each of its data group operating states to determine if the device entered and/or exited an operating state. If the operating state changed, this process performs the following actions:
      • Adds an ExitOpState point to the point value map in the data set.
      • Resets dwell times and other properties of the current operating state, such as the baseline delta EU value.
    • Determines whether the configuration for the current operating state calls for a data set to be collected:
      1. Evaluates if the expression that gates data set collections is met. If so, proceeds to step 2. Otherwise, continues to its next iteration.
      2. Evaluates data set collection trigger expressions for the current operating state.
      3. Resets the dwell time and other collection properties for the current operating state.
  • Handles force-trigger messages initiated in the InsightCM web application.

Communicating with this Process

The SDK does not provide any messages you can send to this process specifically. To request that this process evaluate data for triggers, start an iteration of the Dataflow Script and allow the data to pass through to this process.

Role within the Dataflow Script

When the Dataflow Script API sends a ProcessDataFlowBlock message to this process, this process requires the following inputs and produces the following outputs.

Inputs

  • Features and spectral bands calculated from waveforms are a common source of triggers. Therefore, this process should execute after any processes that perform analysis-related calculations.

Outputs

  • This process writes ExitOpState and EnterOpState map points when the operating state has changed. When the Data Event Creator process receives the same data set, it looks for these points in the map. If either of those points is true and the operating state is configured to perform stream acquisitions, Data Event Creator creates a new data event:
    • ExitOpState—The device exited its previous operating state.
    • EnterOpState—The device entered a new operating state.
  • This process writes the name of the current operating state to the OpState map point each time it evaluates whether the device exited or entered an operating state.
  • This process writes a CollectFile map point with a value of 1 when a collection condition evaluates to true or a data group is force triggered. When the Data Event Creator process receives the same data set, it looks for this point to determine whether to create a new data set.
  • This process writes a CollectFileReason point whose string value indicates whether a collection condition evaluated to true or a force trigger occurred.

Related Information

Data Event Creator Process


 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit