File Formats

Visualyse Binary Files

Visualyse Professional binary files are stored complete with all the information that is required to describe a scenario including the windows used. The file format is not available to the user.

Shaped Beams Gain Tables

The shaped beams are constructed as a table, with a grid of azimuth and elevation angles, and a gain value for each point on the grid. To ease defining complex gain tables, the data can be read in from a text file.

Two formats are available:

  1. HP-CON
  2. Visualyse Professional

HPCON

HPCON is a standard format for antenna pattern data. The format is defined by TICRA Copenhagen, the world leader in antenna design and analysis software.

The format used is described below:

RecordDataFormat
First LineIdentifying label18 characters of text
Second LineU1,U2,V1,V2,MU,MV Where: U1 = start azimuth, U2 = end azimuth, V1 = start elevation, V2 = end elevation, MU = number of azimuths, MV = number of elevations.Floating point number represented by an 8 character fixed field padded out with spaces. Accuracy is 3 decimal places. Integer value represented by a 4 character fixed field padded out with spaces
Subsequent Lines(ZR(I,J), J=1,MV) , I=1 MU Where ZR(I,J) is the gain for the Ith azimuth and Jth elevation. There is a maximum of 10 entries per line.Floating point number represented by an 8 character fixed field padded out with spaces. Accuracy is 3 decimal places.

Additional data may follow such as the phase of field for each azimuth and elevation, but this is ignored.

Visualyse Professional

There are two possible file formats whereby the data is read in in rows or columns.

The fields are text, separated by one of the following:

  1. tabs
  2. commas
  3. spaces

Format 1:

The file format is described below. The square brackets would not appear in the actual file.

[AzStart] [AzStep] [AzNum] [ElStart] [ElStep] [ElNum]

[Gain X-1 Y-1]

:

[Gain X-n Y-1]

[Gain X-1Y-2]

:

[Gain X-nY-2]

:

:

[Gain X-1Y-m]

:

[Gain X-nY-m]

where:

[AzStart] = start (smallest) azimuth in degrees

[AzStep] = spacing between azimuth grid points (degrees)

[AzNum] = number of azimuth points

[ElStart] = start (smallest) elevation in degrees

[ElStep] = spacing between elevation grid points (degrees)

[ElNum] = number of elevation points

[Gain Az-i El-j] = gain of i-th Azimuth point, j-th Elevation point in dB

Format 2:

The file format is described below using the same notation as for the previous version:

[AzStart] [AzStep] [AzNum] [ElStart] [ElStep] [ElNum]

[Gain X-1 Y-1]

:

[Gain X-1 Y-n]

[Gain X-2Y-1]

:

[Gain X-2Y-n]

:

:

[Gain X-nY-1]

:

[Gain X-nY-m]

Shaped Antenna Type: Multiple Tables File Format

This section describes the file format to load Multiple Tables into a Shaped Antenna Type. The Antenna Type should use an electronically steered beam.

File Type

The fields are text, separated by one of the following:

  1. tabs
  2. commas
  3. spaces

Header Format

The file format is described below for Shaped Antenna Type with N gain tables. The square brackets would not appear in the actual file.

[DataTypeCode] [NumberOfTables = N]

[GainTable 0]

[Azimith-1] [Elevation-1]

[GainTable 1]

:

[Azimith-N-1] [Elevation-N-1]

[GainTable N-1]

The following DataTypeCodes are valid:

101 = Gain tables dependent upon azimuth only and the elevation can be set to zero. Visualyse will select the gain table with skew angle closest to the given azimuth angle, rotate until the pattern has the same skew angle and then rotate the pattern around the sub-satellite point to align with the target pointing direction.

102 = Gain table dependent upon both azimuth and elevation. Visualyse will select the GainTable with (azimuth, elevation) closest to the beam pointing direction, and then rotate the pattern so it aligns with the target pointing direction.

The format of the field [GainTable N] is given in the following section.

The gain table Gain(az, el) reflects the beam when it is pointing at a direction = (azimuth, elevation). So, in most cases, the gain table should have it’s peak gain at the given (azimuth, elevation).

The 0-th gain table is the sub-satellite one i.e. for an (azimuth, elevation) = (0, 0) so there is no need to enter the azimuth or elevation angles for that table.

GainTable Format

The file format is described below. The square brackets would not appear in the actual file.

[AzStart] [AzStep] [AzNum] [ElStart] [ElStep] [ElNum]

[Gain X-1 Y-1]

:

[Gain X-n Y-1]

[Gain X-1Y-2]

:

[Gain X-nY-2]

:

:

[Gain X-1Y-m]

:

[Gain X-nY-m]

where:

[AzStart] = start (smallest) azimuth in degrees

