tide tool 7.0 manual v1.1

7/18/2019 Tide Tool 7.0 Manual V1.1

http://slidepdf.com/reader/full/tide-tool-70-manual-v11 1/38

Tide Tool ManualV7.0

June 2009Tide Tool Version 7.0, Client Version 1.1

AbstractTide Tool is an operational tool developed and supported by the PaciicTsuna!i "arnin# Center or the decodin#, display, and !anipulation o sea level data trans!itted over the "M$ %lobal Teleco!!unications&yste! '%T&(. Tide Tool continuously decodes %T& sea level !essa#esin real)ti!e and displays the ti!e series on a co!puter screen* users areable to interactively !anipulate the ti!e series to !easure +ave

a!plitude and period, and to re!ove the tidal si#nal. on)operationalversions also e-ist or data trans!issions throu#h the internet 'tp( andor archived data.

1. Introduction

Tide Tool is created by the Tide.tcl script, +hich is based on the TclT/ e-tension calledT3. TclT/ is an open source, plator!)independent sot+are pac/a#e. TclT/ at itsheart is a robust shell pro#ra!!in# lan#ua#e 'tclsh( +ith a po+erul, #raphical tool/it'+ish( '4ppendi- 5(. #etTide is an additional T script that can be used to read and

analy6e old sea)level data lo# iles. Tide.tcl provides end users +ith the ability to decode,display, and !anipulate sea level data broadcast over the %lobal Teleco!!unications&yste! o the "orld Meteorolo#ical $r#ani6ation '"M$(. ata are continuouslydo+nloaded directly ro! the %T& to a data ile, +hich is then decoded and displayed. 4version is also available usin# a non)%T& 8tp data trans!ission protocol in inu- and"indo+s :PVista or tsuna!i centers +ithout %T& lin/s '4ppendices 55 and 555(. The8tp !ethod should be considered non)operational i co!!ercial internet service isutili6ed since connection reliability and ti!eliness, especially durin# tsuna!ie!er#encies, cannot be #uaranteed. The sot+are application +as ori#inally developed by the ;& $44 "& PaciicTsuna!i "arnin# Center to provide an operational tool or the real)ti!e continuoustsuna!i !onitorin# in the 5ndian $cean. 5ts pri!ary users +ould be ationalMeteorolo#ical and <ydrolo#ical &ervice 'M<&(, or other a#encies +ith a do+n lin/ ro! the %T& or to a data ile containin# those data or!atted in a si!ilar !anner. 5t has

been tested under ;5:, 5;:, "indo+s 2000, :P, and Vista environ!ents in5ndonesia, Malaysia, the 5$= 'el#iu!(, 5T5C and at the PT"C.

1



The sot+are is easily !odiied or chan#es in sea)level !essa#e or!attin# and theaddition o sea)level stations. The pri!ary use o this sot+are is as an operational

pro#ra! run by tsuna!i +arnin# centers, or other a#encies, that need to continuously!onitor sea levels. Mouse)clic/able unctions include the e-pansion o the ti!e series,and !easure!ent o the arrival ti!e, +ave hei#ht and +ave period ro! the inco!in#si#nal.

Tide Tool V7.0 co!es +ith dyna!ic !ap clients3 +hich allo+ users to select individualstations or display. The clients have a 6oo!3 eature that allo+s users to select an areaon the !ap client and enlar#e it. &oc/et handlers +ere added to the Tide.tcl script, suchthat Tide.tcl beco!es a server listenin# or re>uests on a desi#nated soc/et. The clientsconnect to Tide.tcl over this soc/et.

Requirements:5n order to decode, run the dyna!ic !ap clients and display the data, the ollo+in# arere>uired?

• Co!puter runnin# TclT/ sot+are +ith T e-tension

• &ea level data that are continuously archived into a data ile

• Tide.tcl sot+are

Tide Tool can be do+nloaded ro! http?ili/ai.soest.ha+aii.edupt+c. oo/ or the latestversion 'versions nu!bered se>uentially( and do+nload the acco!panyin#

TideTool@Metaata ile and the Tide@Coes directory. 4 co!plete !etadata inventory o PT"Cs sea)level station list can also be ound at this lin/ in the C$MP@M=T4 ile.This +ill allo+ you to custo!i6e the stations your TideTool +ill decode.

5n a related proAect, PT"C, in collaboration +ith collea#ues at $44s 5=4 Center, isstandin# up a !etadata server. "e are encoura#in# !aintainers o sea)level #au#es andsea)level #au#e net+or/s to participate in this proAect. The #oal is to establish a +ebservice that provides up)to)date !etadata or all sea)level stations. &ea)level stationnet+or/ !ana#ers +ill be able to !aintain the !etadata or their net+or/s usin# thisservice. 5n the uture, TideTool +ould be able to directly access the service to ensure the!etadata it is usin# is up to date. 5 you are interested in bein# a user, supplier, or both, o sea)level station !etadata, please contact &tuart "einstein, PT"C.

Currently, the $44 5dea Center is producin# a /!l ile that, +hen i!ported into%oo#le =arth, +ill #ive a #lobal vie+ o the sea)level stations and their !etadata content.The /!l ile is developed ro! the C$MP@M=T4 ile. Bou can ind the /!l ile at?http?+++.sealevelstations.or# stations./!l

2



Computer and Software Requirements:The sot+are re>uires the installation o the TclT/ sot+are pac/a#e and the Te-tension, both o +hich are reely available or do+nload and easy to install. Thesot+are has been installed and tested under ;ni-, inu-, and "indo+s 2000, :P, andVista operatin# syste!s '$&(. ;se on other plator!s is possible as it only depends onthe TclT/ and T sot+are bein# available. The sot+are does not re>uire substantialco!putin# po+er, and can thus run easily on a Pentiu! 555 or hi#her PC syste!.

&o!e users do+nload the sea)level !essa#es on a PC runnin# a lavor o "indo+s andthen transer the data to a ;5:5;: syste! or vice versa. Bou !ust !a/e sure thatthe scripts, !etadata and sea)level !essa#e iles are consistent +ith the plator! TideTool is runnin# on. Tide Tool chec/s +hat $& it is runnin# under and e-pects the iles tohave the end)o)line and end)o)ile ter!inators appropriate or that $&. ;se thedos2uni- or uni-2dos utilities to ensure consistency +ith the $&.

5t is not our intention to #ive a TclT/ tutorial in this !anual, as there are several #ood boo/s and +ebsites on the subAect. Please reer to a short list o the! in 4ppendi- 5.There is a lar#e TclT/ user co!!unity, and there is a %oo#le #roup 'co!p.lan#.tcl(devoted to TclT/ issues.

2. ConfigurationFor DecoderTo e-ecute Tide.tcl, you !ust run the blt+ish.e-e pro#ra!. ote that blt+ish2.e-e is an

alias to blt+ish.e-e, so either can be used. ;5: users can turn the Tide.tcl script into ane-ecutable by !a/in# the irst line in the script?

DEull@pathblt+ish and then !a/in# the script e-ecutable 'ch!od uF- Tide.tcl(.

"hen the blt+ish console appears, Aust type source Tide.tcl and the pro#ra! should start.4lternatively, you !ay type blt+ish Tide.tcl on a co!!and line to start the pro#ra!.

Gor "indo+s PC users, another easy +ay to start Tide.tcl and the Map clients +ithouthavin# to open a console to type the co!!and is to si!ply drop the script onto a

blt+ish2.e-e icon. To do this, create a short cutalias o blt+ish2.e-e and place it as anicon on the des/top. To run Tide.tcl and the !ap clients, hi#hli#ht the tcl script ro! thedirectory +here they reside and !ovedrop it onto the blt+ish2.e-e icon to start thescript.

H



There are 1H custo!i6able para!eters. Bou can assi#n their values at the top o theTide.tcl script. #etTide also uses the sa!e para!eters. The assi#n!ent state!ents arealready placed near the top o the script. They have the or!?

set parameter “

5 nothin# is placed bet+een the 3, deault values +ill be used or so!e eatures +ill bedisabled. Bou !ust ho+ever speciy the ilena!e para!eter.

The 1H para!eters are?

1. fi!ename? Tide.tcl assu!es the lo# iles +hich contain the %T& '"M$( data are in theor! rootJJJBB.lo# +here JJJ is a three di#it Julian day and BB is the t+o di#it year. Theilena!e includes the path and ilena!e sui- or root, and should be speciied as

pathroot. ote that the 8I is a special character in the Tcl +orld and !ust be escaped.Thereore i you use the bac/slash in the path speciication, it !ust be +ritten as 8IIother+ise the path +ill be #arbled. The ilena!e para!eter must be set other+ise TideTool +ill not +or/.

4n e-a!ple ro! PT"Cs i!ple!entation o Tide Tool is?set fi!ename “"data"!ogs"nmc"sr+here datalo#sn!c is the path and sr is the root. <ence the ilena!e o a lo# ile or day 11, 200 is datalo#sn!csr110.lo# .

