Scenario Generator

The figure below shows the Scenario Generator tab.

Click the links below for more information about each property.

Generation Mode 

Output A-GPS and Ephemeris Files

Ephemeris File (Optional)

Almanac File

Elevation Mask Angle

Troposphere Model

Ionosphere Model

Ionosphere Parameters

Scenario Type

Initial Longitude

Initial Latitude

Initial Altitude

Start Date Time (GPS Time)

Duration (HH:mm:ss)

Channel Packing

Antenna Pattern

Elevation Resolution

Azimuth Resolution

Azimuth Rotation

Leap Seconds

NMEA Message File

Source Scenario File

Save Edit Log

Edit Mode

Source Channel

Start

Stop

Power Offset

Save

Recall

Reset

Save Scenario

Create Scenario

Apply

Download

Help: Online Documentation

Help: About

 

 

Generation Mode 

Choice: Create | Edit

Default: Create

Couplings: Apply button is active when Generation Mode is Edit. Switching to Edit mode will cause a graphic tab update and log window update based on the selected scenario file for edit. Refer to Creating a Scenario or Editing a Scenario for more information.

Create

This mode creates a new scenario file with the input parameters provided by the user.

Edit

This mode loads an existing scenario and displays it in the graphic panel. User can make changes to the scenario file and then re-save it.

Output A-GPS and Ephemeris Files

Choice: On | Off

Default: Off

Couplings: This property is active when Generation Mode is Create.

Indicates whether a A-GPS parameter file and matching ephemeris file will be created along with the scenario file.

The ephemeris file that is generated contains a header line in the first row. Delete this row if you want to use the ephemeris file as an input to the scenario generator software.

Ephemeris File (Optional)

Default: No file selected

Couplings: This property is active when Generation Mode is Create.

Select the ephemeris data file in comma-separated format for scenario creation. This property is optional for creating a scenario and can be left with no file selected.

If you use an ephemeris file created with the Output A-GPS and Ephemeris Files property, before using it, you must modify the file by removing the first line (header line) of the file. To modify the file, use either a text editor or Microsoft Excel. Ensure to resave the file in the same format, comma separated values (.csv).

Almanac File

Default:

Windows XP

C:\Program Files\Keysight\Scenario Generator for MS-GPS\20130425.alm

 

Windows 7

C:\Program Files (x86)\Keysight\Scenario Generator for MS-GPS\20130425.alm

Couplings: This property is active when Generation Mode is Create.

Select the almanac data file in YUMA format for scenario creation. The date of the almanac file should be close to the desired scenario start date for better satellite location accuracy. The software will display a warning message if the dates are more than four weeks apart.

Elevation Mask Angle

Range: 0° - 30°

Default: 5.00°

Couplings: This property is active when Generation Mode is Create.

Enter the angle above the horizon which constitutes valid satellite data. Satellites below this angle will not be used. Increasing this angle will reduce the number of visible satellites in the generated scenario.

Troposphere Model

Choice: No Model | NATO

Default: No Model

Couplings: This property is active when Generation Mode is Create.

Select the troposphere model to be applied to satellite signals in the generated scenario.

Ionosphere Model

Choice: No Model | Klobuchar for WCDMA | Klobuchar for cdma2000

Default: No Model

Couplings: This property is active when Ionosphere Model is Klobuchar for WCDMA or Klobuchar for cdma2000 is selected. Alpha and Beta values for WCDMA are from 3GPP TS34.108 and values for cdma2000 are from 3GPP2 C.S0036-0 v2.0 Annex B section B.3.

Select the ionosphere model to be applied to satellite signals in the generated scenario.

Ionosphere Parameters

Default: 4.6566129E-09, 1.4901161E-08, -5.96046E-08, -5.96046E-08, 79872, 65536, -65536, -393216

Couplings: This property is active when Ionosphere Model is Klobuchar for WCDMA or Klobuchar for cdma2000. Alpha and Beta values cannot be modified by the user and will be automatically updated along with the selected Ionosphere Model.

The table below displays the Alpha and Beta parameters for ionosphere model calculation. The format is Alpha[0], Alpha[1], Alpha[2], Alpha[3], Beta[0], Beta[1], Beta[2], Beta[3].

 

Klobuchar for WCDMA

Klobuchar for cdma2000

Alpha[0]