[AzStep] = spacing between azimuth grid points (degrees)

[AzNum] = number of azimuth points

[ElStart] = start (smallest) elevation in degrees

[ElStep] = spacing between elevation grid points (degrees)

[ElNum] = number of elevation points

[Gain Az-i El-j] = gain of i-th Azimuth point, j-th Elevation point in dB

The gain values are loaded in azimuth rows (from lowest azimuth to largest azimuth) starting with the lowest elevation row.

ITU Graphical Data

Visualyse Professional has the ability to read/write files based on the format for shaped beams specified in ITU CR/58. The file format structure is text with sections as used by Microsoft Windows INI files, i.e.:

[SectionName1]

key1=value1

key2=value2

[SectionName2]

key1=value1

key2=value2

The sections are:

  1. FormatInfo: specifies the file format

  2. GeoMain: contains general information such as name and satellite location

  3. COHeader: specifies parameters such as number of contours and boresights

  4. Bi: one section for each boresight

  5. Ci: one section for each contour, specifying level and series of lat/long points

    These sections are described in more detail in the sections below.

FormatInfo

This has a single field to specify the version which is set to one, i.e.:

KeyTypeDescription
format_verintVersion, set to 1

GeoMain

This section contains global information about the file. The fields are:

KeyTypeDescription
admcharThe notifying administration: this field is not used within Visualyse Professional and so is set to DK for export.
ntwk_orgcharThe responsible organisation operating the satellite: this field is not used within Visualyse Professional and so is set to DK for export.
sat_namecharThis is the satellite name and is used as the antenna description
long_nomcharThe satellite’s nominal longitude, used as the antenna longitude
n_diagintThe number of diagrams: not used by Visualyse Professional, so set to 1 for export.

COHeader

This section describes the contours contained within the file. The fields are:

KeyTypeDescription
beam_idcharThe designation of the beam. Set to 1 for export
emi_rcpcharThe emission / reception flag at the satellite, set to E for emission, R for reception. Visualyse Professional does not distinguish between up and down beams: for export this field is set to E.
polar_disccharThe polarisation discriminator, set to C for co-polarisation, X for cross-polarisation. Visualyse Professional contours are co-polar (though could be used as cross polar) and so this field should be set to C.
reasoncharThe reason for notification: not used by Visualyse so set to A (advance publication)
n_boreintNumber of boresights
n_contintNumber of contours

Visualyse Professional adds a field to this section to specify the peak gain of the beam. This would not affect how the file is read by other systems, but is required to completely define the pattern. This field has the following structure:

KeyTypeDescription
gainrealpeak gain in dBi of the beam

Bi

There is a separate section for each of the boresights. Each section has the section name of the form Bi, for example the first boresight would have section name B1.

Each boresight section has the following keys:

KeyTypeDescription
gainrealgain relative to peak in dB of the boresight
pgeo-coordThe geographical co-ordinates of the boresight in degrees (longitude;latitude)

Ci

There is a separate section for each of the contours. Each section has the section name of the form Ci, for example the first contour would have section name C1.

Each contour section has the following keys:

KeyTypeDescription
gainrealgain relative to peak in dB of the boresight
n_pointintThe number of points forming the contour
p1geo-coordThe geographical co-ordinates of the first contour point in degrees (longitude; latitude)
::
pngeo-coordThe geographical co-ordinates of the n-th contour point in degrees (longitude; latitude)

Visualyse Professional will convert open contours to closed contours when reading in.

Example

The following file was produced by creating a contour antennas in Visualyse Professional and then using the export to ITU file format option.

[FormatInfo]

format_ver=1

[GeoMain]

adm=DK

ntwk_org=DK

sat_name=GSO_Test_A

long_nom=-105.000

n_diag=1

[COHeader]

beam_id=1

emi_rcp=E

polar_disc=C

reason=A

gain=+30.00

n_bore=1

n_cont=3

[B1]

gain=+0.00

p=-99.559;+40.189

[C1]

gain=-3.00

n_point=30

p1=-109.008;+50.377

p2=-114.173;+49.623

p3=-120.598;+48.491

p4=-123.370;+47.547

p5=-124.126;+42.075

p6=-122.866;+37.170

p7=-120.724;+34.151

p8=-117.449;+32.264

p9=-114.551;+29.434

p10=-109.260;+28.679

p11=-105.102;+25.660

p12=-99.685;+23.208

p13=-96.913;+25.849

p14=-90.488;+28.679

p15=-86.079;+26.981

p16=-81.921;+23.396

p17=-77.890;+21.321

p18=-76.252;+21.321

p19=-77.008;+25.472

p20=-76.504;+31.887

p21=-74.866;+35.660

p22=-70.709;+39.434

p23=-68.945;+42.830