2. dirname? Tide.tcl also has the ability to +rite the decoded tide data to iles. Thedecoded data iles have the synta-? station.#au#e.JJJ +here JJJ is Julian day. The data isarran#ed in a t+o)colu!n 4&C55 or!at? ti!e in ractional Julian day and sea)levelhei#ht in !eters. To enable this eature you !ust deine the dirna!e3 para!eter in thescript. This para!eter speciies +here the decoded tide data is +ritten. 5 this para!eter isnot speciied decoded data +ill not be +ritten to your syste!.

4n e-a!ple ro! PT"Cs i!ple!entation is?set dirname “"#ome"stuart"$ide"2%%&"

ote? This directory !ust be created beore runnin# Tide.tcl* it +ill not be created or you.

'. #ardirname? Tide.tcl +ill no+ de)tide the decoded sea)level !essa#es. The iles thatcontain the har!onic coeicients have the na!in# convention [email protected] are to be placed in the directory speciied by the #ardirname variable.



4n e-a!ple ro! PT"Cs i!ple!entation is?set #ardirname “"#ome"stuart"$ide"$ide(Coeffs"

). metadata(fi!ename? The ull pathna!e or the !etadata ile +hich deter!ines +hichstations to decode and display. 5 not speciied, .TideTool@Metaata is assu!ed.

4n e-a!ple ro! PT"Cs i!ple!entation is?set metadata(fi!ename “."C*+,(+-$A

. mapdirname: Tide Tool can no+ display !aps sho+in# the #eo#raphical conte-t in+hich the sea)level station lies. These !aps contain a lot o inor!ation and they +ill bedescribed later in this docu!ent.

4n e-a!ple ro! PT"Cs i!ple!entations?set mapdirname /"data"ttt(dbase"geoware"maps"/

0. ti!e!istfi!e? This speciies the na!e o a ile +hich contains station)sensor code pairs.4ter Tide Tool is inished +ith its initial read o the lo#ile ater startup it +illauto!atically tile the screen +ith displays correspondin# to those stations.

4n e-a!ple ro! PT"Cs i!ple!entation is?set ti!e!istfi!e “"#ome"stuart"$ide"$i!e(ist

. record(fi!ename: Bou can no+ record !easure!ents o sea)level hei#hts and those!easure!ents +ill be +ritten to the ile speciied by record@ilena!e.

4n e-a!ple ro! PT"Cs i!ple!entation is?set record(fi!ename “.."obser3ations

4. error(!og: Messa#es +ith bad ti!e sta!ps, i!proper or!ats and unreco#ni6edheaders +ill be +ritten to the ile speciied by error@lo#.

4n e-a!ple ro! PT"Cs i!ple!entation is ?set error(!og “-rror(!ogThe actual lo#iles +ill be error@lo#.Ad +here Ad is Julian ay.

K



&. printer(command? Tide Tool stores the latest 100 !essa#es ro! each tide station.These !essa#es are vie+able and can be !ade printable i the variableprinter(command is set to the local syste!s printer co!!and.

4n e-a!ple ro! !y i!ple!entation is?set printer(command “enscript 5fCourier67o!d4 28 "de3"nu!!

1%. $9C(DAR$(F*R+A$? 5 this is set to 13, Tide Tool +ill +rite the decoded4LT data iles usin# the sa!e or!at as does PT"C. 4n e-a!ple o that or!at is#iven belo+?

Gile? KK01K@[email protected]

The ilena!e is co!posed o the 4LT buoy nu!ber, a three letter code and the year andJulian day. The three letter code can be one o nha, tra, tha, nhb, trb, thb, +hich indicatenor!al trans!ission !ode 'nha, nhb(, tri##er trans!ission !ode 'tra, trb( and tri##eredhourly !essa#es 'tha, thb(. The contents o ile KK01K@[email protected] loo/ li/e?

# DART_Tasman_Sea_55015 dtas nha 55015 NDBC NORMAL_MODE -46.9222 160.5622 2008234

# DART m UTC 15 min Water_Depth PTWC Unfiltered

# DCP_PLATFORM_ID 55015P

# Data Format: SampleTIme(seconds from midnight 1/1/1970) WaterLevel

SampleTime(yyyymmddhhmmss)

1219276800 04944.306 20080821000000

1219277700 04944.378 20080821001500

1219278600 04944.442 20080821003000

1219279500 04944.504 20080821004500

1219280400 04944.556 200808210100001219281300 04944.602 20080821011500

1219282200 04944.643 20080821013000

1219283100 04944.670 20080821014500

1219284000 04944.694 20080821020000

1219284900 04944.709 20080821021500

1219285800 04944.708 20080821023000

1219286700 04944.700 20080821024500

1219287600 04944.684 20080821030000

1219288500 04944.659 20080821031500

1219289400 04944.625 20080821033000

The irst colu!n is the epochal ti!e 'seconds since !idni#ht 111970(, the second is the

+ater colu!n thic/ness in !eters and the ri#ht colu!n is the hu!an readable ti!e at theti!e o !easure!ent.

11. num(buttons(row: This para!eter sets the nu!ber o buttons per ro+ on the !aindecoder %;5.



12. p!ot(widt# and 1'. p!ot(#eig#t: These para!eters set the di!ensions o the basicTide Tool sea level displays li/e that sho+n belo+ or enoa. 4n e-a!ple value +ould

be H.0i +here 8i stands or inches. i/e+ise, the di!ensions can be speciied as H.0c+here 8c is or c!. The deaults are 7.0i and H.0i respectively.

For C!ients

The clients have 10 re>uired para!eters ho+ever, you should be able to use the clients+ith little !odiication. The only para!eters that you need to coni#ure are the!etadata@ilena!e and Map@Gile@a!e para!eters. The para!eter descriptions are asollo+s?

1. !eft(!on and 2. r#t(!on ? These para!eters represent the lon#itude li!its o the !ap.

'. top(!at and ). bot(!at : These para!eters represent the latitude li!its o the !ap.

. Image(9idt#(,ie!s and 0. Image(;eig#t(,ie!s: The +idth and hei#ht o the!ap in pi-els.

. +ap(Fi!e(<ame : The na!e o the !ap ile. 4s an e-a!ple, or the Paciic client +especiy the !ap ile usin#?

set +ap(Fi!e(<ame /."pacific(ocean(map.gif/

4. metadata(fi!ename ? This is the na!e o the !etadata ile 'ull pathna!e(.

&. c!ient(tit!e : The na!e o the client that appears at the top o the client.

1%. sca!e : The a!ount by +hich the selected area +ill e-pand +hen creatin# a client6oo! +id#et. 4 scale value o t+o see!s to #ive #ood results. 4 scale value #reater thanthree produces so!e+hat u66y !aps. Bou can use non)inte#ers, but then the #enerationo the client 6oo! +id#et !ay ta/e several tens o seconds dependin# on your co!puter.

Bou can certainly #enerate your o+n !ap iles 'in the %5G or!at( and i you chan#e the

above para!eters in the client TclT/ scripts you can create your o+n clients. Gor no+,the clients can only do the linearcylindrical proAection. <o+ever, 5 e-pect to add the!ath needed to do so!e other co!!on proAections li/e the Mercator in the uture.

$#e C*+,(+-$A Fi!e

7



The C$MP@M=T4 ile is a lat ile database containin# a list o all stations decoded byTide Tool. The C$MP@M=T4 ile has 1 colu!ns and the !etadata it contains includesthe #eo#raphic coordinates or each station, and a nu!ber o para!eters that acilitatesthe decodin# o the sea)level !essa#es. Gro! let to ri#ht, the 1 colu!ns are? stationcode, #eo#raphic na!e, plator! 5 nu!ber, "M$ header, sensor type, sa!ple rate or that sensor, nu!ber o sa!ples or that sensor per !essa#e, observation units 'G or .01tand M or !!(, a nu!ber that indicates the nu!ber o non)data ields in the data

payload, ti!e orderin# '1 or chronolo#ical and )1 or reverse chronolo#ical order(, ascale actor, trans!ission ti!e interval, hour?!inute o irst trans!ission o the day,latitude, lon#itude, availability o tide coeicients or tide prediction '1 or available, 0or unavailable(, o+ner o the sea)level station and %$&& 5 'added at the re>uest o %$&&(. 4n e-a!ple is #iven belo+ or the enoa sea)level station pressure sensor.

beno Benoa_ID 22856700 SXXX32 prs 1 30 M 3 -1 1.00 015 0007 -8.7500 115.2166 1 UHSLC 04

4ny line in the !etadata ile that be#ins +ith D3 +ill be i#nored. "hen Tide Tool startsit peror!s a >uality3 chec/ on the !etadata ile and +ill stop i the !etadata ile is notconi#ured properly.

$ne can construct a custo!i6ed !etadata ile usin# Aust the stations o interest. 4ne-a!ple o this is the TideTool@Metadata ile that is also available at the tp site. This!etadata ile is custo!i6ed or the 5ndian $cean. The !etadata can be or#ani6ed intore#ions o your choice by placin# a re#ion na!e li/e &;M4TL4@J4V43 on a line byitsel. The re#ion na!e is your choice, ho+ever, +hite space is not allo+ed, henceunderscores @3 !ust be used instead o blan/ space. The presence o re#ion na!es +ill

cause the !ain %;5 to be se#!ented into dierent re#ions !a/in# it easier to locatestations on the %;5. 4n e-a!ple is #iven in section H.

To be consistent, the sa!e Metadata ile 'para!eter 8!etadata@ilena!e( should be usedin both Tide.tcl and the !ap clients '[email protected], [email protected],[email protected](. This +ill ensure that the Tide.tcl station %;5 'sho+in# decodedstations( and the !ap client 'sho+in# dots or each station +ith color)coded stationhealth( are correctly sho+n and updated.

'. *perationa! Detai!sPlease note that Tide Tool enorces %MT '%reen+ich Mean Ti!e( +hen decodin#.Thereore, you !ust !a/e sure that your syste! #ives the correct %MT ti!e. Thisre>uires that you set the ti!e 6one on your co!puter to 03 oset ro! %MT. o notsi!ply chan#e the cloc/ on your syste!* chan#e the ti!e 6one. Chan#in# the cloc/ +illcause Tide Tool to assu!e that the chan#e o day occurs either too late or too early. The



use o %MT is necessary to re!ove any a!bi#uities +ith respect to ti!e, as %T& dataalso uses %MT. 5 your syste! does not have the correct %MT ti!e, Tide Tools behavior +ill be erratic.

Tide Tool version 7.0 consists o t+o basic parts, the decoder 'created by the Tide.tclscript( +ith the a!iliar !ain %;5 containin# buttons or each sea)level station. The other

part is the dyna!ic !ap client. There are currently three !ap clients* one each or the5ndian $cean, Paciic $cean and the Caribbean. Tide.tcl listens or re>uests on port1KK00. Co!!unication bet+een the decoder and clients is t+o)+ay. The clients anddecoder can send instructions bac/ and orth. The decoder can support any nu!ber o clients, so i you choose, you can run !ultiple instances o the sa!e client, or all threeclients.

"hen Tide.tcl is started it +ill read data ro! the current day data lo#. Tide.tcl +ill /eepup to N hours o data. 4s !ore data arrives beyond +hat Tide.tcl can hold, it +illdiscard the older data to !a/e roo! or the ne+. "e have let so!e active debu# code inTide.tcl, so i you see a lot o output, do not +orry. 5 Tide.tcl ails, please send PT"Cs&tuart "einstein 'stuart.+einsteinOnoaa.#ov( as !uch o the debu# output as you can, upto the last state!ent beore Tide.tcl ailed. 5 possible, send the lo# ile Tide Tool +asreadin# at the ti!e. 4lso send the error@lo# i you have one.

$#e Decoder"hen Tide.tcl is started, the current day lo# ile is read and decoded, a si!ple %;5 +ill

be displayed that has buttons or each tide station in the !etadata ile. 4ter the initial

scan o the current day lo# ile Tide.tcl #oes into the bac/#round. Tide Tool sleeps and+a/es up every 20 seconds to see i any ne+ data has arrived. 5 so, it is decoded. $ncestarted, Tide Tool runs continuously.

The station na!e is listed as a our)letter code. The stations codes are obtained ro! the!etadata ile. The #au#e code is only three letters* prs stands or pressure sensor, bubindicates bubbler, enc indicates encoder, rad indicated radar, etc. More inor!ation on the#au#e types can be ound in 4ppendi- 5V, +hich is e-tracted ro! the PT"C $perations,&yste!s, and Procedures Manual 'Version 1.0, ec 200(.

"ith Version 2.19, there +ere chan#es !ade to the Tide Tool %;5. Prior to 2.19, the %;5+ould not appear until Tide Tool +as inished readin# the lo# ile. o+, the %;5 appearsirst, but in a deactivated !ode +hile the Tide Tool is irst readin# the lo# ile. 4ter theinitial read is done, the %;5 is activated. $n the botto! o the %;5 is a !essa#e +id#etsho+in# ho+ !any bytes have been read ro! the current lo# ile.

9

mailto:[email protected]




ote the letterin# on the station buttons is dar/ violet indicatin#they are active. "hen Tide.tclis irst started, the letterin# onall buttons is #rey 'inactive(e-cept or the =:5T3 button.The station button section is

placed on a scrollable,e-pandable canvas. ependin#on the si6e and resolution o your screen, you !ay or !aynot need to scroll. Le#ion

na!es li/e &;M4TL4@J4V43 are yours to create and are to be placed in the !etadata

ile as described previously

Clic/in# on a button in the %;5 +ill display a !enu sho+in# the #au#es available?

5n this snap shot, the enoa,5ndonesia station +as selectedand the !enu sho+in# three#au#es 'a pressure, radar andencoder #au#e ( plus t+o

other ite!s 5no3 andMess3 are displayed. Those+ill be discussed later. Gour

buttons, =:5T, L=T5=,L=P$LT and ;P4T=&T4T;& appear on the

botto!. 5 you !a/e chan#esto the ile reerred to by the

para!eter ti!e!istfi!e, clic/in#L=T5= +ill retile the screen.

Clic/in# on ;P4T=&T4T;&3 +ill send station

status inor!ation to the clients. Clic/in# L=P$LT3 +ill #enerate a table sho+in# thenu!ber o !essa#es received or each station. The last t+o eatures +ill be described in#reater detail later

10



$#e +onitor and =oom 9idgets&electin# one o the sensors 'or e-a!ple, prs, rad, enc, bub( +ill create a !onitor +id#et. This sho+s the sea)level curve as a unction o ti!e. Clic/in# on the rad'acoustic radar sensor( or the enoa 'beno( station produces a !onitor +id#et or enoastation sensor?

T+o curves are in the display. The #reen curve is the sea)level curve resultin# ro!decodin# the sea)level !essa#es. The +hite curve is the de)tided sea)level curve usin# atide prediction !odel. The tide coeicients +ere co!puted by r. ailin "an# at PT"C.5n so!e cases the available ti!e series or the ne+er stations are too short to allo+ri#orous de)tidin#. <o+ever, the bul/ o the tide si#nal is usually eli!inated. 5n the above

i#ure the T5=3 !enu button has been clic/ed and it sho+s options. The deault is to plot both the observed and corrected tides. $ther options are to sho+ the observed or corrected separately or both +ith the predicted tide. $n the botto! o the display, theti!e o the ne-t e-pected trans!ission 'e-t :MT( or this station is #iven.

Clic/in# the M=;3 button produces a!enu sho+in# other sensors or thisstation?

This +ay, you +ont have to #o to the !ain %;5 to display curves or the other sensors.

11



4nother eature is the =&P5=3 button. Clic/in# the =&P5=3 button +ill run thesea)level curve throu#h a three point !edian ilter. asically, at each point, the value isreplaced +ith the !edian value a!on#st that point and its nearest nei#hbors. This #ets rido solitary bad points. Gor spi/es#litches lastin# !ore than one sa!ple interval, it !aynot eli!inate the spi/e#litch. 5n our e-perience, ho+ever, this si!ple techni>ue has

proven to be eective in the !aAority o cases.

Consider the !areo#ra! obtained at Led o#, 4las/a. Clearly this station is havin# so!esort o sot+are or tele!etry proble!?

Clic/in# the =&P5=3 button results in?

12



4s you can see, this is >uite an i!prove!ent. 4lso note that the =&P5=3 button no+reads ;=&P5=3. Clic/in# this button no+ +ill undo the despi/in#.

4s ne+ data is decoded by Tide.tcl, the !onitor +id#et +ill be auto!atically updated torelect the ne+ data. The +id#et +ill only sho+ up to N2) hours o tide record. 5 ne+data is decoded or a station +hile a display +id#et or that station e-ists, the bac/#roundo that display +id#et +ill chan#e ro! blac/ to blue or 0. seconds 'This is lo+eredro! H seconds in previous Tide Tool versions(.

"hat operations can you doQ y usin# the ri#ht button or nu!ber three button on your !ouse, you can dra+ an e-pandin# rectan#le to 6oo! in on a section o the sea)levelcurve. <old the ri#ht button do+n and !ove the !ouse dia#onally, and you +ill dra+ athin red rectan#le. "hen the section o curve you +ish to e-a!ine is in the rectan#le,release the ri#ht button, and a 6oo! +id#et +ill pop)up +ith the selected portion o ti!eserious e-panded. This +as done in the earlier i#ure sho+in# the !onitor +id#et or enoa. The resultin# 6oo! +id#et in the i#ure belo+?

Bou can also urther 6oo! on the 6oo! +id#et itsel. "hen the ri#ht button is released,the appropriate section o curve +ill be displayed in the 6oo! +id#et. The T5=3 buttonat the top let has the sa!e unction as +ith the display +id#et.

$n the 6oo! +id#et you can conduct si!ple !easure!ents o a!plitude and period.;sin# the let or nu!ber one !ouse button, si!ply clic/ on the curve in the 6oo! +id#et,and a su!!ary inset +ill appear in the top let corner sho+in# the coordinates o the

point you Aust clic/ed on. 4 cross +ill !ar/ the spot you pic/ed. 4ter a second point isclic/ed on, the coordinates o the second point +ill be displayed. 5n addition the

1H



dierence in hei#ht and ti!e bet+een the t+o points +ill be displayed on the su!!aryinset. Ti!e dierence is in !inutes?seconds, and hei#ht dierences are in !eters.

4 su!!ary inset can be seen on the enoa 6oo! +id#et sho+n above. ote the t+ocrosshairs. 5 you +ish to clear the su!!ary display, clic/ the !iddle or nu!ber t+o!ouse button any +here on the 6oo! +id#et canvas.

The record button L=C3 +ill allo+ youto record sea)level observations in theile reerenced by the record(fi!ename

para!eter.

y clic/in# the point +here tsuna!i +aves irst arrive and then clic/in# the Girst4rrival3 !enu ite!, you can record the arrival o the tsuna!i at a sea)level station. yusin# t+o pic/s you can record either the Rero to Pea/3 or Pea/ to Pea/3 variation onthe sea)level curve. =ntries in the record(fi!ename3 ile are in this or!?

>ota prs First Arri3a! 111"% %4:)' 2%%111 11:)4>ota prs ,ea> to ,ea> 111"% %4:)' ; %%.2%4 111"% %&:%4 ; %%.1 ,er %%:2) Amp %%.%2 2%%111 11:)4

The observation records start +ith the station and #au#e ollo+ed by the type o !easure!ent and then the !easure!ent's(. 5n the case o Girst 4rrival3, +e have the day

ti!e sta!p o the arrival in the or!at JJJBB <<?MM ollo+ed by the ti!e thisobservation +as recorded in or!at BBBBJJJ <<?MM. 5n the Pea/ to Pea/3 or Rero toPea/3 cases, both pic/s are recorded +ith a ti!e sta!p JJJBB <<?MM ollo+ed by <3'sea)level hei#ht la#( ollo+ed by the sea)level in !eters. 4ter the pic/s +e have theti!e dierence 'ater the Per3 la#( and sea)level dierence 'ater the 4!p3 la#(

bet+een the t+o pic/s ollo+ed by the ti!e the observation +as recorded. The 5no3 and Mess3 ite!s allo+ youto display basic station data and recent!essa#es or a #iven station. This is ane-a!ple o an inor!ation +id#et. 5tsho+s basic inor!ation about the sea)level station.

1



Clic/in# on the Mess3 ite! +ill create a +id#et that sho+s the last 100 !essa#es or thestation that +ere reco#ni6able to Tide Tool. 4n e-a!ple o the !essa#es +id#et is sho+n

belo+?

ote that this +id#et is scrollable and has a print button. <o+ever, as dierent syste!sutili6e dierent co!!ands or printin# te-t, the print button re>uires so!e coni#uration

by the user. 5n particular the ,RI<$-R(C*++A<D variable !ust be set to a strin#

that is the printer co!!and. 5 this variable is not set, the PL5T3 button +ill notappear. 5t !ay re>uire !ore +or/ in the uture to!a/e this option a bit !ore user)riendly. 5 youcannot #et it to +or/, contact &tuart "einstein and+e +ill try to develop a custo!i6ed solution.

Clic/in# the L=P$LT3 button on the !ain %;5

+ill #ive an account o the nu!ber o !essa#esreceived and the nu!ber o !essa#es e-pected or each station in the !etadata ile over a speciiedti!e period. Bou can select H, , 12 or up to hours. Bou can also print the report. The report isappro-i!ate in ter!s o the nu!ber o !essa#ese-pected, ho+ever it is accurate enou#h so that

1K



you can /eep trac/ o stations that are havin# tele!etry proble!s or other issues. otethat receipt o a !essa#e as indicated on the report does not !ean the !essa#e +assuccessully decoded* only that it +as received.

4nother eature included is the M4P3eature. Clic/in# on the M4P button +illdisplay a !ap '%5G ile i!ported into a t/ +id#et( sho+in# the #eo#raphic conte-t o the stations. There are three vie+s sho+in#the station at enoa in a #lobal, re#ionaland local conte-t. The location o the stationis centered on the !ap. Contour linessho+in# tsuna!i travel ti!es at one)!inuteintervals are dra+n usin# the station is thestartin# point. These !aps are useul +henit co!es to assessin# ho+ the station !ay

be i!pacted by a tsuna!i. Gor e-a!ple i the station is relatively sheltered or is acin#a+ay ro! the li/ely direction o tsuna!i

propa#ation, it !ay not be ideal or useulor evaluatin# the destructiveness o thetsuna!i.

$ide $oo! C!ients

Tide Tool has three basic clients, one each or the 5ndian $cean, Paciic $cean andCaribbean &ea. These clients, sho+n belo+, are interactive !ap interaces.

1



5ndian $cean Client Caribbean Client

Paciic $cean Client

5n each interace display +indo+, the s!all dots sho+ the location o coastal sea)levelstations and the lar#er dots sho+ the position o the 4LT buoys. The colors o the dotsindicate status3 and the !eanin# o the colors is #iven by the le#end Aust belo+ the !ap.

%reen indicates that at least one !essa#e +as decoded or that station +ithin the last 7hours. Bello+ indicates that at least one !essa#e +as decoded +ithin the last 2 hours,and Led indicates no !essa#es received in over 2 hours. The reason these criteria +erechosen is that the 4LT buoys in their nor!al !ode 'as opposed to their tri##er !ode(only trans!it data ti!es a day.

17



&tation status can be updated at any ti!e by clic/in# the &T4T;&3 button on thedecoder 'Tide.tcl( %;5. These clients do not re>uire any special coni#uration. Place theclient scripts in the sa!e older as the decoder and start the! runnin# the sa!e +ay asthe decoder. i/e the decoder, clients e-pect the !etadata ile to be in the sa!e older."hen the clients connect, the !essa#e C$=CT=3 +ill appear on the botto! let o the client %;5 as sho+n above. 5 the decoder is not runnin# or the clients have notconnected yet, the !essa#e +ill be $T C$=CT=3. 5 the decoder is shut do+nater the clients connected the !essa#e +ill be 5&C$=CT=. ote that ater thedecoder 'Tide.tcl( is started, it +ill not accept clients until the initial read o the currentlo# ile is co!pleted.

4 sin#le let button clic/ on a dot +ill display the station code or that station. 4 doublelet button clic/ +ill create a !enu button, Aust li/e the one on the decoder %;5, and youcan choose to display a sensor. The =-it selection +ill delete the button. $nly one button at a ti!e +ill appear, so i youre>uest another button, any pre)e-istin# button +ill be deleted. Bou +ill notice that so!estations have a yello+ halo* this is to inor! you that the station has been !oved,#raphically, ro! its actual location so that it can be located and clic/ed on the !ap."hen you use the 6oo! eature, !ost o these halos +ill disappear as there is !oreresolution and less overlap a!on# the station dots.

The 5&PG5 &T4T5$&3 !enu button on the botto! can be used to ind stations onthe !ap. Clic/in# this button produces the !enu?

The irst t+o ite!s i chec/ed +ill cause the station codes andor 4LT C nu!bersto be displayed on the !ap. The G53 ite!s are cascadin# !enus that allo+ you tolocate a station by its station code or 4LT C nu!ber?

1



To 6oo! in a section o the Client !ap, use the ri#ht !ouse button. Clic/ and traversero! one corner o the re#ion you +ish to enlar#e, to the opposite corner and release the

button. This +ill create a 6oo!3 client

The 6oo! client has the sa!e unctionality asabove. 5t also has =:5T3 and T5=3 buttonson the botto!. Clic/in# =:5T3 +ill destroythe 6oo! +id#et.

Clic/in# T5=3 +ill tile the screen +ithall stations that have data, present in the6oo! re#ion. The T5=3 button +illthen s+itch to ;T5=3. Clic/in#;T5=3 +ill re!ove the tiled +id#ets.

19



Currently, you can only have one 6oo! +id#et per client. 5 a ne+ 6oo! +id#et iscreated, the old one +ill disappear. 5 you clic/ T5=3 on the ne+ 6oo! +id#et, the oldtilin# +ill be destroyed and a ne+ tilin# usin# stations in the current 6oo! +ill becreated. 5 you +ish to tile usin# stations ro! t+o separate re#ions, you +ill need tocreate another instance o the client, and create a 6oo! +id#et ro! each client.

). Future Directions

4!on# the ne+ eatures under consideration or uture releases o Tide Tool are ?

1. The use o environ!ent variables in the scripts. This +ay, no !odiication +ill benecessary i you deine the environ!ent variables on your syste!. Tide.tcl +ill >ueryenviron!ent variables to obtain the para!eter values.

2. &trip Chart "id#et. 5n addition to tilin# the screen +ith selected stations, the user +illalso be #iven the option to have those stations arran#ed in a strip chart +id#et. This is+hat is typically done in displays o seis!ic data.

H. Leal Ti!e tide !odelin#. 5n so!e cases, not enou#h data is available to create a #oodset o tide har!onic coeicients. 5n other cases the tide coeicients are no lon#er ade>uate or !eteorolo#ical eects are s/e+in# the de)tidin#. 5n these cases, it is useul toco!pute tide coeicients on the ly3 usin# the hours o data held by Tide Tool.

. yna!ic reconi#uration. Chan#in# station !etadata or addin# ne+ stations +ill notre>uire a restart o Tide Tool.

get$ide

The #etTide pro#ra! has all o the above eatures '+ith the e-ception o the auto)tilin#eature(, but is desi#ned to read old lo#iles. There is one i!portant caveat to be a+are o

in usin# #etTide. Bou !ust to be sure that the !etadata used by #etTide is consistent +iththe date o the lo#ile you +ish to e-a!ine. &ensors and data units do chan#e throu#hti!e. This is another i!portant reason to consider Aoinin# the !etadata +eb service eortdescribed earlier. &uch a service +ill create a !etadata ile consistent +ith any ti!era!e and release you ro! havin# to /eep trac/ o !etadata chan#es yoursel. The useo #etTide is very si!ple. ;pon startin# #etTide a si!ple entry +id#et +ill appear?

20



This +id#et re>uires three entries, Julian day, Bear and &P4 +hich is the nu!ber o days o data you +ish to read startin# at the Julian day and year entered. 4ter clic/in#the $=3 button, this +id#et disappears and the Tide Tool %;5 then appears. 4ter this, everythin# is basically the sa!e as Tide Tool.

4uthor?r. &tuart "einstein4sst irector, Lichard <. <a#e!eyer Paciic Tsuna!i "arnin# Center

Please send all >uestions, bu#s, re>uests etc. to?stuart.+einsteinOnoaa.#ov

Gor other related >uestions or assistance, please contact r. aura on#, irector, 5$C5nternational Tsuna!i 5nor!ation Centre, l./on#Ounesco.or#

Ac>now!edgments

&. "einstein is indebted to several collea#ues or their help and ideas in creatin# andi!provin# Tide Tool. The #enesis o Tide Tool +as a re>uest ro! r. aura on# in late

200K to develop a >uic/ and dirty3 tool that can be used to decipher %T& sea)level data,display the results and allo+ basic !easure!ents o a!plitude and period to be !adero! the sea)level record. Tide Tool 1.0 +as released in ov. 200K. The earliest users'and perhaps victi!s3( o Tide Tool +ere the Met. $ice in Malaysia and M% in5ndonesia. Tide Tool has proven so capable that it is no+ part o the operational sot+aresuite at PT"C.

5n Malaysia, a!ran <ussein provided valuable assistance in debu##in# Tide Tool. r.Bap o/ &en#, o+ on# Chie+, and &a+ un ion# also provided su##estions andtested Tide Tool on "indo+s plator!s.

r. Gau6i 'M%( provided the irst detailed set o instructions or obtainin# everythin#needed to #et Tide Tool runnin# on 5;:. 5ndra %una+an +as also very helpul introuble shootin# proble!s +ith Tide Tool.

21







r. Boh/o 5#arashi 'JM45T5C( provided valuable assistance in i!provin# the port o Tide Tool to both 5;: and "indo+s and developin# the scriptsprocesses used toobtain %T& data ro! the "eb.

r. ailin "an# 'PT"C( created and !aintains the suite o tide coeicients used in de)tidin# and is currently helpin# !e to develop an on the ly3 de)tidin# al#orith! in Tcl.

r. athan ec/er 'PT"C( desi#ned and created the station !aps and the !aps or theTide Tool clients.

Peter Pissierssens '5$=( oered several valuable su##estions durin# !y visit to 5$=in 200. Mar/ Van Cro!bru##e '5$=( helped #et Tide Tool runnin# on "indo+s.

ast but not least, 5 than/ Chip McCreery and the PT"C sta or puttin# up +ith !y!ood s+in#s +hile +or/in# on Tide Tool.

22



Appendi I.

Leadin# Materials?

Practical Pro#ra!!in# in Tcl and T by rent "elch. Prentice <all.4 super boo/ and introduction to TclT/. Bou can ind it in !any boo/stores or obtain itro! an online source.

=ective TclT/ Pro#ra!!in# by <arrison and McennanThis covers unda!entals o event driven pro#ra!!in#. Gor those o you +ho do !ostlyserial pro#ra!!in# in Gortran or C, event driven pro#ra!!in# is a bit a o a trip.

Tcl and the T/ Tool/it by John $usterhout$usterhout invented TclT/. &o 5 eel obli#ed to !ention his boo/.

"ebsites?

http?+++.activestate.co!Products4ctiveTclBou can #et binaries here. This site has so!ethin# or everyone.

http?tcl.sourceor#e.net http?sourceor#e.netproAectsbltBou can #et binaries here and /eep tabs on the latest G4Ss, versions, bu#s, and advances

in the Tcl +orld.

http?phaseit.netclairdco!p.lan#.tcl<o+ToC.ht!l<o+to, on ho+ to inte#rate the po+er o C pro#ra!!in# +ith TclT/. 5 use co!binationsli/e this at PT"C. Ca!eron is one o the #reat TclT/ e-perts and re>uently ans+ersTclT/ >uestions on the co!p.lan#.tcl %oo#le ne+s #roup. Bou !ay ind !e there onoccasions as +ell.

http?+i/i.tcl.t/1994 startin# point or T

2H

http://www.activestate.com/Products/ActiveTcl/

http://tcl.sourceforge.net/

http://sourceforge.net/projects/blt/

http://phaseit.net/claird/comp.lang.tcl/HowToC.html

http://wiki.tcl.tk/199

http://www.activestate.com/Products/ActiveTcl/

http://tcl.sourceforge.net/

http://sourceforge.net/projects/blt/

http://phaseit.net/claird/comp.lang.tcl/HowToC.html

http://wiki.tcl.tk/199



Appendi II.$ide $oo! using Internet Data Down!oad

9indows ?,

Developed and maintained by the Pacific Tsunami Warning Center Windows internet version by International Tsunami Information Center

Distributed by International Tsunami Information Center

For more information, contactStuart Weinstein stuart!weinstein"noaa!gov # or $aura %ong l!&ong"unesco!org #

'ersion (pril )**+

$ide $oo! is an operational tool developed and supported by the Pacific Tsunami Warning Center for thedecode, display, and manipulation of sea level data transmitted over the W- .lobal TelecommunicationsSystem .TS#! The tool continuously decodes sea level in real/time and displays the time series on a

computer screen0 users are able to interactively manipulate the time series to measure wave amplitude and period, and to remove the tidal signal! 1on/operational versions also e2ist for data transmissions throughthe internet ftp# and for archived data!

Instructions for the installation and running of Tide Tool on a PC under a Windows 3P operating systemand with data collection through the internet ftp are provided below! 4se of Windows 'ista is alsoavailable! Installation is similar, e2cept for differences in how to Schedule Tas&s!

Instruction for $ide $oo! @9indows 3ersion

%. 5 you already have an old version o Tide Tool, delete the iles.

1. 5 needed, e-tract iles ro! Tide@Tool@tp@+indo+s.6ip on the des/top. Then, a older na!ed Tide@Tool@tp@+indo+s3 +ill be created on the des/top.2. Place the older Tcl3 and the our iles chi/an.e-e3, #a+/.e-e3, %[email protected] and !ini!i6e.bat3 under C?I. The structure is as ollo+s.

2







My Co!puter ))) C?I ))))))) Tcl ))))))))))))))))) bin ))))))))) Tide.tcl

