Queries

A query is a real-time element that filters a provider's data to display specific subsets of it, called entities. By default, none of a provider's entities are displayed when the provider is first added; you must create a query to begin viewing data. RT3 provides three types of queries:

Area
Distance
Simple

You may have more query types available to you if your RT3 integrator has created some. Any query can be configured as an event in addition to its standard form.

The queries are prioritized according to their order in the Display Manager, from top to bottom. Thus, a query at the top that displays an entity in red will take precedence over a lower query that displays it in black.

Area Query

An area query displays entities within a specified area. You can use an Area Target object in the STK scenario or a polyline entity - if one is being transmitted by the provider - to define the area of the query.

Select Reference Area Target or Reference Polyline Entity, and then click Choose... to select the desired reference area.

Distance Query

A distance query displays entities within a specified range of a point or entity. You can define a reference point using latitude, longitude, and altitude, or you can select an entity in the provider's feed to serve as the reference.

Select Reference Entity or Static Position, and then click Choose... to select a reference entity or enter values for Latitude, Longitude, and Altitude to define the static position. To define the range, enter values for the fields described in the following table:

Field	Description
Threshold	The maximum range from the reference entity or point within which an entity will be displayed.
Calculation Type	How the range will be calculated. Choose from: Both Surface and Straight Line - range is measured along the surface of the earth and along a straight line; if either measurement places the entity within range, the query displays it. Straight Line Distance - range is measured in a straight line from reference to entity. Surface Distance - range is measured from and along the surface of the earth.

Field

Description

Threshold

The maximum range from the reference entity or point within which an entity will be displayed.

Calculation Type

How the range will be calculated. Choose from:

Both Surface and Straight Line - range is measured along the surface of the earth and along a straight line; if either measurement places the entity within range, the query displays it.

Straight Line Distance - range is measured in a straight line from reference to entity.

Surface Distance - range is measured from and along the surface of the earth.

Simple Query

A simple query is a basic data filter that utilizes a SQL-based set of expressions and operands to determine what data will be displayed. When you create or modify a simple query, the Query Options window is opened. You can use this window to define the data that you want to display - by comparing the data - and the manner in which it will be displayed. Click Add to add a clause to the simple query. You can double-click any field of an existing clause to edit it. Click Remove to delete the currently selected clause. Click Apply to save the changes you have made, or click OK to save the changes you have made and close the window, or click Cancel to close the window without saving changes.

Each clause in a simple query is defined by a set of fields, described in the following table:

Field	Description
Field Name	Select the data field you wish apply the clause to; the list of available fields is dependent on the provider.
Operand	Select an operand to apply to the field value; the operand can be =, !=, >, >=, <, or <=.
Field Value	Enter the value to be compared to the data field, using the selected operand.
Conjunction	Select a conjunction to relate the clause to the subsequent clause in the table; the conjunction can be AND, OR, or NONE.

Select Use Regular Expressions if you want to use regular expressions (wildcard symbols) in the Field Value field. For further information about using regular expressions, consult the website www.Regular-Expressions.info.

Standard Query Display Options

Each standard query can be configured to display entities in STK or STK Viewer with general, line, model, and marker display options. The following tables describe the options for each subset of display properties:

General Options	Description
Color	Select the color with which the entities related to the query will be displayed.
Display Labels	Select to display labels for entities.
Label Settings...	Click to define the labeling of the entities related to the query. See the Label Settings section of the Help, below.

Line Options	Description
Display Lines	Select to display lines for entity routes.
Width	Select the width of the line with which the entities' paths will be displayed.
Style	Select the style of the line with which the entities' paths will be displayed.
Use Lead and Trail Times	Select to define time limits for the length of an entity's trail.
Lead	Enter the length (in seconds) of the entity's lead line.
Trail	Enter the length (in seconds) of the entity's trail line.

Model Options	Description
Display Models	Select to display models for entities.
File	Click the ellipsis button to select a model file that will represent all of the entities related to the query.
File Field	Select to use a model file - identified in the provider's data - to represent all of the entities related to the query. Specify a field from the drop-down menu; the data in the field will define the file name to be used as the model.
Log Scale	Set the display scale - an exponential value - of the model.

Marker Options	Description
Display Markers	Select to display markers for entities.
File	Click the ellipsis button to select an image file to be used as the marker that will represent all of the entities related to the query.
Mil2525B Field	Select to use a Mil2525B symbol - identified in the provider's data - to represent all of the entities related to the query; specify the field in which to search for the symbol code from the drop-down menu.
Mil2525B Symbol	Select to use a Mil2525B symbol - defined by you - to represent all of the entities related to the query; enter the symbol code in the adjacent field.
Shape	Select to use a shape to represent all of the entities related to the query; select a shape from the drop-down menu.
File Field	Select to use a marker - identified in the provider's data - to represent all of the entities related to the query. Specify a field from the drop-down menu; the data in the field will define the marker to be used.
Pixel Size	Set the display size, in square pixels, of the marker.

Label Settings

The RT3 Query Label Settings window is opened when you click Label Settings... in the Query Options window. It is used to define the labeling to be applied to the entities produced by the simple query. The window is divided between the Available Fields and Chosen Fields lists. Click to move a field from the Available Fields list to the Chosen Fields list, and to move a field in the reverse. The and buttons allow you to move the currently selected field within the order of the Chosen Fields list. Click Clear to remove all fields from the Chosen Fields list. In the Separator field, you can enter a character or string to be used as a buffer when concatenating the Chosen Fields’ values.

Select Multi-Line Label to have the label fields appear on separate lines; select Show Field Names to have the values preceded by the field label. Click OK to save the changes you have made and close the window, or click Close to close the window without saving changes.

Query (As Event)

An event is a type of query that evaluates the data of a provider and notifies you - and optionally executes an action - when specific conditions are met. Each type of query available to you can be used as an event. Events are displayed in the Event Manager when they are triggered. When you create or modify an event, the RT3 Event Configuration window is opened. You can use this window to define the conditions of the event, the information it will display, and the action that will be taken when the event conditions are met. The window will contain the same controls and parameters that are available for the standard query of that type, but instead of display options you will be given event options to define. The options specific to events are described in the following table:

Field	Description
Code	Enter a numerical code value to define the importance of the event.
Description	Enter a description of the event.
Actions...	Click Actions... to select an Action plugin that will be executed when the event is triggered; Actions are plugin scripts or applications created using the RT3 Software Development Kit, and can perform a wide variety of automated tasks. Creating Action plugins is the job of an RT3 integrator.