Export to Google Earth 3.1

Export to Google EAdd-in User Manu

arthal

version 3.1

Forsk 2011 Export to Google Earth Add-in User Manual

Table of Contents

1 Export to Google Earth Add-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

2 Installing the Export to Google Earth Add-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

3 Activating and Deactivating the Add-in in Atoll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

4 Using the Export to Google Earth Add-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

5 Advanced Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83


1 Export to Google Earth Add-inThe Export to Google Earth add-in can export items such as sites, transmitters, microwave links, their properties, andcoverage prediction plots from Atoll to Google Earth.

The Export to Google Earth add-in is developed by Forsk using the standard Atoll API. It is available on demand and can beused with Atoll version 2.5.2 and later.

2 Installing the Export to Google Earth Add-inAtoll 3.1.0 setup includes the Export to Google Earth add-in, which can be installed at the same time as Atoll 3.1.0. You can,if you wish, install the add-in separately from Atoll using the add-ins own setup program.

Installing the Add-in Separately From Atoll

To install the add-in using the add-ins own setup program:

1. Run the add-ins setup program.

2. Select an installation folder for the add-in. It is not necessary to install the add-in in the Atoll installation directory.

3. Specify whether the installation should only be performed in the current user profile or for all users.

4. Click Next. The add-in is installed.

5. Once the installation is complete, click Close to exit the setup.

Repairing the Already-Installed Add-in

The add-ins setup program allows you to repair the already-installed add-in by re-installing it using the installationparameters that you defined when installing it the first time.

To repair the already-installed add-in:


2. Select Repair Export to Google Earth add-in for Atoll.

3. Click Finish. The add-in is installed again using the installation parameters that you defined when installing the add-inthe first time.

Uninstalling the Add-in

To uninstall the add-in:


2. Select Remove Export to Google Earth add-in for Atoll.

3. Click Finish. The add-in is uninstalled.

You can also uninstall the add-in through Windows Control Panel.

3 Activating and Deactivating the Add-in in AtollOnce installed, the add-in is available in the list of add-ins installed with Atoll.

To activate the add-in in Atoll:

1. Select Tools > Add-ins and Macros from the menu bar. The Add-ins and Macros dialogue appears.

2. Select the GoogleEarthAddin Class check box.

3. Click Close. The Export to Google Earth add-in icon is available in the Add-in toolbar.

Figure 1: Add-ins and Macros Dialogue in Atoll4


You can verify the installation details of the add-in by clicking the Details button in the Add-ins and Macros dialogue.

You can deactivate add-in in the Add-ins and Macros dialogue. For example, if you clear the GoogleEarthAddin Class checkbox in this dialogue, the Export to Google Earth add-in icon will no longer be available in the Add-in toolbar.

4 Using the Export to Google Earth Add-inOnce the add-in is installed, the Export to Google Earth add-in icon is available in Atoll. You have to install Google Earthbefore using the Export to Google Earth add-in in Atoll.

To run the Export to Google Earth add-in:

1. Click the Export to Google Earth add-in icon in the Add-in toolbar. The Export to Google Earth dialogue appears(see Figure 2 on page 5).

2. Select the items to export to Google Earth:

Sites: Select this check box to export the site locations and heights to Google Earth.

You can export other site properties to Google Earth as well. For more information, see step 3.

You can choose to export the site altitudes as Absolute values or Relative to the Ground.

Transmitters: Select this check box to export the transmitter heights, azimuths, antenna beamwidths, mechanicaltilts, and activity statuses to Google Earth.

You can export other transmitter properties to Google Earth as well. For more information, see step 3.

If you are working on a 3GPP Multi-RAT document, you can select transmitters of each technology and theirproperties separately.

Microwave Links: Select this check box to export the microwave link heights and activity statuses to Google Earth.

You can export other microwave link properties to Google Earth as well. For more information, see step 3.

You can select the Fresnel Ellipsoid check box if you wish the add-in to generate and export Fresnel ellipsoids toGoogle Earth for the exported microwave links.

Coverage Plots: Select the coverage prediction plots to export to Google Earth. The list contains all the plotsavailable in the Predictions folder for the current Atoll document.

The Terrain layer should be active in Google Earth. Otherwise, the height informationexported by the Export to Google Earth add-in will not be correctly interpreted byGoogle Earth.

Figure 2: Export to Google Earth Add-in Dialogue

When you export site altitudes as relative to the ground, the altitudes of transmitters arealso exported as relative to the ground and, therefore, depend on the topology of themap.5


3. Select site, transmitter, and microwave link properties to export to Google Earth:

a. Click the Browse button ( ) next to the Properties box corresponding to Sites, Transmitters, or MicrowaveLinks. The Selection of fields dialogue appears (see Figure 3 on page 6).

b. Select the fields you want to export.

To select a field to be exported, select the field in the Available fields list and click to move it to theSelected fields list.

To remove a field from the Selected fields list, select the field and click to remove it from the Selectedfields list.

To change the order of the fields, select one or more fields in the Selected fields list and click or to moveit up or down in the list. The exported properties will be sorted in the order of the fields in the Selected fieldslist, from top to bottom.

c. Click OK.

4. In Save as, enter the name and location for the Google Earth export data storage file created by the add-in.