[email protected] [email protected] [email protected] paciic@ocean@!ap.#i indian@ocean@!ap.#i caribbean@!ap.#i C$MP@M=T4 TideTool@Metaata

TideTool@Metaata@5$ TideTool@Metaata@P$

TideTool@Metaata@=P$ TideTool@Metaata@"P$ TideTool@Metaata@&=P$ TideTool@Metaata@&"P$

TideTool@Metaata@"4$@C4L TclT/ T iles

Tile@ist )))))))) stations list to display'sa!ple(

))) !ini!i6e.bat ))TideTool )))))) Tide@Coes )))) coeicient iles or & stations ))) %[email protected] )) doc ))) ecoded@ata )) decoded data +ill be archived ))) #a+/.e-e )) include ))) &L@$% ))))))) srJJJBB.lo# iles +ill be archived ))) chi/an.e-e )) lib )))) so!e sa!ples )) licenses ))) M4P& ))))))))))) !aps or stations )) 'other iles( ))) =rror )))))))))))))=rror@$% iles +ill be archived ))) $: )))))))))))))data ro! tpsite +ill be archived ))) past@!etadata )) past !etadata or #etTide.tcl

))) &!ap)4$5$P$ )))))) station !aps))) Tide Tool 7.0 Manual.doc

))) 5nstruction@or@TideTool@"indo+s.pd

))) L=4M=

