Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this
publication supersedes that in all previously published material. Specifications and price change privileges
reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Version November 17, 2015
Contactin
Tektronix, Inc.
14150 SW Karl Braun Drive
P. O . B o x 5 0 0
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
g Tektronix
In North America, call 1-800-833-9200.
Worldwide, visit www.tek.com to find contacts in your area.
This help provides in-depth information on how to use the RSA Map and RSA software. The RSA Map
software enables you to record measurement results taken b y a Tektronix spectrum analyzer on a map.
If a GNSS rece
automatically and include GNSS coordinates as part of the measurement data.
iver is connected to the Host Instrument, the measurements can be placed on a map
RSA Map Printable Help1
Welc o meWelc o me
2RSA Map Printable Help
RSA Map overviewRSA Map overview
RSA Map overview
RSA Map and Tektronix Real-Time Spectrum Analyzers provide an integrated solution for field
interference and coverage problems. RSA Map lets you use an on- screen map to record the location a nd
value of Host
Select a measurement and touch the displayed map where you want the measurement to be placed
Use a GNSS receiver (customer supplied) to automatically position measurements at your current
location (on maps with geophysical reference information)
Collect and export measurement data (and position data when using a GNSS receiver) to common
formats to help analyze measurements (position, value, and direction) and prepare reports to resolve
interfer
Map files
RSA Map supports the following vector and image map file formats.
Map file formatDescription
.bmpWindow Bitmap
.mifMapInfo Interchange Format
.jpg, .jpeg
.gifGraphics Interchange Format
.tiff
.png
.osm
.shp
.dlg, .opt
xx
x
TekVISA
Instrument measurements. With RSA Map you can do the following:
ence problems.
.bpm files can be either geo-referenced (using world map file format to specify geographic
location) or non geo-referenced (which does not have geographic location information).
JPEG File Interchange Format
Tagged Image File Format
Portable Network Graphics
Open Street Map
ArcView Shape
Digital Line Graphs
Tektronix Virtual Instrument Software Architecture (TekVISA) is a Tektronix VISA s olution. It is
a collection of software and documentation that allows for remote control of instruments regardless
of instrument brand and physical connection. TekVISA includes a VISA driver, VISA libraries,
RSA Map Printable Help3
RSA Map overviewElements of the display
documentation, USB Device Driver, VXI-11 server, and connection management/debug software. It is
required for RSA Map to function properly.
Elements of the display
Elements of the RSA Map display
ItemButtonDescription
1
2
The Settings button allows you to set repeat
measurement parameters and advanced map
parameters.
The gray GNSS button indicates that GNSS is not
enabled. Click it to toggle GNSS on/off.
The yellow GNSS unlocked button indicates that
GNSS is enabled, but the receiver is not locked to a
signal. Click it to toggle GNS S on/off.
The red GNSS button indicates that GNSS is
enabled, but the GNSS data is invalid. Click it to
toggle GNSS on/off.
The green GNSS locked button indicates that the
GNSS is enabled and is locked to a signal. Click it to
toggle GNSS on/off.
4RSA Map Printable Help
RSA Map overviewElements of the display
Elements of the RSA Map display (cont.)
ItemButtonDescription
3
4
The Home button resets the position of the map to
the Home location and resets the magnification to
its default value.
The User Center button resets the current GNSS
location to the center of the display.
5
6The Pan tool is used to move the map within the
7
8TheMoveResultbuttonisusedtomovea
9
10
11The Repeat Measurements button is used to start
12
The Zoom button is used to magnify and shrink the
map image.
window.
The Select button is used to select a measurement
on the map display for editing.
measurement on the map to a different position.
The Change Azimuth button is used to place an
azimuth arrow on a measurement to indicate the
direction in w hich a measurement was taken.
The Single Measurement button is used to start
single measurement mode.
repeat measurements mode.
The Stopped icon indicates that the Host Instrument
is not taking measurements.
The R unning icon indicates that the Host Instrument
is running and taking measurements.
RSA Map Printable Help5
RSA Map overviewElements of the display
Elements of the R SA Map display (cont.)
ItemButtonDescription
13
The M easurements Select area is used to select the
measurement to be taken.
14
The T humbnail Preview shows a version of the Host
Instrument display.
15
The instrument status readout displays the status of
the Host Instrument.
16
17
The Map name readout displays the name of the
ntly loaded map.
curre
ale readout at the bottom of the window
The Sc
indicates the scale of the map at the current
magnification. For example, if the Scale reading is
0 that means that 1 cm on the map represents
1:10
100 cm on the ground.
18The
Latitude and Longitude readouts indicate the
location of the cursor on a geo-referenced map.
xxx
RSA Map menus
MenuDescription
le
Fi
ViewDisplay measurements, display the “You are here” icon, and set the azimuth line style.
Tools
HelpDisplay online help.
xxx
ad maps, save and recall results, print documents, and clear measurements.
Lo
Preset software to default settings and switch to Host Instrument (analyzer).
6RSA Map Printable Help
Launching RSA MapLaunching RSA Map
Launching RSA Map
To la unch R SA Map:
1. In the Host Instrument application, select Tools > RSA Map from the menu bar.
RSA Map will launch in a separate window.
NOTE. When RSA Map is running, selecting RSA Map switches the display from the Host Instrument
display to the RSA Map display.
Loading a map
Before you can use the RSA Map tool to record measurements you must load a map. If you loaded a map
in a previous session, that map will remain loaded until it is replaced by a new map. You can create a
map using a program like OpenStreetMap
of the world. It can capture a map anywhere in the world and can export it in its native format, which
RSAMap can import.
RSA Map Printable Help7
, which is a collaborative project to create a free editable map
Launching RSA MapLoading a map
NOTE. If GNSS is enabled and you load a map with coordinates that are far from the current GNSS
location, the map display may appear blank because RSA Map is trying to display both the GNSS location
andthemaploc
close to the actual GNSS location. If the map coordinates are not close to the actual GNSS location, try
loading a map with coordinates closer to the actual GNSS location.
1. Select File > Load Map.
ation. If the map display is blank after loading a map, check that the map coordinates are
2. Navigate to
to specify the file type of the map).
3. Click Open. The RSA Map application will load the selected map file.
the location of the map file to be loaded, and select the map file to load (you may need
NOTE. Loading a map causes all previously stored measurements to be deleted, even if the same map
is reloaded.
8RSA Map Printable Help
Launching RSA MapConverting a scanned map into a geo-referenced map
Converting a scanned map into a geo-referenced map
You can create a geo-referenced map to i mport into the RSA Map application from a scanned map. To
do this, create a bitmap file of the map and then a World file (a geo-reference information file) using a
World file cre
reference information in the RSA Map application.
ation software available online. The following image shows the location of the geophysical
RSA Map Printable Help9
Launching RSA MapSetting up a GNSS receiver
Setting up a GNSS receiver
To include GNSS-derived coordinates with measurements when they are placed on a map, you must first
enable GNSS in the Host Instrument.
GNSS receiver requirements
To place mea
need to connect an external GNSS receiver to the Host Instrument. The GNSS receiver must output
NMEA 0183 serial data. Install any necessary software for the GNSS receiver before connecting.
surements on a map with the GNSS coordinates of where the measurement was taken, you
GNSS receiver setup
The GNSS receiver is set up through the Host Instrument software. Perform the following steps in the
Host Instrument interface:
1. Click the
open the GNSS/Antenna control panel.
2. Open the Host Instrument H elp file (User Manual).
3. In the Contents tab, expand the GNSS, Antenna, and Map It Features section and click on the How to
set up GNSS topic for setup instructions.
icon on the Favorites toolbar or select Setup > GNSS/Antenna from the main menu to
10RSA Map Printable Help
Mapping a measurementMapping a m easurement
Mapping a measurement
Use the following procedure to map measurement results. Before you use the following procedure,
do the following:
Load a map. See Loading a Map (see page 7).
Select Tools > Host Instrument to switch to the Host Instrument and set up the measurement you
wish to map. If you want to map Signal Strength, set up the Chan Power/STR and ACPR display on
the Host Instrument as required for the signal you will be measuring.
1. In the RSA Map application, select one of the measurement buttons. The selected measurement is
surrounded with a blue highlight and the name of the measurement appears bel ow the Thumbnail area.
RSA Map Printable Help11
Mapping a measurementMapping a measurement
2. Click the Single Measurement button. The selected measurement begins running on the Host
Instrument and the result is displayed in the Thumbnail area.
3. Click or tap on the map.
If a GNSS receiver is active, and you are using a geo-referenced map, a single measurement is placed
at the current GNSS coordinates.
If a GNSS receiver is not active, or if you are using an image map, a single measurement is placed
where you tapped the map.
4. You can select a different measurement button, and then tap the map to add a new measurement to the
map. Multiple measurement icons at the same location stack on top of each other.
12RSA Map Printable Help
Mapping a measurementRepeat measurements
NOTE. The number of measurements that can be placed on a map is limited to 200. When the limit is
reached, RSA Map shows a message stating that the limit has been reached, and discards any following
measurements. Select File > Save As to save the map and measurements to a file, or select File > Clear All
Measurements to clear the map and resume adding measurements to the map.
NOTE. To add measurements at a new location on a geo-referenced map with an active GNSS receiver, you
must physically move to the new location. If you want to add a measurement at a point other than the
current GNSS location, disable GNSS before placing the measurement.
Repeat measurements
Repeat measurements lets you automatically map a single measurement at a set time interval or change
in GNSS position. To perform repeat measurements, GNSS must be enabled and locked. The map used
be a geo-referenced map.
must
NOTE. The RSA Map program maps only completed measurement results. If the specified time interval
is less than that required to take a measurement, RSA Map ignores the specified time interval and maps
results as soon as the measurement acquisition is done. For example, if the instrument requires 20 seconds
to take a measurement, but the time interval is set to 10 seconds, then the instrument maps results every
20 seconds.
1. Set up the measurement parameters (frequency, bandwidth, and so on) in the Host Instrument
application.
RSA Map Printable Help13
Mapping a measurementRepeat measurements
2. Select Tools > RSA Map to return to the RSA Map application.
3. Enable GNSS as previously described.
4. Click th
5. Click
6. Set
7. Click Done.
e Repeat Measurements button.
the Settings button display the Settings window.
the type of measurement interval (time or distance between measurement positions) as needed.
14RSA Map Printable Help
Mapping a measurementRepeat measurements
8. Click the map at any point to start repeat measurements. The instrument adds a measurements to
the map at the current GNSS position.
The instrument will repeat measurements based on time or distance as specified on the
> Repeat Measurement tab.
9. Cli
ck the map to stop measurements:
(Settings)
RSA Map Printable Help15
Mapping a measurementModifying measurement icons and results
10. Click the
measurements mode.
NOTE. The number of measurements that can be placed on a map is limited to 200. For repeat
measurements, when the instrument reaches the measurement limit, the measurements and map are
automatically saved to the current Save Results directory, the map is cleared, and then RSA Map continues
adding measurements to the map.
Single Measurement button
or the Select buttonto exit the RSA Map repeat
Modifying measurement icons and results
The RSA Map application uses icons on the map to represent a measurement taken at that location. You
can perform various actions on measurement icons, including viewing the measurement results of an icon,
ng the icon, deleting an icon, and attachingameasurementdirectionarrowtoanicon.
movi
Moving measurement icons
To move a measurement icon (for example, if two or more results are stacked):
ick the Move Result button.
1. Cl
2. Click and drag the measurement result to a new position. If the icon is moved to a new stack of
measurements, then the icon is placed in the stack in time-of-measurement order.
16RSA Map Printable Help
Mapping a measurementModifying measurement icons and results
NOTE. Moving a measurement icon results in the geographic location data for the moved measurement
icon being changed to that of the map location the measurement icon is moved to.
Viewing
To view or delete the measurement results associated with an RSA Map measurement icon:
1. Click the RSA Map Select button.
2. Click
3. Click the measurement of interest in the list.
and deleting measurement icons
a measurement icon to open the Map Measurements dialog box.
RSA Map Printable Help17
Mapping a measurementModifying measurement icons and results
4. Click View
Instrument. Select To o l s > RSA Map on the Host Instrument to return to the RSA Map screen.
5. Click the Delete Measurement button to delete the selected measurement. If there are multiple
measurements to delete, repeatedly select and tap Delete Measurement.
in Instrument to show the measurement screen for the se l ected measurement on the Host
6. Click OK to close the dialog box.
18RSA Map Printable Help
Mapping a measurementModifying measurement icons and results
NOTE. To delete all the measurement icons from a map, select File > Clear All Measurements.
Draw a measurements azimuth (direction) arrow
TheRSAMapazimuthdirectionarrowfunctionletsyoudrawanarrowonamappedmeasurementto
indicate the direction your antenna was pointing when you took a measurement.
1. Click the Change Azimuth button.
2. Click and drag from the center of a measurement icon in the direction the antenna was pointing when
the measurement was made. RSA Map draws an arrow from the measurement icon.
The RSA Map measurement thumbnail display shows the direction of the arrow as you draw it. This
display shows the True Azimuth and Magnetic Azimuth. As you change the direction of the arrow,
the angles shown in the thumbnail display are updated to help you set the direction accurately. The
information shown depends on the map type (geo-referenced or image ). T he example shown is for a
geo-referenced map.
RSA Map Printable Help19
Mapping a measurementModifying measurement icons and results
3. To change the arrow direction, draw a new line. RSA Map replaces the existing arrow with the
new direction arrow.
You can also change the direction of the arrow by tapping the measurement, selecting Change Azimuth
from the Map Measurements window and entering a Magnetic Azimuth value for the result.
4. To change the style of the azimuth line, select View > Azimuth line style – Line or Azimuth line
style – Arrow.
Changing the azimuth of a measurement
1. Click th
2. Click the measurement icon with the azimuth arrow whose value you want to change.
3. Click the measurement name that has the azimuth arrow you wish to change.
4. Click the Change Azimuth button.
e RSA Map Select button.
20RSA Map Printable Help
Mapping a measurementModifying measurement icons and results
5. Enter a new
6. Click OK. RSA Map closes the dialog box and updates the azimuth value.
e an azimuth measurement direction arrow
Delet
1. Click the RSA Map Select button.
value for the azimuth. You can enter values precise to 1/100 of a degree.
2. Click the measurement icon with the direction arrow to delete. RSA Map opens the Map
Measurements dialog box.
RSA Map Printable Help21
Mapping a measurementModifying measurement icons and results
3. Click the measurement name that has the direction arrow to delete.
4. Click the Delete Azimuth button.
5. Click OK. RSA Map closes the dialog box and deletes the direction arrow.
Adding and deleting measurement icon labels
1. Click the RSA Map Select button.
2. If Measurements are not displayed (flags are displayed instead of measurement thumbnails), select
View > Display Measurements so that measurements are visible.
3. Click the measurement icon that you want to add a label to or that you want to change.
22RSA Map Printable Help
Mapping a measurementModifying measurement icons and results
4. Click the measurement name that you want to add a label to.
5. Click the C
6. Enter text for the label. You can enter up to 16 characters.
7. Click OK to close the Label dialog box.
8. Click
measurement icon displays the new label below the measurement name.
The
hange Label button.
OK to close the Map Measurements dialog box.
RSA Map Printable Help23
Mapping a measurementModifying measurement icons and results
24RSA Map Printable Help
Saving and recalling measurement resultsSaving measurement results
Saving measurement results
RSA Map allows you to save measurement results to a file for documentation. Savedresultscanalsobe
recalled to review results. RSA Map saves results in a compressed .zip format. The saved results contain
several type
Measurement data files (exported results)
Map file used for the measurements
Google Earth KMZ file
Recallable results files (trace and setup files)
MapInfo-compatible MIF/MID files
soffiles:
To save me
1. Select File > Save As.
2. Navigate to the location where you want to save the results and type a name for the file.
asurement results:
3. Select Save to save the results.
Results archive format
The RSA Map results are saved in a Zip format compressed file. The structure of the Zip archive is
shown in the following table.
RSA Map Printable Help25
Saving and recalling measurement resultsSaving measurement results
Table 1: Results archive contents
Folder / Filena
Readme.txt
me
FilenameDescription
A text documen
t that describes th e archive folder
structure and file contents.
Data
Contains all exported csv-format trace data and
png-format image captures. Also contains a
summary file.
of all measurements in the Data folder.
rement results for each measurement taken.
pture of the measurement for each
Measurements.csv
<Timestamp>_Result.csv
<Timestamp>_Picture.png
measurement
Summary file
Full measu
A s creen ca
measurement taken.
KMZ
Map
<Archiv
eFilename>.kmz
Map data for use with Google Earth.
Contains the exported .kmz data.
Contains files for use by RSA Map.
<mapfilename>A copy of the map file in use when the m easurements
were taken.
Mifmid
hiveFilename>.mif
<Arc
Contains exported .mif and .mid files. These files can be
ted into MapInfo for custom plotting.
impor
File containing MIF data.
<ArchiveFilename.mid>File containing MID data.
RSAContains setup and trace files for all measurement in
archive.
the
Tek
xxx
tains filesusedbyRSAMap.
Con
Contents of the measurements.csv file
Theelementsofthemeasurements.csvfile saved in the archive is described in the following table.
Data and measurement csv file contents
RowColumnDescription
AllA
B
CAzimuth, True North in degrees (blank if azimuth was not set for the
D
E
F
GCenter Frequency, Hz, Example: 869200000.
HUser Label, Example: PDX Airport
IMeasurement Result, Example: -104.644527.
JMeasurement Result Unit, Example: Hz..
xxx
Longitude in decimal degrees, +/- (East/West), Example: 29.69462.
Latitude in decimal degrees, +/- (North/South), Example: -2.851485.
measurement), Example: 122.
Azimuth, Magnetic North in degrees (blank if azimuth was not set for the
measurement), Example: 100.
Result Export filename (.csv format), Example: 2e552f.csv.
Result Date/Time, Example: 2012-04-28T07:41:46.
26RSA Map Printable Help
Saving and recalling measurement resultsRecalling measurement results
Measurement result. The Measurement Result value is a single number retrieved from the measurement,
and is only available for Channel Power and Occupied Channel Bandwidth.
Google Earth output files
The RSA Map ap
results archive file.
plication generates a file named
<ArchiveFilename>.kmz is the same filename used by the archive .zip file. The
.kmz file has a standard format that can be read by Google Earth to add RSA Map measurement icons
to the Google Earth map display. To use the .kmz file in Google Earth, extract it from the .zip archive
file and import it into Google Earth.
KMZ file con
tent. The KMZ file contains the following files, all at the root level of the KMZ folder.
There are no subfolders within the KMZ folder.
KMZ file contents
FilenameDescription
doc.kml
<Timestamp>_ResultThumbnail.png
<Timestamp>_AzimuthThumbnail.png
xxx
Recalling m easurement results
<ArchiveFilename>.kmz in the KMZ folder of the
KML language format file specifying point locations and
icons.
Measurement icon thumbnail graphic file; one for each result
to be displayed on the Google Earth map.
Azimuth arrow thumbnail graphic file;, one for each result
with azimuth to be displayed on the Google Earth map.
The Map It feature in the Host Instrument (analyzer) allows you to capture and export .zip files that can be
imported into RSA Map using this recall functionality. To recall saved me asurement results:
1. Select File > Recall.
2. Navigate to the location where you want to save the results and type a name for the file.
3. Select Save to save the results.
RSA Map Printable Help27
Saving and recalling measurement resultsRecalling measurement results
RSA Map loads the contents of the recalled measurement archive.
28RSA Map Printable Help
ReferenceRSA Map menus
RSA Map menus
Table 2: File menu
MenuDescription
Load MapLoads maps.
Load Default MapLoads the default WorldMap map.
Recall
Save AsSave measurement results to an archive file.
Export Map Picture
Print Map PicturePrints the map with m easurement icons.
Print Map & Result
Recall previously saved measurement results for analysis.
Save the map display, with measurement icons, to a PNG format file for
documentation.
Prints the map with measurement icons and the measurement results. Measurement
results include the following data:
Latitude – Latitude where the measurement was taken.
Longitude – Longitude where the measurement was taken.
Date \ time – Date and time the measurement was taken.
Magnetic Azimuth – Present when an azimuth arrow has been added to a
measurement icon.
True azimuth – Present when an azimuth arrow has been added to a
measurement icon.
Center frequency – Center frequency of the spectrum analyzer.
Result – Measured result for the selected measurement.
Filename – Name of file where the measurement was saved.
Clear All Measurements
Removes measurements displayed on the map.
Map PropertiesDisplays map characteristics. Properties displayed include map name, dimensions,
latitude and longitude coordinates of the map edges, and whether the map is
earth-referenced.
xxx
Table 3: View menu
MenuDescription
Display “You Are Here”Displays or hides the “You Are Here” icon.
Display Measurements
Azimuth line style – Line
Azimuthlinestyle–Arrow
xxx
Displays or hides the measurement icons. If measurements are hidden, the
measurement location is indicated by a flag icon.
Sets the azimuth line to just a line.
Sets the azimuth line to a line with an arrow at the end of the line.
RSA Map Printable Help29
ReferenceWorking with the map display
Table 4: Tools menu
MenuDescription
Preset
Host Instrument
xxx
Resets the RSA Map parameters to the factory defaults.
Changes the active application from RSA Map to the Host Instrument. This does
not change th
e GNSS settings.
Table 5: Help menu
MenuDescription
HelpDisplays the online help.
User Manual
About RSA MapDisplays information about the RSA Map version.
xxx
Displays a PDF version o f the online help.
Workingwiththemapdisplay
You can magnify and shrink the map display using the Zoom button.
To zoom in (magnify):
1. Select the Magnify button.
2. Locate the Magnify icon at the top-left corner of the area you wish to magnify and then click (or
double-tap the touchscreen) and drag across the map down and to the right to the lower-right corner of
the area you wish to magnify.
RSA Map will draw a square outline around the selected area.
30RSA Map Printable Help
ReferenceWorking with the map display
3. When you have selected the area you wish to magnify, release the mouse button. RSA Map will
magnify the selected area to fill the map display.
To zoom out (shrink):
1. Select the Zoom button.
2. Locate the Zoom icon at the bottom-right corner of the area you wish to shrink and then click (or
double-tap the touchscreen) and drag across the map up and to the left toward the upper-left corner of
the area you wish to magnify.
RSA Map will draw a square outline around the selected area.
RSA Map Printable Help31
ReferenceChanging map settings
3. When you have selected the area you wish to zoom, release the mouse button (or lift your finger from
the touchscreen). RSA Map will shrink the selected area.
Panning the map
1. Select the Pan button.
2. Click on the map and drag the map to the desired position.
Changing map settings
Use the Settings button to change advanced map settings.
To change advanced map settings:
1. Click the
This displays the Settings window.
(Settings) button.
32RSA Map Printable Help
ReferenceChanging map settings
2. Click the Advanced Map tab.
3. Change the settings as required. See the table below.
4. Clic
k Done when you have finished changing settings.
Advanced map settings
GroupSettingDescription
Map label
Display labelDisplay or hide map labels. Labels normally include street
names.
RSA Map Printable Help33
ReferenceChanging map settings
Advanced map settings (cont.)
GroupSettingDescription
Label character set
Ignore shape style
Coordinate System
Projected Coordinate SystemSets the coordinate system. This value is set automatically
Geographic SystemSpecifies the reference system used to represent locations.
Turn Off (unknown system)You can turn off the coordinate system if you do not know
xxx
Set the character set for map labels. Labels on a map
can be created with different character sets, for example,
Chinese or English. You may need to set the character set
to match the label. Available selections are:
System - The system character set.
GBK, GB18030, Big5 – Chinese character sets.
UTF-8 - A common character set encoding.
Causes RSA Map to ignore shape styles specified in a
MapInfo map file.
when a map is loaded. For a geo-referenced map, it
defaults to Projected Coordinate System (WGS 84 Word
Mercator (epsg:3395)). For a non-geo-referenced map, it
defaults to Geographic System (WGS 84 (epsg:4326)).
You can select a different system from the drop-down list.
You can select a different system from the drop-down list.
what system is being used in the loaded map.
34RSA Map Printable Help
Index
Index
A
About RSA Map
Help menu, 30
Advanced Map settings, 32
azimuth
changing, 20
azimuth arrow
deleting, 21
drawing,
azimuth line style, 20
Azimuth line style - A rrow