### Example: Bathymetry and Geoacoustics File Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/ATI_BTY_File.htm This example demonstrates the format for a file including bathymetry and geoacoustic parameters, using the long format. ```text 'LL' 3 0 100 1700 0.0 1.2 0.5 0 2.5 100 1550 0.0 1.2 0.5 0 5.0 100 1550 0.0 1.2 0.5 0 ``` -------------------------------- ### Example ENV File for BOUNCE Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/bounce.htm This example demonstrates the structure of an .ENV file for BOUNCE, defining acoustic and elastic layers, reflection coefficient parameters, and grid settings. ```plaintext 'Refl. coef. test problem' 50.0 1 'NAW' 0.0  1500.0  0.0  1.0 0.0 0.0/        ! Z(m) CP CS (m/s) RHO (g/cm3) AP AS 100 0.0 20.0     0.0 1600.0 400.0 1.8 0.2 0.5    20.0 / 'A' 0.0    20.0 1800.0 600.0 2.0 0.1 0.2 1400.0 19000.0 10.0                  ! RMAX (km) 1                     ! NSD 50.0 /                ! SD(1:NSD) 501                   ! NRD 0.0 150.0 /           ! RD(1:NRD) ``` -------------------------------- ### Reflection Coefficient Data Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/ReflectionCoefficientFile.htm This example demonstrates the structure of a reflection coefficient file, specifying the number of angles and the corresponding reflection magnitude and phase at each angle. ```text 3 0.0 1.00 180.0 45.0 0.95 175.0 90.0 0.90 170.0 ``` -------------------------------- ### Example: Bathymetry Only File Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/ATI_BTY_File.htm This example shows the format for a bathymetry-only file using the piecewise linear option. ```text 'L' 5 0 3000 10 3000 20 500 30 3000 100 3000 ``` -------------------------------- ### Run KRAKEN from Matlab Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Example of how to execute the KRAKEN program from the Matlab command line. ```matlab kraken( 'pekeris') ``` -------------------------------- ### Run KRAKEN from DOS Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Example of how to execute the KRAKEN program from a DOS command line. ```dos kraken pekeris ``` -------------------------------- ### FIELD Program FLP File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/field.htm Example of a FIELD input parameter file (.FLP). This file defines simulation parameters such as title, source options, number of modes, profile ranges, and source/receiver locations. ```plaintext /, ! TITLE 'RA' ! OPT 'X/R', 'C/A' 9999 ! M (number of modes to include) 1 ! NPROF 0.0 ! RPROF(1:NPROF) (km) 501 ! NR 200.0 220.0 / ! R(1:NR) (km) 1 ! NSD 500.0 / ! SD(1:NSD) (m) 1 ! NRD 2500.0 / ! RD(1:NRD) (m) 1 ! NRR 0.0 / ! RR(1:NRR) (m) ``` -------------------------------- ### Range-Dependent SSP File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/RangeDepSSPFile.htm This example demonstrates the format of a range-dependent SSP file. It includes the number of profiles, the range of each profile, and the sound speed values at different depth points for each profile. Ensure the main BELLHOP envfil contains a dummy SSP with the same number of depth points for correct interpretation. ```text 8 0.0 12.5 25.0 37.5 50.0 75.0 100.0 125.0 1536 1536 1536 1536 1536 1536 1536 1536 1506 1508.75 1511.5 1514.25 1517 1520 1524 1528 1503 1503 1503 1502.75 1502.5 1502 1502 1502 1508 1507 1506 1505 1504 1503 1501.5 1500 1508 1506.6 1505 1503.75 1502.5 1500.5 1499 1497 1497 1497 1497 1497 1497 1497 1497 1497 1500 1500 1500 1500 1500 1500 1500 1500 1512 1512 1512 1512 1512 1512 1512 1512 1528 1528 1528 1528 1528 1528 1528 1528 1545 1545 1545 1545 1545 1545 1545 1545 ``` -------------------------------- ### FIELD3D FLP File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/field3d.htm Example structure of a FIELD3D FLP (FieLd Parameters) input file. This file defines simulation parameters, grid, and triangulation for acoustic field calculations. ```plaintext 'MUNK3D' ! TITLE 'STDFM' ! OPT 9999 ! M (number of modes) 1 ! Nsx 0.001 ! Sx coordinates of source (km) 1 ! Nsy 0.001 ! Sy coordinates of source (km) 1 ! NSD 1000.0 ! SD(1:NSD) (m) 1 ! NRD 800.0 ! RD(1:NRD) (m) 501 ! NR 0.0 100.0 501 ! RMIN RMAX (km) 19 ! NTHETA 0.0 360.0 / ! THETA(1:NTHETA) (degrees) 5 ! Number of SSP's (NSSP) 100.0 0.0 'SCR:MUNKT0' ! (x, y) i=1, NSSP (km) 0.0 100.0 'SCR:MUNKT90' -100.0 0.0 'SCR:MUNKT0' 0.0 -100.0 'SCR:MUNKT270' 0.0 0.0 'SCR:MUNKT0' 4 ! NELTS 5 1 2 ! Nodes of corners 5 2 3 5 3 4 5 4 1 4.0 360.0 90 ! ALPHA1 ALPHA2 NALPHA 500.0 160 ! STEP NSTEPS 0.3 ! EPMULT ``` -------------------------------- ### BELLHOP3D Environmental File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/bellhop3d.htm This is a sample environmental file for BELLHOP3D, defining parameters like frequency, media, sound speed profile, source/receiver depths, and beam fan settings. It uses a 'Munk profile' for sound speed. ```bellhop 'Munk profile'        ! TITLE 50.0                  ! FREQ (Hz) 1                     ! NMEDIA 'CVN'                 ! SSPOPT (Analytic or C-linear interpolation) 51  0.0  20000.0       ! DEPTH of bottom (m)     0.0  1548.52  /   200.0  1530.29  /   250.0  1526.69  /   400.0  1517.78  /   600.0  1509.49  /   800.0  1504.30  /  1000.0  1501.38  /  1200.0  1500.14  /  1400.0  1500.12  /  1600.0  1501.02  /  1800.0  1502.57  /  2000.0  1504.62  /  2200.0  1507.02  /  2400.0  1509.69  /  2600.0  1512.55  /  2800.0  1515.56  /  3000.0  1518.67  /  3200.0  1521.85  /  3400.0  1525.10  /  3600.0  1528.38  /  3800.0  1531.70  /  4000.0  1535.04  /  4200.0  1538.39  /  4400.0  1541.76  /  4600.0  1545.14  /  4800.0  1548.52  /  5000.0  1551.91  /   20000   1551.91 / 'A' 0.0  20000.0  1600.00 0.0 1.8 0.8 / 1                 ! NSx number of source coordinates in x 0.0 /             ! x coordinate of source (km) 1                 ! NSy number of source coordinates in y 0.0 /             ! y coordinate of source (km) 1                 ! NSz 1000.0 /          ! Sz(1 : NSz) (m) 501               ! NRz 0 5000 /          ! Rz(1 : NRz) (m) 1001              ! NR 0.0  100.0 /      ! R(1 : NR ) (km) 2                 ! Ntheta (number of bearings) 0.0 1.0 /         ! bearing angles (degrees) 'CG   3'          ! 'R/C/I/S' 51 6              ! Nalpha -14.66 14.66 /    ! alpha1, 2 (degrees) Elevation/declination angle fan 11 46             ! Nbeta -2  2 /           ! beta1, beta2 (degrees) bearine angle fan 100.0  100.0 100.0 20500.0 ! STEP (m), Box%x (km) Box%y (km) Box%z (m) ``` -------------------------------- ### BELLHOP Environmental Input File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/bellhop.htm This is a sample environmental file for BELLHOP, defining parameters like frequency, sound speed profile, source/receiver depths, and run options. Ensure the sound speed profile and other parameters are appropriate for your acoustic environment. ```bellhop 'Munk profile' ! TITLE 50.0 ! FREQ (Hz) 1 ! NMEDIA 'SVN' ! SSPOPT (Analytic or C-linear interpolation) 51 0.0 5000.0 ! DEPTH of bottom (m) 0.0 1548.52 / 200.0 1530.29 / 250.0 1526.69 / 400.0 1517.78 / 600.0 1509.49 / 800.0 1504.30 / 1000.0 1501.38 / 1200.0 1500.14 / 1400.0 1500.12 / 1600.0 1501.02 / 1800.0 1502.57 / 2000.0 1504.62 / 2200.0 1507.02 / 2400.0 1509.69 / 2600.0 1512.55 / 2800.0 1515.56 / 3000.0 1518.67 / 3200.0 1521.85 / 3400.0 1525.10 / 3600.0 1528.38 / 3800.0 1531.70 / 4000.0 1535.04 / 4200.0 1538.39 / 4400.0 1541.76 / 4600.0 1545.14 / 4800.0 1548.52 / 5000.0 1551.91 / 'V' 0.0 1 ! NSD 1000.0 / ! SD(1:NSD) (m) 2 ! NRD 0.0 5000.0 / ! RD(1:NRD) (m) 501 ! NRR 0.0 100.0 / ! RR(1:NR ) (km) 'R' ! Run-type: 'R/C/I/S' 51 ! NBEAMS -11.0 11.0 / ! ALPHA(1:NBEAMS) (degrees) 200.0 5500.0 101.0 ! STEP (m) ZBOX (m) RBOX (km) ``` -------------------------------- ### FIELDS FLP File Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/doc/fields.htm Example of the .FLP file format used to define field parameters for the FIELDS program. It includes options for coordinate systems, spectrum, interpolation, and source beam patterns, along with receiver range specifications. ```plaintext 'RDB' ! 'R/X (coord), Lin/DB, Pos/Neg/Both' 200.0 220.0 501 ! RMIN, RMAX, NR (1) - OPTIONS Syntax: OPT Description: OPT(1:1): Coordinates 'R' Cylindrical (R-Z) coordinates using the far-field approximation to the Hankel functions. 'X' Cartesian (X-Z) coordinates. 'H' Hankel functions used to provide the exact transform (a bit slower but more accurate) (only available in the Matlab fieldsco.m) OPT(2:2): Spectrum 'P' Positive (recommended) 'N' Negative 'B' Both positive and negative The spectral integral should formally be done from all along the real k-axis, however the negative portion contributes significantly only in the near-field. Run-time is less if it is neglected. OPT(3:3): Interpolation type 'O' POlynomial (for broadband runs) (default) 'A' PAde (can produce better results for CW runs but is less reliable) The Pade option (OPT(3:3)) is less robust. Use polynomial interpolation if an underflow/overflow occurs ... OPT(4:4): Selects a source beam pattern '*' Read in a source beam pattern file. 'O' Omnidirectional (default). (2) - RECEIVER RANGES Syntax: RMIN RMAX NR Description: RMIN: First receiver range (km) RD: Last receiver range (km) NR: Minimum number of receiver ranges The actual number of ranges used is increased slightly to satisfy FFT sampling requirements. ``` -------------------------------- ### Set PATH in Unix/Linux/MacOSX for Matlab Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Ensure path info is set in Matlab at startup by editing the matlab startup script. This example adds a source command for the profile script. ```shell source ~/.profile ``` -------------------------------- ### Fortran 90/95 Dynamic Allocation Example Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Illustrates the new input structure for Fortran 90/95 where the number of items in a vector must appear on a separate line before the vector contents. ```fortran In the new version the number of items in the vector must appear on a separate line so that the code can read it, allocate the space, and then read the vector contents. ``` -------------------------------- ### Run Test Suite with Fortran Binaries Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Execute the complete suite of tests using the Fortran binaries by running this m-file. ```matlab runtests.m ``` -------------------------------- ### Set PATH in DOS Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Add this line to your autoexec.bat to make scripts executable in your default path. Ensure the directory paths reflect your installation. ```batch SET PATH=%PATH%;C:\AT\SCRIPTS;C:\AT\BIN ``` -------------------------------- ### Fortran Deprecated Char Reference Conversion Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Example of converting deprecated 'char foo*5' references to the Fortran 2003 standard 'char (len=5) :: foo'. ```fortran Converted most "char foo\*5' references, which are deprecated in the new Fortran, in favor of "char (len=5) :: foo". ``` -------------------------------- ### Run Test Suite with Matlab Versions Source: https://github.com/a-new-bellhope/bellhop/blob/main/index.htm Execute the complete suite of tests using the Matlab versions of BELLHOP, SCOOTER, BOUNCE, and SPARC by running this m-file. ```matlab runtestsM.m ```