'. &et your PC to use ;TC.

). &et Tas/ &cheduler to run !i!ini6e.bat every !inutes, !ini!i6e,bat calls #[email protected] +hich is thescript that does the 8tp to #et the data ro! the $44 ational "eather &ervice Teleco!!unications#ate+ay.

2K

#a+/.e-e is used to e-tract a certain colu!n in a ile? here, to e-tract a colu!n o data ile na!e

in a ile o data list.chi/an.e-e chan#es return code ro! ;ni- 'In( to M&)$& 'IrIn(.



To schedule a tas/,$pen Control Panel3 Peror!ance and Maintenance3 &cheduled Tas/s3

4dd &cheduled Tas/3

Clic/ e-t3 on the irst pa#e, clic/ ro+se3 on the ne-t pa#e.

Choose C?I!ini!i6e.bat. The ollo+in# +indo+ appears, so choose aily3 and clic/ e-t3.

&et &tart ti!e 12?00 4M and choose =very ay3.

2

%[email protected] creates srJJJBB.lo# ile and!ini!i6e.bat runs %[email protected] +ith a!ini!i6ed +indo+.

"hen you set %[email protected] in tas/ scheduler torun, a +indo+ pops up every ti!e so it +ill be better to set !ini!i6e.bat.



=nter the user na!e and pass+ord and clic/ e-t3.

