The Data Parser is a tool designed to permit the selection of sections of data at specific time points of interest. Data Parser functionality is only available from within a Review session.

Parser Segments are represented in the Parser Bar located at the top of the Primary and Trend graph pages. The Parser Bar may be displayed/hidden by selecting Display Parser Bar in Graphs from the Data Parser menu. The default selection is visible.

Parser Segments may be defined using any of the three methods described below:

• Automatically based on user-defined rules. (Parser Rules)
• Graphically via the Primary or Trend graph. (Manually insert parser segments on graph page)
• Manually by typing in start and end times for each segment (Parser Rule)

Adding Parser Segments using the Parser Rule Setup 

Here’s how to do this.

1. Open the Data Parser dialog by selecting Open Data Parser Dialog from the Data Parser menu
2. Select the Parser Rule Setup tab.
3. Click on the New button.
4. Enter a unique name into the Rule Name text box to identify the rule.
5. Set the Starting Criteria. The options are as follows.
   • Real Time Enter the starting time needed for the parser section.
   • Prior to Event (Note that an existing event is needed for this function to work) Select the Event and Subject that the event is associated with and enter the amount of time prior to the event that will be used.
   • Following Event (An existing event is needed) Select the Event and Subject that the event is associated with and enter the amount of time after the event that will be used as the starting point.
   • Time Span Enter the desired time duration of the Data Parser starting from the Starting Time and ending once the duration has been achieved.
6. Set the Ending Criteria. The end criteria are the same as the starting criteria except for one addition, setting the Time Span, which is the length of time from the start point of the Parser Segment to the end point of the Parser Segment.
7. Set the Sub-Divide Span (Optional) This allows the user to configure multiple, iterative Parser Segments. The time over which Parser Segments will be configured is based on the start and end criteria and each segment will be configured for the length of time set up in the Segment Duration for every Repetition Interval set. For example, if a rule is set up like the one below, 24 Data Parser Segments will be configured, each with a duration of 15 minutes.
8. Add additional Rules as necessary based on desired goal.

The above screenshot shows a rule named "Post Dose", that takes 30 minutes prior to the event for a length of 24 hours and divides it into 15 minutes averages (Segment duration) every 1 hour (Repetition).  

Notes:

• When using the same Event letter to specify the start and end criteria, two separate events must be entered. Data Parser will not use a single event to trigger both start and end. If a fixed time is desired from the start, Time Span should be used.
• Once segments have been created, they are no longer directly associated with the underlying rules. Thus, in the case of rules based on Events, any subsequent changes to Events will not affect the Parser Segments unless the underlying rules are reapplied. The rules and the Parser Segments may be modified independently. The Parser Segments may be modified graphically on time based graph pages.
• Data Parser Segments may span across Data Breaks. Data Parser is based on real-time and Parser Segments will span accordingly. For example, if using Scheduled Sampling to sample 30 seconds every 10 minutes and have configured your Parser Rules to include a repetition of 30 mins every 60 minutes, then the Parser Segment will span three Scheduled Sampling Segments. This scenario is depicted below.

Example of Data Parser Segment and Graph Page View

Resultant Data Parser Segments visible on Graph page:

Adding Parser Segments using Individual Segments

The following outlines the process to add Parser Segments using Individual Segments:

1. Open the Data Parser dialog by selecting Open Data Parser Dialog from the Data Parser menu.
2. Select the Individual Segments tab.
3. Select the appropriate group desired to parse.
4. Select the Insert button.

Adding Parser Segments from the Graph Page

To add Parser Segment directly from the Primary or Trend graph page:

1. Right-click on the Parser Bar.
2. Select New Parser Segment.
3. Adjust the position and the size of the Parser Segment as described in that section.

Altering the Size and Location of the Parser Segment

Parser Segments can be augmented directly from the graph.

To compress/expand the Parser Segment size:

1. Hover over the left boundary of the Parser Segment. The mouse turns into a left-right arrow.
2. Left-click and drag the side to the desired location.
3. Repeat for the right-hand boundary.

To move the entire Parser Segment to a new location:

1. Left-click on the top boundary of the Parser Segment
2. Drag to the desired location.
3. Repeat the above steps for multiple segments.

Parser Segments can also be augmented using the Data Parser Dialog:

1. From the main Ponemah window, select Data Parser | Segments…
2. Adjust the Start and End times to the times needed.
3. Select hours, minutes, seconds, or milliseconds, and either type a new number in or use the up/down arrow buttons to change the times.