Bellhop Python Simulation relies on the following libraries:
- fortran compiler
- Acoustic Toolbox
- Arlpy
- Python3
- Jupyter Notebook(optional)-
First make sure you have
gfortran,gccandgcxx compiler. -
Please checked if the GNU Fortran compiler was in my system by typing
gfortran --version:GNU Fortran (Ubuntu 7.4.0-1ubuntu1~20.04.1) 7.4.0 Copyright (C) 2017 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
If you have them then go for the GNU compiler, type:
bash export FC=gfortran
Acoustic Toolbox is in repo folder named AcousticToolbox. You can download from there or follow the instruction below.
| Sr No. | Link | DESCRIPTION |
|---|---|---|
| 1. | Bellhop Simulation | Bellhop - Ray Tracing |
| 2. | Bellhop Sample Notebook | Bellhop Sample Notebook |
| 3. | Bellhop another usecase Notebook | Bellhop another usecase Notebook (PDF) |
| 4. | Bellhop Introduction | Bellhop Introduction (PDF) |
| 5. | Simple plotting GUI Tool for ARLPY | Simple plotting GUI Tool for ARLPY |
Please make sure you have newer version of Bellhop.
cd ${HOME}/Documents
wget http://oalib.hlsresearch.com/AcousticsToolbox/at_2024_12_25.zip
unzip at_2020_11_4.zip
cd at_2020_11_4
make clean
make all
sudo make install
sudo ldconfigIf something goes wrong, you need to do make clean in order to clear all necessary files and then again run the above mentioned steps.
Once installed, let's tell the system where to find our new libraries: ( Please replace ns with your hostname)
export PATH=/home/ns/Documents/at/at/Bellhop:/home/ns/Documents/at/at/:$PATHPlease download the binary files from the Bellhop. You can find them on this page -- Here.
Important: This is a critical instruction from Ocean Acoustics Library - OALIB. Look at the compile dates carefully!
at source code (zip file) for Mac, Linux, or Windows. Binaries are *NOT* provided. (2024_12_25) ; you need to build this. You can use the above commands to build this.
at Binaries (zip file) for Windows 10. This version is older than the one above. (The source code is also included so that you can access the compatible Matlab routines that read/write model input/output.) *(2020_11_4)*
The Fortran2008 source code should be fully portable. The Windows10 binaries were compiled for a plain vanilla Intel architecture. Therefore they will likely be slower that one that you compile yourself for the native architecture.
First let's check which Linux are you running with the command:
lsb_release -ds
Will return something like:
Debian GNU/Linux 9.8 (stretch)
-
For Debian/Ubuntu/Linux Mint:
$ sudo apt-get update $ sudo apt-get install wget nano gfortran m4 build-essential -
Also check your python version, it is recommanded to use python3.
$ python --version
Will return something like:
Python 2.7.18rc1
or you might have something like this if you have python3 correctly installed:
$ python3 --version
Will return something like:
Python 3.8.2
Run the following command in your terminal. (It worked without sudo permission as well. It is recommanded to use sudo to installed everything properly.)
$ pip3 install arlpy
or
$ python3 -m pip install arlpy
or
$ sudo -H pip3 install arlpy
The Jupyter notebook is a web-based notebook environment for interactive computing.
You can find the installation documentation for the Jupyter platform, on ReadTheDocs.
The documentation for advanced usage of Jupyter notebook can be found here.
For a local installation, make sure you have pip installed and run:
$ pip install notebook
Launch with:
$ jupyter notebook
You need some configuration before starting Jupyter notebook remotely. See Running a notebook server.
You can find the example notebook of Bellhop in the repo folder named sample notebook. Follow the instruction and commands in the notebook to perform basic simulations with bellhop.
- If you want to see the notebook output figures then download
sample notebook/bellhop.htmland open in your browser, it will open up notebook with all the output graphs.
You can find this cool small GUI tool here.
To chech you have correctly set your PATH for acoustic toolbox, please type this in your command prompt
$ which bellhop.exe
It will show you path of your bellhop.exe, same like this,
/home/ns/Documents/at/bin/bellhop.exe
1. M. Chitre 2020, “ARLPY python toolbox” , https://github.com/org-arl/arlpy
2. Ocean Acoustics Library. https://oalib-acoustics.org/, Retrieved August 11, 2020.
3. Jay Patel and Mae Seto, Underwater channel characterization for shallow water multi-domain communications, Proceedings of Meetings on Acoustics 40, 070014 (2020), https://doi.org/10.1121/2.0001316, Retrieved July 07, 2021.