=G$L= Clic/in# Ginish, chec/ in the bo-, then,clic/ Ginish3.

The ollo+in# +indo+ opens, so open &chedule3 tab andclic/ 4dvanced3.

27



Chec/ the bo- o Lepeat tas/3 and set the interval !inutes.Choose Ti!e3 and set till +hen to run* to #et tp datacontinuously, it should be 11?K9 PM3.

Then, C?I%[email protected] runs in every !inutes andcreate srJJJBB.lo#.

5n this case, it +ill be conusin# i the process lasts !ore than !inutes but the ne+ tas/ be#ins beore the previous 'current(one inishes, so open &ettin#s3 tab and set as ollo+s*

K. =dit Tide.tcl to speciy dierent ilena!es or i needed, directory paths than currently speciied.&o!e variables that you !ay +ant to chan#e are?

a. 8!etadata@ilena!e variable, i you +ant only a subset o the data to be decoded and displayed. Pre)selected iles available are?

C$MP@M=T4 'deault( +ill decode all stations TideTool@Metaata@5$ is or 5ndian $cean

TideTool@Metaata@=P$ is or ortheast Paciic $cean TideTool@Metaata@"P$ is or orth+est Paciic $cean TideTool@Metaata@&=P$ is or &outheast Paciic $cean TideTool@Metaata@&"P$ is or &outh+est Paciic $cean TideTool@Metaata@"4$@C4L is or orth+est 4tlantic $cean,

