How to export raw sonar data of a scanning session? (beta version)

It is possible to export raw sonar data of a scanning session made with Deeper Sonar. The data is exported in .csv format.

[!] This feature is currently in open-beta state.

[!] We recommend using the latest version of Google Chrome browser for this feature to work properly.

To export the raw sonar data, you will first need to get the unique session ID of the session you wish to export, as well as user token.

F.A.Q. can be found on the bottom of this page.


STEP 1. GETTING THE UNIQUE SESSION ID

Make sure that the scanning session that you’re trying to export is uploaded to the Fish Deeper web-app.

To instantly upload the scanning session to web-app, go to the History section of the app, and click the cloud button in the top-right corner:

Get the unique session ID. Now, you will need to get a unique session ID, which will be later used to export the raw data.

    1. Go to Fish Deeper web-app and open the group of scans which contains the scanning session that you want to export. Do not open the scanning session you wish to export.

 

 

    1. Right-click anywhere and select “Inspect

    1. Go to Network tab

 

    1. Add filter “chunk”

    1. Now, press on the session that you want to export. A few results under the Name tab will appear. Press on any of them and you will see the unique session ID. In this example, it’s fd318343-1ef8-486f-8ea8-e9e06c4095a8

 

STEP 2. GETTING THE USER TOKEN

Next, you will need to get the user token, which will be needed to export the raw sonar data in the later steps.

  1. Log out from our web-app account and go to log-in screen. Right click and select “Inspect

  1. Then, log in to your account and filter by “login” in the Network tab, and click Preview

You will see the user token.

[!] You will not need to repeat the step 2 and get the user token next time you wish to export the sonar data. You can use the same user token next time you export the sonar data.

[!] Do not share the user token with anyone, as it can be used to log in to your account.

 

STEP 3. DOWNLOADING THE RAW SONAR DATA

Sonar data can be downloaded in .csv format using a custom link:

https://siren.deeper.eu/sonar/export/SESSIONID?token=USERTOKEN

Instead of SESSIONID, enter the session ID that you have gotten in Step 1 of this guide.
Instead of USERTOKEN, enter the token ID that you have gotten in Step 2 of this guide.

Then, open the link. A download of a .zip file will be initiated. It will contain bathymetry and sonar data in .csv formats, as well as Readme file.


F.A.Q.

What are the minimum and maximum values of sonar return strength?

Sonar return strength minimum and maximum range depends on the model:

• All Deeper CHIRP model series and PRO+2: Between 0 and 4096
• Deeper PRO model series: Between 0 and 1600
• Deeper START: Between 0 and 1600

 

How to determine depth based on the exported raw sonar data? How the numbers of column in .csv file is determined?

Depth between the water surface and the bottom is something you will need to define by yourself, depending on what you define as a bottom in your particular use case.

When it comes to the total scanned depth, there are general rules you need to know in order to properly understand how it’s determined:

• Deeper automatically determines the bottom, based on reflection strength and algorithms. Documentation of those algorithms is not disclosed to the public.
• If Deeper detects the bottom, it will add 10 additional meters to the total scanning depth.
• Amount of columns in the .csv file is related to meters per pixel and depth determined by the Deeper itself. Meters per pixel (scanning resolution) depends on the model:

All Deeper CHIRP model series and PRO+2: 0.010407008 m. per pixel
Deeper PRO model series: 0.02738 m. per pixel
Deeper START: 0.03705 m. per pixel

EXAMPLE: if Deeper CHIRP+ 2 determines that the bottom is at 3 meter depth, it will add 10 meters to the scanned depth. The number of columns will be (3m + 10m) / 0.010407008= 1249 columns.

 

How number of rows in the .csv file is determined?

Number of rows depends on total the time Deeper was scanning during a particular scanning session, as well as amount of scans (sonar pulses) per second. All Deeper CHIRP and PRO model series scan up to 15 times per second. Scanning rate (pulse rate) depends on depth:
• When scanning shallow waters, scan rate will be higher.
• When scanning deep waters, scan rate will be lower.
• From 30-35 m. of depth, scanning rate will start to slow down. At 100 meters, it will be 3 scans (sonar pulses) per second.
• If Deeper cannot detect the bottom, scan rate will be at its highest value.
• Scanning rate is determined automatically and cannot be controlled.