export to google earth 4.3

8/13/2019 Export to Google Earth 4.3

1/10

ExporttoGoogleEarth

AddinUserManual

version4.3


2/10


3/10

Forsk2013 ExporttoGoogleEarthAddinUserManual

3

TableofContents

1 Exportto

Google

Earth

Add

in

..................................................4

2 InstallingtheExporttoGoogleEarthAddin .......................................4

3 ActivatingandDeactivatingtheAddininAtoll ....................................4

4 UsingtheExporttoGoogleEarthAddin ..........................................5

5 AdvancedConfiguration.......................................................9


4/10

4


1 ExporttoGoogleEarthAddin

The Export to Google Earth addin can export items such as sites, transmitters, microwave links, their properties, and

coveragepredictionplotsfromAtollsingleRATandmultiRATdocumentstoGoogleEarth.

TheExporttoGoogleEarthaddinisdevelopedbyForskusingthestandardAtollAPI.Itisavailableondemandandcanbe

usedwithAtollversion2.5.2andlater.

2 InstallingtheExporttoGoogleEarthAddin

InstallingtheAddinSeparatelyFromAtoll

Toinstalltheaddinusingtheaddinsownsetupprogram:

1. Runtheaddinssetupprogram.

2. Selectaninstallationfolderfortheaddin.ItisnotnecessarytoinstalltheaddinintheAtollinstallationdirectory.

3. Specifywhethertheinstallationshouldonlybeperformedinthecurrentuserprofileorforallusers.

4. ClickNext.Theaddinisinstalled.

5. Oncetheinstallationiscomplete,clickClosetoexitthesetup.

RepairingtheAlreadyInstalledAddin

The addins setup program allows you to repair the alreadyinstalled addin by reinstalling it using the installation

parametersthatyoudefinedwheninstallingitthefirsttime.

Torepairthealreadyinstalledaddin:


2. SelectRepairExporttoGoogleEarth.

3. ClickFinish.Theaddinisinstalledagainusingtheinstallationparametersthatyoudefinedwheninstallingtheaddin

thefirsttime.

UninstallingtheAddin

Touninstalltheaddin:


2. SelectRemoveExporttoGoogleEarth.

3. ClickFinish.Theaddinisuninstalled.

YoucanalsouninstalltheaddinthroughWindowsControlPanel.

3 Activatingand

Deactivating

the

Add

in

in

Atoll

Onceinstalled,theaddinisavailableinthelistofaddinsinstalledwithAtoll.

ThesetupprogramoftheExporttoGoogleEarthaddinissuppliedinboth:

a32bitversionforAtoll32bit:"ExportToGoogleEarth.msi",and

a64bitversionforAtoll64bit:"ExportToGoogleEarth_x64.msi"

Beforeinstallingthe64bitversionofthisaddin,makesurethatAtoll64bitisinstalled

correctly.Formoreinformation,seetheAtollAdministratorManual.

ThesetupofAtoll3.1.0andlaterincludestheExporttoGoogleEarthaddin,whichcan

beinstalled

at

the

same

time

as

Atoll.

You

can,

ifyou

wish,

install

the

add

in

separately

fromAtollusingtheaddinsownsetupprogram.

Incaseyouareinstallinganewversionofthisaddin,uninstallthecurrentversionbefore

youinstallthenewone.


5/10


5

ToactivatetheaddininAtoll:

1. SelectTools >AddinsandMacrosfromthemenubar.TheAddinsandMacrosdialogboxappears.

2. SelecttheGoogleEarthAddinClasscheckbox.

3. ClickClose.TheExporttoGoogleEarthaddinicon isavailableintheAddintoolbar.

YoucanverifytheinstallationdetailsoftheaddinbyclickingtheDetailsbuttonintheAddinsandMacrosdialogbox.

YoucandeactivatetheaddinintheAddinsandMacrosdialogbox.Forexample,ifyoucleartheGoogleEarthAddinClass

checkboxinthisdialogbox,theExporttoGoogleEarthaddinicon willnolongerbeavailableintheAddintoolbar.

4 Usingthe

Export

to

Google

Earth

Add

in

Oncetheaddinisinstalled,theExporttoGoogleEarthaddinicon isavailableinAtoll.YouhavetoinstallGoogleEarth