Caribbean, %ul o Me-ico TideTool@Metaata is to speciy user)selected stations to decodedisplay.

2



b. 8tilelistile, +hich speciies +hich sea level station !onitors to brin# up at Tide.tcl startup. 4ne-a!ple Tile@ist is provided. Bou can set it not to brin# up any !onitors at startup by leavin# this ileunspeciied. Gor e-a!ple, i you need to !onitor the H stations yapi3, !ani3 and davo3 or prssensor, then Tile@ist +ould loo/ li/e

!ap" prs #an" prs $a%o prs

&'(er )"$e.(*+ "s r,nn"n !o, *an e$" (/e '"+e )"+e_L"s( (o $es"na(e o(/ers(a("ons an$ (/en /"( (/e b,((on )IL (o s/o (/ese s(a("on #on"(ors.

c. 8printer@co!!and, +hich speciies the co!!and or printin#. Presently, the deault is set or alinu-uni- co!!and.

0. Lun Tide.tcl 1. ouble clic/ on the C?ITclIbinIblt+ish.e-e 'or C?ITclIbinIblt+ish2.e-e( Then, a console appears.

2. 5n the console, type as ollo+s 'e-a!ple is or 5ndian $cean(* U blt+ish Tide.tcl

Tide.tcl reads and decodes the e-istin# data in the current days &L$% ile, and then reads Tile@istand auto!atically displays s!all sa!e)si6ed +indo+s or each station data. ote that at the be#innin#,+hen srJJJBB.lo# is s!all andor little station data are obtained, only a s!all nu!ber o s!all +indo+s+ill be displayed. 5 you rerun the Tide.tcl later on the irst day o your usa#e, it +ill display !orestation data since srJJJBB.lo# is lar#er.

H. "hen you need a !ap 'Paciic $cean !ap in the ollo+in# e-a!ple(, type in the ne-t line U blt+ish [email protected]

5t opens a !ap o Paciic $cean +ith stations. "hen you need a !ap o 5ndian $cean orCaribbean, type [email protected] or [email protected] instead o [email protected]. More than 1 !ap client can be run at the sa!e ti!e. ote that Tide.tcl !ust al+ays be runnin# since the !aps

are only clients o Tide.tcl.

S;*R$ CB$:4n easy +ay to start Tide.tcl and the Map clients +ithout havin# to open a console to type the co!!andis to si!ply drop the script onto a blt+ish.e-e icon. To do this, create a short cut 'alias( o blt+ish.e-eand place it as an icon on the des/top. To run Tide.tcl and the !ap clients, hi#hli#ht the tcl script and!ovedrop it onto the blt+ish.e-e icon to start the script.

D Gor #etTide.tcl, double clic/ C?ITclIbinIblt+ish.e-e 'or C?ITclIbinIblt+ish2.e-e( and type

U blt+ish #etTide.tcl t!p t!p is a lo# ile to see +hat has happened in case o error. 5t us useul because +e need to useolder)or!at !etadata iles or older data. Bou can use +hatever ilena!e you +ant. &ee the TideTool Manual or !ore inor!ation.

'$T=? TideTool v7.0, +hich has !any ne+ eatures, does not have an acco!panyin# #etTide.tclscript. This is planned in the near uture(.

29



. 5MP$LT4T $T=? ependin# on your !achine, you !ay need to edit the #[email protected] script inorder to have the correct your date speciication in order to create the correct lo# ile na!e'srJJJBB.lo#( or Tide.tcl To chec/, open Co!!and Pro!pt and Type date 66

"hen your !achine sho+s !!ddyyyy as ollo+s, you do not to edit %[email protected]

"hen your !achine sho+s yyyy!!dd or !!ddyy ay, you need to edit.

W%[email protected] Bou need to +rite the nu!bers as sho+n belo+ in red.

L=M ))) count Julian date or srJJJBB.lo# ile ))) set yyyyXUdate?N)U

set yyXUdate?N)2Uset !!XUdate?N)10,2Uset ddXUdate?N)7,2U

Gor the case o 072200 Thu,N),U !eans letters ro! the th letter ro! the bac/, so 200 is selected or yyyy 'year(.N),2U !eans 2 letters ro! the th letter ro! the bac/, so 0 is selected or yy 'year +ith 2 letters(.

N)1,2U !eans 2 letters ro! the 1th letter ro! the bac/, so 07 is selected or !! '!onth(.N)11,2U !eans 2 letters ro! the 11th letter ro! the bac/, so 2 is selected or dd 'day(.

Gor the case o 200072,N0,U !eans letters ro! the be#innin# '1st letter(, so 200 is selected or yyyy 'year(.N2,2U !eans 2 letters ro! the Hrd letter, so 0 is selected or yy 'year +ith 2 letters(.NK,2U !eans 2 letters ro! the th letter, so 07 is selected or !! '!onth(.

N,2U !eans 2 letters ro! the 9th

letter, so 2 is selected or dd 'day(.Gor the case o Thu 072200,N)U !eans letters ro! the bac/, so 200 is selected or yyyy.N)2U !eans 2 letters ro! the bac/, so 0 is selected or yy.N)10,2U !eans 2 letters ro! the 10th letter ro! the bac/, so 07 is selected or !!* sa!e as N0,2U.N)7,2U !eans 2 letters ro! the 7th letter ro! the bac/, so 2 is selected or dd* sa!e as NH,2U.

5 your !achine sho+s a dierent or!at, such as, dd!!yyyy, you need to re+rite in the sa!e +ay.

H0



Appendi III.$ide $oo! using Internet Data Down!oad

inu " Bni

Developed and maintained by the Pacific Tsunami Warning Center Distributed by International Tsunami Information Center

For more information, contactStuart Weinstein stuart!weinstein"noaa!gov # or $aura %ong l!&ong"unesco!org #

'ersion arch )**+

$ide $oo! is an operational tool developed and supported by the Pacific Tsunami Warning Center for thedecode, display, and manipulation of sea level data transmitted over the W- .lobal TelecommunicationsSystem .TS#! The tool continuously decodes sea level in real/time and displays the time series on a

computer screen0 users are able to interactively manipulate the time series to measure wave amplitude and period, and to remove the tidal signal! 1on/operational versions also e2ist for data transmissions throughthe internet ftp# and for archived data!

Instructions for the installation and running of Tide Tool on a PC under a $inu2 operating system and withdata collection through the internet ftp are provided below!

Instruction for $ide $oo! @inu 3ersion

1. Put [email protected].#6 on the es/top and e-tract the iles* #un6ip [email protected].#6

tar -v [email protected]

Chec/ i ) directory na!ed Tide@Tool3 is created on the es/top ) directories na!ed ecoded@ata3, M4P&3, past@!etadata3, &L@$%3, Tide@Coes3 and

V7.03 are under Tide@Tool3 ) iles na!ed Tide Tool 7.0 Manual.doc3 and &!ap)4$5$P$.Ap#3 are under Tide@Tool3

Create a directory na!ed $:3 on the es/top.2. Chec/ i the ollo+in# iles are in V7.03* )) C$MP@M=T4 )) TideTool@Metaata, TideTool@Metaata@5$P$=P$"P$&=P$&"P$"4$@C4L

)) ;L@G5= )) Tile@ist 'sa!ple( )) %[email protected] YYYYY. script to #et the lo#ile srJJJBB.lo#3, +hich is re>uired to run Tide.tcl sr2H0.lo#3 and so!e past lo# iles are in &L@$%3 or reerence )) Tide.tcl YYYYYYY script to !onitor the sea level data 'near real)ti!e( )) #etTide.tcl YYYYYYscript to sho+ the past sea level data )) [email protected], [email protected], [email protected] YY scripts to display a !ap )) paciic@ocean@!ap.#i, indian@ocean@!ap.#i, caribbean@!ap.#iY..!aps or each ocean