5. Click OK. The selected items are exported to Google Earth.

The Export to Google Earth add-in automatically runs Google Earth if installed and sets the focus on the location of theexported items. The selected properties are also exported to Google Earth and can be displayed in tip text inside Google Earthby clicking the desired item in the Places window, or by pressing and holding the Ctrl key and clicking the desired item on themap.

The following figures show examples of the export using the add-in.

Figure 3: Selection of Fields to Export to Google Earth

KMZ files are compressed archives that include the KML file containing site, transmitter,and microwave link data, as well as the coverage prediction plots exported in PNGformat. You can open KMZ files and access their contents in most compression/ziputilities.6


Figure 4: Sites, Transmitters, and a Signal Level Coverage Prediction Plot

Figure 5: Transmitter Properties7


5 Advanced ConfigurationSome options may be configured through the GoogleEarth.ini file. This file must be located in the Export to Google Earth add-in installation folder. The following options are available in the [Options] section:

Automatically launch Google Earth after exporting data

OpenDocument = 0 or 1 (default value)

Default name and storage location for the file created by the add-in

DefaultStorage = "C:\TEMP\Atoll.kmz" (example)

If you do not specify any name and location in the .ini file, files created by the add-in will be stored under the defaultname and location: "%USERPROFILE%\Application Data \Google\GoogleEarth\Atoll.kmz".

Do not draw tower graphical details representing sites in Google Earth

SimplifyTower = 0 (default value) or 1

Radius (in metres) of the polygon that represents transmitters in Google Earth

TransmitterSize = 50 (default value)

Number of Fresnel ellipsoids to be drawn for microwave links in Google Earth

EllipsoidNumber = 2 (default value)

Width and height (numbers of pixels) of the maximum texture size supported by Google Earth (see About box inGoogle Earth)

MaximumWidth = 2048 (default value)

MaximumHeight = 2048 (default value)

More accurate export of coverage plots (coverage prediction overlays in Google Earth might have some overlap)

UseAccuracy = 0 (default value) or 1

Width and height (numbers of pixels) of the tile used for the accurate coverage plot export

TileWidth = 128 (default value)

TileHeight = 128 (default value)

Figure 6: Microwave Link and Fresnel Ellipsoid8

Forsk 2011 Export to Google Earth Add-in User Manual9

Export to Google Earth Add-in User Manual

version 3.1

22 July 2011

Head Office7, rue des Briquetiers31700 Blagnac - FranceTel: +33 562 747 210Fax: +33 562 747 211

US Office200 South Wacker Drive - Suite 3100Chicago, IL 60606 - USATel: +1 312 674 4800Fax: +1 312 674 4847

China OfficeSuite 302, 3/F, West Tower,Jiadu Commercial Building,No. 66 Jianzhong Road,Tianhe Hi-Tech Industrial Zone,Guangzhou, 510665, P. R. of ChinaTel: +86 20 8553 8938Fax: +86 20 8553 8285

www.forsk.com

Table of Contents1 Export to Google Earth Add-in2 Installing the Export to Google Earth Add-inInstalling the Add-in Separately From AtollRepairing the Already-Installed Add-inUninstalling the Add-in

3 Activating and Deactivating the Add-in in Atoll4 Using the Export to Google Earth Add-in5 Advanced Configuration

/ColorImageDict > /JPEG2000ColorACSImageDict > /JPEG2000ColorImageDict > /AntiAliasGrayImages false /CropGrayImages true /GrayImageMinResolution 150 /GrayImageMinResolutionPolicy /OK /DownsampleGrayImages true /GrayImageDownsampleType /Bicubic /GrayImageResolution 300 /GrayImageDepth 8 /GrayImageMinDownsampleDepth 2 /GrayImageDownsampleThreshold 1.50000 /EncodeGrayImages true /GrayImageFilter /FlateEncode /AutoFilterGrayImages false /GrayImageAutoFilterStrategy /JPEG /GrayACSImageDict > /GrayImageDict > /JPEG2000GrayACSImageDict > /JPEG2000GrayImageDict > /AntiAliasMonoImages false /CropMonoImages true /MonoImageMinResolution 1200 /MonoImageMinResolutionPolicy /OK /DownsampleMonoImages true /MonoImageDownsampleType /Bicubic /MonoImageResolution 1200 /MonoImageDepth -1 /MonoImageDownsampleThreshold 1.50000 /EncodeMonoImages true /MonoImageFilter /FlateEncode /MonoImageDict > /AllowPSXObjects false /CheckCompliance [ /None ] /PDFX1aCheck false /PDFX3Check false /PDFXCompliantPDFOnly false /PDFXNoTrimBoxError true /PDFXTrimBoxToMediaBoxOffset [ 0.00000 0.00000 0.00000 0.00000 ] /PDFXSetBleedBoxToMediaBox true /PDFXBleedBoxToTrimBoxOffset [ 0.00000 0.00000 0.00000 0.00000 ] /PDFXOutputIntentProfile (None) /PDFXOutputConditionIdentifier () /PDFXOutputCondition () /PDFXRegistryName (http://www.color.org) /PDFXTrapped /False

/CreateJDFFile false /SyntheticBoldness 1.000000 /Description >>> setdistillerparams> setpagedevice

Documents

Export to Google Earth 3.1