beforeusingtheExporttoGoogleEarthaddininAtoll.

ToruntheExporttoGoogleEarthaddin:

1. ClicktheExporttoGoogleEarthaddinicon intheAddintoolbar.TheExporttoGoogleEarthdialogboxappears

(seeFigure 2

on

page 5).

2. Select

the

items

to

export

to

Google

Earth: Sites:SelectthischeckboxtoexportthesitelocationsandheightstoGoogleEarth.

YoucanexportothersitepropertiestoGoogleEarthaswell.Formoreinformation,seestep 3.

YoucanchoosetoexportthesitealtitudesasAbsolutevaluesorRelativetotheGround.

Figure 1:AddinsandMacrosdialogboxinAtoll

TheTerrain layershouldbeactive inGoogleEarth.Otherwise,theheight information

exported by the Export to Google Earth addin will not be correctly interpreted by

GoogleEarth.

Figure 2:ExporttoGoogleEarthAddindialogboxfora3GPPdocument
http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-


6/10

6


Youcanalsoselect/cleartheDisplayLabelcheckboxtoshow/hidesitelabelsinGoogleEarth.

Transmitters:Selectthischeckboxtoexportthetransmitterheights,mechanicalandelectricalazimuths,antenna

beamwidths,mechanicaltilts,andactivitystatusestoGoogleEarth.

YoucanexportothertransmitterpropertiestoGoogleEarthaswell.Formoreinformation,seestep 3.

IfyouareworkingonaMultiRATdocument,youcanselecttransmittersofeachtechnologyandtheirproperties

separately.

MicrowaveLinks:SelectthischeckboxtoexportthemicrowavelinkheightsandactivitystatusestoGoogleEarth.

YoucanexportothermicrowavelinkpropertiestoGoogleEarthaswell.Formoreinformation,seestep 3.

FresnelEllipsoid:SelectthecheckboxifyouwanttheaddintogenerateandexportFresnelellipsoidstoGoogle

Earthfortheexportedmicrowavelinks.

OtherLinks:Selectthischeckboxtoexportotherlinks(FOand/orLL)propertiestoGoogleEarth.

CoveragePlots:Select thecoveragepredictionplots toexporttoGoogleEarth.The listcontainsall theplots

availableinthePredictionsfolderforthecurrentAtolldocument.

Bydefault,

coverage

plots

are

exported

in

raster

format.

You

can

also

export

them

in

vector

format.

To

do

that,

rightclickonthecoverageplotyouwantandselectVectorFormatinthecontextmenu.Youcangobacktoraster

formatbyselectingRasterFormat.

3. Selectsite,transmitter,andmicrowavelinkpropertiestoexporttoGoogleEarth:

a. ClicktheBrowsebuttonnexttothePropertiesboxcorrespondingtoSites,Transmitters,orMicrowaveLinks.The

Selectionoffieldsdialogboxappears(seeFigure 3).

b. Selectthefieldsyouwanttoexport.

Toselectafieldtobeexported,selectthefield intheAvailablefields listandclick tomove ittothe

Selectedfieldslist.

ToremoveafieldfromtheSelectedfieldslist,selectthefieldandclick toremoveitfromtheSelected

fieldslist.

Tochangetheorderofthefields,selectoneormorefieldsintheSelectedfieldslistandclick or tomove

themupordowninthelist.TheexportedpropertieswillbesortedintheorderofthefieldsintheSelected

fieldslist,fromtoptobottom.

c. ClickOK.

4. InSaveas,enterthenameandlocationfortheGoogleEarthexportdatastoragefilecreatedbytheaddin.

Whenyouexportsitealtitudesasrelativetotheground,thealtitudesoftransmittersare

alsoexportedasrelativetothegroundand,therefore,dependonthetopologyofthe

map.

Figure 3:SelectionofFieldstoExporttoGoogleEarth

KMZfilesarecompressedarchivesthatincludetheKMLfilecontainingsite,transmitter,

and

microwave

link

data,

as

well

as

the

coverage

prediction

plots

exported

in

PNG

format. You can open KMZ files and access their contents in most compression/zip

utilities.
http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-


7/10


7

5. ClickOK.TheselecteditemsareexportedtoGoogleEarth.

TheExporttoGoogleEarth addinautomatically runs GoogleEarth if installedandsets the focuson the locationofthe

