The "PREDICTIONS" Tabular Data object is read-only except for the LOCKED field, which can be used to lock or unlock path loss matrices of a transmitter.
Atoll Version
2.8.0
The field PATH_NAME is read-write. Its value can be set to Null , in which case path loss matrices for TX_ID are deleted.
Atoll Version
2.8.1
New columns are available
These values are available even when VALID returns FALSE but they are not up to date when the resolution of path loss matri- ces, the calculation area, or the transmitter location has changed.
Else
MsgBox "Not an array" End If
End Sub
Column Name Type Description
TX_ID String Transmitter name.
LOCKED Boolean True if the path loss matrices are locked, otherwise False.
VALID Boolean True if the main and extended path loss matrices are valid, otherwise False.
INVALID_CAUSE String Cause of invalidity, when VALID returns False.
Null value when VALID returns True.
SIZE Integer Size of the main matrix plus the size of the extended matrix, in bytes.
PATHNAME String
Null value when there is no storage for the main matrix. "(Embedded in document)" if the storage is not external.
Otherwise contains the main path loss matrix file path.
PATHLOSS Object
The object implements the IGridData interface. This grid data contains the main path loss matrix data for transmitter TX_ID.
Null value when there is no available result for the main matrix.
SIGNAL Object
The object implements the IGridData interface. This grid data contains the main signal level matrix data for transmitter TX_ID.
Null value when there is no available result for the main matrix.
LOWRES_PATHLOSS Object
The object implements the IGridData interface. This grid data contains the extended path loss matrix data for transmitter TX_ID.
Null value when there is no available result for the extended matrix.
LOWRES_SIGNAL Object
The object implements the IGridData interface. This grid data contains the extended signal level matrix data for transmitter TX_ID.
Null value when there is no available result for the extended matrix.
LOWRES_PATHNAME String
Atoll version 2.7.0
Null value when there is no storage for the extended matrix. "(Embedded in document)" if the storage is not external. Otherwise contains the extended path loss matrix file path.
Atoll Version
3.1.0
New columns are available:
TX_PATHLOSS, TX_SIGNAL , TX_LOWRES_PATHLOSS, TX_LOWRES_SIGNAL for the transmitter TX_ID do not take into account its repeaters or remote antennas.
On the contrary, using PATHLOSS, SIGNAL, LOWRES_PATHLOSS, LOWRES_SIGNAL, contributions from repeaters or remote antennas are combined into one matrix.
Please use TX_PATHLOSS, TX_SIGNAL , TX_LOWRES_PATHLOSS, TX_LOWRES_SIGNAL columns when you need to consider transmitter signal or path loss independently from its repeaters or remote antennas.
Atoll Version
3.2.0
It is now possible to update path loss matrices with external results (.LOS files).
Column Name Type Description
GRID_X Double
X-coordinate of the top-left corner of the main path loss matrix upper-left pixel.
Null value when there is no available result for the main matrix.
GRID_Y Double
Y-coordinate of the top-left corner of the main path loss matrix upper-left pixel.
Null value when there is no available result for the main matrix.
GRID_NX Integer Number of columns in the main path loss matrix.
Null value when there is no available result for the main matrix.
GRID_NY Integer Number of rows in the main path loss matrix.
Null value when there is no available result for the main matrix.
GRID_RESX Double Resolution of the main path loss matrix, in metre.
Null value when there is no available result for the main matrix.
GRID_RESY Double Resolution of the main path loss matrix, in metre.
Null value when there is no available result for the main matrix.
LOWRES_GRID_X Double
X-coordinate of the top-left corner of the extended path loss matrix upper- left pixel.
Null value when there is no available result for the extended matrix.
LOWRES_GRID_Y Double
Y-coordinate of the top-left corner of the extended path loss matrix upper- left pixel.
Null value when there is no available result for the extended matrix.
LOWRES_GRID_NX Integer Number of columns in the extended path loss matrix.
Null value when there is no available result for the extended matrix.
LOWRES_GRID_NY Integer Number of rows in the extended path loss matrix.
Null value when there is no available result for the extended matrix.
LOWRES_GRID_RESX Double Resolution of the extended path loss matrix, in metre.
Null value when there is no available result for the extended matrix.
LOWRES_GRID_RESY Double Resolution of the extended path loss matrix, in metre.
Null value when there is no available result for the extended matrix.
Column Name Type Description
TX_PATHLOSS Object The object implements the IGridData interface.
TX_SIGNAL Object The object implements the IGridData interface.
TX_LOWRES_PATHLOSS Object The object implements the IGridData interface.
TX_LOWRES_SIGNAL Object The object implements the IGridData interface.
Atoll 3.3.2 Task Automation Guide
Chapter 7: Zones and Predictions Tabular Data Objects © 2016 Forsk. All Rights Reserved.
You can edit the PATH_NAME or LOWRES_PATHNAME columns, specifying valid .LOS absolute full path.
In this case, when the row in the predictions table is updated, path loss matrices are updated with the content of files previ- ously specified.
Please note that fo this to work, you have to georeference your provided .LOS files, with a standard BIL header file (.hdr). Please note that even if your .LOS files need to be georeferenced just like they were .BIL files, .LOS files are written bottom- up, not top-down.
TX_PATHLOSS Object
The object implements the IGridData interface. This grid data contains the main path loss matrix data for transmitter TX_ID.
Null value when there is no available result for the main matrix. Values returned do not include contributions from repeaters or remote
antennas of the transmitter TX_ID.
TX_SIGNAL Object
The object implements the IGridData interface. This grid data contains the main signal level matrix data for transmitter TX_ID.
Null value when there is no available result for the main matrix. Values returned do not include contributions from repeaters or remote
antennas of the transmitter TX_ID.
TX_LOWRES_PATHLOSS Object
The object implements the IGridData interface. This grid data contains the extended path loss matrix data for transmitter TX_ID.
Null value when there is no available result for the extended matrix. Values returned do not include contributions from repeaters or remote
antennas of the transmitter TX_ID.
TX_LOWRES_SIGNAL Object
The object implements the IGridData interface. This grid data contains the extended signal level matrix data for transmitter TX_ID.
Null value when there is no available result for the extended matrix. Values returned do not include contributions from repeaters or remote
Chapter 8
CoordSystem
Object
Atoll 3.3.2 Task Automation Guide
8 CoordSystem Object
This object contains the entire definition of a coordinate system. Several coordinate systems are used in Atoll documents; one for display, one for projected geographic files, and one for site coordinates. The last one can be related to the system used for display.
This object is not defined in Atoll library but in the FSKGISLib library. It can convert points coordinates from one coordinate system to another.
The CoordSystem object provides the following properties and methods:
For details on coordinate systems, see the Technical Reference Guide.