p24=-69.323;+46.415

p25=-72.724;+50.566

p26=-83.307;+51.698

p27=-90.866;+50.000

p28=-97.291;+49.811

p29=-105.228;+50.755

p30=-109.008;+50.377

[C2]

gain=-6.00

n_point=19

p1=-112.535;+62.453

p2=-124.882;+60.377

p3=-129.921;+51.887

p4=-131.307;+37.358

p5=-126.520;+28.113

p6=-116.189;+22.264

p7=-110.016;+16.415

p8=-99.433;+12.642

p9=-91.244;+12.453

p10=-80.787;+14.151

p11=-75.244;+12.642

p12=-69.701;+17.547

p13=-66.173;+35.472

p14=-64.283;+43.208

p15=-67.685;+55.660

p16=-78.898;+59.623

p17=-98.299;+62.264

p18=-108.882;+63.019

p19=-112.535;+62.453

[C3]

gain=-30.00

n_point=5

p1=-140.000;+70.000

p2=-60.000;+70.000

p3=-60.000;+0.000

p4=-140.000;+0.000

p5=-140.000;+70.000

Logged Data

Data can be logged to text file, where it has the following format (the entries in square brackets are fields with values that will depend upon the simulation setup):

Log data from run: [Filename]

Number of logs: [Number of variables logged, n]

Timesteps between logs: [Timesteps between file updates]

Elapsed Time [Var-1 long name] … [Var-n long name]

Time since start [Var-1 short name] … [Var-n short name]

s [Var-1 units] … [Var-n units]

[t-0] [Var-1 at t-0] … [Var-n at t-0]

[t-1] [Var-1 at t-1] … [Var-n at t-1]

: : :

[t-m] [Var-1 at t-m] … [Var-n at t-m]

Terrain Data General Import File Format

The General file format is a flexible documented format to the standard set of terrain file formats (USGS GTOPO 30, SRTM etc). Users can translate terrain of their own format into the General file format for loading into Visualyse Professional.

The first terrain data point read is the height at the bottom left of the terrain region specified. The file is binary and each spot height is 2 bytes.

By default values of -9999 will be displayed as sea on the map so as to differentiate from land with height zero. The Propagation models and Path Profile will use a height of zero in place of -9999.

The first height data point is taken to be the terrain height at the bottom left the next. All the fields are twos compliment, little-endian (Intel) integers and the file is packed binary.

Terrain Area and Data Order
Terrain Area and Data Order

Terrain data can be imported into Visualyse Professional using the following file format:

DescriptionUnitsSize in bytes
Type-4
Version-4
Bottom most latitudemilliseconds4
Left most longitudemilliseconds4
Nlats-4
Nlongs-4
Spacing of latitude pointsmilliseconds4
Spacing of longitude pointsmilliseconds4
Height (1,1)meters2
Height (1,2)meters2
Height (1, nlongs)meters2
Height (2,1)meters2
Height (2,2)meters2
meters2
Height (nlats, nlongs)meters2
EOF--

Where Nlats is the number of latitude points and Nlongs is the number of longitude points.

An example of the alternative sources of data is the Shuttle Radar Topography Mission (SRTM), which can be found at:

http://edcsns17.cr.usgs.gov/srtm/index.html

Land Use Generic File Format

The clutter data is assumed to be structured as in the figure below:

Land Use Generic File Format
Land Use Generic File Format

There is a grid of clutter codes starting from bottom left. Each clutter code represents the environment across the whole of the pixel: therefore with a grid of n lat/long lines there are n pixel codes not n+1 (as for terrain).

The location of the bottom right of the rectangle is defined via the (LatitudeBottom, LongitudeRight) point. The other corner of the rectangle is calculated from:

LongitudeRight = LongitudeLeft + LongitudePoints * LongitudeSpacing

LatitudeTop = LatitudeBottom + LatitudePoints * LatitudeSpacing

Each clutter code is assumed to be an integer in the range [0..15] so that there are sixteen possible clutter environments.

Mapping of codes to propagation parameters

The clutter codes are mapped to propagation parameters such as height of clutter and distance to clutter in the Visualyse Professional configuration dialog as shown in the figure below:

Clutter Configuration Dialog
Clutter Configuration Dialog

Reference Geoid

The clutter file format does not specify the reference geoid and all data used in a simulation (clutter data, terrain data and station locations) should use the same reference geoid.

File Format

Generic clutter data can be imported into Visualyse Professional using the following file format.