exporteditems.TheselectedpropertiesarealsoexportedtoGoogleEarthandcanbedisplayedintiptextinsideGoogleEarth

byclickingthedesirediteminthePlaceswindow,orbypressingandholdingtheCtrlkeyandclickingthedesireditemonthe

map.

Thefollowingfiguresshowexamplesoftheexportusingtheaddin.

Figure 5showsthedifferentcellandtransmittersizesdisplayedinGoogleEarth.Fromlargesttosmallest:

GSMtransmitters(topleftsite)

UMTScells(toprightsite)

LTEcells(bottomsite)

Smallcell

(top

cell

in

bottom

site)

Figure 4:Sites,Transmitters,andaSignalLevelCoveragePredictionPlot

Figure 5:CellandTransmitterSizesinGoogleEarth
http://-/?-http://-/?-


8/10

8


Figure 6:TransmitterProperties

Figure 7:MicrowaveLinkwithFresnelEllipsoid


9/10


9

5 AdvancedConfiguration

SomeoptionsmaybeconfiguredthroughtheGoogleEarth.inifile.ThisfilemustbelocatedintheExporttoGoogleEarthadd

ininstallationfolder.Thefollowingoptionsareavailableinthe[Options]section:

Verbose=0(default)or1

Verbosemode.

OpenDocument=0or

1(default)

AutomaticallylaunchGoogleEarthafterexportingdata.

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

Defaultnameandstoragelocationforthefilecreatedbytheaddin.

Ifyoudonotspecifyanynameandlocationinthe.inifile,filescreatedbytheaddinwillbestoredunderthedefault

nameandlocation:"%USERPROFILE%\ApplicationData\Google\GoogleEarth\Atoll.kmz".

SimplifyTower=0(default)or1

DonotdrawtowergraphicaldetailsrepresentingsitesinGoogleEarth.

TransmitterSize=50(default)

Radius(inmetres)ofthepolygonthatrepresentstransmittersinGoogleEarth.

CellPower=30(default).Cellpowerthresholdunderwhichacellisregardedasa"smallcell".

EllipsoidNumber=4(default)

Numberof

Fresnel

ellipsoids

to

be

drawn

for

microwave

links

in

Google

Earth.

DetailLevel=128(default)

Levelofdetail.Youcanuse"DetailLevel"tospecifyaminimumlevelofdetail(insquarepixels).Whenyourcoverage

plotisprojectedontothescreen,itmustoccupyanareaofthescreenthatisgreaterthan"DetailLevel"inordertobe

visible.Iftheprojectedsizeofthecoverageplotisbelowthislimit,thenthecoverageplotwillnotbevisible.

MaximumWidth=4096(default)

MaximumHeight=4096(default)

Widthandheight(numbersofpixels)ofmax.texturesizesupportedbyGoogleEarth(seeAboutboxinGoogleEarth).

UseAccuracy=0(default)or1

Moreaccurateexportofcoverageplots(coveragepredictionoverlaysinGoogleEarthmighthavesomeoverlap).

TileWidth=1024(default)

TileHeight=1024(default)

Widthand

height

(numbers

of

pixels)

of

the

tile

used

for

the

accurate

coverage

plot

export.

TileNumber=1024(default)

Maximumnumberoftilesthatcanbegenerated,indirectproportiontothesizeofthecoveredareaandthesizeof

thetiles(TileWidth,TileHeight).

OverlapLayers=0(default)

Indicateswhetherornotthepolygonscorrespondingtodifferentsignallevelswillbesuperimposed.


10/10

ExporttoGoogle

EarthAddin

UserManual

version 4.3

September2013

HeadOffice7,ruedesBriquetiers

31700Blagnac France

Tel:+33562747210

Fax:+33562747211

USOffice200SouthWackerDrive Suite3100

Chicago,IL60606 USA

Tel:+13126744800

Fax:+13126744847

ChinaOfficeSuite302,3/F,WestTower,

JiaduCommercialBuilding,

No.66JianzhongRoad,

TianheHi

Tech

Industrial

Zone,

Guangzhou,510665,P.R.ofChina

Tel:+862085538938

Fax:+862085538285

www.forsk.com
http://-/?-http://www.forsk.com/http://-/?-http://www.forsk.com/

export to google earth 4.3

Documents