4.6566129E-09

Alpha[0]

1.49011611938477E-08

Alpha[1]

1.4901161E-08

Alpha[1]

2.23517417907715E-08

Alpha[2]

-5.96046E-08

Alpha[2]

-1.19209289550781E-07

Alpha[3]

-5.96046E-08

Alpha[3]

-1.19209289550781E-07

Beta[0]

79872

Beta[0]

112640

Beta[1]

65536

Beta[1]

131072

Beta[2]

-65536

Beta[2]

-131072

Beta[3]

-393216

Beta[3]

-196608

 

Scenario Type

Choice: Static | Dynamic

Default: Static

Couplings: This property is active when Generation Mode is Create.

Select the scenario type to be generated.

Static

Scenario will be generated for a static GPS receiver with fixed longitude, latitude and altitude. This selection also provides the choice of creating an antenna pattern.

Dynamic

Scenario will be generated for a moving GPS receiver based on the provided trajectory data.

Initial Longitude

Default: 116.478479 E

Couplings: This property is active when Scenario Type is Static.

Enter the initial longitude in degrees for the GPS receiver position to be simulated in a static scenario. Enter a positive number for East and negative number for West or a positive number with W or E appended.

Initial Latitude

Default: 40.0096856 N

Couplings: This property is active when Scenario Type is Static.

Enter the initial latitude in degrees for the GPS receiver position to be simulated in a static scenario. Enter a positive number for North and negative number for South or a positive number with N or S appended.

Initial Altitude

Range: -100 m to 15000000 m

Default: 100.00 m

Couplings: This property is active when Scenario Type is Static.

Enter the initial altitude in meters for the GPS receiver position to be simulated in a static scenario.

Start Date Time (GPS Time)

Default: 2013-04-25 16:38:24

Couplings: This property is active when Generation Mode is Create.

Set the start date and GPS time for the scenario simulation. This information can be set in one of two ways:

Automatically

Manually after the file sets the date and GPS time (manual override of the file setting)

When manually setting the GPS time, it is recommended that you use a start time on a 3-second boundary.

Duration (HH:mm:ss)

Range: 00:00:06 - 24:00:00

Default: 01:00:00

Couplings: This property is active when Scenario Type is Static. For a dynamic scenario, the duration is determined by the time length of input NMEA message file.

Enter the duration of the scenario to be created in <HH:mm:ss> format.

Channel Packing

Choice: Auto | Manual

Default: Auto

Couplings: This property is active when Generation Mode is Create and the Scenario Type is Static. When creating a scenario in Manual mode, a new tab with satellite visibility is displayed. Select the desired satellites to fill a maximum of 8 channels. While the Satellite Visibility tab is available, the Scenario Generator tab properties are grayed out (inactive).

The ESG supports a maximum of 8 satellite channels at a time. This property describes how to select satellites to fill the channels when there are more than 8 satellites available. Auto means that software will have channel packing done automatically. In Manual mode, select the satellites you want to use.

Antenna Pattern

Choice: On | Off

Default: Off

Couplings: Properties Elevation Resolution, Azimuth Resolution and Azimuth Rotation are active when Antenna Pattern is On. Antenna Pattern is only applied to Static scenarios and will be disabled when generating Dynamic scenarios.

This property indicates whether the gain mask for an antenna pattern will be enabled for generated scenarios. The gain mask is configured through the sky-view map in the Antenna Pattern tab.

Elevation Resolution

Range: 5° - 90°

Default: 10.00°

Couplings: When this value is changed, the gain mask for the antenna pattern will be rebuilt and reset to the default value (0 dB). Save the current antenna pattern settings before changing the elevation resolution value.

Enter the satellite elevation resolution for creating the gain mask of antenna pattern. With this value (ER), the whole elevation range [0° - 90°] will be divided into several blocks - [0° - ER], [ER - 2ER] ... [nER - 90°].

Azimuth Resolution

Range: 5° - 90°

Default: 30.00°

Couplings: When this value is changed, the gain mask for the antenna pattern will be rebuilt and reset to the default value (0 dB). Save the current antenna pattern settings before changing the elevation resolution value.

Enter the satellite azimuth resolution for creating the gain mask of an antenna pattern. With this value (AR), the whole azimuth range [0° - 360°] will be divided into several blocks - [0° - AR], [ER - 2AR] ... [mAR - 360°].