H1







'. 5nstall TclT/ T and set the path. o+nload sot+are o TclT/ '..1 or upper, lo+er than .K( and T and install on your !achine.

http?+++.tcl.t/sot+aretclt/ or TclT/ http?sourceor#e.netproAectsho+iles.phpQ#roup@idX11 or T

<o+ to install is !entioned in the instruction o each source, so please ollo+ the instruction.

<o+ to set the path 'co!!ands, ilena!es, ile locations, etc.( depends on your !achine. <ere is an e-a!ple* +hereis tclsh. Y.Gind the location o tclsh. +hereis +ish. Y.Gind the location o +ish. +hereis blt+ish Y.Gind the location o T vi .bash@proieYY$pen the settin# ile to edit.

Gile na!e !i#ht be dierent i yours is not usin# bash but tcsh and so on. "ith the co!!and ls Zal3, you can search +hich ile is or the settin#.

4dd the path or tclsh., +ish. and T in the settin# ile.

Gor e-a!ple, +hen all o the three are in usrlocalbin, add the ollo+in# lines* P4T<X[P4T<?usrlocalbin =-port P4T<

). Le+rite the scripts* red indicates the parts +hich '!ay( need to be chan#ed dependin# on the !achine, and

blue indicates +here you need to chan#e +hen PT"C distributes ne+er scripts and you install it.

<< Get_data.sh >>

b"ns/ -

