Installation and user manual - Curtin Centre for Marine Science and
Contents
1. 4 24 lt vEditEnvir onment ine A E 11 4 2 5 Edit Code Independent Propagation Parameters 11 4 2 6 Edit Code Dependent Propagation Parameters ooionnoniininninnininnnnnciocncannarar narran rancia 11 4 2 7 Select Active Code lt code gt oo cecececcccceceseessesseeesteseceecesecesecsecsecacecaessaecaaecseeeaeeeseeeseeeseeeseeeeeeeeeeaeens 11 4 3 PROT LING OO ion 12 4 3 1 Amplitude delay for each ray PAthi cccccecccceccececccesecscssecsseeecnseescesesseeecieeeecnsseecesseseeeeeeesneseeenseerees 12 IZ lt BINNER A iai E E E A A A ta E taa 12 ASS ENVIEONMEN eiieeii A A TA E Tibi 12 4 3 4 Green s JUNCTION sitiada stitute a it i inati in 12 BI Mode locations ee ad E a 12 4 3 6 Modesha pes etiese nedi era iei iee eii ie a aa e oeiia 12 EN o EE EE tana NAA A AA E AAA R AE AA EA AE SRA 12 43 8 Reflection coefficient seeeeeesseesereresrsstsirrrissresisteitestsrtstsettststssestettteststestsseseseertsent 12 4 3 9 All Transmission loss plots c ccccccccescscseseeeeeeesesseesecseeseceeeecceescesecseeseceeecnsseeceseeseeaecseeaeseseeeneeerens 12 ACOUSTIC PROPAGATION CODES ssssssssssssssssesssccsssssoscssesssssenessssssesosssesnsssssnesscsssssessesseesosesesoes 13 5 1 ACOUSTIC TOOLBOX AT CODES rrsan eese aaeeeo Sara So E E e ENEE EES EENES AESSR E 13 Sol Bounced Belhopa A AA AA AE DA ae aa 13 Sch 2e Kraken RrakenG amp A casitas ti adas ria bibs aa bs tica A 13 SA3 ScO0terE Fields iron a eR enla oirlo DANS ca2. One of the motivations for AcTUP is that each propagation code uses quite data and data formats These are written to the env files and then copied to the standard configuration file name for the active propagation code just prior to execution The env files are stored with the other output 4 2 Environment amp Propagation Definitions 4 2 1 Load DEFAULT Run Definition 2 menu AS The default configuration has preloaded code Environment amp Propagation Definitions specific parameters for each available TO propagation code and can be run as a first test after installation AAA 4 2 2 Load Run Definition A To as Save Run Definition To date there is no specific filename extension identifying Run Definition objects and instead Edit Environment we use the default mat extension denoting the format in which the Run Definition is saved Edit Code Independent Propagation Parameters This and the way environment and propagation models are handled may change in future Edit Code Dependent Propagation Parameters versions Note that backward compatibility has been Select Active Code RAMGeo maintained AcTUP 2 2 will seamlessly load Run Definitions saved by previous versions then Main Menu create and fill missing fields with default values While the converted Run Definition may run with previously unavailable code options results may not be satisfactory 4 2 3 Save Run Definition While you may use a different extension
3. these parameters form a basis for configuring runs by the different propagation codes and in some cases e g Bounce Kraken Scooter completely specify the run 4 2 6 Edit Code Dependent Propagation Parameters Information additional to that provided above is required for some codes i e Bellhop KrakenC RAMGeo and RAMSGeo Here the user can set appropriate parameters values for each code Note that most of the values for RAMGeo and RAMSGeo are common and editing a parameter in one of these effectively edits that parameter for both codes The interface design has been compromised for the sake of development time and contains artefacts of earlier unreleased versions Some streamlining may occur in subsequent versions Note that when a Run Definition is saved all the code dependent parameters are saved with it irrespective of which code is selected as active 4 2 7 Select Active Code lt code gt See 4 1 2 AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 4 3 Plotting Tools These are fairly self explanatory and the following is merely a brief description of which data files are accessed and which codes produce those files 4 3 1 Amplitude delay for each ray path Plot the data from arr files output by Bellhop in A mode 4 3 2 Bathymetry Plots bathymetry data from bathymetry files in the input format required by AcTUP ascii format row format comments 1 Sa
4. C Program Files CMST Software AcTUP v2 2L AcTUP gt gt actup Note that if AcTUP is used often the working directory will probably spend a lot of time in the current directory drop box at the top of the command window for rapid selection Alternatively the two lines above can be inserted in to a MATLAB script or function somewhere on the MATLAB path allowing the cd and launch command to be executed in one line Note that it is not sufficient and not recommended that you place the working directory permanently on the MATLAB path 3 5 2 developer This is NOT recommended for driving the application but while developing AcTUP it is more conveniet to run from the source subdirectory gt gt cd C Program Files CMST Software AcTUP v2 2L AcTUP Source gt gt act AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 9 4 using AcTUP v2 2 The menu driven system is largely self explanatory but some introductory notes are provided below to kick start the familiarisation process and to help the user avoid pitfalls 4 1 Main Menu 4 1 1 Configure Environment amp Propagation ts joj xj Models Acoustic Toolbox Launches another menu which allows the user ES Version 2 2L to define the model environment set basic propagation parameters to set parameters Configure Environment amp Propagation Models specific to the available propagation codes to save all environm
5. number of points 2toN 1 f f r km z m 4 3 3 Environment Plots water and substrate physical and acoustic parameter profiles for the currently loaded environment model 4 3 4 Green s function Plots the results generated by Scooter grn files 4 3 5 Mode locations Uses output from Kraken 8 KrakenC 4 3 6 Mode shapes Uses output from Kraken 8 KrakenC 4 3 7 Rays 12 Lyme ix Plotting Tools Amplitude delay for each ray path Bathymetry Environment Greens function Mode locations Mode shapes Rays Reflection coefficient Transmission loss vs depth Transmission loss vs range Transmission loss vs range and depth Transmission loss vs range multiple f Main Menu Exit AcTUP Plots ray paths generated by Bellhop in R mode ray files 4 3 8 Reflection coefficient Plot the data from brc files output by Bounce 4 3 9 All Transmission loss plots Plots output from shd files generated by Bellhop C S amp I modes Kraken KrakenC Fields and RAM see 5 2 AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 13 5 Acoustic Propagation Codes 5 1 Acoustic Toolbox AT Codes The following components of Mike Porter s Acoustic Toolbox are supported and directly available from HLS Research The version supplied and tested with AcTUP v2 2 is that released by Mike Porter in early 2006 For further details please refer
6. to the HLS Research site http www hlsresearch com oalib Modes AcousticsToolbox For an excellent reference that covers the theoretical background of all the propagation codes used by ActUP see Jensen et al 1994 Computational Ocean Acoustics AIP Press New York 5 1 1 Bounce amp Bellhop Bounce calculates reflection coefficients at the lower water column interface In AcTUP it can be run independently or in tandem with Bellhop which uses the reflection coefficient output to model either Beam Ray paths Amplitude and Delay of arrivals at specified field points or Coherent semicoherent or incoherent transmission loss Bellhop is a beam tracing program that can include range dependent bathymetry but not sound speed Beam tracing is similar in principle to ray tracing but traces the paths of finite width beams rather than infinitesimal width rays This reduces problems caused by ray theory artefacts such as caustics and shadow zones Bellhop can use beams with a Gaussian intensity profile or geometric beams which produce the same result as a standard ray trace Bellhop is inherently a high frequency code and although its useful frequency range extends lower than standard ray trace programs it should be used with extreme caution in situations where the water depth or the size of any significant feature in the sound speed profile is less than 20 wavelengths 5 1 2 Kraken KrakenC amp Field Kraken finds the normal modes f
7. Curtin UNIVERSITY OF TECHNOLOGY Centre for Marine Science amp Technology AcTUP v2 2 Acoustic Toolbox User interface amp Post processor Installation amp User Guide Amos L Maggi amp Alec J Duncan the designation indicates the limited or lite release of ACTUP CMST AcTUP Installation amp User Guide Revision Sheet Organisation Project Number Centre for Marine Science and Technology Project Name AcTUP Development on going Document Number Document Name AcTUP Installation amp User Guide Revision Issue Notes Written Checked Approved Date No By By By Issued A L First draft ALM AJD amp AJD AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 3 1 2 3 TABLE OF CONTENTS INTRODUCTION cionado acacia 5 1 1 BACKGROUND a A A aurea 5 1 2 DOCUMENT DESCRIPTIONS ziii oaio oee A E E 5 1 3 INTENDED AUDIENCE 000 A A ia 5 WHAT T DA AE AAEN EEEE cubist SEAE E A EEEE E T 6 INSTALLING LAUNCHING ACTU P eissioes ssensessrorseosvosie versoeters sisie ve sso pi esios euses 7 3 1 PREREQUISITES vincia a a a EE E a 7 DAA MATLAB AAA AAA AAA 7 RRA NN 7 3 2 DOWNLOADING FILES escisiones i 3 3 INSTALLING FILES voii ies af 3 4 SETTING UPA WU Pisces 223 sessed Sosesced licences coin E ARN AEN AEE aS A A A E 8 3 4 1 ifyou used some other target directory c
8. amlining is some loss of generality however users familiar with the individual propagation codes will find the ability to directly edit initialisation files from AcTUP goes someway to addressing this issue Since 2002 the software has steadily grown to include two non AT propagation codes and a number of post processing tools The development of AcTUP from version 1 6 to the current version was largely funded by the Defence Science amp Technology Organisation DSTO 1 2 document description This Installation amp User Guide is not intended as a complete user manual AcTUP is research level code and a little clunky at times but the menu driven format makes it mostly self explanatory This guide provides installation instructions an outline of the steps required to generate principle data products where these are perhaps not obvious limited guidance for parameter selection in order to successfully generate these products warning of potential traps in the interface 1 3 intended audience AcTUP Project Team All potential AcTUP users particularly new users AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 6 2 what s new AcTUP has grown considerably since v1 6 was released Among the principle changes are a Addition of two modified versions of Mike Collins range dependent PE code RAM The unmodified source code is available from ftp ftp ccs nrl navy mil pu
9. b ram RAM b Compatibility with the 2006 release of Mike Porter s Acoustic Toolbox c A redesigned Run Definition class combining model environment and propagation parameters into single structure This offers increased robustness facilitating full documentation and recovery of all model parameters d Ability to set up batch runs of one or more propagation codes using the same user friendly interface used for single runs e A redesigned and more connected user interface to cope with the significantly expanded functionality AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 3 installing launching AcTUP 3 1 prerequisites 3 1 1 MATLAB AcTUP v2 2L requires only MATLAB version 6 or later In addition to this the full release specification requires the MATLAB Signal Processing Toolbox Note that version 2 2 was developed using MATLAB R2000a 3 1 2 AT Mike Porter s Acoustic Toolbox and versions of RAM modified to work with ActUP are supplied with AcTUP v2 2 L to simplify installation procedure 3 2 downloading files All the files you require for installing ACTUP v2 2L are available from the Centre for Marine Science amp Technology website http www cmst curtin edu au products actoolbox index html The appropriate link will allow you to download the following self extracting zip file AcTUP v2 2 lite exe 3 3 installing files To install ACTUP v2 2 L simply run the e
10. ccccccecsscececsceseetesseesecsseeecuseescesesseeecieeeecnseesenseeseeesneeeeeneeets 8 3 5 RUNNING A CUP raa aE EE O ASAAN ti bias Slate Siesiiastes A IA 8 Dads WONDUSCR RA Aes vs E Senetisesaebanebsdebava A 8 AN 14107117 AE RR NN 8 USINGACTUP V22 scstisiccctscssccstisiedecccusestdbosddcctscssoucsvehsdeuseerooaseccecd co s casaesessiosesteuaseasclchcbectossssesasusscuessstsaoue 9 4 1 MAIN MENU ccoo da iia lada cctv evade ed la desc satu ole IO dad ses eu eee 9 4 1 1 Configure Environment amp Propagation ModelS ooionnnninnninninonvnvnjnnj n viscosa rana 9 4 1 2 Select Active Code lt code e ra eo ei eea e a a ea a ea Nee 9 4 1 3 Run Current Model for ACTIVE Propagation code 9 4 1 4 Run Current Model for ALL Propagation codes eesseeeeereeerreerirsrrerrrreerirrsrsrrreee 9 4 1 5 Run Model s from File s cccccccccscssccssssscesesseesecnceeccsesscsessessecaeesecaceeeceaessessecsessecsaeeeceaessesaeeaesseeaeeats 9 4 1 6 View Log or Environment Files c cccccccccecscceseesseseesseeecuseeseeecseescesecseesecesecueseecnseeseeseeseesesneseeenseatens 10 4 2 ENVIRONMENT amp PROPAGATION DEFINITIONS oocoococoncaccnnannncocancanronnnranronanonnronanrnnrocnn ran ra rnn ran racinrnnrananoa 10 4 2 1 Load DEFAULT Run Definition ccecccccccesecseesecsseeecnseescusesseescsesseesecseseceseecteeseeaesseeseseeeeeneeerens 10 422 Load RUM Definition a a tr ltd acid 10 42 3 Save Run DC SINIION oniinn Ere a da aji ie eiea enaa E eiae aa 10
11. discussed in the previous section Mike Collins elastic substrate version of RAM has been modified so that it uses the same bathymetry datum substrate profile specification model as RAMGeo 5 2 3 Additional modification and data handling When these two versions are run under AcTUP the pgrid files are translated and written to shade format files shd used by the other AcT models Code for conversion and reading shade files in ACTUP has been modified to cope with the rare but conceivable case where the complex TL record length can exceed twice the length in number not necessarily bytes of the real range vector record Generally only a risk in model propagation planes with unusually high aspect ratios AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 6 Data Products 6 1 Output Files 16 extension description format produced by arr Amplitude and time of flight data as ascii Bellhop well as other ray parameters for arrivals at field point brc Bottom reflection coefficient as a ascii Bounce function of incident angle grn Depth dependent Green s function binary Scooter solutions mod Mode solutions binary Kraken KrakenC ray Ray trace output Bellhop shd Complex transmission loss as a binary Bellhop function of depth and range Field Fields AcTUP AcTUP LITE Installation amp User Guide doc
12. dos 14 5 2 RAM a bla 15 IZ RAM GEO VLOCOQOS cies A a R dE CEA ET Mea Ra AEE Rss 15 D202 RAMS GEO OS COL OLDI Forsite cn ENE nhs ndico 15 5 2 3 Additional modification and data handling cccccccccccecessesecseeecnteesceseceesecseseecnseeseeseeseeesseveeeneeetees 15 DATA PRODUCTS fiisscsediecesceciessecccssctacscsustecadesctssscscstesetesssusrcvessscecsasssuvce dolida cies iii thus sienccedesetssaseessuboede 16 6 1 CUT RUT PILES cari A A AR EE 16 AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 4 SUMMARY This document Installation amp User Guide is a collection of notes intended to accelerate the new user s familiarisation with AcTUP It is not intended as an exhaustive user manual Work carried out by Amos L Maggi amp Alec J Duncan AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 1 introduction 1 1 background AcTUP was initially developed as the Acoustics Toolbox Front End by Alec Duncan to facilitate the rapid application of and performance comparisons between the different acoustic propagation codes available in Mike Porter s Acoustic Toolbox AT This was achieved by providing the user with a unified environment model automating the creation of code specific initialisation files and by providing intelligent guesses and selection guidelines for code specific parameters The cost of this kind of stre
13. ent and propagation model Select Active Code RAMGeo parameters as a single Run Definition and to load previously saved Run Definitions Run Current Model for ACTIVE Propagation Code 4 1 2 Select Active Code lt code gt Run Current Model for ALL Propagation Codes Selects which of the available codes is used in modelling propagation when the button below Run Model s from File s this one is selected see 4 1 3 View Log or Envi rit Fil 4 1 3 Run Current Model for ACTIVE ____VewLogerenvanmertFies Propagation code Platting Tools Runs the environment propagation model Exit AcTUP currently in memory using the selected propagation code see 4 1 2 Note AcTUP does not check whether the code specific parameters have been set for the selected propagation code 4 1 4 Run Current Model for ALL Propagation codes Runs the environment propagation model currently in memory using all available propagation codes Note that in this mode Bounce and Fields are only run in conjunction with Bellhop and Scooter respectively Note AcTUP does not check whether the all code specific parameters have been set This would be rather difficult to do anyway since Run Definitions are rarely built from scratch They are often built from previously saved Definitions It is impractical and perhaps impossible to track environment or propagation model edit and from these determine algorithmically whether previously defined code specific pa
14. esired range However the number of modes increases with increasing frequency making normal mode methods unsuitable for modelling propagation in situations where the waveguide is many acoustic wavelengths deep In future versions Field may be offered as a separate option to make use of existing mode files Range dependent problems can be handled by computing the normal modes at different ranges and then using adiabatic or coupled mode theory to calculate how the modes at one range couple to the modes at the next range This capability is not currently supported by AcTUP 5 1 3 Scooter amp Fields Scooter calculates the depth dependent Green s function for the model environment Fields not Field integrates the resultant Green s function results in grn files to determine the transmission loss by using an FFT This is the fast field technique This method of calculating transmission loss accounts for all the acoustic energy whether trapped or not and does not rely on the less than 100 reliable process of finding normal modes It can also cope quite happily with layered elastic seabeds and even model boundary interface waves It is therefore both more accurate and more reliable than the normal mode method and is far and away the preferred technique for low frequency short range range independent problems It is however much more computationally intensive than normal modes for long range problems and the computational load increa
15. from mat it is advised that you stick with this format If you save both input and output files in an areas designated for AcTUP modelling then there is no need to distinguish these mat files from any others since they are the only ones used by AcTUP AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 11 4 2 4 Edit Environment This launches an interface to edit the model environment This consists of an array of range independent Environment objects each defined at a specific range The range independent codes all codes except RAM in this version only use the first element of the Environment array Each Environment object is a collection of range independent layers of acoustic media The first layer is always the water column and the second layer is always the upper most layer of the substrate Each layer consists of lists of depth z dependent properties which must be specified Bathymetry is currently specified in the propagation model It is used to specify the depth at which the upper interface of the 2 acoustic medium layer occurs relative to the upper surface of the first water layer Currently the Environment object array is limited in such a way that each component Environment object must contain the same number of layers 4 2 5 Edit Code Independent Propagation Parameters Basic parameters defining the propagation scenario are specified here Along with the environmental model
16. or the model propagation environment using real arithmetic and estimates the attenuation by a perturbation technique This method works well for layered fluid seabeds and can handle an elastic lower halfspace i e a halfspace with a significant shear speed It can t cope with elastic intermediate layers The normal modes only account for energy that is trapped in the waveguide and therefore this method is inaccurate at short range where the effect of untrapped energy is significant KrakenC finds the normal modes in the complex wavenumber plane which allows it to deal with elastic seabed layers and to include the effects of leaky modes which account for some of the untrapped energy This makes it more accurate than Kraken at short range However finding modes in the complex plane is much more difficult than finding them on the real axis which makes KrakenC prone to missing some of the modes leading to inaccurate results Use with caution Field uses the normal modes calculated by either of these programs to determine the transmission loss at the specified field points AcTUP automatically runs Field immediately following either Kraken or KrakenC This is a very efficient way of calculating low frequency transmission loss at long AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 14 ranges as the modes only have to be calculated once after which the transmission loss can easily be computed at any d
17. p launching Fields AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 15 5 2 RAM Two modified versions of Mike Collins Range dependent Acoustic Model RAM have been integrated into the AcTUI framework RAM is a parabolic equation PE code that uses a split step Pad algorithm to achieve high efficiency and the ability to model propagation at large angles from the horizontal the usual limitation of PE codes There is a trade off between the angular range and the speed of computation that is governed by the number of terms the user specifies for the Pad approximation the more terms the wider the angle but the slower the code runs RAM is capable of modelling low frequency propagation in fully range dependent environments i e range dependent bathymetry and sound speed and this capability is fully supported by AcTUP 5 2 1 RAMGeo v1 5C00 03 This is a CMST version based on Mike Collins RAMGeo version 1 5 It has been modified to output complex transmission loss data as well as the standard magnitude only files Additional files output are tl pgrid Complex pressure analogue to tl grid tl pline Complex pressure analogue to tl line Additional minor modifications include some error flags which enable AcTUI and the user to better identify some run time errors 5 2 2 RAMSGeo v0 5C01 01 01 This is a CMST version based on Mike Collins RAMS version 0 5 and the RAMGeo version
18. rameters are still appropriate 4 1 5 Run Model s from File s This options enables batch mode processing The user is prompted to select a directory containing one or more Run Definitions AcTUP will sequentially load and run each Run Definition file For each Run Definition file the propagation code applied is which was active 4 1 2 at the time it was last saved to disk Currently only one active propagation code is selectable at any one time so that in order to run multiple propagation codes for the same Run Definition from file the user must save a copy of same the Run Definition for each propagation code required AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 10 4 1 6 View Log or Environment Files Allows user to open and view log prn and environment definition env files The log files are text files which contain a log of the command line instructions issued by AcTUP and any errors generated by them Note in some cases MATLAB commands copyfile and movefile have been used to replace command line copy and move and so do not generate entries in the log file The environment files are somewhat of a misnomer and an artefact from early versions of AcTUP These are in fact renamed copies of the configuration files accessed by the propagation codes and contain propagation model parameters as well as environment model parameters Additionally env does not describe a single format
19. ses rapidly with increasing frequency In AcTUP Scooter and Fields can be run in sequence automatically Scooter Fields or manually The later is useful when high resolution range data dr is only required about small regions Ar about a number of ranges rj where ri41 1 gt gt Ar while maintaining workable file sizes When the sequence is run automatically it is done so for each specified frequency in turn Field uses the grn file just created by Scooter and the field points specified by the receiver location in the Code Independent parameter set Care needs to be taken when Fields is run manually because Fields needs very little information In fact it can be run without the same Run Definition environment propagation parameters previously used by Scooter When run manually the user must first launch Edit Code Dependent Parameters for Fields Here the user specifies a group of target grn files by choosing one of the group interactively AcTUP will then locate all grn files in the same folder that match the base filename prefix excluding the frequency tag The user is then prompted to specify the field point grid for the TL calculation The suggested parameters appearing on the Fields dialog box will be based on the grn file contents and the receiver locations in the Code Independent parameters It is recommended although not absolutely necessary that the Run Definition used to generate Scooter be loaded for before setting u
20. xecutable above After extract the topmost AcTUP directory will locate directly below the default target directory as shown in the figure below S Local Disk C Q Program Files CI cmsT Software E AcTUP v2 2L Below the target directory your directory structure no matter what target was selected will look like working directory EQ actup output files a Bathymetry g CI Output default location for 1 03 RunDef saving run definitions L Source Do amp J Tx Signals model source sianals H at O ram ee You should AVOID editing or deleting installed directory names Acoustic Toolbox code AcTUP LITE Installation amp User Guide doc CMST AcTUP Installation amp User Guide 8 3 4 setting up AcTUP You only need to complete the following instructions if you DID NOT use the default target directory in the installation process 3 4 1 if you used some other target directory Navigate to the folder C Program Files CMST Software AcTUP v2 2L AcTUP Source Open GetAcDirectoryInfo m Edit the line Top C Program Files CMST Software AcTUP v2 2L to reflect the correct location of the actup v2 2 directory Save and close this file Now point MATLAB at the working directory by 3 5 running AcTUP 3 5 1 end user In order to run AcTUP you must point MATLAB at the working directory AcTUP You must then run the top level m file actup m The example below is for the default installation case gt gt cd
Download Pdf Manuals
Related Search