Azimuth Rotation

Range: 0° - 360°

Default: 0°

Couplings: When this value is changed, the sky-view map on the Antenna Pattern tab will be updated to reflect the rotation.

Enter the rotation of configuring antenna pattern from the base pattern, in which 0° azimuth points to the north.

Leap Seconds

Range: 1–Unlimited leap seconds

Default: 16 leap seconds (as of 2012-07-01)—defined per the BIH (Bureau International of the Hour or International Bureau of Time)

Couplings: This property is active when Generation Mode is Create.

Set the number of leap seconds by clicking the property, and then click the dialog box button that appears to launch the ClosedLeap Seconds Editor. Use the Leap Seconds Editor to add or remove leap seconds, or to reset the editor to the factory default number of leap seconds. With the editor, set the leap seconds as either a positive or negative.

The scenario length needs to be at least 12.5 minutes long to ensure that the leap second information is included in the scenario. The leap second information is contained in frame 4, page 18 of the navigation message. The entire 25-page navigation message repeats every 12.5 minutes, and where the navigation message starts in the scenario depends on the scenario start date and time. For a dynamic scenario, since the scenario length is determined by the length of the NMEA message (GGA) file, the file must contain a trajectory that lasts at least 12.5 minutes.

NMEA Message File

Range: 1Hz - 5Hz message rates

Default:

Windows XP

C:\Program Files\Keysight\Scenario Generator for MS-GPS\Circle.gga

 

Windows 7

C:\Program Files (X86)\Keysight\Scenario Generator for MS-GPS\Circle.gga

Couplings: This property is active when Scenario Type is Dynamic. When a new NMEA file is selected, Start Date Time will be updated according to the content of the file.

Select a NMEA message file for dynamic scenario creation, which contains RMC/GGA messages generated by a GPS receiver.

The NMEA file must contain the $GPGGA messages.  The GGA messages are necessary because they contain the longitude, latitude, and altitude (location) information along with the time information. The start time and duration for the dynamic scenario will be based on the time information in the NMEA message file.

Optionally, the file may also contain $GPRMC messages. RMC messages also contain the date information (which is not in the GGA messages), and if any RMC messages are present, then the scenario generator will use the date in the first RMC message that it finds as the start date of the scenario. If no RMC messages are in the NMEA file, the user needs to specify the start date.

The NMEA file cannot consist of RMC messages only. RMC messages lack the altitude information, so the scenario generator cannot use them for the location information.

Source Scenario File

Default:

Windows XP

C:\Program Files\Keysight\Scenario Generator for MS-GPS\Beijing.ags

 

Windows 7

C:\Program Files (X86)\Keysight\Scenario Generator for MS-GPS\Beijing.ags

Couplings: This property is active when Generation Mode is Edit.

Select an existing scenario file for editing. After loading a scenario, the Scenario Graphics tab will be updated to display the contents of the scenario.

The software also allows the editing of Option 422 scenario files. When the Option 422 scenario edits are saved, they are saved as only an Option 422 scenario file for playback on an Option 422 licensed signal generator.

There is no linkage between a file that may have just been created in the scenario generation mode and the active scenario file in the Edit mode.

Edit Mode

Choice: Delete Channel | Apply Power Offset | Equalize Satellite Powers | Trim

Default: Delete Channel

Couplings: This property is active when Generation Mode is Edit. Each time the selected scenario is edited, the graphic panel will update and a new record will be appended to the edit log.  

Select an edit operation to be applied to the scenario file.

Delete Channel

This mode deletes a satellite channel from the scenario with the specified channel index. A Satellite Channel is a basic resource unit in a scenario for playing satellite data. During scenario playback, a channel could either be blank (no satellite data), or transmitting data from a satellite with specified SV ID. And at certain time, it may make a transition to another satellite as defined in the scenario. The channel plot in the Scenario Graphics tab displays the color coding to show which SV IDs (PRNs) are assigned to each channel versus time.

Apply Power Offset

This mode adds an offset to the power level during some portion in the scenario. The Start and Stop properties specify the time range over which power level will be adjusted.

Multiple power offsets can be applied to the same channel as long as the time spans do not overlap. Click Apply after each change has been made.

Equalize Satellite Power

This mode sets the power levels of all satellites in the scenario to the same value.

Trim