DescriptionUnitsSize in bytes
Type-4
Version-4
Bottom most latitudemilliseconds4
Left most longitudemilliseconds4
nLats-4
nLongs-4
Spacing of latitude pointsmilliseconds4
Spacing of longitude pointsmilliseconds4
String name of clutter type 1-20
String name of clutter type 2-20
:::
String name of clutter type 16-20
Code(1,1)-1
Code(1,2)-1
Code(1, nLongs-1)-1
Code(1, nLongs)-1
Code(2,1)-1
Code(2,2)-1
Code(nLats, nLongs-1)-1
Code(nLats, nLongs)-1
EOF--

The field “Type” should be set to 200 and the field “Version” should be 100.

Strings should be ASCII coded zero terminated and padded to a length of 20 bytes including zero.

All the fields are twos compliment, little-endian (Intel) integers and the file is packed binary.

View Overlay XML Files

It is possible to overlay images such as maps and vector data such as boundaries, roads etc on top of the Mercator, Plate Carree and 3D views. This section gives the file format for the XML file that describes the data.

The XML file and any referenced graphics files must be located in the “Visualyse 7/Overlays” directory at the time that Visualyse Professional 7 is started.

View Overlay Images

Images in formats such as JPG and BMP can be displayed on top of Visualyse Professional’s views. An XML file is used to define the four corners (lat, long) in either degrees or radians, and also point to the relevant file.

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [MAP_NAME]

<?xml version="1.0" encoding="utf-8"?>
<image xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" name="[NAME]">
    <texture>[FILENAME]</texture>
    <bottomLeft units="[UNITS]" latitude="[LAT_BL]" longitude="[LONG_BL]" />
    <topLeft units="[UNITS]" latitude="[LAT_TL]" longitude="[LONG_TL]" />
    <topRight units="[UNITS]" latitude="[LAT_TR]" longitude="[LONG_TR]" />
    <bottomRight units="[UNITS]" latitude="[LAT_BR]" longitude="[LONG_BR]" />
    <colour>[TTRRGGBB]</colour>
</image>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

FILENAME filename may include full path or be relative to overlays directory

UNITS either “degrees” or “radians”

LAT_BL latitude in relevant units of bottom left of image

LAT_TL latitude in relevant units of top left of image

LAT_BR latitude in relevant units of bottom right of image

LAT_TR latitude in relevant units of top right of image

LONG_BL longitude in relevant units of bottom left of image

LONG_TL longitude in relevant units of top left of image

LONG_BR longitude in relevant units of bottom right of image

LONG_TR longitude in relevant units of top right of image

TTRRGGBB codes in hex for the Transparency, Red, Green & Blue to use

Note that it is necessary to define the lat/long of all four corners of the image rather than just top (top left and bottom right) as some images could be rotated. For example, maps generated in Universal Transverse Mercator (UTM) or local variants such as the UK’s National Grid do not always align with vertically with the North-South line.

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?>
<image xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Google Maps Seattle">
    <texture>C:\Program Files (x86)\Visualyse 7\Overlays\Seattle Area.bmp</texture>
    <bottomLeft units="degrees" latitude="47.17" longitude="-125.6121825" />
    <topLeft units="degrees" latitude="49.81" longitude="-125.6121825" />
    <topRight units="degrees" latitude="49.81" longitude="-120.5035395" />
    <bottomRight units="degrees" latitude="47.17" longitude="-120.5035395" />
    <colour>ffffffff</colour>
</image>

View Overlay Vector Line Data

Vector data such as roads, railways, borders, boundaries etc can be displayed on top of Visualyse Professional’s views. An XML file is used to define a set of (lat, long) points and a line colour is used to connect them.

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [NAME]

<?xml version="1.0" encoding="utf-8"?>
<lines xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="[NAME]" colour="[TTRRGGBB]">  
<line units="UNITS">
<coordinates>
“[LAT_1]”, “[LONG_1]”,
“[LAT_2]”, “[LONG_2]”,
“[LAT_3]”, “[LONG_3]”,
...
“[LAT_n]”, “[LONG_n]”
</coordinates>
</line>
</lines>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

TTRRGGBB codes in hex for the Transparency, Red, Green & Blue to use

UNITS either “degrees” or “radians”

LAT_i set of latitudes

LONG_i set of longitudes

Any number of (lat, long) points may be used, though there could be performance implications for very large data sets.

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?>
<lines xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Washington BEA" colour="8000ffff">
    <line units="degrees">
        <coordinates>
        39.194801,-79.487396,
        39.205856,-79.487099,
        39.279827,-79.487877,
        39.216099,-79.507797,
        39.194801,-79.487396
        </coordinates>
    </line>
</lines>

View Overlay Point Data

Point data such as capital cities can be displayed on top of Visualyse Professional’s views. An XML file is used to define a set of (lat, long) points with a label.

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [NAME]