9$a!:;b"n$a(e <=9;!ear:;b"n$a(e <=!;pa(/:>?Des@(op)"$e_)oo+> ......set the path to the directory“Tide_Tool”.

'"+ena#e:>Apa(/S_LsrA9$a!A!ear.+o>

*$ Apa(/,srb"ne( - -E -" Apa(/F7.0UL_GIL ...... set the path to wget depending on yourmachine.

'"+e:;a@ pr"n( AJ +s-+( K /ea$ -1;e*/o '(p('(p.ns.noaa.o%SL.,s008001DG.anDC.s'#arDS.("$eA'"+e UL_GIL2

,srb"ne( - -E -" Apa(/UL_GIL2..

=dit Tide.tcl to speciy dierent ilena!es or directory paths than currently speciic.&o!e variables that you !ay +ant to chan#e are?

H2

http://www.tcl.tk/software/tcltk/

http://sourceforge.net/project/showfiles.php?group_id=18616

http://www.tcl.tk/software/tcltk/

http://sourceforge.net/project/showfiles.php?group_id=18616



a. 8!etadata@ilena!e variable, i you !ay +ant only a subset o the data to be decoded and displayed,&o!e iles available are?

C$MP@M=T4 'deault( +ill decode all stations TideTool@Metaata@5$ is or 5ndian $cean TideTool@Metaata@=P$ is or ortheast Paciic $cean TideTool@Metaata@"P$ is or orth+est Paciic $cean TideTool@Metaata@&=P$ is or &outheast Paciic $cean TideTool@Metaata@&"P$ is or &outh+est Paciic $cean TideTool@Metaata@"4$@C4L is or orth+est 4tlantic $cean,

Caribbean, %ul o Me-ico TideTool@Metaata to select user)selected stations

b. 8tilelistile, +hich speciies +hich sea level station !onitors to brin# up on Tide.tcl startup. 4ne-a!ple Tile@ist is provided. Presently, the deault is not to brin# up any !onitors at startup. Gore-a!ple, i you need to !onitor the H stations yapi3, !ani3 and davo3 or prs sensor, then Tile@ist+ould loo/ li/e

!ap" prs

#an" prs $a%o prs

c. 8printer@co!!and, +hich speciies the co!!and or printin#. Presently, the deault is set or alinu-uni- co!!and.

. &et your !achine to use ;TC Tide.tcl +or/s ollo+in# ;TC so set your !achine to use ;TC, or your !achine +ill not create a

ne+ srJJJBB.lo# +hen the ;TC date chan#ed and sho+s errors.

0. &et crontab <ere, set %[email protected] to run every e+ !inutes 'e-a!ple* every !in(. crontab Ze Then, your crontab ile opens, so add the ollo+in# line and save it* 0,,,12,1,20,2,2,H2,H,0,,,K2,K \ \ \ \ sh ho!e'userna!e(es/[email protected]%[email protected]

. Lun the scripts Type as ollo+s under es/[email protected], and Tide.tcl starts.

usrlocalbinblt+ish .Tide.tcl 'i youve set the path, Aust type .Tide.tcl ( "hen you need a !ap o Paciic $cean, type usrlocalbinblt+ish [email protected] Bou can add !ore !aps i you need, Aust by addin# lines in the sa!e +ay.

Tide.tcl reads srJJJBB.lo#, +hich %et @ data.sh creates. "ait or crontab to run %[email protected] once 1st.Tide.tcl reads Tile@ist and auto!atically displays s!all data +indo+s or each station

ote that at the be#innin#, srJJJBB.lo# is s!all and not all the station data are obtained,so only a li!ited nu!ber o s!all +indo+s +ill be displayed.5 you rerun the Tide.tcl later on the irst day o your usa#e, it +ill display !ore stations

since srJJJBB.lo# is lar#er. Then, you can /eep those +indo+s orever and need not rerun a#ain.

"hen you run #etTide.tcl, type

HH



usrlocalbinblt+ish .#etTide.tcl 'i you have set the path, Aust type .#etTide.tcl( Then, put the day, year and span in a s!all +indo+. D 4s !entioned above, use ;TC to count days.

H

Des>top $ide($oo! .% Tide.tcl [email protected] Paciic5ndianCaribbean@!ap.#i

%[email protected] #etTide.tcl ;L@G5= TideTool@Metaata

7*? TideTool@Metaata@5$P$=PP"P$&=P$&"P$"4$@C4 C$MP@M=T4 Tile@ist =rror@$% 'to be created( =rror@$%@past 'to be created(

$ide(Coeffs )) coeicient iles or the sea level stations

Decoded(Data )) decoded data are archived in this directory

SR(* )) srJJJBB.lo# iles are archived in this directory +A,S )) !aps or each station

past(metadata 66 past C$MP@M=T4 TideTool@Metaata

Tide Tool 7.0 Manual.doc

&!ap@4$5$P$.Ap#

Tide@Tool@$% 'to be created(

Tile@Tool@$%@past 'to be created(

DirectoryDirectoryStructureStructure



A,,-<DI? I

S-A6-- AB- I<S$RB+-<$A$I*<

52tracted from

PTWC -P56(TI-1S, S7ST5S (1D P6-C5D465S (14($, 5dition 8!*, December )**9

C;A,$-R 0. S-A6-- DA$A ,R*C-SSI<C. S-A6-- AB- I<S$RB+-<$A$I*<

a. Coasta! auges

The sea)level net+or/s o the +orlds oceans utili6e a co!bination o $44%$=&, JM4%M& or=;L$&4T satellite trans!ission co!!unications. These data arrive at PT"C via the =&5&"&co!!unications routin# throu#h the "&T% onto line K. The sea)level data is collected andtrans!itted ro! the sea)level station usin# a ata Collection Plator!, 'CP( that are procured ro!various !anuacturers. The CPs provide a suite o pro#ra!!able para!eters or data '+ater)level(

!onitorin# and data trans!ission via satellite. $ther !eteorolo#ical sensors can also be utili6ed inconAunction +ith these syste!s. The +ater)level data is sa!pled at a 2 second rate avera#ed over a 2!inute period and trans!itted via %$=& or %M& on an hourly basis to PT"C. <o+ever, $& ';& $44 ational $cean &ervice( is up#radin# sea)level stations to trans!it one)!inute sa!ples every !inutes. 4lready a nu!ber o $& stations in <a+aii and 4las/a re#ion have been up#raded to thehi#her trans!ission rate. &upported by the 5$C +ith unds ro! $44, the ;<&C is up#radin# the%$&& stations in the 5ndian $cean. The up#raded #au#es in the 5ndian $cean trans!it every 12 or 1K!inutes, +ith 12 to H0 one)!inute sa!ples or the sensors +ith the hi#hest sa!plin# rate.

=ach sea level site !ay use one or !ore o types o sensors?

• &P& Z '&ub!ersible Pressure &ensor( !easures +ater)level sea pressure ro! 0 Z K eet. ac/up

pressure sensor code is &P.

• PL1,PL2 Z Pressure sensors.

• ; ) 'ubbler Pressure &ensor( !easures +ater)level sea pressure, ro! 0 Z K eet 'utili6in# a

nitro#en #as pur#in# syste!( in a cavity sub!er#ed in the +ater. 4s sea)level chan#es, the pressurein the nitro#en #as cavity chan#es. ac/up bubbler code is .

• =C Z '5ncre!ental =ncoder &ensor( !easures +ater chan#es developed in a stillin# +ell syste!,

incre!entally chan#in# a pulley usin# a loat and +ei#ht. 4s sea)level chan#es a loat !oves up anddo+n. The operation is si!ilar to the loat in your toilet. ac/up encoder code is =.

• P4S Z 'Pri!ary 4>uatra/( !easures sea)level +ith acoustics. The trans!itter and receiver are above

the +ater. &ea)level is deter!ined by the round trip ti!e or the acoustic si#nal. ac/up a>uatra/ code is 4S. P4S desi#nation is used or TG #au#es.

• P" Z This is the desi#nation or $& a>uatra/s. " is the bac/up $& sea)level #au#e

desi#nation, usually a Paros pressure sensor.

• L4 Z 'Ladar( !easures sea)level usin# radar. The L4 sensor is placed above the sea)level and

bounces radar si#nals o the sea)surace. Ti!in# the round trip ti!e yields the sea)level.

HK



The sea)level stations syste!s are #enerally located in ports or bay areas in secure areas +ith acilities.<o+ever, they can be located in re!ote locations on !ost any shoreline +here there is a suitable areaor anchorin# the sensor and the =lectronic &yste!s are sae ro! the ele!ents. The photos belo+'courtesy Lichard y#ard( sho+ the basic ele!ents o the 5nstallation at <iva $a, Mar>uesas. The <iva$a station pri!ary sensor is a pressure sensor '&P&( +hile the secondary #au#e is an encoder '=(.

<iva $a 5nstallation <iva $a &tillin# "ell

Vaisala CP, +irin#, 12v battery, and solar re#ulator.

b. DAR$ 7uoEs

The 4LT buoy concept is illustrated here?

The 4LT sensor is a pressure sensor that sits on the sealoor in very deep +ater and !easures sea)level luctuationsavera#ed over 1K sec to a precision o 1 !!. The data isrelayed by acoustic tele!etry to the buoy and is thentrans!itted to satellite. The data is transported to PT"C vialine K.

H



"hy 4LT buoysQ The 4chilles heel o the +arnin# syste! is the unnecessary evacuations. 4nevacuation o the &tate o <a+aii +ill easily cost the &tate tens o !illions o dollars in lost businessrevenue and the costs associated +ith e-ecutin# e!er#ency procedures. Gre>uent unnecessaryevacuations +ill under!ine public conidence in the +arnin# syste!. 5 people stop payin# attention tothe +arnin# syste!, then +e have ailed the public.

"hy do +e have unnecessary evacuationsQ ecause orecastin# ho+ lar#e a tsuna!i #enerated on thePaciic Li! +ill be +hen it arrives on distant shores is still very !uch in its nascent sta#es. Coastal tide#au#es provide an i!perect #uide as to ho+ destructive a tsuna!i +ill be as it propa#ates a+ay ro!the source. This is because the near shore bathy!etry and #eo!etry o the harbor +here the tide #au#e issituated have as !uch eect on the +ave)hei#ht and inundation as the unda!ental characteristics o thetsuna!i itsel. 4lon# the sa!e coast, it is not unusual to ind harbors that resonate stron#ly +ith tsuna!iand those +hich sho+ !uch less tsuna!i activity. Thereore the picture #iven by coastal tide #au#es isso!e+hat !ur/y* and orecasts +ith respect to da!a#e on distant coasts rau#ht +ith peril. "hat +asneeded +as a +ay to distin#uish bet+een tsuna!is that +ill cross oceans +ith destructive po+er andtsuna!is that !ay produce !easurable, but non)da!a#in# +aves on distant coasts.

y !easurin# the properties o a tsuna!i ar ro! the inluences o near)shore bathy!etry and

#eo!etry, the 4LT buoys #ive us a loo/ at the tsuna!i in deep +ater unettered by resonant eects.Gurther!ore, +hile !odelin# tsuna!i propa#ation in the near shore environ!ent is diicult, !odelin#tsuna!is as they !a/e their +ay into deep +ater, is a !uch si!pler proble! and can be si!ulated +ith!ore robustness.

Thereore both Paul "hit!ore o the 4T"C '=4LT<V;( and Vasily Titov o PM= '&5GT( have produced a tsuna!i +ave)hei#ht orecast database o pre)co!puted tsuna!i scenarios. These !odels+ill !a/e predictions based on basic seis!ic data as to +hat si6e tsuna!i should be recorded by the4LT and coastal buoys. y co!parin# the predicted results to the observed, the +atchstander should be able to #au#e +hether or not the tsuna!i +ill be destructive +hen it arrives on distant shores.

7. T&;4M5 TL4V=)T5M= 4 "4V=)<=5%<T G$L=C4&T5%

"henever a "atch"arnin# !essa#e is issued, the +atchstander needs to run sot+are to co!pute thetravel ti!es to the various +arnin# points supplied by our clients. This inor!ation is then relayed to our clients in our !essa#e products.

4s !entioned earlier, travel)ti!e calculations are relatively si!ple calculations* they can be done>uic/ly in real)ti!e. <o+ever, even this calculation can be speeded up by co!pilin# a database o pre)co!puted scenarios. &o +e have t+o approaches or co!putin# tsuna!i travel)ti!es. The approach to be used durin# an event is to use the travel)ti!e database because it is aster. <o+ever, this approach'eta.tcl( does not produce any #raphical products. 4ter bulletins are sent the +atchstanders can +or/ +ith travel)ti!e tool 'tttool( to produce a travel)ti!e !ap. tttool +ill also co!pute travel)ti!es, and can be used as a bac/up to eta.tcl.

4!on# the !ost challen#in# nu!erical si!ulation proble!s is that o the tsuna!i. 5t isnt the luidthats diicult* its the boundary conditions that are a pain. 5n order to !odel +ave)hei#hts, the details o near shore bathy!etry and coastline !ust be ta/en into account. This re>uires very ine nu!ericalresolution. Bet, applyin# such resolution to the +hole o an ocean basin +ould re>uire vastco!putational resources. Thereore such !odels involve !ultiple nu!erical #rids on !any scales."ave)hei#ht orecastin# is still in its nascent sta#es althou#h +e can see the li#ht at the end o thetunnel. Coupled +ith a net+or/ o 4LT #au#es, these current !odels should enable the +atchstander

H7



to distin#uish bet+een destructive and non)destructive tele)tsuna!is. T+o tools that are currently bein#used are &5GT 'still bein# developed and tested( and =4LT<V; '"C4T"C(

tide tool 7.0 manual v1.1

Documents