This mode removes the satellite data from the scenario outside of the time range specified by Start and Stop.

Source Channel

Range: 1 - 8

Default: 1

Couplings: This property is active when Generation Mode is Edit and Edit Mode is Delete Channel or Apply Power Offset.

Enter the index of the satellite channel on which the edit operation will be performed.

Start

Range: 0 - duration of scenario

Default: 0

Couplings: This property is active when Generation Mode is Edit and Edit Mode is Apply Power Offset or Trim. The Start time in scenario cannot be larger than Stop time.

Enter the start time in the scenario in seconds for a specific edit operation, with a resolution of 0.6 second.

Stop

Range: 0 - duration of scenario

Default: 3600

Couplings: This property is active when Generation Mode is Edit and Edit Mode is Apply Power Offset or Trim. The Stop time in scenario cannot be less than Start time.

Enter the stop position in the scenario in seconds for a specific edit operation, with a resolution of 0.6 second.

Power Offset

Range: -40 dB to 0 dB

Default: 0.00

Couplings: This property is active when Generation Mode is Edit and Edit Mode is Apply Power Offset.

Enter the power offset to be applied to a specific satellite channel. Adjust this offset value to control the relative power levels among satellite channels. 

When the power offset is applied, it can cause the power level of the satellite to be to low to be detected, This typically occurs when the satellite already has a low power level and then the offset is applied that further lowers the channel power.

Save Edit Log

Choice: On | Off

Default: Off

Couplings: This property is active when Generation Mode is Edit.

This property indicates whether the edit log will be saved to a text file along with the scenario. The log file will have the same path and file name as the scenario file but a *.log file extension.

Save

Click this Closedbutton to save project settings that includes the antenna pattern if enabled for a static Scenario Type.

Recall

Click this Closedbutton to recall project settings. This software also accepts Option 422 settings files to re-save as Option 423 settings or to create an Option 423 scenario file.

Reset

Click this Closedbutton to reset project settings to the default values and tabs. If the Satellite Visibility tab is present, it will go away upon clicking Reset.

Create Scenario

Couplings: This Closedbutton is active when Generation Mode is Create. Refer to the tutorial Creating a Scenario for more information. This button is inactive (grayed out) while the Satellite Visibility tab is present.

Clicking this button will bring up a dialog asking for the file path and name, and then the software will create the scenario file. When the scenario is successfully created, the graphic panel in the Scenario Graphics tab will be updated to display the content of satellite channels in the scenario. If an error occurs, a message will be displayed.

Save Scenario

Couplings: This Closedbutton is active when Generation Mode is Edit.

Clicking this button will bring up a dialog asking user to specify the file path and name and then save the edited file. When scenario file is saved, there will be a record of the saved scenario appended to the log window.

If the edited scenario file was originally created using the Option 422 software, the file with the edits are still saved as an Option 422 scenario file for playback on an Option 422 licensed signal generator.

Apply

Couplings: This Closedbutton is active when Generation Mode is Edit. When an edit operation is done, it will become inactive. When changes are made to the related parameters (see table below), it becomes active again.

Clicking this button will perform the edit operation to the selected scenario as specified by Edit Mode and related parameters. When the operation is done, the graphics panel in the Scenario Graphics tab will be updated to reflect the changes made to the scenario. The information will be appended to the log window as well. If any error occurs, an error message will be displayed.

Edit Mode

Related Parameter

Sample log text

Delete Channel

Source Channel

Delete channel 1

Apply Power Offset

Source Channel

Start

Stop

Power Offset

Apply power scale of -10 dB to channel 1 from 0 to 3600 seconds

Equalize Satellite Power

n/a

Set power of all satellites to equal values.

Trim

Start

Stop

Trim scenario – keep time range from 0 to 1800 seconds

Save Antenna

Description is in the Antenna Pattern topic.

Recall Antenna

Description is in the Antenna Pattern topic.

Download

Click this Closedbutton to download the selected scenario to the target instrument.

Provide the instrument LAN address.

Allows the user to select one or more scenario files within the same directory for download.

Transfers selected files to the GPS folder in the ESG.

Refer to the tutorial Downloading a Scenario for more information.

Help: Online Documentation

Click this Closedbutton to view the online documentation. The online documentation opens in a separate window.

Help: About

Click this Closedbutton to view the software revision.