<?xml version="1.0" encoding="utf-8" ?> 
- <points xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="[NAME]">
  <poi units="[UNITS]" legend="[LEG_1]" latitude="[LAT_1]" longitude="[LONG_1]" /> 
  <poi units="[UNITS]" legend="[LEG_2]" latitude="[LAT_2]" longitude="[LONG_2]" /> 
  <poi units="[UNITS]" legend="[LEG_3]" latitude="[LAT_3]" longitude="[LONG_3]" /> 
  <poi units="[UNITS]" legend="[LEG_4]" latitude="[LAT_4]" longitude="[LONG_4]" /> 
  <poi units="[UNITS]" legend="[LEG_5]" latitude="[LAT_5]" longitude="[LONG_5]" /> 
  <poi units="[UNITS]" legend="[LEG_6]" latitude="[LAT_6]" longitude="[LONG_6]" /> 
</points>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

UNITS either “degrees” or “radians”

LEG_i set of legends

LAT_i set of latitudes

LONG_i set of longitudes

Any number of (lat, long) points may be used, though there could be performance implications for very large data sets.

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?> 
<points xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Capital Cities of the World">
  <poi units="degrees" legend="Kabul" latitude="34.467" longitude="69.1833" /> 
  <poi units="degrees" legend="Tirane" latitude="41.3" longitude="19.81666667" /> 
  <poi units="degrees" legend="Algiers" latitude="36.7" longitude="3.133333333" />
  <poi units="degrees" legend="Plymouth" latitude="16.6802" longitude="-62.2014" /> 
  <poi units="degrees" legend="Saint Johns" latitude="17.1175" longitude="-61.8455" /> 
  <poi units="degrees" legend="The Valley" latitude="18.2249" longitude="-63.0668" /> 
</points>

View Overlay Drawing Objects

Basic shapes including Rectangles, Ellipses and Grids can be displayed on top of Visualyse Professional’s views. An XML file is used to define the drawing object as below:

Rectangle

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [NAME]

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="[NAME]" colour="[TTRRGGBB]">    
<rect units="[UNITS]" top="[LAT_TOP]" left="[LONG_LFT]" bottom="[LAT_BTM] right="[LONG_RGT]" /> 
</drawing>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

TTRRGGBB codes in hex for the Transparency, Red, Green & Blue to use

UNITS either “degrees” or “radians”

LAT_TOP top latitude

LONG_LFT left longitude

LAT_BTM bottom latitude

LONG_RGT right longitude

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Test Rectangle" colour="8000ffff">
<rect units="degrees" top="37.0" left="-9.0" bottom="23.5" right="12.0" />
</drawing>

Ellipse

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [NAME]

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="[NAME]" colour="[TTRRGGBB]">    
<ellipse units="[UNITS]" centrelat="[CTR_LAT]" centrelong="[CTR_LNG]" radiuslat="[RAD_LAT] radiuslong="[RAD_LNG]" /> 
</drawing>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

TTRRGGBB codes in hex for the Transparency, Red, Green & Blue to use

UNITS either “degrees” or “radians”

CTR_LAT centre latitude

CTR_LNG centre longitude

RAD_LAT radius latitude

RAD_LNG radius longitude

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Test Ellipse" colour="8000ffff">
<ellipse units="degrees" centrelat="60.0" centrelong="20.0" radiuslat="10" radiuslong="20" />
</drawing>

Grid

The format is given below, with the fields to complete contained within square brackets and in capital letters - i.e. [NAME]

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="[NAME]" colour="[TTRRGGBB]">    
<grid areaunits="[UNITS]" top="[LAT_TOP]" left="[LONG_LFT]" bottom="[LAT_BTM] right="[LONG_RGT]" horzres="[HOR_RES] vertres="[VER_RES]" /> 
</drawing>

The fields to enter are therefore:

NAME used to display this image on list of possible overlays

TTRRGGBB codes in hex for the Transparency, Red, Green & Blue to use

UNITS either “degrees” or “radians”

CTR_LAT centre latitude

CTR_LNG centre longitude

RAD_LAT radius latitude

RAD_LNG radius longitude

HOR_RES horizontal resolution (km)

VER_RES vertical resolution (km)

An example of this format is given below:

<?xml version="1.0" encoding="utf-8"?>
<drawing xmlns="http://www.transfinite.com" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.transfinite.com overlay.xsd" 
name="Test Grid" colour="8000ffff">
<grid areaunits="degrees" top="30.0" left="-50.0" bottom="10" right="-30" horzres="300" vertres="300" />
</drawing>

Text File Format

Structure

Visualyse Professional has a file format that allows complete definition of simulations in a standard ASCII text file. In it are definitions of all objects and their attributes required to specify any Visualyse Professional sharing scenario. The file format can also be used to define single elements – for example a station or an antenna.

The format is based upon the Microsoft Windows INI structure, using section headers and field names as follows:

[Section Header]

[Field Name] = (value)

The section header describes the object being defined based upon the Visualyse Professional object tree. Each simulation starts at the root object “Simul” and then has branches for stations, antennas, links etc separated by a period or “.”1.

1

This is the reason that Visualyse Professional object names are not allowed to include the “.” character

So the section header for the geographic location of a station called “FS TX” would be:

[Simul.Station List.FS TX.Start LatLongHeight]

Field names are the variables associated with the object defined by the section header – so for the geographic location the variables would be latitude and longitude. The section would then start as follows:

[Simul.Station List.FS TX.Start LatLongHeight]

Name=Start LatLongHeight

Description=Start Earth latitude, longitude, height

Latitude=N38:58'31.2034"

Longitude=W77:9'39.1658"

Creating Text Files

While in theory it is possible to create text files solely using a text editor, in practice it is easier to get Visualyse Professional to make a template which you can then edit. This ensures the format is the one that Visualyse Professional expects, as all the variables and objects must be specified in the correct format.

These can be done by either:

  • Creating a simulation file (as normal) and then using the “Save As” option and selecting the text file format;
  • Opening the Model View and saving the object required as a text file.

Batch Mode

It is also possible to run Visualyse Professional in batch mode from the command line. This could be useful if there are many simulations to be run or an iterative approach is required.

With this file format the command line would be something like:

C:\\Program Files (x86)\\Visualyse 7\\Program\>visualyse –x mss-fs.txt

where the -x command closes Visualyse Professional on completion of the run.

This command line would save the results into the file “mss-fs.txt” which could then be read in by other programs.

Service Area Wizard

Station locations can be read into Visualyse Professional using the service area wizard. This requires a text file with a set of rows similar to this:

[Lat-1], [Long-1]

[Lat-2], [Long-2]

: :

The fields should be separated by commas.

TLEs

Satellites orbit data can be read into Visualyse Professional using the Two Line Element (TLE) format.

This file format is defined in the document that can be found here:

http://celestrak.com/columns/v04n03/

FS Import

The FS Import tool uses a pre-defined format in which each row defines one point to point (PtP) link. The FS Import requires the following fields to be defined and then either pasted into Visualyse Professional or be available in a CSV format file:

ColumnField
1Link Number
2Link Name Or Reference
3Operator Name
4Centre Frequency (GHz)
5Licensed Bandwidth (MHz)
6Tx OBW (MHz)
7Transmit Station Name
8Tx Longitude (degrees)
9Tx Latitude (degrees)
10Tx Height Above Terrain (m)
11Receive Station Name
12Rx Longitude (degrees)
13Rx Latitude (degrees)
14Rx Height Above Terrain (m)
15Transmit Power (dBW)
16Tx Antenna Peak Gain (dBi)
17Tx Antenna Gain roll-off Code
18Tx Antenna Beam width (degrees)
19Tx Feed Loss (dB)
20Rx Antenna Peak Gain (dBi)
21Rx Antenna Gain roll-off Code
22Rx Antenna Beam width (dB)
23Rx Feed Loss (dB)
24 (*)Hop Geoclimatic Factor (c)
25 (*)pL (Rec P.453)
26Pol
27System Temp (k)
28C/I Threshold
29C/N Threshold
30C/(N+I) Threshold
31I/N Threshold

Fields marked (*) are not required in Visualyse Professional Version 7 but are there to ensure backwards compatibility.

Valid polarisation codes are given in the table below:

PolarisationCode
Linear horizontalH
Linear verticalV
Left hand circularLHC
Right hand circularRHC

The gain patterns should match one of the following codes or text descriptions:

CodeGain Pattern
0Analytic ES
1Analytic NGSO
2App 29 Earth Station
3App 30 Earth Rx Reg 1 & 3 Comm
4App 30 Earth Rx Reg 1 & 3 Ind
5App 30 Earth Rx Reg 1 & 3 WRC-97
6App 30 Earth Rx Reg 2
7App 30 Satellite Tx Reg 1 & 3
8App 30 Satellite Tx Reg 1 & 3 FR
9App 30 Satellite Tx Reg 2
10App 30 Satellite Tx Reg 2 FR
11App 30 Space
12App 30 Space Fast roll-off
13App 30A Satellite Rx Reg 1 & 3
14App 30A Satellite Rx Reg 1 & 3 FR
15App 30A Satellite Rx Reg 2
16App 30A Satellite Rx Reg 2 FR
17App 30B Earth Station A
18App 30B Earth Station B
19App 30B Space Station
20App 30B Space Station FR
21App 7 Earth Station
22App 7 Fixed Service
23App 8 Earth Station
24Bessel
25Capped Bessel
26Cosine
27ETS 300-157 Rx
28ETS 300-158 Rx
29ETS 300-159 Rx
30ETS 300-159 Tx Spec 1
31ETS 300-159 Tx Spec 2
32ETS 300-327 Rx
33ETS 300-327 Tx
34ETS 300-332 Rx
35ETS 300-332 Tx
36ETS 300-333 Rx
37FSATMULTI_1A Earth Station
38FSATMULTI_1A Type A
39GPS L1
40GPS L2
41GPS User
42IMT-MODEL 28 GHz BS
43IMT-MODEL 28 GHz UE A
44IMT-MODEL 28 GHz UE B
45IMT-MODEL BS Indoor
46IMT-MODEL BS Suburban
47IMT-MODEL BS Urban Outdoor
48IMT-MODEL UE Indoor
49IMT-MODEL UE Suburban
50IMT-MODEL UE Urban Outdoor
51ITU-R BO.1443-1
52ITU-R BO.1443-3
53ITU-R F.1245
54ITU-R F.1245-1
55ITU-R F.1245-1 Annex 1
56ITU-R F.1245-2
57ITU-R F.1245-2 Annex 1
58ITU-R F.1245-3
59ITU-R F.1245-3 Annex 1
60ITU-R F.1336 (2.1.1)
61ITU-R F.1336 (2.1.2)
62ITU-R F.1336 (2.2)
63ITU-R F.1336 (4, NOTE 4)
64ITU-R F.1336-1 (k=0)
65ITU-R F.1336-1 (k=0.1)
66ITU-R F.1336-1 (k=0.2)
67ITU-R F.1336-1 (k=0.7)
68ITU-R F.1336-2 (2.1) [k=0.1]
69ITU-R F.1336-2 (2.1) [k=0.2]
70ITU-R F.1336-2 (2.1) [k=0.7]
71ITU-R F.1336-2 (2.1) [k=0]
72ITU-R F.1336-2 (2.2) [k=0.1]
73ITU-R F.1336-2 (2.2) [k=0.2]
74ITU-R F.1336-2 (2.2) [k=0.7]
75ITU-R F.1336-2 (2.2) [k=0]
76ITU-R F.1336-5 Rec 2.1
77ITU-R F.1336-5 Rec 2.2
78ITU-R F.1336-5 Rec 3.1.1
79ITU-R F.1336-5 Rec 3.1.2
80ITU-R F.1336-5 Rec 3.2
81ITU-R F.1336-5 Rec 4
82ITU-R F.1336-5 Annex 4
83ITU-R F.1891 (LN = -25)
84ITU-R F.699-2
85ITU-R F.699-2R
86ITU-R F.699-3
87ITU-R F.699-3R
88ITU-R F.699-5
89ITU-R F.699-6
90ITU-R F.699-7
91ITU-R F.699-8
92ITU-R M.1851 (COS Average)
93ITU-R M.1851 (COS Peak)
94ITU-R M.1851 (COS)
95ITU-R M.1851 (COS2 Average)
96ITU-R M.1851 (COS2 Peak)
97ITU-R M.1851 (COS2)
98ITU-R M.1851 (COS3 Average)
99ITU-R M.1851 (COS3 Peak)
100ITU-R M.1851 (COS3)
101ITU-R M.1851 (COS4 Average)
102ITU-R M.1851 (COS4 Peak)
103ITU-R M.1851 (COS4)
104ITU-R M.1851 (SIN Average)
105ITU-R M.1851 (SIN Peak)
106ITU-R M.1851 (SIN)
107ITU-R M.2101
108ITU-R RS.1813 (Recommends 1)
109ITU-R RS.1813 (Recommends 2)
110ITU-R S.1328 USAKUL1
111ITU-R S.1428
112ITU-R S.1428-1
113ITU-R S.1528 (1.2) LN = -15
114ITU-R S.1528 (1.2) LN = -20
115ITU-R S.1528 (1.2) LN = -25
116ITU-R S.1528 (1.2) LN = -30
117ITU-R S.465-5
118ITU-R S.465-5 (APL)
119ITU-R S.465-5 prior to 1993
120ITU-R S.465-6 Rx
121ITU-R S.465-5 Tx
122ITU-R S.580-6
123ITU-R S.580-6 (APL)
124ITU-R S.672-3 Annex 1 Ls = -10
125ITU-R S.672-3 Annex 1 Ls = -20
126ITU-R S.672-3 Annex 1 Ls = -25
127ITU-R S.672-3 Annex 1 Ls = -30
128ITU-R S.672-3 Ln = -20
129ITU-R S.672-3 Ln = -25
130ITU-R S.672-3 Ln = -30
131ITU-R S.672-4 Annex 1 Ls = -10
132ITU-R S.672-4 Annex 1 Ls = -20
133ITU-R S.672-4 Annex 1 Ls = -25
134ITU-R S.672-4 Annex 1 Ls = -30
135ITU-R S.672-4 Ln = -20
136ITU-R S.672-4 Ln = -25
137Linear with angle
138NGSO FSS RX
139NGSO FSS TX
140Omni directional
141PFD Area
142Parabolic rolloff
143Resolution 221 (LN = -25)
144Resolution 221 (LN = -26)
145Resolution 221 (LN = -28)
146Resolution 221 (LN = -30)
147Resolution 221 (LN = -32)
148SMATV
149Sine
150Sine(x)/x
151SkyBridge RX Type A
152SkyBridge TX Type A
153TVRO
154Teledesic 2 - RX
155Teledesic 2 - RX fixed BW
156Teledesic 2 - TX
157Teledesic 2 - TX fixed BW
158Teledesic Type A
159Teledesic Type B
160Teledesic Type C

Import Tx System

The Import Tx System tool uses a pre-defined format in which each row defines one Transmit station and link. The Import Tx System tool requires the following fields to be defined and then either pasted into Visualyse Professional or be available in a CSV format file:

ColumnField
1Number
2Reference
3Operator Name
4Centre Frequency (GHz)
5Licensed Bandwidth (MHz)
6Tx OBW (MHz)
7Tx Station Name
8Tx Longitude (degrees)
9Tx Latitude (degrees)
10Tx Height Above Terrain (m)
11Transmit Power (dBW)
12Tx Antenna Peak Gain (dBi)
13Tx Antenna Gain roll-off Code
14Tx Antenna Beam width (degrees)
15Polarisation
16Icon
17Tx Antenna Azimuth (degrees)
18Tx Antenna Elevation (degrees)
19Tx Antenna Feeder Loss (dB)
20Number of Links (optional field)

Valid polarisation codes are given in table 3 in the previous section

The gain patterns should match one of the codes or text descriptions in Table 4 in the previous section.

The Icon should be a string of the form icon-name (R,G,B) where R,G,B are values in the range 0 – 255 to indicate colour. For example: dish-medium (200,60,25)

Tower Icons

Name
broadcast-tower
cell-tower
golf-ball
microwave-tower
office-building
broadcast-tower

Dish Icons

Name
5G-base
dish-large
dish-medium
dish-small
dish-tiny
house
microwave-dish
radar
router

Satellite Icons

Name
3-cube
3-panel-h
3-panel
4-dish
8-panel
cube
eos
gps
gso
hubble
iss
leo-2-dish-h
leo-2-dish
leo
ngso-v
ngso
t-long
t-short
wide-span

Handset Icons

Name
mobile-small
mobile
satphone

Vehicle Icons

Name
aircraft
blimp
car
ferry
helicopter
rocket
ship
shuttle
tank
train
truck

Broadcasting Icons

Name
camera-small
camera
hand-mic-small
hand-mic
headset-small
headset
mic-symbol-small
mic-symbol

Marker Icons

Name
marker-cross
marker-dot
marker-flag
marker-map-rounded
marker-map
marker-pin
marker-ring
marker-triangle

Import Rx System

The Import Rx System tool uses a pre-defined format in which each row defines one Receive station and link. The Import Rx System tool requires the following fields to be defined and then either pasted into Visualyse Professional or be available in a CSV format file:

ColumnField
1Number
2Reference
3Operator Name
4Centre Frequency (GHz)
5Licensed Bandwidth (MHz)
6Rx OBW (MHz)
7Rx Station Name
8Rx Longitude (degrees)
9Rx Latitude (degrees)
10Rx Height Above Terrain (m)
11Rx Antenna Peak Gain (dBi)
12Rx Antenna Gain roll-off Code
13Rx Antenna Beam width (degrees)
14Polarisation
15Icon
16Rx Antenna Azimuth (degrees)
17Rx Antenna Elevation (degrees)
18Rx Antenna Feeder Loss (dB)
19Rx Temperature (K)

Valid polarisation codes are given in table 5 in the previous section

The gain patterns should match one of the codes or text descriptions in Table 4 in the previous section.

The Icon should be as per the previous section.

Import Non-GSO Orbit Elements

The Import Non-GSO Orbit Elements tool uses a pre-defined format in which each row defines one Non-GSO station. The Import Non-GSO Orbit Elements requires the following fields to be defined and then either pasted into Visualyse Professional or be available in a CSV format file:

ColumnField
1Number
2Semi-major axis, a (km)
3Eccentricity, e
4Inclination, i (degrees)
5Use LAN
6Longitude ascending node / RAAN (degrees)
7Argument of periapsis (degrees)
8True anomaly (degrees)